This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/notes/substrate-gate-cultnet-contracts.md
2026-08-23 12:57:38 +02:00

60 lines
3 KiB
Markdown

# Substrate Gate CultNet Contract
Objective: make repository access explicit without turning Substrate Gate into a
second workflow, decision, or state-admission system. Body is the substrate;
Substrate Gate owns only the exact grant that lets a named runtime job touch a
bounded part of that substrate.
## Authority Map
- Owner: the concrete family invariant owner constructs and persists one
`SubstrateGateRepoAccessGrantReceipt` for an authenticated runtime job.
- Inputs: runtime job, worker binding, role, authority scope, fixed permitted
operations, bounded paths, and grant time.
- Output: one immutable grant receipt. Runtime validators correlate its exact
identity and envelope with the launch, tool intent, Hands intent/review, and
consequence that consumes it.
- Derived state: source lookup receipts, Body observations, Hands patch/command/
commit receipts, provider-owned editor receipts, and CultNet views report
consequences. They do not create access authority.
- Forbidden writers: models, tools, CultNet clients, and provider daemons cannot
author an Epiphany grant. A model cannot widen the paths or operations in a
persisted grant.
- Shared paths: governed source tools and Hands consequences reach their
family-specific validators through the same exact grant identity.
- Cut line: launch `authority_scope` is descriptive until bound to a persisted
grant. Substrate Gate does not own workflow requests, reviews, refusals,
snapshots, mutations, evidence admission, or Mind commits.
## Contract Family
- `epiphany.substrate_gate.repo_access_grant_receipt`: the sole Substrate Gate
document. CultNet advertises it read-only.
There is no generic access-request protocol. Family owners derive required
access from typed current work and either issue an exact grant or refuse the
operation directly. There is no generic snapshot or mutation receipt: Eyes
source receipts and Hands consequence receipts already own those facts.
## Organ Boundaries
Mind decides whether typed observations and decisions enter durable state.
Substrate Gate decides only whether a particular runtime job may touch bounded
repository substrate. Neither is an alias for the other.
Modeling may consume typed Body observations and exact RepoModel documents
directly. Eyes is involved when a claim needs evidence outside the Body; it is
not a mandatory preprocessor for Modeling. Hands consumes an adopted action
route plus an exact grant, then emits the consequence receipt Soul verifies.
Editor integration remains provider-owned. Brokkr owns Unity inspection and
actuation over Eve/CultMesh. A future Rider daemon owns Rider. Epiphany carries
no embedded Unity or Rider command organ and cannot manufacture provider
receipts on either daemon's behalf.
## Verse Boundary
The grant remains private runtime state. CultNet may project its typed contract
and operator-safe receipt view, but cannot submit or widen grants. Provider
capabilities are discovered through CultMesh; discovery does not grant local
repository access or Mind admission.