@doccov/sdk 0.24.2 → 0.25.0

package/dist/analysis/index.d.ts

@@ -5,7 +5,21 @@ interface DetectedSchemaEntry {
 	schema: Record<string, unknown>;
 	vendor: string;
 }
-import { SpecDiff } from "@openpkg-ts/spec";
+import { DocCovSpec } from "@doccov/spec";
+import { OpenPkg } from "@openpkg-ts/spec";
+type OpenPkgSpec = OpenPkg;
+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;
 /**
 * All possible drift type identifiers.
 */
@@ -20,11 +34,6 @@ type SpecDocDrift = {
 * 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 +81,6 @@ interface DriftSummary {
 	byCategory: Record<DriftCategory, number>;
 	fixable: number;
 }
-import { OpenPkg as OpenPkg2, SpecExport as SpecExport7 } from "@openpkg-ts/spec";
 /**
 * Categorize a single drift issue.
 *
@@ -136,8 +144,6 @@ declare function getDriftSummary(drifts: SpecDocDrift[]): DriftSummary;
 */
 declare function formatDriftSummaryLine(summary: DriftSummary): string;
 import { SpecExport } from "@openpkg-ts/spec";
-import { OpenPkg } from "@openpkg-ts/spec";
-type OpenPkgSpec = OpenPkg;
 /**
 * Build a registry of all export/type names for cross-reference validation.
 */
@@ -234,80 +240,49 @@ declare function hasNonAssertionComments(code: string): boolean;
 * Detect assertion failures by comparing stdout to expected values.
 */
 declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
+import { DocCovDrift, DocCovSpec as DocCovSpec2, ExportAnalysis, MissingDocRule } from "@doccov/spec";
+import { SpecExport as SpecExport7 } from "@openpkg-ts/spec";
 /**
-* An enriched with computed documentation metadata.
-* Extends SpecExport with the `docs` field for coverage analysis.
-*/
-type EnrichedExport = SpecExport7 & {
-	docs?: EnrichedDocsMetadata;
-};
-/**
-* Extended docs metadata.
+* Get the full analysis data for an export.
+*
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Export analysis or undefined if not found
 */
-type EnrichedDocsMetadata = SpecDocsMetadata;
+declare function getExportAnalysis(exp: SpecExport7, doccov: DocCovSpec2): ExportAnalysis | undefined;
 /**
-* An enriched OpenPkg spec with computed documentation metadata.
-* Extends OpenPkg with per-and aggregate coverage data.
+* Get the coverage score for an export.
+*
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Coverage score (0-100) or 100 if not found
 */
-type EnrichedOpenPkg = Omit<OpenPkg2, "exports"> & {
-	exports: EnrichedExport[];
-	docs?: EnrichedDocsMetadata;
-	/** Drift summary with category breakdown (if drift exists) */
-	driftSummary?: DriftSummary;
-};
-interface EnrichOptions {
-	/**
-	* Per-drift issues to include in enrichment.
-	* Map from ID to drift issues.
-	*/
-	driftByExport?: Map<string, SpecDocDrift[]>;
-}
+declare function getExportScore(exp: SpecExport7, doccov: DocCovSpec2): number;
 /**
-* Enrich an OpenPkg spec with documentation coverage metadata.
-*
-* Computes coverage scores and detects drift issues.
-*
-* @param spec - The pure OpenPkg spec to enrich
-* @param options - Optional enrichment configuration
-* @returns An enriched spec with documentation metadata
-*
-* @example
-* ```ts
-* import { DocCov, enrichSpec } from '@doccov/sdk';
-*
-* const doccov = new DocCov();
-* const { spec } = await doccov.analyzeFileWithDiagnostics('src/index.ts');
+* Get drift issues for an export.
 *
-* const enriched = enrichSpec(spec);
-* console.log(enriched.docs?.coverageScore); // e.g., 85
-* ```
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Array of drift issues or empty array if none
 */
-declare function enrichSpec(spec: OpenPkg2, options?: EnrichOptions): EnrichedOpenPkg;
+declare function getExportDrift(exp: SpecExport7, doccov: DocCovSpec2): DocCovDrift[];
 /**
-* Extended diff result with doccov-specific coverage tracking.
+* Get missing documentation rules for an export.
+*
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Array of missing rule IDs or empty array if none
 */
-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[];
-};
+declare function getExportMissing(exp: SpecExport7, doccov: DocCovSpec2): MissingDocRule[];
 /**
-* Compare two enriched OpenPkg specs with coverage tracking.
+* Check if an has complete documentation.
+*
+* @param exp - The to check
+* @param doccov - The DocCov spec containing analysis data
+* @returns True if has 100% coverage and no drift
 */
-declare function diffEnrichedSpec(oldSpec: SpecWithDocs, newSpec: SpecWithDocs): EnrichedSpecDiff;
-import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
+declare function isExportFullyDocumented(exp: SpecExport7, doccov: DocCovSpec2): boolean;
+import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
 /** Directory for storing history snapshots */
 declare const HISTORY_DIR = ".doccov/history";
 /**
@@ -402,7 +377,7 @@ interface ExtendedTrendAnalysis {
 /**
 * Compute a coverage snapshot from an OpenPkg spec.
 */
