the-mindscape-of-bro-tsong/scripts/README.md

1.2 KiB

Scripts

This folder contains simple local scripts for validation and selector demos.

Current script:

  • validate_model_library.py
  • check_card_contract.py
  • rebuild_indexes.py
  • check_model_card_sync.py
  • run_selector_regression.py
  • run_selector_demo.py

Run:

python scripts\validate_model_library.py

The script checks JSON parsing, required model fields, unique IDs, source references, excerpt references, regression case model references, and model/card index drift. It writes reports/validation_report.md.

Rebuild or check model/card indexes:

python scripts\rebuild_indexes.py --write
python scripts\rebuild_indexes.py --check

The index script regenerates models/model_index.json and cards/card_index.md from model JSON, card files, and regression cases. It writes reports/index_rebuild_report.md.

Run the card contract checker:

python scripts\check_card_contract.py

Run the selector demo:

python scripts\run_selector_demo.py

Run selector regression and model/card sync checks:

python scripts\run_selector_regression.py
python scripts\check_model_card_sync.py

Prefer Python standard library before adding dependencies.