Skip to content

Commit 071eafc

Browse files
authored
Update GOVERNANCE.md
1 parent d1b44c8 commit 071eafc

1 file changed

Lines changed: 30 additions & 48 deletions

File tree

GOVERNANCE.md

Lines changed: 30 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -16,48 +16,43 @@ Responsible for:
1616

1717
- Maintaining canonical Protocol-Commons + Agent-Cards standards
1818
- Publishing signed manifest + checksum sets
19-
- Ensuring ENS TXT correctness
2019
- Approving and versioning normative changes
20+
- Ensuring transparency + security in provenance
2121
- Security revocation + incident handling
2222

23-
> The Founding Steward **does not own** the ecosystem —
24-
> it **protects** stability until broader stewardship is in place.
23+
> The Founding Steward **protects protocol stability** until broader stewardship is in place.
2524
2625
### Future Decentralization Intent
2726

28-
Governance will evolve in **phases**:
29-
3027
| Phase | Governance Structure | Trigger |
3128
|------|---------------------|--------|
3229
| 1 — Bootstrap (now) | Single steward | Initial adoption |
3330
| 2 — Multi-maintainer | ≥3 independent implementers | Cross-vendor usage |
3431
| 3 — Standards Committee | Formal proposal & review | Widespread ecosystem reliance |
35-
| 4 — Neutral Standards Body | Community-elected representatives | Global adoption & academic participation |
32+
| 4 — Neutral Standards Body | Community-elected representatives | Global adoption |
3633

37-
Governance will remain permissionless and open to ecosystem implementers.
3834
---
3935

4036
## 2. Change Classes
4137

4238
| Change Type | Examples | Version Rule | Audit Log |
4339
|------------|----------|--------------|-----------|
44-
| **Normative** | Schema rules, ENS TXT semantics | Major: `1 → 2` | `RESOLUTION.md` |
40+
| **Normative** | Schema rules, TXT semantics | Major: `1 → 2` | `RESOLUTION.md` |
4541
| **Compatibility-affecting** | Required field tightening | Minor: `1.0 → 1.1` | `RESOLUTION.md` |
46-
| **Non-behavioral** | Docs, comments, naming | Patch: `1.0.0 → 1.0.1` | Commit message |
42+
| **Non-behavioral** | Docs, naming | Patch: `1.0.0 → 1.0.1` | Commit message |
4743

48-
CIDs + checksums MUST be published for the change to become effective.
44+
CIDs + checksums MUST be published for changes to become effective.
4945

5046
---
5147

5248
## 3. Immutability Guarantees
5349

5450
Once a version is published:
5551

56-
- No file mutation
57-
- No `$id` or CID changes
58-
- ENS TXT MUST still resolve correctly
52+
- No file mutation
53+
- No `$id` or CID changes
5954

60-
**Violation triggers:** revocation + new version.
55+
Violations require revocation + new version.
6156

6257
---
6358

@@ -66,57 +61,44 @@ Once a version is published:
6661
Every release MUST include:
6762

6863
- Strict validation via CI
69-
- Signed IPFS CID and checksums
70-
- Complete transparency artifacts updated **together**:
71-
- `SPEC.md`
72-
- `POLICY.md`
73-
- `SECURITY_PROVENANCE.md`
74-
- `RESOLUTION.md`
75-
- `VERSIONING.md`
64+
- Signed IPFS CID + checksums
65+
- Transparency artifacts updated **together**:
66+
- `SPEC.md`, `POLICY.md`, `SECURITY_PROVENANCE.md`, `RESOLUTION.md`, `VERSIONING.md`
7667

77-
**Atomic and provable — or it isn’t real.**
68+
**Atomic and verifiable — or not valid.**
7869

7970
---
8071

81-
## 5. ENS TXT Enforcement
72+
## 5. TXT Responsibility Split (NORMATIVE)
8273

83-
Resolvers MUST reject identity bindings when:
74+
- **Protocol-Commons** governs TXT keys that resolve **schema semantics**
75+
- **Agent-Cards** governs TXT keys that bind **identity + invocation**
8476

85-
- TXT keys mismatch card values
86-
- CIDs or checksums fail
87-
- Required TXT fields are missing
77+
If a TXT field is not explicitly assigned here, it MUST NOT be introduced without governance approval.
8878

89-
**Correct TXT = trusted identity**
90-
**Anything else = untrusted.**
79+
Resolvers MUST treat TXT contract violations as **UNTRUSTED** bindings.
9180

9281
---
9382

9483
## 6. Security Governance
9584

9685
Responsibilities:
9786

98-
- Enforce security requirements under:
99-
- `SECURITY.md`
100-
- `SECURITY_PROVENANCE.md`
101-
- Respond to incidents within **7 days**
102-
- Record revocations transparently
87+
- Enforce requirements under `SECURITY*.md`
88+
- Respond to security reports within **7 days**
10389
- Require signed replacements for compromised artifacts
90+
- Log revocations transparently
10491

105-
Emergency revocations MAY bypass full review
106-
if required to protect the network.
92+
Emergency revocation MAY bypass full review if required to protect the ecosystem.
10793

10894
---
10995

11096
## 7. Dispute Resolution
11197

112-
If an artifact or claim is contested:
113-
114-
1. Log issue publicly
115-
2. Review evidence and ecosystem impact
116-
3. Decide outcome via steward + public comment
117-
4. Log resolution action in `RESOLUTION.md`
118-
119-
**Collaborative — not arbitrary.**
98+
1. Log an Issue publicly
99+
2. Review evidence + ecosystem impact
100+
3. Render decision with public comment
101+
4. Log outcome in `RESOLUTION.md`
120102

121103
---
122104

@@ -127,14 +109,14 @@ Software MAY claim:
127109
- **Commons-Compatible**
128110
- **Agent-Cards-Compatible**
129111

130-
…only if ALL of the following hold:
112+
…only with:
131113

132-
ENS TXT → Card → SchemaCID validation
133-
✔ Ajv strict JSON Schema conformance
114+
✔ Schema/CID/TXT validation
115+
✔ Ajv strict JSON Schema enforcement
134116
✔ Canonical x402 entry format
135117
✔ Trace echo + status rules enforced
136118

137-
False compatibility claims are governance violations.
119+
False claims are governance violations.
138120

139121
---
140122

0 commit comments

Comments
 (0)