Skip to content

Commit a6b2a2e

Browse files
committed
Clarify v1.1.0 HTTPS hosting status
1 parent a2db39d commit a6b2a2e

File tree

9 files changed

+49
-40
lines changed

9 files changed

+49
-40
lines changed

COMPLIANCE.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,12 @@ Compliance claims MUST identify the version they apply to.
2929

3030
Current repository status:
3131

32-
- **v1.1.0** — current canonical in-repo schema family; repository metadata still records CID publication as pending
32+
- **v1.1.0** — current canonical HTTPS-hosted schema family; repository metadata still records IPFS CID publication as pending
3333
- **v1.0.0** — historical pinned release line
3434

3535
A system MAY claim **v1.1.0 schema compatibility** if it validates and enforces the published v1.1.0 schemas.
3636

37-
A system MUST describe provenance accurately and MUST NOT claim that v1.1.0 is the historical pinned release while CID publication remains unpublished in repository metadata.
37+
A system MUST describe provenance accurately and MUST NOT claim that v1.1.0 is the historical pinned release while IPFS CID publication remains unpublished in repository metadata.
3838

3939
---
4040

@@ -92,7 +92,7 @@ canonical compliance, and MUST reject mismatches.
9292

9393
Mismatch = **integrity failure**
9494

95-
For v1.1.0 specifically, the schemas and checksums can be validated locally, and compliance statements MUST distinguish the current canonical in-repo line from the historical pinned release until CID publication is complete.
95+
For v1.1.0 specifically, the schemas and checksums can be validated locally, and compliance statements MUST distinguish the current canonical HTTPS-hosted line from the historical pinned release until IPFS CID publication is complete.
9696

9797
---
9898

@@ -155,6 +155,6 @@ You may claim **Protocol-Commons compliant** for a specific version if:
155155
- CIDs and checksums match content when the version is claimed as canonical and pinned
156156
- Changes logged and signed
157157
- ENS TXT duties respected per SPEC.md
158-
- Version status is described accurately as current canonical in-repo or historical pinned release
158+
- Version status is described accurately as current canonical HTTPS-hosted or historical pinned release
159159

160160
If uncertain → treat the implementation as **experimental**.

GOVERNANCE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ Attempts to mutate semantics in place MUST be treated as **UNTRUSTED**.
9999
The current lock states are interpreted strictly:
100100

101101
- **v1.0.0 historical pinned release** means the legacy release line with published CID, immutable checksums, and locked provenance
102-
- **v1.1.0 current canonical working line** means the current repository contract and primary documentation target; CID publication remains pending in repository provenance metadata
102+
- **v1.1.0 current canonical HTTPS-hosted line** means the current repository contract, primary documentation target, and live HTTPS schema namespace; IPFS CID publication remains pending in repository provenance metadata
103103

104104
---
105105

@@ -154,7 +154,7 @@ Silent or undocumented changes are **STRICTLY FORBIDDEN.**
154154

155155
Every semantic release MUST publish new CIDs + checksums.
156156

157-
Until CID publication is complete, contributors MUST describe that version accurately as the current canonical working line and MUST NOT misstate it as the historical pinned release.
157+
Until IPFS CID publication is complete, contributors MUST describe that version accurately as the current canonical HTTPS-hosted line and MUST NOT misstate it as the historical pinned release.
158158

159159
---
160160

@@ -184,6 +184,6 @@ ONLY if:
184184

185185
False claims REQUIRE public enforcement action.
186186

187-
_Last updated: v1.0.0 retained as the historical pinned release; v1.1.0 documented as the current canonical working line_
187+
_Last updated: v1.0.0 retained as the historical pinned release; v1.1.0 documented as the current canonical HTTPS-hosted line_
188188
Steward declaration (plain-text repository statement, not a cryptographic signature): **`commandlayer.eth`**
189189
*Founding Steward — CommandLayer Semantic Standards*

README.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@
1212

