Files

tegwick 90a854f841 spec(SHARD-WP-0002): re-fold synthesis v3 + computational page model (T17, T18)

Folds the later syntheses into the federation/adapter-contract workplan:
- T11 capability spectra 13 -> 15 (+provenance granularity, +computational/
  liveness); +derive-projection/execute verbs
- T12 four computational page shapes (UC-83/84) + typed-graph statements
- T13 paired-text/nbdime + DB-version-rows + partial-history honesty
- T14 git-IS-store + direct-DB + image-is-not-a-store boundary
- T15 structured-re-evaluable-value opacity point; non-Markdown computed
- T16 two-axis projection model + moldable view registry + named-chunk transclusion
- NEW T17 federation-model taxonomy (fork+journal / VCS-replication+ping /
  query-join / feed / activity-streams / engine-mirror; selectable+composable)
- NEW T18 computational/executable content (in scope as page-model+projection,
  out as execution platform; execute = gated capability)
- Context/decision-tables/acceptance/order updated; UC range -> UC-26-UC-84

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-15 00:22:59 +02:00

3.6 KiB

Raw Blame History

SCOPE

One-Liner

Git-based Markdown wiki orchestrator and federation layer — early-stage scaffold with intent, research, and specification groundwork; domain model not yet implemented.

Mode Of Operation

Close the gap between this file and INTENT.md by exploring the problem space (research/), reviewing inbound demand (demand/), refining specifications (spec/), and implementing through registered workplans (workplans/). Learnings update both SCOPE and INTENT where necessary.

Current Status

Layer	State
Code	Python package scaffold (`src/shard_wiki/`, smoke tests only)
Intent	`INTENT.md` established; authorization-in-core amendments drafted
Research	yawex prior art; c2 origins; federation concepts; wikiengines overview (`research/260608-/`); XWiki/TWiki/Foswiki deep dives (`research/260613-/`); Xanadu + ZigZag + Roam + Obsidian + Notion + Joplin + Logseq + local-first workspaces (Anytype/AFFiNE/AppFlowy) + Trilium + Wiki.js + Federated Wiki + Wikibase + git-forge wikis + TiddlyWiki + ikiwiki + Quip + MojoMojo + Oddmuse + UseModWiki deep dives & shard-spectrum synthesis (`research/260614-*/`)
Demand	NetKingdom integration asks captured, not yet negotiated
Spec	Architecture blueprint drafted; UseCaseCatalog 84 UCs from research; PRD/TSD scaffolds
Work	`SHARD-WP-0001` active (6 tasks); `SHARD-WP-0002` active (18 tasks: T1–T10 federation + T11–T16 adapter contract + T17 federation-model taxonomy + T18 computational content, re-folded from synthesis v3 + the computational page model); `SHARD-WP-0003` done (9 engine dives complete); `SHARD-WP-0004` done (all 8 computational-knowledge dives T1–T8 complete + "computational page model" synthesis)

In Scope (today)

Establishing repository documentation structure and specification groundwork.
Federation design informed by yawex prior art (page resolution, namespaces, derived views, provenance, overlays).
Authorization model design (delegated authentication, core authorization).
Shard adapter contract and wiki page model (to be specified, then implemented).
Git-backed coordination journal for information spaces.
State Hub workplan registration and consistency sync.

Out Of Scope (today)

A standalone wiki engine UI or rendering pipeline.
Authentication, credential storage, or user directory implementation.
Hard-coded editorial, sync, or conflict-resolution policy.
Generic file mirroring independent of wiki-page semantics.
Production deployment, multi-tenant operations, or enterprise IAM rollout.

Boundary Rule

shard-wiki orchestrates wiki-shaped content across heterogeneous shards. It provides mechanisms (federation, projection, overlay, patching, reconciliation); policy (canonical source, conflict preference, access rules) remains explicit and configurable. Identity comes from pluggable providers; authorization decisions live in core.

Current Planning

Design work is tracked in workplans/SHARD-WP-0001-yawex-requirements.md (yawex-derived resolution, namespaces, overlays) and workplans/SHARD-WP-0002-federation-architecture.md (federation architecture, decisions, tradeoffs). Research continues under workplans/SHARD-WP-0003-engine-dives-batch.md (remaining new-insight wiki engines + git-forge wikis + classic engines) and workplans/SHARD-WP-0004-computational-knowledge-systems.md (literate programming, computational notebooks, live-coding REPLs, image-based/moldable environments — the executable/computational page-model thread). Specification outputs land in spec/. Inbound integration asks remain in demand/ until reviewed and promoted into spec or workplans.

3.6 KiB Raw Blame History Unescape Escape