Registry

A registry answers four questions about capabilities — search, versions, latest, info — plus download_url to resolve where an archive lives. The abstract contract is heepx.registry.Registry; any class implementing its methods is a valid provider.

heepx.search("assert")
heepx.info("warrant")

hx search warrant
hx info warrant

Providers

• GitHubRegistry — the default. One capability per repository, one version per git tag, resolved against the real HeepX GitHub organization. Requires network access for a version not already cached.
• LocalRegistry — a JSON index plus local .tar.gz archives, for a private or offline mirror a caller builds and points the client at explicitly.

from heepx.registry import LocalRegistry

heepx.learn("warrant", registry=LocalRegistry(index_path=..., archive_dir=...))

Browse an unofficial, generated mirror of what's currently published at /registry — the authoritative catalogue is workspace/ECOSYSTEM.md.