Skip to content

Commit c31f8df

Browse files
authored
Update GOVERNANCE.md
1 parent fd370bd commit c31f8df

File tree

1 file changed

+90
-106
lines changed

1 file changed

+90
-106
lines changed

GOVERNANCE.md

Lines changed: 90 additions & 106 deletions
Original file line numberDiff line numberDiff line change
@@ -1,193 +1,177 @@
1-
# GOVERNANCE — CommandLayer Protocol
1+
# GOVERNANCE — Protocol-Commons (CommandLayer)
22

3-
**Applies To:** Protocol-Commons, Protocol-Commercial, Agent-Cards
3+
**Scope:** Protocol-Commons (primary), Agent-Cards (identity bindings)
44
**Status:** v1.0.0 — Stable-Lock
55

6-
> This document is **NORMATIVE, ENFORCEABLE, AND PERMANENT**.
7-
> Governance is custodial today and **designed to decentralize** over time.
6+
> This governance is **NORMATIVE, ENFORCEABLE, AND PERMANENT**.
7+
> Control is custodial today and **designed to decentralize** as adoption grows.
88
99
---
1010

11-
## 1. Stewardship Model
11+
## 1. Mandate of Commons Governance
1212

13-
**Founding Steward:** `commandlayer.eth`
13+
Protocol-Commons governs **semantic truth**:
1414

15-
Responsible for:
16-
17-
- Maintaining canonical Commons + Commercial semantics
18-
- Publishing signed manifests + checksums
19-
- Approving normative version changes
20-
- Security revocations + provenance logging
21-
- Transparency and public accountability
22-
23-
> The Steward protects **semantic stability** until multi-party governance takes over.
24-
25-
### 1.1 Decentralization Roadmap
15+
- Canonical verbs
16+
- Request/receipt schemas
17+
- TXT semantics for schema binding
18+
- Normative version changes
19+
- Immutable historical provenance
2620

27-
| Phase | Governance | Trigger |
28-
|------|------------|---------|
29-
| 1 — Bootstrap | Single-operator Safe | Initial ecosystem adoption |
30-
| 2 — Multi-Maintainer | ≥3 independent vendors in Safe | Cross-vendor production usage |
31-
| 3 — Standards Committee | Public proposal + review | Widespread interoperability reliance |
32-
| 4 — Neutral Standards Body | Community-elected seats | Global normative standard |
21+
It MUST protect:
3322

34-
New governance participants SHALL be recruited from:
23+
- **Machine-readable meaning**
24+
- **Interoperability continuity**
25+
- **Permanent public access**
3526

36-
- ENS DAO
37-
- Ethereum Foundation contributors
38-
- Neutral infra & runtime operators
39-
- Academic and open-standards bodies
40-
41-
Vendor diversity is REQUIRED — no single affiliation may dominate control.
27+
> **Commons is the constitution of agent intent.**
28+
> Everything else derives authority from it — not the other way around.
4229
4330
---
4431

45-
## 2. Scope of Authority — NORMATIVE
32+
## 2. Strict Scope Limits — NORMATIVE
4633

47-
Governance **MAY** define:
34+
### Commons MAY govern:
35+
- Semantic contracts (schema language, grammar, behavior)
36+
- Required validation mode (strict, draft 2020-12)
37+
- TXT keys that bind semantic truth (`cl.schema.*`)
4838

49-
- Semantic contracts (Commons + Commercial schemas)
50-
- TXT semantics for identity + invocation
51-
- Transparency + versioning requirements
39+
### Commons MUST NOT govern:
40+
- Pricing or economics
41+
- Runtime topology
42+
- Execution performance or SLAs
43+
- Vendor-specific commercial logic
5244

53-
Governance **MUST NOT** dictate:
45+
Commercial and Runtime layers MUST remain **subordinate**:
5446

