@doccov/cli 0.18.0 → 0.20.0

package/dist/cli.js

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
 
 // src/config/doccov-config.ts
-import { access, readFile } from "node:fs/promises";
+import { access } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
-import { parse as parseYaml } from "yaml";
 
 // src/config/schema.ts
 import { z } from "zod";
@@ -16,7 +15,6 @@ var docsConfigSchema = z.object({
   include: stringList.optional(),
   exclude: stringList.optional()
 });
-var severitySchema = z.enum(["error", "warn", "off"]);
 var exampleModeSchema = z.enum([
   "presence",
   "typecheck",
@@ -32,23 +30,12 @@ var checkConfigSchema = z.object({
   minCoverage: z.number().min(0).max(100).optional(),
   maxDrift: z.number().min(0).max(100).optional()
 });
-var qualityConfigSchema = z.object({
-  rules: z.record(severitySchema).optional()
-});
-var policyConfigSchema = z.object({
-  path: z.string().min(1),
-  minCoverage: z.number().min(0).max(100).optional(),
-  maxDrift: z.number().min(0).max(100).optional(),
-  requireExamples: z.boolean().optional()
-});
 var docCovConfigSchema = z.object({
   include: stringList.optional(),
   exclude: stringList.optional(),
   plugins: z.array(z.unknown()).optional(),
   docs: docsConfigSchema.optional(),
-  check: checkConfigSchema.optional(),
-  quality: qualityConfigSchema.optional(),
-  policies: z.array(policyConfigSchema).optional()
+  check: checkConfigSchema.optional()
 });
 var normalizeList = (value) => {
   if (!value) {
@@ -80,21 +67,12 @@ var normalizeConfig = (input) => {
       maxDrift: input.check.maxDrift
     };
   }
-  let quality;
-  if (input.quality) {
-    quality = {
-      rules: input.quality.rules
-    };
-  }
-  const policies = input.policies;
   return {
     include,
     exclude,
     plugins: input.plugins,
     docs,
-    check,
-    quality,
-    policies
+    check
   };
 };
 
@@ -102,12 +80,8 @@ var normalizeConfig = (input) => {
 var DOCCOV_CONFIG_FILENAMES = [
   "doccov.config.ts",
   "doccov.config.mts",
-  "doccov.config.cts",
   "doccov.config.js",
-  "doccov.config.mjs",
-  "doccov.config.cjs",
-  "doccov.yml",
-  "doccov.yaml"
+  "doccov.config.mjs"
 ];
 var fileExists = async (filePath) => {
   try {
@@ -134,11 +108,6 @@ var findConfigFile = async (cwd) => {
   }
 };
 var importConfigModule = async (absolutePath) => {
-  const ext = path.extname(absolutePath);
-  if (ext === ".yml" || ext === ".yaml") {
-    const content = await readFile(absolutePath, "utf-8");
-    return parseYaml(content);
-  }
   const fileUrl = pathToFileURL(absolutePath);
   fileUrl.searchParams.set("t", Date.now().toString());
   const module = await import(fileUrl.href);
@@ -177,7 +146,7 @@ ${formatIssues(issues)}`);
 // src/config/index.ts
 var defineConfig = (config) => config;
 // src/cli.ts
-import { readFileSync as readFileSync4 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 import * as path9 from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
@@ -186,14 +155,11 @@ import { Command } from "commander";
 import * as fs2 from "node:fs";
 import * as path4 from "node:path";
 import {
-  analyzeSpecContributors,
-  analyzeSpecOwnership,
   applyEdits,
   categorizeDrifts,
   createSourceFile,
   DocCov,
   enrichSpec,
-  evaluatePolicies,
   findJSDocLocation,
   generateFixesForExport,
   generateReport,
@@ -201,6 +167,7 @@ import {
   NodeFileSystem,
   parseExamplesFlag,
   parseJSDocToPatch,
+  parseMarkdownFiles,
   resolveTarget,
   serializeJSDoc,
   validateExamples
@@ -208,7 +175,8 @@ import {
 import {
   DRIFT_CATEGORIES as DRIFT_CATEGORIES2
 } from "@openpkg-ts/spec";
-import chalk5 from "chalk";
+import chalk4 from "chalk";
+import { glob } from "glob";
 
 // src/reports/changelog-renderer.ts
 function renderChangelog(data, options = {}) {
@@ -649,7 +617,8 @@ function renderPRComment(data, opts = {}) {
   const { diff, headSpec } = data;
   const limit = opts.limit ?? 10;
   const lines = [];
-  const hasIssues = diff.newUndocumented.length > 0 || diff.driftIntroduced > 0 || diff.breaking.length > 0 || opts.minCoverage !== undefined && diff.newCoverage < opts.minCoverage;
+  const hasStaleRefs = (opts.staleDocsRefs?.length ?? 0) > 0;
+  const hasIssues = diff.newUndocumented.length > 0 || diff.driftIntroduced > 0 || diff.breaking.length > 0 || hasStaleRefs || opts.minCoverage !== undefined && diff.newCoverage < opts.minCoverage;
   const statusIcon = hasIssues ? diff.coverageDelta < 0 ? "❌" : "⚠️" : "✅";
   lines.push(`## ${statusIcon} DocCov — Documentation Coverage`);
   lines.push("");
@@ -661,6 +630,13 @@ function renderPRComment(data, opts = {}) {
   if (diff.driftIntroduced > 0) {
     lines.push(`**Doc drift issues:** ${diff.driftIntroduced}`);
   }
+  if (opts.staleDocsRefs && opts.staleDocsRefs.length > 0) {
+    lines.push(`**Stale doc references:** ${opts.staleDocsRefs.length}`);
+  }
+  if (opts.semverBump) {
+    const emoji = opts.semverBump.bump === "major" ? "\uD83D\uDD34" : opts.semverBump.bump === "minor" ? "\uD83D\uDFE1" : "\uD83D\uDFE2";
+    lines.push(`**Semver:** ${emoji} ${opts.semverBump.bump.toUpperCase()} (${opts.semverBump.reason})`);
+  }
   if (diff.newUndocumented.length > 0) {
     lines.push("");
     lines.push("### Undocumented exports in this PR");
@@ -673,7 +649,15 @@ function renderPRComment(data, opts = {}) {
     lines.push("");
     renderDriftIssues(lines, diff.newUndocumented, headSpec, opts, limit);
   }
-  const fixGuidance = renderFixGuidance(diff);
+  if (opts.staleDocsRefs && opts.staleDocsRefs.length > 0) {
+    lines.push("");
+    lines.push("### \uD83D\uDCDD Stale documentation references");
+    lines.push("");
+    lines.push("These markdown files reference exports that no longer exist:");
+    lines.push("");
+    renderStaleDocsRefs(lines, opts.staleDocsRefs, opts, limit);
+  }
+  const fixGuidance = renderFixGuidance(diff, opts);
   if (fixGuidance) {
     lines.push("");
     lines.push("### How to fix");
@@ -687,6 +671,16 @@ function renderPRComment(data, opts = {}) {
   renderDetailsTable(lines, diff);
   lines.push("");
   lines.push("</details>");
+  if (opts.includeBadge !== false && opts.repoUrl) {
+    const repoMatch = opts.repoUrl.match(/github\.com\/([^/]+)\/([^/]+)/);
+    if (repoMatch) {
+      const [, owner, repo] = repoMatch;
+      lines.push("");
+      lines.push("---");
+      lines.push("");
+      lines.push(`[![DocCov](https://doccov.dev/badge/${owner}/${repo})](https://doccov.dev/${owner}/${repo})`);
+    }
+  }
   return lines.join(`
 `);
 }
@@ -807,15 +801,47 @@ function getMissingSignals(exp) {
   }
   return missing;
 }
-function renderFixGuidance(diff) {
+function renderStaleDocsRefs(lines, refs, opts, limit) {
+  const byFile = new Map;
+  for (const ref of refs) {
+    const list = byFile.get(ref.file) ?? [];
+    list.push({ line: ref.line, exportName: ref.exportName });
+    byFile.set(ref.file, list);
+  }
+  let count = 0;
+  for (const [file, fileRefs] of byFile) {
+    if (count >= limit)
+      break;
+    const fileLink = buildFileLink(file, opts);
+    lines.push(`\uD83D\uDCC1 ${fileLink}`);
+    for (const ref of fileRefs) {
+      if (count >= limit)
+        break;
+      lines.push(`- Line ${ref.line}: \`${ref.exportName}\` does not exist`);
+      count++;
+    }
+    lines.push("");
+  }
+  if (refs.length > count) {
+    lines.push(`_...and ${refs.length - count} more stale references_`);
+  }
+}
+function renderFixGuidance(diff, opts) {
   const sections = [];
   if (diff.newUndocumented.length > 0) {
     sections.push(`**For undocumented exports:**
 ` + "Add JSDoc/TSDoc blocks with description, `@param`, and `@returns` tags.");
   }
   if (diff.driftIntroduced > 0) {
+    const fixableNote = opts.fixableDriftCount && opts.fixableDriftCount > 0 ? `
+
+**Quick fix:** Run \`npx doccov check --fix\` to auto-fix ${opts.fixableDriftCount} issue(s).` : "";
     sections.push(`**For doc drift:**
-` + "Update the code examples in your markdown files to match current signatures.");
+` + "Update JSDoc to match current code signatures." + fixableNote);
+  }
+  if (opts.staleDocsRefs && opts.staleDocsRefs.length > 0) {
+    sections.push(`**For stale docs:**
+` + "Update or remove code examples that reference deleted exports.");
   }
   if (diff.breaking.length > 0) {
     sections.push(`**For breaking changes:**
@@ -978,275 +1004,9 @@ function writeReports(options) {
   }));
   return results;
 }
-// src/utils/ai-client.ts
-import chalk2 from "chalk";
-
-// src/utils/ai-generate.ts
-import { createAnthropic } from "@ai-sdk/anthropic";
-import { createOpenAI } from "@ai-sdk/openai";
-import { generateObject } from "ai";
-import { z as z2 } from "zod";
-var JSDocGenerationSchema = z2.object({
-  description: z2.string().describe("1-2 sentence description of what this does"),
-  params: z2.array(z2.object({
-    name: z2.string(),
-    type: z2.string().optional(),
-    description: z2.string()
-  })).optional().describe("Parameter descriptions for functions"),
-  returns: z2.object({
-    type: z2.string().optional(),
-    description: z2.string()
-  }).optional().describe("Return value description for functions"),
-  example: z2.string().optional().describe("Working code example showing typical usage"),
-  typeParams: z2.array(z2.object({
-    name: z2.string(),
-    description: z2.string()
-  })).optional().describe("Type parameter descriptions for generics")
-});
-function getModel() {
-  const provider = process.env.DOCCOV_LLM_PROVIDER?.toLowerCase();
-  if (provider === "anthropic" || process.env.ANTHROPIC_API_KEY) {
-    const anthropic = createAnthropic();
-    return anthropic("claude-sonnet-4-20250514");
-  }
-  const openai = createOpenAI();
-  return openai("gpt-4o-mini");
-}
-function isAIGenerationAvailable() {
-  return Boolean(process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY);
-}
-function buildSignature(exp) {
-  if (exp.signatures && exp.signatures.length > 0) {
-    const sig = exp.signatures[0];
-    const params = sig.parameters?.map((p) => `${p.name}: ${p.type ?? "unknown"}`).join(", ") ?? "";
-    const ret = sig.returnType ?? "void";
-    return `(${params}) => ${ret}`;
-  }
-  if (exp.type) {
-    return typeof exp.type === "string" ? exp.type : JSON.stringify(exp.type);
-  }
-  return exp.kind;
-}
-function buildMembersContext(exp) {
-  if (!exp.members || exp.members.length === 0)
-    return "";
-  const memberLines = exp.members.slice(0, 10).map((m) => {
-    const type = m.type ? `: ${typeof m.type === "string" ? m.type : "object"}` : "";
-    return `  - ${m.name}${type}`;
-  });
-  if (exp.members.length > 10) {
-    memberLines.push(`  - ... and ${exp.members.length - 10} more members`);
-  }
-  return `
-
-Members:
-${memberLines.join(`
-`)}`;
-}
-async function generateJSDocForExport(exp) {
-  if (!isAIGenerationAvailable()) {
-    return null;
-  }
-  const signature = buildSignature(exp);
-  const membersContext = buildMembersContext(exp);
-  const prompt = `Generate JSDoc documentation for this TypeScript export.
-
-Name: ${exp.name}
-Kind: ${exp.kind}
-Signature: ${signature}${membersContext}
-
-Requirements:
-- Description: 1-2 sentences explaining what this does and when to use it
-- For functions: describe each parameter and return value
-- Example: provide a working code snippet showing typical usage
-- Be concise but informative
-
-The documentation should help developers understand the purpose and usage at a glance.`;
-  try {
-    const { object } = await generateObject({
-      model: getModel(),
-      schema: JSDocGenerationSchema,
-      prompt
-    });
-    return object;
-  } catch {
-    return null;
-  }
-}
-function toJSDocPatch(result) {
-  const patch = {};
-  if (result.description) {
-    patch.description = result.description;
-  }
-  if (result.params && result.params.length > 0) {
-    patch.params = result.params.map((p) => ({
-      name: p.name,
-      type: p.type,
-      description: p.description
-    }));
-  }
-  if (result.returns) {
-    patch.returns = {
-      type: result.returns.type,
-      description: result.returns.description
-    };
-  }
-  if (result.example) {
-    patch.examples = [result.example];
-  }
-  if (result.typeParams && result.typeParams.length > 0) {
-    patch.typeParams = result.typeParams.map((tp) => ({
-      name: tp.name,
-      description: tp.description
-    }));
-  }
-  return patch;
-}
-async function batchGenerateJSDocs(exports, options = {}) {
-  const results = [];
-  const { maxConcurrent = 3, onProgress } = options;
-  for (let i = 0;i < exports.length; i += maxConcurrent) {
-    const batch = exports.slice(i, i + maxConcurrent);
-    const promises = batch.map(async (exp) => {
-      const generated = await generateJSDocForExport(exp);
-      if (generated) {
-        onProgress?.(results.length + 1, exports.length, exp.name);
-        return {
-          exportName: exp.name,
-          patch: toJSDocPatch(generated),
-          generated: true
-        };
-      }
-      return {
-        exportName: exp.name,
-        patch: {},
-        generated: false
-      };
-    });
-    const batchResults = await Promise.all(promises);
-    results.push(...batchResults);
-  }
-  return results;
-}
-
-// src/utils/ai-client.ts
-var API_BASE = process.env.DOCCOV_API_URL || "https://api.doccov.com";
-function isHostedAPIAvailable() {
-  return Boolean(process.env.DOCCOV_API_KEY);
-}
-async function generateViaHostedAPI(exports, packageName) {
-  const apiKey = process.env.DOCCOV_API_KEY;
-  if (!apiKey) {
-    return { error: "No DOCCOV_API_KEY set" };
-  }
-  try {
-    const response = await fetch(`${API_BASE}/v1/ai/generate`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        exports: exports.map((exp) => ({
-          name: exp.name,
-          kind: exp.kind,
-          signature: buildSignature2(exp),
-          members: exp.members?.slice(0, 10).map((m) => ({
-            name: m.name,
-            type: typeof m.type === "string" ? m.type : undefined
-          }))
-        })),
-        packageName
-      })
-    });
-    if (response.status === 429) {
-      const data = await response.json();
-      return {
-        error: data.error || "Monthly AI limit reached",
-        quotaExceeded: true
-      };
-    }
-    if (!response.ok) {
-      const data = await response.json();
-      return { error: data.error || "API request failed" };
-    }
-    return await response.json();
-  } catch (err) {
-    return { error: err instanceof Error ? err.message : "Network error" };
-  }
-}
-function buildSignature2(exp) {
-  if (exp.signatures && exp.signatures.length > 0) {
-    const sig = exp.signatures[0];
-    const params = sig.parameters?.map((p) => `${p.name}: ${p.type ?? "unknown"}`).join(", ") ?? "";
-    const ret = sig.returnType ?? "void";
-    return `(${params}) => ${ret}`;
-  }
-  if (exp.type) {
-    return typeof exp.type === "string" ? exp.type : JSON.stringify(exp.type);
-  }
-  return exp.kind;
-}
-async function generateWithFallback(exports, options = {}) {
-  const { log = console.log } = options;
-  if (isHostedAPIAvailable()) {
-    log(chalk2.dim("Using DocCov hosted AI..."));
-    const hostedResult = await generateViaHostedAPI(exports, options.packageName);
-    if ("error" in hostedResult) {
-      if (hostedResult.quotaExceeded) {
-        log(chalk2.yellow(`
-⚠ ${hostedResult.error}`));
-        log(chalk2.dim("Falling back to local API keys..."));
-        if (isAIGenerationAvailable()) {
-          return await generateViaBYOK(exports, options);
-        }
-        log(chalk2.red("No local API keys configured."));
-        log(chalk2.dim("Set OPENAI_API_KEY or ANTHROPIC_API_KEY for unlimited generation."));
-        return { results: [], source: "byok" };
-      }
-      log(chalk2.yellow(`
-⚠ Hosted API error: ${hostedResult.error}`));
-      log(chalk2.dim("Falling back to local API keys..."));
-    } else {
-      const results = hostedResult.results.map((r) => ({
-        exportName: r.name,
-        patch: r.patch ?? {},
-        generated: r.patch !== null
-      }));
-      return {
-        results,
-        source: "hosted",
-        quotaRemaining: hostedResult.quota.remaining,
-        quotaResetAt: hostedResult.quota.resetAt
-      };
-    }
-  }
-  if (isAIGenerationAvailable()) {
-    return await generateViaBYOK(exports, options);
-  }
-  log(chalk2.yellow(`
-⚠ No AI configuration available.`));
-  log(chalk2.dim("Options:"));
-  log(chalk2.dim("  1. Set DOCCOV_API_KEY for hosted AI (included with Team/Pro plan)"));
-  log(chalk2.dim("  2. Set OPENAI_API_KEY or ANTHROPIC_API_KEY for direct API access"));
-  return { results: [], source: "byok" };
-}
-async function generateViaBYOK(exports, options) {
-  const { log = console.log } = options;
-  log(chalk2.dim("Using local API keys (BYOK)..."));
-  const results = await batchGenerateJSDocs(exports, {
-    maxConcurrent: options.maxConcurrent ?? 3,
-    onProgress: options.onProgress
-  });
-  return {
-    results,
-    source: "byok"
-  };
-}
-
 // src/utils/filter-options.ts
 import { mergeFilters, parseListFlag } from "@doccov/sdk";
-import chalk3 from "chalk";
+import chalk2 from "chalk";
 var parseVisibilityFlag = (value) => {
   if (!value)
     return;
@@ -1263,7 +1023,7 @@ var parseVisibilityFlag = (value) => {
   }
   return result.length > 0 ? result : undefined;
 };
-var formatList = (label, values) => `${label}: ${values.map((value) => chalk3.cyan(value)).join(", ")}`;
+var formatList = (label, values) => `${label}: ${values.map((value) => chalk2.cyan(value)).join(", ")}`;
 var mergeFilterOptions = (config, cliOptions) => {
   const messages = [];
   if (config?.include) {
@@ -1295,76 +1055,8 @@ var mergeFilterOptions = (config, cliOptions) => {
   };
 };
 
-// src/utils/llm-assertion-parser.ts
-import { createAnthropic as createAnthropic2 } from "@ai-sdk/anthropic";
-import { createOpenAI as createOpenAI2 } from "@ai-sdk/openai";
-import { generateObject as generateObject2 } from "ai";
-import { z as z3 } from "zod";
-var AssertionParseSchema = z3.object({
-  assertions: z3.array(z3.object({
-    lineNumber: z3.number().describe("1-indexed line number where the assertion appears"),
-    expected: z3.string().describe("The expected output value"),
-    originalComment: z3.string().describe("The original comment text"),
-    suggestedSyntax: z3.string().describe("The line rewritten with standard // => value syntax")
-  })).describe("List of assertion-like comments found in the code"),
-  hasAssertions: z3.boolean().describe("Whether any assertion-like comments were found")
-});
-var ASSERTION_PARSE_PROMPT = (code) => `Analyze this TypeScript/JavaScript example code for assertion-like comments.
-
-Look for comments that appear to specify expected output values, such as:
-- "// should be 3"
-- "// returns 5"
-- "// outputs: hello"
-- "// expected: [1, 2, 3]"
-- "// 42" (bare value after console.log)
-- "// result: true"
-
-Do NOT include:
-- Regular code comments that explain what the code does
-- Comments that are instructions or documentation
-- Comments with // => (already using standard syntax)
-
-For each assertion found, extract:
-1. The line number (1-indexed)
-2. The expected value (just the value, not the comment prefix)
-3. The original comment text
-4. A suggested rewrite of the ENTIRE line using "// => value" syntax
-
-Code:
-\`\`\`
-${code}
-\`\`\``;
-function getModel2() {
-  const provider = process.env.DOCCOV_LLM_PROVIDER?.toLowerCase();
-  if (provider === "anthropic" || process.env.ANTHROPIC_API_KEY) {
-    const anthropic = createAnthropic2();
-    return anthropic("claude-sonnet-4-20250514");
-  }
-  const openai = createOpenAI2();
-  return openai("gpt-4o-mini");
-}
-function isLLMAssertionParsingAvailable() {
-  return Boolean(process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY);
-}
-async function parseAssertionsWithLLM(code) {
-  if (!isLLMAssertionParsingAvailable()) {
-    return null;
-  }
-  try {
-    const model = getModel2();
-    const { object } = await generateObject2({
-      model,
-      schema: AssertionParseSchema,
-      prompt: ASSERTION_PARSE_PROMPT(code)
-    });
-    return object;
-  } catch {
-    return null;
-  }
-}
-
 // src/utils/progress.ts
-import chalk4 from "chalk";
+import chalk3 from "chalk";
 class StepProgress {
   steps;
   currentStep = 0;
@@ -1392,7 +1084,7 @@ class StepProgress {
     this.completeCurrentStep();
     if (message) {
       const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
-      console.log(`${chalk4.green("✓")} ${message} ${chalk4.dim(`(${elapsed}s)`)}`);
+      console.log(`${chalk3.green("✓")} ${message} ${chalk3.dim(`(${elapsed}s)`)}`);
     }
   }
   render() {
@@ -1400,17 +1092,17 @@ class StepProgress {
     if (!step)
       return;
     const label = step.activeLabel ?? step.label;
-    const prefix = chalk4.dim(`[${this.currentStep + 1}/${this.steps.length}]`);
-    process.stdout.write(`\r${prefix} ${chalk4.cyan(label)}...`);
+    const prefix = chalk3.dim(`[${this.currentStep + 1}/${this.steps.length}]`);
+    process.stdout.write(`\r${prefix} ${chalk3.cyan(label)}...`);
   }
   completeCurrentStep() {
     const step = this.steps[this.currentStep];
     if (!step)
       return;
     const elapsed = ((Date.now() - this.stepStartTime) / 1000).toFixed(1);
-    const prefix = chalk4.dim(`[${this.currentStep + 1}/${this.steps.length}]`);
+    const prefix = chalk3.dim(`[${this.currentStep + 1}/${this.steps.length}]`);
     process.stdout.write(`\r${" ".repeat(80)}\r`);
-    console.log(`${prefix} ${step.label} ${chalk4.green("✓")} ${chalk4.dim(`(${elapsed}s)`)}`);
+    console.log(`${prefix} ${step.label} ${chalk3.green("✓")} ${chalk3.dim(`(${elapsed}s)`)}`);
   }
 }
 
@@ -1454,10 +1146,10 @@ function registerCheckCommand(program, dependencies = {}) {
     ...defaultDependencies,
     ...dependencies
   };
-  program.command("check [entry]").description("Check documentation coverage and output reports").option("--cwd <dir>", "Working directory", process.cwd()).option("--package <name>", "Target package name (for monorepos)").option("--min-coverage <percentage>", "Minimum docs coverage percentage (0-100)", (value) => Number(value)).option("--max-drift <percentage>", "Maximum drift percentage allowed (0-100)", (value) => Number(value)).option("--examples [mode]", "Example validation: presence, typecheck, run (comma-separated). Bare flag runs all.").option("--skip-resolve", "Skip external type resolution from node_modules").option("--fix", "Auto-fix drift issues").option("--write", "Alias for --fix").option("--generate", "AI-generate missing JSDoc (requires --fix and API key)").option("--dry-run", "Preview fixes without writing (requires --fix)").option("--format <format>", "Output format: text, json, markdown, html, github", "text").option("-o, --output <file>", "Custom output path (overrides default .doccov/ path)").option("--stdout", "Output to stdout instead of writing to .doccov/").option("--update-snapshot", "Force regenerate .doccov/report.json").option("--limit <n>", "Max exports to show in report tables", "20").option("--max-type-depth <number>", "Maximum depth for type conversion (default: 20)").option("--no-cache", "Bypass spec cache and force regeneration").option("--visibility <tags>", "Filter by release stage: public,beta,alpha,internal (comma-separated)").option("--owners", "Show coverage breakdown by CODEOWNERS").option("--contributors", "Show documentation contributors (git blame)").action(async (entry, options) => {
+  program.command("check [entry]").description("Check documentation coverage and output reports").option("--cwd <dir>", "Working directory", process.cwd()).option("--package <name>", "Target package name (for monorepos)").option("--min-coverage <percentage>", "Minimum docs coverage percentage (0-100)", (value) => Number(value)).option("--max-drift <percentage>", "Maximum drift percentage allowed (0-100)", (value) => Number(value)).option("--examples [mode]", "Example validation: presence, typecheck, run (comma-separated). Bare flag runs all.").option("--skip-resolve", "Skip external type resolution from node_modules").option("--docs <glob>", "Glob pattern for markdown docs to check for stale refs", collect, []).option("--fix", "Auto-fix drift issues").option("--write", "Alias for --fix").option("--preview", "Preview fixes with diff output (implies --fix)").option("--dry-run", "Alias for --preview").option("--format <format>", "Output format: text, json, markdown, html, github", "text").option("-o, --output <file>", "Custom output path (overrides default .doccov/ path)").option("--stdout", "Output to stdout instead of writing to .doccov/").option("--update-snapshot", "Force regenerate .doccov/report.json").option("--limit <n>", "Max exports to show in report tables", "20").option("--max-type-depth <number>", "Maximum depth for type conversion (default: 20)").option("--no-cache", "Bypass spec cache and force regeneration").option("--visibility <tags>", "Filter by release stage: public,beta,alpha,internal (comma-separated)").action(async (entry, options) => {
     try {
-      const validations = parseExamplesFlag(options.examples);
-      const hasExamples = validations.length > 0;
+      let validations = parseExamplesFlag(options.examples);
+      let hasExamples = validations.length > 0;
       const stepList = [
         { label: "Resolved target", activeLabel: "Resolving target" },
         { label: "Loaded config", activeLabel: "Loading config" },
@@ -1477,8 +1169,18 @@ function registerCheckCommand(program, dependencies = {}) {
       const { targetDir, entryFile } = resolved;
       steps.next();
       const config = await loadDocCovConfig(targetDir);
-      const minCoverageRaw = options.minCoverage ?? config?.check?.minCoverage;
-      const minCoverage = minCoverageRaw !== undefined ? clampPercentage(minCoverageRaw) : undefined;
+      if (!hasExamples && config?.check?.examples) {
+        const configExamples = config.check.examples;
+        if (Array.isArray(configExamples)) {
+          validations = configExamples;
+        } else if (typeof configExamples === "string") {
+          validations = parseExamplesFlag(configExamples);
+        }
+        hasExamples = validations.length > 0;
+      }
+      const DEFAULT_MIN_COVERAGE = 80;
+      const minCoverageRaw = options.minCoverage ?? config?.check?.minCoverage ?? DEFAULT_MIN_COVERAGE;
+      const minCoverage = clampPercentage(minCoverageRaw);
       const maxDriftRaw = options.maxDrift ?? config?.check?.maxDrift;
       const maxDrift = maxDriftRaw !== undefined ? clampPercentage(maxDriftRaw) : undefined;
       const cliFilters = {
@@ -1488,7 +1190,7 @@ function registerCheckCommand(program, dependencies = {}) {
       };
       const resolvedFilters = mergeFilterOptions(config, cliFilters);
       if (resolvedFilters.visibility) {
-        log(chalk5.dim(`Filtering by visibility: ${resolvedFilters.visibility.join(", ")}`));
+        log(chalk4.dim(`Filtering by visibility: ${resolvedFilters.visibility.join(", ")}`));
       }
       steps.next();
       const resolveExternalTypes = !options.skipResolve;
@@ -1510,31 +1212,8 @@ function registerCheckCommand(program, dependencies = {}) {
       steps.next();
       const specWarnings = specResult.diagnostics.filter((d) => d.severity === "warning");
       const specInfos = specResult.diagnostics.filter((d) => d.severity === "info");
-      const shouldFix = options.fix || options.write;
-      const violations = [];
-      for (const exp of spec.exports ?? []) {
-        for (const v of exp.docs?.violations ?? []) {
-          violations.push({ exportName: exp.name, violation: v });
-        }
-      }
-      let policyResult;
-      if (config?.policies && config.policies.length > 0) {
-        policyResult = evaluatePolicies(config.policies, spec, {
-          baseDir: targetDir
-        });
-      }
-      let ownershipResult;
-      if (options.owners) {
-        ownershipResult = analyzeSpecOwnership(spec, {
-          baseDir: targetDir
-        }) ?? undefined;
-      }
-      let contributorResult;
-      if (options.contributors) {
-        contributorResult = analyzeSpecContributors(spec, {
-          baseDir: targetDir
-        }) ?? undefined;
-      }
+      const isPreview = options.preview || options.dryRun;
+      const shouldFix = options.fix || options.write || isPreview;
       let exampleResult;
       const typecheckErrors = [];
       const runtimeDrifts = [];
@@ -1544,11 +1223,7 @@ function registerCheckCommand(program, dependencies = {}) {
           packagePath: targetDir,
           exportNames: (spec.exports ?? []).map((e) => e.name),
           timeout: 5000,
-          installTimeout: 60000,
-          llmAssertionParser: isLLMAssertionParsingAvailable() ? async (example) => {
-            const result = await parseAssertionsWithLLM(example);
-            return result;
-          } : undefined
+          installTimeout: 60000
         });
         if (exampleResult.typecheck) {
           for (const err of exampleResult.typecheck.errors) {
@@ -1571,6 +1246,41 @@ function registerCheckCommand(program, dependencies = {}) {
         }
         steps.next();
       }
+      const staleRefs = [];
+      let docsPatterns = options.docs;
+      if (docsPatterns.length === 0 && config?.docs?.include) {
+        docsPatterns = config.docs.include;
+      }
+      if (docsPatterns.length > 0) {
+        const markdownFiles = await loadMarkdownFiles(docsPatterns, targetDir);
+        if (markdownFiles.length > 0) {
+          const exportNames = (spec.exports ?? []).map((e) => e.name);
+          const exportSet = new Set(exportNames);
+          for (const mdFile of markdownFiles) {
+            for (const block of mdFile.codeBlocks) {
+              const codeLines = block.code.split(`
+`);
+              for (let i = 0;i < codeLines.length; i++) {
+                const line = codeLines[i];
+                const importMatch = line.match(/import\s*\{([^}]+)\}\s*from\s*['"][^'"]*['"]/);
+                if (importMatch) {
+                  const imports = importMatch[1].split(",").map((s) => s.trim().split(/\s+/)[0]);
+                  for (const imp of imports) {
+                    if (imp && !exportSet.has(imp)) {
+                      staleRefs.push({
+                        file: mdFile.path,
+                        line: block.lineStart + i,
+                        exportName: imp,
+                        context: line.trim()
+                      });
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
       const coverageScore = spec.docs?.coverageScore ?? 0;
       const allDriftExports = [...collectDrift(spec.exports ?? []), ...runtimeDrifts];
       let driftExports = hasExamples ? allDriftExports : allDriftExports.filter((d) => d.category !== "example");
@@ -1580,12 +1290,12 @@ function registerCheckCommand(program, dependencies = {}) {
         if (allDrifts.length > 0) {
           const { fixable, nonFixable } = categorizeDrifts(allDrifts.map((d) => d.drift));
           if (fixable.length === 0) {
-            log(chalk5.yellow(`Found ${nonFixable.length} drift issue(s), but none are auto-fixable.`));
+            log(chalk4.yellow(`Found ${nonFixable.length} drift issue(s), but none are auto-fixable.`));
           } else {
             log("");
-            log(chalk5.bold(`Found ${fixable.length} fixable issue(s)`));
+            log(chalk4.bold(`Found ${fixable.length} fixable issue(s)`));
             if (nonFixable.length > 0) {
-              log(chalk5.gray(`(${nonFixable.length} non-fixable issue(s) skipped)`));
+              log(chalk4.gray(`(${nonFixable.length} non-fixable issue(s) skipped)`));
             }
             log("");
             const groupedDrifts = groupByExport(allDrifts.filter((d) => fixable.includes(d.drift)));
@@ -1593,22 +1303,22 @@ function registerCheckCommand(program, dependencies = {}) {
             const editsByFile = new Map;
             for (const [exp, drifts] of groupedDrifts) {
               if (!exp.source?.file) {
-                log(chalk5.gray(`  Skipping ${exp.name}: no source location`));
+                log(chalk4.gray(`  Skipping ${exp.name}: no source location`));
                 continue;
               }
               if (exp.source.file.endsWith(".d.ts")) {
-                log(chalk5.gray(`  Skipping ${exp.name}: declaration file`));
+                log(chalk4.gray(`  Skipping ${exp.name}: declaration file`));
                 continue;
               }
               const filePath = path4.resolve(targetDir, exp.source.file);
               if (!fs2.existsSync(filePath)) {
-                log(chalk5.gray(`  Skipping ${exp.name}: file not found`));
+                log(chalk4.gray(`  Skipping ${exp.name}: file not found`));
                 continue;
               }
               const sourceFile = createSourceFile(filePath);
               const location = findJSDocLocation(sourceFile, exp.name, exp.source.line);
               if (!location) {
-                log(chalk5.gray(`  Skipping ${exp.name}: could not find declaration`));
+                log(chalk4.gray(`  Skipping ${exp.name}: could not find declaration`));
                 continue;
               }
               let existingPatch = {};
@@ -1640,129 +1350,63 @@ function registerCheckCommand(program, dependencies = {}) {
               editsByFile.set(filePath, fileEdits);
             }
             if (edits.length > 0) {
-              if (options.dryRun) {
-                log(chalk5.bold("Dry run - changes that would be made:"));
+              if (isPreview) {
+                log(chalk4.bold("Preview - changes that would be made:"));
                 log("");
                 for (const [filePath, fileEdits] of editsByFile) {
                   const relativePath = path4.relative(targetDir, filePath);
-                  log(chalk5.cyan(`  ${relativePath}:`));
                   for (const { export: exp, edit, fixes } of fileEdits) {
-                    const lineInfo = edit.hasExisting ? `lines ${edit.startLine + 1}-${edit.endLine + 1}` : `line ${edit.startLine + 1}`;
-                    log(`    ${chalk5.bold(exp.name)} [${lineInfo}]`);
-                    for (const fix of fixes) {
-                      log(chalk5.green(`      + ${fix.description}`));
+                    log(chalk4.cyan(`${relativePath}:${edit.startLine + 1}`));
+                    log(chalk4.bold(`  ${exp.name}`));
+                    log("");
+                    if (edit.hasExisting && edit.existingJSDoc) {
+                      const oldLines = edit.existingJSDoc.split(`
+`);
+                      const newLines = edit.newJSDoc.split(`
+`);
+                      for (const line of oldLines) {
+                        log(chalk4.red(`  - ${line}`));
+                      }
+                      for (const line of newLines) {
+                        log(chalk4.green(`  + ${line}`));
+                      }
+                    } else {
+                      const newLines = edit.newJSDoc.split(`
+`);
+                      for (const line of newLines) {
+                        log(chalk4.green(`  + ${line}`));
+                      }
                     }
+                    log("");
+                    log(chalk4.dim(`  Fixes: ${fixes.map((f) => f.description).join(", ")}`));
+                    log("");
                   }
-                  log("");
                 }
-                log(chalk5.gray("Run without --dry-run to apply these changes."));
+                const totalFixes = Array.from(editsByFile.values()).reduce((sum, edits2) => sum + edits2.reduce((s, e) => s + e.fixes.length, 0), 0);
+                log(chalk4.yellow(`${totalFixes} fix(es) across ${editsByFile.size} file(s) would be applied.`));
+                log(chalk4.gray("Run with --fix to apply these changes."));
               } else {
                 const applyResult = await applyEdits(edits);
                 if (applyResult.errors.length > 0) {
                   for (const err of applyResult.errors) {
-                    error(chalk5.red(`  ${err.file}: ${err.error}`));
+                    error(chalk4.red(`  ${err.file}: ${err.error}`));
                   }
                 }
-              }
-            }
-          }
-        }
-        if (!options.dryRun) {
-          driftExports = driftExports.filter((d) => !fixedDriftKeys.has(`${d.name}:${d.issue}`));
-        }
-      }
-      const generatedExportKeys = new Set;
-      if (shouldFix && options.generate) {
-        const hasAIAccess = isHostedAPIAvailable() || isAIGenerationAvailable();
-        if (!hasAIAccess) {
-          log("");
-          log(chalk5.yellow("⚠ --generate requires AI access. Options:"));
-          log(chalk5.dim("  1. Set DOCCOV_API_KEY for hosted AI (included with Team/Pro plan)"));
-          log(chalk5.dim("  2. Set OPENAI_API_KEY or ANTHROPIC_API_KEY for direct API access"));
-        } else {
-          const undocumented = (spec.exports ?? []).filter((exp) => {
-            if (exp.description)
-              return false;
-            if (exp.source?.file?.endsWith(".d.ts"))
-              return false;
-            if (!exp.source?.file)
-              return false;
-            return true;
-          });
-          if (undocumented.length > 0) {
-            log("");
-            log(chalk5.bold(`Generating JSDoc for ${undocumented.length} undocumented export(s)`));
-            log("");
-            const aiResult = await generateWithFallback(undocumented, {
-              maxConcurrent: 3,
-              onProgress: (completed, total, name) => {
-                log(chalk5.dim(`  [${completed}/${total}] ${name}`));
-              },
-              log,
-              packageName: spec.meta?.name
-            });
-            const generated = aiResult.results;
-            const edits = [];
-            for (const result of generated) {
-              if (!result.generated)
-                continue;
-              const exp = undocumented.find((e) => e.name === result.exportName);
-              if (!exp || !exp.source?.file)
-                continue;
-              const filePath = path4.resolve(targetDir, exp.source.file);
-              if (!fs2.existsSync(filePath))
-                continue;
-              const sourceFile = createSourceFile(filePath);
-              const location = findJSDocLocation(sourceFile, exp.name, exp.source.line);
-              if (!location)
-                continue;
-              let existingPatch = {};
-              if (location.hasExisting && location.existingJSDoc) {
-                existingPatch = parseJSDocToPatch(location.existingJSDoc);
-              }
-              const mergedPatch = { ...existingPatch, ...result.patch };
-              const newJSDoc = serializeJSDoc(mergedPatch, location.indent);
-              edits.push({
-                filePath,
-                symbolName: exp.name,
-                startLine: location.startLine,
-                endLine: location.endLine,
-                hasExisting: location.hasExisting,
-                existingJSDoc: location.existingJSDoc,
-                newJSDoc,
-                indent: location.indent
-              });
-              generatedExportKeys.add(exp.name);
-            }
-            if (edits.length > 0) {
-              if (options.dryRun) {
-                log("");
-                log(chalk5.bold("Dry run - JSDoc that would be generated:"));
-                for (const edit of edits) {
-                  const relativePath = path4.relative(targetDir, edit.filePath);
-                  log(chalk5.cyan(`  ${relativePath}:`));
-                  log(`    ${chalk5.bold(edit.symbolName)} [line ${edit.startLine + 1}]`);
-                  log(chalk5.green("      + description, params, returns, example"));
-                }
+                const totalFixes = Array.from(editsByFile.values()).reduce((sum, edits2) => sum + edits2.reduce((s, e) => s + e.fixes.length, 0), 0);
                 log("");
-                log(chalk5.gray("Run without --dry-run to apply these changes."));
-              } else {
-                const applyResult = await applyEdits(edits);
-                log("");
-                log(chalk5.green(`✓ Generated JSDoc for ${edits.length} export(s)`));
-                if (aiResult.source === "hosted" && aiResult.quotaRemaining !== undefined) {
-                  const remaining = aiResult.quotaRemaining === "unlimited" ? "unlimited" : aiResult.quotaRemaining.toLocaleString();
-                  log(chalk5.dim(`  AI calls remaining: ${remaining}`));
-                }
-                if (applyResult.errors.length > 0) {
-                  for (const err of applyResult.errors) {
-                    error(chalk5.red(`  ${err.file}: ${err.error}`));
-                  }
+                log(chalk4.green(`✓ Applied ${totalFixes} fix(es) to ${applyResult.filesModified} file(s)`));
+                for (const [filePath, fileEdits] of editsByFile) {
+                  const relativePath = path4.relative(targetDir, filePath);
+                  const fixCount = fileEdits.reduce((s, e) => s + e.fixes.length, 0);
+                  log(chalk4.dim(`  ${relativePath} (${fixCount} fixes)`));
                 }
               }
             }
           }
         }
+        if (!isPreview) {
+          driftExports = driftExports.filter((d) => !fixedDriftKeys.has(`${d.name}:${d.issue}`));
+        }
       }
       steps.complete("Check complete");
       if (format !== "text") {
@@ -1784,8 +1428,7 @@ function registerCheckCommand(program, dependencies = {}) {
           case "github":
             formatContent = renderGithubSummary(stats, {
               coverageScore,
-              driftCount: driftExports.length,
-              qualityIssues: violations.length
+              driftCount: driftExports.length
             });
             break;
           default:
@@ -1805,12 +1448,10 @@ function registerCheckCommand(program, dependencies = {}) {
         const totalExportsForDrift2 = spec.exports?.length ?? 0;
         const exportsWithDrift2 = new Set(driftExports.map((d) => d.name)).size;
         const driftScore2 = totalExportsForDrift2 === 0 ? 0 : Math.round(exportsWithDrift2 / totalExportsForDrift2 * 100);
-        const coverageFailed2 = minCoverage !== undefined && coverageScore < minCoverage;
+        const coverageFailed2 = coverageScore < minCoverage;
         const driftFailed2 = maxDrift !== undefined && driftScore2 > maxDrift;
-        const hasQualityErrors2 = violations.filter((v) => v.violation.severity === "error").length > 0;
         const hasTypecheckErrors2 = typecheckErrors.length > 0;
-        const policiesFailed2 = policyResult && !policyResult.allPassed;
-        if (coverageFailed2 || driftFailed2 || hasQualityErrors2 || hasTypecheckErrors2 || policiesFailed2) {
+        if (coverageFailed2 || driftFailed2 || hasTypecheckErrors2) {
           process.exit(1);
         }
         return;
@@ -1818,49 +1459,41 @@ function registerCheckCommand(program, dependencies = {}) {
       const totalExportsForDrift = spec.exports?.length ?? 0;
       const exportsWithDrift = new Set(driftExports.map((d) => d.name)).size;
       const driftScore = totalExportsForDrift === 0 ? 0 : Math.round(exportsWithDrift / totalExportsForDrift * 100);
-      const coverageFailed = minCoverage !== undefined && coverageScore < minCoverage;
+      const coverageFailed = coverageScore < minCoverage;
       const driftFailed = maxDrift !== undefined && driftScore > maxDrift;
-      const hasQualityErrors = violations.filter((v) => v.violation.severity === "error").length > 0;
       const hasTypecheckErrors = typecheckErrors.length > 0;
-      const policiesFailed = policyResult && !policyResult.allPassed;
       if (specWarnings.length > 0 || specInfos.length > 0) {
         log("");
         for (const diag of specWarnings) {
-          log(chalk5.yellow(`⚠ ${diag.message}`));
+          log(chalk4.yellow(`⚠ ${diag.message}`));
           if (diag.suggestion) {
-            log(chalk5.gray(`  ${diag.suggestion}`));
+            log(chalk4.gray(`  ${diag.suggestion}`));
           }
         }
         for (const diag of specInfos) {
-          log(chalk5.cyan(`ℹ ${diag.message}`));
+          log(chalk4.cyan(`ℹ ${diag.message}`));
           if (diag.suggestion) {
-            log(chalk5.gray(`  ${diag.suggestion}`));
+            log(chalk4.gray(`  ${diag.suggestion}`));
           }
         }
       }
       const pkgName = spec.meta?.name ?? "unknown";
       const pkgVersion = spec.meta?.version ?? "";
       const totalExports = spec.exports?.length ?? 0;
-      const errorCount = violations.filter((v) => v.violation.severity === "error").length;
-      const warnCount = violations.filter((v) => v.violation.severity === "warn").length;
       log("");
-      log(chalk5.bold(`${pkgName}${pkgVersion ? `@${pkgVersion}` : ""}`));
+      log(chalk4.bold(`${pkgName}${pkgVersion ? `@${pkgVersion}` : ""}`));
       log("");
       log(`  Exports:    ${totalExports}`);
-      if (minCoverage !== undefined) {
-        if (coverageFailed) {
-          log(chalk5.red(`  Coverage:   ✗ ${coverageScore}%`) + chalk5.dim(` (min ${minCoverage}%)`));
-        } else {
-          log(chalk5.green(`  Coverage:   ✓ ${coverageScore}%`) + chalk5.dim(` (min ${minCoverage}%)`));
-        }
+      if (coverageFailed) {
+        log(chalk4.red(`  Coverage:   ✗ ${coverageScore}%`) + chalk4.dim(` (min ${minCoverage}%)`));
       } else {
-        log(`  Coverage:   ${coverageScore}%`);
+        log(chalk4.green(`  Coverage:   ✓ ${coverageScore}%`) + chalk4.dim(` (min ${minCoverage}%)`));
       }
       if (maxDrift !== undefined) {
         if (driftFailed) {
-          log(chalk5.red(`  Drift:      ✗ ${driftScore}%`) + chalk5.dim(` (max ${maxDrift}%)`));
+          log(chalk4.red(`  Drift:      ✗ ${driftScore}%`) + chalk4.dim(` (max ${maxDrift}%)`));
         } else {
-          log(chalk5.green(`  Drift:      ✓ ${driftScore}%`) + chalk5.dim(` (max ${maxDrift}%)`));
+          log(chalk4.green(`  Drift:      ✓ ${driftScore}%`) + chalk4.dim(` (max ${maxDrift}%)`));
         }
       } else {
         log(`  Drift:      ${driftScore}%`);
@@ -1868,103 +1501,51 @@ function registerCheckCommand(program, dependencies = {}) {
       if (exampleResult) {
         const typecheckCount = exampleResult.typecheck?.errors.length ?? 0;
         if (typecheckCount > 0) {
-          log(`  Examples:   ${typecheckCount} type errors`);
-        } else {
-          log(chalk5.green(`  Examples:   ✓ validated`));
-        }
-      }
-      if (errorCount > 0 || warnCount > 0) {
-        const parts = [];
-        if (errorCount > 0)
-          parts.push(`${errorCount} errors`);
-        if (warnCount > 0)
-          parts.push(`${warnCount} warnings`);
-        log(`  Quality:    ${parts.join(", ")}`);
-      }
-      if (policyResult && policyResult.results.length > 0) {
-        log("");
-        log(chalk5.bold("  Policies:"));
-        for (const result of policyResult.results) {
-          const status = result.passed ? chalk5.green("✓") : chalk5.red("✗");
-          const policyPath = result.policy.path;
-          const matchCount = result.matchedExports.length;
-          if (result.passed) {
-            log(`    ${status} ${policyPath} (${matchCount} exports)`);
-          } else {
-            log(`    ${status} ${policyPath} (${matchCount} exports)`);
-            for (const failure of result.failures) {
-              log(chalk5.red(`        ${failure.message}`));
-            }
+          log(chalk4.yellow(`  Examples:   ${typecheckCount} type error(s)`));
+          for (const err of typecheckErrors.slice(0, 5)) {
+            const loc = `example[${err.error.exampleIndex}]:${err.error.line}:${err.error.column}`;
+            log(chalk4.dim(`              ${err.exportName} ${loc}`));
+            log(chalk4.red(`                ${err.error.message}`));
           }
+          if (typecheckErrors.length > 5) {
+            log(chalk4.dim(`              ... and ${typecheckErrors.length - 5} more`));
+          }
+        } else {
+          log(chalk4.green(`  Examples:   ✓ validated`));
         }
       }
-      if (ownershipResult) {
-        log("");
-        log(chalk5.bold("  Owners:"));
-        const sortedOwners = [...ownershipResult.byOwner.values()].sort((a, b) => a.coverageScore - b.coverageScore);
-        for (const stats of sortedOwners) {
-          const coverageColor = stats.coverageScore >= 80 ? chalk5.green : stats.coverageScore >= 50 ? chalk5.yellow : chalk5.red;
-          const coverageStr = coverageColor(`${stats.coverageScore}%`);
-          const undocCount = stats.undocumentedExports.length;
-          log(`    ${stats.owner.padEnd(24)} ${coverageStr.padStart(12)} coverage  (${stats.totalExports} exports${undocCount > 0 ? `, ${undocCount} undoc` : ""})`);
-        }
-        if (ownershipResult.unowned.length > 0) {
-          log(chalk5.dim(`    (${ownershipResult.unowned.length} exports have no owner in CODEOWNERS)`));
-        }
-      }
-      if (contributorResult) {
-        log("");
-        log(chalk5.bold("  Contributors:"));
-        const sortedContributors = [...contributorResult.byContributor.values()].sort((a, b) => b.documentedExports - a.documentedExports);
-        const displayLimit = 10;
-        const topContributors = sortedContributors.slice(0, displayLimit);
-        for (const stats of topContributors) {
-          const name = stats.name.length > 20 ? stats.name.slice(0, 17) + "..." : stats.name;
-          const lastDate = stats.lastContribution ? stats.lastContribution.toISOString().split("T")[0] : "unknown";
-          log(`    ${name.padEnd(22)} ${String(stats.documentedExports).padStart(4)} exports  (last: ${lastDate})`);
-        }
-        if (sortedContributors.length > displayLimit) {
-          log(chalk5.dim(`    ... and ${sortedContributors.length - displayLimit} more contributors`));
+      const hasStaleRefs = staleRefs.length > 0;
+      if (hasStaleRefs) {
+        log(chalk4.yellow(`  Docs:       ${staleRefs.length} stale ref(s)`));
+        for (const ref of staleRefs.slice(0, 5)) {
+          log(chalk4.dim(`              ${ref.file}:${ref.line} - "${ref.exportName}"`));
         }
-        if (contributorResult.unattributed.length > 0) {
-          log(chalk5.dim(`    (${contributorResult.unattributed.length} exports could not be attributed via git blame)`));
+        if (staleRefs.length > 5) {
+          log(chalk4.dim(`              ... and ${staleRefs.length - 5} more`));
         }
       }
       log("");
-      const failed = coverageFailed || driftFailed || hasQualityErrors || hasTypecheckErrors || policiesFailed;
+      const failed = coverageFailed || driftFailed || hasTypecheckErrors || hasStaleRefs;
       if (!failed) {
         const thresholdParts = [];
-        if (minCoverage !== undefined) {
-          thresholdParts.push(`coverage ${coverageScore}% ≥ ${minCoverage}%`);
-        }
+        thresholdParts.push(`coverage ${coverageScore}% ≥ ${minCoverage}%`);
         if (maxDrift !== undefined) {
           thresholdParts.push(`drift ${driftScore}% ≤ ${maxDrift}%`);
         }
-        if (policyResult) {
-          thresholdParts.push(`${policyResult.passedCount}/${policyResult.totalPolicies} policies`);
-        }
-        if (thresholdParts.length > 0) {
-          log(chalk5.green(`✓ Check passed (${thresholdParts.join(", ")})`));
-        } else {
-          log(chalk5.green("✓ Check passed"));
-          log(chalk5.dim("  No thresholds configured. Use --min-coverage or --max-drift to enforce."));
-        }
+        log(chalk4.green(`✓ Check passed (${thresholdParts.join(", ")})`));
         return;
       }
-      if (hasQualityErrors) {
-        log(chalk5.red(`✗ ${errorCount} quality errors`));
-      }
       if (hasTypecheckErrors) {
-        log(chalk5.red(`✗ ${typecheckErrors.length} example type errors`));
+        log(chalk4.red(`✗ ${typecheckErrors.length} example type errors`));
       }
-      if (policiesFailed && policyResult) {
-        log(chalk5.red(`✗ ${policyResult.failedCount} policy failures`));
+      if (hasStaleRefs) {
+        log(chalk4.red(`✗ ${staleRefs.length} stale references in docs`));
       }
       log("");
-      log(chalk5.dim("Use --format json or --format markdown for detailed reports"));
+      log(chalk4.dim("Use --format json or --format markdown for detailed reports"));
       process.exit(1);
     } catch (commandError) {
-      error(chalk5.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
+      error(chalk4.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
       process.exit(1);
     }
   });
@@ -1988,6 +1569,23 @@ function collectDrift(exportsList) {
   }
   return drifts;
 }
+function collect(value, previous) {
+  return previous.concat([value]);
+}
+async function loadMarkdownFiles(patterns, cwd) {
+  const files = [];
+  for (const pattern of patterns) {
+    const matches = await glob(pattern, { nodir: true, cwd });
+    for (const filePath of matches) {
+      try {
+        const fullPath = path4.resolve(cwd, filePath);
+        const content = fs2.readFileSync(fullPath, "utf-8");
+        files.push({ path: filePath, content });
+      } catch {}
+    }
+  }
+  return parseMarkdownFiles(files);
+}
 
 // src/commands/diff.ts
 import * as fs3 from "node:fs";
@@ -1999,73 +1597,11 @@ import {
   getDocsImpactSummary,
   hasDocsImpact,
   hashString,
-  parseMarkdownFiles
+  parseMarkdownFiles as parseMarkdownFiles2
 } from "@doccov/sdk";
 import { calculateNextVersion, recommendSemverBump } from "@openpkg-ts/spec";
-import chalk6 from "chalk";
-import { glob } from "glob";
-
-// src/utils/docs-impact-ai.ts
-import { createAnthropic as createAnthropic3 } from "@ai-sdk/anthropic";
-import { createOpenAI as createOpenAI3 } from "@ai-sdk/openai";
-import { generateObject as generateObject3, generateText } from "ai";
-import { z as z4 } from "zod";
-var CodeBlockUsageSchema = z4.object({
-  isImpacted: z4.boolean().describe("Whether the code block is affected by the change"),
-  reason: z4.string().describe("Explanation of why/why not the code is impacted"),
-  usageType: z4.enum(["direct-call", "import-only", "indirect", "not-used"]).describe("How the export is used in this code block"),
-  suggestedFix: z4.string().optional().describe("If impacted, the suggested code change"),
-  confidence: z4.enum(["high", "medium", "low"]).describe("Confidence level of the analysis")
-});
-var MultiBlockAnalysisSchema = z4.object({
-  groups: z4.array(z4.object({
-    blockIndices: z4.array(z4.number()).describe("Indices of blocks that should run together"),
-    reason: z4.string().describe("Why these blocks are related")
-  })).describe("Groups of related code blocks"),
-  skippedBlocks: z4.array(z4.number()).describe("Indices of blocks that should be skipped (incomplete/illustrative)")
-});
-function getModel3() {
-  const provider = process.env.DOCCOV_LLM_PROVIDER?.toLowerCase();
-  if (provider === "anthropic" || process.env.ANTHROPIC_API_KEY) {
-    const anthropic = createAnthropic3();
-    return anthropic("claude-sonnet-4-20250514");
-  }
-  const openai = createOpenAI3();
-  return openai("gpt-4o-mini");
-}
-function isAIDocsAnalysisAvailable() {
-  return Boolean(process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY);
-}
-async function generateImpactSummary(impacts) {
-  if (!isAIDocsAnalysisAvailable()) {
-    return null;
-  }
-  if (impacts.length === 0) {
-    return "No documentation impacts detected.";
-  }
-  try {
-    const { text } = await generateText({
-      model: getModel3(),
-      prompt: `Summarize these documentation impacts for a GitHub PR comment.
-
-Impacts:
-${impacts.map((i) => `- ${i.file}: ${i.exportName} (${i.changeType})`).join(`
-`)}
-
-Write a brief, actionable summary (2-3 sentences) explaining:
-1. How many files/references are affected
-2. What type of updates are needed
-3. Priority recommendation
-
-Keep it concise and developer-friendly.`
-    });
-    return text.trim();
-  } catch {
-    return null;
-  }
-}
-
-// src/commands/diff.ts
+import chalk5 from "chalk";
+import { glob as glob2 } from "glob";
 var defaultDependencies2 = {
   readFileSync: fs3.readFileSync,
   log: console.log,
@@ -2086,11 +1622,11 @@ function getStrictChecks(preset) {
   return checks;
 }
 function registerDiffCommand(program, dependencies = {}) {
-  const { readFileSync: readFileSync2, log, error } = {
+  const { readFileSync: readFileSync3, log, error } = {
     ...defaultDependencies2,
     ...dependencies
   };
-  program.command("diff [base] [head]").description("Compare two OpenPkg specs and detect breaking changes").option("--base <file>", 'Base spec file (the "before" state)').option("--head <file>", 'Head spec file (the "after" state)').option("--format <format>", "Output format: text, json, markdown, html, github, pr-comment, changelog", "text").option("--stdout", "Output to stdout instead of writing to .doccov/").option("-o, --output <file>", "Custom output path").option("--cwd <dir>", "Working directory", process.cwd()).option("--limit <n>", "Max items to show in terminal/reports", "10").option("--repo-url <url>", "GitHub repo URL for file links (pr-comment format)").option("--sha <sha>", "Commit SHA for file links (pr-comment format)").option("--min-coverage <n>", "Minimum coverage % for HEAD spec (0-100)").option("--max-drift <n>", "Maximum drift % for HEAD spec (0-100)").option("--strict <preset>", "Fail on conditions: ci, release, quality").option("--docs <glob>", "Glob pattern for markdown docs to check for impact", collect, []).option("--ai", "Use AI for deeper analysis and fix suggestions").option("--no-cache", "Bypass cache and force regeneration").option("--recommend-version", "Output recommended semver version bump").action(async (baseArg, headArg, options) => {
+  program.command("diff [base] [head]").description("Compare two OpenPkg specs and detect breaking changes").option("--base <file>", 'Base spec file (the "before" state)').option("--head <file>", 'Head spec file (the "after" state)').option("--format <format>", "Output format: text, json, markdown, html, github, pr-comment, changelog", "text").option("--stdout", "Output to stdout instead of writing to .doccov/").option("-o, --output <file>", "Custom output path").option("--cwd <dir>", "Working directory", process.cwd()).option("--limit <n>", "Max items to show in terminal/reports", "10").option("--repo-url <url>", "GitHub repo URL for file links (pr-comment format)").option("--sha <sha>", "Commit SHA for file links (pr-comment format)").option("--min-coverage <n>", "Minimum coverage % for HEAD spec (0-100)").option("--max-drift <n>", "Maximum drift % for HEAD spec (0-100)").option("--strict <preset>", "Fail on conditions: ci, release, quality").option("--docs <glob>", "Glob pattern for markdown docs to check for impact", collect2, []).option("--no-cache", "Bypass cache and force regeneration").option("--recommend-version", "Output recommended semver version bump").action(async (baseArg, headArg, options) => {
     try {
       const baseFile = options.base ?? baseArg;
       const headFile = options.head ?? headArg;
@@ -2099,8 +1635,8 @@ function registerDiffCommand(program, dependencies = {}) {
 ` + `Usage: doccov diff <base> <head>
 ` + "   or: doccov diff --base main.json --head feature.json");
       }
-      const baseSpec = loadSpec(baseFile, readFileSync2);
-      const headSpec = loadSpec(headFile, readFileSync2);
+      const baseSpec = loadSpec(baseFile, readFileSync3);
+      const headSpec = loadSpec(headFile, readFileSync3);
       const config = await loadDocCovConfig(options.cwd);
       const baseHash = hashString(JSON.stringify(baseSpec));
       const headHash = hashString(JSON.stringify(headSpec));
@@ -2137,9 +1673,9 @@ function registerDiffCommand(program, dependencies = {}) {
           }, null, 2));
         } else {
           log("");
-          log(chalk6.bold("Semver Recommendation"));
+          log(chalk5.bold("Semver Recommendation"));
           log(`  Current version:    ${currentVersion}`);
-          log(`  Recommended:        ${chalk6.cyan(nextVersion)} (${chalk6.yellow(recommendation.bump.toUpperCase())})`);
+          log(`  Recommended:        ${chalk5.cyan(nextVersion)} (${chalk5.yellow(recommendation.bump.toUpperCase())})`);
           log(`  Reason:             ${recommendation.reason}`);
         }
         return;
@@ -2157,9 +1693,6 @@ function registerDiffCommand(program, dependencies = {}) {
       switch (format) {
         case "text":
           printSummary(diff, baseName, headName, fromCache, log);
-          if (options.ai && diff.docsImpact && hasDocsImpact(diff)) {
-            await printAISummary(diff, log);
-          }
           if (!options.stdout) {
             const jsonPath = getDiffReportPath(baseHash, headHash, "json");
             if (!fromCache) {
@@ -2171,8 +1704,8 @@ function registerDiffCommand(program, dependencies = {}) {
                 silent: true
               });
             }
-            const cacheNote = fromCache ? chalk6.cyan(" (cached)") : "";
-            log(chalk6.dim(`Report: ${jsonPath}`) + cacheNote);
+            const cacheNote = fromCache ? chalk5.cyan(" (cached)") : "";
+            log(chalk5.dim(`Report: ${jsonPath}`) + cacheNote);
           }
           break;
         case "json": {
@@ -2224,11 +1757,13 @@ function registerDiffCommand(program, dependencies = {}) {
           printGitHubAnnotations(diff, log);
           break;
         case "pr-comment": {
+          const semverRecommendation = recommendSemverBump(diff);
           const content = renderPRComment({ diff, baseName, headName, headSpec }, {
             repoUrl: options.repoUrl,
             sha: options.sha,
             minCoverage,
-            limit
+            limit,
+            semverBump: { bump: semverRecommendation.bump, reason: semverRecommendation.reason }
           });
           log(content);
           break;
@@ -2262,29 +1797,29 @@ function registerDiffCommand(program, dependencies = {}) {
         checks
       });
       if (failures.length > 0) {
-        log(chalk6.red(`
+        log(chalk5.red(`
 ✗ Check failed`));
         for (const f of failures) {
-          log(chalk6.red(`  - ${f}`));
+          log(chalk5.red(`  - ${f}`));
         }
         process.exitCode = 1;
       } else if (options.strict || minCoverage !== undefined || maxDrift !== undefined) {
-        log(chalk6.green(`
+        log(chalk5.green(`
 ✓ All checks passed`));
       }
     } catch (commandError) {
-      error(chalk6.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
+      error(chalk5.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
       process.exitCode = 1;
     }
   });
 }
-function collect(value, previous) {
+function collect2(value, previous) {
   return previous.concat([value]);
 }
-async function loadMarkdownFiles(patterns) {
+async function loadMarkdownFiles2(patterns) {
   const files = [];
   for (const pattern of patterns) {
-    const matches = await glob(pattern, { nodir: true });
+    const matches = await glob2(pattern, { nodir: true });
     for (const filePath of matches) {
       try {
         const content = fs3.readFileSync(filePath, "utf-8");
@@ -2292,7 +1827,7 @@ async function loadMarkdownFiles(patterns) {
       } catch {}
     }
   }
-  return parseMarkdownFiles(files);
+  return parseMarkdownFiles2(files);
 }
 async function generateDiff(baseSpec, headSpec, options, config, log) {
   let markdownFiles;
@@ -2300,21 +1835,21 @@ async function generateDiff(baseSpec, headSpec, options, config, log) {
   if (!docsPatterns || docsPatterns.length === 0) {
     if (config?.docs?.include) {
       docsPatterns = config.docs.include;
-      log(chalk6.gray(`Using docs patterns from config: ${docsPatterns.join(", ")}`));
+      log(chalk5.gray(`Using docs patterns from config: ${docsPatterns.join(", ")}`));
     }
   }
   if (docsPatterns && docsPatterns.length > 0) {
-    markdownFiles = await loadMarkdownFiles(docsPatterns);
+    markdownFiles = await loadMarkdownFiles2(docsPatterns);
   }
   return diffSpecWithDocs(baseSpec, headSpec, { markdownFiles });
 }
-function loadSpec(filePath, readFileSync2) {
+function loadSpec(filePath, readFileSync3) {
   const resolvedPath = path5.resolve(filePath);
   if (!fs3.existsSync(resolvedPath)) {
     throw new Error(`File not found: ${filePath}`);
   }
   try {
-    const content = readFileSync2(resolvedPath, "utf-8");
+    const content = readFileSync3(resolvedPath, "utf-8");
     const spec = JSON.parse(content);
     return ensureSpecCoverage(spec);
   } catch (parseError) {
@@ -2323,60 +1858,40 @@ function loadSpec(filePath, readFileSync2) {
 }
 function printSummary(diff, baseName, headName, fromCache, log) {
   log("");
-  const cacheIndicator = fromCache ? chalk6.cyan(" (cached)") : "";
-  log(chalk6.bold(`Comparing: ${baseName} → ${headName}`) + cacheIndicator);
+  const cacheIndicator = fromCache ? chalk5.cyan(" (cached)") : "";
+  log(chalk5.bold(`Comparing: ${baseName} → ${headName}`) + cacheIndicator);
   log("─".repeat(40));
   log("");
-  const coverageColor = diff.coverageDelta > 0 ? chalk6.green : diff.coverageDelta < 0 ? chalk6.red : chalk6.gray;
+  const coverageColor = diff.coverageDelta > 0 ? chalk5.green : diff.coverageDelta < 0 ? chalk5.red : chalk5.gray;
   const coverageSign = diff.coverageDelta > 0 ? "+" : "";
   log(`  Coverage:   ${diff.oldCoverage}% → ${diff.newCoverage}% ${coverageColor(`(${coverageSign}${diff.coverageDelta}%)`)}`);
   const breakingCount = diff.breaking.length;
   const highSeverity = diff.categorizedBreaking?.filter((c) => c.severity === "high").length ?? 0;
   if (breakingCount > 0) {
-    const severityNote = highSeverity > 0 ? chalk6.red(` (${highSeverity} high severity)`) : "";
-    log(`  Breaking:   ${chalk6.red(breakingCount)} changes${severityNote}`);
+    const severityNote = highSeverity > 0 ? chalk5.red(` (${highSeverity} high severity)`) : "";
+    log(`  Breaking:   ${chalk5.red(breakingCount)} changes${severityNote}`);
   } else {
-    log(`  Breaking:   ${chalk6.green("0")} changes`);
+    log(`  Breaking:   ${chalk5.green("0")} changes`);
   }
   const newCount = diff.nonBreaking.length;
   const undocCount = diff.newUndocumented.length;
   if (newCount > 0) {
-    const undocNote = undocCount > 0 ? chalk6.yellow(` (${undocCount} undocumented)`) : "";
-    log(`  New:        ${chalk6.green(newCount)} exports${undocNote}`);
+    const undocNote = undocCount > 0 ? chalk5.yellow(` (${undocCount} undocumented)`) : "";
+    log(`  New:        ${chalk5.green(newCount)} exports${undocNote}`);
   }
   if (diff.driftIntroduced > 0 || diff.driftResolved > 0) {
     const parts = [];
     if (diff.driftIntroduced > 0)
-      parts.push(chalk6.red(`+${diff.driftIntroduced}`));
+      parts.push(chalk5.red(`+${diff.driftIntroduced}`));
     if (diff.driftResolved > 0)
-      parts.push(chalk6.green(`-${diff.driftResolved}`));
+      parts.push(chalk5.green(`-${diff.driftResolved}`));
     log(`  Drift:      ${parts.join(", ")}`);
   }
+  const recommendation = recommendSemverBump(diff);
+  const bumpColor = recommendation.bump === "major" ? chalk5.red : recommendation.bump === "minor" ? chalk5.yellow : chalk5.green;
+  log(`  Semver:     ${bumpColor(recommendation.bump.toUpperCase())} (${recommendation.reason})`);
   log("");
 }
-async function printAISummary(diff, log) {
-  if (!isAIDocsAnalysisAvailable()) {
-    log(chalk6.yellow(`
-⚠ AI analysis unavailable (set OPENAI_API_KEY or ANTHROPIC_API_KEY)`));
-    return;
-  }
-  if (!diff.docsImpact)
-    return;
-  log(chalk6.gray(`
-Generating AI summary...`));
-  const impacts = diff.docsImpact.impactedFiles.flatMap((f) => f.references.map((r) => ({
-    file: f.file,
-    exportName: r.exportName,
-    changeType: r.changeType,
-    context: r.context
-  })));
-  const summary = await generateImpactSummary(impacts);
-  if (summary) {
-    log("");
-    log(chalk6.bold("AI Summary"));
-    log(chalk6.cyan(`  ${summary}`));
-  }
-}
 function validateDiff(diff, headSpec, options) {
   const { minCoverage, maxDrift, checks } = options;
   const failures = [];
@@ -2455,7 +1970,7 @@ function printGitHubAnnotations(diff, log) {
 
 // src/commands/info.ts
 import { DocCov as DocCov2, enrichSpec as enrichSpec2, NodeFileSystem as NodeFileSystem2, resolveTarget as resolveTarget2 } from "@doccov/sdk";
-import chalk7 from "chalk";
+import chalk6 from "chalk";
 function registerInfoCommand(program) {
   program.command("info [entry]").description("Show brief documentation coverage summary").option("--cwd <dir>", "Working directory", process.cwd()).option("--package <name>", "Target package name (for monorepos)").option("--skip-resolve", "Skip external type resolution from node_modules").action(async (entry, options) => {
     try {
@@ -2477,14 +1992,14 @@ function registerInfoCommand(program) {
       const spec = enrichSpec2(specResult.spec);
       const stats = computeStats(spec);
       console.log("");
-      console.log(chalk7.bold(`${stats.packageName}@${stats.version}`));
+      console.log(chalk6.bold(`${stats.packageName}@${stats.version}`));
       console.log("");
-      console.log(`  Exports:    ${chalk7.bold(stats.totalExports.toString())}`);
-      console.log(`  Coverage:   ${chalk7.bold(`${stats.coverageScore}%`)}`);
-      console.log(`  Drift:      ${chalk7.bold(`${stats.driftScore}%`)}`);
+      console.log(`  Exports:    ${chalk6.bold(stats.totalExports.toString())}`);
+      console.log(`  Coverage:   ${chalk6.bold(`${stats.coverageScore}%`)}`);
+      console.log(`  Drift:      ${chalk6.bold(`${stats.driftScore}%`)}`);
       console.log("");
     } catch (err) {
-      console.error(chalk7.red("Error:"), err instanceof Error ? err.message : err);
+      console.error(chalk6.red("Error:"), err instanceof Error ? err.message : err);
       process.exit(1);
     }
   });
@@ -2493,53 +2008,65 @@ function registerInfoCommand(program) {
 // src/commands/init.ts
 import * as fs4 from "node:fs";
 import * as path6 from "node:path";
-import chalk8 from "chalk";
+import chalk7 from "chalk";
 var defaultDependencies3 = {
   fileExists: fs4.existsSync,
   writeFileSync: fs4.writeFileSync,
   readFileSync: fs4.readFileSync,
+  mkdirSync: fs4.mkdirSync,
   log: console.log,
   error: console.error
 };
 function registerInitCommand(program, dependencies = {}) {
-  const { fileExists: fileExists2, writeFileSync: writeFileSync3, readFileSync: readFileSync3, log, error } = {
+  const { fileExists: fileExists2, writeFileSync: writeFileSync3, readFileSync: readFileSync4, mkdirSync: mkdirSync3, log, error } = {
     ...defaultDependencies3,
     ...dependencies
   };
-  program.command("init").description("Create a DocCov configuration file").option("--cwd <dir>", "Working directory", process.cwd()).option("--format <format>", "Config format: auto, mjs, js, cjs, yaml", "auto").action((options) => {
+  program.command("init").description("Initialize DocCov: config, GitHub Action, and badge").option("--cwd <dir>", "Working directory", process.cwd()).option("--skip-action", "Skip GitHub Action workflow creation").action((options) => {
     const cwd = path6.resolve(options.cwd);
-    const formatOption = String(options.format ?? "auto").toLowerCase();
-    if (!isValidFormat(formatOption)) {
-      error(chalk8.red(`Invalid format "${formatOption}". Use auto, mjs, js, cjs, or yaml.`));
-      process.exitCode = 1;
-      return;
-    }
     const existing = findExistingConfig(cwd, fileExists2);
     if (existing) {
-      error(chalk8.red(`A DocCov config already exists at ${path6.relative(cwd, existing) || "./doccov.config.*"}.`));
+      error(chalk7.red(`A DocCov config already exists at ${path6.relative(cwd, existing) || "./doccov.config.*"}.`));
       process.exitCode = 1;
       return;
     }
-    const packageType = detectPackageType(cwd, fileExists2, readFileSync3);
-    const targetFormat = resolveFormat(formatOption, packageType);
-    if (targetFormat === "js" && packageType !== "module") {
-      log(chalk8.yellow('Package is not marked as "type": "module"; creating doccov.config.js may require enabling ESM.'));
-    }
-    const fileName = targetFormat === "yaml" ? "doccov.yml" : `doccov.config.${targetFormat}`;
+    const packageType = detectPackageType(cwd, fileExists2, readFileSync4);
+    const targetFormat = packageType === "module" ? "ts" : "mts";
+    const fileName = `doccov.config.${targetFormat}`;
     const outputPath = path6.join(cwd, fileName);
     if (fileExists2(outputPath)) {
-      error(chalk8.red(`Cannot create ${fileName}; file already exists.`));
+      error(chalk7.red(`Cannot create ${fileName}; file already exists.`));
       process.exitCode = 1;
       return;
     }
-    const template = buildTemplate(targetFormat);
+    const template = buildConfigTemplate();
     writeFileSync3(outputPath, template, { encoding: "utf8" });
-    log(chalk8.green(`✓ Created ${path6.relative(process.cwd(), outputPath)}`));
+    log(chalk7.green(`✓ Created ${fileName}`));
+    if (!options.skipAction) {
+      const workflowDir = path6.join(cwd, ".github", "workflows");
+      const workflowPath = path6.join(workflowDir, "doccov.yml");
+      if (!fileExists2(workflowPath)) {
+        mkdirSync3(workflowDir, { recursive: true });
+        writeFileSync3(workflowPath, buildWorkflowTemplate(), { encoding: "utf8" });
+        log(chalk7.green(`✓ Created .github/workflows/doccov.yml`));
+      } else {
+        log(chalk7.yellow(`  Skipped .github/workflows/doccov.yml (already exists)`));
+      }
+    }
+    const repoInfo = detectRepoInfo(cwd, fileExists2, readFileSync4);
+    log("");
+    log(chalk7.bold("Add this badge to your README:"));
+    log("");
+    if (repoInfo) {
+      log(chalk7.cyan(`[![DocCov](https://doccov.dev/badge/${repoInfo.owner}/${repoInfo.repo})](https://doccov.dev/${repoInfo.owner}/${repoInfo.repo})`));
+    } else {
+      log(chalk7.cyan(`[![DocCov](https://doccov.dev/badge/OWNER/REPO)](https://doccov.dev/OWNER/REPO)`));
+      log(chalk7.dim("  Replace OWNER/REPO with your GitHub repo"));
+    }
+    log("");
+    log(chalk7.dim("Run `doccov check` to verify your documentation coverage"));
   });
 }
-var isValidFormat = (value) => {
-  return ["auto", "mjs", "js", "cjs", "yaml"].includes(value);
-};
 var findExistingConfig = (cwd, fileExists2) => {
   let current = path6.resolve(cwd);
   const { root } = path6.parse(current);
@@ -2557,13 +2084,13 @@ var findExistingConfig = (cwd, fileExists2) => {
   }
   return null;
 };
-var detectPackageType = (cwd, fileExists2, readFileSync3) => {
+var detectPackageType = (cwd, fileExists2, readFileSync4) => {
   const packageJsonPath = findNearestPackageJson(cwd, fileExists2);
   if (!packageJsonPath) {
     return;
   }
   try {
-    const raw = readFileSync3(packageJsonPath, "utf8");
+    const raw = readFileSync4(packageJsonPath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.type === "module") {
       return "module";
@@ -2589,80 +2116,75 @@ var findNearestPackageJson = (cwd, fileExists2) => {
   }
   return null;
 };
-var resolveFormat = (format, packageType) => {
-  if (format === "yaml")
-    return "yaml";
-  if (format === "auto") {
-    return packageType === "module" ? "js" : "mjs";
-  }
-  return format;
-};
-var buildTemplate = (format) => {
-  if (format === "yaml") {
-    return `# doccov.yml
-# include:
-#   - "MyClass"
-#   - "myFunction"
-# exclude:
-#   - "internal*"
-
-check:
-  # minCoverage: 80
-  # maxDrift: 20
-  # examples: typecheck
+var buildConfigTemplate = () => {
+  return `import { defineConfig } from '@doccov/cli/config';
 
-quality:
-  rules:
-    # has-description: warn
-    # has-params: off
-    # has-returns: off
-`;
-  }
-  const configBody = `{
-  // Filter which exports to analyze
+export default defineConfig({
+  // Filter exports to analyze (optional)
   // include: ['MyClass', 'myFunction'],
   // exclude: ['internal*'],
 
-  // Check command thresholds
   check: {
-    // Minimum documentation coverage percentage (0-100)
-    // minCoverage: 80,
+    // Fail if coverage drops below threshold
+    minCoverage: 80,
 
-    // Maximum drift percentage allowed (0-100)
+    // Fail if drift exceeds threshold
     // maxDrift: 20,
-
-    // Example validation: 'presence' | 'typecheck' | 'run'
-    // examples: 'typecheck',
   },
+});
+`;
+};
+var buildWorkflowTemplate = () => {
+  return `name: DocCov
 
-  // Quality rule severities: 'error' | 'warn' | 'off'
-  quality: {
-    rules: {
-      // 'has-description': 'warn',
-      // 'has-params': 'off',
-      // 'has-returns': 'off',
-      // 'has-examples': 'off',
-      // 'no-empty-returns': 'warn',
-      // 'consistent-param-style': 'off',
-    },
-  },
-}`;
-  if (format === "cjs") {
-    return [
-      "const { defineConfig } = require('@doccov/cli/config');",
-      "",
-      `module.exports = defineConfig(${configBody});`,
-      ""
-    ].join(`
-`);
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  doccov:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: doccov/action@v1
+        with:
+          min-coverage: 80
+          comment-on-pr: true
+`;
+};
+var detectRepoInfo = (cwd, fileExists2, readFileSync4) => {
+  const packageJsonPath = findNearestPackageJson(cwd, fileExists2);
+  if (packageJsonPath) {
+    try {
+      const raw = readFileSync4(packageJsonPath, "utf8");
+      const parsed = JSON.parse(raw);
+      let repoUrl;
+      if (typeof parsed.repository === "string") {
+        repoUrl = parsed.repository;
+      } else if (parsed.repository?.url) {
+        repoUrl = parsed.repository.url;
+      }
+      if (repoUrl) {
+        const match = repoUrl.match(/github\.com[/:]([^/]+)\/([^/.]+)/);
+        if (match) {
+          return { owner: match[1], repo: match[2] };
+        }
+      }
+    } catch {}
   }
-  return [
-    "import { defineConfig } from '@doccov/cli/config';",
-    "",
-    `export default defineConfig(${configBody});`,
-    ""
-  ].join(`
-`);
+  const gitConfigPath = path6.join(cwd, ".git", "config");
+  if (fileExists2(gitConfigPath)) {
+    try {
+      const config = readFileSync4(gitConfigPath, "utf8");
+      const match = config.match(/url\s*=\s*.*github\.com[/:]([^/]+)\/([^/.]+)/);
+      if (match) {
+        return { owner: match[1], repo: match[2].replace(/\.git$/, "") };
+      }
+    } catch {}
+  }
+  return null;
 };
 
 // src/commands/spec.ts
@@ -2670,9 +2192,9 @@ import * as fs5 from "node:fs";
 import * as path7 from "node:path";
 import { DocCov as DocCov3, NodeFileSystem as NodeFileSystem3, renderApiSurface, resolveTarget as resolveTarget3 } from "@doccov/sdk";
 import { normalize, validateSpec } from "@openpkg-ts/spec";
-import chalk9 from "chalk";
+import chalk8 from "chalk";
 // package.json
-var version = "0.17.0";
+var version = "0.19.0";
 
 // src/commands/spec.ts
 var defaultDependencies4 = {
@@ -2687,7 +2209,7 @@ function getArrayLength(value) {
 function formatDiagnosticOutput(prefix, diagnostic, baseDir) {
   const location = diagnostic.location;
   const relativePath = location?.file ? path7.relative(baseDir, location.file) || location.file : undefined;
-  const locationText = location && relativePath ? chalk9.gray(`${relativePath}:${location.line ?? 1}:${location.column ?? 1}`) : null;
+  const locationText = location && relativePath ? chalk8.gray(`${relativePath}:${location.line ?? 1}:${location.column ?? 1}`) : null;
   const locationPrefix = locationText ? `${locationText} ` : "";
   return `${prefix} ${locationPrefix}${diagnostic.message}`;
 }
@@ -2696,7 +2218,7 @@ function registerSpecCommand(program, dependencies = {}) {
     ...defaultDependencies4,
     ...dependencies
   };
-  program.command("spec [entry]").description("Generate OpenPkg specification (JSON)").option("--cwd <dir>", "Working directory", process.cwd()).option("-p, --package <name>", "Target package name (for monorepos)").option("-o, --output <file>", "Output file path", "openpkg.json").option("-f, --format <format>", "Output format: json (default) or api-surface", "json").option("--include <patterns>", "Include exports matching pattern (comma-separated)").option("--exclude <patterns>", "Exclude exports matching pattern (comma-separated)").option("--visibility <tags>", "Filter by release stage: public,beta,alpha,internal (comma-separated)").option("--skip-resolve", "Skip external type resolution from node_modules").option("--max-type-depth <n>", "Maximum depth for type conversion", "20").option("--no-cache", "Bypass spec cache and force regeneration").option("--show-diagnostics", "Show TypeScript compiler diagnostics").option("--verbose", "Show detailed generation metadata").action(async (entry, options) => {
+  program.command("spec [entry]").description("Generate OpenPkg specification (JSON)").option("--cwd <dir>", "Working directory", process.cwd()).option("-p, --package <name>", "Target package name (for monorepos)").option("-o, --output <file>", "Output file path", "openpkg.json").option("-f, --format <format>", "Output format: json (default) or api-surface", "json").option("--include <patterns>", "Include exports matching pattern (comma-separated)").option("--exclude <patterns>", "Exclude exports matching pattern (comma-separated)").option("--visibility <tags>", "Filter by release stage: public,beta,alpha,internal (comma-separated)").option("--skip-resolve", "Skip external type resolution from node_modules").option("--max-type-depth <n>", "Maximum depth for type conversion", "20").option("--runtime", "Enable Standard Schema runtime extraction (richer output for Zod, Valibot, etc.)").option("--no-cache", "Bypass spec cache and force regeneration").option("--show-diagnostics", "Show TypeScript compiler diagnostics").option("--verbose", "Show detailed generation metadata").action(async (entry, options) => {
     try {
       const steps = new StepProgress([
         { label: "Resolved target", activeLabel: "Resolving target" },
@@ -2718,7 +2240,7 @@ function registerSpecCommand(program, dependencies = {}) {
       try {
         config = await loadDocCovConfig(targetDir);
       } catch (configError) {
-        error(chalk9.red("Failed to load DocCov config:"), configError instanceof Error ? configError.message : configError);
+        error(chalk8.red("Failed to load DocCov config:"), configError instanceof Error ? configError.message : configError);
         process.exit(1);
       }
       steps.next();
@@ -2733,7 +2255,8 @@ function registerSpecCommand(program, dependencies = {}) {
         resolveExternalTypes,
         maxDepth: options.maxTypeDepth ? parseInt(options.maxTypeDepth, 10) : undefined,
         useCache: options.cache !== false,
-        cwd: options.cwd
+        cwd: options.cwd,
+        schemaExtraction: options.runtime ? "hybrid" : "static"
       });
       const generationInput = {
         entryPoint: path7.relative(targetDir, entryFile),
@@ -2761,9 +2284,9 @@ function registerSpecCommand(program, dependencies = {}) {
       const normalized = normalize(result.spec);
       const validation = validateSpec(normalized);
       if (!validation.ok) {
-        error(chalk9.red("Spec failed schema validation"));
+        error(chalk8.red("Spec failed schema validation"));
         for (const err of validation.errors) {
-          error(chalk9.red(`schema: ${err.instancePath || "/"} ${err.message}`));
+          error(chalk8.red(`schema: ${err.instancePath || "/"} ${err.message}`));
         }
         process.exit(1);
       }
@@ -2778,55 +2301,62 @@ function registerSpecCommand(program, dependencies = {}) {
         writeFileSync4(outputPath, JSON.stringify(normalized, null, 2));
         steps.complete(`Generated ${options.output}`);
       }
-      log(chalk9.gray(`  ${getArrayLength(normalized.exports)} exports`));
-      log(chalk9.gray(`  ${getArrayLength(normalized.types)} types`));
+      log(chalk8.gray(`  ${getArrayLength(normalized.exports)} exports`));
+      log(chalk8.gray(`  ${getArrayLength(normalized.types)} types`));
       if (options.verbose && normalized.generation) {
         const gen = normalized.generation;
         log("");
-        log(chalk9.bold("Generation Info"));
-        log(chalk9.gray(`  Timestamp:        ${gen.timestamp}`));
-        log(chalk9.gray(`  Generator:        ${gen.generator.name}@${gen.generator.version}`));
-        log(chalk9.gray(`  Entry point:      ${gen.analysis.entryPoint}`));
-        log(chalk9.gray(`  Detected via:     ${gen.analysis.entryPointSource}`));
-        log(chalk9.gray(`  Declaration only: ${gen.analysis.isDeclarationOnly ? "yes" : "no"}`));
-        log(chalk9.gray(`  External types:   ${gen.analysis.resolvedExternalTypes ? "resolved" : "skipped"}`));
+        log(chalk8.bold("Generation Info"));
+        log(chalk8.gray(`  Timestamp:        ${gen.timestamp}`));
+        log(chalk8.gray(`  Generator:        ${gen.generator.name}@${gen.generator.version}`));
+        log(chalk8.gray(`  Entry point:      ${gen.analysis.entryPoint}`));
+        log(chalk8.gray(`  Detected via:     ${gen.analysis.entryPointSource}`));
+        log(chalk8.gray(`  Declaration only: ${gen.analysis.isDeclarationOnly ? "yes" : "no"}`));
+        log(chalk8.gray(`  External types:   ${gen.analysis.resolvedExternalTypes ? "resolved" : "skipped"}`));
         if (gen.analysis.maxTypeDepth) {
-          log(chalk9.gray(`  Max type depth:   ${gen.analysis.maxTypeDepth}`));
+          log(chalk8.gray(`  Max type depth:   ${gen.analysis.maxTypeDepth}`));
+        }
+        if (gen.analysis.schemaExtraction) {
+          const se = gen.analysis.schemaExtraction;
+          log(chalk8.gray(`  Schema extraction: ${se.method}`));
+          if (se.runtimeCount) {
+            log(chalk8.gray(`  Runtime schemas:   ${se.runtimeCount} (${se.vendors?.join(", ")})`));
+          }
         }
         log("");
-        log(chalk9.bold("Environment"));
-        log(chalk9.gray(`  node_modules:     ${gen.environment.hasNodeModules ? "found" : "not found"}`));
+        log(chalk8.bold("Environment"));
+        log(chalk8.gray(`  node_modules:     ${gen.environment.hasNodeModules ? "found" : "not found"}`));
         if (gen.environment.packageManager) {
-          log(chalk9.gray(`  Package manager:  ${gen.environment.packageManager}`));
+          log(chalk8.gray(`  Package manager:  ${gen.environment.packageManager}`));
         }
         if (gen.environment.isMonorepo) {
-          log(chalk9.gray(`  Monorepo:         yes`));
+          log(chalk8.gray(`  Monorepo:         yes`));
         }
         if (gen.environment.targetPackage) {
-          log(chalk9.gray(`  Target package:   ${gen.environment.targetPackage}`));
+          log(chalk8.gray(`  Target package:   ${gen.environment.targetPackage}`));
         }
         if (gen.issues.length > 0) {
           log("");
-          log(chalk9.bold("Issues"));
+          log(chalk8.bold("Issues"));
           for (const issue of gen.issues) {
-            const prefix = issue.severity === "error" ? chalk9.red(">") : issue.severity === "warning" ? chalk9.yellow(">") : chalk9.cyan(">");
+            const prefix = issue.severity === "error" ? chalk8.red(">") : issue.severity === "warning" ? chalk8.yellow(">") : chalk8.cyan(">");
             log(`${prefix} [${issue.code}] ${issue.message}`);
             if (issue.suggestion) {
-              log(chalk9.gray(`    ${issue.suggestion}`));
+              log(chalk8.gray(`    ${issue.suggestion}`));
             }
           }
         }
       }
       if (options.showDiagnostics && result.diagnostics.length > 0) {
         log("");
-        log(chalk9.bold("Diagnostics"));
+        log(chalk8.bold("Diagnostics"));
         for (const diagnostic of result.diagnostics) {
-          const prefix = diagnostic.severity === "error" ? chalk9.red(">") : diagnostic.severity === "warning" ? chalk9.yellow(">") : chalk9.cyan(">");
+          const prefix = diagnostic.severity === "error" ? chalk8.red(">") : diagnostic.severity === "warning" ? chalk8.yellow(">") : chalk8.cyan(">");
           log(formatDiagnosticOutput(prefix, diagnostic, targetDir));
         }
       }
     } catch (commandError) {
-      error(chalk9.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
+      error(chalk8.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
       process.exit(1);
     }
   });
@@ -2846,7 +2376,7 @@ import {
   RETENTION_DAYS,
   saveSnapshot
 } from "@doccov/sdk";
-import chalk10 from "chalk";
+import chalk9 from "chalk";
 function formatDate(timestamp) {
   const date = new Date(timestamp);
   return date.toLocaleDateString("en-US", {
@@ -2859,19 +2389,19 @@ function formatDate(timestamp) {
 }
 function getColorForScore(score) {
   if (score >= 90)
-    return chalk10.green;
+    return chalk9.green;
   if (score >= 70)
-    return chalk10.yellow;
+    return chalk9.yellow;
   if (score >= 50)
-    return chalk10.hex("#FFA500");
-  return chalk10.red;
+    return chalk9.hex("#FFA500");
+  return chalk9.red;
 }
 function formatSnapshot(snapshot) {
   const color = getColorForScore(snapshot.coverageScore);
   const date = formatDate(snapshot.timestamp);
   const version2 = snapshot.version ? ` v${snapshot.version}` : "";
-  const commit = snapshot.commit ? chalk10.gray(` (${snapshot.commit.slice(0, 7)})`) : "";
-  return `${chalk10.gray(date)}  ${color(`${snapshot.coverageScore}%`)}  ${snapshot.documentedExports}/${snapshot.totalExports} exports${version2}${commit}`;
+  const commit = snapshot.commit ? chalk9.gray(` (${snapshot.commit.slice(0, 7)})`) : "";
+  return `${chalk9.gray(date)}  ${color(`${snapshot.coverageScore}%`)}  ${snapshot.documentedExports}/${snapshot.totalExports} exports${version2}${commit}`;
 }
 function formatWeekDate(timestamp) {
   const date = new Date(timestamp);
@@ -2879,10 +2409,10 @@ function formatWeekDate(timestamp) {
 }
 function formatVelocity(velocity) {
   if (velocity > 0)
-    return chalk10.green(`+${velocity}%/day`);
+    return chalk9.green(`+${velocity}%/day`);
   if (velocity < 0)
-    return chalk10.red(`${velocity}%/day`);
-  return chalk10.gray("0%/day");
+    return chalk9.red(`${velocity}%/day`);
+  return chalk9.gray("0%/day");
 }
 function registerTrendsCommand(program) {
   program.command("trends").description("Show coverage trends over time").option("--cwd <dir>", "Working directory", process.cwd()).option("-n, --limit <count>", "Number of snapshots to show", "10").option("--prune <count>", "Prune history to keep only N snapshots").option("--record", "Record current coverage to history").option("--json", "Output as JSON").option("--extended", "Show extended trend analysis (velocity, projections)").option("--tier <tier>", "Retention tier: free (7d), team (30d), pro (90d)", "pro").option("--weekly", "Show weekly summary breakdown").action(async (options) => {
@@ -2892,17 +2422,17 @@ function registerTrendsCommand(program) {
       const keepCount = parseInt(options.prune, 10);
       if (!isNaN(keepCount)) {
         const deleted = pruneHistory(cwd, keepCount);
-        console.log(chalk10.green(`Pruned ${deleted} old snapshots, kept ${keepCount} most recent`));
+        console.log(chalk9.green(`Pruned ${deleted} old snapshots, kept ${keepCount} most recent`));
       } else {
         const deleted = pruneByTier(cwd, tier);
-        console.log(chalk10.green(`Pruned ${deleted} snapshots older than ${RETENTION_DAYS[tier]} days`));
+        console.log(chalk9.green(`Pruned ${deleted} snapshots older than ${RETENTION_DAYS[tier]} days`));
       }
       return;
     }
     if (options.record) {
       const specPath = path8.resolve(cwd, "openpkg.json");
       if (!fs6.existsSync(specPath)) {
-        console.error(chalk10.red("No openpkg.json found. Run `doccov spec` first to generate a spec."));
+        console.error(chalk9.red("No openpkg.json found. Run `doccov spec` first to generate a spec."));
         process.exit(1);
       }
       try {
@@ -2910,24 +2440,24 @@ function registerTrendsCommand(program) {
         const spec = JSON.parse(specContent);
         const trend = getTrend(spec, cwd);
         saveSnapshot(trend.current, cwd);
-        console.log(chalk10.green("Recorded coverage snapshot:"));
+        console.log(chalk9.green("Recorded coverage snapshot:"));
         console.log(formatSnapshot(trend.current));
         if (trend.delta !== undefined) {
           const deltaStr = formatDelta2(trend.delta);
-          const deltaColor = trend.delta > 0 ? chalk10.green : trend.delta < 0 ? chalk10.red : chalk10.gray;
-          console.log(chalk10.gray("Change from previous:"), deltaColor(deltaStr));
+          const deltaColor = trend.delta > 0 ? chalk9.green : trend.delta < 0 ? chalk9.red : chalk9.gray;
+          console.log(chalk9.gray("Change from previous:"), deltaColor(deltaStr));
         }
         return;
       } catch (error) {
-        console.error(chalk10.red("Failed to read openpkg.json:"), error instanceof Error ? error.message : error);
+        console.error(chalk9.red("Failed to read openpkg.json:"), error instanceof Error ? error.message : error);
         process.exit(1);
       }
     }
     const snapshots = loadSnapshots(cwd);
     const limit = parseInt(options.limit ?? "10", 10);
     if (snapshots.length === 0) {
-      console.log(chalk10.yellow("No coverage history found."));
-      console.log(chalk10.gray("Run `doccov trends --record` to save the current coverage."));
+      console.log(chalk9.yellow("No coverage history found."));
+      console.log(chalk9.gray("Run `doccov trends --record` to save the current coverage."));
       return;
     }
     if (options.json) {
@@ -2942,17 +2472,17 @@ function registerTrendsCommand(program) {
     }
     const sparklineData = snapshots.slice(0, 10).map((s) => s.coverageScore).reverse();
     const sparkline = renderSparkline(sparklineData);
-    console.log(chalk10.bold("Coverage Trends"));
-    console.log(chalk10.gray(`Package: ${snapshots[0].package}`));
-    console.log(chalk10.gray(`Sparkline: ${sparkline}`));
+    console.log(chalk9.bold("Coverage Trends"));
+    console.log(chalk9.gray(`Package: ${snapshots[0].package}`));
+    console.log(chalk9.gray(`Sparkline: ${sparkline}`));
     console.log("");
     if (snapshots.length >= 2) {
       const oldest = snapshots[snapshots.length - 1];
       const newest = snapshots[0];
       const overallDelta = newest.coverageScore - oldest.coverageScore;
       const deltaStr = formatDelta2(overallDelta);
-      const deltaColor = overallDelta > 0 ? chalk10.green : overallDelta < 0 ? chalk10.red : chalk10.gray;
-      console.log(chalk10.gray("Overall trend:"), deltaColor(deltaStr), chalk10.gray(`(${snapshots.length} snapshots)`));
+      const deltaColor = overallDelta > 0 ? chalk9.green : overallDelta < 0 ? chalk9.red : chalk9.gray;
+      console.log(chalk9.gray("Overall trend:"), deltaColor(deltaStr), chalk9.gray(`(${snapshots.length} snapshots)`));
       console.log("");
     }
     if (options.extended) {
@@ -2962,8 +2492,8 @@ function registerTrendsCommand(program) {
           const specContent = fs6.readFileSync(specPath, "utf-8");
           const spec = JSON.parse(specContent);
           const extended = getExtendedTrend(spec, cwd, { tier });
-          console.log(chalk10.bold("Extended Analysis"));
-          console.log(chalk10.gray(`Tier: ${tier} (${RETENTION_DAYS[tier]}-day retention)`));
+          console.log(chalk9.bold("Extended Analysis"));
+          console.log(chalk9.gray(`Tier: ${tier} (${RETENTION_DAYS[tier]}-day retention)`));
           console.log("");
           console.log("  Velocity:");
           console.log(`    7-day:   ${formatVelocity(extended.velocity7d)}`);
@@ -2972,47 +2502,47 @@ function registerTrendsCommand(program) {
             console.log(`    90-day:  ${formatVelocity(extended.velocity90d)}`);
           }
           console.log("");
-          const projColor = extended.projected30d >= extended.trend.current.coverageScore ? chalk10.green : chalk10.red;
+          const projColor = extended.projected30d >= extended.trend.current.coverageScore ? chalk9.green : chalk9.red;
           console.log(`  Projected (30d): ${projColor(`${extended.projected30d}%`)}`);
-          console.log(`  All-time high:   ${chalk10.green(`${extended.allTimeHigh}%`)}`);
-          console.log(`  All-time low:    ${chalk10.red(`${extended.allTimeLow}%`)}`);
+          console.log(`  All-time high:   ${chalk9.green(`${extended.allTimeHigh}%`)}`);
+          console.log(`  All-time low:    ${chalk9.red(`${extended.allTimeLow}%`)}`);
           if (extended.dataRange) {
             const startDate = formatWeekDate(extended.dataRange.start);
             const endDate = formatWeekDate(extended.dataRange.end);
-            console.log(chalk10.gray(`  Data range: ${startDate} - ${endDate}`));
+            console.log(chalk9.gray(`  Data range: ${startDate} - ${endDate}`));
           }
           console.log("");
           if (options.weekly && extended.weeklySummaries.length > 0) {
-            console.log(chalk10.bold("Weekly Summary"));
+            console.log(chalk9.bold("Weekly Summary"));
             const weekLimit = Math.min(extended.weeklySummaries.length, 8);
             for (let i = 0;i < weekLimit; i++) {
               const week = extended.weeklySummaries[i];
               const weekStart = formatWeekDate(week.weekStart);
               const weekEnd = formatWeekDate(week.weekEnd);
-              const deltaColor = week.delta > 0 ? chalk10.green : week.delta < 0 ? chalk10.red : chalk10.gray;
+              const deltaColor = week.delta > 0 ? chalk9.green : week.delta < 0 ? chalk9.red : chalk9.gray;
               const deltaStr = week.delta > 0 ? `+${week.delta}%` : `${week.delta}%`;
               console.log(`  ${weekStart} - ${weekEnd}:  ${week.avgCoverage}% avg  ${deltaColor(deltaStr)}  (${week.snapshotCount} snapshots)`);
             }
             if (extended.weeklySummaries.length > weekLimit) {
-              console.log(chalk10.gray(`  ... and ${extended.weeklySummaries.length - weekLimit} more weeks`));
+              console.log(chalk9.gray(`  ... and ${extended.weeklySummaries.length - weekLimit} more weeks`));
             }
             console.log("");
           }
         } catch {
-          console.log(chalk10.yellow("Could not load openpkg.json for extended analysis"));
+          console.log(chalk9.yellow("Could not load openpkg.json for extended analysis"));
           console.log("");
         }
       }
     }
-    console.log(chalk10.bold("History"));
+    console.log(chalk9.bold("History"));
     const displaySnapshots = snapshots.slice(0, limit);
     for (let i = 0;i < displaySnapshots.length; i++) {
       const snapshot = displaySnapshots[i];
-      const prefix = i === 0 ? chalk10.cyan("→") : " ";
+      const prefix = i === 0 ? chalk9.cyan("→") : " ";
       console.log(`${prefix} ${formatSnapshot(snapshot)}`);
     }
     if (snapshots.length > limit) {
-      console.log(chalk10.gray(`  ... and ${snapshots.length - limit} more`));
+      console.log(chalk9.gray(`  ... and ${snapshots.length - limit} more`));
     }
   });
 }
@@ -3020,7 +2550,7 @@ function registerTrendsCommand(program) {
 // src/cli.ts
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = path9.dirname(__filename2);
-var packageJson = JSON.parse(readFileSync4(path9.join(__dirname2, "../package.json"), "utf-8"));
+var packageJson = JSON.parse(readFileSync5(path9.join(__dirname2, "../package.json"), "utf-8"));
 var program = new Command;
 program.name("doccov").description("DocCov - Documentation coverage and drift detection for TypeScript").version(packageJson.version);
 registerCheckCommand(program);