60 lines
2.3 KiB
TypeScript
60 lines
2.3 KiB
TypeScript
|
/**
|
||
|
|
* Golden parity dump — S1 `op-design-lint` parity oracle.
|
||
|
|
*
|
||
|
|
* Reads every hand-authored `PenDocument` fixture under
|
||
|
|
* `crates/op-design-lint/tests/fixtures/docs/`, runs the TS `detectAllIssues`
|
||
|
|
* (the parity oracle), and writes the resulting `Issue[]` as pretty JSON to
|
||
|
|
* `crates/op-design-lint/tests/fixtures/golden/<same-name>.json`.
|
||
|
|
*
|
||
|
|
* The Rust `tests/parity.rs` then asserts `op_design_lint::detect_all`
|
||
|
|
* structurally matches each committed golden file. A CI drift-guard job
|
||
|
|
* re-runs this script and fails if the regenerated golden differs from the
|
||
|
|
* committed copy (spec §8, Risk R4).
|
||
|
|
*
|
||
|
|
* Run: bun run tools/dump-diagnostics-golden.ts
|
||
|
|
*
|
||
|
|
* Each fixture is a single-page `PenDocument`; its lone root node
|
||
|
|
* (`doc.children[0]`) is the subtree `detectAllIssues` walks — matching how
|
||
|
|
* the Rust parity test feeds `detect_all`.
|
||
|
|
*/
|
||
|
|
import { readdirSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
|
||
|
|
import { join, dirname } from 'node:path';
|
||
|
|
import { fileURLToPath } from 'node:url';
|
||
|
|
import { detectAllIssues } from '@zseven-w/pen-ai-skills';
|
||
|
|
import type { PenDocument, PenNode } from '@zseven-w/pen-types';
|
||
|
|
|
||
|
|
const here = dirname(fileURLToPath(import.meta.url));
|
||
|
|
const fixturesRoot = join(here, '..', 'crates', 'op-design-lint', 'tests', 'fixtures');
|
||
|
|
const docsDir = join(fixturesRoot, 'docs');
|
||
|
|
const goldenDir = join(fixturesRoot, 'golden');
|
||
|
|
|
||
|
|
mkdirSync(goldenDir, { recursive: true });
|
||
|
|
|
||
|
|
const fixtureFiles = readdirSync(docsDir)
|
||
|
|
.filter((name) => name.endsWith('.json'))
|
||
|
|
.sort();
|
||
|
|
|
||
|
|
if (fixtureFiles.length === 0) {
|
||
|
|
throw new Error(`no fixture docs found under ${docsDir}`);
|
||
|
|
}
|
||
|
|
|
||
|
|
let total = 0;
|
||
|
|
for (const file of fixtureFiles) {
|
||
|
|
const docPath = join(docsDir, file);
|
||
|
|
const doc = JSON.parse(readFileSync(docPath, 'utf8')) as PenDocument;
|
||
|
|
|
||
|
|
const root = doc.children?.[0] as PenNode | undefined;
|
||
|
|
if (!root) {
|
||
|
|
throw new Error(`fixture ${file} has no root node in doc.children[0]`);
|
||
|
|
}
|
||
|
|
|
||
|
|
const issues = detectAllIssues(root, doc);
|
||
|
|
const goldenPath = join(goldenDir, file);
|
||
|
|
// Trailing newline so the file is POSIX-clean and `git diff` stays quiet.
|
||
|
|
writeFileSync(goldenPath, JSON.stringify(issues, null, 2) + '\n', 'utf8');
|
||
|
|
total += issues.length;
|
||
|
|
console.log(`${file}: ${issues.length} issue(s)`);
|
||
|
|
}
|
||
|
|
|
||
|
|
console.log(`\nwrote ${fixtureFiles.length} golden file(s), ${total} issue(s) total`);
|