55-
- Execution pricing
56-
- Runtime topology
57-
- Settlement mechanisms
58-
- Vendor-specific commercial logic
47+
> **Execution is business.
48+
> Semantics are public goods.**
5949
60-
> **Commons + Commercial define language.
61-
> Agent-Cards bind identity.
62-
> Runtime governs execution and economics.**
50+
Commercial schemas may reference Commons semantics — they **may not alter them**.
6351

6452
---
6553

66-
## 3. Immutable Semantic Guarantees (Anti-Rug)
54+
## 3. Stewardship — Bootstrap to Neutrality
6755

68-
Once published:
56+
**Founding Steward:** `commandlayer.eth`
6957

70-
- **Schemas:** `$id`, CID, and versioned TXT keys MAY NOT change
71-
- **Agent-Cards:** historical versions MUST remain resolvable
72-
- **Governance artifacts:** MUST preserve full historical context
58+
Responsible for:
7359

74-
Attempts to mutate semantics in place MUST be treated as **untrusted**.
60+
- Canonical schema publishing
61+
- Signed manifest + checksum updates
62+
- Security revocations + provenance logs
63+
- Transparency for all normative decisions
7564

76-
Schemas are **permanently free** under MIT/Apache-2.0 — irrevocable rights.
65+
### Decentralization Phases
7766

78-
> **Semantics are public infrastructure — forever.**
67+
| Phase | Governance Form | Trigger |
68+
|-------|----------------|---------|
69+
| 1 — Bootstrap | Single-operator Safe | Initial production adoption |
70+
| 2 — Multi-Maintainer | ≥3 independent vendors in Safe | Cross-vendor reliance |
71+
| 3 — Standards Committee | Public RFC review + voting | Global ecosystem dependence |
72+
| 4 — Neutral Standards Body | Community-elected | Entrenched industry standard |
7973

80-
---
74+
Vendor diversity REQUIRED — **no single affiliation may dominate**.
8175

82-
## 4. Change Classes
76+
A non-profit legal wrapper SHALL be established before Phase 3.
8377

84-
| Change | Version Rule | Required Log |
85-
|-------|--------------|--------------|
86-
| **Normative** (behavior change) | `1 → 2` | `RESOLUTION.md` |
87-
| **Compat-affecting** | `1.0 → 1.1` | `RESOLUTION.md` |
88-
| **Non-behavioral** | `1.0.0 → 1.0.1` | Commit history |
78+
---
8979

90-
CIDs + checksums MUST be published for every semantic release.
80+
## 4. Immutable Semantic Guarantees (Anti-Rug)
9181

92-
---
82+
Once published:
9383

94-
## 5. Release Requirements
84+
- `$id`, CID, and version MUST NEVER change
85+
- Historical schemas MUST remain resolvable
86+
- Governance history MUST NOT be rewritten
9587

96-
Valid releases MUST include:
88+
Commercial schemas inherit similar guarantees:
9789

98-
- Strict validation CI passing
99-
- Signed IPFS CIDs + checksums
100-
- Updated transparency artifacts:
101-
- `SPEC.md`, `VERSIONING.md`, `SECURITY_PROVENANCE.md`, `RESOLUTION.md`
90+
> **Commercial schemas are permanently free**
91+
> **economics only occur at runtime, never in the semantic layer.**
10292
103-
> **Atomic. Verified. Immutable. Or not valid.**
93+
Attempts to mutate semantics in place MUST be treated as **UNTRUSTED**.
10494

10595
---
10696

107-
## 6. TXT Governance (NORMATIVE)
97+
## 5. TXT Key Governance NORMATIVE
10898

10999
TXT semantics are partitioned:
110100

111101
| Prefix | Authority | Meaning | Mutation Allowed? |
112102
|--------|-----------|---------|------------------|
113-
| `cl.schema.*` | Commons + Commercial | Semantic schemas | ❌ NEVER |
103+
| `cl.schema.*` | Commons | Semantic bindings | ❌ NEVER |
114104
| `cl.agentcard` | Agent-Cards | Identity binding | ❌ NEVER (per version) |
115-
| `cl.runtime.*` | Runtime | Execution endpoints | ✔ Yes, logged |
105+
| `cl.runtime.*` | Runtime | Operational endpoints | ✔ Yes, logged |
116106

