Files
shard-wiki/research/README.md
tegwick 3d137c96b6 research: SHARD-WP-0004 synthesis (the computational page model); workplan done
Consolidates the 8 computational/interactive-knowledge dives into one
source/derivation/projection model on two axes (replication<->derivation,
live<->snapshot); four computational page shapes; recommendation that
executable content is in scope as a page-model+projection concern, out of
scope as an execution platform (capability-gated, degrade to snapshot;
no INTENT amendment). Flips SHARD-WP-0004 status: done.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-15 00:12:03 +02:00

7.4 KiB
Raw Permalink Blame History

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 (v3) — shard family matrix + fourteen capability spectra across ~23 systems + federation-model taxonomy (fork+journal / VCS-replication+ping / query-join / engine-mirror); feeds SHARD-WP-0002 T1T6 + T11T16
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
2026-06-14 260614-federated-wiki-deep-dive/ Federated Wiki — fork-with-provenance, per-page semantic-action journal (story=replay), neighborhood/roster + chorus; prior art for our coordination journal / overlay / union pillars; UC-70/71/72
2026-06-14 260614-wikibase-deep-dive/ Wikibase/Wikidata — typed entity-statement knowledge graph (claim+qualifiers+refs+rank), SPARQL/RDF + federated SERVICE, opaque stable IDs, statement-level provenance; structure & query far-end; UC-73/74/75
2026-06-14 260614-forge-wikis-deep-dive/ Gitea · GitLab · GitHub wikis — a wiki is a separate .wiki.git of Markdown; git-clone universal, wiki API capability-varying (GitHub git-only); git IS the store (resolves UC-68 race); the home case; UC-76/77
2026-06-14 260614-tiddlywiki-deep-dive/ TiddlyWiki — entire wiki (content + app) in one self-contained HTML file = whole-file write-granularity extreme; Node .tid file-per-tiddler substrate (git-diffable); tiddler/field records, filter-expression query; UC-78
2026-06-14 260614-ikiwiki-deep-dive/ ikiwiki — wiki compiler: git-canonical Markdown source → static HTML (derived publish/projection); git-distributed clone federation + XML-RPC pinger (third federation flavor); UC-79
2026-06-14 260614-quip-deep-dive/ Salesforce Quip — closed-SaaS live docs + embedded spreadsheets/live apps; REST + lossy HTML import/export; Salesforce enterprise ACL; external-API payload-format facet + inline-object page model; UC-80
2026-06-14 260614-mojomojo-deep-dive/ MojoMojo — Perl Catalyst/DBIx::Class DB-backed wiki; pages + history in SQL tables, no file store/API → direct-DB-read binding; DB version rows as history source; UC-81
2026-06-14 260614-oddmuse-deep-dive/ Oddmuse — single Perl CGI, plain-text page/ files + keep/ revisions, no DB; the minimal file-store floor / graceful-degradation baseline; partial-history honesty; UC-82
2026-06-14 260614-usemodwiki-deep-dive/ UseModWiki — flat-file ancestor (Wikipedia's MediaWiki Phase I); CamelCase linking; lineage grounding for the minimal file-store floor; enrichment-only (reinforces UC-82, UC-25)
2026-06-14 260614-literate-programming-deep-dive/ Literate programming (Knuth's WEB / weave / tangle) — one source → N co-equal derived projections (docs + code); named-chunk transclusion; splits replication- vs derivation-projection; SHARD-WP-0004 T1; UC-83
2026-06-14 260614-jupyter-deep-dive/ Jupyter Notebooks — .ipynb JSON cells + embedded computed outputs with fragile execution provenance; derived output stored inside the source; non-Markdown/lossy; kernel = capability; SHARD-WP-0004 T3; UC-84
2026-06-14 260614-glamorous-toolkit-deep-dive/ Glamorous Toolkit (moldable development on Pharo) — gtView open set of co-equal type-keyed computed views (none canonical) = moldable view registry; Lepiter live notebook over git files; SHARD-WP-0004 T7; enrichment-only (UC-47/48/54)
2026-06-14 260614-mathematica-deep-dive/ Mathematica Notebooks — the original computational notebook (.nb = a Wolfram expression); nestable cell groups, structured re-evaluable outputs, Manipulate live widgets, CDF; confirms UC-84 notebook shape is a genus; SHARD-WP-0004 T2; enrichment-only (reinforces UC-84; UC-54/55)
2026-06-14 260614-squeak-pharo-deep-dive/ Squeak & Pharo (image-based Smalltalk) — the live-object image (purest "live" end); image-is-not-a-store boundary (export→files only); Pharo Tonel/Iceberg externalizes code to git text; names the live↔snapshot projection axis; SHARD-WP-0004 T6 + T8 (merged); boundary/enrichment-only, no new UC
2026-06-14 260614-processing-deep-dive/ Processing / p5.js — program-as-page rendered live at view time (no cached output); adds materialization-timing + continuity facets to projection; execute-in-viewer = capability+trust; SHARD-WP-0004 T4; enrichment-only (UC-54/55)
2026-06-14 260614-strudel-deep-dive/ Strudel.cc (TidalCycles JS) live-coding REPL — code as live time-based audio performance; the far live end (no faithful static form; static = source + marked recording); honesty test for graceful degradation; SHARD-WP-0004 T5; enrichment-only (UC-54/55)
2026-06-15 260614-computational-page-model-synthesis/ SHARD-WP-0004 synthesisthe computational page model: source canonical / everything rendered is a projection; two axes (replication↔derivation, live↔snapshot); four computational page shapes; recommendation — executable content in scope as page-model+projection, out of scope as an execution platform (no INTENT amendment); feeds SHARD-WP-0002 T11T16