Kjell Tore Guttormsen
bfc79710c8
1b-premisset (ikke-advisor storfiler er Cosmo-frie, trygt å TOC-e nå) er motbevist mot ground truth: 11/12 har en `## …Cosmo…`-overskrift → en TOC bygget fra `##`-overskriftene ville emittert ny Cosmo-anker (bryter «aldri ny Cosmo-innhold»), og å nøytralisere overskriften er selve persona-fjerningen (ikke en sidehandling — scope-guard). Store-fil-TOC (de 20 filene >800 linjer, advisor + ikke-advisor) folder derfor inn i Cosmo-utfasingen. Denne committen leverer kun det gjenbrukbare verktøyet; ingen ref-filer rørt. - transform.insertToc: retrofitter `## Innhold` i en eksisterende storfil rett før første ikke-fence `## `-seksjon (samme slot som composeKbFile), robust mot de 3 legacy-header-variantene (med/uten `---`), idempotent, fence-aware. - scripts/kb-update/backfill-toc.mjs: dry-run/--write applier (ren glue rundt insertToc; transform.mjs forblir write-fri — arkitektur-invariant). - docs/cosmo-removal-brief: «Sammenfall»-seksjon dokumenterer fold-inn + bruk. - TDD: +6 transform-tester. Suite 509/509 (kb-update 355 + kb-eval 154).
51 lines
2 KiB
JavaScript
51 lines
2 KiB
JavaScript
#!/usr/bin/env node
|
|
// backfill-toc.mjs — Fase 1b applier: insert a `## Innhold` TOC into EXISTING large
|
|
// reference files via transform.insertToc. Dry-run by default; --write applies in place.
|
|
//
|
|
// transform.mjs stays pure (it never writes — architecture invariant); THIS script is
|
|
// the operator-gate-side applier, the same seam commands/kb-update.md occupies when it
|
|
// writes a composed file after the gate clears. All the logic lives in the tested
|
|
// insertToc (no-op on small/already-TOC'd files, body byte-identical) — this is glue.
|
|
//
|
|
// node scripts/kb-update/backfill-toc.mjs <file.md ...> # dry-run (report)
|
|
// node scripts/kb-update/backfill-toc.mjs --write <file.md ...> # apply in place
|
|
//
|
|
// Per file: would/write (+N lines, M sections) | skip (small or already has TOC).
|
|
// A file whose content insertToc leaves unchanged is never rewritten (no churn).
|
|
|
|
import { readFileSync, writeFileSync } from 'node:fs';
|
|
import { insertToc, buildToc } from './lib/transform.mjs';
|
|
|
|
const argv = process.argv.slice(2);
|
|
const write = argv.includes('--write');
|
|
const files = argv.filter((a) => a !== '--write');
|
|
|
|
if (files.length === 0) {
|
|
console.error('usage: backfill-toc.mjs [--write] <file.md ...>');
|
|
process.exit(2);
|
|
}
|
|
|
|
let changed = 0;
|
|
let skipped = 0;
|
|
for (const path of files) {
|
|
const before = readFileSync(path, 'utf8');
|
|
const after = insertToc(before);
|
|
if (after === before) {
|
|
skipped++;
|
|
console.log(`skip ${path} (small or already has TOC)`);
|
|
continue;
|
|
}
|
|
const addedLines = after.split('\n').length - before.split('\n').length;
|
|
const sections = (buildToc(before).match(/^- /gm) || []).length;
|
|
changed++;
|
|
if (write) {
|
|
writeFileSync(path, after);
|
|
console.log(`write ${path} (+${addedLines} lines, ${sections} sections)`);
|
|
} else {
|
|
console.log(`would ${path} (+${addedLines} lines, ${sections} sections)`);
|
|
}
|
|
}
|
|
|
|
const verb = write ? 'wrote' : 'would change';
|
|
const hint = write ? '' : ' — re-run with --write to apply';
|
|
console.log(`\n${verb} ${changed}, skipped ${skipped}${hint}`);
|