@doccov/sdk 0.12.0 → 0.15.0

package/dist/index.d.ts

@@ -45,8 +45,8 @@ declare function runExamples(examples: string[], options?: RunExampleOptions): P
 * runs all examples, then cleans up.
 */
 declare function runExamplesWithPackage(examples: string[], options: RunExamplesWithPackageOptions): Promise<RunExamplesWithPackageResult>;
-import { OpenPkg } from "@openpkg-ts/spec";
-type OpenPkgSpec = OpenPkg;
+import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
+type OpenPkgSpec = OpenPkg2;
 /**
 * Result of computing drift for a single export.
 */
@@ -225,7 +225,7 @@ declare function ensureSpecCoverage(spec: OpenPkgSpec): OpenPkgSpec & {
 		coverageScore: number;
 	};
 };
-import { OpenPkg as OpenPkg2, SpecDocDrift as SpecDocDrift2, SpecDocsMetadata, SpecExport as SpecExport3 } from "@openpkg-ts/spec";
+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";
 /**
@@ -445,7 +445,7 @@ type EnrichedDocsMetadata = SpecDocsMetadata & {
 * An enriched OpenPkg spec with computed documentation metadata.
 * Extends OpenPkg with per-and aggregate coverage data.
 */
-type EnrichedOpenPkg = Omit<OpenPkg2, "exports"> & {
+type EnrichedOpenPkg = Omit<OpenPkg3, "exports"> & {
 	exports: EnrichedExport[];
 	docs?: EnrichedDocsMetadata;
 	/** Drift summary with category breakdown (if drift exists) */
@@ -490,8 +490,8 @@ interface EnrichOptions {
 * console.log(enriched.docs?.missing); // e.g., ['has-examples']
 * ```
 */
-declare function enrichSpec(spec: OpenPkg2, options?: EnrichOptions): EnrichedOpenPkg;
-import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
+declare function enrichSpec(spec: OpenPkg3, options?: EnrichOptions): EnrichedOpenPkg;
+import { OpenPkg as OpenPkg4 } from "@openpkg-ts/spec";
 import { DriftCategory as DriftCategory2, SpecDocDrift as SpecDocDrift3 } from "@openpkg-ts/spec";
 /**
 * DocCov report schema version.
@@ -686,7 +686,7 @@ interface DocCovReport {
 * console.log(`Coverage: ${report.coverage.score}%`);
 * ```
 */
-declare function generateReport(spec: OpenPkg3): DocCovReport;
+declare function generateReport(spec: OpenPkg4): DocCovReport;
 /**
 * Generate a DocCov report from an already-enriched spec.
 *
@@ -755,7 +755,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 OpenPkg4 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg5 } from "@openpkg-ts/spec";
 /** Current cache format version */
 declare const CACHE_VERSION = "1.0.0";
 /** Default cache file path */
@@ -790,7 +790,7 @@ interface SpecCache {
 	/** Analysis configuration that affects output */
 	config: SpecCacheConfig;
 	/** The cached OpenPkg spec */
-	spec: OpenPkg4;
+	spec: OpenPkg5;
 }
 /**
 * Result of cache validation.
@@ -833,7 +833,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: OpenPkg4, context: CacheContext): void;
+declare function saveSpecCache(spec: OpenPkg5, context: CacheContext): void;
 /**
 * Validate if cached spec is still valid.
 *
@@ -1378,9 +1378,7 @@ interface DocCovOptions {
 	/** Working directory for cache operations (default: process.cwd()) */
 	cwd?: string;
 }
-/** @deprecated Use DocCovOptions instead */
-type OpenPkgOptions = DocCovOptions;
-declare function extractPackageSpec(entryFile: string, packageDir?: string, content?: string, options?: OpenPkgOptions): Promise<OpenPkgSpec>;
+declare function extractPackageSpec(entryFile: string, packageDir?: string, content?: string, options?: DocCovOptions): Promise<OpenPkgSpec>;
 interface FilterOptions {
 	include?: string[];
 	exclude?: string[];
@@ -1477,7 +1475,7 @@ declare function categorizeDrifts(drifts: SpecDocDrift4[]): {
 	fixable: SpecDocDrift4[];
 	nonFixable: SpecDocDrift4[];
 };
-import { OpenPkg as OpenPkg5 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg6 } from "@openpkg-ts/spec";
 /**
 * Parsed components of a GitHub URL.
 */
@@ -1570,7 +1568,7 @@ declare function buildRawUrl(parsed: ParsedGitHubUrl, filePath: string): string;
 * }
 * ```
 */
-declare function fetchSpecFromGitHub(parsed: ParsedGitHubUrl): Promise<OpenPkg5 | null>;
+declare function fetchSpecFromGitHub(parsed: ParsedGitHubUrl): Promise<OpenPkg6 | null>;
 /**
 * Fetch an OpenPkg spec from a GitHub repository by owner/repo/branch.
 *
@@ -1581,84 +1579,22 @@ declare function fetchSpecFromGitHub(parsed: ParsedGitHubUrl): Promise<OpenPkg5
 * @param branch - Branch name (default: 'main')
 * @returns The OpenPkg spec, or null if not found
 */
-declare function fetchSpec(owner: string, repo: string, branch?: string): Promise<OpenPkg5 | null>;
-/**
-* Scan types for CLI, API, and SDK consumers.
-* Single source of truth for scan-related interfaces.
-*/
-/**
-* Result of scanning a repository for documentation coverage.
-* Used by CLI scan command, API endpoints, and SDK consumers.
-*/
-interface ScanResult {
-	/** GitHub repository owner */
-	owner: string;
-	/** GitHub repository name */
-	repo: string;
-	/** Git ref (branch/tag) that was scanned */
-	ref: string;
-	/** Package name if scanning a monorepo package */
-	packageName?: string;
-	/** Overall documentation coverage percentage (0-100) */
-	coverage: number;
-	/** Number of public exports analyzed */
-	exportCount: number;
-	/** Number of types analyzed */
-	typeCount: number;
-	/** Number of documentation drift issues found */
-	driftCount: number;
-	/** Names of exports missing documentation */
-	undocumented: string[];
-	/** Drift issues found during analysis */
-	drift: DriftIssue[];
-}
-/**
-* A documentation drift issue.
-*/
-interface DriftIssue {
-	/** Name of the with drift */
-	export: string;
-	/** Type of drift (e.g., 'param-mismatch', 'return-type') */
-	type: string;
-	/** Human-readable description of the issue */
-	issue: string;
-	/** Optional suggestion for fixing the issue */
-	suggestion?: string;
-}
+declare function fetchSpec(owner: string, repo: string, branch?: string): Promise<OpenPkg6 | null>;
 /**
-* Options for running a scan.
+* Progress event for installation status updates.
 */
-interface ScanOptions {
-	/** GitHub URL or owner/repo shorthand */
-	url: string;
-	/** Git ref (branch/tag) to scan */
-	ref?: string;
-	/** Target package name for monorepos */
-	package?: string;
-	/** Skip dependency installation */
-	skipInstall?: boolean;
-	/** Skip external type resolution */
-	skipResolve?: boolean;
-}
-/**
-* Stages of the scan pipeline.
-*/
-type ProgressStage = "cloning" | "detecting" | "installing" | "building" | "analyzing" | "complete";
-/**
-* Progress event emitted during scan operations.
-*/
-interface ProgressEvent {
-	/** Current stage of the scan */
-	stage: ProgressStage;
+interface InstallProgressEvent {
+	/** Current stage */
+	stage: "installing";
 	/** Human-readable message */
 	message: string;
 	/** Progress percentage (0-100), if known */
 	progress?: number;
 }
 /**
-* Callback for receiving progress events.
+* Callback for receiving installation progress events.
 */
-type ProgressCallback = (event: ProgressEvent) => void;
+type InstallProgressCallback = (event: InstallProgressEvent) => void;
 /**
 * Result of running a command.
 */
@@ -1702,7 +1638,7 @@ interface InstallOptions {
 	/** Order of fallback package managers to try */
 	fallbackOrder?: PackageManager[];
 	/** Progress callback for status updates */
-	onProgress?: ProgressCallback;
+	onProgress?: InstallProgressCallback;
 }
 /**
 * Install dependencies for a project.
@@ -1902,7 +1838,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 OpenPkg8, SpecDiff as SpecDiff2 } from "@openpkg-ts/spec";
 /**
 * Extended spec diff result with docs impact
 */
@@ -1948,7 +1884,7 @@ interface DiffWithDocsOptions {
 * }
 * ```
 */
-declare function diffSpecWithDocs(oldSpec: OpenPkg7, newSpec: OpenPkg7, options?: DiffWithDocsOptions): SpecDiffWithDocs;
+declare function diffSpecWithDocs(oldSpec: OpenPkg8, newSpec: OpenPkg8, options?: DiffWithDocsOptions): SpecDiffWithDocs;
 /**
 * Check if a diff has any docs impact
 */
@@ -2004,7 +1940,29 @@ declare function findExportReferences(files: MarkdownDocFile[], exportNames: str
 * Check if a code block references any of the given names
 */
 declare function blockReferencesExport(block: MarkdownCodeBlock, exportName: string): boolean;
-interface Diagnostic {
+import { EntryPointDetectionMethod } from "@openpkg-ts/spec";
+/**
+* Input for generation metadata that comes from the caller (CLI, API, etc.)
+*/
+interface GenerationInput {
+	/** Entry point file path (relative to package root) */
+	entryPoint: string;
+	/** How the entry point was detected */
+	entryPointSource: EntryPointDetectionMethod;
+	/** Whether this is a declaration-only analysis (.d.ts file) */
+	isDeclarationOnly?: boolean;
+	/** Generator tool name */
+	generatorName: string;
+	/** Generator tool version */
+	generatorVersion: string;
+	/** Detected package manager */
+	packageManager?: string;
+	/** Whether this is a monorepo */
+	isMonorepo?: boolean;
+	/** Target package name (for monorepos) */
+	targetPackage?: string;
+}
+interface Diagnostic2 {
 	message: string;
 	severity: "error" | "warning" | "info";
 	suggestion?: string;
@@ -2016,7 +1974,7 @@ interface Diagnostic {
 }
 interface AnalysisResult {
 	spec: OpenPkgSpec;
-	diagnostics: Diagnostic[];
+	diagnostics: Diagnostic2[];
 	metadata: AnalysisMetadata;
 	/** True if result came from cache (no fresh analysis) */
 	fromCache?: boolean;
@@ -2034,6 +1992,8 @@ interface AnalysisMetadata {
 }
 interface AnalyzeOptions {
 	filters?: FilterOptions;
+	/** Generation metadata input (entry point info, tool version, etc.) */
+	generationInput?: GenerationInput;
 }
 declare class DocCov {
 	private readonly options;
@@ -2067,8 +2027,6 @@ declare class DocCov {
 }
 declare function analyze(code: string, options?: AnalyzeOptions): Promise<OpenPkgSpec>;
 declare function analyzeFile(filePath: string, options?: AnalyzeOptions): Promise<OpenPkgSpec>;
-/** @deprecated Use DocCov instead */
-declare const OpenPkg8: typeof DocCov;
 import { SpecExport as SpecExport6 } from "@openpkg-ts/spec";
 import { SpecExportKind as SpecExportKind2 } from "@openpkg-ts/spec";
 /**
@@ -2179,127 +2137,18 @@ interface ResolvedTarget {
 * ```
 */
 declare function resolveTarget(fs: FileSystem, options: ResolveTargetOptions): Promise<ResolvedTarget>;
-import { OpenPkg as OpenPkg9 } from "@openpkg-ts/spec";
-/**
-* Options for creating a ScanOrchestrator.
-*/
-interface ScanOrchestratorOptions {
-	/** Progress callback for status updates */
-	onProgress?: ProgressCallback;
-	/** Command runner for executing shell commands */
-	commandRunner?: CommandRunner;
-	/** Skip external type resolution */
-	skipResolve?: boolean;
-}
-/**
-* Context for the current scan operation.
-*/
-interface ScanContext {
-	/** Parsed GitHub URL info */
-	parsed: ParsedGitHubUrl;
-	/** Target package name for monorepos */
-	packageName?: string;
-	/** Working directory for the scan */
-	workDir: string;
-	/** Entry point file path */
-	entryFile?: string;
-}
 /**
-* Orchestrates the scan workflow.
-*
-* The orchestrator coordinates:
-* 1. Repository cloning (for remote URLs)
-* 2. Monorepo detection and package resolution
-* 3. Entry point detection
-* 4. Dependency installation
-* 5. Build execution (if needed)
-* 6. Documentation analysis
-* 7. Summary extraction
-*
-* It's designed to be FileSystem-agnostic so it works with both:
-* - NodeFileSystem (CLI - local execution)
-* - SandboxFileSystem (API - isolated execution)
-*
-* @example
-* ```typescript
-* import { ScanOrchestrator, NodeFileSystem, createNodeCommandRunner } from '@doccov/sdk';
-*
-* const fs = new NodeFileSystem('/path/to/repo');
-* const orchestrator = new ScanOrchestrator(fs, {
-*   commandRunner: createNodeCommandRunner(),
-*   onProgress: (event) => console.log(event.message),
-* });
-*
-* const result = await orchestrator.scan({
-*   url: 'https://github.com/owner/repo',
-*   ref: 'main',
-* });
-*
-* console.log(`Coverage: ${result.coverage}%`);
-* ```
+* A documentation drift issue in a spec summary.
 */
-declare class ScanOrchestrator {
-	private readonly fs;
-	private readonly options;
-	constructor(fs: FileSystem, options?: ScanOrchestratorOptions);
-	/**
-	* Emit a progress event.
-	*/
-	private emit;
-	/**
-	* Detect monorepo and resolve target package.
-	*
-	* @param packageName - Target package name (required for monorepos)
-	* @returns Target directory path (relative to workDir)
-	* @throws Error if monorepo requires --package flag
-	*/
-	detectPackage(packageName?: string): Promise<{
-		targetPath: string;
-		resolvedPackage?: string;
-	}>;
-	/**
-	* Detect entry point for the package.
-	*
-	* @param targetPath - Path to the package directory
-	* @returns Entry point file path (relative to workDir)
-	*/
-	detectEntry(targetPath: string): Promise<string>;
-	/**
-	* Install dependencies for the project.
-	*
-	* @param workDir - Working directory (absolute path)
-	* @returns Installation result
-	*/
-	install(workDir: string): Promise<InstallResult>;
-	/**
-	* Run build if needed.
-	*
-	* @param workDir - Working directory (absolute path)
-	* @param targetPath - Target package path (relative)
-	*/
-	build(workDir: string, targetPath: string): Promise<void>;
-	/**
-	* Run documentation analysis.
-	*
-	* @param entryFile - Path to entry file (absolute)
-	* @returns OpenPkg spec
-	*/
-	analyze(entryFile: string): Promise<OpenPkg9>;
-	/**
-	* Run a complete scan workflow.
-	*
-	* @param options - Scan options
-	* @returns Scan result with coverage statistics
-	*/
-	scan(options: ScanOptions): Promise<ScanResult>;
-}
-/**
-* Error thrown when a monorepo is detected but no package is specified.
-*/
-declare class MonorepoRequiresPackageError extends Error {
-	/** Available package names */
-	readonly availablePackages: string[];
-	constructor(availablePackages: string[]);
+interface SummaryDriftIssue {
+	/** Name of the with drift */
+	export: string;
+	/** Type of drift (e.g., 'param-mismatch', 'return-type') */
+	type: string;
+	/** Human-readable description of the issue */
+	issue: string;
+	/** Optional suggestion for fixing the issue */
+	suggestion?: string;
 }
 /**
 * Summary of a spec's documentation coverage.
@@ -2317,7 +2166,7 @@ interface SpecSummary {
 	/** Names of undocumented or partially documented exports */
 	undocumented: string[];
 	/** Drift issues */
-	drift: DriftIssue[];
+	drift: SummaryDriftIssue[];
 }
 /**
 * Extract a summary from an enriched OpenPkg spec.
@@ -2342,6 +2191,185 @@ interface SpecSummary {
 */
 declare function extractSpecSummary(spec: EnrichedOpenPkg): SpecSummary;
 /**
+* Build Plan types for AI-powered repository scanning.
+*/
+/**
+* Target repository information for a build plan.
+*/
+interface BuildPlanTarget {
+	/** Target type (currently only GitHub is supported) */
+	type: "github";
+	/** Full GitHub repository URL */
+	repoUrl: string;
+	/** Git ref (branch, tag, or commit) */
+	ref: string;
+	/** Root path within the repository (for monorepos) */
+	rootPath?: string;
+	/** Entry point files to analyze */
+	entryPoints: string[];
+}
+/**
+* Runtime environment configuration for executing a build plan.
+*/
+interface BuildPlanEnvironment {
+	/** Node.js or Bun runtime */
+	runtime: "node20" | "node22" | "bun";
+	/** Package manager to use */
+	packageManager: "npm" | "yarn" | "pnpm" | "bun";
+	/** Additional tools required (e.g., 'wasm-pack', 'cargo') */
+	requiredTools?: string[];
+}
+/**
+* A single step in the build plan.
+*/
+interface BuildPlanStep {
+	/** Unique identifier for this step */
+	id: string;
+	/** Human-readable step name */
+	name: string;
+	/** Command to execute */
+	command: string;
+	/** Command arguments */
+	args: string[];
+	/** Working directory (relative to repo root) */
+	cwd?: string;
+	/** Timeout in milliseconds */
+	timeout?: number;
+	/** If true, failure won't stop the plan execution */
+	optional?: boolean;
+}
+/**
+* AI-generated build plan for analyzing a repository.
+*/
+interface BuildPlan {
+	/** Build plan schema version */
+	version: "1.0.0";
+	/** When the plan was generated */
+	generatedAt: string;
+	/** Target repository information */
+	target: BuildPlanTarget;
+	/** Environment configuration */
+	environment: BuildPlanEnvironment;
+	/** Ordered list of steps to execute */
+	steps: BuildPlanStep[];
+	/** AI reasoning about the plan */
+	reasoning: {
+		/** Brief summary of the approach */
+		summary: string;
+		/** Why this approach was chosen */
+		rationale: string;
+		/** Potential issues or concerns */
+		concerns: string[];
+	};
+	/** AI confidence in the plan */
+	confidence: "high" | "medium" | "low";
+}
+/**
+* Result of executing a single build plan step.
+*/
+interface BuildPlanStepResult {
+	/** Step ID that was executed */
+	stepId: string;
+	/** Whether the step succeeded */
+	success: boolean;
+	/** Duration in milliseconds */
+	duration: number;
+	/** Command output (stdout) */
+	output?: string;
+	/** Error message if failed */
+	error?: string;
+}
+/**
+* Result of executing a complete build plan.
+*/
+interface BuildPlanExecutionResult {
+	/** Whether all required steps succeeded */
+	success: boolean;
+	/** Generated OpenPkg spec (if successful) */
+	spec?: import("@openpkg-ts/spec").OpenPkg;
+	/** Results for each step */
+	stepResults: BuildPlanStepResult[];
+	/** Total execution time in milliseconds */
+	totalDuration: number;
+	/** Overall error message if failed */
+	error?: string;
+}
+/**
+* Repository metadata from GitHub API.
+*/
+interface GitHubRepoMetadata {
+	owner: string;
+	repo: string;
+	defaultBranch: string;
+	description: string | null;
+	language: string | null;
+	topics: string[];
+	isPrivate: boolean;
+}
+/**
+* Detected package manager from lockfile.
+*/
+type DetectedPackageManager = "npm" | "yarn" | "pnpm" | "bun" | "unknown";
+/**
+* Workspace/monorepo configuration.
+*/
+interface WorkspaceConfig {
+	isMonorepo: boolean;
+	tool?: "npm" | "yarn" | "pnpm" | "lerna" | "turborepo" | "nx";
+	packages?: string[];
+}
+/**
+* Build hints detected from project files.
+*/
+interface BuildHints {
+	hasTypeScript: boolean;
+	hasWasm: boolean;
+	hasNativeModules: boolean;
+	hasBuildScript: boolean;
+	buildScript?: string;
+	frameworks: string[];
+}
+/**
+* Complete project context for build plan generation.
+*/
+interface GitHubProjectContext {
+	/** Repository metadata */
+	metadata: GitHubRepoMetadata;
+	/** Git ref being analyzed */
+	ref: string;
+	/** Detected package manager */
+	packageManager: DetectedPackageManager;
+	/** Workspace/monorepo configuration */
+	workspace: WorkspaceConfig;
+	/** Build hints from project files */
+	buildHints: BuildHints;
+	/** Raw file contents for AI analysis */
+	files: {
+		packageJson?: string;
+		tsconfigJson?: string;
+		lockfile?: {
+			name: string;
+			content: string;
+		};
+	};
+}
+/**
+* Parse GitHub URL into owner and repo.
+* Uses the richer parseGitHubUrl from github/index.ts, returning null on error.
+*/
+declare function parseGitHubUrl2(url: string): {
+	owner: string;
+	repo: string;
+} | null;
+/**
+* Fetch complete project context from GitHub.
+*/
+declare function fetchGitHubContext(repoUrl: string, ref?: string): Promise<GitHubProjectContext>;
+/**
+* List packages in a monorepo workspace.
+*/
+declare function listWorkspacePackages(owner: string, repo: string, ref: string, patterns: string[]): Promise<string[]>;
+/**
 * Type-check a single example
 */
 declare function typecheckExample(example: string, packagePath: string, options?: TypecheckOptions): ExampleTypeError[];
@@ -2349,4 +2377,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, shouldValidate, serializeJSDoc, saveSpecCache, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, readPackageJson, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, mergeFixes, mergeFilters, mergeConfig, loadSpecCache, loadCachedReport, isFixableDrift, isExecutableLang, isCachedReportValid, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupDriftsByCategory, getUndocumentedExports, getSpecCachePath, getRunCommand, getRulesForKind, getRule, getReportPath, getPrimaryBuildScript, getInstallCommand, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, getDefaultConfig, getCoverageRules, generateReportFromEnriched, generateReport, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, findRemovedReferences, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, fetchSpecFromGitHub, fetchSpec, extractSpecSummary, extractPackageSpec, extractImports, extractFunctionCalls, evaluateQuality, evaluateExportQuality, ensureSpecCoverage, enrichSpec, diffSpecWithDocs, diffHashes, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeExportDrift, computeDrift, clearSpecCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyEdits, analyzeProject2 as analyzeProject, analyzeFile, analyzeDocsImpact, analyze, WorkspacePackage, VALIDATION_INFO, TypecheckValidationResult, TypecheckResult, TypecheckOptions, SpecSummary, SpecDiffWithDocs, SpecCacheConfig, SpecCache, ScanResult, ScanOrchestratorOptions, ScanOrchestrator, ScanOptions, ScanContext, SandboxFileSystem, STYLE_RULES, SPEC_CACHE_FILE, RuntimeDrift, RunValidationResult, RunExamplesWithPackageResult, RunExamplesWithPackageOptions, RunExampleOptions, RuleContext, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, REPORT_VERSION, REPORT_EXTENSIONS, QualityViolation, QualitySeverity2 as QualitySeverity, QualityRulesConfig, QualityRule, QualityResult, QualityConfig, ProjectInfo, ProgressStage, ProgressEvent, ProgressCallback, PresenceResult, ParsedGitHubUrl, PackageManagerInfo, PackageManager, PackageJson, PackageExports, OpenPkgSpec, OpenPkgOptions, OpenPkg8 as OpenPkg, NodeFileSystem, MonorepoType, MonorepoRequiresPackageError, MonorepoInfo, MemberChange, MarkdownDocFile, MarkdownCodeBlock, LLMAssertion, JSDocTag, JSDocReturn, JSDocPatch, JSDocParam, JSDocEdit, InstallResult, InstallOptions, FixType, FixSuggestion, FilterSource, FilterOptions, FileSystem, ExportReference, ExportDriftResult, ExportCoverageData, ExampleValidationTypeError, ExampleValidationResult, ExampleValidationOptions, ExampleValidationMode, ExampleValidation, ExampleTypeError, ExampleRunResult, EntryPointSource, EntryPointInfo, EnrichedOpenPkg, EnrichedExport, EnrichedDocsMetadata, EnrichOptions, DriftSummary, DriftResult, DriftReportSummary, DriftReport, DriftIssue, DocsImpactResult, DocsImpactReference, DocsImpact, DocsConfig, DocsChangeType, DocCovReport, DocCovOptions, DocCovConfig, DocCov, DiffWithDocsOptions, Diagnostic, DEFAULT_REPORT_PATH, DEFAULT_REPORT_DIR, CoverageSummary, CommandRunner, CommandResult, CheckConfig, CategorizedDrift, CacheValidationResult, CacheContext, CORE_RULES, CACHE_VERSION, BuildInfo, BUILTIN_RULES, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, AggregateQualityResult, ALL_VALIDATIONS };
+export { validateSpecCache, validateExamples, typecheckExamples, typecheckExample, shouldValidate, serializeJSDoc, saveSpecCache, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, readPackageJson, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, mergeFixes, mergeFilters, mergeConfig, loadSpecCache, loadCachedReport, listWorkspacePackages, isFixableDrift, isExecutableLang, isCachedReportValid, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupDriftsByCategory, getUndocumentedExports, getSpecCachePath, getRunCommand, getRulesForKind, getRule, getReportPath, getPrimaryBuildScript, getInstallCommand, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, getDefaultConfig, getCoverageRules, generateReportFromEnriched, generateReport, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, findRemovedReferences, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractSpecSummary, extractPackageSpec, extractImports, extractFunctionCalls, evaluateQuality, evaluateExportQuality, ensureSpecCoverage, enrichSpec, diffSpecWithDocs, diffHashes, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeExportDrift, computeDrift, clearSpecCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyEdits, analyzeProject2 as analyzeProject, analyzeFile, analyzeDocsImpact, analyze, WorkspacePackage, WorkspaceConfig, VALIDATION_INFO, TypecheckValidationResult, TypecheckResult, TypecheckOptions, SummaryDriftIssue, SpecSummary, SpecDiffWithDocs, SpecCacheConfig, SpecCache, SandboxFileSystem, STYLE_RULES, SPEC_CACHE_FILE, RuntimeDrift, RunValidationResult, RunExamplesWithPackageResult, RunExamplesWithPackageOptions, RunExampleOptions, RuleContext, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, REPORT_VERSION, REPORT_EXTENSIONS, QualityViolation, QualitySeverity2 as QualitySeverity, QualityRulesConfig, QualityRule, QualityResult, QualityConfig, ProjectInfo, PresenceResult, ParsedGitHubUrl, PackageManagerInfo, PackageManager, PackageJson, PackageExports, OpenPkgSpec, NodeFileSystem, MonorepoType, MonorepoInfo, MemberChange, MarkdownDocFile, MarkdownCodeBlock, LLMAssertion, JSDocTag, JSDocReturn, JSDocPatch, JSDocParam, JSDocEdit, InstallResult, InstallOptions, GitHubRepoMetadata, GitHubProjectContext, FixType, FixSuggestion, FilterSource, FilterOptions, FileSystem, 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, DetectedPackageManager, DEFAULT_REPORT_PATH, DEFAULT_REPORT_DIR, CoverageSummary, CommandRunner, CommandResult, CheckConfig, CategorizedDrift, CacheValidationResult, CacheContext, CORE_RULES, CACHE_VERSION, BuildPlanTarget, BuildPlanStepResult, BuildPlanStep, BuildPlanExecutionResult, BuildPlanEnvironment, BuildPlan, BuildInfo, BuildHints, BUILTIN_RULES, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, AggregateQualityResult, ALL_VALIDATIONS };