📢 Notice: This repository is a Component Submodule of the Vindicta Platform Monorepo. For local development, testing, and dependency resolution, please clone the root vindicta-platform repository.

The central hub and core pillar of the Vindicta Platform. This repository provides the axiomatic base models, shared kernel logic, and constitutional documentation that all other Vindicta microservices, agents, and clients depend upon.

uv sync

• VindictaModel: Pydantic V2 base model for all entities.
• EntropyProof: Cryptographic verification for random events.
• GasTankState: Economic state tracking.

uv run pytest --cov
uv run behave

Coverage Mandate: ≥90%

• ⚖️ The Constitution: The supreme law and Zero-Order Axioms.
• 🏗️ ADRs: Architectural Decision Records.
• 🗺️ C4 Models: System architecture diagrams.
• 📚 Core Concepts: Deep dives into WARScribe and platform logic.