Přeskočit na obsah

npm run build:source-catalog — Generátor katalogu zdrojů

Generátor katalogu zdrojů: Staví katalog zdrojů ze dvou záměrně oddělených vstupů: ručně psaných záznamů o registrech (co dokládají, co nedokládají, jaké mají pasti) a SKUTEČNĚ použitých zdrojů dopočítaných z datasetu.. npm skript, generování.

npm skript generování pipeline: build pipeline: dev

Volání

npm run build:source-catalog

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

Zdroj: scripts/dossier/build-source-catalog.mjs

Staví katalog zdrojů ze dvou záměrně oddělených vstupů: ručně psaných záznamů o registrech (co dokládají, co nedokládají, jaké mají pasti) a SKUTEČNĚ použitých zdrojů dopočítaných z datasetu.

Kdy ho spustit

V build i dev pipeline; ručně po editaci data/source-catalog/*.json — jinak spadne verify:source-catalog.

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

  • Seznam „co bylo kdy použito“ se nikdy nepíše ručně, aby nemohl zastarat proti datům.
  • Zápis je idempotentní: soubor se přepíše jen tehdy, když se jeho obsah liší.

Vstupy a výstupy

Čte

  • data/source-catalog/*.json
  • data/dossiers/*/sources/*.json
  • schemas/canonical/source-catalog-entry.schema.json

Zapisuje

  • data/generated/source-catalog.json
  • content/zdroje/_index.md
  • content/zdroje/<slug>.md
  • docs/osint/SOURCE_CATALOG.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.