// Command reference
simforge catalog
Generated from the CLI's own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the reference index.
simforge catalog batch
Resumable catalog materialisation + simulation with an attempt ledger
simforge catalog batch [OPTIONS] <CATALOG>
Runs on: local runtime
| Argument / flag | Notes | What |
|---|---|---|
| <catalog> | required | The catalog manifest (its slot statuses are updated in place) |
| --ledger FILE | The attempt ledger (default: catalog-execution-ledger.json beside the catalog) | |
| --slots IDS | Only these slot identities, comma-separated | |
| --map MAP | Only slots on this map | |
| --maps MAPS | Only slots on these maps, comma-separated | |
| --mechanisms IDS | Only these incident mechanisms, comma-separated | |
| --attempts N | Attempts per slot, 1 to 100 (default 3) | |
| --concurrency N | Parallel slots, 1 to 32 (default: min(4, CPUs)) | |
| --force | Start a fresh ledger instead of resuming | |
| --filter MODE | Evaluation filter: critical | negative-control | all | |
| --trivial-ttc SECONDS | Time-to-collision (s) below which a conflict counts as trivial | |
| --allow-collisions | Accept attempts whose simulation collided | |
| --require-full-coverage | Refuse a catalog that does not cover every taxonomy mechanism (default: run it and report the gap as coverage) |
simforge catalog create
Reserve exactly 100 deterministic scenario identities per selected installed map (mechanisms no map can host are reported as coverage, exit 0)
simforge catalog create [OPTIONS]
Runs on: local runtime
| Argument / flag | Notes | What |
|---|---|---|
| --out FILE | Write the catalog manifest here | |
| --map MAP | One installed map | |
| --maps MAPS | Several installed maps, comma-separated, in this order (default: every installed map) | |
| --dev-assets DIR | The installed-maps directory (default: SCEN_DEV_ASSETS, else <maps root>/dev-assets) | |
| --namespace NAME | Identity namespace mixed into every seed | |
| --evidence-root DIR | Evidence directory, relative to the catalog file (default: evidence) | |
| --require-full-coverage | Fail (exit 2, incomplete_mechanism_coverage) when the maps cannot cover every taxonomy mechanism. Default: write the catalog and report the gap as coverage |
simforge catalog verify
Reject catalog identity, cardinality, provenance or evidence gaps (exit 2); uncovered mechanisms are reported as coverage unless --require-full-coverage
simforge catalog verify [OPTIONS] <CATALOG>
Runs on: local runtime
| Argument / flag | Notes | What |
|---|---|---|
| <catalog> | required | The catalog manifest |
| --evidence-root DIR | Where the evidence tree physically is (default: beside the manifest) | |
| --require-evidence | Require every evidence file, not only those implied by slot status | |
| --require-full-coverage | Fail (exit 2, insufficient_taxonomy_breadth) when the catalog does not cover every taxonomy mechanism. Default: report the gap as coverage |