viva-catalog

The ecosystem ledger for the vivarium / process-bigraph workbench.

It answers two questions for the vivarium-workbench Registry, so a workbench can browse the whole ecosystem — not just what's installed locally — and offer Install to use:

Previously the registry lived in viva_superpowers/catalog/modules.json (the Claude-Code plugin). It moved here so the ledger is owned by a dedicated repo.

Adding a repo? Just add the viva-marketplace GitHub topic to your public repo (gh repo edit vivarium-collective/<repo> --add-topic viva-marketplace) — the nightly builder discovers it, refreshes modules.json, and scans its source into the index. No PR needed. See CONTRIBUTING.md.

How the index is built

scripts/build_ecosystem_index.py reads modules.json and, for each repo, shallow-clones it and scans the source — no published dashboard required:

• composites — @composite_generator(name=…, description=…) decorators (AST)
  • any *.composite.yaml files
• processes / steps — top-level classes whose base ends in Process / Step (AST), described by a description class attribute or the class docstring
• studies — **/studies/*/study.yaml (name + objective/title)
• investigations — **/investigations/*/investigation.yaml (name + title)

This gives complete coverage across the ecosystem whether or not a repo publishes a workbench dashboard. Repos that can't be cloned are still listed (empty artifacts, cloned: false).

python scripts/build_ecosystem_index.py            # rebuild the index locally
python scripts/build_ecosystem_index.py --only Viva-munk,pbg-copasi   # subset

Needs git + PyYAML.

Consuming the ledger

Python (viva-superpowers, vivarium-workbench):

import viva_catalog
repos = viva_catalog.load_modules()          # the repo registry
index = viva_catalog.load_ecosystem_index()  # aggregated artifacts

Over HTTP (published to gh-pages, same-origin for any published workbench):

https://vivarium-collective.github.io/viva-catalog/modules.json
https://vivarium-collective.github.io/viva-catalog/ecosystem-index.json

CI

.github/workflows/build-index.yml rebuilds ecosystem-index.json daily (and on modules.json changes), commits it to main, and publishes modules.json + the index to gh-pages.