generated from coulomb/repo-seed
tegwick
4543f5dc43
The closest existing engine to shard-wiki's own design: DB-canonical (Postgres/MySQL/SQLite) but with a pluggable storage-module abstraction that bidirectionally syncs clean Markdown (+ YAML frontmatter) to Git (also FS/S3/Azure), each provider acting as backup or source of truth. Two big findings: (1) the storage-module interface is concrete adapter-contract prior art alongside Foswiki::Store, and the closer one (medium = Markdown in Git); (2) the engine-maintained bidirectional Git mirror is the ideal file-store attach (clean MD + git history) and, being bidirectional, makes git commit a write path (overlay/patch as a commit, no API). Also GraphQL API (introspection = capability discovery; selective fields = efficient projection) and authn-delegated auth modules + path-based rule ACL. Added UC-68 (engine-maintained bidirectional Git mirror, write-by-commit), UC-69 (typed/introspectable API for schema discovery + selective projection); enriched UC-06/36/38/40/42/57. Catalog now 69 UCs. Architecture for SHARD-WP-0002 T11/T14: storage-module abstraction as 2nd adapter-contract prior art, engine-maintained Git mirror as attach+write surface, GraphQL introspection for capability discovery. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
research/
Exploration results for the problem and solution space.
Each exploration uses a yymmdd- prefix on the markdown file or subdirectory
when multiple files or sources are involved. Findings here inform spec/ and
SCOPE.md; they do not directly authorize implementation until promoted.
Active Explorations
| Date | Path | Summary |
|---|---|---|
| 2026-06-08 | 260608-yawex-prior-art/ |
yawex 0.7.4 Perl wiki prior art; federation design seeds |
| 2026-06-08 | 260608-c2-wiki-origins/ |
Ward Cunningham & WikiWikiWeb origins; terms and use cases |
| 2026-06-08 | 260608-federation-concepts/ |
Federated Wiki, git/ActivityPub/Xanadu federation models |
| 2026-06-08 | 260608-wikiengines-overview/ |
Wiki engine landscape survey (Perplexity-assisted) |
| 2026-06-13 | 260613-xwiki-deep-dive/ |
XWiki impl, extension interfaces, ecosystem; UC-38/39 |
| 2026-06-13 | 260613-twiki-deep-dive/ |
TWiki impl, plugin API, ecosystem; UC-40/41 |
| 2026-06-13 | 260613-foswiki-deep-dive/ |
Foswiki store abstraction, extension API; UC-42/43 |
| 2026-06-14 | 260614-xanadu-deep-dive/ |
Project Xanadu — EDL/reference-not-copy, transclusion, addressing; UC-44/45/46 |
| 2026-06-14 | 260614-zigzag-deep-dive/ |
ZigZag/zzstructure — information space as orthogonal dimensions; UC-47/48/49 |
| 2026-06-14 | 260614-roam-deep-dive/ |
Roam Research — block-graph DataScript DB, transclusion, datalog, Roam Depot extension API; UC-50/51/52 |
| 2026-06-14 | 260614-obsidian-deep-dive/ |
Obsidian — file-over-app vaults, plugin API, ecosystem-popularity → UC signal; UC-53/54/55/56 |
| 2026-06-14 | 260614-notion-deep-dive/ |
Notion — closed block-DB SaaS, external REST API only, database-as-pages; UC-57/58/59 |
| 2026-06-14 | 260614-shard-spectrum-synthesis/ |
Synthesis — shard family matrix + eleven capability spectra across nine systems; feeds SHARD-WP-0002 T11–T16 |
| 2026-06-14 | 260614-joplin-deep-dive/ |
Joplin — SQLite-local/Markdown-on-sync, interchange-format attach, E2EE content opacity; UC-60/61 |
| 2026-06-14 | 260614-logseq-deep-dive/ |
Logseq — block-graph on plain Markdown files, in-file block IDs, derived Datalog index; UC-62/63 |
| 2026-06-14 | 260614-localfirst-workspaces-deep-dive/ |
Anytype · AFFiNE · AppFlowy — CRDT local-first workspaces (any-sync/Yjs/Yrs), native merge, P2P/E2EE; UC-64/65 |
| 2026-06-14 | 260614-trilium-deep-dive/ |
Trilium/TriliumNext — note cloning (DAG hierarchy), attribute inheritance/templates, HTML-native, scripting+ETAPI; UC-66/67 |
| 2026-06-14 | 260614-wikijs-deep-dive/ |
Wiki.js — storage-module engine (DB↔Git Markdown), GraphQL API, pluggable modules ≈ adapter-contract prior art; UC-68/69 |