frontend-patterns/research/catalog/SourceCatalog.md
tegwick 78bd951568 Exercise Matrix SDK recovery under controlled transport failures
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a0cffe-206f-7323-89d3-b20ca4cf4bf9
2026-09-25 11:02:03 +02:00

6.5 KiB
Raw Blame History

Source Catalog

Identified primary sources

ID Source and edition State Prepared input
SRC-0001 Ryan Carniato, The Grand Unifying Architecture of Frontend; web edition accessed 2026-09-24; displayed Sep 22, year unverified extracted; initial manual review; live draft completed; admission rejected (review) Authority and feedback packet
SRC-0002 Martin Kleppmann, Adam Wiggins, Peter van Hardenberg, Mark McGranaghan, Local-first software; April 2019 web essay; DOI 10.1145/3359591.3359737; accessed 2026-09-24 extracted; initial manual review; live bounded investigation completed; no candidates justified (review) Local authority packet
SRC-0003 Joplin, Architecture; living docs accessed 2026-09-25, release/date unknown extracted; E04 in expansion review Manual located review
SRC-0004 Joplin, Synchronisation; living docs accessed 2026-09-25, release/date unknown extracted; E05–E06 in expansion review Manual located review
SRC-0005 Joplin, What is a conflict?; living docs accessed 2026-09-25, release/date unknown extracted; live run completed, editorial revision needed Conflict packet
SRC-0006 Obsidian, Troubleshoot Sync; living docs accessed 2026-09-25, release/date unknown extracted; live run completed, proposed relations rejected Conflict packet
SRC-0007 Obsidian, Back up files; living docs accessed 2026-09-25, release/date unknown extracted; E11–E12 in expansion review Manual located review
SRC-0008 Kubernetes, API Concepts; living docs accessed 2026-09-25, revision unknown T01; bounded live extraction and editorial review Stale-write packet
SRC-0009 GitLab, Repository files API; living docs accessed 2026-09-25, revision unknown T02; manual located review Transactional review
SRC-0010 Stripe, Idempotent requests; living docs accessed 2026-09-25, revision unknown T03; manual located review Transactional review
SRC-0011 React Router, Network Concurrency Management; living docs accessed 2026-09-25, revision unknown T04; manual located review Transactional review
SRC-0012 React Router, Pending UI; living docs accessed 2026-09-25, revision unknown T05; manual located review Transactional review

Queued does not mean reviewed. Bibliography and hashes live in each workspace's source artifact and manifest. Preparation review records selection, provenance limits and remaining work. Claim IDs will resolve inside completed source reviews; preparation packets do not establish a pattern.

Source families to investigate

Family Representative sources Research purpose
Pattern languages Christopher Alexander, Hillside/PLoP literature Pattern form, relations, generative sequences
GUI architecture Martin Fowler, MVC/MVP/Presentation Model Presentation/domain/state separation
Unidirectional state Flux, Redux, Elm State transition and dependency direction
Hypermedia REST, HTML forms, HTMX Navigation, mutation, server projection
Rendering web.dev, framework docs, Patterns.dev CSR/SSR/SSG/hydration/islands/streaming
Local-first Ink & Switch and related work Local authority, sync, conflict handling
Distributed state CRDT/event sourcing/sync literature Reconciliation and replication
Modularity Feature-Sliced Design Feature boundaries and dependency rules
Organizational architecture Microfrontend literature Independent ownership/deployment
Quality WCAG, progressive enhancement, web performance Cross-cutting architectural forces

Catalog policy

Each source should eventually capture:

  • source identity,
  • date/version,
  • scope,
  • vocabulary used,
  • candidate patterns,
  • dominant forces,
  • assumptions,
  • contradictions,
  • known implementations,
  • evidence quality.

2026-09-24: initial authority-focused reviews are recorded as extracted. They have not passed a full-source or independent review gate. Live calls failed before any artifact generation. See AuthorityPilot for findings, execution evidence and limitations.

2026-09-25: local-first -06 completed after replacing padded claim tables with compact records. Its bounded negative result does not complete full-source review. Source state remains extracted; recurrence and independent implementations remain open.

Pinned frontend implementations — 2026-09-25

SRC-0013 Zulip, SRC-0014 Element Web, SRC-0015 Matrix JS SDK and SRC-0016 Matrix client-server specification v1.15 are inspected in the frontend recovery review. The manifest records exact revisions, file URLs and SHA-256 hashes. State: bounded static review; no runtime validation. Element and its SDK are one implementation family. Complete-pattern recurrence remains unproven despite two partial draft-preservation uses.

Executable SDK follow-up — 2026-09-25

SRC-0017: published matrix-js-sdk 42.3.0; npm archive and integrity recorded in experiment provenance. State: executed under controlled synthetic transport. Four cases pass; server guarantees remain assumptions. This is the SRC-0014/0015 implementation family, not another independent application. Review.