@doccov/cli 0.2.1

package/dist/config/index.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+declare const stringList: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+declare const docCovConfigSchema: z.ZodObject<{
+	include: z.ZodOptional<typeof stringList>
+	exclude: z.ZodOptional<typeof stringList>
+	plugins: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>
+}>;
+type DocCovConfigInput = z.infer<typeof docCovConfigSchema>;
+interface NormalizedDocCovConfig {
+	include?: string[];
+	exclude?: string[];
+	plugins?: unknown[];
+}
+/** @deprecated Use NormalizedDocCovConfig instead */
+type NormalizedOpenPkgConfig = NormalizedDocCovConfig;
+declare const DOCCOV_CONFIG_FILENAMES: readonly ["doccov.config.ts", "doccov.config.mts", "doccov.config.cts", "doccov.config.js", "doccov.config.mjs", "doccov.config.cjs", "openpkg.config.ts", "openpkg.config.mts", "openpkg.config.cts", "openpkg.config.js", "openpkg.config.mjs", "openpkg.config.cjs"];
+interface LoadedDocCovConfig extends NormalizedDocCovConfig {
+	filePath: string;
+}
+/** @deprecated Use LoadedDocCovConfig instead */
+type LoadedOpenPkgConfig = LoadedDocCovConfig;
+declare const loadDocCovConfig: (cwd: string) => Promise<LoadedDocCovConfig | null>;
+/** @deprecated Use loadDocCovConfig instead */
+declare const loadOpenPkgConfigInternal: typeof loadDocCovConfig;
+/** @deprecated Use loadDocCovConfig instead */
+declare const loadOpenPkgConfig: typeof loadDocCovConfig;
+declare const defineConfig: (config: DocCovConfigInput) => DocCovConfigInput;
+export { loadOpenPkgConfigInternal, loadOpenPkgConfig, loadDocCovConfig, defineConfig, NormalizedOpenPkgConfig, NormalizedDocCovConfig, LoadedOpenPkgConfig, LoadedDocCovConfig, DocCovConfigInput, DOCCOV_CONFIG_FILENAMES };

package/dist/config/index.js

@@ -0,0 +1,139 @@
+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 __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/config/openpkg-config.ts
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+// src/config/schema.ts
+import { z } from "zod";
+var stringList = z.union([
+  z.string(),
+  z.array(z.string())
+]);
+var docCovConfigSchema = z.object({
+  include: stringList.optional(),
+  exclude: stringList.optional(),
+  plugins: z.array(z.unknown()).optional()
+});
+var normalizeList = (value) => {
+  if (!value) {
+    return;
+  }
+  const list = Array.isArray(value) ? value : [value];
+  const normalized = list.map((item) => item.trim()).filter(Boolean);
+  return normalized.length > 0 ? normalized : undefined;
+};
+var normalizeConfig = (input) => {
+  const include = normalizeList(input.include);
+  const exclude = normalizeList(input.exclude);
+  return {
+    include,
+    exclude,
+    plugins: input.plugins
+  };
+};
+
+// src/config/openpkg-config.ts
+var DOCCOV_CONFIG_FILENAMES = [
+  "doccov.config.ts",
+  "doccov.config.mts",
+  "doccov.config.cts",
+  "doccov.config.js",
+  "doccov.config.mjs",
+  "doccov.config.cjs",
+  "openpkg.config.ts",
+  "openpkg.config.mts",
+  "openpkg.config.cts",
+  "openpkg.config.js",
+  "openpkg.config.mjs",
+  "openpkg.config.cjs"
+];
+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 DOCCOV_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 loadDocCovConfig = 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 DocCov 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 DocCov configuration at ${configPath}.
+${formatIssues(issues)}`);
+  }
+  const normalized = normalizeConfig(parsed.data);
+  return {
+    filePath: configPath,
+    ...normalized
+  };
+};
+var loadOpenPkgConfigInternal = loadDocCovConfig;
+var loadOpenPkgConfig = loadDocCovConfig;
+
+// src/config/index.ts
+var defineConfig = (config) => config;
+export {
+  loadOpenPkgConfigInternal,
+  loadOpenPkgConfig,
+  loadDocCovConfig,
+  defineConfig,
+  DOCCOV_CONFIG_FILENAMES
+};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@doccov/cli",
+  "version": "0.2.1",
+  "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
+  "keywords": [
+    "typescript",
+    "cli",
+    "documentation",
+    "doccov",
+    "docs-coverage",
+    "drift-detection"
+  ],
+  "homepage": "https://github.com/doccov/doccov#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/doccov/doccov.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "author": "Ryan Waits",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "doccov": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./config": {
+      "import": "./dist/config/index.js",
+      "types": "./dist/config/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "bunup",
+    "dev": "bunup --watch",
+    "cli": "bun run src/cli.ts",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "format": "biome format --write src/"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@ai-sdk/anthropic": "^1.0.0",
+    "@ai-sdk/openai": "^1.0.0",
+    "@inquirer/prompts": "^7.8.0",
+    "@doccov/sdk": "^0.2.1",
+    "@openpkg-ts/spec": "^0.2.1",
+    "ai": "^4.0.0",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "glob": "^11.0.0",
+    "ora": "^8.2.0",
+    "simple-git": "^3.27.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^20.0.0",
+    "bunup": "latest"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}