1313
> **Integrity Notice — Protocol-Commons v1.1.0**
1414
>
15-
> `schemas/v1.1.0/commons` is the current canonical **working line in this repository**.
16-
> Its publication metadata still says `schemas_cid: PENDING`, so this line is **not yet the externally pinned canonical release**.
15+
> `schemas/v1.1.0/commons` is the current canonical schema family in this repository, and its HTTPS schema URLs are live under `https://commandlayer.org/schemas/v1.1.0/...`.
16+
> Its metadata still says `schemas_cid: PENDING`, so v1.1.0 is **not yet the IPFS-pinned canonical release**.
1717
>
1818
> `v1.0.0` remains the last **externally pinned canonical release**:
1919
> `schemas/v1.0.0/` — CID: `bafybeigvf6nkzws7dblos74dqqjkguwkrwn4a2c27ieygoxmgofyzdkz6m`
@@ -182,7 +182,7 @@ console.log(validate.errors ?? []);
182182
183183
Commons v1.1.0 is the current canonical schema family in this repository.
184184
185-
It is the primary documentation and validation target for Commons. The repository still records CID publication as pending, so `v1.1.0` should be treated as the active working line rather than the last externally pinned release. `v1.0.0` is retained as the historical pinned release line.
185+
It is the primary documentation and validation target for Commons, and its canonical HTTPS `$id` URLs are live. The repository still records IPFS CID publication as pending, so `v1.1.0` should be treated as the current HTTPS-published schema family rather than the last IPFS-pinned release. `v1.0.0` is retained as the historical pinned release line.
186186
187187
- Each request schema is standalone
188188
- Each receipt schema is standalone
@@ -348,11 +348,11 @@ Commons gives upper layers a stable meaning layer to build around.
348348
349349
## Status
350350
351-
**v1.1.0 — current canonical working line**
351+
**v1.1.0 — current canonical HTTPS-hosted schema line**
352352
353353
- `v1.1.0` is the current flat Commons layout in this repo
354354
- `v1.0.0` remains the historical pinned release line
355-
- Do not describe `v1.1.0` as externally pinned or historically locked until CID publication is complete
355+
- Do not describe `v1.1.0` as IPFS-pinned or historically locked until CID publication is complete
356356
357357
---
358358
@@ -394,9 +394,10 @@ Commons gives upper layers a stable meaning layer to build around.
394394
- schema and example roots
395395
- the current schema pin target
396396
- per-verb request and receipt schema paths
397+
- HTTPS hosting status (live for `https://commandlayer.org/schemas/v1.1.0/...`)
397398
- CID publication status (`PENDING` in `manifest.json` until published)
398399
399-
Treat `schemas_cid: PENDING` as an explicit signal that the v1.1.0 line is still awaiting external publication/provenance, even though it is the repo's current schema target.
400+
Treat `schemas_cid: PENDING` as an explicit signal that IPFS provenance for v1.1.0 is still awaiting publication, even though the v1.1.0 HTTPS schema identifiers are already live and this is the repo's current schema target.
400401
401402
---
402403

RESOLUTION.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ If a change is **not** documented here, it is **not** considered valid.
2525
| Date | Verb(s) | Action | Class | Reason | Resolution | Approver(s) |
2626
|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|---------|-------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|-------------------|
2727
| 2025-12-06 | analyze, classify, clean, convert, describe, explain, fetch, format, parse, summarize | Added | Commons | Initial canonical verb set | v1.0.0 published — immutable directory `schemas/v1.0.0/` — CID: `bafybeigvf6nkzws7dblos74dqqjkguwkrwn4a2c27ieygoxmgofyzdkz6m` | Founding Steward |
28-
| 2026-03-18 | analyze, classify, clean, convert, describe, explain, fetch, format, parse, summarize | Revised | Commons | Simplified attestation-oriented receipt contract, flat layout, removal of universal x402/trace assumptions from the new schema family | v1.1.0 current canonical in-repo line recorded, CID publication pending | Founding Steward |
28+
| 2026-03-18 | analyze, classify, clean, convert, describe, explain, fetch, format, parse, summarize | Revised | Commons | Simplified attestation-oriented receipt contract, flat layout, removal of universal x402/trace assumptions from the new schema family | v1.1.0 canonical HTTPS schema hosting live; IPFS CID publication pending | Founding Steward |
2929

