capacium-models

Shared domain models for the Capacium ecosystem. Used by capacium-exchange and capacium-crawler.

Installation

pip install capacium-models

Models

The package-level TRUST_BADGES and get_trust_badge() exports retain the rich badge metadata introduced in v0.4.0. UI-facing canonical text labels, including the string-only trust labels, live in capacium_models.labels.

Usage

from capacium_models import Listing, TrustState, TrustMachine

# Create a discovered listing
listing = Listing(
    canonical_name="org/my-mcp-server",
    package_type="mcp-server",
    canonical_source_url="https://github.com/org/my-mcp-server",
    short_description="A cool MCP server",
    trust_state=TrustState.DISCOVERED,
)

# Transition through trust states
machine = TrustMachine()
if machine.can_transition(listing.trust_state, TrustState.PENDING_REVIEW):
    listing = machine.transition(
        listing,
        TrustState.PENDING_REVIEW,
        "Validated metadata",
    )

Dependencies

Zero runtime dependencies — stdlib only (dataclasses, enum, uuid, datetime, json, typing).

License

MIT

Development

Canonical repository: self-hosted Forgejo — git.langevc.com/capacium/capacium-models (git clone git@git.langevc.com:capacium/capacium-models.git). Develop against the Forgejo clone and open pull requests there. The GitHub copy is a read-only mirror.