@doccov/cli 0.16.0 → 0.18.0

package/dist/config/index.d.ts

@@ -1,12 +1,12 @@
 import { z } from "zod";
-import { CheckConfig, DocCovConfig, DocsConfig, QualityRulesConfig } from "@doccov/sdk";
+import { CheckConfig, DocCovConfig, DocsConfig, PolicyConfig, QualityRulesConfig } from "@doccov/sdk";
 declare const stringList: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 /**
 * Docs configuration schema
 */
 declare const docsConfigSchema: z.ZodObject<{
-	include: z.ZodOptional<typeof stringList>
-	exclude: z.ZodOptional<typeof stringList>
+	include: z.ZodOptional<typeof stringList>;
+	exclude: z.ZodOptional<typeof stringList>;
 }>;
 /** Quality rule severity levels */
 declare const severitySchema: z.ZodEnum<["error", "warn", "off"]>;
@@ -18,30 +18,40 @@ declare const exampleModesSchema: z.ZodUnion<[typeof exampleModeSchema, z.ZodArr
 * Check command configuration schema.
 */
 declare const checkConfigSchema: z.ZodObject<{
-	examples: z.ZodOptional<typeof exampleModesSchema>
-	minCoverage: z.ZodOptional<z.ZodNumber>
-	maxDrift: z.ZodOptional<z.ZodNumber>
+	examples: z.ZodOptional<typeof exampleModesSchema>;
+	minCoverage: z.ZodOptional<z.ZodNumber>;
+	maxDrift: z.ZodOptional<z.ZodNumber>;
 }>;
 /**
 * Quality rules configuration schema
 */
 declare const qualityConfigSchema: z.ZodObject<{
-	rules: z.ZodOptional<z.ZodRecord<z.ZodString, typeof severitySchema>>
+	rules: z.ZodOptional<z.ZodRecord<z.ZodString, typeof severitySchema>>;
+}>;
+/**
+* Per-path policy configuration schema
+*/
+declare const policyConfigSchema: z.ZodObject<{
+	path: z.ZodString;
+	minCoverage: z.ZodOptional<z.ZodNumber>;
+	maxDrift: z.ZodOptional<z.ZodNumber>;
+	requireExamples: z.ZodOptional<z.ZodBoolean>;
 }>;
 declare const docCovConfigSchema: z.ZodObject<{
-	include: z.ZodOptional<typeof stringList>
-	exclude: z.ZodOptional<typeof stringList>
-	plugins: z.ZodOptional<z.ZodArray<z.ZodUnknown>>
-	docs: z.ZodOptional<typeof docsConfigSchema>
-	check: z.ZodOptional<typeof checkConfigSchema>
-	quality: z.ZodOptional<typeof qualityConfigSchema>
+	include: z.ZodOptional<typeof stringList>;
+	exclude: z.ZodOptional<typeof stringList>;
+	plugins: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+	docs: z.ZodOptional<typeof docsConfigSchema>;
+	check: z.ZodOptional<typeof checkConfigSchema>;
+	quality: z.ZodOptional<typeof qualityConfigSchema>;
+	policies: z.ZodOptional<z.ZodArray<typeof policyConfigSchema>>;
 }>;
 type DocCovConfigInput = z.infer<typeof docCovConfigSchema>;
 type NormalizedDocCovConfig = DocCovConfig;
-declare const DOCCOV_CONFIG_FILENAMES: readonly ["doccov.config.ts", "doccov.config.mts", "doccov.config.cts", "doccov.config.js", "doccov.config.mjs", "doccov.config.cjs"];
+declare const DOCCOV_CONFIG_FILENAMES: readonly ["doccov.config.ts", "doccov.config.mts", "doccov.config.cts", "doccov.config.js", "doccov.config.mjs", "doccov.config.cjs", "doccov.yml", "doccov.yaml"];
 interface LoadedDocCovConfig extends NormalizedDocCovConfig {
 	filePath: string;
 }
 declare const loadDocCovConfig: (cwd: string) => Promise<LoadedDocCovConfig | null>;
 declare const defineConfig: (config: DocCovConfigInput) => DocCovConfigInput;
-export { loadDocCovConfig, defineConfig, QualityRulesConfig, NormalizedDocCovConfig, LoadedDocCovConfig, DocsConfig, DocCovConfigInput, DOCCOV_CONFIG_FILENAMES, CheckConfig };
+export { loadDocCovConfig, defineConfig, QualityRulesConfig, PolicyConfig, NormalizedDocCovConfig, LoadedDocCovConfig, DocsConfig, DocCovConfigInput, DOCCOV_CONFIG_FILENAMES, CheckConfig };

package/dist/config/index.js

@@ -1,7 +1,8 @@
 // src/config/doccov-config.ts
-import { access } from "node:fs/promises";
+import { access, readFile } 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";
@@ -32,13 +33,20 @@ var checkConfigSchema = z.object({
 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()
+  quality: qualityConfigSchema.optional(),
+  policies: z.array(policyConfigSchema).optional()
 });
 var normalizeList = (value) => {
   if (!value) {
@@ -76,13 +84,15 @@ var normalizeConfig = (input) => {
       rules: input.quality.rules
     };
   }
+  const policies = input.policies;
   return {
     include,
     exclude,
     plugins: input.plugins,
     docs,
     check,
-    quality
+    quality,
+    policies
   };
 };
 
@@ -93,7 +103,9 @@ var DOCCOV_CONFIG_FILENAMES = [
   "doccov.config.cts",
   "doccov.config.js",
   "doccov.config.mjs",
-  "doccov.config.cjs"
+  "doccov.config.cjs",
+  "doccov.yml",
+  "doccov.yaml"
 ];
 var fileExists = async (filePath) => {
   try {
@@ -120,6 +132,11 @@ 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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/cli",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -48,14 +48,15 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^1.0.0",
     "@ai-sdk/openai": "^1.0.0",
-    "@doccov/sdk": "^0.15.1",
+    "@doccov/sdk": "^0.18.0",
     "@inquirer/prompts": "^7.8.0",
-    "@openpkg-ts/spec": "^0.9.0",
+    "@openpkg-ts/spec": "^0.10.0",
     "ai": "^4.0.0",
     "chalk": "^5.4.1",
     "commander": "^14.0.0",
     "glob": "^11.0.0",
     "simple-git": "^3.27.0",
+    "yaml": "^2.8.2",
     "zod": "^3.25.0"
   },
   "devDependencies": {