3030
> Any future semantic change requires a **new version directory** and **new CID** prior to approval and publication in this Resolution Log.
3131
@@ -49,4 +49,4 @@ Maintainers must review before any merge:
4949
- `GOVERNANCE.md`
5050
- `SECURITY_PROVENANCE.md`
5151

52-
**Status:** v1.1.0 current canonical in-repo line recorded, CID publication pending; v1.0.0 remains the historical pinned release.
52+
**Status:** v1.1.0 canonical HTTPS schema hosting is live, IPFS CID publication remains pending; v1.0.0 remains the historical pinned release.

SCHEMAS.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ This repository currently ships:
2727
- **v1.1.0** as the active in-repo schema family
2828
- **v1.0.0** as the historical and last fully pinned canonical release
2929

30-
Because `manifest.json` still reports the v1.1.0 schema CID as pending, documentation MUST describe v1.1.0 accurately as the current canonical in-repo line and MUST distinguish it from the historical pinned release until a real CID is published.
30+
Because `manifest.json` still reports the v1.1.0 schema CID as pending, documentation MUST describe v1.1.0 accurately as the current canonical HTTPS-hosted schema line and MUST distinguish it from the historical pinned release until a real CID is published.
3131

3232
---
3333

@@ -250,6 +250,12 @@ Integrity is tracked by:
250250
- `checksums.txt`
251251
- `manifest.json`
252252

253+
Current v1.1.0 canonical HTTPS schema root:
254+
255+
```text
256+
https://commandlayer.org/schemas/v1.1.0/
257+
```
258+
253259
Current v1.1.0 schema CID status:
254260

255261
```text
@@ -262,7 +268,7 @@ Last pinned canonical release content identifier:
262268
v1.0.0 → bafybeigvf6nkzws7dblos74dqqjkguwkrwn4a2c27ieygoxmgofyzdkz6m
263269
```
264270

265-
Resolvers and auditors MUST reject mismatched artifacts and MUST distinguish between the current canonical in-repo schema family and the historical pinned release.
271+
Resolvers and auditors MUST reject mismatched artifacts and MUST distinguish between the current canonical HTTPS-hosted schema family and the historical pinned release.
266272

267273
---
268274

@@ -271,4 +277,4 @@ Resolvers and auditors MUST reject mismatched artifacts and MUST distinguish bet
271277
- dev@commandlayer.org
272278
- PGP 5016 D496 9F38 22B2 C5A2 FA40 99A2 6950 197D AB0A
273279

274-
**Status:** v1.1.0 current canonical in-repo schema family with pending CID publication metadata; v1.0.0 retained as the historical pinned release.
280+
**Status:** v1.1.0 current canonical HTTPS-hosted schema family with pending CID publication metadata; v1.0.0 retained as the historical pinned release.

SECURITY_PROVENANCE.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,14 @@ Current canonical pinned release: **v1.0.0**
2626

2727
Integrity sources:
2828
- **v1.0.0 CID:** `bafybeigvf6nkzws7dblos74dqqjkguwkrwn4a2c27ieygoxmgofyzdkz6m`
29-
- **v1.1.0 CID:** `PENDING` (pinning not yet published)
29+
- **v1.1.0 HTTPS canonical root:** `https://commandlayer.org/schemas/v1.1.0/` (live)
30+
- **v1.1.0 CID:** `PENDING` (IPFS pinning not yet published)
3031
- `checksums.txt` — file-level hashes
3132
- CI strict validation (Ajv)
3233
- `RESOLUTION.md` — immutable lifecycle history
3334
- `manifest.json` — current package metadata and pin target state
3435

35-
Until a v1.1.0 CID is published and recorded, resolvers and auditors MUST treat v1.1.0 as the current canonical in-repo schema family rather than the historical pinned release.
36+
Until a v1.1.0 CID is published and recorded, resolvers and auditors MUST treat v1.1.0 as the current canonical HTTPS-hosted schema family rather than the historical pinned release.
3637

