@doccov/sdk 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -1,3 +1,94 @@
+/**
+* Configuration types for DocCov.
+* These types are shared between CLI and API.
+*/
+/**
+* Documentation configuration options.
+*/
+interface DocsConfig {
+	/** Glob patterns for markdown docs to include */
+	include?: string[];
+	/** Glob patterns for markdown docs to exclude */
+	exclude?: string[];
+}
+/**
+* Example validation modes.
+*/
+type ExampleValidationMode = "presence" | "typecheck" | "run";
+/**
+* Schema extraction modes for validation libraries (Zod, Valibot, TypeBox, ArkType).
+*
+* - 'static': TypeScript Compiler API only (no runtime, always safe)
+* - 'runtime': Standard Schema runtime extraction (requires built package)
+* - 'hybrid': Try runtime first, fall back to static
+*/
+type SchemaExtractionMode = "static" | "runtime" | "hybrid";
+/**
+* Check command configuration options.
+*/
+interface CheckConfig {
+	/**
+	* Example validation modes to run.
+	* Can be a single mode, array of modes, or comma-separated string.
+	* - 'presence': Check that @example blocks exist on exports
+	* - 'typecheck': Compile examples with TypeScript
+	* - 'run': Execute examples and validate assertions
+	*/
+	examples?: ExampleValidationMode | ExampleValidationMode[] | string;
+	/** Minimum coverage percentage required (0-100) */
+	minCoverage?: number;
+	/** Maximum drift percentage allowed (0-100) */
+	maxDrift?: number;
+}
+/**
+* Normalized DocCov configuration.
+* This is the parsed/normalized form used by commands.
+*/
+interface DocCovConfig {
+	/** Export include patterns */
+	include?: string[];
+	/** Export exclude patterns */
+	exclude?: string[];
+	/** Plugins (future) */
+	plugins?: unknown[];
+	/** Documentation configuration */
+	docs?: DocsConfig;
+	/** Check command configuration */
+	check?: CheckConfig;
+	/**
+	* Schema extraction mode for validation libraries.
+	*
+	* - 'static' (default): Safe, uses TypeScript Compiler API
+	* - 'runtime': Uses Standard Schema (requires built package)
+	* - 'hybrid': Tries runtime first, falls back to static
+	*
+	* Runtime extraction provides richer JSON Schema output (formats, patterns)
+	* but requires the package to be built first.
+	*/
+	schemaExtraction?: SchemaExtractionMode;
+}
+/**
+* Define a DocCov configuration.
+* Helper function for type-safe configuration in doccov.config.ts.
+*
+* @param config - Configuration object
+* @returns The configuration object (for type inference)
+*
+* @example
+* ```typescript
+* // doccov.config.ts
+* import { defineConfig } from '@doccov/sdk';
+*
+* defineConfig({
+*   include: ['MyClass', 'myFunction'],
+*   exclude: ['internal*'],
+*   check: {
+*     minCoverage: 80,
+*   },
+* });
+* ```
+*/
+declare function defineConfig(config: DocCovConfig): DocCovConfig;
 interface DocCovOptions {
 	includePrivate?: boolean;
 	followImports?: boolean;
@@ -7,6 +98,14 @@ interface DocCovOptions {
 	useCache?: boolean;
 	/** Working directory for cache operations (default: process.cwd()) */
 	cwd?: string;
+	/**
+	* Schema extraction mode for validation libraries (Zod, Valibot, etc.)
+	*
+	* - 'static' (default): TypeScript Compiler API only (no runtime)
+	* - 'runtime': Standard Schema runtime extraction (requires built package)
+	* - 'hybrid': Try runtime first, fall back to static
+	*/
+	schemaExtraction?: SchemaExtractionMode;
 }
 /**
 * Pre-detected Standard Schema for a variable export.
@@ -16,176 +115,159 @@ interface DetectedSchemaEntry {
 	vendor: string;
 }
 /**
-* Standard JSON Schema Integration
+* Runtime Schema Detection (Stubbed)
 *
-* Provides runtime detection and extraction of Standard JSON Schema v1 compliant libraries.
-* This enables support for Zod v4.2+, ArkType, Valibot, and other Standard Schema compliant libraries.
-*
-* @see https://github.com/standard-schema/standard-schema
-*/
-/**
-* Standard JSON Schema V1 interface (minimal subset for detection).
-* Full spec: https://github.com/standard-schema/standard-schema
+* Standard Schema extraction has been removed. This module provides
+* empty stubs to maintain API compatibility.
 */
-interface StandardJSONSchemaV1 {
-	readonly "~standard": {
-		readonly version: 1;
-		readonly vendor: string;
-		readonly jsonSchema: {
-			readonly output: (options?: StandardSchemaOutputOptions) => Record<string, unknown>;
-		};
-	};
+interface SchemaDetectionContext {
+	baseDir: string;
+	entryFile: string;
 }
+interface SchemaDetectionResult {
+	schemas: Map<string, never>;
+	errors: string[];
+}
+declare function detectRuntimeSchemas(_context: SchemaDetectionContext): Promise<SchemaDetectionResult>;
+declare function clearSchemaCache(): void;
+import * as TS from "typescript";
 /**
-* Options for Standard Schema JSON output.
+* A schema adapter can detect and extract output types from a specific
+* schema validation library.
 */
-interface StandardSchemaOutputOptions {
+interface SchemaAdapter {
+	/** Unique identifier for this adapter */
+	readonly id: string;
+	/** npm package name(s) this adapter handles */
+	readonly packages: readonly string[];
+	/**
+	* Check if a type matches this adapter's schema library.
+	* Should be fast - called for every export.
+	*/
+	matches(type: TS.Type, checker: TS.TypeChecker): boolean;
+	/**
+	* Extract the output type from a schema type.
+	* Returns null if extraction fails.
+	*/
+	extractOutputType(type: TS.Type, checker: TS.TypeChecker): TS.Type | null;
 	/**
-	* Target JSON Schema dialect.
-	* - 'draft-07': JSON Schema Draft 07 (widest compatibility)
-	* - 'draft-2020-12': Latest JSON Schema (best features)
-	* - 'openapi-3.0': OpenAPI 3.0 compatible schema
+	* Extract the input type from a schema type (optional).
+	* Useful for transforms where input differs from output.
 	*/
-	target?: "draft-07" | "draft-2020-12" | "openapi-3.0";
+	extractInputType?(type: TS.Type, checker: TS.TypeChecker): TS.Type | null;
 }
 /**
-* Result of Standard Schema extraction.
+* Result of schema type extraction
 */
-interface StandardSchemaResult {
-	/** The extracted JSON Schema */
-	schema: Record<string, unknown>;
-	/** The vendor library (e.g., 'zod', 'arktype', 'valibot') */
-	vendor: string;
-	/** Standard Schema version */
-	version: number;
+interface SchemaExtractionResult {
+	/** The adapter that matched */
+	adapter: SchemaAdapter;
+	/** The extracted output type */
+	outputType: TS.Type;
+	/** The extracted input type (if different from output) */
+	inputType?: TS.Type;
 }
+import * as TS2 from "typescript";
 /**
-* Check if a value implements the Standard JSON Schema v1 interface.
-*
-* This enables runtime detection of schema libraries that implement the standard,
-* including Zod v4.2+, ArkType, Valibot, and others.
-*
-* @param value - Value to check
-* @returns True if the value implements StandardJSONSchemaV1
-*
-* @example
-* ```typescript
-* import { isStandardJSONSchema, extractViaStandardSchema } from '@doccov/sdk';
-* import { z } from 'zod';
-*
-* const UserSchema = z.object({
-*   name: z.string(),
-*   age: z.number().min(0),
-* });
-*
-* if (isStandardJSONSchema(UserSchema)) {
-*   const jsonSchema = extractViaStandardSchema(UserSchema);
-*   console.log(jsonSchema);
-*   // { type: 'object', properties: { name: { type: 'string' }, age: { type: 'number', minimum: 0 } } }
-* }
-* ```
+* Find an adapter that matches the given type.
+* Returns null if no adapter matches.
 */
-declare function isStandardJSONSchema(value: unknown): value is StandardJSONSchemaV1;
+declare function findAdapter(type: TS2.Type, checker: TS2.TypeChecker): SchemaAdapter | null;
 /**
-* Extract JSON Schema from a Standard Schema v1 compliant value.
-*
-* @param schema - A value implementing StandardJSONSchemaV1
-* @param options - Extraction options
-* @returns Extracted JSON Schema result with vendor info
-* @throws Error if the value doesn't implement Standard Schema
-*
-* @example
-* ```typescript
-* import { extractViaStandardSchema } from '@doccov/sdk';
-*
-* // Works with any Standard Schema v1 compliant library
-* const result = extractViaStandardSchema(mySchema, { target: 'draft-2020-12' });
-* console.log(result.vendor); // 'zod', 'arktype', 'valibot', etc.
-* console.log(result.schema); // The extracted JSON Schema
-* ```
+* Check if a type is from a recognized schema library.
 */
-declare function extractViaStandardSchema(schema: StandardJSONSchemaV1, options?: StandardSchemaOutputOptions): StandardSchemaResult;
+declare function isSchemaType(type: TS2.Type, checker: TS2.TypeChecker): boolean;
 /**
-* Try to extract JSON Schema from a value that may or may not implement Standard Schema.
-*
-* @param value - Any value that might be a Standard Schema
-* @param options - Extraction options
-* @returns Extraction result, or null if value doesn't implement Standard Schema
-*
-* @example
-* ```typescript
-* import { tryExtractStandardSchema } from '@doccov/sdk';
-*
-* const result = tryExtractStandardSchema(unknownSchema);
-* if (result) {
-*   console.log(`Extracted ${result.vendor} schema:`, result.schema);
-* }
-* ```
+* Extract the output type from a schema type.
+* Returns null if:
+* - The type is not from a recognized schema library
+* - The adapter fails to extract the output type
 */
-declare function tryExtractStandardSchema(value: unknown, options?: StandardSchemaOutputOptions): StandardSchemaResult | null;
+declare function extractSchemaOutputType(type: TS2.Type, checker: TS2.TypeChecker): TS2.Type | null;
 /**
-* Supported Standard Schema vendors and their minimum versions.
+* Full extraction with adapter info.
+* Useful when you need to know which library was detected.
 */
-declare const KNOWN_VENDORS: {
-	readonly zod: {
-		readonly minVersion: "4.2.0";
-		readonly homepage: "https://zod.dev";
-	};
-	readonly arktype: {
-		readonly minVersion: "2.0.0";
-		readonly homepage: "https://arktype.io";
-	};
-	readonly valibot: {
-		readonly minVersion: "1.0.0";
-		readonly homepage: "https://valibot.dev";
+declare function extractSchemaType(type: TS2.Type, checker: TS2.TypeChecker): SchemaExtractionResult | null;
+/**
+* Get all registered adapters.
+* Useful for logging/debugging.
+*/
+declare function getRegisteredAdapters(): readonly SchemaAdapter[];
+/**
+* Get supported library names.
+* Useful for documentation/help output.
+*/
+declare function getSupportedLibraries(): readonly string[];
+/**
+* Standard JSON Schema v1 interface (minimal for detection).
+*/
+interface StandardJSONSchemaV1 {
+	"~standard": {
+		version: number;
+		vendor: string;
+		jsonSchema?: {
+			output: (target?: string) => Record<string, unknown>;
+			input?: (target?: string) => Record<string, unknown>;
+		};
 	};
-};
-type KnownVendor = keyof typeof KNOWN_VENDORS;
+}
 /**
-* Context for schema detection.
+* Result of extracting Standard Schema from an export.
 */
-interface SchemaDetectionContext {
-	/** Base directory for resolving modules */
-	baseDir: string;
-	/** Entry file being analyzed */
-	entryFile: string;
+interface StandardSchemaExtractionResult {
+	exportName: string;
+	vendor: string;
+	outputSchema: Record<string, unknown>;
+	inputSchema?: Record<string, unknown>;
 }
 /**
-* Result of runtime schema detection for a module.
+* Options for runtime Standard Schema extraction.
 */
-interface SchemaDetectionResult {
-	/** Map of name to detected Standard Schema */
-	schemas: Map<string, StandardSchemaResult>;
-	/** Errors encountered during detection (non-fatal) */
+interface ExtractStandardSchemasOptions {
+	/** Timeout in milliseconds (default: 10000) */
+	timeout?: number;
+	/** JSON Schema target version (default: 'draft-2020-12') */
+	target?: "draft-2020-12" | "draft-07" | "openapi-3.0";
+}
+/**
+* Result of Standard Schema extraction.
+*/
+interface StandardSchemaExtractionOutput {
+	schemas: Map<string, StandardSchemaExtractionResult>;
 	errors: string[];
 }
 /**
-* Detect Standard Schema exports from a compiled module.
-*
-* This function attempts to load the compiled/transpiled version of the entry file
-* and checks each for Standard Schema compliance.
-*
-* @param context - Detection context with paths
-* @returns Detection result with found schemas and any errors
+* Check if an object implements StandardJSONSchemaV1.
+* This is a static type guard - doesn't require runtime.
+*/
+declare function isStandardJSONSchema(obj: unknown): obj is StandardJSONSchemaV1;
+/**
+* Resolve compiled JS path from TypeScript source.
+* Tries common output locations: dist/, build/, lib/, same dir.
+*/
+declare function resolveCompiledPath(tsPath: string, baseDir: string): string | null;
+/**
+* Extract Standard Schema JSON Schemas from a compiled JS module.
 *
-* @example
-* ```typescript
-* const result = await detectRuntimeSchemas({
-*   baseDir: '/path/to/project',
-*   entryFile: '/path/to/project/dist/index.js',
-* });
+* **Security Note**: This executes the module in a subprocess.
+* Only use with trusted code (user's own packages).
 *
-* for (const [name, schema] of result.schemas) {
-*   console.log(`Found ${schema.vendor} schema: ${name}`);
-* }
-* ```
+* @param compiledJsPath - Path to compiled .js file
+* @param options - Extraction options
+* @returns Extraction results with schemas and any errors
 */
-declare function detectRuntimeSchemas(context: SchemaDetectionContext): Promise<SchemaDetectionResult>;
+declare function extractStandardSchemas(compiledJsPath: string, options?: ExtractStandardSchemasOptions): Promise<StandardSchemaExtractionOutput>;
 /**
-* Clear the module cache.
-* Useful for testing or when modules may have changed.
+* Extract Standard Schema from a TypeScript project.
+*
+* Convenience function that resolves compiled JS and extracts schemas.
+*
+* @param entryFile - TypeScript entry file path
+* @param baseDir - Project base directory
+* @param options - Extraction options
 */
-declare function clearSchemaCache(): void;
+declare function extractStandardSchemasFromProject(entryFile: string, baseDir: string, options?: ExtractStandardSchemasOptions): Promise<StandardSchemaExtractionOutput>;
 import { DriftCategory, SpecDocDrift, SpecExport } from "@openpkg-ts/spec";
 interface ExampleRunResult {
 	success: boolean;
@@ -413,227 +495,18 @@ declare function ensureSpecCoverage(spec: OpenPkgSpec): OpenPkgSpec & {
 		coverageScore: number;
 	};
 };
-import { OpenPkg as OpenPkg3, SpecDocDrift as SpecDocDrift2, SpecDocsMetadata, SpecExport as SpecExport3 } from "@openpkg-ts/spec";
-import { SpecExport as SpecExport2, SpecExportKind } from "@openpkg-ts/spec";
-import * as TS from "typescript";
-/**
-* Represents a single parameter in a JSDoc patch
-*/
-interface JSDocParam {
-	name: string;
-	type?: string;
-	description?: string;
-	optional?: boolean;
-}
-/**
-* Represents a return type in a JSDoc patch
-*/
-interface JSDocReturn {
-	type?: string;
-	description?: string;
-}
-/**
-* Represents a generic tag in a JSDoc patch
-*/
-interface JSDocTag {
-	name: string;
-	text: string;
-}
-/**
-* A patchable representation of a JSDoc comment
-*/
-interface JSDocPatch {
-	description?: string;
-	params?: JSDocParam[];
-	returns?: JSDocReturn;
-	examples?: string[];
-	deprecated?: string | false;
-	async?: boolean;
-	type?: string;
-	typeParams?: Array<{
-		name: string;
-		constraint?: string;
-		description?: string;
-	}>;
-	otherTags?: JSDocTag[];
-}
-/**
-* Represents an edit to be applied to a source file
-*/
-interface JSDocEdit {
-	filePath: string;
-	symbolName: string;
-	startLine: number;
-	endLine: number;
-	hasExisting: boolean;
-	existingJSDoc?: string;
-	newJSDoc: string;
-	indent: string;
-}
-/**
-* Result of applying edits to source files
-*/
-interface ApplyEditsResult {
-	filesModified: number;
-	editsApplied: number;
-	errors: Array<{
-		file: string;
-		error: string;
-	}>;
-}
-/**
-* Parse a JSDoc comment string into a patchable structure
-*/
-declare function parseJSDocToPatch(jsDocText: string): JSDocPatch;
-/**
-* Apply a partial patch to an existing JSDoc patch, preserving unmodified content
-*/
-declare function applyPatchToJSDoc(existing: JSDocPatch, updates: Partial<JSDocPatch>): JSDocPatch;
-/**
-* Serialize a JSDocPatch back to a formatted comment string
-*/
-declare function serializeJSDoc(patch: JSDocPatch, indent?: string): string;
-/**
-* Find the JSDoc location for a declaration in a source file
-*/
-declare function findJSDocLocation(sourceFile: TS.SourceFile, symbolName: string, approximateLine?: number): {
-	startLine: number;
-	endLine: number;
-	declarationLine: number;
-	hasExisting: boolean;
-	existingJSDoc?: string;
-	indent: string;
-} | null;
-/**
-* Apply a batch of edits to source files
-*/
-declare function applyEdits(edits: JSDocEdit[]): Promise<ApplyEditsResult>;
-/**
-* Create a TypeScript source file from a file path
-*/
-declare function createSourceFile(filePath: string): TS.SourceFile;
-/**
-* Quality rule severity levels.
-*/
-type QualitySeverity = "error" | "warn" | "off";
-/**
-* Context passed to quality rule checks.
-*/
-interface RuleContext {
-	export: SpecExport2;
-	rawJSDoc?: string;
-	/**
-	* Registry of all exported names/IDs for spec-level rules.
-	* Used by rules like no-forgotten-to check if referenced types are exported.
-	*/
-	exportRegistry?: Set<string>;
-}
-/**
-* A violation reported by a quality rule.
-*/
-interface QualityViolation {
-	ruleId: string;
-	severity: "error" | "warn";
-	message: string;
-	line?: number;
-	fixable: boolean;
-}
-/**
-* A quality rule checks one aspect of documentation quality.
-* Rules can contribute to coverage score, lint violations, or both.
-*/
-interface QualityRule {
-	/** Unique rule identifier */
-	id: string;
-	/** Human-readable name */
-	name: string;
-	/** What this rule checks */
-	description: string;
-	/**
-	* Which kinds this rule applies to.
-	* If undefined, applies to all kinds.
-	*/
-	appliesTo?: SpecExportKind[];
-	/**
-	* Does this rule contribute to coverage score?
-	* If true, the rule is counted as a "signal" for coverage calculation.
-	*/
-	affectsCoverage: boolean;
-	/**
-	* Default lint severity. Set to 'off' if rule is coverage-only.
-	*/
-	defaultSeverity: QualitySeverity;
-	/**
-	* Check if the satisfies this rule.
-	* Returns true if satisfied, false if not.
-	*/
-	check(ctx: RuleContext): boolean;
-	/**
-	* Get detailed violation info when check returns false.
-	* Only called if check() returns false and severity !== 'off'.
-	*/
-	getViolation?(ctx: RuleContext): QualityViolation;
-	/**
-	* Generate a fix for the violation.
-	* Only called if check() returns false and fix is requested.
-	*/
-	fix?(ctx: RuleContext): JSDocPatch | null;
-}
-/**
-* User configuration for quality rules.
-*/
-interface QualityConfig {
-	rules: Record<string, QualitySeverity>;
-}
-/**
-* Result of evaluating quality for a single export.
-*/
-interface QualityResult {
-	/** Coverage score (0-100) */
-	coverageScore: number;
-	/** Coverage details */
-	coverage: {
-		/** Rule IDs that passed */
-		satisfied: string[];
-		/** Rule IDs that failed */
-		missing: string[];
-		/** All applicable rule IDs */
-		applicable: string[];
-	};
-	/** Lint violations (only for rules with severity !== 'off') */
-	violations: QualityViolation[];
-	/** Summary counts */
-	summary: {
-		errorCount: number;
-		warningCount: number;
-		fixableCount: number;
-	};
-}
-/**
-* Aggregate result for multiple exports.
-*/
-interface AggregateQualityResult {
-	byExport: Map<string, QualityResult>;
-	overall: {
-		coverageScore: number;
-		totalViolations: number;
-		errorCount: number;
-		warningCount: number;
-	};
-}
+import { OpenPkg as OpenPkg3, SpecDocDrift as SpecDocDrift2, SpecDocsMetadata, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
 /**
 * An enriched with computed documentation metadata.
 * Extends SpecExport with the `docs` field for coverage analysis.
 */
-type EnrichedExport = SpecExport3 & {
+type EnrichedExport = SpecExport2 & {
 	docs?: EnrichedDocsMetadata;
 };
 /**
-* Extended docs metadata with quality violations.
+* Extended docs metadata.
 */
-type EnrichedDocsMetadata = SpecDocsMetadata & {
-	violations?: QualityViolation[];
-};
+type EnrichedDocsMetadata = SpecDocsMetadata;
 /**
 * An enriched OpenPkg spec with computed documentation metadata.
 * Extends OpenPkg with per-and aggregate coverage data.
@@ -650,21 +523,11 @@ interface EnrichOptions {
 	* Map from ID to drift issues.
 	*/
 	driftByExport?: Map<string, SpecDocDrift2[]>;
-	/**
-	* Quality configuration with rule severities.
-	*/
-	qualityConfig?: QualityConfig;
-	/**
-	* Per-raw JSDoc text for style rule checks.
-	* Map from ID to raw JSDoc string.
-	*/
-	rawJSDocByExport?: Map<string, string>;
 }
 /**
 * Enrich an OpenPkg spec with documentation coverage metadata.
 *
-* This function computes coverage scores using quality rules,
-* detects drift issues, and produces an EnrichedOpenPkg.
+* Computes coverage scores and detects drift issues.
 *
 * @param spec - The pure OpenPkg spec to enrich
 * @param options - Optional enrichment configuration
@@ -677,10 +540,8 @@ interface EnrichOptions {
 * const doccov = new DocCov();
 * const { spec } = await doccov.analyzeFileWithDiagnostics('src/index.ts');
 *
-* // Enrich with coverage data
 * const enriched = enrichSpec(spec);
 * console.log(enriched.docs?.coverageScore); // e.g., 85
-* console.log(enriched.docs?.missing); // e.g., ['has-examples']
 * ```
 */
 declare function enrichSpec(spec: OpenPkg3, options?: EnrichOptions): EnrichedOpenPkg;
@@ -1178,350 +1039,89 @@ interface SpecCache {
 	/** Hash validation data */
 	hashes: {
 		/** Hash of tsconfig.json content (null if not found) */
-		tsconfig: string | null;
-		/** Hash of package.json content */
-		packageJson: string;
-		/** Source file hashes: relative filepath → content hash */
-		sourceFiles: Record<string, string>;
-	};
-	/** Analysis configuration that affects output */
-	config: SpecCacheConfig;
-	/** The cached OpenPkg spec */
-	spec: OpenPkg6;
-}
-/**
-* Result of cache validation.
-*/
-interface CacheValidationResult {
-	/** Whether the cache is valid */
-	valid: boolean;
-	/** Reason for invalidation (if invalid) */
-	reason?: "cache-version-mismatch" | "entry-file-changed" | "config-changed" | "tsconfig-changed" | "package-json-changed" | "source-files-changed";
-	/** Files that changed (if reason is source-files-changed) */
-	changedFiles?: string[];
-}
-/**
-* Context needed for cache operations.
-*/
-interface CacheContext {
-	/** Entry file being analyzed (absolute path) */
-	entryFile: string;
-	/** Source files included in analysis (absolute paths) */
-	sourceFiles: string[];
-	/** Path to tsconfig.json (absolute, or null if not found) */
-	tsconfigPath: string | null;
-	/** Path to package.json (absolute) */
-	packageJsonPath: string;
-	/** Configuration that affects output */
-	config: SpecCacheConfig;
-	/** Working directory */
-	cwd: string;
-}
-/**
-* Load cached spec from disk.
-*
-* @param cwd - Working directory
-* @returns Cached spec, or null if not found or invalid JSON
-*/
-declare function loadSpecCache(cwd: string): SpecCache | null;
-/**
-* Save spec to cache.
-*
-* @param spec - OpenPkg spec to cache
-* @param context - Cache context with file paths and config
-*/
-declare function saveSpecCache(spec: OpenPkg6, context: CacheContext): void;
-/**
-* Validate if cached spec is still valid.
-*
-* Checks:
-* 1. Cache version matches
-* 2. Entry file matches
-* 3. Config matches
-* 4. tsconfig.json hash matches
-* 5. package.json hash matches
-* 6. All source file hashes match
-*
-* @param cache - Cached spec to validate
-* @param context - Current cache context
-* @returns Validation result
-*/
-declare function validateSpecCache(cache: SpecCache, context: CacheContext): CacheValidationResult;
-/**
-* Clear the spec cache.
-*
-* @param cwd - Working directory
-* @returns True if cache was deleted, false if it didn't exist
-*/
-declare function clearSpecCache(cwd: string): boolean;
-/**
-* Get cache file path for a given working directory.
-*
-* @param cwd - Working directory
-* @returns Absolute path to cache file
-*/
-declare function getSpecCachePath(cwd: string): string;
-/**
-* A single CODEOWNERS rule.
-*/
-interface CodeOwnerRule {
-	/** Line number in the CODEOWNERS file (1-indexed) */
-	line: number;
-	/** The glob pattern for matching files */
-	pattern: string;
-	/** List of owners (e.g., @user, @org/team, email) */
-	owners: string[];
-}
-/**
-* Parsed CODEOWNERS file.
-*/
-interface CodeOwnersFile {
-	/** Path to the CODEOWNERS file */
-	filePath: string;
-	/** All parsed rules (in order, later rules take precedence) */
-	rules: CodeOwnerRule[];
-}
-/**
-* Coverage stats for a single owner.
-*/
-interface OwnerCoverageStats {
-	/** The owner identifier */
-	owner: string;
-	/** Total exports owned */
-	totalExports: number;
-	/** Documented exports (has description) */
-	documentedExports: number;
-	/** Coverage percentage */
-	coverageScore: number;
-	/** Exports with drift issues */
-	exportsWithDrift: number;
-	/** Drift percentage */
-	driftScore: number;
-	/** Exports missing @example */
-	missingExamples: number;
-	/** List of undocumented names */
-	undocumentedExports: string[];
-}
-/**
-* Result of ownership analysis.
-*/
-interface OwnershipAnalysisResult {
-	/** Path to the CODEOWNERS file used */
-	codeownersPath: string;
-	/** Stats per owner */
-	byOwner: Map<string, OwnerCoverageStats>;
-	/** Exports with no matching owner */
-	unowned: EnrichedExport[];
-	/** Total exports analyzed */
-	totalExports: number;
-}
-/**
-* Parse a CODEOWNERS file content into rules.
-*/
-declare function parseCodeOwners(content: string): CodeOwnerRule[];
-/**
-* Find and load CODEOWNERS file from a directory.
-*/
-declare function loadCodeOwners(baseDir: string): CodeOwnersFile | null;
-/**
-* Find owners for a file path based on CODEOWNERS rules.
-* Returns the owners from the last matching rule (CODEOWNERS precedence).
-*/
-declare function findOwners(filePath: string, rules: CodeOwnerRule[]): string[];
-/**
-* Attribute owners to exports based on their source file paths.
-*/
-declare function attributeOwners(exports: EnrichedExport[], rules: CodeOwnerRule[], baseDir: string): Map<EnrichedExport, string[]>;
-/**
-* Analyze ownership and coverage breakdown by owner.
-*/
-declare function analyzeOwnership(spec: EnrichedOpenPkg, codeowners: CodeOwnersFile, baseDir: string): OwnershipAnalysisResult;
-/**
-* Options for ownership analysis.
-*/
-interface AnalyzeOwnershipOptions {
-	/** Base directory for the project */
-	baseDir: string;
-}
-/**
-* Load CODEOWNERS and analyze ownership for a spec.
-* Returns null if no CODEOWNERS file is found.
-*/
-declare function analyzeSpecOwnership(spec: EnrichedOpenPkg, options: AnalyzeOwnershipOptions): OwnershipAnalysisResult | null;
-/**
-* Git blame info for a single line.
-*/
-interface BlameInfo {
-	/** Commit hash */
-	commit: string;
-	/** Author name */
-	author: string;
-	/** Author email */
-	email: string;
-	/** Line number (1-indexed) */
-	line: number;
-	/** Timestamp */
-	timestamp: number;
-}
-/**
-* Stats for a single contributor.
-*/
-interface ContributorStats {
-	/** Contributor name */
-	name: string;
-	/** Contributor email */
-	email: string;
-	/** Number of exports this contributor documented */
-	documentedExports: number;
-	/** Names of exports documented by this contributor */
-	exports: string[];
-	/** Number of JSDoc lines authored */
-	linesAuthored: number;
-	/** Most recent documentation contribution */
-	lastContribution: Date | null;
-}
-/**
-* Result of contributor analysis.
-*/
-interface ContributorAnalysisResult {
-	/** Stats per contributor */
-	byContributor: Map<string, ContributorStats>;
-	/** Total documented exports analyzed */
-	totalDocumented: number;
-	/** Exports that couldn't be attributed (no git history) */
-	unattributed: string[];
-}
-/**
-* Get git blame for a file.
-*/
-declare function getFileBlame(filePath: string, cwd: string): BlameInfo[] | null;
-/**
-* Get blame info for specific line range.
-*/
-declare function getBlameForLines(filePath: string, startLine: number, endLine: number, cwd: string): BlameInfo[] | null;
-/**
-* Analyze contributors for documented exports.
-*/
-declare function analyzeContributors(spec: EnrichedOpenPkg, baseDir: string): ContributorAnalysisResult;
-/**
-* Options for contributor analysis.
-*/
-interface AnalyzeContributorsOptions {
-	/** Base directory for the project (must be a git repo) */
-	baseDir: string;
-}
-/**
-* Analyze spec contributors.
-* Returns null if not in a git repository.
-*/
-declare function analyzeSpecContributors(spec: EnrichedOpenPkg, options: AnalyzeContributorsOptions): ContributorAnalysisResult | null;
-/**
-* Configuration types for DocCov.
-* These types are shared between CLI and API.
-*/
-/**
-* Documentation configuration options.
-*/
-interface DocsConfig {
-	/** Glob patterns for markdown docs to include */
-	include?: string[];
-	/** Glob patterns for markdown docs to exclude */
-	exclude?: string[];
+		tsconfig: string | null;
+		/** Hash of package.json content */
+		packageJson: string;
+		/** Source file hashes: relative filepath → content hash */
+		sourceFiles: Record<string, string>;
+	};
+	/** Analysis configuration that affects output */
+	config: SpecCacheConfig;
+	/** The cached OpenPkg spec */
+	spec: OpenPkg6;
 }
 /**
-* Example validation modes.
+* Result of cache validation.
 */
-type ExampleValidationMode = "presence" | "typecheck" | "run";
+interface CacheValidationResult {
+	/** Whether the cache is valid */
+	valid: boolean;
+	/** Reason for invalidation (if invalid) */
+	reason?: "cache-version-mismatch" | "entry-file-changed" | "config-changed" | "tsconfig-changed" | "package-json-changed" | "source-files-changed";
+	/** Files that changed (if reason is source-files-changed) */
+	changedFiles?: string[];
+}
 /**
-* Check command configuration options.
+* Context needed for cache operations.
 */
-interface CheckConfig {
-	/**
-	* Example validation modes to run.
-	* Can be a single mode, array of modes, or comma-separated string.
-	* - 'presence': Check that @example blocks exist on exports
-	* - 'typecheck': Compile examples with TypeScript
-	* - 'run': Execute examples and validate assertions
-	*/
-	examples?: ExampleValidationMode | ExampleValidationMode[] | string;
-	/** Minimum coverage percentage required (0-100) */
-	minCoverage?: number;
-	/** Maximum drift percentage allowed (0-100) */
-	maxDrift?: number;
+interface CacheContext {
+	/** Entry file being analyzed (absolute path) */
+	entryFile: string;
+	/** Source files included in analysis (absolute paths) */
+	sourceFiles: string[];
+	/** Path to tsconfig.json (absolute, or null if not found) */
+	tsconfigPath: string | null;
+	/** Path to package.json (absolute) */
+	packageJsonPath: string;
+	/** Configuration that affects output */
+	config: SpecCacheConfig;
+	/** Working directory */
+	cwd: string;
 }
 /**
-* Quality rule severity level.
+* Load cached spec from disk.
+*
+* @param cwd - Working directory
+* @returns Cached spec, or null if not found or invalid JSON
 */
-type QualitySeverity2 = "error" | "warn" | "off";
+declare function loadSpecCache(cwd: string): SpecCache | null;
 /**
-* Quality rules configuration.
+* Save spec to cache.
+*
+* @param spec - OpenPkg spec to cache
+* @param context - Cache context with file paths and config
 */
-interface QualityRulesConfig {
-	/** Rule severity overrides */
-	rules?: Record<string, QualitySeverity2>;
-}
+declare function saveSpecCache(spec: OpenPkg6, context: CacheContext): void;
 /**
-* Per-path policy configuration.
-* Allows setting different coverage requirements for different parts of the codebase.
+* Validate if cached spec is still valid.
+*
+* Checks:
+* 1. Cache version matches
+* 2. Entry file matches
+* 3. Config matches
+* 4. tsconfig.json hash matches
+* 5. package.json hash matches
+* 6. All source file hashes match
+*
+* @param cache - Cached spec to validate
+* @param context - Current cache context
+* @returns Validation result
 */
-interface PolicyConfig {
-	/** Glob pattern to match file paths (e.g., "packages/public-api/**") */
-	path: string;
-	/** Minimum coverage percentage required for matched paths (0-100) */
-	minCoverage?: number;
-	/** Maximum drift percentage allowed for matched paths (0-100) */
-	maxDrift?: number;
-	/** Require @example blocks on all matched exports */
-	requireExamples?: boolean;
-}
+declare function validateSpecCache(cache: SpecCache, context: CacheContext): CacheValidationResult;
 /**
-* Normalized DocCov configuration.
-* This is the parsed/normalized form used by commands.
+* Clear the spec cache.
+*
+* @param cwd - Working directory
+* @returns True if cache was deleted, false if it didn't exist
 */
-interface DocCovConfig {
-	/** Export include patterns */
-	include?: string[];
-	/** Export exclude patterns */
-	exclude?: string[];
-	/** Plugins (future) */
-	plugins?: unknown[];
-	/** Documentation configuration */
-	docs?: DocsConfig;
-	/** Check command configuration */
-	check?: CheckConfig;
-	/** Quality rules configuration */
-	quality?: QualityRulesConfig;
-	/** Per-path coverage policies (Pro tier) */
-	policies?: PolicyConfig[];
-}
+declare function clearSpecCache(cwd: string): boolean;
 /**
-* Define a DocCov configuration.
-* Helper function for type-safe configuration in doccov.config.ts.
-*
-* @param config - Configuration object
-* @returns The configuration object (for type inference)
-*
-* @example
-* ```typescript
-* // doccov.config.ts
-* import { defineConfig } from '@doccov/sdk';
+* Get cache file path for a given working directory.
 *
-* defineConfig({
-*   include: ['MyClass', 'myFunction'],
-*   exclude: ['internal*'],
-*   docs: {
-*     include: ['docs/**\/*.md'],
-*   },
-*   quality: {
-*     rules: {
-*       'has-description': 'error',
-*       'has-examples': 'warn',
-*     },
-*   },
-* });
-* ```
+* @param cwd - Working directory
+* @returns Absolute path to cache file
 */
-declare function defineConfig(config: DocCovConfig): DocCovConfig;
+declare function getSpecCachePath(cwd: string): string;
 /**
 * Project detection types for I/O-agnostic project analysis.
 * Used by both CLI (NodeFileSystem) and API (SandboxFileSystem).
@@ -1811,7 +1411,7 @@ declare function parseExamplesFlag(value: boolean | string | undefined): Example
 * Check if a specific validation is enabled.
 */
 declare function shouldValidate(validations: ExampleValidation[], check: ExampleValidation): boolean;
-import { SpecExport as SpecExport4 } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport3 } from "@openpkg-ts/spec";
 interface ExampleTypeError {
 	/** Index of the example in the examples array */
 	exampleIndex: number;
@@ -1934,7 +1534,7 @@ interface ExampleValidationResult {
 * - `typecheck`: type-checks examples (doesn't require presence or run)
 * - `run`: executes examples (doesn't require presence or typecheck)
 */
-declare function validateExamples(exports: SpecExport4[], options: ExampleValidationOptions): Promise<ExampleValidationResult>;
+declare function validateExamples(exports: SpecExport3[], options: ExampleValidationOptions): Promise<ExampleValidationResult>;
 declare function extractPackageSpec(entryFile: string, packageDir?: string, content?: string, options?: DocCovOptions): Promise<OpenPkgSpec>;
 /**
 * Release stage/visibility tags that can be used for filtering.
@@ -2003,7 +1603,104 @@ declare function parseListFlag(value?: string | string[]): string[] | undefined;
 * ```
 */
 declare function mergeFilters(config: DocCovConfig | null, overrides: FilterOptions): ResolvedFilters;
-import { SpecDocDrift as SpecDocDrift4, SpecExport as SpecExport5 } from "@openpkg-ts/spec";
+import { SpecDocDrift as SpecDocDrift4, SpecExport as SpecExport4 } from "@openpkg-ts/spec";
+import * as TS3 from "typescript";
+/**
+* Represents a single parameter in a JSDoc patch
+*/
+interface JSDocParam {
+	name: string;
+	type?: string;
+	description?: string;
+	optional?: boolean;
+}
+/**
+* Represents a return type in a JSDoc patch
+*/
+interface JSDocReturn {
+	type?: string;
+	description?: string;
+}
+/**
+* Represents a generic tag in a JSDoc patch
+*/
+interface JSDocTag {
+	name: string;
+	text: string;
+}
+/**
+* A patchable representation of a JSDoc comment
+*/
+interface JSDocPatch {
+	description?: string;
+	params?: JSDocParam[];
+	returns?: JSDocReturn;
+	examples?: string[];
+	deprecated?: string | false;
+	async?: boolean;
+	type?: string;
+	typeParams?: Array<{
+		name: string;
+		constraint?: string;
+		description?: string;
+	}>;
+	otherTags?: JSDocTag[];
+}
+/**
+* Represents an edit to be applied to a source file
+*/
+interface JSDocEdit {
+	filePath: string;
+	symbolName: string;
+	startLine: number;
+	endLine: number;
+	hasExisting: boolean;
+	existingJSDoc?: string;
+	newJSDoc: string;
+	indent: string;
+}
+/**
+* Result of applying edits to source files
+*/
+interface ApplyEditsResult {
+	filesModified: number;
+	editsApplied: number;
+	errors: Array<{
+		file: string;
+		error: string;
+	}>;
+}
+/**
+* Parse a JSDoc comment string into a patchable structure
+*/
+declare function parseJSDocToPatch(jsDocText: string): JSDocPatch;
+/**
+* Apply a partial patch to an existing JSDoc patch, preserving unmodified content
+*/
+declare function applyPatchToJSDoc(existing: JSDocPatch, updates: Partial<JSDocPatch>): JSDocPatch;
+/**
+* Serialize a JSDocPatch back to a formatted comment string
+*/
+declare function serializeJSDoc(patch: JSDocPatch, indent?: string): string;
+/**
+* Find the JSDoc location for a declaration in a source file
+*/
+declare function findJSDocLocation(sourceFile: TS3.SourceFile, symbolName: string, approximateLine?: number): {
+	startLine: number;
+	endLine: number;
+	declarationLine: number;
+	hasExisting: boolean;
+	existingJSDoc?: string;
+	indent: string;
+} | null;
+/**
+* Apply a batch of edits to source files
+*/
+declare function applyEdits(edits: JSDocEdit[]): Promise<ApplyEditsResult>;
+/**
+* Create a TypeScript source file from a file path
+*/
+declare function createSourceFile(filePath: string): TS3.SourceFile;
 /**
 * Types of fixes that can be generated
 */
@@ -2025,11 +1722,11 @@ declare function isFixableDrift(drift: SpecDocDrift4): boolean;
 /**
 * Generate a fix for a single drift issue
 */
-declare function generateFix(drift: SpecDocDrift4, exportEntry: SpecExport5, existingPatch?: JSDocPatch): FixSuggestion | null;
+declare function generateFix(drift: SpecDocDrift4, exportEntry: SpecExport4, existingPatch?: JSDocPatch): FixSuggestion | null;
 /**
 * Generate all fixes for an export's drift issues
 */
-declare function generateFixesForExport(exportEntry: SpecExport5, existingPatch?: JSDocPatch): FixSuggestion[];
+declare function generateFixesForExport(exportEntry: SpecExport4, existingPatch?: JSDocPatch): FixSuggestion[];
 /**
 * Merge multiple fix patches into a single patch
 */
@@ -2613,127 +2310,6 @@ declare class DocCov {
 declare function analyze(code: string, options?: AnalyzeOptions): Promise<OpenPkgSpec>;
 declare function analyzeFile(filePath: string, options?: AnalyzeOptions): Promise<OpenPkgSpec>;
 /**
-* Result of evaluating a single policy.
-*/
-interface PolicyResult {
-	/** The policy that was evaluated */
-	policy: PolicyConfig;
-	/** Exports that matched this policy's path pattern */
-	matchedExports: EnrichedExport[];
-	/** Coverage score for matched exports (0-100) */
-	coverageScore: number;
-	/** Drift score for matched exports (0-100, percentage of exports with drift) */
-	driftScore: number;
-	/** Number of matched exports missing @example */
-	missingExamples: number;
-	/** Whether the policy passed all configured thresholds */
-	passed: boolean;
-	/** Specific failures for this policy */
-	failures: PolicyFailure[];
-}
-/**
-* A specific policy failure.
-*/
-interface PolicyFailure {
-	type: "coverage" | "drift" | "examples";
-	message: string;
-	actual: number;
-	threshold: number;
-}
-/**
-* Result of evaluating all policies.
-*/
-interface PolicyEvaluationResult {
-	/** Results for each policy */
-	results: PolicyResult[];
-	/** Whether all policies passed */
-	allPassed: boolean;
-	/** Total number of policies */
-	totalPolicies: number;
-	/** Number of policies that passed */
-	passedCount: number;
-	/** Number of policies that failed */
-	failedCount: number;
-}
-/**
-* Evaluate a single policy against a set of exports.
-*/
-declare function evaluatePolicy(policy: PolicyConfig, allExports: EnrichedExport[], baseDir?: string): PolicyResult;
-/**
-* Options for evaluating policies.
-*/
-interface EvaluatePoliciesOptions {
-	/** Base directory for resolving relative paths in policies */
-	baseDir?: string;
-}
-/**
-* Evaluate all policies against a spec's exports.
-*/
-declare function evaluatePolicies(policies: PolicyConfig[], spec: EnrichedOpenPkg, options?: EvaluatePoliciesOptions): PolicyEvaluationResult;
-import { SpecExport as SpecExport6 } from "@openpkg-ts/spec";
-import { SpecExportKind as SpecExportKind2 } from "@openpkg-ts/spec";
-/**
-* Core quality rules - these affect coverage score.
-*/
-declare const CORE_RULES: QualityRule[];
-/**
-* TSDoc Strictness rules - match API Extractor's TSDoc compliance.
-* These help maintain consistent, high-quality documentation.
-*/
-declare const TSDOC_RULES: QualityRule[];
-/**
-* Style rules - these don't affect coverage, only lint.
-*/
-declare const STYLE_RULES: QualityRule[];
-/**
-* All built-in quality rules.
-*/
-declare const BUILTIN_RULES: QualityRule[];
-/**
-* Get rules that affect coverage calculation.
-*/
-declare function getCoverageRules(): QualityRule[];
-/**
-* Get rules applicable to a specific kind.
-*/
-declare function getRulesForKind(kind: SpecExportKind2): QualityRule[];
-/**
-* Get a rule by ID.
-*/
-declare function getRule(id: string): QualityRule | undefined;
-/**
-* Get default configuration with all rule defaults.
-*/
-declare function getDefaultConfig(): Record<string, QualitySeverity>;
-/**
-* Evaluate quality for a single export.
-*
-* @param exp - The to evaluate
-* @param rawJSDoc - Optional raw JSDoc text for regex-based checks
-* @param config - Quality configuration with rule severities
-* @param exportRegistry - Optional registry of all exported names for spec-level rules
-* @returns Quality result with coverage score and violations
-*/
-declare function evaluateExportQuality(exp: SpecExport6, rawJSDoc?: string, config?: QualityConfig, exportRegistry?: Set<string>): QualityResult;
-/**
-* Evaluate quality for multiple exports.
-*
-* @param exports - Array of exports with optional raw JSDoc
-* @param config - Quality configuration with rule severities
-* @returns Aggregate result with per-and overall scores
-*/
-declare function evaluateQuality(exports: Array<{
-	export: SpecExport6;
-	rawJSDoc?: string;
-}>, config?: QualityConfig): AggregateQualityResult;
-/**
-* Merge user configuration with defaults.
-*
-* @param userConfig - Partial user configuration
-* @returns Complete configuration with defaults filled in
-*/
-declare function mergeConfig(userConfig: Partial<QualityConfig>): QualityConfig;
-/**
 * Options for resolving a target package/entry point.
 */
 interface ResolveTargetOptions {
@@ -3035,4 +2611,4 @@ declare function typecheckExample(example: string, packagePath: string, options?
 * Type-check multiple examples
 */
 declare function typecheckExamples(examples: string[], packagePath: string, options?: TypecheckOptions): TypecheckResult;
-export { validateSpecCache, validateExamples, typecheckExamples, typecheckExample, tryExtractStandardSchema, shouldValidate, serializeJSDoc, saveSpecCache, saveSnapshot, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, renderSparkline, renderApiSurface, readPackageJson, pruneHistory, pruneByTier, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseCodeOwners, parseAssertions, mergeFixes, mergeFilters, mergeConfig, loadSpecCache, loadSnapshotsForDays, loadSnapshots, loadCodeOwners, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isFixableDrift, isExecutableLang, isCachedReportValid, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupDriftsByCategory, getUndocumentedExports, getTrend, getSpecCachePath, getRunCommand, getRulesForKind, getRule, getReportPath, getPrimaryBuildScript, getInstallCommand, getFileBlame, getExtendedTrend, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, getDefaultConfig, getCoverageRules, getBlameForLines, generateWeeklySummaries, generateReportFromEnriched, generateReport, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findRemovedReferences, findPackageByName, findOwners, findJSDocLocation, findExportReferences, findDeprecatedReferences, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractViaStandardSchema, extractSpecSummary, extractPackageSpec, extractImports, extractFunctionCalls, evaluateQuality, evaluatePolicy, evaluatePolicies, evaluateExportQuality, ensureSpecCoverage, enrichSpec, diffSpecWithDocs, diffHashes, detectRuntimeSchemas, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeSnapshot, computeExportDrift, computeDrift, clearSpecCache, clearSchemaCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDisplayUrl, buildCloneUrl, blockReferencesExport, attributeOwners, applyPatchToJSDoc, applyEdits, analyzeSpecOwnership, analyzeSpecContributors, analyzeProject2 as analyzeProject, analyzeOwnership, analyzeFile, analyzeDocsImpact, analyzeContributors, analyze, WorkspacePackage, WorkspaceConfig, WeeklySummary, VALIDATION_INFO, TypecheckValidationResult, TypecheckResult, TypecheckOptions, TSDOC_RULES, SummaryDriftIssue, StandardSchemaResult, StandardSchemaOutputOptions, StandardJSONSchemaV1, SpecSummary, SpecDiffWithDocs, SpecCacheConfig, SpecCache, SchemaDetectionResult, SchemaDetectionContext, SandboxFileSystem, STYLE_RULES, SPEC_CACHE_FILE, RuntimeDrift, RunValidationResult, RunExamplesWithPackageResult, RunExamplesWithPackageOptions, RunExampleOptions, RuleContext, RetentionTier, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, ReleaseTag, RETENTION_DAYS, REPORT_VERSION, REPORT_EXTENSIONS, QualityViolation, QualitySeverity2 as QualitySeverity, QualityRulesConfig, QualityRule, QualityResult, QualityConfig, ProjectInfo, PresenceResult, PolicyResult, PolicyFailure, PolicyEvaluationResult, PolicyConfig, ParsedGitHubUrl, PackageManagerInfo, PackageManager, PackageJson, PackageExports, OwnershipAnalysisResult, OwnerCoverageStats, OpenPkgSpec, NodeFileSystem, MonorepoType, MonorepoInfo, MemberChange, MarkdownDocFile, MarkdownCodeBlock, LLMAssertion, KnownVendor, KNOWN_VENDORS, JSDocTag, JSDocReturn, JSDocPatch, JSDocParam, JSDocEdit, InstallResult, InstallOptions, HISTORY_DIR, GitHubRepoMetadata, GitHubProjectContext, FixType, FixSuggestion, FilterSource, FilterOptions, FileSystem, FetchGitHubContextOptions, ExtendedTrendAnalysis, ExportReference, ExportDriftResult, ExportCoverageData, ExampleValidationTypeError, ExampleValidationResult, ExampleValidationOptions, ExampleValidationMode, ExampleValidation, ExampleTypeError, ExampleRunResult, EvaluatePoliciesOptions, 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, ContributorStats, ContributorAnalysisResult, CommandRunner, CommandResult, CodeOwnersFile, CodeOwnerRule, CheckConfig, CategorizedDrift, CacheValidationResult, CacheContext, CORE_RULES, CACHE_VERSION, BuildPlanTarget, BuildPlanStepResult, BuildPlanStep, BuildPlanExecutionResult, BuildPlanEnvironment, BuildPlan, BuildInfo, BuildHints, BlameInfo, BUILTIN_RULES, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOwnershipOptions, AnalyzeOptions, AnalyzeContributorsOptions, AnalysisResult, AggregateQualityResult, 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, loadSnapshotsForDays, loadSnapshots, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isSchemaType, isFixableDrift, isExecutableLang, isCachedReportValid, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, generateWeeklySummaries, 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, clearSchemaCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyEdits, analyzeProject2 as analyzeProject, analyzeFile, analyzeDocsImpact, analyze, WorkspacePackage, WorkspaceConfig, WeeklySummary, 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, 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, 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 };