@doccov/sdk 0.23.0 → 0.24.0

package/dist/analysis/index.d.ts

@@ -5,8 +5,25 @@ interface DetectedSchemaEntry {
 	schema: Record<string, unknown>;
 	vendor: string;
 }
-import { DriftCategory as DriftCategory2, SpecDocDrift as SpecDocDrift2 } from "@openpkg-ts/spec";
-import { DriftCategory, SpecDocDrift } from "@openpkg-ts/spec";
+/**
+* All possible drift type identifiers.
+*/
+type DriftType = "param-mismatch" | "param-type-mismatch" | "return-type-mismatch" | "generic-constraint-mismatch" | "optionality-mismatch" | "deprecated-mismatch" | "visibility-mismatch" | "async-mismatch" | "property-type-drift" | "example-drift" | "example-syntax-error" | "example-runtime-error" | "example-assertion-failed" | "broken-link";
+type SpecDocDrift = {
+	type: DriftType;
+	target?: string;
+	issue: string;
+	suggestion?: string;
+};
+/**
+* Drift categories group related drift types for progressive disclosure.
+*/
+type DriftCategory = "structural" | "semantic" | "example";
+type SpecDocsMetadata = {
+	coverageScore?: number;
+	missing?: string[];
+	drift?: SpecDocDrift[];
+};
 /**
 * Result of computing drift for a single export.
 */
