Title: Track: LWS protocol conformance (Oct 2026 drafts) — core vs plugin split, Touchstone as acceptance test · Issue #621 · JavaScriptSolidServer/JavaScriptSolidServer · GitHub
Open Graph Title: Track: LWS protocol conformance (Oct 2026 drafts) — core vs plugin split, Touchstone as acceptance test · Issue #621 · JavaScriptSolidServer/JavaScriptSolidServer
X Title: Track: LWS protocol conformance (Oct 2026 drafts) — core vs plugin split, Touchstone as acceptance test · Issue #621 · JavaScriptSolidServer/JavaScriptSolidServer
Description: Status (14 Oct 2026): the LWS implementation lives in linkedwebstorage/lwsd — a JSS plugin — and it passes 196 of 203 Touchstone tests (0 failed, 7 inapplicable: 3 SAML, 4 optional preconditions). Conformant. Per-module results: lwsd REA...
Open Graph Description: Status (14 Oct 2026): the LWS implementation lives in linkedwebstorage/lwsd — a JSS plugin — and it passes 196 of 203 Touchstone tests (0 failed, 7 inapplicable: 3 SAML, 4 optional preconditions). ...
X Description: Status (14 Oct 2026): the LWS implementation lives in linkedwebstorage/lwsd — a JSS plugin — and it passes 196 of 203 Touchstone tests (0 failed, 7 inapplicable: 3 SAML, 4 optional preconditions). ...
Opengraph URL: https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/621
X: @github
Domain: github.com
IPv4 address: 140.82.114.3
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Track: LWS protocol conformance (Oct 2026 drafts) — core vs plugin split, Touchstone as acceptance test","articleBody":"> **Status (14 Oct 2026): the LWS implementation lives in [linkedwebstorage/lwsd](https://github.com/linkedwebstorage/lwsd) — a JSS plugin — and it passes 196 of 203 [Touchstone](https://github.com/ebremer/touchstone) tests (0 failed, 7 inapplicable: 3 SAML, 4 optional preconditions). Conformant.** Per-module results: [lwsd README → Touchstone](https://github.com/linkedwebstorage/lwsd#touchstone). Landed in [lwsd#10](https://github.com/linkedwebstorage/lwsd/pull/10). What remains on *this* issue is the host-pod side (#622, #624/#604, #615, #625); #628 (QUERY in the host) is WONTFIX.\n\nUmbrella tracker for implementing the **W3C Linked Web Storage (LWS) protocol** in JSS against the current editor's drafts — core WD of **5 Oct 2026**, CID auth WD of **21 Sep 2026** — with [Touchstone](https://github.com/ebremer/touchstone) as the acceptance test.\n\nSupersedes #87 (`--lws-mode`, written against the Jan 2026 draft) and #89 (minimal LWS server — the ecosystem now has reference servers). Continues the auth work from #319 / #386.\n\n## Where JSS stands\n\nJSS covers the **authentication suite** reasonably well — CID v1 profiles, a self-signed LWS-CID JWT verifier (`src/auth/lws-cid.js`, [docs/lws.md](https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/blob/gh-pages/docs/lws.md)) — but implements **none of the core protocol surface**: no storage description, `lws+json` containers, pagination, linksets, merge-patch, `Depth`, problem+json, authorization server / token exchange, access grants or webhooks.\n\nTwo things have changed since our trackers were written:\n\n1. The auth model moved. The April FPWD let the self-signed CID JWT *be* the Bearer credential, which is what `lws-cid.js` does. The current draft has the client present a **subject token** (CID / did:key / OIDC) to the storage's **authorization server**, which exchanges it (RFC 8693) for an `at+jwt`; resources only ever see the `at+jwt`. Our verifier is now the legacy shape.\n2. There are now two complete reference points to measure against (below).\n\n## Reference implementations\n\n**Jesse Wright — CSS**\n- [`jeswr/LinkedWebStorage`](https://github.com/jeswr/LinkedWebStorage) — `@solid/community-server-lws`, a Components.js plugin for CSS v8. LWS alone or Solid+LWS dual mode, WAC or ACP. Touchstone core 116/116, webhook 11/11, auth 23/23.\n- Review PRs in his fork: [jeswr/CommunitySolidServer#124](https://github.com/jeswr/CommunitySolidServer/pull/124) (v7) and [#126](https://github.com/jeswr/CommunitySolidServer/pull/126) (v8). The PR body is the best single description of what a full implementation needs, including the ambiguity choices (storage URI = root container, `*/*` behaviour in dual mode, Bearer-with-`webid`-claim → Solid-OIDC, public storage description, grants only add to WAC/ACP).\n- Core hooks he needed upstream, all small: CSS [#2267](https://github.com/CommunitySolidServer/CommunitySolidServer/pull/2267) (conditions on description resources), [#2268](https://github.com/CommunitySolidServer/CommunitySolidServer/pull/2268) (identifiers on default handlers so they can be extended), [#2269](https://github.com/CommunitySolidServer/CommunitySolidServer/pull/2269) (ETags for `.meta`), [#2270](https://github.com/CommunitySolidServer/CommunitySolidServer/pull/2270) (412 instead of 304 on failed `If-Match` for GET/HEAD).\n- [`jeswr/lws-solid-diff`](https://github.com/jeswr/lws-solid-diff) — spec-level diff Solid Protocol vs LWS 1.0.\n\n**Erich Bremer — Touchstone and friends**\n- [`ebremer/touchstone`](https://github.com/ebremer/touchstone) — conformance harness. 101 YAML-LD tests, 296-requirement catalog covering core, all three auth suites, webhooks, type index and search. Ships as a Docker image and a **GitHub Action** (`ebremer/touchstone/.github/actions/lws-conformance@master`); EARL/HTML/JUnit reports.\n- [`ebremer/lws-server`](https://github.com/ebremer/lws-server) — Java reference server (Jakarta servlets).\n- [`ebremer/lws-client`](https://github.com/ebremer/lws-client) — clients in 11 languages including JS; useful for interop tests.\n- [`ebremer/lws-authn`](https://github.com/ebremer/lws-authn) — Keycloak extension, all four auth suites.\n- [`ebremer/lws-fuse`](https://github.com/ebremer/lws-fuse), [`ebremer/lws-drupal`](https://github.com/ebremer/lws-drupal).\n\n## Core vs plugin split\n\nThe JSS plugin seam (`src/plugins.js`, #206) is route-prefix based, so the split falls out naturally: the parts that touch every LDP response go in core; the parts that are their own services go in a plugin (`jss-plugin-lws`), given four small new seams that are useful to other plugins regardless.\n\n| Core (small, mostly spec-independent) | Plugin — works with today's API | Plugin — needs a new seam |\n|---|---|---|\n| 412 on failed `If-Match` / `If-Unmodified-Since` for GET/HEAD (cf. CSS #2270) | Authorization server: `/.well-known/lws-configuration`, RFC 8693 token exchange, JWKS, `at+jwt` issuance | `api.auth.registerVerifier()` — so pod resources accept the plugin's `at+jwt` |\n| ETags on `.meta` / description resources (cf. CSS #2269) | `/.notifications/lws/` subscription routes, RFC 9421-signed webhook delivery | `api.events.on('change')` — resource change feed for webhooks |\n| `Link rel=\"https://www.w3.org/ns/lws#storage\"`, `up`, `type`, `linkset` on responses | Access request / grant documents under `.lws/requests/` and `.lws/grants/` | `api.wac.registerReader()` — grants add permissions to WAC |\n| `application/lws+cid` storage description on pod root | did:key subject tokens (#86) | `api.headers.link()` / root `onSend` — add link relations on every response |\n| `application/lws+json` containers + `?page=N` pagination | `application/problem+json` on its own routes | |\n| `.meta` as RFC 9264 linkset + JSON Merge Patch (RFC 7386) | | |\n| `DELETE` with `Depth: infinity` | | |\n| `application/problem+json` for LDP errors | | |\n\nA caution from Jesse's dual-mode work: he had to pick what `application/ld+json` on a container returns and fails two Touchstone conneg MUSTs as a result. JSON-LD is JSS's native container format, so this collision is sharper for us — likely needs an explicit LWS-vs-Solid default per deployment.\n\n## Plan\n\n- [ ] Touchstone scoreboard: `scripts/lws-conformance.sh` (run locally, not on Actions) — baseline below\n- [ ] Plugin seams: #622 `api.auth.registerVerifier`, #623 `api.events.on`, #624 `api.wac.registerReader`, #625 `api.headers.link`\n- [ ] Core, phase 1: 412 fix, `.meta` ETags, `lws#storage` link, storage description, problem+json\n- [ ] Core, phase 2: `lws+json` containers, pagination, `up`/`type`/`linkset` links, 204 on writes\n- [ ] Core, phase 3: linkset + merge-patch, `Depth: infinity`\n- [ ] Plugin: authorization server + token exchange (subject tokens: CID, did:key #86, OIDC)\n- [ ] Plugin: access requests / grants\n- [ ] Plugin: webhook notifications\n- [ ] Decide `application/ld+json` container behaviour in dual mode\n- [ ] Later: server-managed type index / search (#535)\n\n## Related\n\n#319 #386 #86 #535 #206 #87 #89\n","author":{"url":"https://github.com/melvincarvalho","@type":"Person","name":"melvincarvalho"},"datePublished":"2026-10-14T17:05:06Z","url":"https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/621"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:dce7a04f-f4c1-c891-c765-7973b844380b |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | E944:102FBB:1BFA92:23930F:6B037B02 |
| html-safe-nonce | de05e876fb71ccf5eb0ab004d73bb0e104ce16052028177af48d43e663da8432 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFOTQ0OjEwMkZCQjoxQkZBOTI6MjM5MzBGOjZCMDM3QjAyIiwidmlzaXRvcl9pZCI6Ijg0NDkzMTY1MzEzMDA2OTQ3ODYiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 707768df53de75f0fc85a338c0ad9ed263e84badc9ec1912bc6203b4ab3485f4 |
| hovercard-subject-tag | issue:5852082306 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/JavaScriptSolidServer/JavaScriptSolidServer/621/issue_layout |
| twitter:image | https://opengraph.githubassets.com/c3257258abacbc1f1012184f69767a01a98e43815b19fcd5cd2028211975262a/JavaScriptSolidServer/JavaScriptSolidServer/issues/621 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/c3257258abacbc1f1012184f69767a01a98e43815b19fcd5cd2028211975262a/JavaScriptSolidServer/JavaScriptSolidServer/issues/621 |
| og:image:alt | Status (14 Oct 2026): the LWS implementation lives in linkedwebstorage/lwsd — a JSS plugin — and it passes 196 of 203 Touchstone tests (0 failed, 7 inapplicable: 3 SAML, 4 optional preconditions). ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | melvincarvalho |
| hostname | github.com |
| expected-hostname | github.com |
| None | 87e774ee7c6b3bee0490394e4d3e57ec9dbc956f74b87ea685dc8996c1676456 |
| turbo-cache-control | no-preview |
| go-import | github.com/JavaScriptSolidServer/JavaScriptSolidServer git https://github.com/JavaScriptSolidServer/JavaScriptSolidServer.git |
| octolytics-dimension-user_id | 205442424 |
| octolytics-dimension-user_login | JavaScriptSolidServer |
| octolytics-dimension-repository_id | 958025407 |
| octolytics-dimension-repository_nwo | JavaScriptSolidServer/JavaScriptSolidServer |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 958025407 |
| octolytics-dimension-repository_network_root_nwo | JavaScriptSolidServer/JavaScriptSolidServer |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 423dbb54c5e7bfecc838eb387c1435eb3d0e760d |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
| Server | github.com |
| Content-Type | text/html; charset=utf-8 |
| Cache-Control | max-age=0, private, must-revalidate |
Viewport: width=device-width