2026-06-08 13:55:27 +02:00
|
|
|
|
# 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 |
|
2026-06-14 21:14:26 +02:00
|
|
|
|
| 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-*/`) |
|
2026-06-08 13:55:27 +02:00
|
|
|
|
| Demand | NetKingdom integration asks captured, not yet negotiated |
|
2026-06-15 01:43:14 +02:00
|
|
|
|
| Spec | CoreArchitectureBlueprint (whole-system architecture, hardened via SHARD-WP-0005) + ArchitectureBlueprint (auth/history) drafted; UseCaseCatalog 84 UCs from research; PRD/TSD scaffolds |
|
spec(SHARD-WP-0002): adapter contract (TSD §A, T11-T16+T18); workplan done
Adds the normative Shard Adapter Contract as TechnicalSpecificationDocument §A:
A.1 versioned capability contract (verbs + orthogonal-core spectra), A.2 verified
conformance suite (profiles not self-asserted), A.3 attachment-mode taxonomy +
image-is-not-a-store boundary, A.4 page model (incl. computational shapes,
identity/placement/equivalence, layered provenance), A.5 history portability,
A.6 syntax translation + fidelity report, A.7 addressing/navigation, A.8 gated
computational content. Updates TSD references/UC-count/next-work. Flips all 18
WP-0002 tasks + workplan done. Design layer complete.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-15 02:25:50 +02:00
|
|
|
|
| Work | `SHARD-WP-0001` **done** (6 ADRs: yawex-derived federation requirements → `spec/FederationRequirements.md`); `SHARD-WP-0002` **done** (18 tasks → `FederationArchitecture.md` [T1–T10, T17] + `TechnicalSpecificationDocument.md` §A adapter contract [T11–T16, T18]); `SHARD-WP-0003` **done** (9 engine dives complete); `SHARD-WP-0004` **done** (all 8 computational-knowledge dives T1–T8 complete + "computational page model" synthesis); `SHARD-WP-0005` **done** (9 tasks: CoreArchitectureBlueprint hardened against the 260615 review); `SHARD-WP-0006` **done** (5 tasks: round-2 hardening — overview reconciled, event-sourced coordination + append authority, adapter conformance, incremental correctness + I-2 verification) |
|
2026-06-08 13:55:27 +02:00
|
|
|
|
|
|
|
|
|
|
## 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
|
|
|
|
|
|
|
2026-06-08 14:55:13 +02:00
|
|
|
|
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,
|
plan: add SHARD-WP-0003 (engine-dive batch) and SHARD-WP-0004 (computational-knowledge systems)
SHARD-WP-0003 — nine wiki-engine deep dives chosen against the synthesis
coverage review: high-insight (Federated Wiki, Wikibase/Wikidata,
TiddlyWiki, ikiwiki), the INTENT-named git-forge wikis (Gitea/GitLab/
GitHub), and four for breadth/lineage (Salesforce Quip, Oddmuse, MojoMojo,
UseModWiki). Each task = persist a deep-dive memo + promote/enrich the
use-case catalog + log adapter-contract notes for SHARD-WP-0002;
post-batch synthesis-v3 decision.
SHARD-WP-0004 — eight computational / interactive-knowledge systems as
design prior art for executable/computational/live page content and
one-source-many-projections: Knuth WEB/weave/tangle, Mathematica & Jupyter
notebooks, Processing/Processing.js, Strudel.cc, Squeak, Glamorous
Toolkit, Pharo. Carries the question of whether a page can be a live
computational artifact; closes with a "computational page model"
synthesis. Both workplans authored file-authoritative (no state_hub IDs;
sync will create+link workstreams and tasks).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 18:28:06 +02:00
|
|
|
|
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.
|