fix(sdk): fix dogfood gate — bundler dupes, prose drift false positives, stale README imports

Author: Ryan

packages/sdk/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @doccov/sdk
 
+## 1.0.2
+
+### Patch Changes
+
+- Fix dogfood gate: bundler duplicate export errors, prose drift false positives on subpath imports, stale README imports, add content/\*_/_.md to default discovery
+
+## 1.0.1
+
+### Patch Changes
+
+- 8719ae0: Fix dogfood gate: bundler duplicate export errors, prose drift false positives on subpath imports, stale README imports, add content/\*_/_.md to default discovery
+
 ## 1.0.0
 
 ### Major Changes

packages/sdk/README.md

@@ -133,7 +133,7 @@ const { entryFile, targetDir, packageInfo } = await resolveTarget(fs, {
 ### History & Trends
 
 ```typescript
-import { saveSnapshot, loadSnapshots, getTrend, computeSnapshot } from '@driftdev/sdk';
+import { saveSnapshot, loadSnapshots, getTrend, computeSnapshot } from '@driftdev/sdk/history';
 
 saveSnapshot(computeSnapshot(spec), process.cwd());
 const snapshots = loadSnapshots(process.cwd());
@@ -143,7 +143,7 @@ const trend = getTrend(spec, process.cwd());
 ### Categorize & Summarize
 
 ```typescript
-import { categorizeDrift, getDriftSummary, groupDriftsByCategory } from '@driftdev/sdk';
+import { categorizeDrift, getDriftSummary, groupDriftsByCategory } from '@driftdev/sdk/analysis';
 
 const summary = getDriftSummary(drifts);
 // summary.total, summary.byCategory (structural/semantic/example/prose)
@@ -164,7 +164,7 @@ const grouped = groupDriftsByCategory(drifts);
 ### Drift Detection
 - `detectProseDrift` — Markdown prose drift detection
 - `buildExportRegistry` — Build registry for cross-reference validation
-- `categorizeDrift` / `getDriftSummary` / `groupDriftsByCategory` — Categorization
+- `categorizeDrift` / `getDriftSummary` / `groupDriftsByCategory` — Categorization (via `@driftdev/sdk/analysis`)
 
 ### Markdown
 - `discoverMarkdownFiles` — Auto-discover markdown files by glob patterns
@@ -181,7 +181,7 @@ const grouped = groupDriftsByCategory(drifts);
 - `NodeFileSystem` — File system adapter
 - `detectPackageManager` — Detect npm/yarn/pnpm/bun
 
-### History
+### History (via `@driftdev/sdk/history`)
 - `saveSnapshot` / `loadSnapshots` — Manage coverage history
 - `getTrend` / `getExtendedTrend` — Trend analysis
 - `pruneHistory` — Clean old snapshots

packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftdev/sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Drift SDK - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",

packages/sdk/src/analysis/drift/prose-drift.ts

@@ -35,6 +35,8 @@ export function detectProseDrift(options: ProseDriftOptions): SpecDocDrift[] {
       for (const imp of packageImports) {
         if (imp.kind === 'side-effect') continue;
         if (registry.all.has(imp.name)) continue;
+        // Skip subpath imports — registry only covers the main entry point
+        if (imp.from !== packageName) continue;
 
         const match = findClosestMatch(imp.name, registry.allNames);
         const suggestion = match

packages/sdk/src/analyzer.ts

@@ -16,7 +16,7 @@ import {
   loadSpecCache,
   saveSpecCache,
   validateSpecCache,
-} from './cache';
+} from './cache/spec-cache';
 import { extractPackageSpec } from './extractor';
 import { applyFilters } from './filtering/apply-filters';
 import type { FilterOptions } from './filtering/types';

packages/sdk/src/index.ts

@@ -136,18 +136,22 @@ export { resolveTarget } from './resolve';
 
 export type {
   ExampleValidation,
+} from './examples/types';
+export type {
   ExampleValidationOptions,
   ExampleValidationResult,
-} from './examples';
-export { parseExamplesFlag, validateExamples } from './examples';
+} from './examples/validator';
+export { parseExamplesFlag } from './examples/types';
+export { validateExamples } from './examples/validator';
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Markdown Analysis — @deprecated Use @driftdev/sdk/markdown
 // ─────────────────────────────────────────────────────────────────────────────
 
 export { detectProseDrift, type ProseDriftOptions } from './analysis/drift/prose-drift';
-export type { MarkdownCodeBlock, MarkdownDocFile } from './markdown';
-export { discoverMarkdownFiles, findExportReferences, parseMarkdownFiles } from './markdown';
+export type { MarkdownCodeBlock, MarkdownDocFile } from './markdown/types';
+export { discoverMarkdownFiles } from './markdown/discover';
+export { findExportReferences, parseMarkdownFiles } from './markdown/parser';
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Report Types (commonly needed)

packages/sdk/src/markdown/discover.ts

@@ -8,7 +8,7 @@ export interface DiscoverOptions {
   exclude?: string[];
 }
 
-const DEFAULT_INCLUDE = ['README.md', 'docs/**/*.md', 'docs/**/*.mdx'];
+const DEFAULT_INCLUDE = ['README.md', 'docs/**/*.md', 'docs/**/*.mdx', 'content/**/*.md', 'content/**/*.mdx'];
 const DEFAULT_EXCLUDE = ['node_modules/**', 'dist/**', '.git/**'];
 
 /**