117107
Resolvers MUST:
118108

119-
- Reject TXT CID mismatches
109+
- Reject TXT CID mismatches
120110
- Treat unauthorized TXT keys as **UNTRUSTED**
121-
- Honor immutability of versioned schema keys
111+
- Enforce immutability of all versioned schema keys
122112

123-
> **Schema TXT keys are sacred. Runtime keys are operational.**
113+
> **Schema TXT is sacred.
114+
> Runtime TXT is operational.**
124115
125116
---
126117

127-
## 7. ENS Custody Model — NORMATIVE
118+
## 6. ENS Custody — NORMATIVE
128119

129120
Canonical ENS:
130121

131122
- `commandlayer.eth`
132123
- `{verb}agent.eth` identities
133124

134-
Custody MUST be a **3-of-5 Safe** once Phase 2 triggers:
125+
Custody SHALL transition to a **3-of-5 Safe** before Phase 2:
135126

136-
- Signers hardware-backed
137-
- All signer identities disclosed in `SECURITY_PROVENANCE.md`
138-
- Rotation MUST be logged as governance action
127+
- Hardware-backed keys
128+
- Signer identities publicly logged
129+
- Rotation MUST be recorded in `SECURITY_PROVENANCE.md`
139130

140-
**No single key** can change canonical TXT state.
131+
No single key may modify canonical semantics.
141132

142133
---
143134

144-
## 8. Runtime Governance Boundary
145-
146-
- Runtime **MAY** set and rotate `cl.runtime.*`
147-
- Runtime **MAY** define pricing and SLAs
148-
- Runtime **MAY** provide commercial execution
135+
## 7. Change Classification
149136

150-
Runtime MUST NOT:
151-
152-
- Alter semantic contracts
153-
- Shadow governed schema keys
154-
- Introduce proprietary lock-in of verbs
137+
| Change Class | Version Rule | Required Log |
138+
|--------------|--------------|--------------|
139+
| **Normative** (behavior change) | `1 → 2` | `RESOLUTION.md` |
140+
| **Compat-affecting** | `1.0 → 1.1` | `RESOLUTION.md` |
141+
| **Non-behavioral** | `1.0.0 → 1.0.1` | Commit history |
155142

156-
> **Execution is business.
157-
> Semantics are public goods.**
143+
Every semantic release MUST publish new CIDs + checksums.
158144

159145
---
160146

161-
## 9. Dispute Resolution
147+
## 8. Security Governance
162148

163-
1. Public Issue opened
164-
2. Evidence + impact review
165-
3. Governance decision + rationale
166-
4. Permanent entry in `RESOLUTION.md`
149+
- Responsible disclosure contact MUST be active
150+
- No silent patches or overwritten history
151+
- Emergency revocation allowed to protect downstream users
167152

168-
Emergency revocation MAY bypass full review to protect users.
153+
Transparency ALWAYS wins.
169154

170155
---
171156

172-
## 10. Compatibility Claims
157+
## 9. Enforcement of Compatibility Claims
173158

174-
Software MAY claim:
159+
Products MAY claim:
175160

176161
- **Commons-Compatible**
177-
- **Commercial-Compatible**
178162
- **Agent-Cards-Compatible**
179163

180164
ONLY if:
181165

182-
- CID + `$id` validation
183-
- Ajv strict mode
184-
- Timestamp-protected trace + receipts
185-
- Conformance with this Governance
166+
- `$id` + CID validation passes
167+
- Ajv strict mode enforced
168+
- Traceable receipt conformance
169+
- Adherence to this Governance
186170

187-
False claims REQUIRE enforcement.
171+
False claims REQUIRE public enforcement action.
188172

189173
---
190174

191175
_Last updated: v1.0.0 — Stable-Lock_
192176
Signed: **`commandlayer.eth`**
193-
*Founding Steward — CommandLayer Standards*
177+
*Founding Steward — CommandLayer Semantic Standards*

0 commit comments

Comments
 (0)