-declare function computeSnapshot(spec: OpenPkg3, options?: {
+declare function computeSnapshot(spec: OpenPkg2, options?: {
 	commit?: string;
 	branch?: string;
 }): CoverageSnapshot;
@@ -428,7 +403,7 @@ declare function loadSnapshots(cwd: string): CoverageSnapshot[];
 * @param options - Optional git metadata
 * @returns Trend data with history and delta
 */
-declare function getTrend(spec: OpenPkg3, cwd: string, options?: {
+declare function getTrend(spec: OpenPkg2, cwd: string, options?: {
 	commit?: string;
 	branch?: string;
 }): CoverageTrend;
@@ -485,12 +460,13 @@ declare function generateWeeklySummaries(snapshots: CoverageSnapshot[]): WeeklyS
 * @param options - Analysis options
 * @returns Extended trend analysis
 */
-declare function getExtendedTrend(spec: OpenPkg3, cwd: string, options?: {
+declare function getExtendedTrend(spec: OpenPkg2, cwd: string, options?: {
 	commit?: string;
 	branch?: string;
 	tier?: RetentionTier;
 }): ExtendedTrendAnalysis;
-import { OpenPkg as OpenPkg4 } from "@openpkg-ts/spec";
+import { DocCovSpec as DocCovSpec3 } from "@doccov/spec";
+import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
 /**
 * Drift summary with category breakdown.
 */
@@ -601,6 +577,7 @@ interface DocCovReport {
 * Generate a DocCov report from an OpenPkg spec.
 *
 * @param spec - The pure OpenPkg spec to analyze
+* @param openpkgPath - Path to the openpkg spec file (for source tracking)
 * @returns A DocCov report with coverage analysis
 *
 * @example
@@ -614,17 +591,18 @@ interface DocCovReport {
 * console.log(`Coverage: ${report.coverage.score}%`);
 * ```
 */
-declare function generateReport(spec: OpenPkg4): DocCovReport;
+declare function generateReport(spec: OpenPkg3, openpkgPath?: string): DocCovReport;
 /**
-* Generate a DocCov report from an already-enriched spec.
+* Generate a DocCov report from OpenPkg spec + DocCov spec composition.
 *
-* Use this when you've already called enrichSpec() and want to avoid
+* Use this when you've already called buildDocCovSpec() and want to avoid
 * recomputing coverage data.
 *
-* @param enriched - The enriched OpenPkg spec
+* @param openpkg - The pure OpenPkg spec
+* @param doccov - The DocCov spec with analysis data
 * @returns A DocCov report with coverage analysis
 */
-declare function generateReportFromEnriched(enriched: EnrichedOpenPkg): DocCovReport;
+declare function generateReportFromDocCov(openpkg: OpenPkg3, doccov: DocCovSpec3): DocCovReport;
 /**
 * Load a cached DocCov report from disk.
 *
@@ -672,7 +650,7 @@ declare function isCachedReportValid(reportPath?: string, sourceFiles?: string[]
 * fs.writeFileSync('api-surface.md', apiSurface);
 * ```
 */
-declare function renderApiSurface(spec: OpenPkg4): string;
+declare function renderApiSurface(spec: OpenPkg3): string;
 interface SchemaDetectionContext {
 	baseDir: string;
 	entryFile: string;
@@ -688,4 +666,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, 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 };
+export { saveSnapshot, saveReport, renderSparkline, renderApiSurface, pruneHistory, pruneByTier, parseAssertions, loadSnapshotsForDays, loadSnapshots, loadCachedReport, isExportFullyDocumented, isCachedReportValid, hasNonAssertionComments, groupDriftsByCategory, getTrend, getExtendedTrend, getExportScore, getExportMissing, getExportDrift, getExportAnalysis, getDriftSummary, generateWeeklySummaries, generateReportFromDocCov, generateReport, formatDriftSummaryLine, formatDelta, ensureSpecCoverage, detectRuntimeSchemas, detectExampleRuntimeErrors, detectExampleAssertionFailures, computeSnapshot, computeExportDrift, computeDrift, categorizeDrift, calculateAggregateCoverage, buildExportRegistry, buildDocCovSpec, WeeklySummary, SchemaDetectionResult, SchemaDetectionContext, RetentionTier, RETENTION_DAYS, OpenPkgSpec, HISTORY_DIR, ExtendedTrendAnalysis, ExportDriftResult, DriftSummary, DriftResult, DetectedSchemaEntry, CoverageTrend, CoverageSnapshot, CategorizedDrift, BuildDocCovOptions };

package/dist/analysis/index.js

@@ -1,6 +1,7 @@
 import {
   HISTORY_DIR,
   RETENTION_DAYS,
+  buildDocCovSpec,
   buildExportRegistry,
   calculateAggregateCoverage,
   categorizeDrift,
@@ -10,19 +11,23 @@ import {
   detectExampleAssertionFailures,
   detectExampleRuntimeErrors,
   detectRuntimeSchemas,
-  enrichSpec,
   ensureSpecCoverage,
   formatDelta,
   formatDriftSummaryLine,
   generateReport,
-  generateReportFromEnriched,
+  generateReportFromDocCov,
   generateWeeklySummaries,
   getDriftSummary,
+  getExportAnalysis,
+  getExportDrift,
+  getExportMissing,
+  getExportScore,
   getExtendedTrend,
   getTrend,
   groupDriftsByCategory,
   hasNonAssertionComments,
   isCachedReportValid,
+  isExportFullyDocumented,
   loadCachedReport,
   loadSnapshots,
   loadSnapshotsForDays,
@@ -33,64 +38,8 @@ import {
   renderSparkline,
   saveReport,
   saveSnapshot
-} from "../shared/chunk-p1stkhse.js";
+} from "../shared/chunk-e9mvnrys.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,
@@ -102,20 +51,23 @@ export {
   loadSnapshotsForDays,
   loadSnapshots,
   loadCachedReport,
+  isExportFullyDocumented,
   isCachedReportValid,
   hasNonAssertionComments,
   groupDriftsByCategory,
   getTrend,
   getExtendedTrend,
+  getExportScore,
+  getExportMissing,
+  getExportDrift,
+  getExportAnalysis,
   getDriftSummary,
   generateWeeklySummaries,
-  generateReportFromEnriched,
+  generateReportFromDocCov,
   generateReport,
   formatDriftSummaryLine,
   formatDelta,
   ensureSpecCoverage,
-  enrichSpec,
-  diffEnrichedSpec,
   detectRuntimeSchemas,
   detectExampleRuntimeErrors,
   detectExampleAssertionFailures,
@@ -125,6 +77,7 @@ export {
   categorizeDrift,
   calculateAggregateCoverage,
   buildExportRegistry,
+  buildDocCovSpec,
   RETENTION_DAYS,
   HISTORY_DIR
 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { DocCovSpec } from "@doccov/spec";
-import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
-type OpenPkgSpec = OpenPkg2;
+import { OpenPkg } from "@openpkg-ts/spec";
+type OpenPkgSpec = OpenPkg;
 interface BuildDocCovOptions {
 	openpkgPath: string;
 	openpkg: OpenPkgSpec;
@@ -39,11 +39,6 @@ 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.
 */
@@ -289,57 +284,50 @@ declare function hasNonAssertionComments(code: string): boolean;
 * Detect assertion failures by comparing stdout to expected values.
 */
 declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
-import { OpenPkg as OpenPkg3, SpecExport as SpecExport7 } from "@openpkg-ts/spec";
+import { DocCovDrift, DocCovSpec as DocCovSpec2, ExportAnalysis, MissingDocRule } from "@doccov/spec";
+import { SpecExport as SpecExport7 } from "@openpkg-ts/spec";
 /**
-* An enriched with computed documentation metadata.
-* Extends SpecExport with the `docs` field for coverage analysis.
+* Get the full analysis data for an export.
+*
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Export analysis or undefined if not found
 */
-type EnrichedExport = SpecExport7 & {
-	docs?: EnrichedDocsMetadata;
-};
+declare function getExportAnalysis(exp: SpecExport7, doccov: DocCovSpec2): ExportAnalysis | undefined;
 /**
-* Extended docs metadata.
+* Get the coverage score for an export.
+*
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Coverage score (0-100) or 100 if not found
 */
-type EnrichedDocsMetadata = SpecDocsMetadata;
+declare function getExportScore(exp: SpecExport7, doccov: DocCovSpec2): number;
 /**
-* An enriched OpenPkg spec with computed documentation metadata.
-* Extends OpenPkg with per-and aggregate coverage data.
+* Get drift issues for an export.
+*
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Array of drift issues or empty array if none
 */
-type EnrichedOpenPkg = Omit<OpenPkg3, "exports"> & {
-	exports: EnrichedExport[];
-	docs?: EnrichedDocsMetadata;
-	/** Drift summary with category breakdown (if drift exists) */
-	driftSummary?: DriftSummary;
-};
-interface EnrichOptions {
-	/**
-	* Per-drift issues to include in enrichment.
-	* Map from ID to drift issues.
-	*/
-	driftByExport?: Map<string, SpecDocDrift[]>;
-}
+declare function getExportDrift(exp: SpecExport7, doccov: DocCovSpec2): DocCovDrift[];
 /**
-* Enrich an OpenPkg spec with documentation coverage metadata.
-*
-* Computes coverage scores and detects drift issues.
+* Get missing documentation rules for an export.
 *
-* @param spec - The pure OpenPkg spec to enrich
-* @param options - Optional enrichment configuration
-* @returns An enriched spec with documentation metadata
-*
-* @example
-* ```ts
-* import { DocCov, enrichSpec } from '@doccov/sdk';
-*
-* const doccov = new DocCov();
-* const { spec } = await doccov.analyzeFileWithDiagnostics('src/index.ts');
+* @param exp - The to look up
+* @param doccov - The DocCov spec containing analysis data
+* @returns Array of missing rule IDs or empty array if none
+*/
+declare function getExportMissing(exp: SpecExport7, doccov: DocCovSpec2): MissingDocRule[];
+/**
+* Check if an has complete documentation.
 *
-* const enriched = enrichSpec(spec);
-* console.log(enriched.docs?.coverageScore); // e.g., 85
-* ```
+* @param exp - The to check
+* @param doccov - The DocCov spec containing analysis data
+* @returns True if has 100% coverage and no drift
 */
-declare function enrichSpec(spec: OpenPkg3, options?: EnrichOptions): EnrichedOpenPkg;
-import { OpenPkg as OpenPkg4 } from "@openpkg-ts/spec";
+declare function isExportFullyDocumented(exp: SpecExport7, doccov: DocCovSpec2): boolean;
+import { DocCovSpec as DocCovSpec3 } from "@doccov/spec";
+import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
 /**
 * DocCov report schema version.
 */
@@ -520,6 +508,7 @@ interface DocCovReport {
 * Generate a DocCov report from an OpenPkg spec.
 *
 * @param spec - The pure OpenPkg spec to analyze
+* @param openpkgPath - Path to the openpkg spec file (for source tracking)
 * @returns A DocCov report with coverage analysis
 *
 * @example
@@ -533,17 +522,18 @@ interface DocCovReport {
 * console.log(`Coverage: ${report.coverage.score}%`);
 * ```
 */
-declare function generateReport(spec: OpenPkg4): DocCovReport;
+declare function generateReport(spec: OpenPkg2, openpkgPath?: string): DocCovReport;
 /**
-* Generate a DocCov report from an already-enriched spec.
+* Generate a DocCov report from OpenPkg spec + DocCov spec composition.
 *
-* Use this when you've already called enrichSpec() and want to avoid
+* Use this when you've already called buildDocCovSpec() and want to avoid
 * recomputing coverage data.
 *
-* @param enriched - The enriched OpenPkg spec
+* @param openpkg - The pure OpenPkg spec
+* @param doccov - The DocCov spec with analysis data
 * @returns A DocCov report with coverage analysis
 */
-declare function generateReportFromEnriched(enriched: EnrichedOpenPkg): DocCovReport;
+declare function generateReportFromDocCov(openpkg: OpenPkg2, doccov: DocCovSpec3): DocCovReport;
 /**
 * Load a cached DocCov report from disk.
 *
@@ -578,7 +568,7 @@ declare function saveReport(report: DocCovReport, reportPath?: string): void;
 * fs.writeFileSync('api-surface.md', apiSurface);
 * ```
 */
-declare function renderApiSurface(spec: OpenPkg4): string;
+declare function renderApiSurface(spec: OpenPkg2): string;
 import { EntryPointDetectionMethod } from "@openpkg-ts/spec";
 /**
 * Configuration types for DocCov.
@@ -748,7 +738,7 @@ declare function hashFiles(filePaths: string[], cwd: string): Record<string, str
 * @returns Array of file paths that changed, were added, or were removed
 */
 declare function diffHashes(cached: Record<string, string>, current: Record<string, string>): string[];
-import { OpenPkg as OpenPkg5 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
 /** Current cache format version */
 declare const CACHE_VERSION = "1.0.0";
 /** Default cache file path */
@@ -783,7 +773,7 @@ interface SpecCache {
 	/** Analysis configuration that affects output */
 	config: SpecCacheConfig;
 	/** The cached OpenPkg spec */
-	spec: OpenPkg5;
+	spec: OpenPkg3;
 }
 /**
 * Result of cache validation.
@@ -826,7 +816,7 @@ declare function loadSpecCache(cwd: string): SpecCache | null;
 * @param spec - OpenPkg spec to cache
 * @param context - Cache context with file paths and config
 */
-declare function saveSpecCache(spec: OpenPkg5, context: CacheContext): void;
+declare function saveSpecCache(spec: OpenPkg3, context: CacheContext): void;
 /**
 * Validate if cached spec is still valid.
 *
@@ -1533,9 +1523,13 @@ declare function isFixableDrift(drift: SpecDocDrift): boolean;
 */
 declare function generateFix(drift: SpecDocDrift, exportEntry: SpecExport9, existingPatch?: JSDocPatch): FixSuggestion | null;
 /**
-* Generate all fixes for an export's drift issues
+* Generate all fixes for an export's drift issues.
+*
+* @param exportEntry - The to generate fixes for
+* @param existingPatch - Optional existing JSDoc patch to merge with
+* @param driftList - Optional drift list from DocCovSpec (if not provided, reads from exportEntry.docs?.drift for backward compat)
 */
-declare function generateFixesForExport(exportEntry: SpecExport9, existingPatch?: JSDocPatch): FixSuggestion[];
+declare function generateFixesForExport(exportEntry: SpecExport9, existingPatch?: JSDocPatch, driftList?: SpecDocDrift[]): FixSuggestion[];
 /**
 * Merge multiple fix patches into a single patch
 */
@@ -1703,7 +1697,7 @@ declare function getDocumentedExports(markdownFiles: MarkdownDocFile[], exportNa
 * Get all exports that lack documentation
 */
 declare function getUndocumentedExports(markdownFiles: MarkdownDocFile[], exportNames: string[]): string[];
-import { CategorizedBreaking, OpenPkg as OpenPkg7, SpecDiff as SpecDiff2 } from "@openpkg-ts/spec";
+import { CategorizedBreaking, OpenPkg as OpenPkg5, SpecDiff as SpecDiff2 } from "@openpkg-ts/spec";
 /**
 * Extended spec diff result with docs impact
 */
@@ -1749,7 +1743,7 @@ interface DiffWithDocsOptions {
 * }
 * ```
 */
-declare function diffSpecWithDocs(oldSpec: OpenPkg7, newSpec: OpenPkg7, options?: DiffWithDocsOptions): SpecDiffWithDocs;
+declare function diffSpecWithDocs(oldSpec: OpenPkg5, newSpec: OpenPkg5, options?: DiffWithDocsOptions): SpecDiffWithDocs;
 /**
 * Check if a diff has any docs impact
 */
@@ -1813,7 +1807,7 @@ declare function typecheckExample(example: string, packagePath: string, options?
 * Type-check multiple examples
 */
 declare function typecheckExamples(examples: string[], packagePath: string, options?: TypecheckOptions): TypecheckResult;
-import { OpenPkg as OpenPkg8 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg6 } from "@openpkg-ts/spec";
 /** Directory for storing history snapshots */
 declare const HISTORY_DIR = ".doccov/history";
 /**
@@ -1908,7 +1902,7 @@ interface ExtendedTrendAnalysis {
 /**
 * Compute a coverage snapshot from an OpenPkg spec.
 */
-declare function computeSnapshot(spec: OpenPkg8, options?: {
+declare function computeSnapshot(spec: OpenPkg6, options?: {
 	commit?: string;
 	branch?: string;
 }): CoverageSnapshot;
@@ -1934,7 +1928,7 @@ declare function loadSnapshots(cwd: string): CoverageSnapshot[];
 * @param options - Optional git metadata
 * @returns Trend data with history and delta
 */
-declare function getTrend(spec: OpenPkg8, cwd: string, options?: {
+declare function getTrend(spec: OpenPkg6, cwd: string, options?: {
 	commit?: string;
 	branch?: string;
 }): CoverageTrend;
@@ -1976,7 +1970,7 @@ declare function pruneByTier(cwd: string, tier: RetentionTier): number;
 * @param options - Analysis options
 * @returns Extended trend analysis
 */
-declare function getExtendedTrend(spec: OpenPkg8, cwd: string, options?: {
+declare function getExtendedTrend(spec: OpenPkg6, cwd: string, options?: {
 	commit?: string;
 	branch?: string;
 	tier?: RetentionTier;
@@ -2189,7 +2183,7 @@ declare function parseListFlag(value?: string | string[]): string[] | undefined;
 * ```
 */
 declare function mergeFilters(config: DocCovConfig | null, overrides: FilterOptions): ResolvedFilters;
-import { OpenPkg as OpenPkg9 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg7 } from "@openpkg-ts/spec";
 /**
 * Parsed components of a GitHub URL.
 */
@@ -2282,7 +2276,7 @@ declare function buildRawUrl(parsed: ParsedGitHubUrl, filePath: string): string;
 * }
 * ```
 */
-declare function fetchSpecFromGitHub(parsed: ParsedGitHubUrl): Promise<OpenPkg9 | null>;
+declare function fetchSpecFromGitHub(parsed: ParsedGitHubUrl): Promise<OpenPkg7 | null>;
 /**
 * Options for fetching a spec from GitHub.
 */
@@ -2302,7 +2296,7 @@ interface FetchSpecOptions {
 * @param branchOrOptions - Branch name (default: 'main') or options object
 * @returns The OpenPkg spec, or null if not found
 */
-declare function fetchSpec(owner: string, repo: string, branchOrOptions?: string | FetchSpecOptions): Promise<OpenPkg9 | null>;
+declare function fetchSpec(owner: string, repo: string, branchOrOptions?: string | FetchSpecOptions): Promise<OpenPkg7 | null>;
 /**
 * Progress event for installation status updates.
 */
@@ -2489,6 +2483,8 @@ declare function fetchGitHubContext(repoUrl: string, refOrOptions?: string | Fet
 * List packages in a monorepo workspace.
 */
 declare function listWorkspacePackages(owner: string, repo: string, ref: string, patterns: string[], authToken?: string): Promise<string[]>;
+import { DocCovSpec as DocCovSpec4 } from "@doccov/spec";
+import { OpenPkg as OpenPkg8 } from "@openpkg-ts/spec";
 /**
 * A documentation drift issue in a spec summary.
 */
@@ -2521,27 +2517,29 @@ interface SpecSummary {
 	drift: SummaryDriftIssue[];
 }
 /**
-* Extract a summary from an enriched OpenPkg spec.
+* Extract a summary from OpenPkg spec + DocCov spec composition.
 *
 * This consolidates the logic previously duplicated in:
 * - CLI scan.ts (drift collection)
 * - CLI reports/stats.ts (computeStats)
 * - API scan-stream.ts (inline extraction script)
 *
-* @param spec - The enriched OpenPkg spec to summarize (must be enriched via enrichSpec())
+* @param openpkg - The pure OpenPkg spec
+* @param doccov - The DocCov spec with analysis data
 * @returns Summary of documentation coverage
 *
 * @example
 * ```typescript
-* import { enrichSpec, extractSpecSummary } from '@doccov/sdk';
+* import { buildDocCovSpec, extractSpecSummary } from '@doccov/sdk';
 *
-* const enriched = enrichSpec(spec);
-* const summary = extractSpecSummary(enriched);
+* const doccov = buildDocCovSpec({ openpkg: spec, openpkgPath: 'openpkg.json' });
+* const summary = extractSpecSummary(spec, doccov);
 * console.log(`Coverage: ${summary.coverage}%`);
 * console.log(`Undocumented: ${summary.undocumented.length}`);
 * ```
 */
-declare function extractSpecSummary(spec: EnrichedOpenPkg): SpecSummary;
+declare function extractSpecSummary(openpkg: OpenPkg8, doccov: DocCovSpec4): SpecSummary;
+import { OpenPkg as OpenPkg_mulpcdndjy } from "@openpkg-ts/spec";
 /**
 * Build Plan types for AI-powered repository scanning.
 */
@@ -2638,7 +2636,7 @@ interface BuildPlanExecutionResult {
 	/** Whether all required steps succeeded */
 	success: boolean;
 	/** Generated OpenPkg spec (if successful) */
-	spec?: import("@openpkg-ts/spec").OpenPkg;
+	spec?: OpenPkg_mulpcdndjy;
 	/** Results for each step */
 	stepResults: BuildPlanStepResult[];
 	/** Total execution time in milliseconds */
@@ -2646,4 +2644,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, 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 };
+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, isExportFullyDocumented, isExecutableLang, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getExportScore, getExportMissing, getExportDrift, getExportAnalysis, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, generateReportFromDocCov, generateReport, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findRemovedReferences, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, findAdapter, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractStandardSchemasFromProject, extractStandardSchemas, extractSpecSummary, extractSchemaType, extractSchemaOutputType, extractPackageSpec, extractImports, extractFunctionCalls, ensureSpecCoverage, 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, 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

@@ -6,6 +6,7 @@ import {
   RETENTION_DAYS,
   applyEdits,
   applyPatchToJSDoc,
+  buildDocCovSpec,
   buildExportRegistry,
   calculateAggregateCoverage,
   categorizeDrift,
@@ -17,7 +18,6 @@ import {
   detectExampleAssertionFailures,
   detectExampleRuntimeErrors,
   detectRuntimeSchemas,
-  enrichSpec,
   ensureSpecCoverage,
   extractStandardSchemas,
   extractStandardSchemasFromProject,
@@ -27,14 +27,19 @@ import {
   generateFix,
   generateFixesForExport,
   generateReport,
-  generateReportFromEnriched,
+  generateReportFromDocCov,
   getDriftSummary,
+  getExportAnalysis,
+  getExportDrift,
+  getExportMissing,
+  getExportScore,
   getExtendedTrend,
   getTrend,
   groupDriftsByCategory,
   hasNonAssertionComments,
   isBuiltInIdentifier,
   isBuiltInTypeName,
+  isExportFullyDocumented,
   isFixableDrift,
   isStandardJSONSchema,
   loadCachedReport,
@@ -51,7 +56,7 @@ import {
   saveSnapshot,
   serializeJSDoc,
   ts
-} from "./shared/chunk-p1stkhse.js";
+} from "./shared/chunk-e9mvnrys.js";
 import {
   mergeFilters,
   parseListFlag
@@ -66,141 +71,6 @@ import {
   getDiffReportPath,
   getReportPath
 } from "./shared/chunk-esptwrfq.js";
-
-// 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/openpkg.ts
 import * as fsSync from "node:fs";
 import * as fs5 from "node:fs/promises";
@@ -6740,20 +6610,20 @@ async function listWorkspacePackages(owner, repo, ref, patterns, authToken) {
   return packages;
 }
 // src/scan/summary.ts
-function extractSpecSummary(spec) {
-  const exports = spec.exports ?? [];
+function extractSpecSummary(openpkg, doccov) {
+  const exports = openpkg.exports ?? [];
   const undocumented = [];
   const drift = [];
   for (const exp of exports) {
-    const docs = exp.docs;
-    if (!docs)
+    const analysis = getExportAnalysis(exp, doccov);
+    if (!analysis)
       continue;
-    const hasMissing = (docs.missing?.length ?? 0) > 0;
-    const isPartial = (docs.coverageScore ?? 0) < 100;
+    const hasMissing = (analysis.missing?.length ?? 0) > 0;
+    const isPartial = (analysis.coverageScore ?? 0) < 100;
     if (hasMissing || isPartial) {
       undocumented.push(exp.name);
     }
-    for (const d of docs.drift ?? []) {
+    for (const d of analysis.drift ?? []) {
       drift.push({
         export: exp.name,
         type: d.type,
@@ -6763,9 +6633,9 @@ function extractSpecSummary(spec) {
     }
   }
   return {
-    coverage: spec.docs?.coverageScore ?? 0,
+    coverage: doccov.summary.score,
     exportCount: exports.length,
-    typeCount: spec.types?.length ?? 0,
+    typeCount: openpkg.types?.length ?? 0,
     driftCount: drift.length,
     undocumented,
     drift
@@ -6809,6 +6679,7 @@ export {
   isStandardJSONSchema,
   isSchemaType,
   isFixableDrift,
+  isExportFullyDocumented,
   isExecutableLang,
   installDependencies,
   hashString,
@@ -6828,11 +6699,15 @@ export {
   getPrimaryBuildScript,
   getInstallCommand,
   getExtendedTrend,
+  getExportScore,
+  getExportMissing,
+  getExportDrift,
+  getExportAnalysis,
   getDriftSummary,
   getDocumentedExports,
   getDocsImpactSummary,
   getDiffReportPath,
-  generateReportFromEnriched,
+  generateReportFromDocCov,
   generateReport,
   generateFixesForExport,
   generateFix,
@@ -6857,7 +6732,6 @@ export {
   extractImports,
   extractFunctionCalls,
   ensureSpecCoverage,
-  enrichSpec,
   diffSpecWithDocs,
   diffHashes,
   detectRuntimeSchemas,

package/dist/shared/{chunk-p1stkhse.js → chunk-e9mvnrys.js}

@@ -42,10 +42,10 @@ function generateFix(drift, exportEntry, existingPatch) {
       return null;
   }
 }
-function generateFixesForExport(exportEntry, existingPatch) {
+function generateFixesForExport(exportEntry, existingPatch, driftList) {
   const fixes = [];
-  const driftList = exportEntry.docs?.drift ?? [];
-  for (const drift of driftList) {
+  const drifts = driftList ?? exportEntry.docs?.drift ?? [];
+  for (const drift of drifts) {
     const fix = generateFix(drift, exportEntry, existingPatch);
     if (fix) {
       fixes.push(fix);
@@ -2016,8 +2016,143 @@ function computeExportDrift(entry, registry) {
   ];
 }
 
+// src/analysis/doccov-builder.ts
+import { DRIFT_CATEGORIES } 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_CATEGORIES[driftType],
+    fixable: isFixableDrift(drift)
+  };
+}
+
 // src/analysis/drift/types.ts
-var DRIFT_CATEGORIES = {
+var DRIFT_CATEGORIES2 = {
   "param-mismatch": "structural",
   "param-type-mismatch": "structural",
   "return-type-mismatch": "structural",
@@ -2048,7 +2183,7 @@ var DRIFT_CATEGORY_DESCRIPTIONS = {
 function categorizeDrift(drift) {
   return {
     ...drift,
-    category: DRIFT_CATEGORIES[drift.type],
+    category: DRIFT_CATEGORIES2[drift.type],
     fixable: isFixableDrift(drift)
   };
 }
@@ -2125,129 +2260,83 @@ function ensureSpecCoverage(spec) {
     }
   };
 }
-// src/analysis/enrich.ts
-function collectAllMissing(exports) {
-  const allMissing = new Set;
-  for (const exp of exports) {
-    if (exp.docs?.missing) {
-      for (const ruleId of exp.docs.missing) {
-        allMissing.add(ruleId);
-      }
-    }
-  }
-  return Array.from(allMissing);
+// src/analysis/lookup.ts
+function getExportAnalysis(exp, doccov) {
+  const id = exp.id ?? exp.name;
+  return doccov.exports[id];
 }
-function collectAllDrift(exports) {
-  const allDrift = [];
-  for (const exp of exports) {
-    if (exp.docs?.drift) {
-      allDrift.push(...exp.docs.drift);
-    }
-  }
-  return allDrift;
+function getExportScore(exp, doccov) {
+  const analysis = getExportAnalysis(exp, doccov);
+  return analysis?.coverageScore ?? 100;
 }
-function computeExportCoverage(exp) {
-  const missing = [];
-  if (!exp.description) {
-    missing.push("has-description");
-    return { score: 0, missing };
-  }
-  return { score: 100, missing: [] };
+function getExportDrift(exp, doccov) {
+  const analysis = getExportAnalysis(exp, doccov);
+  return analysis?.drift ?? [];
 }
-function enrichSpec(spec, options = {}) {
-  const { driftByExport } = options;
-  const exportRegistry = buildExportRegistry(spec);
-  let totalCoverage = 0;
-  const enrichedExports = spec.exports.map((exp) => {
-    const coverage = computeExportCoverage(exp);
-    const drift2 = computeExportDrift(exp, exportRegistry);
-    const additionalDrift = driftByExport?.get(exp.id);
-    const allDrift2 = additionalDrift ? [...drift2, ...additionalDrift] : drift2;
-    totalCoverage += coverage.score;
-    const docs2 = {
-      coverageScore: coverage.score
-    };
-    if (coverage.missing.length > 0) {
-      docs2.missing = coverage.missing;
-    }
-    if (allDrift2.length > 0) {
-      docs2.drift = allDrift2;
-    }
-    return {
-      ...exp,
-      docs: docs2
-    };
-  });
-  const count = enrichedExports.length;
-  const allMissing = collectAllMissing(enrichedExports);
-  const allDrift = collectAllDrift(enrichedExports);
-  const docs = {
-    coverageScore: count === 0 ? 100 : Math.round(totalCoverage / count)
-  };
-  if (allMissing.length > 0) {
-    docs.missing = allMissing;
-  }
-  if (allDrift.length > 0) {
-    docs.drift = allDrift;
-  }
-  const driftSummary = allDrift.length > 0 ? getDriftSummary(allDrift) : undefined;
-  return {
-    ...spec,
-    exports: enrichedExports,
-    docs,
-    driftSummary
-  };
+function getExportMissing(exp, doccov) {
+  const analysis = getExportAnalysis(exp, doccov);
+  return analysis?.missing ?? [];
+}
+function isExportFullyDocumented(exp, doccov) {
+  const analysis = getExportAnalysis(exp, doccov);
+  if (!analysis)
+    return true;
+  return analysis.coverageScore === 100 && (!analysis.drift || analysis.drift.length === 0);
 }
 
 // src/analysis/report.ts
 import * as fs2 from "node:fs";
 import * as path2 from "node:path";
-function generateReport(spec) {
-  const enriched = enrichSpec(spec);
-  return generateReportFromEnriched(enriched);
+function generateReport(spec, openpkgPath = "openpkg.json") {
+  const doccov = buildDocCovSpec({ openpkg: spec, openpkgPath });
+  return generateReportFromDocCov(spec, doccov);
 }
-function generateReportFromEnriched(enriched) {
+function generateReportFromDocCov(openpkg, doccov) {
   const exportsData = {};
   const missingByRule = {};
   let documentedExports = 0;
   let totalDrift = 0;
-  for (const exp of enriched.exports) {
+  for (const exp of openpkg.exports ?? []) {
+    const analysis = getExportAnalysis(exp, doccov);
     const data = {
       name: exp.name,
       kind: exp.kind,
-      coverageScore: exp.docs?.coverageScore ?? 100
+      coverageScore: analysis?.coverageScore ?? 100
     };
-    if (exp.docs?.missing && exp.docs.missing.length > 0) {
-      data.missing = exp.docs.missing;
-      for (const ruleId of exp.docs.missing) {
+    if (analysis?.missing && analysis.missing.length > 0) {
+      data.missing = analysis.missing;
+      for (const ruleId of analysis.missing) {
         missingByRule[ruleId] = (missingByRule[ruleId] ?? 0) + 1;
       }
     } else {
       documentedExports++;
     }
-    if (exp.docs?.drift && exp.docs.drift.length > 0) {
-      data.drift = exp.docs.drift;
-      totalDrift += exp.docs.drift.length;
+    if (analysis?.drift && analysis.drift.length > 0) {
+      data.drift = analysis.drift;
+      totalDrift += analysis.drift.length;
     }
-    exportsData[exp.id] = data;
+    const exportId = exp.id ?? exp.name;
+    exportsData[exportId] = data;
   }
-  const allDrifts = enriched.exports.flatMap((exp) => exp.docs?.drift ?? []);
-  const driftSummary = allDrifts.length > 0 ? getDriftSummary(allDrifts) : undefined;
   const coverage = {
-    score: enriched.docs?.coverageScore ?? 100,
-    totalExports: enriched.exports.length,
+    score: doccov.summary.score,
+    totalExports: doccov.summary.totalExports,
     documentedExports,
     missingByRule,
     driftCount: totalDrift,
-    driftSummary
+    driftSummary: doccov.summary.drift.total > 0 ? {
+      total: doccov.summary.drift.total,
+      fixable: doccov.summary.drift.fixable,
+      byCategory: doccov.summary.drift.byCategory
+    } : undefined
   };
   return {
     $schema: "https://doccov.com/schemas/v1.0.0/report.schema.json",
     version: REPORT_VERSION,
     generatedAt: new Date().toISOString(),
     spec: {
-      name: enriched.meta.name,
-      version: enriched.meta.version
+      name: openpkg.meta.name,
+      version: openpkg.meta.version
     },
     coverage,
     exports: exportsData
@@ -2911,4 +3000,4 @@ function getExtendedTrend(spec, cwd, options) {
   };
 }
 
-export { isFixableDrift, generateFix, generateFixesForExport, mergeFixes, categorizeDrifts, ts, parseJSDocToPatch, applyPatchToJSDoc, serializeJSDoc, findJSDocLocation, applyEdits, createSourceFile, isBuiltInTypeName, isBuiltInIdentifier, detectExampleRuntimeErrors, parseAssertions, hasNonAssertionComments, detectExampleAssertionFailures, buildExportRegistry, computeDrift, computeExportDrift, DRIFT_CATEGORIES, DRIFT_CATEGORY_LABELS, DRIFT_CATEGORY_DESCRIPTIONS, categorizeDrift, groupDriftsByCategory, getDriftSummary, formatDriftSummaryLine, calculateAggregateCoverage, ensureSpecCoverage, enrichSpec, generateReport, generateReportFromEnriched, loadCachedReport, saveReport, isCachedReportValid, renderApiSurface, isStandardJSONSchema, resolveCompiledPath, extractStandardSchemas, extractStandardSchemasFromProject, detectRuntimeSchemas, HISTORY_DIR, RETENTION_DAYS, computeSnapshot, saveSnapshot, loadSnapshots, getTrend, renderSparkline, formatDelta, pruneHistory, pruneByTier, loadSnapshotsForDays, generateWeeklySummaries, getExtendedTrend };
+export { isFixableDrift, generateFix, generateFixesForExport, mergeFixes, categorizeDrifts, ts, parseJSDocToPatch, applyPatchToJSDoc, serializeJSDoc, findJSDocLocation, applyEdits, createSourceFile, isBuiltInTypeName, isBuiltInIdentifier, detectExampleRuntimeErrors, parseAssertions, hasNonAssertionComments, detectExampleAssertionFailures, buildExportRegistry, computeDrift, computeExportDrift, buildDocCovSpec, DRIFT_CATEGORIES2 as DRIFT_CATEGORIES, DRIFT_CATEGORY_LABELS, DRIFT_CATEGORY_DESCRIPTIONS, categorizeDrift, groupDriftsByCategory, getDriftSummary, formatDriftSummaryLine, calculateAggregateCoverage, ensureSpecCoverage, getExportAnalysis, getExportScore, getExportDrift, getExportMissing, isExportFullyDocumented, generateReport, generateReportFromDocCov, loadCachedReport, saveReport, isCachedReportValid, renderApiSurface, isStandardJSONSchema, resolveCompiledPath, extractStandardSchemas, extractStandardSchemasFromProject, detectRuntimeSchemas, HISTORY_DIR, RETENTION_DAYS, computeSnapshot, saveSnapshot, loadSnapshots, getTrend, renderSparkline, formatDelta, pruneHistory, pruneByTier, loadSnapshotsForDays, generateWeeklySummaries, getExtendedTrend };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/sdk",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "description": "DocCov SDK - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",