3738
Any semantic update requires:
3839
- New `schemas/vX.Y.Z/` directory
@@ -42,10 +43,10 @@ Any semantic update requires:
4243
**No silent edits. No exceptions.**
4344

4445
Auditors MUST verify:
45-
- HTTP and IPFS mirrors match exactly for pinned canonical releases
46+
- HTTPS and IPFS mirrors match exactly for pinned canonical releases
4647
- Checksums remain unchanged
4748
- Version directories are immutable
48-
- The current canonical in-repo line is not misdescribed as the historical pinned release before CID publication is complete
49+
- The current canonical HTTPS-hosted line is not misdescribed as the historical pinned release before CID publication is complete
4950

5051
---
5152

@@ -75,4 +76,4 @@ Recovery requires **transparent governance** — never mutation in place.
7576

7677
---
7778

78-
**Status:** v1.1.0 is the current canonical in-repo schema family; v1.0.0 remains the historical fully verifiable pinned release.
79+
**Status:** v1.1.0 is the current canonical HTTPS-hosted schema family with pending IPFS CID publication; v1.0.0 remains the historical fully verifiable pinned release.

SPEC.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -25,15 +25,15 @@ Execution, payment, identity, and routing are the domain of other layers.
2525

2626
This repository contains two materially different Commons schema families:
2727

28-
- **v1.1.0** — current canonical in-repo schema family and active documentation target
28+
- **v1.1.0** — current canonical schema family, active documentation target, and live HTTPS-hosted identifier set
2929
- **v1.0.0** — legacy schema family and historical pinned release
3030

31-
Repository metadata still records v1.1.0 CID publication as pending. Implementers MUST therefore distinguish between:
31+
Repository metadata still records v1.1.0 IPFS CID publication as pending. Implementers MUST therefore distinguish between:
3232

33-
1. **Schema semantics** — what the v1.1.0 files require
34-
2. **Release provenance status** — whether a version has completed CID publication and canonical pinning
33+
1. **Schema semantics and canonical HTTPS identifiers** — what the v1.1.0 files require and where their `$id` values resolve
34+
2. **Release provenance status** — whether a version has completed IPFS CID publication and canonical pinning
3535

36-
This specification documents the v1.1.0 contract as the current canonical working line while preserving v1.0.0 as the historical pinned release until v1.1.0 pinning is complete.
36+
This specification documents the v1.1.0 contract as the current canonical schema family while preserving v1.0.0 as the historical pinned release until v1.1.0 IPFS pinning is complete.
3737

3838
---
3939

@@ -209,7 +209,7 @@ schemas/v1.0.0/commons/<verb>/receipts/<verb>.receipt.schema.json
209209

210210
Every v1.1.0 schema MUST use the canonical HTTPS `$id` namespace under this pattern.
211211

212-
Those `$id` values are stable schema identifiers inside the repository and validation tooling. They SHOULD resolve over live HTTPS once publication/hosting is completed, but live HTTPS resolution is not yet guaranteed by current v1.1.0 repository provenance metadata.
212+
Those `$id` values are stable canonical schema identifiers. For v1.1.0 they MUST match the live HTTPS-hosted schema namespace and MUST resolve at the published HTTPS locations. This HTTPS hosting state is distinct from any separate IPFS CID publication record.
213213

214214
### Request
215215

@@ -274,7 +274,8 @@ The current v1.1.0 schema family is identified by:
274274
- Package version: `1.1.0`
275275
- Manifest entry: `manifest.json`
276276
- File-level hashes: `checksums.txt`
277-
- IPFS directory CID: `PENDING` until CID publication is complete
277+
- Canonical HTTPS schema host: `https://commandlayer.org/schemas/v1.1.0/`
278+
- IPFS directory CID: `PENDING` until IPFS CID publication is complete
278279

279280
The last fully pinned canonical release is:
280281

@@ -286,7 +287,7 @@ Auditors and resolvers SHOULD:
286287
1. Fetch the versioned schemas
287288
2. Verify integrity locally
288289
3. Treat mismatched artifacts as untrusted
289-
4. Treat v1.1.0 as the current canonical working line, distinct from the historical pinned release, until CID publication is complete
290+
4. Treat v1.1.0 HTTPS identifiers as live canonical schema references, while treating IPFS provenance for v1.1.0 as pending until a CID is published
290291

