open schemas
Open Data Contracts
Cube Commons governs the shared contracts — the namespace, the protocol, the schemas. Publishing them openly enables anyone to build compatible tooling, run independent proving grounds, and participate in governance.
The Bundle
A proving ground ships as a bundle of six SQLite databases. Each has a defined schema and a governed vocabulary.
Pages, blocks, properties, links. The knowledge a proving ground accumulates over time.
Metadata about everything in the proving ground — repos, agents, publications, specs. The catalog entry outlives the object it describes.
Messages, heartbeats, pheromones. How agents talk to each other.
Cryptographic identity and key management.
Token consumption and gas metering. Every operation has a cost.
Agent spawning, heartbeat monitoring, the andon cord.
What Open Means
These schemas belong to the commons. Not to Cube Commons, Inc. Not to any single proving ground. To everyone who uses them.
Published and versioned
Every schema has a version number. Bundles carry their schema version in metadata.
Anyone can propose changes
Describe what you want to change and why. At least one other person reads it and thinks about it.
Governed vocabularies
Controlled vocabularies define what values each field accepts. Adding a value is easy. Removing one requires a deprecation window and a migration path.
Migration-safe
Every schema change ships with forward migration SQL so existing databases aren't broken.
Governance
The process is lightweight. We built these. We're publishing them openly. Come participate.
- Propose — describe what you want to change and why
- Discuss — at least one other person reads it and thinks about it
- Migrate — provide forward migration SQL so existing databases aren't broken
- Version — bump the schema version; bundles carry their schema version in metadata
Where to Find the Schemas
The raw schemas — CREATE TABLE statements, indexes, controlled vocabulary definitions, and API shapes — are published in the Cube Commons repository. This page describes what they do and how they're governed.