From e18397272ae7ee92a036ee9b7ca58ec5f866f0ac Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 15 Jun 2026 23:02:15 +0200 Subject: [PATCH] spec(SHARD-WP-0013 T6): wire-up + close-out spec/README + SCOPE list WikiEngineCoreArchitecture.md; CoreArchitectureBlueprint cross-links the engine as a canonical-mode shard (federation/union stay in the orchestrator). reuse-surface engine capability promoted D2->D3 (4204255). Marks T6 + SHARD-WP-0013 done. Co-Authored-By: Claude Opus 4.8 --- SCOPE.md | 2 +- spec/CoreArchitectureBlueprint.md | 4 ++++ spec/README.md | 1 + workplans/SHARD-WP-0013-wiki-engine-prep.md | 4 ++-- 4 files changed, 8 insertions(+), 3 deletions(-) diff --git a/SCOPE.md b/SCOPE.md index a624b5a..eca25e4 100644 --- a/SCOPE.md +++ b/SCOPE.md @@ -21,7 +21,7 @@ Learnings update both SCOPE and INTENT where necessary. | 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 | CoreArchitectureBlueprint (whole-system architecture, hardened via SHARD-WP-0005) + ArchitectureBlueprint (auth/history) drafted; UseCaseCatalog 84 UCs from research; PRD/TSD scaffolds | +| Spec | CoreArchitectureBlueprint (whole-system, hardened via SHARD-WP-0005/0006) + FederationArchitecture + FederationRequirements + TSD §A adapter contract + ArchitectureBlueprint (auth/history) + WikiEngineCoreArchitecture (headless API-first engine, SHARD-WP-0013) drafted; UseCaseCatalog 84 UCs (+ engine capability-structure layer); PRD scaffold | | 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) | ## In Scope (today) diff --git a/spec/CoreArchitectureBlueprint.md b/spec/CoreArchitectureBlueprint.md index e7eb93a..e535283 100644 --- a/spec/CoreArchitectureBlueprint.md +++ b/spec/CoreArchitectureBlueprint.md @@ -18,6 +18,10 @@ Scope relationship to the other specs: `spec/TechnicalSpecificationDocument.md`. - **`UseCaseCatalog.md`** is the demand this architecture must satisfy; UC references below are load tests, not decoration. +- **`WikiEngineCoreArchitecture.md`** designs shard-wiki's native, headless, API-first wiki + engine as a **canonical-mode shard backend** (one shard behind §6/§A — federation, union, and + projection stay here in the orchestrator, not in the engine). Added per the 2026-06-15 INTENT + amendment (decision `84ffdb48`, SHARD-WP-0013). --- diff --git a/spec/README.md b/spec/README.md index 546808c..ce6d230 100644 --- a/spec/README.md +++ b/spec/README.md @@ -8,6 +8,7 @@ Background on document types: InfoTechPrimers on coulomb.social. |------|--------|------| | `CoreArchitectureBlueprint.md` | draft for review | **Whole-system architecture** — layers, abstractions, load-bearing decisions (synthesised from all research) | | `FederationArchitecture.md` | draft for review | federation design — *what the union does*: T1–T10 decision records + the federation-model taxonomy (SHARD-WP-0002) | +| `WikiEngineCoreArchitecture.md` | draft for review | the native **headless, API-first wiki engine** — small page-store kernel + typed-extension framework, as a canonical-mode shard backend (SHARD-WP-0013) | | `FederationRequirements.md` | draft for review | yawex-derived union/federation design notes — resolution, namespace, derived views, provenance, overlay, links (ADR-01…06; SHARD-WP-0001) | | `ProductRequirementsDocument.md` | draft scaffold | What the product must deliver | | `TechnicalSpecificationDocument.md` | draft + §A | How the system is built; **§A = the normative shard adapter contract** (T11–T16, T18; SHARD-WP-0002) | diff --git a/workplans/SHARD-WP-0013-wiki-engine-prep.md b/workplans/SHARD-WP-0013-wiki-engine-prep.md index 0554637..e63fe4b 100644 --- a/workplans/SHARD-WP-0013-wiki-engine-prep.md +++ b/workplans/SHARD-WP-0013-wiki-engine-prep.md @@ -4,7 +4,7 @@ type: workplan title: "wiki-engine prep — reuse-surface registration, UC-catalog systematization, WikiEngineCoreArchitecture" domain: whynot repo: shard-wiki -status: active +status: done owner: tegwick topic_slug: whynot created: "2026-06-15" @@ -163,7 +163,7 @@ exotic case possible (mirror the CoreArchitectureBlueprint discipline). ```task id: SHARD-WP-0013-T6 -status: todo +status: done priority: medium state_hub_task_id: "1c383414-2c8b-41c4-957d-8d1a9ed88143" ```