diff --git a/.changeset/space-conformance-alpha-20261105.md b/.changeset/space-conformance-alpha-20261105.md new file mode 100644 index 00000000..8054677a --- /dev/null +++ b/.changeset/space-conformance-alpha-20261105.md @@ -0,0 +1,12 @@ +--- +"@getcirrus/space-conformance": minor +--- + +Port the conformance suite to the 2026-11-05 spaces alpha (`0.0.0-spaces-alpha-20261105160032`). The catalogue grows from 24 to 92 checks, and every method and declared error in the vendored lexicons is now covered by a `must` check, apart from the takedown, suspension and deactivation errors, which are exempted with a reason because no black-box harness can arrange them. + +- Credentials are presented with the `Atproto-Space-Credential` scheme and an HTTP message signature by a P-256 key, and credentialed reads send `Atproto-Space-Want-Mac`. The DPoP helpers are gone; `createCredentialKey`, `spaceSigHeaders` and `encapsulate` replace them, all browser-safe. +- New checks cover the baseline policies, member management, credential issuance and refusals, signature and audience binding, MAC requests and verification, STAR archives, writer-set sequencing, notifications, revocation, and space and repo migration. +- Discovery checks resolve the target's DID by method and look for `#atproto_pds`, `#atproto` and a P-256 `#atproto_kem`, replacing the `#atproto_space_host` checks. +- `Target.plcDirectory` and `CheckContext.resolveDid` control DID resolution; the CLI takes `--plc`. `SyncerInbox` gains `respond()` so a harness can act as a managing app. `KeypairIdentityProvider` takes an async `didFor` and builds identity DID documents. +- The CLI's OAuth scope asks for `authority=*` on the probe space type, so refusals for spaces the user does not own reach the host's own checks. +- The coverage report lists exemptions and flags stale ones, and `space-conformance coverage` now exits non-zero on gaps. diff --git a/.changeset/space-conformance-alpha-20261112.md b/.changeset/space-conformance-alpha-20261112.md new file mode 100644 index 00000000..729c9b48 --- /dev/null +++ b/.changeset/space-conformance-alpha-20261112.md @@ -0,0 +1,12 @@ +--- +"@getcirrus/space-conformance": minor +--- + +Port the conformance suite to the 2026-11-12 spaces alpha (`0.0.0-spaces-alpha-20261112204144`). + +- Credentials come from `authorizeSpaceSync` (with `credentialKey`), and the writer set from `listWriters`, whose typed `repoWrite` / `repoRemoved` entries the checks now read. Member checks use the batched `putMembers` / `removeMembers`, and the managing-app checks use `checkAccess`, including the new tokenless call without a `repo`. +- MAC requests are `Accept-Signature` headers keyed by an HPKE-exported secret, and the full checks verify the MAC signatures that come back. Credential signatures are checked to be found by tag under any label, with `keyid`, `alg`, component and duplicate-signature refusals. +- Notification registration moves into `authorizeSpaceSync`'s `notify`. The `syncer-inbox` capability is now a webhook endpoint that answers `confirmRegistration` and receives `notifySpaceUpdate`. `createSyncerInbox()` provides one as a fetch-style handler. +- New checks cover `RegistrationNotConfirmed`, the `spaceRev` returned on authorisation, announced writer removals, `listRepoOps` commits on every page, the STAR content type, `InvalidRepoFile`, `RepoMismatch` and `InvalidSpaceMeta`. A slow check covers `registrationExpired`. +- Proposal 0016 citations are checked against its section anchors. The read methods' `SpaceNotFound` and every `InvalidCursor` are exempted from coverage with reasons, since nothing in the spec defines them. +- The probe space type declaration uses `title` in place of `name`. diff --git a/.changeset/spaces-alpha-20261105.md b/.changeset/spaces-alpha-20261105.md new file mode 100644 index 00000000..13bc3a58 --- /dev/null +++ b/.changeset/spaces-alpha-20261105.md @@ -0,0 +1,18 @@ +--- +"@getcirrus/pds": minor +"@getcirrus/spaces": minor +"@getcirrus/oauth-provider": patch +"create-pds": patch +--- + +Update atproto spaces to the 2026-11-05 alpha (`0.0.0-spaces-alpha-20261105160032`). This is a breaking alpha change: existing space data refuses to open until you run `pds spaces reset`, and apps built against the earlier alpha need updating. + +- Space credentials are bound to a P-256 key and presented with the `Atproto-Space-Credential` scheme and an HTTP message signature, replacing DPoP. `getSpaceCredential` takes the key, delegation token and client attestation in its body, and public-read spaces issue credentials without a delegation token. +- Commits are no longer signed. Syncers verify space data with a MAC derived against a new `#atproto_kem` key. Run `pds spaces kem` to create it; on did:plc, `pds spaces kem --publish` adds it to your DID document. `pds spaces status` checks that it is published. +- `com.atproto.simplespace` is replaced by the personalspace, memberspace and managedspace policies, managed with `com.atproto.space.{create,update,delete,get}Space` and `com.atproto.memberspace.*`. Members can be given read or write access separately, and a space can publish its policy and member list to readers. +- `getRepo` serves a STAR archive, streamed rather than buffered. +- Writes are sequenced by space revision, and notifications to a space hosted elsewhere are retried for up to 24 hours. +- New: `clearRecords`, `removeWriter`, `importRepo`, `exportSpaceMeta` and `importSpaceMeta`. `pds spaces export` writes STAR archives that the new import endpoints accept. +- The DID document no longer has an `#atproto_space_host` service entry. + +`@getcirrus/spaces` now bundles `@atproto/space` and its alpha dependencies, several of which have broken releases that package managers would otherwise install in their place. diff --git a/.changeset/spaces-alpha-20261112.md b/.changeset/spaces-alpha-20261112.md new file mode 100644 index 00000000..1c718d6a --- /dev/null +++ b/.changeset/spaces-alpha-20261112.md @@ -0,0 +1,16 @@ +--- +"@getcirrus/pds": minor +"@getcirrus/spaces": minor +"@getcirrus/oauth-provider": minor +--- + +Update atproto spaces to the 2026-11-12 alpha (`0.0.0-spaces-alpha-20261112204144`). This is a breaking alpha change: the space schema moves to version 3, so existing space data refuses to open until you run `pds spaces reset`, and apps and syncers built against the 2026-11-05 alpha need updating. + +- Renamed methods: `getSpaceCredential` is now `authorizeSpaceSync` (taking `credentialKey`), `listRepos` is `listWriters`, `notifyWrite` is `notifyRepoUpdate`, `notifyCredentialRevoked` is `notifyCredentialsRevoked` and the managing app's `checkUserAccess` is `checkAccess`. `putMember` / `removeMember` are replaced by batched `putMembers` / `removeMembers` (up to 100 at a time, in one commit). +- Syncers register for notifications by passing a webhook endpoint and token to `authorizeSpaceSync`, which the space host confirms with the syncer's `confirmRegistration` before issuing. Updates go to its `notifySpaceUpdate`; a lapsed registration gets one `registrationExpired` notice, and deleting a space tells every registered syncer, retried for up to 72 hours. `registerNotify`, `unregisterNotify` and `notifySpaceDeleted` are gone. +- Removing a writer is sequenced and announced, and `listWriters` lists removals. +- MACs are HTTP message signatures, requested with `Accept-Signature` and covering an `Atproto-Space-Commit` or `Atproto-Space-Record` header. STAR archives use the `application/vnd.dasl.star` media type. +- A managed space's `managingApp` must name a service (`did#service`). If the app fails, the request fails with `UpstreamFailure` rather than being refused. Under `publicWrite`, a member denied write stays excluded. +- `listRepoOps` returns the commit on every page; `listSpaces` returns each space's repo revision, digest and space revision. +- Error codes renamed: `NotSpaceOwner` → `NotAuthorized`, `UserNotAuthorized` → `AccountNotAuthorized`, `BadSpaceMac` → `InvalidSpaceMac`, `MalformedCursor` → `InvalidCursor`. +- oauth-provider: space permissions carry `spaceType` rather than `type`, space declarations use `title`, and a new `allowsSpace(permissions, check)` helper matches requests against granted scopes. diff --git a/.github/workflows/pkg-pr-new.yml b/.github/workflows/pkg-pr-new.yml index 1b4625aa..07db69b8 100644 --- a/.github/workflows/pkg-pr-new.yml +++ b/.github/workflows/pkg-pr-new.yml @@ -19,7 +19,7 @@ jobs: - name: Setup Node uses: actions/setup-node@v6 with: - node-version: latest + node-version: "lts/*" cache: "pnpm" - name: Install dependencies diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index c1af27d9..b75b1863 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -34,7 +34,7 @@ jobs: - name: Setup Node uses: actions/setup-node@v6 with: - node-version: latest + node-version: "lts/*" cache: "pnpm" - name: Install Dependencies diff --git a/apps/check/src/App.tsx b/apps/check/src/App.tsx index 60f495f6..72fa0739 100644 --- a/apps/check/src/App.tsx +++ b/apps/check/src/App.tsx @@ -763,14 +763,15 @@ function ConfirmSpacesView(props: { collections inside those probe spaces
getDelegationToken →{" "}
- getSpaceCredential →
- read flow
+ · Obtain space credentials for the
+ probe spaces (including through your PDS's own{" "}
+ getDelegationToken)
+ and present them with signed, MAC-requesting reads
diff --git a/apps/check/src/SpacesConformanceView.tsx b/apps/check/src/SpacesConformanceView.tsx
index 04379e98..79affeee 100644
--- a/apps/check/src/SpacesConformanceView.tsx
+++ b/apps/check/src/SpacesConformanceView.tsx
@@ -2,27 +2,34 @@
* Runner #3: the browser adapter for the spaces conformance suite.
*
* Signed in (the landing-page flow), the run carries the operator, blob
- * and delegation capabilities: probe spaces, record writes, applyWrites
- * atomicity, blob isolation and the operator's own delegation → credential
- * → read flow all execute for real against the user's PDS, authenticated
- * through the DPoP-bound OAuth session. Results stream into the table as
- * each check lands.
+ * and delegation capabilities: space management and the baseline
+ * policies, record writes, blob isolation, credential issuance through
+ * authorizeSpaceSync, and credential presentation — HTTP-signed reads with
+ * an Accept-Signature MAC request keyed by an HPKE-exported secret — all
+ * execute for real against the user's PDS.
+ * Operator calls go through the OAuth session; credential-presenting calls
+ * carry their own WebCrypto P-256 signatures. Results stream into the
+ * table as each check lands.
*
* The checks a browser genuinely cannot run — harness-held foreign
- * identities, the alpha crypto libs — are not shown at all: a row (or a
- * count) implies a way they could have run here, and there isn't one.
- * They are covered by the CLI and vitest runners.
+ * identities, a syncer inbox, MAC verification with the alpha crypto libs
+ * — are not shown at all: a row (or a count) implies a way they could have
+ * run here, and there isn't one. They are covered by the CLI and vitest
+ * runners.
*
* Without a session it degrades to the anonymous slice (discovery and
- * unauthenticated request shapes) against any host the user names.
+ * unauthenticated request shapes) against any host or DID the user names.
*/
import { createSignal, For, onMount, Show } from "solid-js";
import {
+ ALPHA_BUILD,
browserCatalog,
filterCatalog,
operatorChecks,
+ resolveDidDocument,
runChecks,
+ serviceEndpoint,
type CheckContext,
type CheckResult,
type RunReport,
@@ -44,11 +51,38 @@ async function resolveDid(origin: string): Promise