Skip to content

Commit 87cb68e

Browse files
authored
Update SPEC.md
1 parent 85767d7 commit 87cb68e

1 file changed

Lines changed: 13 additions & 32 deletions

File tree

SPEC.md

Lines changed: 13 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,6 @@ Out of scope (defined in other repos):
4545
A system **CONFORMS** to the CommandLayer Commons if it:
4646

4747
3.1 **MUST** support all 10 canonical verbs at their canonical names.
48-
3.2 **MUST** support exactly one alias per verb and normalize aliases to the canonical verb.
4948
3.3 **MUST** validate all requests/receipts using the official schemas in **strict AJV mode**.
5049
3.4 **MUST** treat versioned schemas as immutable once published.
5150
3.5 **MUST** echo `trace.requestId` from request → receipt.
@@ -54,29 +53,27 @@ A “Commons‑Compatible Agent” is any agent capable of consuming a valid req
5453

5554
---
5655

57-
# **4. Canonical Verbs & Aliases (v1.0.0)**
56+
# **4. Canonical Verbs & (v1.0.0)**
5857

5958
The following are the **ONLY canonical verbs** in v1.0.0:
6059

61-
| Category | Verb | Alias |
60+
| Category | Verb | |
6261
|----------|-------|--------|
63-
| Core Ops + Data | fetch | get |
64-
| | save | store |
65-
| | parse | extract |
66-
| AI Cognition | analyze | examine |
67-
| | summarize | outline |
68-
| | classify | categorize |
69-
| | translate | interpret |
70-
| | generate | create |
71-
| Utility | format | normalize |
72-
| Workflow | query | find |
62+
| Core Ops + Data | fetch | |
63+
| | clean | |
64+
| | parse | |
65+
| AI Cognition | analyze | |
66+
| | summarize | |
67+
| | classify | |
68+
| | describe | |
69+
| | |explain |
70+
| Utility | format | |
71+
| Workflow | | |
7372

7473
Rules:
7574

7675
- 4.1 Canonical verbs **MUST** be lowercase, single words.
77-
- 4.2 Aliases **MUST NOT** conflict with any canonical verb.
7876
- 4.3 Canonical names **MUST** appear in `x402.verb`.
79-
- 4.4 Aliases **MAY** be used by UIs, SDKs, and routers.
8077

8178
---
8279

@@ -193,22 +190,6 @@ https://commandlayer.org/schemas/v1.0.0/commons/<verb>/receipts/<verb>.receipt.s
193190

194191
---
195192

196-
# **9. Alias Rules**
197-
198-
Each alias map MUST follow:
199-
200-
```json
201-
{
202-
"canonical": "<verb>",
203-
"aliases": ["<alias>"]
204-
}
205-
```
206-
207-
Rules:
208-
209-
- Aliases **MUST NOT** collide with any canonical verb.
210-
- Aliases **MAY** be mapped automatically by resolvers.
211-
- Canonical verb **MUST** override aliases in all message fields.
212193

213194
---
214195

@@ -255,7 +236,7 @@ Request + receipt envelope fragments are included for implementers (see **SCHEMA
255236

256237
# **15. Examples (Informative)**
257238

258-
Verb examples (fetch, summarize, generate, etc.) are provided in the repository under:
239+
Verb examples (fetch, summarize, etc.) are provided in the repository under:
259240

260241
```
261242
examples/v1.0.0/commons/<verb>/

0 commit comments

Comments
 (0)