From 689d585aa31055c1fd071d319b4fbcfe61e85458 Mon Sep 17 00:00:00 2001 From: "mixie-bot[bot]" <127146692+mixie-bot[bot]@users.noreply.github.com> Date: Fri, 20 Nov 2026 07:36:14 +0000 Subject: [PATCH] ci: release --- .changeset/alpha-dependency-pins.md | 7 --- .changeset/canonical-list-record-blobs.md | 5 -- .changeset/cli-handle-http-resolution.md | 5 -- .changeset/cors-authorization-header.md | 5 -- .changeset/plc-identity-auth.md | 5 -- .changeset/plc-rotation-keys.md | 11 ---- .changeset/probe-lexicons.md | 5 -- .changeset/relay-crawl-self-heal.md | 5 -- .../space-conformance-alpha-20261105.md | 12 ---- .../space-conformance-alpha-20261112.md | 13 ---- .changeset/space-conformance-initial.md | 5 -- .changeset/space-declaration-resolution.md | 5 -- .changeset/spaces-alpha-20261105.md | 18 ------ .changeset/spaces-alpha-20261112.md | 24 -------- .changeset/template-space-do-exports.md | 5 -- packages/create-pds/CHANGELOG.md | 18 ++++++ packages/create-pds/package.json | 2 +- packages/oauth-provider/CHANGELOG.md | 39 ++++++++++++ packages/oauth-provider/package.json | 2 +- packages/pds/CHANGELOG.md | 60 +++++++++++++++++++ packages/pds/package.json | 2 +- packages/space-conformance/CHANGELOG.md | 32 ++++++++++ packages/space-conformance/package.json | 2 +- packages/spaces/CHANGELOG.md | 39 ++++++++++++ packages/spaces/package.json | 2 +- 25 files changed, 193 insertions(+), 135 deletions(-) delete mode 100644 .changeset/alpha-dependency-pins.md delete mode 100644 .changeset/canonical-list-record-blobs.md delete mode 100644 .changeset/cli-handle-http-resolution.md delete mode 100644 .changeset/cors-authorization-header.md delete mode 100644 .changeset/plc-identity-auth.md delete mode 100644 .changeset/plc-rotation-keys.md delete mode 100644 .changeset/probe-lexicons.md delete mode 100644 .changeset/relay-crawl-self-heal.md delete mode 100644 .changeset/space-conformance-alpha-20261105.md delete mode 100644 .changeset/space-conformance-alpha-20261112.md delete mode 100644 .changeset/space-conformance-initial.md delete mode 100644 .changeset/space-declaration-resolution.md delete mode 100644 .changeset/spaces-alpha-20261105.md delete mode 100644 .changeset/spaces-alpha-20261112.md delete mode 100644 .changeset/template-space-do-exports.md create mode 100644 packages/space-conformance/CHANGELOG.md diff --git a/.changeset/alpha-dependency-pins.md b/.changeset/alpha-dependency-pins.md deleted file mode 100644 index fc784c82..00000000 --- a/.changeset/alpha-dependency-pins.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -"@getcirrus/pds": patch -"@getcirrus/spaces": patch -"@getcirrus/space-conformance": patch ---- - -Fix fresh installs failing with `"@atproto/lex-data@workspace:*" is in the dependencies but no package named "@atproto/lex-data" is present in the workspace` (or `Unsupported URL Type "workspace:"` under npm). This affected new projects created with `create-pds`, as well as any project installing these packages without an existing lockfile. diff --git a/.changeset/canonical-list-record-blobs.md b/.changeset/canonical-list-record-blobs.md deleted file mode 100644 index 523e073a..00000000 --- a/.changeset/canonical-list-record-blobs.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/pds": patch ---- - -Return canonical AT Protocol blob objects from `com.atproto.repo.listRecords`. Repository iteration decodes blobs as compatibility `BlobRef` instances; these are now serialized through their JSON representation instead of leaking the internal `original` field and omitting the outer `$type: "blob"`. diff --git a/.changeset/cli-handle-http-resolution.md b/.changeset/cli-handle-http-resolution.md deleted file mode 100644 index 64ac2135..00000000 --- a/.changeset/cli-handle-http-resolution.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/pds": patch ---- - -`pds init` can now find accounts with hosted handles such as `*.bsky.social` when migrating. It only looked for a DNS TXT record, which those handles don't have, so it reported "Failed to resolve handle". The CLI now also checks `/.well-known/atproto-did`, which also fixes the handle checks in `pds activate` and `pds deactivate`. diff --git a/.changeset/cors-authorization-header.md b/.changeset/cors-authorization-header.md deleted file mode 100644 index 558ddb1c..00000000 --- a/.changeset/cors-authorization-header.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/pds": patch ---- - -Allow the `Authorization` header in cross-origin requests. Browser clients sending a bearer token were previously blocked at CORS preflight in Firefox and Safari. diff --git a/.changeset/plc-identity-auth.md b/.changeset/plc-identity-auth.md deleted file mode 100644 index ac91d5f2..00000000 --- a/.changeset/plc-identity-auth.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/pds": patch ---- - -Signing PLC operations (`com.atproto.identity.signPlcOperation`) and generating migration tokens now require your account password, the `AUTH_TOKEN`, or an OAuth grant that includes `identity:*`. App passwords, OAuth tokens without that permission, and service auth tokens are refused. Previously any signed-in app could request a migration token and have your PDS sign a change to your identity. diff --git a/.changeset/plc-rotation-keys.md b/.changeset/plc-rotation-keys.md deleted file mode 100644 index 7fbfc11b..00000000 --- a/.changeset/plc-rotation-keys.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -"@getcirrus/pds": minor ---- - -Migrating a `did:plc` account with `pds identity` now gives your PDS control of your identity. Previously the PDS you migrated from kept the only rotation key, so Cirrus couldn't sign changes to your DID: it couldn't change your handle or rotate its signing key, and migrating away from Cirrus failed at the PLC directory. `pds identity` now makes your PDS's signing key a rotation key, removes the previous PDS's key, and offers to create a recovery key that ranks above it. The recovery key works with `goat` if you ever need to recover your identity without your PDS. - -Accounts that were already migrated can run the new `pds rotation-keys` command to fix this. The change can be signed by your previous PDS (with your password there and an email code), by a rotation key you hold, or by your PDS once it is a rotation key. `pds status` now reports whether your PDS can update your identity, and outbound migration explains the problem instead of failing at the PLC directory. - -`pds identity` also sets your handle in the PLC directory to the one configured for your PDS. Previously, migrating from a `*.bsky.social` handle to a custom domain left the old handle in your DID document, so apps showed the new handle as invalid. `pds init` now explains that the handle you choose takes effect during `pds identity` and how to verify it, and `pds identity` checks the new handle resolves to your DID before changing anything. - -`pds identity --token` also works now. It previously skipped the login that signing needs. diff --git a/.changeset/probe-lexicons.md b/.changeset/probe-lexicons.md deleted file mode 100644 index 37e44115..00000000 --- a/.changeset/probe-lexicons.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/space-conformance": patch ---- - -Probe spaces now use published, resolvable lexicons (`earth.cirrus.check.space` / `.note` / `.withblob`) instead of the unpublished `app.bsky.group` type and unresolvable `test.conformance.*` collections, so the suite works against implementations that resolve lexicons dynamically and validate strictly — not only against lenient targets. diff --git a/.changeset/relay-crawl-self-heal.md b/.changeset/relay-crawl-self-heal.md deleted file mode 100644 index a6ebf5a1..00000000 --- a/.changeset/relay-crawl-self-heal.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/pds": minor ---- - -The PDS now re-adds itself to the relay's crawl list automatically. When a write commits while no relay is subscribed to the firehose, it sends `com.atproto.sync.requestCrawl` to the configured relays — rate-limited, and without delaying the write. Previously a relay that had marked the host offline would silently stop federating your posts until someone requested a crawl by hand. Relays default to `https://bsky.network` and can be overridden with the optional comma-separated `RELAYS` environment variable. diff --git a/.changeset/space-conformance-alpha-20261105.md b/.changeset/space-conformance-alpha-20261105.md deleted file mode 100644 index 8054677a..00000000 --- a/.changeset/space-conformance-alpha-20261105.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -"@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 deleted file mode 100644 index 6b1606d0..00000000 --- a/.changeset/space-conformance-alpha-20261112.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -"@getcirrus/space-conformance": minor ---- - -Port the conformance suite to the 2026-11-12 spaces protocol, pinned to the 2026-11-17 alpha (`0.0.0-spaces-alpha-20261117141222`). - -- 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`. -- `request.garbage-cursor-rejected` filters its `listSpaces` call to the probe type, so it runs under an OAuth session scoped to that type instead of failing with `InsufficientScope`. diff --git a/.changeset/space-conformance-initial.md b/.changeset/space-conformance-initial.md deleted file mode 100644 index 8e46f9d8..00000000 --- a/.changeset/space-conformance-initial.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/space-conformance": minor ---- - -First release of `@getcirrus/space-conformance`: a black-box conformance suite for atproto spaces implementations. This release carries the core check model (tiered MUST/SHOULD/INFO checks with machine-readable citations), the capability-aware catalog runner with honest skip reporting, the vendored spaces lexicons, and the coverage generator that derives required checks from every lexicon method and declared error name. diff --git a/.changeset/space-declaration-resolution.md b/.changeset/space-declaration-resolution.md deleted file mode 100644 index ae6295e3..00000000 --- a/.changeset/space-declaration-resolution.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@getcirrus/oauth-provider": patch ---- - -Fix `space:` scope resolution in the consent UI. `@atcute/lexicon-resolver` validates fetched lexicon documents against `@atcute/lexicon-doc`, whose def-type whitelist has no `type: "space"`, so a correctly published space type declaration failed with `InvalidLexiconSchemaError` and the consent screen showed "could not resolve space type declaration" for every space scope. `resolveSpaceDeclaration` now replicates the resolver's authenticated steps itself — resolve the DID document, fetch the record proof CAR, and verify the commit signature — then validates `defs.main` against the local space shape, keeping full proof verification while tolerating the unknown def type. The workaround can be removed once upstream `@atcute/lexicon-doc` gains the `space` def type. diff --git a/.changeset/spaces-alpha-20261105.md b/.changeset/spaces-alpha-20261105.md deleted file mode 100644 index 13bc3a58..00000000 --- a/.changeset/spaces-alpha-20261105.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -"@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 deleted file mode 100644 index 8d0accc0..00000000 --- a/.changeset/spaces-alpha-20261112.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -"@getcirrus/pds": minor -"@getcirrus/spaces": minor -"@getcirrus/oauth-provider": minor ---- - -Update atproto spaces to the 2026-11-17 alpha (`0.0.0-spaces-alpha-20261117141222`), which carries the 2026-11-12 protocol changes. 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. - -To upgrade a PDS with spaces enabled: - -1. Deploy, then run `pds spaces reset`. Space endpoints answer 503 until you do. -2. If you haven't already, create the `#atproto_kem` key with `pds spaces kem`. Without it, every credentialed read that needs a MAC (`getRecord`, `getLatestCommit`, `getRepo`, `listRepoOps`) fails with `503 KemKeyUnavailable`, so other apps and syncers can't read your spaces. The command stores the private key as the `SPACES_KEM_KEY` secret and the public key as `SPACES_KEM_KEY_PUBLIC`; then redeploy. -3. On did:plc, publish the key in your DID document with `pds spaces kem --publish`. Your PDS signs the PLC operation, so its signing key must be one of your DID's rotation keys: if it isn't, run `pds rotation-keys` first. On did:web, the redeploy publishes it. -4. Run `pds spaces status` to check that the key your PDS holds is the one your DID document publishes. -5. A managed space's managing app must now be named as `did#service`. - -- 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/.changeset/template-space-do-exports.md b/.changeset/template-space-do-exports.md deleted file mode 100644 index d90b1866..00000000 --- a/.changeset/template-space-do-exports.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"create-pds": patch ---- - -Fix deploys of freshly scaffolded workers failing with "Cannot apply new-class migration to class 'SpaceDurableObject' that is not exported by script". The generated worker entry now exports the Space Durable Object classes that its wrangler config declares. diff --git a/packages/create-pds/CHANGELOG.md b/packages/create-pds/CHANGELOG.md index 6e500dbb..abc9340c 100644 --- a/packages/create-pds/CHANGELOG.md +++ b/packages/create-pds/CHANGELOG.md @@ -1,5 +1,23 @@ # create-pds +## 0.1.1 + +### Patch Changes + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - 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. + +- [#248](https://github.com/ascorbic/cirrus/pull/248) [`e6703d5`](https://github.com/ascorbic/cirrus/commit/e6703d513cb36384a53eb80512814727ded7171a) Thanks [@ascorbic](https://github.com/ascorbic)! - Fix deploys of freshly scaffolded workers failing with "Cannot apply new-class migration to class 'SpaceDurableObject' that is not exported by script". The generated worker entry now exports the Space Durable Object classes that its wrangler config declares. + ## 0.1.0 ### Minor Changes diff --git a/packages/create-pds/package.json b/packages/create-pds/package.json index 85a2587a..c229cca4 100644 --- a/packages/create-pds/package.json +++ b/packages/create-pds/package.json @@ -1,6 +1,6 @@ { "name": "create-pds", - "version": "0.1.0", + "version": "0.1.1", "description": "Create a new Cirrus AT Protocol PDS on Cloudflare Workers", "type": "module", "bin": { diff --git a/packages/oauth-provider/CHANGELOG.md b/packages/oauth-provider/CHANGELOG.md index 50f47c7b..0931f4fe 100644 --- a/packages/oauth-provider/CHANGELOG.md +++ b/packages/oauth-provider/CHANGELOG.md @@ -1,5 +1,44 @@ # @getcirrus/oauth-provider +## 0.7.0 + +### Minor Changes + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - Update atproto spaces to the 2026-11-17 alpha (`0.0.0-spaces-alpha-20261117141222`), which carries the 2026-11-12 protocol changes. 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. + + To upgrade a PDS with spaces enabled: + + 1. Deploy, then run `pds spaces reset`. Space endpoints answer 503 until you do. + 2. If you haven't already, create the `#atproto_kem` key with `pds spaces kem`. Without it, every credentialed read that needs a MAC (`getRecord`, `getLatestCommit`, `getRepo`, `listRepoOps`) fails with `503 KemKeyUnavailable`, so other apps and syncers can't read your spaces. The command stores the private key as the `SPACES_KEM_KEY` secret and the public key as `SPACES_KEM_KEY_PUBLIC`; then redeploy. + 3. On did:plc, publish the key in your DID document with `pds spaces kem --publish`. Your PDS signs the PLC operation, so its signing key must be one of your DID's rotation keys: if it isn't, run `pds rotation-keys` first. On did:web, the redeploy publishes it. + 4. Run `pds spaces status` to check that the key your PDS holds is the one your DID document publishes. + 5. A managed space's managing app must now be named as `did#service`. + + - 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. + +### Patch Changes + +- [#239](https://github.com/ascorbic/cirrus/pull/239) [`0adc5fb`](https://github.com/ascorbic/cirrus/commit/0adc5fbd6426b1c6500088ae5e20aa8b43346e34) Thanks [@ascorbic](https://github.com/ascorbic)! - Fix `space:` scope resolution in the consent UI. `@atcute/lexicon-resolver` validates fetched lexicon documents against `@atcute/lexicon-doc`, whose def-type whitelist has no `type: "space"`, so a correctly published space type declaration failed with `InvalidLexiconSchemaError` and the consent screen showed "could not resolve space type declaration" for every space scope. `resolveSpaceDeclaration` now replicates the resolver's authenticated steps itself — resolve the DID document, fetch the record proof CAR, and verify the commit signature — then validates `defs.main` against the local space shape, keeping full proof verification while tolerating the unknown def type. The workaround can be removed once upstream `@atcute/lexicon-doc` gains the `space` def type. + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - 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. + ## 0.6.0 ### Minor Changes diff --git a/packages/oauth-provider/package.json b/packages/oauth-provider/package.json index 3c11e741..bd8dc48d 100644 --- a/packages/oauth-provider/package.json +++ b/packages/oauth-provider/package.json @@ -1,6 +1,6 @@ { "name": "@getcirrus/oauth-provider", - "version": "0.6.0", + "version": "0.7.0", "description": "OAuth 2.1 Provider with AT Protocol extensions for Cloudflare Workers", "type": "module", "main": "dist/index.js", diff --git a/packages/pds/CHANGELOG.md b/packages/pds/CHANGELOG.md index ac4c6402..cedad506 100644 --- a/packages/pds/CHANGELOG.md +++ b/packages/pds/CHANGELOG.md @@ -1,5 +1,65 @@ # @getcirrus/pds +## 0.20.0 + +### Minor Changes + +- [#253](https://github.com/ascorbic/cirrus/pull/253) [`323aecf`](https://github.com/ascorbic/cirrus/commit/323aecf9b95f14dbd8e63a1878413828497c7515) Thanks [@ascorbic](https://github.com/ascorbic)! - Migrating a `did:plc` account with `pds identity` now gives your PDS control of your identity. Previously the PDS you migrated from kept the only rotation key, so Cirrus couldn't sign changes to your DID: it couldn't change your handle or rotate its signing key, and migrating away from Cirrus failed at the PLC directory. `pds identity` now makes your PDS's signing key a rotation key, removes the previous PDS's key, and offers to create a recovery key that ranks above it. The recovery key works with `goat` if you ever need to recover your identity without your PDS. + + Accounts that were already migrated can run the new `pds rotation-keys` command to fix this. The change can be signed by your previous PDS (with your password there and an email code), by a rotation key you hold, or by your PDS once it is a rotation key. `pds status` now reports whether your PDS can update your identity, and outbound migration explains the problem instead of failing at the PLC directory. + + `pds identity` also sets your handle in the PLC directory to the one configured for your PDS. Previously, migrating from a `*.bsky.social` handle to a custom domain left the old handle in your DID document, so apps showed the new handle as invalid. `pds init` now explains that the handle you choose takes effect during `pds identity` and how to verify it, and `pds identity` checks the new handle resolves to your DID before changing anything. + + `pds identity --token` also works now. It previously skipped the login that signing needs. + +- [#229](https://github.com/ascorbic/cirrus/pull/229) [`ded340f`](https://github.com/ascorbic/cirrus/commit/ded340f876f280c321714608833399bb481b0240) Thanks [@ascorbic](https://github.com/ascorbic)! - The PDS now re-adds itself to the relay's crawl list automatically. When a write commits while no relay is subscribed to the firehose, it sends `com.atproto.sync.requestCrawl` to the configured relays — rate-limited, and without delaying the write. Previously a relay that had marked the host offline would silently stop federating your posts until someone requested a crawl by hand. Relays default to `https://bsky.network` and can be overridden with the optional comma-separated `RELAYS` environment variable. + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - 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. + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - Update atproto spaces to the 2026-11-17 alpha (`0.0.0-spaces-alpha-20261117141222`), which carries the 2026-11-12 protocol changes. 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. + + To upgrade a PDS with spaces enabled: + + 1. Deploy, then run `pds spaces reset`. Space endpoints answer 503 until you do. + 2. If you haven't already, create the `#atproto_kem` key with `pds spaces kem`. Without it, every credentialed read that needs a MAC (`getRecord`, `getLatestCommit`, `getRepo`, `listRepoOps`) fails with `503 KemKeyUnavailable`, so other apps and syncers can't read your spaces. The command stores the private key as the `SPACES_KEM_KEY` secret and the public key as `SPACES_KEM_KEY_PUBLIC`; then redeploy. + 3. On did:plc, publish the key in your DID document with `pds spaces kem --publish`. Your PDS signs the PLC operation, so its signing key must be one of your DID's rotation keys: if it isn't, run `pds rotation-keys` first. On did:web, the redeploy publishes it. + 4. Run `pds spaces status` to check that the key your PDS holds is the one your DID document publishes. + 5. A managed space's managing app must now be named as `did#service`. + + - 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. + +### Patch Changes + +- [#255](https://github.com/ascorbic/cirrus/pull/255) [`de476f5`](https://github.com/ascorbic/cirrus/commit/de476f57ba1fb936c6480a8fc278b6c7fc250cab) Thanks [@ascorbic](https://github.com/ascorbic)! - Fix fresh installs failing with `"@atproto/lex-data@workspace:*" is in the dependencies but no package named "@atproto/lex-data" is present in the workspace` (or `Unsupported URL Type "workspace:"` under npm). This affected new projects created with `create-pds`, as well as any project installing these packages without an existing lockfile. + +- [#241](https://github.com/ascorbic/cirrus/pull/241) [`df99d50`](https://github.com/ascorbic/cirrus/commit/df99d50883361a0e508b13865fc792381b3d33f2) Thanks [@sn0opy](https://github.com/sn0opy)! - Return canonical AT Protocol blob objects from `com.atproto.repo.listRecords`. Repository iteration decodes blobs as compatibility `BlobRef` instances; these are now serialized through their JSON representation instead of leaking the internal `original` field and omitting the outer `$type: "blob"`. + +- [#253](https://github.com/ascorbic/cirrus/pull/253) [`323aecf`](https://github.com/ascorbic/cirrus/commit/323aecf9b95f14dbd8e63a1878413828497c7515) Thanks [@ascorbic](https://github.com/ascorbic)! - `pds init` can now find accounts with hosted handles such as `*.bsky.social` when migrating. It only looked for a DNS TXT record, which those handles don't have, so it reported "Failed to resolve handle". The CLI now also checks `/.well-known/atproto-did`, which also fixes the handle checks in `pds activate` and `pds deactivate`. + +- [#197](https://github.com/ascorbic/cirrus/pull/197) [`ef2f310`](https://github.com/ascorbic/cirrus/commit/ef2f310e18aa753294bd9a971f9209732ec918c5) Thanks [@jphastings](https://github.com/jphastings)! - Allow the `Authorization` header in cross-origin requests. Browser clients sending a bearer token were previously blocked at CORS preflight in Firefox and Safari. + +- [#253](https://github.com/ascorbic/cirrus/pull/253) [`323aecf`](https://github.com/ascorbic/cirrus/commit/323aecf9b95f14dbd8e63a1878413828497c7515) Thanks [@ascorbic](https://github.com/ascorbic)! - Signing PLC operations (`com.atproto.identity.signPlcOperation`) and generating migration tokens now require your account password, the `AUTH_TOKEN`, or an OAuth grant that includes `identity:*`. App passwords, OAuth tokens without that permission, and service auth tokens are refused. Previously any signed-in app could request a migration token and have your PDS sign a change to your identity. +- Updated dependencies [[`de476f5`](https://github.com/ascorbic/cirrus/commit/de476f57ba1fb936c6480a8fc278b6c7fc250cab), [`0adc5fb`](https://github.com/ascorbic/cirrus/commit/0adc5fbd6426b1c6500088ae5e20aa8b43346e34), [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224), [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224)]: + - @getcirrus/spaces@0.2.0 + - @getcirrus/oauth-provider@0.7.0 + ## 0.19.0 ### Minor Changes diff --git a/packages/pds/package.json b/packages/pds/package.json index 2bb99759..3b1177b6 100644 --- a/packages/pds/package.json +++ b/packages/pds/package.json @@ -1,6 +1,6 @@ { "name": "@getcirrus/pds", - "version": "0.19.0", + "version": "0.20.0", "description": "Cirrus – A single-user AT Protocol PDS on Cloudflare Workers", "type": "module", "main": "dist/index.js", diff --git a/packages/space-conformance/CHANGELOG.md b/packages/space-conformance/CHANGELOG.md new file mode 100644 index 00000000..468f22fa --- /dev/null +++ b/packages/space-conformance/CHANGELOG.md @@ -0,0 +1,32 @@ +# @getcirrus/space-conformance + +## 0.1.0 + +### Minor Changes + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - 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. + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - Port the conformance suite to the 2026-11-12 spaces protocol, pinned to the 2026-11-17 alpha (`0.0.0-spaces-alpha-20261117141222`). + + - 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`. + - `request.garbage-cursor-rejected` filters its `listSpaces` call to the probe type, so it runs under an OAuth session scoped to that type instead of failing with `InsufficientScope`. + +- [#230](https://github.com/ascorbic/cirrus/pull/230) [`2261832`](https://github.com/ascorbic/cirrus/commit/2261832c3f158e4422b5079ed159d7e703a2bde4) Thanks [@ascorbic](https://github.com/ascorbic)! - First release of `@getcirrus/space-conformance`: a black-box conformance suite for atproto spaces implementations. This release carries the core check model (tiered MUST/SHOULD/INFO checks with machine-readable citations), the capability-aware catalog runner with honest skip reporting, the vendored spaces lexicons, and the coverage generator that derives required checks from every lexicon method and declared error name. + +### Patch Changes + +- [#255](https://github.com/ascorbic/cirrus/pull/255) [`de476f5`](https://github.com/ascorbic/cirrus/commit/de476f57ba1fb936c6480a8fc278b6c7fc250cab) Thanks [@ascorbic](https://github.com/ascorbic)! - Fix fresh installs failing with `"@atproto/lex-data@workspace:*" is in the dependencies but no package named "@atproto/lex-data" is present in the workspace` (or `Unsupported URL Type "workspace:"` under npm). This affected new projects created with `create-pds`, as well as any project installing these packages without an existing lockfile. + +- [#238](https://github.com/ascorbic/cirrus/pull/238) [`a55ac49`](https://github.com/ascorbic/cirrus/commit/a55ac492b556b4b294b28818a4eb3d0ff3664344) Thanks [@ascorbic](https://github.com/ascorbic)! - Probe spaces now use published, resolvable lexicons (`earth.cirrus.check.space` / `.note` / `.withblob`) instead of the unpublished `app.bsky.group` type and unresolvable `test.conformance.*` collections, so the suite works against implementations that resolve lexicons dynamically and validate strictly — not only against lenient targets. diff --git a/packages/space-conformance/package.json b/packages/space-conformance/package.json index c3e79c96..a5cc4764 100644 --- a/packages/space-conformance/package.json +++ b/packages/space-conformance/package.json @@ -1,6 +1,6 @@ { "name": "@getcirrus/space-conformance", - "version": "0.0.0", + "version": "0.1.0", "description": "Black-box conformance suite for atproto spaces implementations (alpha)", "type": "module", "main": "dist/index.js", diff --git a/packages/spaces/CHANGELOG.md b/packages/spaces/CHANGELOG.md index 5b1c948f..489dfe85 100644 --- a/packages/spaces/CHANGELOG.md +++ b/packages/spaces/CHANGELOG.md @@ -1,5 +1,44 @@ # @getcirrus/spaces +## 0.2.0 + +### Minor Changes + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - 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. + +- [#256](https://github.com/ascorbic/cirrus/pull/256) [`9ca9c2f`](https://github.com/ascorbic/cirrus/commit/9ca9c2f5824a19d31febf24d5f358dcddc88f224) Thanks [@ascorbic](https://github.com/ascorbic)! - Update atproto spaces to the 2026-11-17 alpha (`0.0.0-spaces-alpha-20261117141222`), which carries the 2026-11-12 protocol changes. 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. + + To upgrade a PDS with spaces enabled: + + 1. Deploy, then run `pds spaces reset`. Space endpoints answer 503 until you do. + 2. If you haven't already, create the `#atproto_kem` key with `pds spaces kem`. Without it, every credentialed read that needs a MAC (`getRecord`, `getLatestCommit`, `getRepo`, `listRepoOps`) fails with `503 KemKeyUnavailable`, so other apps and syncers can't read your spaces. The command stores the private key as the `SPACES_KEM_KEY` secret and the public key as `SPACES_KEM_KEY_PUBLIC`; then redeploy. + 3. On did:plc, publish the key in your DID document with `pds spaces kem --publish`. Your PDS signs the PLC operation, so its signing key must be one of your DID's rotation keys: if it isn't, run `pds rotation-keys` first. On did:web, the redeploy publishes it. + 4. Run `pds spaces status` to check that the key your PDS holds is the one your DID document publishes. + 5. A managed space's managing app must now be named as `did#service`. + + - 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. + +### Patch Changes + +- [#255](https://github.com/ascorbic/cirrus/pull/255) [`de476f5`](https://github.com/ascorbic/cirrus/commit/de476f57ba1fb936c6480a8fc278b6c7fc250cab) Thanks [@ascorbic](https://github.com/ascorbic)! - Fix fresh installs failing with `"@atproto/lex-data@workspace:*" is in the dependencies but no package named "@atproto/lex-data" is present in the workspace` (or `Unsupported URL Type "workspace:"` under npm). This affected new projects created with `create-pds`, as well as any project installing these packages without an existing lockfile. + ## 0.1.0 ### Minor Changes diff --git a/packages/spaces/package.json b/packages/spaces/package.json index d3d6d033..564f4f35 100644 --- a/packages/spaces/package.json +++ b/packages/spaces/package.json @@ -1,6 +1,6 @@ { "name": "@getcirrus/spaces", - "version": "0.1.0", + "version": "0.2.0", "description": "Atproto spaces engine (alpha) for Cloudflare Workers – permissioned repos, space hosting and credentials", "type": "module", "main": "dist/index.js",