Přeskočit na obsah

npm run build:tooling-catalog — Generátor katalogu toolingu

Generátor katalogu toolingu: Staví katalog příkazů ze dvou záměrně oddělených vstupů: ručně psaných záznamů v data/tooling/*.json (co příkaz dělá, co vynucuje, kdy ho spustit) a SKUTEČNOSTI dopočítané z package.json, scripts/build/pipeline.mjs, .githooks/pre-commit, justfile a .claude/skills/**/SKILL.md.. npm skript, generování.

npm skript generování shodí běh pipeline: build pipeline: dev

Volání

npm run build:tooling-catalog

Spustí node scripts/build/build-tooling-catalog.mjs (čteno z package.json při buildu)

Zdroj: scripts/build/build-tooling-catalog.mjs

Staví katalog příkazů ze dvou záměrně oddělených vstupů: ručně psaných záznamů v data/tooling/*.json (co příkaz dělá, co vynucuje, kdy ho spustit) a SKUTEČNOSTI dopočítané z package.json, scripts/build/pipeline.mjs, .githooks/pre-commit, justfile a .claude/skills/**/SKILL.md.

Kdy ho spustit

Po přidání nebo přejmenování jakéhokoli npm skriptu, just receptu či skillu — a po každé editaci záznamu v data/tooling/.

Co shodí běh

  • G1–G6 stejně jako verify:tooling-catalog — audit běží v obou režimech, takže ani generátor nedoběhne nad katalogem, který neodpovídá repozitáři.
  • Záznam v data/tooling/, který neodpovídá schematu tooling-command, nebo jehož identifier se liší od názvu souboru.

Co je potřeba vědět

  • Ručně se píše jen to, co se ze zdrojů odvodit nedá. Příkazová řádka, zařazení do pipeline, členství v pre-commitu, cíl just receptu ani frontmatter skillu se do dat nezapisují — dopočítávají se, aby katalog nemohl tvrdit něco jiného, než co repozitář spouští.
  • Zápis je idempotentní: soubor se přepíše, jen když se jeho obsah liší.

Vstupy a výstupy

Čte

  • data/tooling/*.json
  • package.json
  • justfile
  • .claude/skills/*/SKILL.md
  • scripts/build/pipeline.mjs
  • .githooks/pre-commit
  • schemas/canonical/tooling-command.schema.json

Zapisuje

  • data/generated/tooling-catalog.json
  • content/dokumentace/prikazy/_index.md
  • content/dokumentace/prikazy/<id>.md
  • docs/TOOLING.md

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.