- Walked: 2026-05-29 at
bf12b0f7d8c291499e1df1ec75d4bd21acf3f6b1. The retained walker was an ephemeral/tmpscript. It rendered/library,/library/collections, and/library/collections/new, then observed a collection-create POST. - Reconciled: 2026-07-18 against the current journey, all four Library routes, the saved-item and collection sources, the sharing engine/BFF, the recipient route, and six focused browser specs. This was source review, not a fresh application run.
- Reconciled again: 2026-09-24, by source review of
5495504a7d7(audit-remediation T13.a: a signed-in member's dashboard collections are the server collections, and/libraryhonours?collectionId=). Only the collection-model statements below changed; no suite was rerun. - Verdict: partial — the dated route/create slice passed and later browser suites substantially deepened save, collection editing, share-policy, and recipient-denial evidence. Since T13.a a signed-in member's dashboard collections are the server catalog's rows and the catalog's links open them; a guest keeps a local showcase. Share policy is still process memory, and a shared link still resolves permission without rendering the sender's collection contents.
- Current authority:
WALKTHROUGH/journeys/library-save-collection-share.mdand itspartialcoverage-registry row.
Result at a glance#
| Evidence plane | Current implementation | Strongest surviving proof | Authority limit |
|---|---|---|---|
| Saved items | Domain saves converge on webLibraryStore; signed-in snapshots use /v1/library/saved-items, with optimistic local cache and guest migration |
Real-BFF save/read-back, unsave, same-user clean-device hydrate, LWW sync, tombstones, isolation, cap paywall, and several direct producers | Not every producer or entitlement/resume permutation is exercised; Nyx event save still owns a separate local action store |
| Server collection catalog | /library/collections/new posts label + opaque item ids to the member-scoped /v1/library/collections; /library/collections lists those rows |
Live-BFF accepted, pending, validation, offline, focus, owner-isolation, and mobile form coverage | Since T13.a the success/list links /library?collectionId=… open the collection in the dashboard manager, which reads the same rows |
| Dashboard collection composition | For a signed-in member, /library/collection/:id reads /v1/library/collections and writes create, PATCH (label, description, items) and archive through the BFF; a guest's showcase stays in oshun.library.collections.v1 |
Create-from-filter, edit, membership toggle, archive, corrupt fallback, unknown deep link, v0→v1 migration, and library-collections-one-system.spec.ts (3 cases, not rerun here) |
Follows a signed-in member across devices; the guest showcase is browser-local |
| Share policy | CollectionShareControls writes private, named-user, link, and public-profile policy through /v1/library/collections/:id/* |
Token issue/revoke, invite/referral attribution, permission tiers, owner checks, and policy read-back over the BFF | The policy store is process memory, and policy creation does not prove that a corresponding server collection payload exists |
| Recipient route | /share/:token asks the BFF to resolve a collection id and requested permission |
Valid grant, wrong/revoked token, insufficient tier, and same-id local-shadow rejection | Current tests use signed-in recipients; the page shows id/tier/via only, not sender labels, items, provenance, or embed cards |
Evidence map#
Since T13.a the catalog and a member's dashboard edit one server collection. The dashed branch is the disconnect that remains: a recipient gets permission, not contents.
flowchart LR
A[Domain Save] --> B[Saved-items BFF]
B --> C[Library hydrate]
C --> D[Dashboard collection editor]
D --> E[Member collection in the BFF]
I[Server collection form] --> E
E --> J[Server collection catalog]
J -- collectionId link --> D
D --> F[Share-policy BFF]
F --> G[Share token]
G --> H[Recipient permission view]
H -. contents not delivered .-> E
Proven observations#
The dated slice is reproducible as a historical claim#
- Both abbreviated commits in the old record resolve in repository history: the
walk at
bf12b0f7d8c291499e1df1ec75d4bd21acf3f6b1and the earlier route repair at8ad5d6a4dfac400ef925ef95df2d6bf155c57158. - All three dated routes remain in the current 701-route inventory. The new
collection form still POSTs
{ label, itemIds }to/v1/library/collections, exposes pending/error/accepted states, preserves fields after server/offline failure, and moves focus to its accepted status. - The member-scoped BFF collection route rejects anonymous callers, validates a
two-character label, records the owner, returns
202, and lists only the caller's rows plus legacy unowned migration rows. Its backing tier can be PostgreSQL, a protected development snapshot, or test memory. - The original “0 page errors, 0 persistent failures” remains a dated walker
observation. The missing
/tmpwalker means its exact selectors, environment, and raw report cannot be independently inspected now.
Saved-item continuity is substantially deeper today#
webLibraryStorekeeps an offline cache but hydrates signed-in members from the saved-items BFF. Focused browser evidence covers direct Nisaba passage save, guest→sign-in migration, clean-device hydration, resume navigation, saved-queue transitions, and unsave row removal.- Companion real-HTTP suites cover same-user cross-device propagation, LWW conflict accounting, tombstone deletion, per-user isolation, and the 25-save free-tier cap. Search, Explore, Veritas, Sophia, Atelier, Tara, Nyx search results, and Metis producers have targeted evidence elsewhere in the current journey registry.
- This evidence is appropriately stronger than “the page rendered.” It proves server read-back for named producers and states; it does not prove every saveable surface or every canonical resume destination.
Collections are one server object for members; sharing is still separate#
- Since T13.a (2026-09-24), a signed-in member's Dashboard collection manager
reads the member's collections from
/v1/library/collectionsand writes through the BFF: create, a PATCH for label, description and items, and archive, each followed by a re-read. A guest keeps the local showcase underoshun.library.collections.v1, and a member never sees its fixtures. - The server catalog and the create form link a collection as
/library?collectionId=<id>;app/library/page.tsxnow passes that id to the dashboard, which opens it in the collection manager. CollectionShareControlscan attach a valid BFF policy to a collection id, but the sharing route governs authorization only. It does not deliver the collection's contents to a recipient.- The recipient route deliberately avoids the recipient's same-id local shadow. Its granted state displays the server-resolved collection id, tier, and resolution channel; this is a correct isolation repair, not content sharing.
Share authorization fails closed within its tested scope#
- Tokens are generated from 32 random bytes, returned once, and stored as a SHA-256 hash. The engine validates view/comment/copy ordering, expiry, revocation, owner-only mutation, named-user grants, and public-profile policy.
- Browser/BFF specs cover issue→resolve→revoke, wrong-token denial, insufficient permission, invite/referral attribution, private state, named-user copy, and public-profile comment policy read-back.
- The current
LibrarySharePolicyStoreis an in-processMap. A BFF restart or a different instance loses its policies unless a durable adapter replaces this binding; “real BFF” must not be read as production durability.
Boundaries and gaps#
- The dated pass belongs to a route/create slice, not the current journey. Rendering three pages and observing one POST never proved domain save, collection editing, link authorization, recipient isolation, or read-back.
- A guest showcase is not a member collection. A guest sees fixture collections kept in this browser; only a signed-in member's collections are the server's rows.
- The “Open it” continuation is repaired in source, not re-walked.
/library?collectionId=now opens the collection manager (T13.a); this reconciliation did not rerun the suites that would show it. - A permission card is not shared content. The recipient does not receive the sender's label, member items, ordering, provenance, grounding, synthetic indicators, or embeddable card.
- A process-local policy is not durable authorization. Restart and multi-instance behavior remain outside the present sharing proof.
- Anonymous link access is not proven. The resolution BFF route requires an auth context, and current browser evidence signs in the recipient.
- Collection composition is cross-device only for members. A signed-in member's labels and membership are server rows; the guest showcase stays in localStorage.
- Several journey branches remain open. Nyx event-save convergence, filter-URL write-back, offline resume, gated-item resume, collection delete, public-profile collection rendering, and provenance-preserving embed cards are not closed by this result.
- Source reconciliation is not execution. None of the cited web/BFF suites was rerun for this documentation audit or for the 2026-09-24 reconciliation.
Re-run evidence#
Run the live BFF and production-like web app at the same immutable commit, then execute the focused specs one at a time with one worker:
bash
pnpm --dir apps/oshun/web exec playwright test -c playwright.config.ts e2e/library-collections-new.spec.ts --project=chromium --workers=1
pnpm --dir apps/oshun/web exec playwright test -c playwright.config.ts e2e/library-save-collection-share.spec.ts --project=chromium --workers=1
pnpm --dir apps/oshun/web exec playwright test -c playwright.config.ts e2e/library-collection-management.spec.ts --project=chromium --workers=1
pnpm --dir apps/oshun/web exec playwright test -c playwright.config.ts e2e/collection-share.spec.ts --project=chromium --workers=1
pnpm --dir apps/oshun/web exec playwright test -c playwright.config.ts e2e/library-shared-resolution.spec.ts --project=chromium --workers=1
pnpm --dir apps/oshun/web exec playwright test -c playwright.config.ts e2e/library-shared-web-view.spec.ts --project=chromium --workers=1
pnpm --dir apps/oshun/web exec playwright test -c playwright.config.ts e2e/library-collections-one-system.spec.ts --project=chromium --workers=1
Retain the web/BFF commit, backing-store tier, environment manifest, Playwright artifacts, and member identities. Add an explicit create→open→edit→second-device read-back assertion before upgrading this result beyond partial.
Source trail#
- Current journey contract
- Current coverage registry
- Server collection list
- Server collection form
- Library root route
- Dashboard collection manager
- Saved-item store
- Collection share controls
- Shared-token route
- Collection catalog BFF routes
- Sharing BFF routes
- Share-policy store
Cross-references#
- Library route evidence
- Collection deep-link evidence
- New collection route evidence
- Shared-token route evidence
- Search→deep read→save journey
- External collection contract
- V1 completeness audit
Open questions#
- Should a guest's showcase collections migrate to the member's server collections at sign-in?
- Should the catalog link straight to
/library/collection/:idnow that both routes read the same server rows? - When will share policies move from the in-process map to the same durable, owner-scoped collection boundary?
- What payload should an authorized recipient receive, and how will it preserve ordering, provenance, grounding, synthetic indicators, and entitlement gates?
- Is anonymous link-with-key access intended? If so, what limited auth/rate/ revocation boundary replaces the current signed-in precondition?
- Which test will prove one continuous domain-save→collection-create→share→ recipient-content flow with clean sender and recipient browser contexts?