9f0d785b61
* fix(#2020): remove dead SDK file refs that triggered infinite find.exe on Windows gsd-executor.md referenced sdk/src/query/QUERY-HANDLERS.md and reapply-patches.md referenced sdk/dist/cli.js — both retired with the SDK (ADR-0174). AI runtimes that locate doc refs via filesystem search ran find /, which on Git Bash for Windows traverses the whole drive (14h+, orphaned find.exe, 4M+ handles). - agents/gsd-executor.md: drop dead QUERY-HANDLERS.md ref. - workflows/reapply-patches.md: drop dead sdk/dist/cli.js clause. - tests/no-dead-sdk-refs.test.cjs: regression guard — no sdk/src|dist|handlers file refs in agents/workflows/references markdown. Closes #2020 * docs(#2020): backfill changeset pr 2027
55 lines
2.2 KiB
JavaScript
55 lines
2.2 KiB
JavaScript
'use strict';
|
|
|
|
// Regression guard for #2020 — dead SDK file references (sdk/src/..., sdk/dist/...)
|
|
// in runtime-loaded markdown cause AI runtimes to `find` them; on Git Bash for
|
|
// Windows `find /` traverses the whole drive (14h+, orphaned find.exe, 4M+ handles).
|
|
// The SDK package was retired (ADR-0174), so these paths never resolve.
|
|
//
|
|
// Scans the markdown a runtime loads + tries to locate references in
|
|
// (agents/, workflows/, references/) and fails on any sdk/(src|dist|handlers)
|
|
// file-path reference. Code-comment mentions in *.cjs (historical prose, not
|
|
// locatable file refs) are out of scope.
|
|
|
|
const { describe, test } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('fs');
|
|
const path = require('path');
|
|
|
|
const ROOT = path.join(__dirname, '..');
|
|
// Runtime-loaded markdown surfaces (the issue is about references a runtime
|
|
// tries to LOCATE as files — agents/workflows/references, not source comments).
|
|
const SCAN_DIRS = ['agents', 'gsd-core/workflows', 'gsd-core/references'];
|
|
// A dead SDK file-path reference: sdk/src|sdk/dist|sdk/handlers followed by a path.
|
|
const DEAD_SDK_REF = /sdk\/(?:src|dist|handlers)\//;
|
|
|
|
function walkMd(dir, out = []) {
|
|
let entries;
|
|
try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
|
|
catch { return out; }
|
|
for (const e of entries) {
|
|
const full = path.join(dir, e.name);
|
|
if (e.isDirectory()) walkMd(full, out);
|
|
else if (e.isFile() && e.name.endsWith('.md')) out.push(full);
|
|
}
|
|
return out;
|
|
}
|
|
|
|
describe('#2020 — no dead SDK file references in runtime-loaded markdown', () => {
|
|
const offenders = [];
|
|
for (const rel of SCAN_DIRS) {
|
|
const absDir = path.join(ROOT, rel);
|
|
for (const file of walkMd(absDir)) {
|
|
const content = fs.readFileSync(file, 'utf8');
|
|
const lines = content.split(/\r?\n/);
|
|
lines.forEach((line, i) => {
|
|
if (DEAD_SDK_REF.test(line)) offenders.push(`${path.relative(ROOT, file)}:${i + 1}`);
|
|
});
|
|
}
|
|
}
|
|
|
|
test('agents/workflows/references contain no sdk/src|sdk/dist|sdk/handlers references', () => {
|
|
assert.deepEqual(offenders, [],
|
|
`Dead SDK file references found (runtimes \`find\` these → #2020 Windows find.exe storm):\n${offenders.join('\n')}`);
|
|
});
|
|
});
|