@driftdev/cli 0.35.1 → 0.37.0

package/dist/drift.js

@@ -175286,6 +175286,25 @@ function validateConfig(raw) {
       if (docs.exclude !== undefined && (!Array.isArray(docs.exclude) || !docs.exclude.every((i) => typeof i === "string"))) {
         errors.push('"docs.exclude" must be an array of strings');
       }
+      if (docs.remote !== undefined) {
+        if (!Array.isArray(docs.remote)) {
+          errors.push('"docs.remote" must be an array');
+        } else {
+          for (let i = 0;i < docs.remote.length; i++) {
+            const target = docs.remote[i];
+            if (typeof target !== "object" || target === null) {
+              errors.push(`"docs.remote[${i}]" must be an object`);
+              continue;
+            }
+            if (typeof target.repo !== "string" || !/^[^/]+\/[^/]+$/.test(target.repo)) {
+              errors.push(`"docs.remote[${i}].repo" must be in "owner/repo" format`);
+            }
+            if (target.branch !== undefined && typeof target.branch !== "string") {
+              errors.push(`"docs.remote[${i}].branch" must be a string`);
+            }
+          }
+        }
+      }
     }
   }
   if (errors.length > 0)
@@ -175651,14 +175670,17 @@ function renderBatchLint(data) {
 function renderBatchList(data) {
   const lines = [""];
   const rows = data.packages;
+  const columnLabel = data.filter === "undocumented" ? "UNDOCUMENTED" : "EXPORTS";
   const nameW = Math.max(7, ...rows.map((r) => r.name.length));
-  lines.push(indent(`${c.gray(pad("PACKAGE", nameW))}  ${c.gray("EXPORTS")}`));
+  lines.push(indent(`${c.gray(pad("PACKAGE", nameW))}  ${c.gray(columnLabel)}`));
   for (const r of rows) {
-    lines.push(indent(`${pad(r.name, nameW)}  ${r.count}`));
+    const countStr = data.filter === "undocumented" ? r.count === 0 ? c.green("0") : c.yellow(String(r.count)) : String(r.count);
+    lines.push(indent(`${pad(r.name, nameW)}  ${countStr}`));
   }
   const total = rows.reduce((s, r) => s + r.count, 0);
   lines.push("");
-  lines.push(indent(`${c.bold("Total")}: ${total} exports across ${rows.length} packages`));
+  const label = data.filter === "undocumented" ? "undocumented exports" : "exports";
+  lines.push(indent(`${c.bold("Total")}: ${total} ${label} across ${rows.length} packages`));
   lines.push("");
   return lines.join(`
 `);
@@ -176013,7 +176035,7 @@ function getPackageInfo(cwd) {
   }
 }
 function registerHealthCommand(program) {
-  program.command("health [entry]", { isDefault: true }).description("Show documentation health score (default command)").option("--min <n>", "Minimum health threshold (exit 1 if below)").option("--all", "Run across all workspace packages").option("--private", "Include private packages in --all mode").action(async (entry, options) => {
+  program.command("health [entry]").description("Show documentation health score (default command)").option("--min <n>", "Minimum health threshold (exit 1 if below)").option("--all", "Run across all workspace packages").option("--private", "Include private packages in --all mode").action(async (entry, options) => {
     const startTime = Date.now();
     const version = getVersion();
     try {
@@ -176517,6 +176539,7 @@ import { existsSync as existsSync17, readFileSync as readFileSync20 } from "node
 import * as path24 from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 import { computeDrift as computeDrift2 } from "@driftdev/sdk";
+import { diffSpec as diffSpec6, categorizeBreakingChanges as categorizeBreakingChanges4 } from "@openpkg-ts/spec";
 
 // src/formatters/ci.ts
 function renderCi(data) {
@@ -176771,20 +176794,104 @@ function filterChangedPackages(allDirs, changedFiles) {
     return changedFiles.some((f) => prefix === "" || f.startsWith(prefix));
   });
 }
-function buildMarkdownTable(results, pass) {
+function buildPRComment(results, pass, commit) {
   const lines = [];
-  lines.push(`## Drift CI Results
+  const multi = results.length > 1;
+  lines.push(`## Drift CI
 `);
   lines.push("| Package | Exports | Coverage | Lint | Status |");
   lines.push("|---------|---------|----------|------|--------|");
   for (const r of results) {
-    const cov = r.coveragePass ? `${r.coverage}%` : `${r.coverage}% ❌`;
-    const lint = r.lintPass ? `${r.lintIssues} issues` : `${r.lintIssues} issues ❌`;
-    const status = r.pass ? "✅" : "❌";
+    const cov = r.coveragePass ? `${r.coverage}%` : `${r.coverage}% :x:`;
+    const lint = r.lintPass ? `${r.lintIssues}` : `${r.lintIssues} :x:`;
+    const status = r.pass ? ":white_check_mark:" : ":x:";
     lines.push(`| ${r.name} | ${r.exports} | ${cov} | ${lint} | ${status} |`);
   }
+  const apiEntries = [];
+  for (const r of results) {
+    if (!r.diff)
+      continue;
+    const { breaking, added, changed } = r.diff;
+    if (breaking.length === 0 && added.length === 0 && changed.length === 0)
+      continue;
+    const pkgLines = [];
+    if (multi)
+      pkgLines.push(`
+**${r.name}**`);
+    for (const name of added)
+      pkgLines.push(`- :heavy_plus_sign: Added: \`${name}\``);
+    for (const name of changed)
+      pkgLines.push(`- :pencil2: Changed: \`${name}\``);
+    for (const b of breaking)
+      pkgLines.push(`- :x: Removed: \`${b.name}\``);
+    apiEntries.push(pkgLines.join(`
+`));
+  }
+  if (apiEntries.length > 0) {
+    const total = results.reduce((s, r) => s + (r.diff ? r.diff.breaking.length + r.diff.added.length + r.diff.changed.length : 0), 0);
+    lines.push("");
+    lines.push(`<details>
+<summary>API Changes (${total})</summary>
+`);
+    lines.push(apiEntries.join(`
+`));
+    lines.push(`
+</details>`);
+  }
+  const breakingEntries = [];
+  for (const r of results) {
+    if (!r.diff?.breaking.length)
+      continue;
+    const pkgLines = [];
+    if (multi)
+      pkgLines.push(`
+**${r.name}**`);
+    for (const b of r.diff.breaking) {
+      pkgLines.push(`- \`${b.name}\`${b.reason ? `: ${b.reason}` : ""}`);
+    }
+    breakingEntries.push(pkgLines.join(`
+`));
+  }
+  if (breakingEntries.length > 0) {
+    const total = results.reduce((s, r) => s + (r.diff?.breaking.length ?? 0), 0);
+    lines.push("");
+    lines.push(`<details>
+<summary>Breaking Changes (${total})</summary>
+`);
+    lines.push(breakingEntries.join(`
+`));
+    lines.push(`
+</details>`);
+  }
+  const undocEntries = [];
+  for (const r of results) {
+    if (!r.undocumented?.length)
+      continue;
+    const pkgLines = [];
+    if (multi)
+      pkgLines.push(`
+**${r.name}**`);
+    for (const name of r.undocumented)
+      pkgLines.push(`- \`${name}\``);
+    undocEntries.push(pkgLines.join(`
+`));
+  }
+  if (undocEntries.length > 0) {
+    const total = results.reduce((s, r) => s + (r.undocumented?.length ?? 0), 0);
+    lines.push("");
+    lines.push(`<details>
+<summary>Undocumented Exports (${total})</summary>
+`);
+    lines.push(undocEntries.join(`
+`));
+    lines.push(`
+</details>`);
+  }
   lines.push("");
-  lines.push(pass ? "**All checks passed.**" : "**Some checks failed.**");
+  lines.push("---");
+  const ts18 = new Date().toISOString();
+  const sha = commit ?? "";
+  lines.push(`*[Drift](https://github.com/driftdev/drift) · ${ts18}${sha ? ` · ${sha}` : ""}*`);
   return lines.join(`
 `);
 }
@@ -176852,6 +176959,24 @@ function registerCiCommand(program) {
             lintIssues += drifts.length;
           }
           const lintPass = config.lint === false || lintIssues === 0;
+          let diff;
+          let undocumented;
+          if (gh.isPR && gh.baseRef) {
+            try {
+              const relEntry = path24.relative(cwd, detectEntry(absDir));
+              const oldSpec = await extractSpecFromRef(`origin/${gh.baseRef}`, relEntry, cwd);
+              const diffResult = diffSpec6(oldSpec, spec);
+              const breaking = categorizeBreakingChanges4(diffResult.breaking, oldSpec, spec);
+              diff = {
+                breaking: breaking.map((b) => ({ name: b.name, reason: b.reason })),
+                added: diffResult.nonBreaking,
+                changed: diffResult.docsOnly
+              };
+            } catch {}
+            const undoc = exports.filter((e) => !e.description?.trim()).map((e) => e.name);
+            if (undoc.length > 0)
+              undocumented = undoc;
+          }
           results.push({
             name,
             coverage,
@@ -176859,7 +176984,9 @@ function registerCiCommand(program) {
             lintIssues,
             lintPass,
             exports: total,
-            pass: coveragePass && lintPass
+            pass: coveragePass && lintPass,
+            diff,
+            undocumented
           });
         } catch {
           results.push({
@@ -176897,7 +177024,7 @@ function registerCiCommand(program) {
         });
       } catch {}
       if (gh.isPR && gh.token && gh.repository) {
-        const md = buildMarkdownTable(results, allPass);
+        const md = buildPRComment(results, allPass, commit);
         writeStepSummary(md);
         const prNumber = getPRNumber(gh.eventPath);
         if (prNumber) {
@@ -177244,7 +177371,7 @@ function registerExamplesCommand(program) {
 import { readFileSync as readFileSync23 } from "node:fs";
 import * as path27 from "node:path";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
-import { diffSpec as diffSpec6, categorizeBreakingChanges as categorizeBreakingChanges4 } from "@openpkg-ts/spec";
+import { diffSpec as diffSpec7, categorizeBreakingChanges as categorizeBreakingChanges5 } from "@openpkg-ts/spec";
 
 // src/formatters/diff.ts
 function renderDiff(data) {
@@ -177310,8 +177437,8 @@ function registerDiffCommand(program) {
     try {
       const args = [oldPath, newPath].filter(Boolean);
       const { oldSpec, newSpec } = await resolveSpecs({ args, ...options });
-      const diff = diffSpec6(oldSpec, newSpec);
-      const breaking = categorizeBreakingChanges4(diff.breaking, oldSpec, newSpec);
+      const diff = diffSpec7(oldSpec, newSpec);
+      const breaking = categorizeBreakingChanges5(diff.breaking, oldSpec, newSpec);
       const data = {
         breaking,
         added: diff.nonBreaking,
@@ -177831,7 +177958,7 @@ function flattenConfig(obj, prefix = "") {
 }
 function registerConfigCommand(program) {
   const cmd = program.command("config").description("Manage drift configuration");
-  cmd.command("list").description("Show all config values").action(() => {
+  cmd.command("list").alias("show").description("Show all config values").action(() => {
     const startTime = Date.now();
     const version = getVersion12();
     try {
@@ -178032,10 +178159,11 @@ function renderInit(data) {
   const lines = [""];
   lines.push(indent(`${data.isMonorepo ? "Monorepo" : "Project"} scan  ${c.gray(`${data.packages.length} package${data.packages.length === 1 ? "" : "s"}`)}`));
   lines.push("");
-  const header = ["PACKAGE", "ENTRY", "EXPORTS", "COVERAGE"];
+  const header = ["Package", "Exports", "Coverage", "Health"];
   const rows = data.packages.map((pkg) => {
-    const color = coverageColor(pkg.coverage);
-    return [pkg.name, pkg.entry, String(pkg.exports), color(`${pkg.coverage}%`)];
+    const covColor = coverageColor(pkg.coverage);
+    const healthColor = coverageColor(pkg.health);
+    return [pkg.name, String(pkg.exports), covColor(`${pkg.coverage}%`), healthColor(`${pkg.health}%`)];
   });
   lines.push(indent(table([header, ...rows])));
   lines.push("");
@@ -178050,6 +178178,277 @@ function renderInit(data) {
 `);
 }
 
+// src/utils/progress/spinner.ts
+import chalk3 from "chalk";
+
+// src/utils/progress/colors.ts
+import chalk2 from "chalk";
+var colors = {
+  success: chalk2.green,
+  error: chalk2.red,
+  warning: chalk2.yellow,
+  info: chalk2.cyan,
+  muted: chalk2.gray,
+  bold: chalk2.bold,
+  dim: chalk2.dim,
+  underline: chalk2.underline,
+  primary: chalk2.cyan,
+  secondary: chalk2.magenta,
+  path: chalk2.cyan,
+  number: chalk2.yellow,
+  code: chalk2.gray
+};
+var symbols = {
+  success: "✓",
+  error: "✗",
+  warning: "⚠",
+  info: "ℹ",
+  spinner: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
+  bullet: "•",
+  arrow: "→",
+  arrowRight: "›",
+  line: "─",
+  corner: "└",
+  vertical: "│",
+  horizontalLine: "─"
+};
+var asciiSymbols = {
+  success: "+",
+  error: "x",
+  warning: "!",
+  info: "i",
+  spinner: ["-", "\\", "|", "/"],
+  bullet: "*",
+  arrow: "->",
+  arrowRight: ">",
+  line: "-",
+  corner: "\\",
+  vertical: "|",
+  horizontalLine: "-"
+};
+function getSymbols(unicodeSupport = true) {
+  return unicodeSupport ? symbols : asciiSymbols;
+}
+var prefix = {
+  success: colors.success(symbols.success),
+  error: colors.error(symbols.error),
+  warning: colors.warning(symbols.warning),
+  info: colors.info(symbols.info)
+};
+
+// src/utils/progress/utils.ts
+function isTTY2() {
+  return Boolean(process.stdout.isTTY);
+}
+function isCI() {
+  return Boolean(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.CIRCLECI || process.env.TRAVIS || process.env.JENKINS_URL || process.env.BUILDKITE || process.env.TEAMCITY_VERSION || process.env.TF_BUILD || process.env.CODEBUILD_BUILD_ID || process.env.BITBUCKET_BUILD_NUMBER);
+}
+function isInteractive() {
+  return isTTY2() && !isCI();
+}
+function supportsUnicode() {
+  if (process.platform === "win32") {
+    return Boolean(process.env.WT_SESSION) || process.env.TERM_PROGRAM === "vscode";
+  }
+  return process.env.TERM !== "linux";
+}
+var MIN_TERMINAL_WIDTH = 40;
+var DEFAULT_TERMINAL_WIDTH = 80;
+function getTerminalWidth() {
+  const width = process.stdout.columns || DEFAULT_TERMINAL_WIDTH;
+  return Math.max(width, MIN_TERMINAL_WIDTH);
+}
+var cursor = {
+  hide: "\x1B[?25l",
+  show: "\x1B[?25h",
+  up: (n = 1) => `\x1B[${n}A`,
+  down: (n = 1) => `\x1B[${n}B`,
+  forward: (n = 1) => `\x1B[${n}C`,
+  back: (n = 1) => `\x1B[${n}D`,
+  left: "\x1B[G",
+  clearLine: "\x1B[2K",
+  clearDown: "\x1B[J",
+  save: "\x1B[s",
+  restore: "\x1B[u"
+};
+function clearLine() {
+  if (isTTY2()) {
+    process.stdout.write(cursor.clearLine + cursor.left);
+  }
+}
+function hideCursor() {
+  if (isTTY2()) {
+    process.stdout.write(cursor.hide);
+  }
+}
+function showCursor() {
+  if (isTTY2()) {
+    process.stdout.write(cursor.show);
+  }
+}
+function truncate(text, maxLength) {
+  if (text.length <= maxLength)
+    return text;
+  return `${text.slice(0, maxLength - 1)}…`;
+}
+
+// src/utils/progress/spinner.ts
+var spinnerColors = {
+  cyan: chalk3.cyan,
+  yellow: chalk3.yellow,
+  green: chalk3.green,
+  red: chalk3.red,
+  magenta: chalk3.magenta,
+  blue: chalk3.blue,
+  white: chalk3.white
+};
+var FRAME_SETS = {
+  dots: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
+  circle: ["◐", "◓", "◑", "◒"]
+};
+var ASCII_FRAME_SET = ["-", "\\", "|", "/"];
+
+class Spinner {
+  label;
+  detail;
+  frames;
+  interval;
+  colorFn;
+  frameIndex = 0;
+  timer = null;
+  state = "stopped";
+  symbols = getSymbols(supportsUnicode());
+  lastRenderedLines = 0;
+  sigintHandler = null;
+  constructor(options = {}) {
+    this.label = options.label ?? "";
+    this.detail = options.detail;
+    this.interval = options.interval ?? 80;
+    this.colorFn = spinnerColors[options.color ?? "cyan"];
+    const style = options.style ?? "circle";
+    this.frames = supportsUnicode() ? FRAME_SETS[style] : ASCII_FRAME_SET;
+  }
+  start(label) {
+    if (label !== undefined)
+      this.label = label;
+    if (this.state === "spinning")
+      return this;
+    this.state = "spinning";
+    this.frameIndex = 0;
+    this.lastRenderedLines = 0;
+    if (!isInteractive()) {
+      console.log(`${this.symbols.bullet} ${this.label}`);
+      return this;
+    }
+    hideCursor();
+    this.setupSignalHandler();
+    this.render();
+    this.timer = setInterval(() => {
+      this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+      this.render();
+    }, this.interval);
+    return this;
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.state = "stopped";
+    this.clearOutput();
+    this.cleanup();
+    return this;
+  }
+  success(label) {
+    if (label !== undefined)
+      this.label = label;
+    this.finish("success");
+    return this;
+  }
+  fail(label) {
+    if (label !== undefined)
+      this.label = label;
+    this.finish("error");
+    return this;
+  }
+  update(label) {
+    this.label = label;
+    if (this.state === "spinning" && isInteractive()) {
+      this.render();
+    }
+    return this;
+  }
+  setDetail(detail) {
+    this.detail = detail;
+    if (this.state === "spinning" && isInteractive()) {
+      this.render();
+    }
+    return this;
+  }
+  get isSpinning() {
+    return this.state === "spinning";
+  }
+  finish(state) {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.state = state;
+    if (!isInteractive()) {
+      const symbol = state === "success" ? this.symbols.success : this.symbols.error;
+      const colorFn = state === "success" ? colors.success : colors.error;
+      console.log(`${colorFn(symbol)} ${this.label}`);
+    } else {
+      this.clearOutput();
+      const symbol = state === "success" ? this.symbols.success : this.symbols.error;
+      const colorFn = state === "success" ? colors.success : colors.error;
+      process.stdout.write(`${colorFn(symbol)} ${this.label}
+`);
+    }
+    this.cleanup();
+  }
+  render() {
+    if (!isTTY2())
+      return;
+    this.clearOutput();
+    const frame = this.colorFn(this.frames[this.frameIndex]);
+    const width = getTerminalWidth();
+    const mainLine = truncate(`${frame} ${this.label}`, width);
+    process.stdout.write(mainLine);
+    let lines = 1;
+    if (this.detail) {
+      const detailLine = truncate(`  ${colors.muted(this.detail)}`, width);
+      process.stdout.write(`
+${detailLine}`);
+      lines = 2;
+    }
+    this.lastRenderedLines = lines;
+  }
+  clearOutput() {
+    if (!isTTY2())
+      return;
+    for (let i = 0;i < this.lastRenderedLines; i++) {
+      if (i > 0)
+        process.stdout.write(cursor.up(1));
+      clearLine();
+    }
+  }
+  setupSignalHandler() {
+    this.sigintHandler = () => {
+      this.cleanup();
+      process.exit(130);
+    };
+    process.on("SIGINT", this.sigintHandler);
+  }
+  cleanup() {
+    if (this.sigintHandler) {
+      process.removeListener("SIGINT", this.sigintHandler);
+      this.sigintHandler = null;
+    }
+    showCursor();
+  }
+}
+
 // src/commands/init.ts
 var __dirname15 = path33.dirname(fileURLToPath14(import.meta.url));
 function getVersion14() {
@@ -178084,7 +178483,8 @@ async function scanPackage(cwd, pkgDir) {
         documented++;
     }
     const coverage = total > 0 ? Math.round(documented / total * 100) : 100;
-    return { name, entry: path33.relative(cwd, entryFile), exports: total, coverage };
+    const health = Math.round(coverage * 0.5 + 100 * 0.5);
+    return { name, entry: path33.relative(cwd, entryFile), exports: total, coverage, health };
   } catch {
     return null;
   }
@@ -178097,7 +178497,7 @@ function generateConfig(packages) {
   };
 }
 function registerInitCommand(program) {
-  program.command("init").description("Scan project, generate global drift config").action(async () => {
+  program.command("init").description("Scan project, generate global drift config").option("--project", "Write to drift.config.json in cwd instead of global config").action(async (opts) => {
     const startTime = Date.now();
     const version = getVersion14();
     const cwd = process.cwd();
@@ -178105,21 +178505,27 @@ function registerInitCommand(program) {
       const workspaces = detectWorkspaces(cwd);
       const isMonorepo = workspaces !== null;
       const packageDirs = isMonorepo ? resolveGlobs(cwd, workspaces) : ["."];
+      const spin = new Spinner({ style: "dots" });
+      spin.start("Scanning packages…");
       const packages = [];
       for (const dir of packageDirs) {
+        spin.update(`Scanning ${dir}…`);
         const result = await scanPackage(cwd, dir);
         if (result)
           packages.push(result);
       }
+      spin.success(`Scanned ${packages.length} package${packages.length === 1 ? "" : "s"}`);
       if (packages.length === 0) {
         formatError("init", "No TypeScript packages found", startTime, version);
         return;
       }
       const config = generateConfig(packages);
-      const globalDir = getGlobalDir();
-      if (!existsSync19(globalDir))
-        mkdirSync7(globalDir, { recursive: true });
-      const configPath = getGlobalConfigPath();
+      const configPath = opts.project ? path33.resolve(cwd, "drift.config.json") : getGlobalConfigPath();
+      if (!opts.project) {
+        const globalDir = getGlobalDir();
+        if (!existsSync19(globalDir))
+          mkdirSync7(globalDir, { recursive: true });
+      }
       writeFileSync7(configPath, JSON.stringify(config, null, 2) + `
 `);
       ensureProjectDir(cwd);
@@ -178521,6 +178927,13 @@ function renderList(data) {
     lines.push(`  ${c.bold(`${total} exports`)}`);
   }
   lines.push("");
+  if (total === 0 && data.filter) {
+    const msg = data.filter === "undocumented" ? `${c.green(sym.ok)} All exports are documented` : `${c.green(sym.ok)} No drifted exports found`;
+    lines.push(indent(msg));
+    lines.push("");
+    return lines.join(`
+`);
+  }
   if (!data.search) {
     const kindCounts = new Map;
     for (const exp of exports) {
@@ -178577,9 +178990,14 @@ function registerListCommand(program) {
         const rows = [];
         for (const pkg of packages) {
           const res = await listExports({ entryFile: pkg.entry });
-          rows.push({ name: pkg.name, count: res.exports.length });
+          let filtered = res.exports;
+          if (options.undocumented) {
+            filtered = filtered.filter((e) => !e.description || e.description.trim().length === 0);
+          }
+          rows.push({ name: pkg.name, count: filtered.length });
         }
-        formatOutput("list", { packages: rows }, startTime, version, renderBatchList);
+        const filter2 = options.undocumented ? "undocumented" : undefined;
+        formatOutput("list", { packages: rows, filter: filter2 }, startTime, version, renderBatchList);
         return;
       }
       let entryFile;
@@ -178616,6 +179034,7 @@ function registerListCommand(program) {
         const matches = fuzzySearch(searchTerm, exports);
         exports = matches.map((m) => exports.find((e) => e.name === m.name));
       }
+      const filter = options.undocumented ? "undocumented" : options.drifted ? "drifted" : undefined;
       const data = {
         exports: exports.map((e) => ({
           name: e.name,
@@ -178624,7 +179043,8 @@ function registerListCommand(program) {
           ...e.deprecated ? { deprecated: true } : {}
         })),
         ...searchTerm ? { search: searchTerm } : {},
-        showAll: !!options.full
+        showAll: !!options.full,
+        ...filter ? { filter } : {}
       };
       formatOutput("list", data, startTime, version, renderList);
     } catch (err) {
@@ -178966,7 +179386,7 @@ function registerReportCommand(program) {
 import { readFileSync as readFileSync36 } from "node:fs";
 import * as path40 from "node:path";
 import { fileURLToPath as fileURLToPath20 } from "node:url";
-import { diffSpec as diffSpec7, recommendSemverBump as recommendSemverBump3 } from "@openpkg-ts/spec";
+import { diffSpec as diffSpec8, recommendSemverBump as recommendSemverBump3 } from "@openpkg-ts/spec";
 
 // src/formatters/semver.ts
 function renderSemver(data) {
@@ -178995,7 +179415,7 @@ function registerSemverCommand(program) {
     try {
       const args = [oldPath, newPath].filter(Boolean);
       const { oldSpec, newSpec } = await resolveSpecs({ args, ...options });
-      const diff = diffSpec7(oldSpec, newSpec);
+      const diff = diffSpec8(oldSpec, newSpec);
       const recommendation = recommendSemverBump3(diff);
       const data = {
         bump: recommendation.bump,
@@ -179156,6 +179576,12 @@ if (process.argv.includes("--capabilities")) {
 `);
   process.exit(0);
 }
+var userArgs = process.argv.slice(2).filter((a) => !a.startsWith("-"));
+if (userArgs.length === 0) {
+  const { configPath } = loadConfig();
+  const subcommand = configPath ? "health" : "init";
+  process.argv.splice(2, 0, subcommand);
+}
 program.parseAsync().catch(() => {
   process.exit(1);
 });

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@driftdev/cli",
-  "version": "0.35.1",
-  "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
+  "version": "0.37.0",
+  "description": "Drift CLI - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
     "cli",
     "documentation",
-    "doccov",
+    "drift",
     "docs-coverage",
     "drift-detection"
   ],
-  "homepage": "https://github.com/doccov/doccov#readme",
+  "homepage": "https://github.com/driftdev/drift#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/doccov/doccov.git",
+    "url": "git+https://github.com/driftdev/drift.git",
     "directory": "packages/cli"
   },
   "license": "MIT",
@@ -28,10 +28,6 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
-    },
-    "./config": {
-      "import": "./dist/config/index.js",
-      "types": "./dist/config/index.d.ts"
     }
   },
   "scripts": {
@@ -47,8 +43,8 @@
     "dist"
   ],
   "dependencies": {
-    "@driftdev/sdk": "^0.35.1",
-    "@driftdev/spec": "^0.35.1",
+    "@driftdev/sdk": "^0.36.0",
+    "@driftdev/spec": "^0.36.0",
     "@openpkg-ts/spec": "^0.37.0",
     "chalk": "^5.4.1",
     "commander": "^14.0.0"

package/dist/config/index.d.ts

@@ -1,9 +0,0 @@
-import { DocCovConfig as DocCovConfig2, DocCovConfigInput, DocsConfig } from "@driftdev/sdk";
-import { DocCovConfig } from "@driftdev/sdk";
-declare const DRIFT_CONFIG_FILENAMES: readonly ["drift.config.ts", "drift.config.mts", "drift.config.js", "drift.config.mjs"];
-interface LoadedDriftTsConfig extends DocCovConfig {
-	filePath: string;
-}
-declare const loadDriftTsConfig: (cwd: string) => Promise<LoadedDriftTsConfig | null>;
-declare const defineConfig: (config: DocCovConfigInput) => DocCovConfigInput;
-export { loadDriftTsConfig, defineConfig, LoadedDriftTsConfig, DocsConfig, DocCovConfigInput, DocCovConfig2 as DocCovConfig, DRIFT_CONFIG_FILENAMES };

package/dist/config/index.js

@@ -1,108 +0,0 @@
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// src/config/drift-ts-config.ts
-import { access } from "node:fs/promises";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { docCovConfigSchema, normalizeConfig } from "@driftdev/sdk";
-var DRIFT_CONFIG_FILENAMES = [
-  "drift.config.ts",
-  "drift.config.mts",
-  "drift.config.js",
-  "drift.config.mjs"
-];
-var fileExists = async (filePath) => {
-  try {
-    await access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-};
-var findConfigFile = async (cwd) => {
-  let current = path.resolve(cwd);
-  const { root } = path.parse(current);
-  while (true) {
-    for (const candidate of DRIFT_CONFIG_FILENAMES) {
-      const candidatePath = path.join(current, candidate);
-      if (await fileExists(candidatePath)) {
-        return candidatePath;
-      }
-    }
-    if (current === root) {
-      return null;
-    }
-    current = path.dirname(current);
-  }
-};
-var importConfigModule = async (absolutePath) => {
-  const fileUrl = pathToFileURL(absolutePath);
-  fileUrl.searchParams.set("t", Date.now().toString());
-  const module = await import(fileUrl.href);
-  return module?.default ?? module?.config ?? module;
-};
-var formatIssues = (issues) => issues.map((issue) => `- ${issue}`).join(`
-`);
-var loadDriftTsConfig = async (cwd) => {
-  const configPath = await findConfigFile(cwd);
-  if (!configPath) {
-    return null;
-  }
-  let rawConfig;
-  try {
-    rawConfig = await importConfigModule(configPath);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to load drift config at ${configPath}: ${message}`);
-  }
-  const parsed = docCovConfigSchema.safeParse(rawConfig);
-  if (!parsed.success) {
-    const issues = parsed.error.issues.map((issue) => {
-      const pathLabel = issue.path.length > 0 ? issue.path.join(".") : "(root)";
-      return `${pathLabel}: ${issue.message}`;
-    });
-    throw new Error(`Invalid drift configuration at ${configPath}.
-${formatIssues(issues)}`);
-  }
-  const normalized = normalizeConfig(parsed.data);
-  return {
-    filePath: configPath,
-    ...normalized
-  };
-};
-
-// src/config/index.ts
-var defineConfig = (config) => config;
-export {
-  loadDriftTsConfig,
-  defineConfig,
-  DRIFT_CONFIG_FILENAMES
-};