You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The CommandLayer Protocol Commons defines the canonical verb and schema layer for agents.
5
-
During the v1.0.0 cycle, it operates under a single-maintainer model to ensure stability and accuracy of the command language.
6
-
As the protocol matures, stewardship will expand to a small group of trusted maintainers, supported by an open proposal and review process. This ensures the Commons can grow, improve, and remain stable under a clear and transparent governance model.
4
+
5
+
During the v1.0.0 cycle, it operates under a single-maintainer model to ensure stability and correctness of the core language. As adoption grows, stewardship will expand to a small group of trusted maintainers under a transparent proposal and review process.
7
6
8
7
---
9
8
10
9
## Stewardship
11
10
12
-
-**Owner:**`commandlayer.eth`
11
+
-**Owner:** commandlayer.eth
13
12
-**Maintainer:** CommandLayer Governance Council
14
-
-**Contact:**`dev@commandlayer.org`
13
+
-**Contact:**dev@commandlayer.org
15
14
16
-
The Commons layer must remain:
15
+
The Commons MUST remain:
17
16
18
17
- Neutral — no vendor-specific semantics
19
18
- Minimal — only what is required for interoperability
@@ -24,67 +23,66 @@ The Commons layer must remain:
24
23
25
24
## Change Process
26
25
27
-
1.**Open an issue** describing the proposed update
28
-
2.**Provide justification** (interoperability need, bug fix, receipt fix, security hardening)
29
-
3.**Run validation**:
30
-
- All schemas pass strict Ajv
31
-
- All examples pass
32
-
-`checksums.txt` regenerated
33
-
4.**Maintainer review** and determination
34
-
5.**Tagged release + provenance update**:
35
-
- New tag (e.g., `commons-v1.0.1`)
36
-
- New IPFS CID recorded in `SECURITY_PROVENANCE.md`
37
-
- ENS TXT fields updated if applicable
38
-
39
-
Changes that alter the request/receipt contract, trace semantics, alias mapping rules, or x402 requirements require a **minor or major** version bump.
26
+
1. Open an Issue describing the change request
27
+
2. Provide justification
28
+
- Interoperability need
29
+
- Bug fix
30
+
- Security correction
31
+
3. Update/verifying artifacts:
32
+
- Request + receipt schemas validated under strict Ajv
33
+
- Checksums regenerated
34
+
- Manifest updated
35
+
4. Maintainer review + decision
36
+
5. Versioned release:
37
+
- New tag (e.g., `commons-v1.0.1`)
38
+
- New IPFS CID recorded in `SECURITY_PROVENANCE.md`
39
+
40
+
⚠️ Any change to request/receipt shape or `$id` structure requires a **minor/major** version bump.
40
41
41
42
---
42
43
43
-
## ENS Binding Governance
44
-
45
-
ENS TXT fields associated with Protocol-Commons — such as those stored under `commandlayer.eth` or verb-specific ENS names — are **critical protocol resources**.
46
-
47
-
Fields include:
48
-
49
-
-`cl.verb`
50
-
-`cl.version`
51
-
-`cl.schema.request`
52
-
-`cl.schema.receipt`
53
-
-`cl.cid.schemas`
54
-
-`cl.owner`
55
-
-`cl.schemas.mirror.ipfs`
56
-
-`cl.agentcard`
57
-
-`cl.cid.agentcard`
58
-
-`cl.agentcard.mirror.ipfs`
59
-
-`cl.checksum.request`
60
-
-`cl.checksum.receipt`
61
-
-`cl.checksum.agentcard`
62
-
-`cl.owner`
63
-
64
-
Any modification must undergo:
65
-
66
-
- Maintainer approval
67
-
- Out-of-band verification (PGP or signed message)
68
-
- Logging in `RESOLUTION.md` with timestamp + rationale
44
+
## ENS Binding
45
+
46
+
Protocol-Commons is responsible ONLY for:
47
+
```
48
+
cl.verb
49
+
cl.version
50
+
cl.schema.request
51
+
cl.schema.receipt
52
+
cl.cid.schemas
53
+
cl.schemas.mirror.ipfs
54
+
```
55
+
56
+
These are **immutable protocol commitments** once published.
57
+
58
+
Updates MUST be approved via governance and logged in `RESOLUTION.md`.
69
59
70
60
---
71
61
72
62
## Deprecation
73
63
74
-
When a verb or schema is deprecated:
64
+
1. Log change in `RESOLUTION.md`
65
+
2. Mark deprecated in documentation
66
+
3. Preserve for backward compatibility unless removal is a security event
67
+
68
+
Deprecation window: **≥90 days** before removal.
69
+
70
+
---
71
+
72
+
## Transparency Artifacts
73
+
74
+
-`POLICY.md` — rules for verbs & schemas
75
+
-`SPEC.md` — normative protocol requirements
76
+
-`RESOLUTION.md` — lifecycle history
77
+
-`SECURITY_PROVENANCE.md` — CIDs & hashes for each release
78
+
79
+
---
80
+
81
+
82
+
83
+
84
+
75
85
76
-
1.**Record** in `RESOLUTION.md` with:
77
-
- Affected `$id`
78
-
- Reason
79
-
- Replacement (if any)
80
-
2.**Mark** deprecated status in `SPEC.md` and public documentation
81
-
3.**Preserve** the schema for backward compatibility unless removal is required for security
82
86
83
-
Removal is treated as an **exceptional event** and requires a documented migration path for downstream integrators.
84
87
85
-
## Links
86
88
87
-
-[SECURITY POLICY](./SECURITY.md) — responsible disclosure and vulnerability handling
88
-
-[RESOLUTION](./RESOLUTION.md) — governance and deprecation log
89
-
-[POLICY](./POLICY.md) — verbs and ENS binding rules
90
-
-[GOVERNANCE](./GOVERNANCE.md) — decision-making and multisig control
0 commit comments