Governance

Warning

Pre-implementation. This page describes proposed contracts. Class signatures, parameter types, schema fields, and behavior are subject to change before code lands. Once implementation exists, content here will be regenerated from docstrings or sourced from running tests.

Governance surfaces: the pre-registration store, the re-scoring log writer, and the conflict-of-interest (COI) charter scaffolding. These classes implement the ring-fence between Superpose’s foundation-model team and EMMA (Electromagnetic Multi-task Model Assessment) ops. The rationale lives in Neutrality; the schema records live on the Schemas page.

Class index

Class	Role	Purpose
PreRegistrationStore	Store	Freezes and verifies pre-registered baseline declarations
ReScoringLogWriter	Writer	Records third-party re-scoring runs
COICharter	Scaffold	Versioned charter text for the steering committee

Pre-registration store

class emma.governance.PreRegistrationStore

Freezes and verifies pre-registered baseline declarations. A PreRegistration record declares the seed backbone’s architecture and training configuration before the held-out split is unsealed, clinical-trial-style. Once frozen, the record is tamper-evident: its content hash is published and any later edit produces a different hash.

class PreRegistrationStore:
    def __init__(self, store_uri: str) -> None: ...

    def freeze(self, record: PreRegistration) -> str: ...

    def verify(self, record_hash: str) -> PreRegistration: ...

Constructor parameters

Parameter	Type	Default	Purpose
store_uri	str	required	URI of the backing storage for frozen records

Methods

freeze(record)

Records the declaration and returns its content hash. The timestamp is set server-side to prove the declaration preceded holdout unseal.

Parameter	Type	Purpose
record	PreRegistration	The declaration to freeze

Returns. str, the content hash of the frozen record.

verify(record_hash)

Looks up a frozen record by its content hash. Raises EmmaError if no record matches.

Parameter	Type	Purpose
record_hash	str	Content hash returned by freeze

Returns. The PreRegistration record.

Invariants

• Frozen records are append-only. A record cannot be edited after freeze; a correction requires a new declaration with a new hash.

• Operator submissions (from Superpose’s own model team) must carry a pre_registration_id; external submissions are not required to.

---

Re-scoring log writer

class emma.governance.ReScoringLogWriter

Records third-party re-scoring runs on the held-out split. The external co-steward re-scores Superpose’s own model on every release, and the resulting ReScoringLog entry is published so the ring-fence is auditable.

class ReScoringLogWriter:
    def __init__(self, log_uri: str) -> None: ...

    def write(self, entry: ReScoringLog) -> str: ...

Constructor parameters

Parameter	Type	Default	Purpose
log_uri	str	required	URI where re-scoring log artifacts are stored

Methods

write(entry)

Writes a re-scoring log entry and returns its URI.

Parameter	Type	Purpose
entry	ReScoringLog	The re-scoring audit entry

Returns. str, the URI of the stored log artifact.

Invariants

• Log entries are append-only and content-hashed. A re-scoring run cannot be retroactively altered; a correction requires a new entry.

• The scored_by field identifies the external co-steward so the chain of custody is visible.

---

COI charter

class emma.governance.COICharter

Versioned conflict-of-interest charter text for the steering committee. The charter defines the ring-fence between Superpose’s model team and EMMA ops, including who may grade which submission and when abstention is required. The text is versioned and content-hashed so a change to the governance rules is itself auditable.

class COICharter:
    def __init__(self, version: str, text_uri: str) -> None: ...

    @property
    def version(self) -> str: ...

    @property
    def text_uri(self) -> str: ...

    @property
    def hash(self) -> str: ...

Constructor parameters

The constructor parameters are exposed as read-only properties; the charter is immutable once loaded.

Parameter	Type	Default	Purpose
version	str	required	Charter version identifier
text_uri	str	required	URI of the charter text

Attributes

Attribute	Type	Purpose
version	str	Charter version identifier
text_uri	str	URI of the charter text
hash	str	Content hash of the charter text, computed from text_uri

Notes

• At v0.1 the charter is an operational ring-fence: a named external co-steward physically holds the test-set seed and re-scores every Superpose submission.

• At v1 a cross-community steering committee is seated, with one elder per sub-community and a formal COI policy.

• At v1 plus the benchmark transitions to an independent non-profit operator. See Neutrality.

See Also

• Neutrality: the narrative version of the ring-fence.

• Schemas: the PreRegistration and ReScoringLog record models.

• Leaderboard: the HoldoutScorer that the re-scoring log records.

• Reproducibility: the held-out secret seed the co-steward holds.