doc-freshness-checker 2.0.6 → 2.0.7

package/README.md

@@ -134,6 +134,8 @@ Options:
   --vector-search         Enable semantic vector search for doc-code mismatches
 ```
 
+Incremental mode skips unchanged documents only after a clean run when the effective configuration and project inventory are unchanged. It conservatively revalidates all documents when filesystem or external inputs cannot be fingerprinted safely.
+
 ### Common Examples
 
 ```bash

package/dist/runner.js

@@ -27,6 +27,12 @@ import { FreshnessScorer } from './scoring/freshnessScorer.js';
 import { IncrementalChecker } from './utils/incremental.js';
 import { VectorSearch } from './semantic/vectorSearch.js';
 import { loadConfig } from './config/loader.js';
+const REPORTER_OUTPUT = {
+    console: 'console',
+    json: 'stable',
+    markdown: 'timestamped',
+    enhanced: 'timestamped',
+};
 /**
  * Main entry point - run with config object
  */
@@ -94,34 +100,39 @@ export async function run(config) {
     if (config.verbose) {
         console.log('Scanning documentation files...');
     }
-    let documents = await parser.scanDocuments();
+    const allDocuments = await parser.scanDocuments();
+    let documentsToValidate = allDocuments;
     if (config.verbose) {
-        console.log(`Found ${documents.length} documentation files.`);
+        console.log(`Found ${allDocuments.length} documentation files.`);
     }
     // Apply incremental checking if enabled
     let incrementalChecker = null;
-    if (config.incremental?.enabled) {
-        incrementalChecker = new IncrementalChecker(config.cache?.dir || '.doc-freshness-cache');
-        const allDocs = documents;
-        documents = await incrementalChecker.filterChanged(documents);
+    if (config.incremental?.enabled && allDocuments.length > 0) {
+        const stateDir = path.resolve(config.rootDir || process.cwd(), config.cache?.dir || config.graph?.cacheDir || '.doc-freshness-cache');
+        const incrementalInputs = await validationEngine.captureIncrementalInputs(allDocuments);
+        const finalFileReporter = (config.reporters || ['console']).findLast((reporter) => REPORTER_OUTPUT[reporter] === 'stable' || REPORTER_OUTPUT[reporter] === 'timestamped');
+        const inventoryExclusions = config.outputPath && finalFileReporter && REPORTER_OUTPUT[finalFileReporter] === 'timestamped'
+            ? [path.resolve(config.outputPath)]
+            : [];
+        incrementalChecker = new IncrementalChecker(stateDir);
+        documentsToValidate = await incrementalChecker.filterChanged(allDocuments, config, incrementalInputs, inventoryExclusions);
         if (config.verbose) {
-            const stats = incrementalChecker.getStats(allDocs.length, documents.length);
+            const stats = incrementalChecker.getStats(allDocuments.length, documentsToValidate.length);
             console.log(`Incremental mode: checking ${stats.changed} changed files, skipping ${stats.skipped} unchanged.`);
         }
     }
+    else if (config.incremental?.enabled && config.verbose) {
+        console.log('Incremental mode: checking 0 changed files, skipping 0 unchanged.');
+    }
     if (config.verbose) {
-        const totalRefs = documents.reduce((sum, doc) => sum + doc.references.length, 0);
+        const totalRefs = allDocuments.reduce((sum, doc) => sum + doc.references.length, 0);
         console.log(`Extracted ${totalRefs} references.`);
     }
     // Validate references
     if (config.verbose) {
         console.log('Validating references...');
     }
-    const results = await validationEngine.validate(documents);
-    // Save incremental state
-    if (incrementalChecker) {
-        await incrementalChecker.saveState();
-    }
+    const results = await validationEngine.validate(documentsToValidate);
     // Build graph if enabled
     let graph = null;
     let gitTracker = null;
@@ -133,7 +144,7 @@ export async function run(config) {
         const codeIndex = codePatternValidator.getSourceIndex();
         // Build graph
         const graphBuilder = new GraphBuilder(config);
-        graph = await graphBuilder.buildGraph(documents, codeIndex);
+        graph = await graphBuilder.buildGraph(allDocuments, codeIndex);
         if (gitTracker.isGitRepo()) {
             graph.gitCommit = gitTracker.getCurrentCommit();
         }
@@ -146,7 +157,7 @@ export async function run(config) {
         // Calculate freshness scores if enabled
         if (config.freshnessScoring?.enabled) {
             const scorer = new FreshnessScorer(config);
-            freshnessScores = scorer.calculateProjectScores(documents, results, gitTracker, graph);
+            freshnessScores = scorer.calculateProjectScores(allDocuments, results, gitTracker, graph);
         }
     }
     // Run vector search if enabled
@@ -159,7 +170,7 @@ export async function run(config) {
         if (config.verbose) {
             console.log('  Indexing documentation sections...');
         }
-        await vectorSearch.indexDocumentation(documents);
+        await vectorSearch.indexDocumentation(allDocuments);
         // Ensure source index is built (may already be built if graph is enabled)
         if (!codePatternValidator.getSourceIndex()) {
             if (config.verbose) {
@@ -197,6 +208,14 @@ export async function run(config) {
     }
     // Generate reports
     await generateReports(results, config, graph, gitTracker, freshnessScores, vectorMismatches);
+    // Persist only after validation and reporting complete; findings make the next run revalidate everything.
+    if (incrementalChecker) {
+        const clean = results.documents.length === 0 &&
+            !results.vectorMismatches?.length &&
+            !validationEngine.hadInvalidResults() &&
+            !validationEngine.hadIncompleteValidation();
+        await incrementalChecker.saveState(clean);
+    }
     return results;
 }
 /**

package/dist/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}

package/dist/runner.test.js

@@ -1,6 +1,10 @@
 import fs from 'fs';
+import os from 'os';
 import path from 'path';
+import { glob } from 'glob';
 import { run, runWithConfig } from './runner.js';
+import { ValidationEngine } from './validators/validationEngine.js';
+import { IncrementalChecker } from './utils/incremental.js';
 import { withOutputFile } from './test-utils/tempFiles.js';
 import { captureConsoleLog, captureConsoleWarn } from './test-utils/console.js';
 vi.mock('fastembed', () => ({
@@ -33,6 +37,19 @@ describe('runner', () => {
     ];
     const captureLog = captureConsoleLog;
     const captureWarn = captureConsoleWarn;
+    const mockDocumentScan = (docPath) => {
+        vi.mocked(glob).mockResolvedValueOnce([docPath]);
+    };
+    const withIncrementalRoot = async (name, test) => {
+        const rootDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), `runner-inc-${name}-`));
+        try {
+            await test(rootDir);
+        }
+        finally {
+            vi.mocked(glob).mockResolvedValue([]);
+            await fs.promises.rm(rootDir, { recursive: true, force: true });
+        }
+    };
     const baseConfig = {
         rootDir: process.cwd(),
         include: [],
@@ -55,6 +72,17 @@ describe('runner', () => {
         reporters: [],
         verbose: false,
     };
+    const incrementalConfig = (rootDir, overrides = {}) => ({
+        ...baseConfig,
+        rootDir,
+        include: ['*.md'],
+        sourcePatterns: [],
+        manifestFiles: [],
+        incremental: { enabled: true },
+        cache: { enabled: false, dir: '.cache' },
+        ...overrides,
+        rules: { ...baseConfig.rules, ...overrides.rules },
+    });
     afterAll(async () => {
         await Promise.all(transientCacheDirs.map((dir) => fs.promises.rm(path.join(process.cwd(), dir), { recursive: true, force: true }).catch(() => { })));
     });
@@ -245,7 +273,7 @@ describe('runner', () => {
         });
     });
     describe('incremental mode', () => {
-        it('filters changed files with verbose logging', async () => {
+        it('reports changed files in verbose mode', async () => {
             const spy = captureLog();
             await run({
                 ...baseConfig,
@@ -255,6 +283,410 @@ describe('runner', () => {
             });
             expect(spy.mock.calls.flat().join('\n')).toContain('Incremental');
         });
+        it('skips a second clean run with default validator configuration', async () => {
+            await withIncrementalRoot('defaults', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const targetPath = path.join(rootDir, 'target.ts');
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                await fs.promises.writeFile(targetPath, 'export const target = true;');
+                const config = {
+                    rootDir,
+                    include: ['*.md'],
+                    incremental: { enabled: true },
+                    graph: { enabled: false },
+                    cache: { enabled: false, dir: '.cache' },
+                    reporters: [],
+                };
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+            });
+        });
+        it('allows reuse when git tracking is enabled without freshness scoring', async () => {
+            await withIncrementalRoot('git-only', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const targetPath = path.join(rootDir, 'target.ts');
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                await fs.promises.writeFile(targetPath, 'export const target = true;');
+                const config = incrementalConfig(rootDir, {
+                    git: { enabled: true },
+                    rules: { 'file-path': { enabled: true } },
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+            });
+        });
+        it('reuses expected skips but revalidates when a disabled unsafe rule is enabled', async () => {
+            await withIncrementalRoot('disabled-rule', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                await fs.promises.writeFile(docPath, '[site](https://example.com)');
+                const config = incrementalConfig(rootDir, {
+                    rules: { 'external-url': { enabled: false } },
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.skipped).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+                mockDocumentScan(docPath);
+                expect((await run({ ...config, rules: { ...config.rules, 'external-url': { enabled: true } } })).summary.total).toBe(1);
+            });
+        });
+        it('reuses a clean run containing an illustrative safe-rule skip', async () => {
+            await withIncrementalRoot('illustrative-skip', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                await fs.promises.writeFile(docPath, '[example](YourProject/file.ts)');
+                const config = incrementalConfig(rootDir, {
+                    rules: { 'file-path': { enabled: true, skipIllustrative: true } },
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.skipped).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+            });
+        });
+        it('keeps state dirty when a validator is missing or throws', async () => {
+            await withIncrementalRoot('incomplete', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const cacheDir = path.join(rootDir, '.cache');
+                await fs.promises.writeFile(docPath, 'unknown input');
+                const unknownExtractor = {
+                    type: 'unknown-type',
+                    supportedFormats: ['markdown'],
+                    supportsFormat: () => true,
+                    extract: (document) => [{ type: 'unknown-type', value: 'value', lineNumber: 1, raw: 'value', sourceFile: document.path }],
+                    findLineNumber: () => 1,
+                    getContext: () => '',
+                };
+                const missingConfig = incrementalConfig(rootDir, { customExtractors: [unknownExtractor] });
+                mockDocumentScan(docPath);
+                await run(missingConfig);
+                expect(JSON.parse(await fs.promises.readFile(path.join(cacheDir, 'file-hashes.json'), 'utf-8')).clean).toBe(false);
+                const throwingValidator = {
+                    async validateBatch() {
+                        throw new Error('validator failed');
+                    },
+                };
+                const throwingConfig = incrementalConfig(rootDir, {
+                    customValidators: { 'file-path': throwingValidator },
+                    rules: { 'file-path': { enabled: true } },
+                });
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                mockDocumentScan(docPath);
+                await run(throwingConfig);
+                expect(JSON.parse(await fs.promises.readFile(path.join(cacheDir, 'file-hashes.json'), 'utf-8')).clean).toBe(false);
+            });
+        });
+        it('revalidates unchanged docs when a referenced source file is renamed', async () => {
+            await withIncrementalRoot('source', async (rootDir) => {
+                const docsDir = path.join(rootDir, 'docs');
+                const sourceDir = path.join(rootDir, 'src');
+                const docPath = path.join(docsDir, 'guide.md');
+                const sourcePath = path.join(sourceDir, 'server.ts');
+                const renamedSourcePath = path.join(sourceDir, 'renamed.ts');
+                const cacheDir = path.join(rootDir, '.cache');
+                await fs.promises.mkdir(docsDir, { recursive: true });
+                await fs.promises.mkdir(sourceDir, { recursive: true });
+                await fs.promises.writeFile(docPath, '[source](../src/server.ts)');
+                await fs.promises.writeFile(sourcePath, 'export const server = true;');
+                const config = incrementalConfig(rootDir, {
+                    include: ['docs/**/*.md'],
+                    sourcePatterns: ['src/**/*.ts'],
+                    rules: { 'file-path': { enabled: true } },
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.errors).toBe(0);
+                await expect(fs.promises.access(path.join(cacheDir, 'file-hashes.json'))).resolves.toBeUndefined();
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+                await fs.promises.rename(sourcePath, renamedSourcePath);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.errors).toBe(1);
+                const stateFile = path.join(cacheDir, 'file-hashes.json');
+                expect(JSON.parse(await fs.promises.readFile(stateFile, 'utf-8')).clean).toBe(false);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.errors).toBe(1);
+            });
+        });
+        it('reuses the code-pattern source index and fingerprints excluded source matches', async () => {
+            await withIncrementalRoot('code-pattern-source', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const sourceDir = path.join(rootDir, '.git');
+                const sourcePath = path.join(sourceDir, 'source.ts');
+                await fs.promises.mkdir(sourceDir);
+                await fs.promises.writeFile(docPath, ['```typescript', 'class StableService {}', '```'].join('\n'));
+                await fs.promises.writeFile(sourcePath, 'export class StableService {}');
+                const config = incrementalConfig(rootDir, {
+                    sourcePatterns: ['.g{it,noop}/**/*.ts'],
+                    rules: { 'code-pattern': { enabled: true, severity: 'warning' } },
+                });
+                const mockScans = () => {
+                    mockDocumentScan(docPath);
+                    vi.mocked(glob).mockResolvedValueOnce([sourcePath]);
+                };
+                mockScans();
+                expect((await run(config)).summary.warnings).toBe(0);
+                mockScans();
+                expect((await run(config)).summary.total).toBe(0);
+                await fs.promises.writeFile(sourcePath, 'export class ReplacementService {}');
+                mockScans();
+                expect((await run(config)).summary.warnings).toBe(1);
+            });
+        });
+        it('captures graph-only source inputs once per run and skips unchanged validation', async () => {
+            await withIncrementalRoot('graph-source', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const sourceDir = path.join(rootDir, 'src');
+                const sourcePath = path.join(sourceDir, 'source.ts');
+                await fs.promises.mkdir(sourceDir);
+                await fs.promises.writeFile(docPath, 'No code-pattern references');
+                await fs.promises.writeFile(sourcePath, 'export class GraphSource {}');
+                const config = incrementalConfig(rootDir, {
+                    graph: { enabled: true },
+                    sourcePatterns: ['src/**/*.ts'],
+                });
+                const mockScans = () => {
+                    mockDocumentScan(docPath);
+                    vi.mocked(glob).mockResolvedValueOnce([sourcePath]);
+                };
+                const validateSpy = vi.spyOn(ValidationEngine.prototype, 'validate');
+                const readSpy = vi.spyOn(fs.promises, 'readFile');
+                vi.mocked(glob).mockClear();
+                try {
+                    mockScans();
+                    await run(config);
+                    mockScans();
+                    await run(config);
+                    expect(validateSpy.mock.calls[0][0]).toHaveLength(1);
+                    expect(validateSpy.mock.calls[1][0]).toEqual([]);
+                    expect(vi.mocked(glob).mock.calls.filter(([pattern]) => pattern === 'src/**/*.ts')).toHaveLength(2);
+                    expect(readSpy.mock.calls.filter(([file]) => file === sourcePath)).toHaveLength(2);
+                }
+                finally {
+                    validateSpy.mockRestore();
+                    readSpy.mockRestore();
+                }
+            });
+        });
+        it('bypasses incremental inventory for an empty graph-enabled scan', async () => {
+            await withIncrementalRoot('empty-graph', async (rootDir) => {
+                const sourceDir = path.join(rootDir, 'src');
+                const sourcePath = path.join(sourceDir, 'source.ts');
+                await fs.promises.mkdir(sourceDir);
+                await fs.promises.writeFile(sourcePath, 'export class GraphSource {}');
+                const config = incrementalConfig(rootDir, {
+                    graph: { enabled: true },
+                    sourcePatterns: ['src/**/*.ts'],
+                });
+                const filterSpy = vi.spyOn(IncrementalChecker.prototype, 'filterChanged');
+                const readSpy = vi.spyOn(fs.promises, 'readFile');
+                vi.mocked(glob).mockClear();
+                try {
+                    vi.mocked(glob).mockResolvedValueOnce([]).mockResolvedValueOnce([sourcePath]);
+                    await run(config);
+                    expect(filterSpy).not.toHaveBeenCalled();
+                    await expect(fs.promises.access(path.join(rootDir, '.cache', 'file-hashes.json'))).rejects.toThrow();
+                    expect(vi.mocked(glob).mock.calls.filter(([pattern]) => pattern === 'src/**/*.ts')).toHaveLength(1);
+                    expect(readSpy.mock.calls.filter(([file]) => file === sourcePath)).toHaveLength(1);
+                }
+                finally {
+                    filterSpy.mockRestore();
+                    readSpy.mockRestore();
+                }
+            });
+        });
+        it('revalidates code-snippet fallbacks under excluded directories', async () => {
+            await withIncrementalRoot('snippet', async (rootDir) => {
+                const docsDir = path.join(rootDir, 'docs');
+                const dependencyDir = path.join(rootDir, 'node_modules');
+                const docPath = path.join(docsDir, 'guide.md');
+                const sourcePath = path.join(dependencyDir, 'generated.js');
+                await fs.promises.mkdir(docsDir);
+                await fs.promises.mkdir(dependencyDir);
+                await fs.promises.writeFile(docPath, "```js\nimport * as generated from '../node_modules/generated';\n```");
+                await fs.promises.writeFile(sourcePath, 'export const generated = true;');
+                const config = incrementalConfig(rootDir, {
+                    include: ['docs/**/*.md'],
+                    rules: { 'code-snippet': { enabled: true } },
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.warnings).toBe(0);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                await fs.promises.rm(sourcePath);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.warnings).toBe(1);
+            });
+        });
+        it('revalidates unchanged docs after an unreported info finding', async () => {
+            await withIncrementalRoot('info', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const cacheDir = path.join(rootDir, '.cache');
+                await fs.promises.writeFile(docPath, 'Install `missingpkg`.');
+                await fs.promises.writeFile(path.join(rootDir, 'package.json'), '{}');
+                const config = incrementalConfig(rootDir, {
+                    manifestFiles: ['package.json'],
+                    rules: { dependency: { enabled: true, severity: 'info' } },
+                    cache: { enabled: false, dir: cacheDir },
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                expect(JSON.parse(await fs.promises.readFile(path.join(cacheDir, 'file-hashes.json'), 'utf-8')).clean).toBe(false);
+            });
+        });
+        it('revalidates after generated output changes the project inventory', async () => {
+            await withIncrementalRoot('output', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const targetPath = path.join(rootDir, 'target.ts');
+                const outputPath = path.join(rootDir, 'report.json');
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                await fs.promises.writeFile(targetPath, 'export const target = true;');
+                const config = incrementalConfig(rootDir, {
+                    rules: { 'file-path': { enabled: true } },
+                    reporters: ['json'],
+                    outputPath,
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+            });
+        });
+        it.each(['markdown', 'enhanced'])('skips unchanged docs when %s output is inside rootDir', async (reporter) => {
+            await withIncrementalRoot(`output-${reporter}`, async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const targetPath = path.join(rootDir, 'target.ts');
+                const outputPath = path.join(rootDir, `${reporter}.out`);
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                await fs.promises.writeFile(targetPath, 'export const target = true;');
+                const config = incrementalConfig(rootDir, {
+                    rules: { 'file-path': { enabled: true } },
+                    reporters: [reporter],
+                    outputPath,
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                await expect(fs.promises.access(outputPath)).resolves.toBeUndefined();
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+            });
+        });
+        it.each([
+            { reporters: ['markdown', 'json'], expectedTotals: [1, 1, 0, 1] },
+            { reporters: ['json', 'markdown'], expectedTotals: [1, 0, 0, 0] },
+        ])('keeps mixed reporter ordering stable for incremental output', async ({ reporters, expectedTotals }) => {
+            await withIncrementalRoot(`mixed-output-${reporters.join('-')}`, async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const targetPath = path.join(rootDir, 'target.ts');
+                const outputPath = path.join(rootDir, 'report.out');
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                await fs.promises.writeFile(targetPath, 'export const target = true;');
+                const config = incrementalConfig(rootDir, {
+                    rules: { 'file-path': { enabled: true } },
+                    reporters,
+                    outputPath,
+                });
+                const totals = [];
+                for (let runNumber = 0; runNumber < expectedTotals.length; runNumber++) {
+                    mockDocumentScan(docPath);
+                    totals.push((await run(config)).summary.total);
+                }
+                expect(totals).toEqual(expectedTotals);
+            });
+        });
+        it('does not throw for markdown reporting without outputPath', async () => {
+            await withIncrementalRoot('markdown-stdout', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                await fs.promises.writeFile(docPath, 'No references');
+                const config = incrementalConfig(rootDir, { reporters: ['markdown'] });
+                const log = captureLog();
+                try {
+                    mockDocumentScan(docPath);
+                    await expect(run(config)).resolves.toBeDefined();
+                }
+                finally {
+                    log.mockRestore();
+                }
+            });
+        });
+        it('revalidates when reporting mutates a validation input', async () => {
+            await withIncrementalRoot('output-overlap', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const targetPath = path.join(rootDir, 'target.ts');
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                await fs.promises.writeFile(targetPath, 'export const target = true;');
+                const config = incrementalConfig(rootDir, {
+                    rules: { 'file-path': { enabled: true } },
+                    reporters: ['json'],
+                    outputPath: targetPath,
+                });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+            });
+        });
+        it('excludes lexical and real symlinked cache directories', async () => {
+            await withIncrementalRoot('cache-link', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const targetPath = path.join(rootDir, 'target.ts');
+                const realCacheDir = path.join(rootDir, '.real-cache');
+                await fs.promises.writeFile(docPath, '[target](target.ts)');
+                await fs.promises.writeFile(targetPath, 'export const target = true;');
+                await fs.promises.mkdir(realCacheDir);
+                await fs.promises.symlink('.real-cache', path.join(rootDir, '.cache'), 'dir');
+                const config = incrementalConfig(rootDir, { rules: { 'file-path': { enabled: true } } });
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(1);
+                await expect(fs.promises.access(path.join(realCacheDir, 'file-hashes.json'))).resolves.toBeUndefined();
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.total).toBe(0);
+            });
+        });
+        it('does not advance state when validation or reporting throws', async () => {
+            await withIncrementalRoot('report', async (rootDir) => {
+                const docPath = path.join(rootDir, 'guide.md');
+                const cacheDir = path.join(rootDir, '.cache');
+                await fs.promises.writeFile(docPath, 'No references');
+                const config = incrementalConfig(rootDir, {
+                    rules: { 'file-path': { enabled: true } },
+                    cache: { enabled: false, dir: cacheDir },
+                });
+                mockDocumentScan(docPath);
+                await run(config);
+                const stateFile = path.join(cacheDir, 'file-hashes.json');
+                const baselineState = await fs.promises.readFile(stateFile, 'utf-8');
+                await fs.promises.writeFile(docPath, '[missing](missing.ts)');
+                const validateSpy = vi.spyOn(ValidationEngine.prototype, 'validate').mockRejectedValueOnce(new Error('validation failed'));
+                try {
+                    mockDocumentScan(docPath);
+                    await expect(run(config)).rejects.toThrow('validation failed');
+                    expect(await fs.promises.readFile(stateFile, 'utf-8')).toBe(baselineState);
+                }
+                finally {
+                    validateSpy.mockRestore();
+                }
+                mockDocumentScan(docPath);
+                await expect(run({
+                    ...config,
+                    reporters: ['json'],
+                    outputPath: rootDir,
+                })).rejects.toThrow();
+                expect(await fs.promises.readFile(stateFile, 'utf-8')).toBe(baselineState);
+                mockDocumentScan(docPath);
+                expect((await run(config)).summary.errors).toBe(1);
+            });
+        });
     });
     it('loads URL cache when cache is enabled', async () => {
         const cacheDir = '.doc-freshness-cache/runner-url';