291292
Integrity check command:
292293

@@ -305,9 +306,9 @@ An implementation supporting Commons v1.1.0 MUST:
305306
3. Validate the flat receipt shape exactly as published
306307
4. Treat published version directories as immutable
307308
5. Preserve receipt trust semantics as hashes plus signatures, without inventing unsupported guarantees
308-
6. Avoid representing v1.1.0 as the historical pinned release until CID publication is complete
309+
6. Avoid representing v1.1.0 as the historical pinned release until its IPFS CID publication is complete
309310

310-
A system supporting any canonical verb MAY claim **Commons-Compatible** for that version, but provenance claims MUST accurately reflect whether the relevant version is the current canonical working line or the historical pinned release.
311+
A system supporting any canonical verb MAY claim **Commons-Compatible** for that version, but provenance claims MUST accurately reflect whether the relevant version is the current canonical HTTPS-hosted schema family or the historical pinned release.
311312

312313
---
313314

@@ -320,7 +321,7 @@ If any of the following occur:
320321
- required conditional receipt fields are missing
321322
- published artifacts differ from expected checksums
322323
- published artifacts are mutated in place
323-
- a current canonical in-repo version is misrepresented as the historical pinned release
324+
- a current canonical HTTPS-hosted version is misrepresented as the historical pinned release
324325

325326
consumers MUST treat the artifact as untrusted and SHOULD reject it.
326327

@@ -345,5 +346,5 @@ Security escalation MUST follow repository policy.
345346

346347
## Status
347348

348-
**v1.1.0:** current canonical schema family documented here; CID publication status remains pending in repository metadata
349+
**v1.1.0:** current canonical schema family documented here; HTTPS hosting is live and IPFS CID publication remains pending in repository metadata
349350
**v1.0.0:** legacy schema family and historical pinned release

manifest.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "@commandlayer/commons",
33
"version": "1.1.0",
44
"package_version": "1.1.0",
5-
"description": "Commons verb + schema package metadata for the active v1.1.0 working line; external CID publication is still pending.",
5+
"description": "Commons verb + schema package metadata for the active v1.1.0 canonical HTTPS-hosted schema line; IPFS CID publication is still pending.",
66
"owner": "commandlayer.eth",
77
"contact": "dev@commandlayer.org",
88
"license": "MIT",
@@ -77,7 +77,7 @@
7777
],
7878
"latest_commons_root": "schemas/v1.1.0/commons",
7979
"pin_target": "schemas/v1.1.0/commons",
80-
"status": "current-working-line",
80+
"status": "current-canonical-https-hosted",
8181
"historical_releases": [
8282
{
8383
"version": "1.0.0",
@@ -151,12 +151,12 @@
151151
],
152152
"active_release": {
153153
"version": "1.1.0",
154-
"status": "current-working-line",
154+
"status": "current-canonical-https-hosted",
155155
"schemas_root": "schemas/v1.1.0",
156156
"commons_root": "schemas/v1.1.0/commons",
157157
"examples_root": "examples/v1.1.0",
158158
"schemas_cid": "PENDING",
159-
"pin_status": "pending-publication"
159+
"pin_status": "https-published-ipfs-pending"
160160
},
161161
"pinned_canonical_release": {
162162
"version": "1.0.0",

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@commandlayer/commons",
33
"version": "1.1.0",
4-
"description": "Canonical Commons verbs and strict JSON Schemas for autonomous agents \u2014 active v1.1.0 working line, historical pinned v1.0.0 release, and cross-runtime interoperability.",
4+
"description": "Canonical Commons verbs and strict JSON Schemas for autonomous agents \u2014 active v1.1.0 HTTPS-hosted schema line, historical pinned v1.0.0 release, and cross-runtime interoperability.",
55
"private": false,
66
"type": "module",
77
"license": "MIT",

0 commit comments

Comments
 (0)