@doccov/sdk 0.29.4 → 0.30.1

package/dist/analysis/index.d.ts

@@ -258,7 +258,7 @@ declare function hasNonAssertionComments(code: string): boolean;
 */
 declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
 import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
-/** Directory for storing history snapshots */
+/** Directory for storing history snapshots (relative to .doccov) */
 declare const HISTORY_DIR = ".doccov/history";
 /**
 * A historical coverage snapshot.
@@ -351,14 +351,18 @@ declare function computeSnapshot(spec: OpenPkg2, options?: {
 /**
 * Save a coverage snapshot to history.
 *
+* Uses project root for .doccov location (walks up from cwd to find root).
+*
 * @param snapshot - The snapshot to save
-* @param cwd - Working directory
+* @param cwd - Working directory (will resolve to project root)
 */
 declare function saveSnapshot(snapshot: CoverageSnapshot, cwd: string): void;
 /**
 * Load all historical snapshots.
 *
-* @param cwd - Working directory
+* Uses project root for .doccov location (walks up from cwd to find root).
+*
+* @param cwd - Working directory (will resolve to project root)
 * @returns Array of snapshots sorted by timestamp (most recent first)
 */
 declare function loadSnapshots(cwd: string): CoverageSnapshot[];
@@ -391,7 +395,9 @@ declare function formatDelta(delta: number): string;
 /**
 * Prune old snapshots to keep history manageable.
 *
-* @param cwd - Working directory
+* Uses project root for .doccov location (walks up from cwd to find root).
+*
+* @param cwd - Working directory (will resolve to project root)
 * @param keepCount - Number of snapshots to keep (default: 100)
 * @returns Number of snapshots deleted
 */

package/dist/analysis/index.js