@@ -72,7 +89,7 @@ interface DriftSummary {
 * console.log(categorized.fixable);  // => true
 * ```
 */
-declare function categorizeDrift(drift: SpecDocDrift2): CategorizedDrift;
+declare function categorizeDrift(drift: SpecDocDrift): CategorizedDrift;
 /**
 * Group drifts by category.
 *
@@ -87,7 +104,7 @@ declare function categorizeDrift(drift: SpecDocDrift2): CategorizedDrift;
 * console.log(grouped.example.length);    // Number of example issues
 * ```
 */
-declare function groupDriftsByCategory(drifts: SpecDocDrift2[]): Record<DriftCategory2, CategorizedDrift[]>;
+declare function groupDriftsByCategory(drifts: SpecDocDrift[]): Record<DriftCategory, CategorizedDrift[]>;
 /**
 * Get drift summary counts by category.
 *
@@ -101,7 +118,7 @@ declare function groupDriftsByCategory(drifts: SpecDocDrift2[]): Record<DriftCat
 * // => "5 issues: 3 fixable"
 * ```
 */
-declare function getDriftSummary(drifts: SpecDocDrift2[]): DriftSummary;
+declare function getDriftSummary(drifts: SpecDocDrift[]): DriftSummary;
 /**
 * Format drift summary for CLI output (single line).
 *
@@ -116,7 +133,7 @@ declare function getDriftSummary(drifts: SpecDocDrift2[]): DriftSummary;
 * ```
 */
 declare function formatDriftSummaryLine(summary: DriftSummary): string;
-import { SpecDocDrift as SpecDocDrift3, SpecExport } from "@openpkg-ts/spec";
+import { SpecExport } from "@openpkg-ts/spec";
 import { OpenPkg } from "@openpkg-ts/spec";
 type OpenPkgSpec = OpenPkg;
 /**
@@ -136,7 +153,7 @@ declare function computeDrift(spec: OpenPkgSpec): DriftResult;
 * @param registry - Registry of known exports and types for validation
 * @returns Array of drift issues detected
 */
-declare function computeExportDrift(entry: SpecExport, registry?: ExportRegistry): SpecDocDrift3[];
+declare function computeExportDrift(entry: SpecExport, registry?: ExportRegistry): SpecDocDrift[];
 /**
 * Calculate aggregate coverage score from a spec's exports.
 *
@@ -185,7 +202,7 @@ declare function ensureSpecCoverage(spec: OpenPkgSpec): OpenPkgSpec & {
 		coverageScore: number;
 	};
 };
-import { SpecDocDrift as SpecDocDrift4, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport2 } from "@openpkg-ts/spec";
 interface ExampleRunResult {
 	success: boolean;
 	stdout: string;
@@ -197,7 +214,7 @@ interface ExampleRunResult {
 * Detect runtime errors in @example blocks.
 * Results are provided externally after running examples via runExamples().
 */
-declare function detectExampleRuntimeErrors(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift4[];
+declare function detectExampleRuntimeErrors(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
 /**
 * Parse assertion comments from example code.
 * Matches: // => expected_value
@@ -214,8 +231,8 @@ declare function hasNonAssertionComments(code: string): boolean;
 /**
 * Detect assertion failures by comparing stdout to expected values.
 */
-declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift4[];
-import { OpenPkg as OpenPkg2, SpecDocDrift as SpecDocDrift8, SpecDocsMetadata, SpecExport as SpecExport7 } from "@openpkg-ts/spec";
+declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
+import { OpenPkg as OpenPkg2, SpecExport as SpecExport7 } from "@openpkg-ts/spec";
 /**
 * An enriched with computed documentation metadata.
 * Extends SpecExport with the `docs` field for coverage analysis.
@@ -242,7 +259,7 @@ interface EnrichOptions {
 	* Per-drift issues to include in enrichment.
 	* Map from ID to drift issues.
 	*/
-	driftByExport?: Map<string, SpecDocDrift8[]>;
+	driftByExport?: Map<string, SpecDocDrift[]>;
 }
 /**
 * Enrich an OpenPkg spec with documentation coverage metadata.
@@ -265,6 +282,31 @@ interface EnrichOptions {
 * ```
 */
 declare function enrichSpec(spec: OpenPkg2, options?: EnrichOptions): EnrichedOpenPkg;
+import { SpecDiff } from "@openpkg-ts/spec";
+/**
+* Extended diff result with doccov-specific coverage tracking.
+*/
+interface EnrichedSpecDiff extends SpecDiff {
+	coverageDelta: number;
+	oldCoverage: number;
+	newCoverage: number;
+	newUndocumented: string[];
+	improvedExports: string[];
+	regressedExports: string[];
+	driftIntroduced: number;
+	driftResolved: number;
+}
+type ExportWithDocs = EnrichedExport & {
+	docs?: SpecDocsMetadata;
+};
+type SpecWithDocs = EnrichedOpenPkg & {
+	docs?: SpecDocsMetadata;
+	exports: ExportWithDocs[];
+};
+/**
+* Compare two enriched OpenPkg specs with coverage tracking.
+*/
+declare function diffEnrichedSpec(oldSpec: SpecWithDocs, newSpec: SpecWithDocs): EnrichedSpecDiff;
 import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
 /** Directory for storing history snapshots */
 declare const HISTORY_DIR = ".doccov/history";
@@ -449,7 +491,6 @@ declare function getExtendedTrend(spec: OpenPkg3, cwd: string, options?: {
 	tier?: RetentionTier;
 }): ExtendedTrendAnalysis;
 import { OpenPkg as OpenPkg4 } from "@openpkg-ts/spec";
-import { DriftCategory as DriftCategory3, SpecDocDrift as SpecDocDrift9 } from "@openpkg-ts/spec";
 /**
 * Drift summary with category breakdown.
 */
@@ -461,7 +502,7 @@ interface DriftReportSummary {
 	/**
 	* Count of issues per category.
 	*/
-	byCategory: Record<DriftCategory3, number>;
+	byCategory: Record<DriftCategory, number>;
 	/**
 	* Number of auto-fixable issues.
 	*/
@@ -519,7 +560,7 @@ interface ExportCoverageData {
 	/**
 	* Drift issues for this export.
 	*/
-	drift?: SpecDocDrift9[];
+	drift?: SpecDocDrift[];
 }
 /**
 * DocCov report - a persistable coverage analysis result.
@@ -647,4 +688,4 @@ interface SchemaDetectionResult {
 	noCompiledJsWarning?: boolean;
 }
 declare function detectRuntimeSchemas(context: SchemaDetectionContext): Promise<SchemaDetectionResult>;
-export { saveSnapshot, saveReport, renderSparkline, renderApiSurface, pruneHistory, pruneByTier, parseAssertions, loadSnapshotsForDays, loadSnapshots, loadCachedReport, isCachedReportValid, hasNonAssertionComments, groupDriftsByCategory, getTrend, getExtendedTrend, getDriftSummary, generateWeeklySummaries, generateReportFromEnriched, generateReport, formatDriftSummaryLine, formatDelta, ensureSpecCoverage, enrichSpec, detectRuntimeSchemas, detectExampleRuntimeErrors, detectExampleAssertionFailures, computeSnapshot, computeExportDrift, computeDrift, categorizeDrift, calculateAggregateCoverage, buildExportRegistry, WeeklySummary, SchemaDetectionResult, SchemaDetectionContext, RetentionTier, RETENTION_DAYS, OpenPkgSpec, HISTORY_DIR, ExtendedTrendAnalysis, ExportDriftResult, EnrichedOpenPkg, EnrichedExport, EnrichedDocsMetadata, EnrichOptions, DriftSummary, DriftResult, DetectedSchemaEntry, CoverageTrend, CoverageSnapshot, CategorizedDrift };
+export { saveSnapshot, saveReport, renderSparkline, renderApiSurface, pruneHistory, pruneByTier, parseAssertions, loadSnapshotsForDays, loadSnapshots, loadCachedReport, isCachedReportValid, hasNonAssertionComments, groupDriftsByCategory, getTrend, getExtendedTrend, getDriftSummary, generateWeeklySummaries, generateReportFromEnriched, generateReport, formatDriftSummaryLine, formatDelta, ensureSpecCoverage, enrichSpec, diffEnrichedSpec, detectRuntimeSchemas, detectExampleRuntimeErrors, detectExampleAssertionFailures, computeSnapshot, computeExportDrift, computeDrift, categorizeDrift, calculateAggregateCoverage, buildExportRegistry, WeeklySummary, SchemaDetectionResult, SchemaDetectionContext, RetentionTier, RETENTION_DAYS, OpenPkgSpec, HISTORY_DIR, ExtendedTrendAnalysis, ExportDriftResult, EnrichedSpecDiff, EnrichedOpenPkg, EnrichedExport, EnrichedDocsMetadata, EnrichOptions, DriftSummary, DriftResult, DetectedSchemaEntry, CoverageTrend, CoverageSnapshot, CategorizedDrift };

package/dist/analysis/index.js

@@ -33,8 +33,63 @@ import {
   renderSparkline,
   saveReport,
   saveSnapshot
-} from "../shared/chunk-nk2w5vws.js";
+} from "../shared/chunk-c1f9mytc.js";
 import"../shared/chunk-esptwrfq.js";
+// src/analysis/diff-enriched.ts
+import { diffSpec } from "@openpkg-ts/spec";
+function diffEnrichedSpec(oldSpec, newSpec) {
+  const baseDiff = diffSpec(oldSpec, newSpec);
+  const result = {
+    ...baseDiff,
+    coverageDelta: 0,
+    oldCoverage: 0,
+    newCoverage: 0,
+    newUndocumented: [],
+    improvedExports: [],
+    regressedExports: [],
+    driftIntroduced: 0,
+    driftResolved: 0
+  };
+  result.oldCoverage = oldSpec.docs?.coverageScore ?? 0;
+  result.newCoverage = newSpec.docs?.coverageScore ?? 0;
+  result.coverageDelta = Math.round((result.newCoverage - result.oldCoverage) * 10) / 10;
+  const oldExportMap = toExportMap(oldSpec.exports);
+  const newExportMap = toExportMap(newSpec.exports);
+  for (const [id, newExport] of newExportMap.entries()) {
+    const oldExport = oldExportMap.get(id);
+    const newScore = newExport.docs?.coverageScore ?? 0;
+    const newDriftCount = newExport.docs?.drift?.length ?? 0;
+    if (!oldExport) {
+      if (newScore < 100 || (newExport.docs?.missing?.length ?? 0) > 0) {
+        result.newUndocumented.push(id);
+      }
+      result.driftIntroduced += newDriftCount;
+      continue;
+    }
+    const oldScore = oldExport.docs?.coverageScore ?? 0;
+    const oldDriftCount = oldExport.docs?.drift?.length ?? 0;
+    if (newScore > oldScore) {
+      result.improvedExports.push(id);
+    } else if (newScore < oldScore) {
+      result.regressedExports.push(id);
+    }
+    if (newDriftCount > oldDriftCount) {
+      result.driftIntroduced += newDriftCount - oldDriftCount;
+    } else if (oldDriftCount > newDriftCount) {
+      result.driftResolved += oldDriftCount - newDriftCount;
+    }
+  }
+  return result;
+}
+function toExportMap(exports) {
+  const map = new Map;
+  for (const exp of exports) {
+    if (exp && typeof exp.id === "string") {
+      map.set(exp.id, exp);
+    }
+  }
+  return map;
+}
 export {
   saveSnapshot,
   saveReport,
@@ -59,6 +114,7 @@ export {
   formatDelta,
   ensureSpecCoverage,
   enrichSpec,
+  diffEnrichedSpec,
   detectRuntimeSchemas,
   detectExampleRuntimeErrors,
   detectExampleAssertionFailures,

package/dist/index.d.ts

@@ -367,9 +367,38 @@ declare class DocCov {
 }
 declare function analyze(code: string, options?: AnalyzeOptions): Promise<OpenPkgSpec>;
 declare function analyzeFile(filePath: string, options?: AnalyzeOptions): Promise<OpenPkgSpec>;
-import { OpenPkg as OpenPkg4, SpecDocDrift as SpecDocDrift8, SpecDocsMetadata, SpecExport as SpecExport7 } from "@openpkg-ts/spec";
-import { DriftCategory as DriftCategory2, SpecDocDrift as SpecDocDrift2 } from "@openpkg-ts/spec";
-import { DriftCategory, SpecDocDrift } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg4, SpecExport as SpecExport7 } from "@openpkg-ts/spec";
+/**
+* All possible drift type identifiers.
+*/
+type DriftType = "param-mismatch" | "param-type-mismatch" | "return-type-mismatch" | "generic-constraint-mismatch" | "optionality-mismatch" | "deprecated-mismatch" | "visibility-mismatch" | "async-mismatch" | "property-type-drift" | "example-drift" | "example-syntax-error" | "example-runtime-error" | "example-assertion-failed" | "broken-link";
+type SpecDocDrift = {
+	type: DriftType;
+	target?: string;
+	issue: string;
+	suggestion?: string;
+};
+/**
+* Drift categories group related drift types for progressive disclosure.
+*/
+type DriftCategory = "structural" | "semantic" | "example";
+/**
+* Maps each drift type to its category.
+*/
+declare const DRIFT_CATEGORIES: Record<DriftType, DriftCategory>;
+/**
+* Human-readable category labels.
+*/
+declare const DRIFT_CATEGORY_LABELS: Record<DriftCategory, string>;
+/**
+* Category descriptions for help text.
+*/
+declare const DRIFT_CATEGORY_DESCRIPTIONS: Record<DriftCategory, string>;
+type SpecDocsMetadata = {
+	coverageScore?: number;
+	missing?: string[];
+	drift?: SpecDocDrift[];
+};
 /**
 * Result of computing drift for a single export.
 */
@@ -435,7 +464,7 @@ interface DriftSummary {
 * console.log(categorized.fixable);  // => true
 * ```
 */
-declare function categorizeDrift(drift: SpecDocDrift2): CategorizedDrift;
+declare function categorizeDrift(drift: SpecDocDrift): CategorizedDrift;
 /**
 * Group drifts by category.
 *
@@ -450,7 +479,7 @@ declare function categorizeDrift(drift: SpecDocDrift2): CategorizedDrift;
 * console.log(grouped.example.length);    // Number of example issues
 * ```
 */
-declare function groupDriftsByCategory(drifts: SpecDocDrift2[]): Record<DriftCategory2, CategorizedDrift[]>;
+declare function groupDriftsByCategory(drifts: SpecDocDrift[]): Record<DriftCategory, CategorizedDrift[]>;
 /**
 * Get drift summary counts by category.
 *
@@ -464,7 +493,7 @@ declare function groupDriftsByCategory(drifts: SpecDocDrift2[]): Record<DriftCat
 * // => "5 issues: 3 fixable"
 * ```
 */
-declare function getDriftSummary(drifts: SpecDocDrift2[]): DriftSummary;
+declare function getDriftSummary(drifts: SpecDocDrift[]): DriftSummary;
 /**
 * Format drift summary for CLI output (single line).
 *
@@ -479,7 +508,7 @@ declare function getDriftSummary(drifts: SpecDocDrift2[]): DriftSummary;
 * ```
 */
 declare function formatDriftSummaryLine(summary: DriftSummary): string;
-import { SpecDocDrift as SpecDocDrift3, SpecExport } from "@openpkg-ts/spec";
+import { SpecExport } from "@openpkg-ts/spec";
 /**
 * Build a registry of all export/type names for cross-reference validation.
 */
@@ -497,7 +526,7 @@ declare function computeDrift(spec: OpenPkgSpec): DriftResult;
 * @param registry - Registry of known exports and types for validation
 * @returns Array of drift issues detected
 */
-declare function computeExportDrift(entry: SpecExport, registry?: ExportRegistry): SpecDocDrift3[];
+declare function computeExportDrift(entry: SpecExport, registry?: ExportRegistry): SpecDocDrift[];
 /**
 * Calculate aggregate coverage score from a spec's exports.
 *
@@ -546,7 +575,7 @@ declare function ensureSpecCoverage(spec: OpenPkgSpec): OpenPkgSpec & {
 		coverageScore: number;
 	};
 };
-import { SpecDocDrift as SpecDocDrift4, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport2 } from "@openpkg-ts/spec";
 interface ExampleRunResult {
 	success: boolean;
 	stdout: string;
@@ -597,7 +626,7 @@ declare function runExamplesWithPackage(examples: string[], options: RunExamples
 * Detect runtime errors in @example blocks.
 * Results are provided externally after running examples via runExamples().
 */
-declare function detectExampleRuntimeErrors(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift4[];
+declare function detectExampleRuntimeErrors(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
 /**
 * Parse assertion comments from example code.
 * Matches: // => expected_value
@@ -614,7 +643,7 @@ declare function hasNonAssertionComments(code: string): boolean;
 /**
 * Detect assertion failures by comparing stdout to expected values.
 */
-declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift4[];
+declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
 /**
 * An enriched with computed documentation metadata.
 * Extends SpecExport with the `docs` field for coverage analysis.
@@ -641,7 +670,7 @@ interface EnrichOptions {
 	* Per-drift issues to include in enrichment.
 	* Map from ID to drift issues.
 	*/
-	driftByExport?: Map<string, SpecDocDrift8[]>;
+	driftByExport?: Map<string, SpecDocDrift[]>;
 }
 /**
 * Enrich an OpenPkg spec with documentation coverage metadata.
@@ -664,8 +693,20 @@ interface EnrichOptions {
 * ```
 */
 declare function enrichSpec(spec: OpenPkg4, options?: EnrichOptions): EnrichedOpenPkg;
+import { DocCovSpec } from "@doccov/spec";
+interface BuildDocCovOptions {
+	openpkgPath: string;
+	openpkg: OpenPkgSpec;
+	packagePath?: string;
+}
+/**
+* Build a DocCov spec from an OpenPkg spec.
+*
+* @param options - Build options
+* @returns DocCov specification with coverage analysis
+*/
+declare function buildDocCovSpec(options: BuildDocCovOptions): DocCovSpec;
 import { OpenPkg as OpenPkg5 } from "@openpkg-ts/spec";
-import { DriftCategory as DriftCategory3, SpecDocDrift as SpecDocDrift9 } from "@openpkg-ts/spec";
 /**
 * DocCov report schema version.
 */
@@ -725,7 +766,7 @@ interface DriftReportSummary {
 	/**
 	* Count of issues per category.
 	*/
-	byCategory: Record<DriftCategory3, number>;
+	byCategory: Record<DriftCategory, number>;
 	/**
 	* Number of auto-fixable issues.
 	*/
@@ -747,7 +788,7 @@ interface DriftReport {
 	/**
 	* Issues grouped by category.
 	*/
-	byCategory: Record<DriftCategory3, CategorizedDrift[]>;
+	byCategory: Record<DriftCategory, CategorizedDrift[]>;
 	/**
 	* Flat list of all drift issues (backward compatible).
 	*/
@@ -805,7 +846,7 @@ interface ExportCoverageData {
 	/**
 	* Drift issues for this export.
 	*/
-	drift?: SpecDocDrift9[];
+	drift?: SpecDocDrift[];
 }
 /**
 * DocCov report - a persistable coverage analysis result.
@@ -885,6 +926,27 @@ declare function loadCachedReport(reportPath?: string): DocCovReport | null;
 */
 declare function saveReport(report: DocCovReport, reportPath?: string): void;
 /**
+* Generate a git-trackable API surface markdown file from an OpenPkg spec.
+*
+* This produces a deterministic, sorted output suitable for version control.
+* Changes to the API will show up as diffs in this file.
+*
+* @param spec - The OpenPkg spec to render
+* @returns Markdown string representing the API surface
+*
+* @example
+* ```ts
+* import { DocCov, renderApiSurface } from '@doccov/sdk';
+*
+* const doccov = new DocCov();
+* const { spec } = await doccov.analyzeFileWithDiagnostics('src/index.ts');
+* const apiSurface = renderApiSurface(spec);
+*
+* fs.writeFileSync('api-surface.md', apiSurface);
+* ```
+*/
+declare function renderApiSurface(spec: OpenPkg5): string;
+/**
 * Project detection types for I/O-agnostic project analysis.
 * Used by both CLI (NodeFileSystem) and API (SandboxFileSystem).
 */
@@ -1350,7 +1412,7 @@ interface ExampleValidationResult {
 * - `run`: executes examples (doesn't require presence or typecheck)
 */
 declare function validateExamples(exports: SpecExport8[], options: ExampleValidationOptions): Promise<ExampleValidationResult>;
-import { SpecDocDrift as SpecDocDrift10, SpecExport as SpecExport9 } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport9 } from "@openpkg-ts/spec";
 import * as TS2 from "typescript";
 /**
 * Represents a single parameter in a JSDoc patch
@@ -1457,7 +1519,7 @@ type FixType = "add-param" | "remove-param" | "update-param-type" | "update-para
 */
 interface FixSuggestion {
 	type: FixType;
-	driftType: SpecDocDrift10["type"];
+	driftType: SpecDocDrift["type"];
 	target: string;
 	description: string;
 	patch: Partial<JSDocPatch>;
@@ -1465,11 +1527,11 @@ interface FixSuggestion {
 /**
 * Check if a drift type can be fixed deterministically
 */
-declare function isFixableDrift(drift: SpecDocDrift10): boolean;
+declare function isFixableDrift(drift: SpecDocDrift): boolean;
 /**
 * Generate a fix for a single drift issue
 */
-declare function generateFix(drift: SpecDocDrift10, exportEntry: SpecExport9, existingPatch?: JSDocPatch): FixSuggestion | null;
+declare function generateFix(drift: SpecDocDrift, exportEntry: SpecExport9, existingPatch?: JSDocPatch): FixSuggestion | null;
 /**
 * Generate all fixes for an export's drift issues
 */
@@ -1481,9 +1543,9 @@ declare function mergeFixes(fixes: FixSuggestion[], basePatch?: JSDocPatch): JSD
 /**
 * Get a summary of fixable vs non-fixable drifts
 */
-declare function categorizeDrifts(drifts: SpecDocDrift10[]): {
-	fixable: SpecDocDrift10[];
-	nonFixable: SpecDocDrift10[];
+declare function categorizeDrifts(drifts: SpecDocDrift[]): {
+	fixable: SpecDocDrift[];
+	nonFixable: SpecDocDrift[];
 };
 import { SpecDiff } from "@openpkg-ts/spec";
 type MemberChangeType = "added" | "removed" | "signature-changed";
@@ -1899,6 +1961,14 @@ declare function formatDelta(delta: number): string;
 */
 declare function pruneHistory(cwd: string, keepCount?: number): number;
 /**
+* Prune snapshots based on tier retention policy.
+*
+* @param cwd - Working directory
+* @param tier - Retention tier (free: 7d, team: 30d, pro: 90d)
+* @returns Number of snapshots deleted
+*/
+declare function pruneByTier(cwd: string, tier: RetentionTier): number;
+/**
 * Get extended trend analysis with velocity and projections.
 *
 * @param spec - Current OpenPkg spec
@@ -2576,4 +2646,4 @@ interface BuildPlanExecutionResult {
 	/** Overall error message if failed */
 	error?: string;
 }
-export { validateSpecCache, validateExamples, typecheckExamples, typecheckExample, shouldValidate, serializeJSDoc, saveSpecCache, saveSnapshot, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, resolveCompiledPath, renderSparkline, readPackageJson, pruneHistory, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, mergeFixes, mergeFilters, loadSpecCache, loadSnapshots, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isSchemaType, isFixableDrift, isExecutableLang, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, generateReportFromEnriched, generateReport, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findRemovedReferences, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, findAdapter, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractStandardSchemasFromProject, extractStandardSchemas, extractSpecSummary, extractSchemaType, extractSchemaOutputType, extractPackageSpec, extractImports, extractFunctionCalls, ensureSpecCoverage, enrichSpec, diffSpecWithDocs, diffHashes, detectRuntimeSchemas, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeSnapshot, computeExportDrift, computeDrift, clearSpecCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyEdits, analyzeProject2 as analyzeProject, analyzeFile, analyzeDocsImpact, analyze, WorkspacePackage, WorkspaceConfig, VALIDATION_INFO, TypecheckValidationResult, TypecheckResult, TypecheckOptions, SummaryDriftIssue, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, SpecSummary, SpecDiffWithDocs, SpecCacheConfig, SpecCache, SchemaExtractionResult, SchemaExtractionMode, SchemaDetectionResult, SchemaDetectionContext, SchemaAdapter, SandboxFileSystem, SPEC_CACHE_FILE, RuntimeDrift, RunValidationResult, RunExamplesWithPackageResult, RunExamplesWithPackageOptions, RunExampleOptions, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, ReleaseTag, RETENTION_DAYS, REPORT_VERSION, REPORT_EXTENSIONS, ProjectInfo, PresenceResult, ParsedGitHubUrl, PackageManagerInfo, PackageManager, PackageJson, PackageExports, OpenPkgSpec, NodeFileSystem, MonorepoType, MonorepoInfo, MemberChange, MarkdownDocFile, MarkdownCodeBlock, LLMAssertion, JSDocTag, JSDocReturn, JSDocPatch, JSDocParam, JSDocEdit, InstallResult, InstallOptions, HISTORY_DIR, GitHubRepoMetadata, GitHubProjectContext, FixType, FixSuggestion, FilterSource, FilterOptions, FileSystem, FetchGitHubContextOptions, ExtractStandardSchemasOptions, ExtendedTrendAnalysis, ExportReference, ExportDriftResult, ExportCoverageData, ExampleValidationTypeError, ExampleValidationResult, ExampleValidationOptions, ExampleValidationMode, ExampleValidation, ExampleTypeError, ExampleRunResult, EntryPointSource, EntryPointInfo, EnrichedOpenPkg, EnrichedExport, EnrichedDocsMetadata, EnrichOptions, DriftSummary, DriftResult, DriftReportSummary, DriftReport, DocsImpactResult, DocsImpactReference, DocsImpact, DocsConfig, DocsChangeType, DocCovReport, DocCovOptions, DocCovConfig, DocCov, DiffWithDocsOptions, Diagnostic2 as Diagnostic, DetectedSchemaEntry, DetectedPackageManager, DEFAULT_REPORT_PATH, DEFAULT_REPORT_DIR, CoverageTrend, CoverageSummary, CoverageSnapshot, CommandRunner, CommandResult, CheckConfig, CategorizedDrift, CacheValidationResult, CacheContext, CACHE_VERSION, BuildPlanTarget, BuildPlanStepResult, BuildPlanStep, BuildPlanExecutionResult, BuildPlanEnvironment, BuildPlan, BuildInfo, BuildHints, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, ALL_VALIDATIONS };
+export { validateSpecCache, validateExamples, typecheckExamples, typecheckExample, shouldValidate, serializeJSDoc, saveSpecCache, saveSnapshot, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, resolveCompiledPath, renderSparkline, renderApiSurface, readPackageJson, pruneHistory, pruneByTier, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, mergeFixes, mergeFilters, loadSpecCache, loadSnapshots, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isSchemaType, isFixableDrift, isExecutableLang, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, generateReportFromEnriched, generateReport, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findRemovedReferences, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, findAdapter, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractStandardSchemasFromProject, extractStandardSchemas, extractSpecSummary, extractSchemaType, extractSchemaOutputType, extractPackageSpec, extractImports, extractFunctionCalls, ensureSpecCoverage, enrichSpec, diffSpecWithDocs, diffHashes, detectRuntimeSchemas, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeSnapshot, computeExportDrift, computeDrift, clearSpecCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDocCovSpec, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyEdits, analyzeProject2 as analyzeProject, analyzeFile, analyzeDocsImpact, analyze, WorkspacePackage, WorkspaceConfig, VALIDATION_INFO, TypecheckValidationResult, TypecheckResult, TypecheckOptions, SummaryDriftIssue, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, SpecSummary, SpecDocDrift, SpecDiffWithDocs, SpecCacheConfig, SpecCache, SchemaExtractionResult, SchemaExtractionMode, SchemaDetectionResult, SchemaDetectionContext, SchemaAdapter, SandboxFileSystem, SPEC_CACHE_FILE, RuntimeDrift, RunValidationResult, RunExamplesWithPackageResult, RunExamplesWithPackageOptions, RunExampleOptions, RetentionTier, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, ReleaseTag, RETENTION_DAYS, REPORT_VERSION, REPORT_EXTENSIONS, ProjectInfo, PresenceResult, ParsedGitHubUrl, PackageManagerInfo, PackageManager, PackageJson, PackageExports, OpenPkgSpec, NodeFileSystem, MonorepoType, MonorepoInfo, MemberChange, MarkdownDocFile, MarkdownCodeBlock, LLMAssertion, JSDocTag, JSDocReturn, JSDocPatch, JSDocParam, JSDocEdit, InstallResult, InstallOptions, HISTORY_DIR, GitHubRepoMetadata, GitHubProjectContext, FixType, FixSuggestion, FilterSource, FilterOptions, FileSystem, FetchGitHubContextOptions, ExtractStandardSchemasOptions, ExtendedTrendAnalysis, ExportReference, ExportDriftResult, ExportCoverageData, ExampleValidationTypeError, ExampleValidationResult, ExampleValidationOptions, ExampleValidationMode, ExampleValidation, ExampleTypeError, ExampleRunResult, EntryPointSource, EntryPointInfo, EnrichedOpenPkg, EnrichedExport, EnrichedDocsMetadata, EnrichOptions, DriftType, DriftSummary, DriftResult, DriftReportSummary, DriftReport, DriftCategory, DocsImpactResult, DocsImpactReference, DocsImpact, DocsConfig, DocsChangeType, DocCovReport, DocCovOptions, DocCovConfig, DocCov, DiffWithDocsOptions, Diagnostic2 as Diagnostic, DetectedSchemaEntry, DetectedPackageManager, DRIFT_CATEGORY_LABELS, DRIFT_CATEGORY_DESCRIPTIONS, DRIFT_CATEGORIES, DEFAULT_REPORT_PATH, DEFAULT_REPORT_DIR, CoverageTrend, CoverageSummary, CoverageSnapshot, CommandRunner, CommandResult, CheckConfig, CategorizedDrift, CacheValidationResult, CacheContext, CACHE_VERSION, BuildPlanTarget, BuildPlanStepResult, BuildPlanStep, BuildPlanExecutionResult, BuildPlanEnvironment, BuildPlan, BuildInfo, BuildHints, BuildDocCovOptions, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, ALL_VALIDATIONS };

package/dist/index.js

@@ -1,4 +1,7 @@
 import {
+  DRIFT_CATEGORIES,
+  DRIFT_CATEGORY_DESCRIPTIONS,
+  DRIFT_CATEGORY_LABELS,
   HISTORY_DIR,
   RETENTION_DAYS,
   applyEdits,
@@ -39,14 +42,16 @@ import {
   mergeFixes,
   parseAssertions,
   parseJSDocToPatch,
+  pruneByTier,
   pruneHistory,
+  renderApiSurface,
   renderSparkline,
   resolveCompiledPath,
   saveReport,
   saveSnapshot,
   serializeJSDoc,
   ts
-} from "./shared/chunk-nk2w5vws.js";
+} from "./shared/chunk-c1f9mytc.js";
 import {
   mergeFilters,
   parseListFlag
@@ -4186,6 +4191,140 @@ function resolvePackageDir(entryFile) {
     currentDir = parentDir;
   }
 }
+// src/analysis/doccov-builder.ts
+import { DRIFT_CATEGORIES as DRIFT_CATEGORIES2 } from "@doccov/spec";
+function buildDocCovSpec(options) {
+  const { openpkg, openpkgPath } = options;
+  const registry = buildExportRegistry(openpkg);
+  const exports = {};
+  let totalScore = 0;
+  let documentedCount = 0;
+  const missingByRule = {
+    description: 0,
+    params: 0,
+    returns: 0,
+    examples: 0,
+    throws: 0
+  };
+  const driftByCategory = {
+    structural: 0,
+    semantic: 0,
+    example: 0
+  };
+  let totalDrift = 0;
+  let fixableDrift = 0;
+  for (const exp of openpkg.exports ?? []) {
+    const coverage = computeExportCoverage(exp);
+    const rawDrifts = computeExportDrift(exp, registry);
+    const categorizedDrifts = rawDrifts.map((d) => toCategorizedDrift(d));
+    const exportId = exp.id ?? exp.name;
+    exports[exportId] = {
+      coverageScore: coverage.score,
+      missing: coverage.missing.length > 0 ? coverage.missing : undefined,
+      drift: categorizedDrifts.length > 0 ? categorizedDrifts : undefined
+    };
+    totalScore += coverage.score;
+    if (coverage.score === 100)
+      documentedCount++;
+    for (const rule of coverage.missing) {
+      missingByRule[rule]++;
+    }
+    for (const d of categorizedDrifts) {
+      driftByCategory[d.category]++;
+      totalDrift++;
+      if (d.fixable)
+        fixableDrift++;
+    }
+  }
+  const exportCount = openpkg.exports?.length ?? 0;
+  const summary = {
+    score: exportCount > 0 ? Math.round(totalScore / exportCount) : 100,
+    totalExports: exportCount,
+    documentedExports: documentedCount,
+    missingByRule,
+    drift: {
+      total: totalDrift,
+      fixable: fixableDrift,
+      byCategory: driftByCategory
+    }
+  };
+  return {
+    doccov: "1.0.0",
+    source: {
+      file: openpkgPath,
+      specVersion: openpkg.openpkg,
+      packageName: openpkg.meta.name,
+      packageVersion: openpkg.meta.version
+    },
+    generatedAt: new Date().toISOString(),
+    summary,
+    exports
+  };
+}
+function computeExportCoverage(exp) {
+  const missing = [];
+  let points = 0;
+  let maxPoints = 0;
+  maxPoints += 30;
+  if (exp.description && exp.description.trim().length > 0) {
+    points += 30;
+  } else {
+    missing.push("description");
+  }
+  const isCallable = exp.kind === "function" || exp.kind === "class";
+  if (isCallable && exp.signatures?.length) {
+    const sig = exp.signatures[0];
+    const params = sig.parameters ?? [];
+    if (params.length > 0) {
+      maxPoints += 25;
+      const documentedParams = params.filter((p) => p.description && p.description.trim().length > 0);
+      if (documentedParams.length === params.length) {
+        points += 25;
+      } else if (documentedParams.length > 0) {
+        points += Math.round(documentedParams.length / params.length * 25);
+        missing.push("params");
+      } else {
+        missing.push("params");
+      }
+    }
+    if (exp.kind === "function" && sig.returns) {
+      maxPoints += 20;
+      if (sig.returns.description && sig.returns.description.trim().length > 0) {
+        points += 20;
+      } else {
+        missing.push("returns");
+      }
+    }
+    if (sig.throws && sig.throws.length > 0) {
+      maxPoints += 10;
+      const documentedThrows = sig.throws.filter((t) => t.description);
+      if (documentedThrows.length === sig.throws.length) {
+        points += 10;
+      } else {
+        missing.push("throws");
+      }
+    }
+  }
+  maxPoints += 15;
+  if (exp.examples && exp.examples.length > 0) {
+    points += 15;
+  } else {
+    missing.push("examples");
+  }
+  const score = maxPoints > 0 ? Math.round(points / maxPoints * 100) : 100;
+  return { score, missing };
+}
+function toCategorizedDrift(drift) {
+  const driftType = drift.type;
+  return {
+    type: driftType,
+    target: drift.target,
+    issue: drift.issue,
+    suggestion: drift.suggestion,
+    category: DRIFT_CATEGORIES2[driftType],
+    fixable: isFixableDrift(drift)
+  };
+}
 // src/config/types.ts
 function defineConfig(config) {
   return config;
@@ -6653,8 +6792,10 @@ export {
   resolveTarget,
   resolveCompiledPath,
   renderSparkline,
+  renderApiSurface,
   readPackageJson,
   pruneHistory,
+  pruneByTier,
   parseGitHubUrl2 as parseScanGitHubUrl,
   parseMarkdownFiles,
   parseMarkdownFile,
@@ -6742,6 +6883,7 @@ export {
   calculateAggregateCoverage,
   buildRawUrl,
   buildExportRegistry,
+  buildDocCovSpec,
   buildDisplayUrl,
   buildCloneUrl,
   blockReferencesExport,
@@ -6760,6 +6902,9 @@ export {
   NodeFileSystem,
   HISTORY_DIR,
   DocCov,
+  DRIFT_CATEGORY_LABELS,
+  DRIFT_CATEGORY_DESCRIPTIONS,
+  DRIFT_CATEGORIES,
   DEFAULT_REPORT_PATH,
   DEFAULT_REPORT_DIR,
   CACHE_VERSION,

package/dist/shared/{chunk-nk2w5vws.js → chunk-c1f9mytc.js}

@@ -219,6 +219,34 @@ async function detectRuntimeSchemas(context) {
   };
 }
 
+// src/analysis/drift/types.ts
+var DRIFT_CATEGORIES = {
+  "param-mismatch": "structural",
+  "param-type-mismatch": "structural",
+  "return-type-mismatch": "structural",
+  "optionality-mismatch": "structural",
+  "generic-constraint-mismatch": "structural",
+  "property-type-drift": "structural",
+  "async-mismatch": "structural",
+  "deprecated-mismatch": "semantic",
+  "visibility-mismatch": "semantic",
+  "broken-link": "semantic",
+  "example-drift": "example",
+  "example-syntax-error": "example",
+  "example-runtime-error": "example",
+  "example-assertion-failed": "example"
+};
+var DRIFT_CATEGORY_LABELS = {
+  structural: "Signature mismatches",
+  semantic: "Metadata issues",
+  example: "Example problems"
+};
+var DRIFT_CATEGORY_DESCRIPTIONS = {
+  structural: "JSDoc types or parameters don't match the actual code signature",
+  semantic: "Deprecation, visibility, or reference issues",
+  example: "@example code has errors or doesn't work correctly"
+};
+
 // src/fix/deterministic-fixes.ts
 var FIXABLE_DRIFT_TYPES = new Set([
   "param-mismatch",
@@ -1014,7 +1042,6 @@ function createSourceFile(filePath) {
   return ts.createSourceFile(path2.basename(filePath), content, ts.ScriptTarget.Latest, true, filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
 }
 // src/analysis/drift/categorize.ts
-import { DRIFT_CATEGORIES } from "@openpkg-ts/spec";
 function categorizeDrift(drift) {
   return {
     ...drift,
@@ -2884,4 +2911,4 @@ function getExtendedTrend(spec, cwd, options) {
   };
 }
 
-export { ts, isBuiltInTypeName, isBuiltInIdentifier, isStandardJSONSchema, resolveCompiledPath, extractStandardSchemas, extractStandardSchemasFromProject, detectRuntimeSchemas, isFixableDrift, generateFix, generateFixesForExport, mergeFixes, categorizeDrifts, parseJSDocToPatch, applyPatchToJSDoc, serializeJSDoc, findJSDocLocation, applyEdits, createSourceFile, categorizeDrift, groupDriftsByCategory, getDriftSummary, formatDriftSummaryLine, detectExampleRuntimeErrors, parseAssertions, hasNonAssertionComments, detectExampleAssertionFailures, buildExportRegistry, computeDrift, computeExportDrift, calculateAggregateCoverage, ensureSpecCoverage, enrichSpec, generateReport, generateReportFromEnriched, loadCachedReport, saveReport, isCachedReportValid, renderApiSurface, HISTORY_DIR, RETENTION_DAYS, computeSnapshot, saveSnapshot, loadSnapshots, getTrend, renderSparkline, formatDelta, pruneHistory, pruneByTier, loadSnapshotsForDays, generateWeeklySummaries, getExtendedTrend };
+export { ts, isBuiltInTypeName, isBuiltInIdentifier, isStandardJSONSchema, resolveCompiledPath, extractStandardSchemas, extractStandardSchemasFromProject, detectRuntimeSchemas, DRIFT_CATEGORIES, DRIFT_CATEGORY_LABELS, DRIFT_CATEGORY_DESCRIPTIONS, isFixableDrift, generateFix, generateFixesForExport, mergeFixes, categorizeDrifts, parseJSDocToPatch, applyPatchToJSDoc, serializeJSDoc, findJSDocLocation, applyEdits, createSourceFile, categorizeDrift, groupDriftsByCategory, getDriftSummary, formatDriftSummaryLine, detectExampleRuntimeErrors, parseAssertions, hasNonAssertionComments, detectExampleAssertionFailures, buildExportRegistry, computeDrift, computeExportDrift, calculateAggregateCoverage, ensureSpecCoverage, enrichSpec, generateReport, generateReportFromEnriched, loadCachedReport, saveReport, isCachedReportValid, renderApiSurface, HISTORY_DIR, RETENTION_DAYS, computeSnapshot, saveSnapshot, loadSnapshots, getTrend, renderSparkline, formatDelta, pruneHistory, pruneByTier, loadSnapshotsForDays, generateWeeklySummaries, getExtendedTrend };

package/dist/types/index.d.ts

@@ -1,5 +1,17 @@
-import { DriftCategory as DriftCategory3, SpecDocDrift as SpecDocDrift8 } from "@openpkg-ts/spec";
-import { DriftCategory, SpecDocDrift } from "@openpkg-ts/spec";
+/**
+* All possible drift type identifiers.
+*/
+type DriftType = "param-mismatch" | "param-type-mismatch" | "return-type-mismatch" | "generic-constraint-mismatch" | "optionality-mismatch" | "deprecated-mismatch" | "visibility-mismatch" | "async-mismatch" | "property-type-drift" | "example-drift" | "example-syntax-error" | "example-runtime-error" | "example-assertion-failed" | "broken-link";
+type SpecDocDrift = {
+	type: DriftType;
+	target?: string;
+	issue: string;
+	suggestion?: string;
+};
+/**
+* Drift categories group related drift types for progressive disclosure.
+*/
+type DriftCategory = "structural" | "semantic" | "example";
 /**
 * Extended drift with category and fixability metadata.
 */
@@ -66,7 +78,7 @@ interface DriftReportSummary {
 	/**
 	* Count of issues per category.
 	*/
-	byCategory: Record<DriftCategory3, number>;
+	byCategory: Record<DriftCategory, number>;
 	/**
 	* Number of auto-fixable issues.
 	*/
@@ -88,7 +100,7 @@ interface DriftReport {
 	/**
 	* Issues grouped by category.
 	*/
-	byCategory: Record<DriftCategory3, CategorizedDrift[]>;
+	byCategory: Record<DriftCategory, CategorizedDrift[]>;
 	/**
 	* Flat list of all drift issues (backward compatible).
 	*/
@@ -146,7 +158,7 @@ interface ExportCoverageData {
 	/**
 	* Drift issues for this export.
 	*/
-	drift?: SpecDocDrift8[];
+	drift?: SpecDocDrift[];
 }
 /**
 * DocCov report - a persistable coverage analysis result.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/sdk",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "DocCov SDK - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -47,7 +47,9 @@
     "dist"
   ],
   "dependencies": {
-    "@openpkg-ts/spec": "^0.11.0",
+    "@doccov/spec": "workspace:*",
+    "@openpkg-ts/extract": "workspace:*",
+    "@openpkg-ts/spec": "workspace:*",
     "@vercel/sandbox": "^1.0.3",
     "mdast": "^3.0.0",
     "minimatch": "^10.1.1",