Skip to content
This repository was archived by the owner on May 24, 2026. It is now read-only.

Commit 34a7158

Browse files
authored
Update POLICY.md
1 parent e835968 commit 34a7158

1 file changed

Lines changed: 55 additions & 55 deletions

File tree

POLICY.md

Lines changed: 55 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,106 +1,106 @@
1+
# POLICY — Protocol-Commons
2+
CommandLayer Core Standards · Semantic Layer
13

2-
# Protocol-Commons Policy
4+
This document defines **publication rules** for Common verbs and schemas.
5+
`SPEC.md` remains the primary normative authority.
36

4-
This document defines the canonical rules for creating, validating, versioning, and publishing verb schemas in the CommandLayer Protocol Commons.
7+
---
58

6-
The Commons is the universal grammar for autonomous agents.
9+
## 1. Canonical Verb Requirements
710

8-
---
11+
A canonical verb MUST:
912

10-
## 1. Verbs Must Remain Canonical
13+
- Be a **single lowercase word**
14+
- Have exactly **one** interpretation
15+
- Be **domain-neutral** and non-commercial
16+
- Be approved through governance review PRIOR to publication
1117

12-
- Single lowercase word
13-
- One meaning; no semantic overload
14-
- Domain-neutral
15-
- Published only after governance review
18+
Commons verbs SHALL NOT encode:
1619

17-
Common verbs **SHALL NOT** model:
18-
- Payments
19-
- Contracts / transfers
20-
- Authentication
21-
- Business logic
20+
- Payments or finance
21+
- Authentication or identity proofing
22+
- Business-specific logic
2223

23-
Those belong in the _Commercial_ layer.
24+
Those belong to **Commercial** standards.
2425

2526
---
2627

2728
## 2. Required Artifacts Per Verb
2829

29-
Each canonical verb MUST define:
30+
Each verb MUST include:
3031

3132
- `requests/<verb>.request.schema.json`
3233
- `receipts/<verb>.receipt.schema.json`
34+
- Valid + invalid example sets:
35+
36+
`examples/valid/.json`
37+
`examples/invalid/.json`
3338

34-
And MUST ship:
35-
-
36-
- `examples/valid/*.json`
37-
- `examples/invalid/*.json`
39+
vbnet
40+
Copy code
41+
Schematics MUST reference shared primitives under:
3842

43+
schemas/v1.0.0/_shared/
3944

4045
---
4146

4247
## 3. JSON Schema Requirements
4348

4449
- Draft **2020-12**
45-
- Ajv **strict mode**
46-
- `"additionalProperties": false` at top level
47-
- Deterministic `$id` and directory structure:
50+
- Ajv **strict** validation
51+
- `"additionalProperties": false`
52+
- Deterministic `$id` structure:
4853

49-
/schemas/v1.0.0/commons/<verb>/
54+
https://commandlayer.org/schemas/v1.0.0/commons/<verb>/requests/<verb>.request.schema.json
55+
https://commandlayer.org/schemas/v1.0.0/commons/<verb>/receipts/<verb>.receipt.schema.json
5056

5157

58+
Directory layout MUST NOT vary.
59+
5260
---
5361

54-
## 4. x402 Alignment
62+
## 4. x402 Alignment (Normative)
63+
64+
**All requests MUST define:**
5565

56-
All requests:
57-
`x402.verb = <verb>`
58-
`x402.version = "1.0.0"`
66+
- x402.verb = <verb>
67+
- x402.version = "1.0.0"
5968

6069

61-
All receipts:
70+
**All receipts MUST define:**
71+
6272
`x402.status = "ok" | "error"`
6373

74+
Trace MUST echo `request.trace.requestId`.
75+
6476
---
6577

6678
## 5. Immutability
6779

6880
Once published:
69-
- **No changes** in-place
70-
- Any update requires a new version directory
71-
- New CID + new checksums
72-
- ENS TXT updates
73-
74-
---
75-
76-
## 6. Breaking Change Rules
7781

78-
### Requires MAJOR version bump:
79-
- Removing fields
80-
- Changing requiredness
81-
- New semantics for success/error
82-
- Trace model changes
82+
- No modification permitted in-place
83+
- Breaking change → new major version dir
84+
- Additive change → minor version dir
85+
- Example/docs fixes → patch version
8386

84-
### Requires MINOR:
85-
- Additive `input.*` or `result.*`
87+
New versions MUST include:
8688

87-
### PATCH:
88-
- Example or documentation fixes
89+
- Updated CIDs
90+
- Updated checksums
91+
- ENS TXT update where applicable
8992

9093
---
9194

92-
## 7. Governance Compliance
95+
## 6. Governance Compliance
9396

9497
Every change MUST:
98+
9599
- Have an issue link
100+
- Pass CI validation
96101
- Be recorded in `RESOLUTION.md`
102+
- Be signed by governance maintainer
97103

104+
---
98105

99-
100-
101-
102-
103-
104-
105-
106-
106+
_Last updated: v1.0.0 — Stable-Lock_

0 commit comments

Comments
 (0)