@@ -36,7 +36,7 @@ import {
   renderSparkline,
   saveReport,
   saveSnapshot
-} from "../shared/chunk-0048g7g0.js";
+} from "../shared/chunk-fdjehkbt.js";
 import"../shared/chunk-r4wa72ae.js";
 export {
   saveSnapshot,

package/dist/index.d.ts

@@ -767,13 +767,17 @@ interface CacheContext {
 /**
 * Load cached spec from disk.
 *
-* @param cwd - Working directory
+* Uses project root for cache location (walks up from cwd to find root).
+*
+* @param cwd - Working directory (will resolve to project root)
 * @returns Cached spec, or null if not found or invalid JSON
 */
 declare function loadSpecCache(cwd: string): SpecCache | null;
 /**
 * Save spec to cache.
 *
+* Uses project root for cache location (walks up from cwd to find root).
+*
 * @param spec - OpenPkg spec to cache
 * @param context - Cache context with file paths and config
 */
@@ -797,14 +801,18 @@ declare function validateSpecCache(cache: SpecCache, context: CacheContext): Cac
 /**
 * Clear the spec cache.
 *
-* @param cwd - Working directory
+* Uses project root for cache location (walks up from cwd to find root).
+*
+* @param cwd - Working directory (will resolve to project root)
 * @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
+* Uses project root for cache location (walks up from cwd to find root).
+*
+* @param cwd - Working directory (will resolve to project root)
 * @returns Absolute path to cache file
 */
 declare function getSpecCachePath(cwd: string): string;
@@ -2026,7 +2034,7 @@ interface DetectedSchemaEntry {
 	vendor: string;
 }
 import { OpenPkg as OpenPkg6 } from "@openpkg-ts/spec";
-/** Directory for storing history snapshots */
+/** Directory for storing history snapshots (relative to .doccov) */
 declare const HISTORY_DIR = ".doccov/history";
 /**
 * A historical coverage snapshot.
@@ -2119,14 +2127,18 @@ declare function computeSnapshot(spec: OpenPkg6, options?: {
 /**
 * Save a coverage snapshot to history.
 *
+* Uses project root for .doccov location (walks up from cwd to find root).
+*
 * @param snapshot - The snapshot to save
-* @param cwd - Working directory
+* @param cwd - Working directory (will resolve to project root)
 */
 declare function saveSnapshot(snapshot: CoverageSnapshot, cwd: string): void;
 /**
 * Load all historical snapshots.
 *
-* @param cwd - Working directory
+* Uses project root for .doccov location (walks up from cwd to find root).
+*
+* @param cwd - Working directory (will resolve to project root)
 * @returns Array of snapshots sorted by timestamp (most recent first)
 */
 declare function loadSnapshots(cwd: string): CoverageSnapshot[];
@@ -2159,7 +2171,9 @@ declare function formatDelta(delta: number): string;
 /**
 * Prune old snapshots to keep history manageable.
 *
-* @param cwd - Working directory
+* Uses project root for .doccov location (walks up from cwd to find root).
+*
+* @param cwd - Working directory (will resolve to project root)
 * @param keepCount - Number of snapshots to keep (default: 100)
 * @returns Number of snapshots deleted
 */
@@ -2618,7 +2632,7 @@ interface SpecSummary {
 * ```
 */
 declare function extractSpecSummary(openpkg: OpenPkg8, doccov: DocCovSpec4): SpecSummary;
-import { OpenPkg as OpenPkg_hlpylamjdn } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg_vkaurybbgl } from "@openpkg-ts/spec";
 /**
 * Build Plan types for AI-powered repository scanning.
 */
@@ -2715,7 +2729,7 @@ interface BuildPlanExecutionResult {
 	/** Whether all required steps succeeded */
 	success: boolean;
 	/** Generated OpenPkg spec (if successful) */
-	spec?: OpenPkg_hlpylamjdn;
+	spec?: OpenPkg_vkaurybbgl;
 	/** Results for each step */
 	stepResults: BuildPlanStepResult[];
 	/** Total execution time in milliseconds */
@@ -2723,4 +2737,28 @@ 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, previewForgottenExportFixes, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, normalizeConfig, mergeFixes, mergeFilters, loadSpecCache, loadSnapshots, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isSchemaType, isFixableDrift, isExportFullyDocumented, isExecutableLang, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupFixesByFile, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getExportScore, getExportMissing, getExportDrift, getExportAnalysis, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDiffReportPath, generateReportFromDocCov, generateReport, generateForgottenExportFixes, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findRemovedReferences, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, findAdapter, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractStandardSchemasFromProject, extractStandardSchemas, extractSpecSummary, extractSchemaType, extractSchemaOutputType, extractPackageSpec, extractImports, extractFunctionCalls, ensureSpecCoverage, docCovConfigSchema, diffSpecWithDocs, diffHashes, detectRuntimeSchemas, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeSnapshot, computeHealth, computeExportDrift, computeDrift, clearSpecCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDocCovSpec, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyForgottenExportFixes, 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, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, ReleaseTag, 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, HealthInput, HISTORY_DIR, GitHubRepoMetadata, GitHubProjectContext, GenerateForgottenExportFixesOptions, ForgottenExportResult, ForgottenExportFix, 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, DocCovConfigInput, DocCovConfig, DocCov, DiffWithDocsOptions, 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, ApplyForgottenExportResult, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, ALL_VALIDATIONS };
+/**
+* Find the project root by walking up from the given directory.
+*
+* Looks for:
+* 1. .git directory
+* 2. pnpm-workspace.yaml
+* 3. package.json with "workspaces" field
+* 4. Other monorepo markers (lerna.json, nx.json, rush.json)
+*
+* Falls back to the original directory if no root is found.
+*
+* @param startDir - Directory to start searching from
+* @returns Absolute path to the project root
+*/
+declare function findProjectRoot(startDir: string): string;
+/**
+* Get the .doccov cache directory for a project.
+*
+* Always uses the project root, not the package directory.
+*
+* @param cwd - Current working directory or package directory
+* @returns Absolute path to the .doccov directory
+*/
+declare function getDoccovDir(cwd: string): string;
+export { validateSpecCache, validateExamples, typecheckExamples, typecheckExample, shouldValidate, serializeJSDoc, saveSpecCache, saveSnapshot, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, resolveCompiledPath, renderSparkline, renderApiSurface, readPackageJson, pruneHistory, previewForgottenExportFixes, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, normalizeConfig, mergeFixes, mergeFilters, loadSpecCache, loadSnapshots, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isSchemaType, isFixableDrift, isExportFullyDocumented, isExecutableLang, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupFixesByFile, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getExportScore, getExportMissing, getExportDrift, getExportAnalysis, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDoccovDir, getDiffReportPath, generateReportFromDocCov, generateReport, generateForgottenExportFixes, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findRemovedReferences, findProjectRoot, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, findAdapter, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractStandardSchemasFromProject, extractStandardSchemas, extractSpecSummary, extractSchemaType, extractSchemaOutputType, extractPackageSpec, extractImports, extractFunctionCalls, ensureSpecCoverage, docCovConfigSchema, diffSpecWithDocs, diffHashes, detectRuntimeSchemas, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeSnapshot, computeHealth, computeExportDrift, computeDrift, clearSpecCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDocCovSpec, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyForgottenExportFixes, 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, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, ReleaseTag, 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, HealthInput, HISTORY_DIR, GitHubRepoMetadata, GitHubProjectContext, GenerateForgottenExportFixesOptions, ForgottenExportResult, ForgottenExportFix, 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, DocCovConfigInput, DocCovConfig, DocCov, DiffWithDocsOptions, 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, ApplyForgottenExportResult, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, ALL_VALIDATIONS };

package/dist/index.js

@@ -26,6 +26,7 @@ import {
   extractStandardSchemasFromProject,
   findAdapter,
   findJSDocLocation,
+  findProjectRoot,
   formatDelta,
   formatDriftSummaryLine,
   generateFix,
@@ -33,6 +34,7 @@ import {
   generateForgottenExportFixes,
   generateReport,
   generateReportFromDocCov,
+  getDoccovDir,
   getDriftSummary,
   getExportAnalysis,
   getExportDrift,
@@ -64,7 +66,7 @@ import {
   saveSnapshot,
   serializeJSDoc,
   ts
-} from "./shared/chunk-0048g7g0.js";
+} from "./shared/chunk-fdjehkbt.js";
 import {
   mergeFilters,
   parseListFlag
@@ -319,7 +321,7 @@ var CACHE_VERSION = "1.3.0";
 var SPEC_CACHE_FILE = ".doccov/cache/spec.cache.json";
 function loadSpecCache(cwd) {
   try {
-    const cachePath = path5.resolve(cwd, SPEC_CACHE_FILE);
+    const cachePath = path5.join(getDoccovDir(cwd), "cache", "spec.cache.json");
     if (!fs4.existsSync(cachePath)) {
       return null;
     }
@@ -355,7 +357,7 @@ function saveSpecCache(spec, context) {
     specDiagnostics,
     forgottenExports
   };
-  const cachePath = path5.resolve(cwd, SPEC_CACHE_FILE);
+  const cachePath = path5.join(getDoccovDir(cwd), "cache", "spec.cache.json");
   const dir = path5.dirname(cachePath);
   if (!fs4.existsSync(dir)) {
     fs4.mkdirSync(dir, { recursive: true });
@@ -390,7 +392,7 @@ function validateSpecCache(cache, context) {
   return { valid: true };
 }
 function clearSpecCache(cwd) {
-  const cachePath = path5.resolve(cwd, SPEC_CACHE_FILE);
+  const cachePath = path5.join(getDoccovDir(cwd), "cache", "spec.cache.json");
   if (fs4.existsSync(cachePath)) {
     fs4.unlinkSync(cachePath);
     return true;
@@ -398,7 +400,7 @@ function clearSpecCache(cwd) {
   return false;
 }
 function getSpecCachePath(cwd) {
-  return path5.resolve(cwd, SPEC_CACHE_FILE);
+  return path5.join(getDoccovDir(cwd), "cache", "spec.cache.json");
 }
 // src/extractor.ts
 import * as path6 from "node:path";
@@ -15420,7 +15422,7 @@ async function runExample(code, options = {}) {
   try {
     fs8.writeFileSync(tmpFile, cleanCode, "utf-8");
     const startTime = Date.now();
-    return await new Promise((resolve5) => {
+    return await new Promise((resolve4) => {
       let stdout = "";
       let stderr = "";
       let killed = false;
@@ -15443,7 +15445,7 @@ async function runExample(code, options = {}) {
         clearTimeout(timeoutId);
         const duration3 = Date.now() - startTime;
         if (killed) {
-          resolve5({
+          resolve4({
             success: false,
             stdout,
             stderr: stderr || `Example timed out after ${timeout}ms`,
@@ -15451,7 +15453,7 @@ async function runExample(code, options = {}) {
             duration: duration3
           });
         } else {
-          resolve5({
+          resolve4({
             success: exitCode === 0,
             stdout,
             stderr,
@@ -15462,7 +15464,7 @@ async function runExample(code, options = {}) {
       });
       proc.on("error", (error48) => {
         clearTimeout(timeoutId);
-        resolve5({
+        resolve4({
           success: false,
           stdout,
           stderr: error48.message,
@@ -15513,7 +15515,7 @@ function getInstallCommand2(pm, packagePath) {
   }
 }
 async function runCommand(cmd, args, options) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve4) => {
     let stdout = "";
     let stderr = "";
     let killed = false;
@@ -15534,14 +15536,14 @@ async function runCommand(cmd, args, options) {
     proc.on("close", (exitCode) => {
       clearTimeout(timeoutId);
       if (killed) {
-        resolve5({
+        resolve4({
           success: false,
           stdout,
           stderr: stderr || `Command timed out after ${options.timeout}ms`,
           exitCode: exitCode ?? 1
         });
       } else {
-        resolve5({
+        resolve4({
           success: exitCode === 0,
           stdout,
           stderr,
@@ -15551,7 +15553,7 @@ async function runCommand(cmd, args, options) {
     });
     proc.on("error", (error48) => {
       clearTimeout(timeoutId);
-      resolve5({
+      resolve4({
         success: false,
         stdout,
         stderr: error48.message,
@@ -17110,6 +17112,7 @@ export {
   getDriftSummary,
   getDocumentedExports,
   getDocsImpactSummary,
+  getDoccovDir,
   getDiffReportPath,
   generateReportFromDocCov,
   generateReport,
@@ -17120,6 +17123,7 @@ export {
   formatDriftSummaryLine,
   formatDelta,
   findRemovedReferences,
+  findProjectRoot,
   findPackageByName,
   findJSDocLocation,
   findExportReferences,

package/dist/shared/{chunk-0048g7g0.js → chunk-fdjehkbt.js}

@@ -1121,47 +1121,16 @@ var BUILTIN_GLOBALS = new Set([
 ]);
 
 // src/analysis/drift/utils.ts
-function extractParamFromTag(text) {
-  const trimmed = text.trim();
-  if (!trimmed) {
-    return;
-  }
-  const match = trimmed.match(/^(?:\{([^}]+)\}\s+)?(\S+)(?:\s+-\s+)?/);
-  if (!match) {
-    return;
-  }
-  const [, type, rawName] = match;
-  const isOptional = Boolean(rawName?.startsWith("[") && rawName?.endsWith("]"));
-  const name = normalizeParamName(rawName);
-  if (!name) {
+function extractParamFromTag(tag) {
+  if (!tag.param) {
     return;
   }
   return {
-    name,
-    type: type?.trim(),
-    isOptional
+    name: tag.param.name,
+    type: tag.param.type,
+    isOptional: tag.param.optional
   };
 }
-function normalizeParamName(raw) {
-  if (!raw) {
-    return;
-  }
-  let name = raw.trim();
-  if (!name) {
-    return;
-  }
-  if (name.startsWith("[") && name.endsWith("]")) {
-    name = name.slice(1, -1);
-  }
-  const equalsIndex = name.indexOf("=");
-  if (equalsIndex >= 0) {
-    name = name.slice(0, equalsIndex);
-  }
-  if (name.endsWith(",")) {
-    name = name.slice(0, -1);
-  }
-  return name;
-}
 function extractReturnTypeFromTag(text) {
   const trimmed = text.trim();
   if (!trimmed) {
@@ -1640,7 +1609,7 @@ function detectParamDrift(entry) {
   if (actualParamNames.size === 0) {
     return drifts;
   }
-  const documentedParamNames = (entry.tags ?? []).filter((tag) => tag.name === "param" && Boolean(tag.text)).map((tag) => extractParamFromTag(tag.text ?? "")?.name).filter((name) => Boolean(name));
+  const documentedParamNames = (entry.tags ?? []).filter((tag) => tag.name === "param").map((tag) => extractParamFromTag(tag)?.name).filter((name) => Boolean(name));
   if (documentedParamNames.length === 0) {
     return drifts;
   }
@@ -1712,7 +1681,7 @@ function detectOptionalityDrift(entry) {
   if (actualOptionality.size === 0) {
     return [];
   }
-  const documentedParams = (entry.tags ?? []).filter((tag) => tag.name === "param" && Boolean(tag.text)).map((tag) => extractParamFromTag(tag.text ?? "")).filter((parsed) => Boolean(parsed?.name));
+  const documentedParams = (entry.tags ?? []).filter((tag) => tag.name === "param").map((tag) => extractParamFromTag(tag)).filter((parsed) => Boolean(parsed?.name));
   if (documentedParams.length === 0) {
     return [];
   }
@@ -1742,7 +1711,7 @@ function detectParamTypeDrift(entry) {
   if (signatures.length === 0) {
     return [];
   }
-  const documentedParams = (entry.tags ?? []).filter((tag) => tag.name === "param" && Boolean(tag.text)).map((tag) => extractParamFromTag(tag.text ?? "")).filter((parsed) => Boolean(parsed?.name) && Boolean(parsed?.type));
+  const documentedParams = (entry.tags ?? []).filter((tag) => tag.name === "param").map((tag) => extractParamFromTag(tag)).filter((parsed) => Boolean(parsed?.name) && Boolean(parsed?.type));
   if (documentedParams.length === 0) {
     return [];
   }
@@ -2863,10 +2832,52 @@ async function detectRuntimeSchemas(context) {
   };
 }
 
-// src/analysis/history.ts
+// src/utils/project-root.ts
 import * as fs4 from "node:fs";
 import * as path4 from "node:path";
+var PROJECT_ROOT_MARKERS = [
+  ".git",
+  "pnpm-workspace.yaml",
+  "pnpm-workspace.yml",
+  "lerna.json",
+  "nx.json",
+  "rush.json"
+];
+function findProjectRoot(startDir) {
+  let dir = path4.resolve(startDir);
+  const root = path4.parse(dir).root;
+  while (dir !== root) {
+    for (const marker of PROJECT_ROOT_MARKERS) {
+      const markerPath = path4.join(dir, marker);
+      if (fs4.existsSync(markerPath)) {
+        return dir;
+      }
+    }
+    const pkgPath = path4.join(dir, "package.json");
+    if (fs4.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
+        if (pkg.workspaces) {
+          return dir;
+        }
+      } catch {}
+    }
+    dir = path4.dirname(dir);
+  }
+  return path4.resolve(startDir);
+}
+function getDoccovDir(cwd) {
+  const projectRoot = findProjectRoot(cwd);
+  return path4.join(projectRoot, ".doccov");
+}
+
+// src/analysis/history.ts
+import * as fs5 from "node:fs";
+import * as path5 from "node:path";
 var HISTORY_DIR = ".doccov/history";
+function getHistoryDir(cwd) {
+  return path5.join(getDoccovDir(cwd), "history");
+}
 var RETENTION_DAYS = 90;
 function getSnapshotFilename(timestamp) {
   const pad = (n) => n.toString().padStart(2, "0");
@@ -2899,24 +2910,24 @@ function computeSnapshot(spec, options) {
   };
 }
 function saveSnapshot(snapshot, cwd) {
-  const historyDir = path4.resolve(cwd, HISTORY_DIR);
-  if (!fs4.existsSync(historyDir)) {
-    fs4.mkdirSync(historyDir, { recursive: true });
+  const historyDir = getHistoryDir(cwd);
+  if (!fs5.existsSync(historyDir)) {
+    fs5.mkdirSync(historyDir, { recursive: true });
   }
   const filename = getSnapshotFilename(new Date(snapshot.timestamp));
-  const filepath = path4.join(historyDir, filename);
-  fs4.writeFileSync(filepath, JSON.stringify(snapshot, null, 2));
+  const filepath = path5.join(historyDir, filename);
+  fs5.writeFileSync(filepath, JSON.stringify(snapshot, null, 2));
 }
 function loadSnapshots(cwd) {
-  const historyDir = path4.resolve(cwd, HISTORY_DIR);
-  if (!fs4.existsSync(historyDir)) {
+  const historyDir = getHistoryDir(cwd);
+  if (!fs5.existsSync(historyDir)) {
     return [];
   }
-  const files = fs4.readdirSync(historyDir).filter((f) => f.endsWith(".json")).sort().reverse();
+  const files = fs5.readdirSync(historyDir).filter((f) => f.endsWith(".json")).sort().reverse();
   const snapshots = [];
   for (const file of files) {
     try {
-      const content = fs4.readFileSync(path4.join(historyDir, file), "utf-8");
+      const content = fs5.readFileSync(path5.join(historyDir, file), "utf-8");
       snapshots.push(JSON.parse(content));
     } catch {}
   }
@@ -2956,15 +2967,15 @@ function formatDelta(delta) {
   return "→0%";
 }
 function pruneHistory(cwd, keepCount = 100) {
-  const historyDir = path4.resolve(cwd, HISTORY_DIR);
-  if (!fs4.existsSync(historyDir)) {
+  const historyDir = getHistoryDir(cwd);
+  if (!fs5.existsSync(historyDir)) {
     return 0;
   }
-  const files = fs4.readdirSync(historyDir).filter((f) => f.endsWith(".json")).sort().reverse();
+  const files = fs5.readdirSync(historyDir).filter((f) => f.endsWith(".json")).sort().reverse();
   const toDelete = files.slice(keepCount);
   for (const file of toDelete) {
     try {
-      fs4.unlinkSync(path4.join(historyDir, file));
+      fs5.unlinkSync(path5.join(historyDir, file));
     } catch {}
   }
   return toDelete.length;
@@ -3060,4 +3071,4 @@ function getExtendedTrend(spec, cwd, options) {
   };
 }
 
-export { isFixableDrift, generateFix, generateFixesForExport, mergeFixes, categorizeDrifts, generateForgottenExportFixes, groupFixesByFile, applyForgottenExportFixes, previewForgottenExportFixes, ts, parseJSDocToPatch, applyPatchToJSDoc, serializeJSDoc, findJSDocLocation, applyEdits, createSourceFile, isBuiltInIdentifier, detectExampleRuntimeErrors, parseAssertions, hasNonAssertionComments, detectExampleAssertionFailures, buildExportRegistry, computeDrift, computeExportDrift, computeHealth, 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, extractSchemaOutputType, getRegisteredAdapters, getSupportedLibraries, extractSchemaType, extractStandardSchemas, extractStandardSchemasFromProject, findAdapter, isSchemaType, isStandardJSONSchema, resolveCompiledPath, detectRuntimeSchemas, HISTORY_DIR, computeSnapshot, saveSnapshot, loadSnapshots, getTrend, renderSparkline, formatDelta, pruneHistory, loadSnapshotsForDays, generateWeeklySummaries, getExtendedTrend };
+export { isFixableDrift, generateFix, generateFixesForExport, mergeFixes, categorizeDrifts, generateForgottenExportFixes, groupFixesByFile, applyForgottenExportFixes, previewForgottenExportFixes, ts, parseJSDocToPatch, applyPatchToJSDoc, serializeJSDoc, findJSDocLocation, applyEdits, createSourceFile, isBuiltInIdentifier, detectExampleRuntimeErrors, parseAssertions, hasNonAssertionComments, detectExampleAssertionFailures, buildExportRegistry, computeDrift, computeExportDrift, computeHealth, 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, extractSchemaOutputType, getRegisteredAdapters, getSupportedLibraries, extractSchemaType, extractStandardSchemas, extractStandardSchemasFromProject, findAdapter, isSchemaType, isStandardJSONSchema, resolveCompiledPath, detectRuntimeSchemas, findProjectRoot, getDoccovDir, HISTORY_DIR, computeSnapshot, saveSnapshot, loadSnapshots, getTrend, renderSparkline, formatDelta, pruneHistory, loadSnapshotsForDays, generateWeeklySummaries, getExtendedTrend };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/sdk",
-  "version": "0.29.4",
+  "version": "0.30.1",
   "description": "DocCov SDK - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -48,8 +48,8 @@
   ],
   "dependencies": {
     "@doccov/spec": "^0.27.0",
-    "@openpkg-ts/extract": "^0.18.0",
-    "@openpkg-ts/spec": "^0.12.0",
+    "@openpkg-ts/extract": "^0.19.0",
+    "@openpkg-ts/spec": "^0.19.0",
     "@vercel/sandbox": "^1.0.3",
     "mdast": "^3.0.0",
     "minimatch": "^10.1.1",