singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

chore(doc-checker): allowlist intentionally-short scaffold files

Browse source 
The doc-checker startup hook prints a "9 files need content" advisory on
every autonomous bootstrap. The flagged files are intentionally terse:
- AGENTS.md indices under docs/ and .sf/harness/* point at sibling
  directories where the real content lives
- .sf/PRINCIPLES.md / STYLE.md / NON-GOALS.md are terse-by-design bullet
  lists; the # heading line is stripped by countContentLines so a 9-bullet
  file falls one short of the 10-line threshold despite being substantive

Adding them to STUB_ALLOWED_PATHS so the advisory only flags genuinely
unfilled scaffolds.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Mikael Hugo 2026-05-15 04:43:18 +02:00
parent 3faa599f9d
commit ffcd3d1157
1 changed files with 14 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
src/resources/extensions/sf/doc-checker.js
View file

@ -26,6 +26,20 @@ const STUB_ALLOWED_PATHS = new Set([
"docs/exec-plans/active/index.md",
"docs/exec-plans/completed/index.md",
"docs/records/index.md",
// AGENTS.md scaffolds that are intentionally short index/header files
// pointing at the actual content in sibling directories.
"docs/AGENTS.md",
"docs/records/AGENTS.md",
".sf/harness/AGENTS.md",
".sf/harness/specs/AGENTS.md",
".sf/harness/evals/AGENTS.md",
".sf/harness/graders/AGENTS.md",
// Top-level .sf/ project meta-files: terse-by-design bullet lists. The
// `# Heading` line is stripped by countContentLines so a 9-bullet file
// counts as 9 content lines — sub-threshold but substantive.
".sf/PRINCIPLES.md",
".sf/STYLE.md",
".sf/NON-GOALS.md",
]);
// Minimum lines considered "real content" vs stub. Template stubs are ~3-8 lines.
const STUB_LINE_COUNT = 10;