diff --git a/history/260615-reuse-surface-contributions.md b/history/260615-reuse-surface-contributions.md new file mode 100644 index 0000000..ca2389e --- /dev/null +++ b/history/260615-reuse-surface-contributions.md @@ -0,0 +1,45 @@ +# reuse-surface contributions — shard-wiki (SHARD-WP-0013 T3) + +Date: 2026-06-15 · From: shard-wiki (whynot) · To: reuse-surface (helix_forge) · Tracked list +of (A) capabilities shard-wiki registered, (B) **gaps** shard-wiki proposes the reuse surface +add, and (C) capabilities shard-wiki will **consume** rather than rebuild. Communicated to the +reuse-surface agent via state-hub `send_message`. + +## A. Registered (T1 + T3) — 8 entries + +`capability.wiki.{shard-orchestration, adapter-contract, page-model, coordination-journal, +overlay, federation-models, engine-typed-extensions, derived-views}` — committed in +reuse-surface, `validate` ok (20 entries total). + +## B. Proposed gaps (cross-cutting; not shard-wiki-internal) → reuse-surface should own/define + +- **G1 — `capability.platform.typed-extension-framework`** *(suggested)* + A reusable pattern: a **small core + a stringent typed-extension framework** where extensions + declare typed contracts, compose, and are **activated per context**. shard-wiki's wiki engine + (`capability.wiki.engine-typed-extensions`) is one instance, but the *pattern* is + cross-domain (any HelixForge capability platform). Evidence: shard-wiki UseCaseCatalog + "Capability structure" layer (core + 10 typed extensions + conflict-mediation map). + Suggested owner: helix_forge / reuse-surface. Relation: would `generalize` + `capability.wiki.engine-typed-extensions`. + +- **G2 — `capability.content.translation-fidelity`** *(suggested)* + Lossless/lossy **content translation with an explicit fidelity report** (what round-trips + cleanly vs degrades, non-mappable elements preserved as provenance). Reusable well beyond + wiki (any format-bridging consumer). Evidence: shard-wiki TSD §A.6, UC-42/UC-59. + +## C. Consumptions (reuse, do not rebuild) + +- **`capability.feature-control.evaluate`** (helix_forge/feature-control) → shard-wiki's + **per-shard extension/feature activation** (the "activate only what you need" mechanism). + Already recorded as a relation on `capability.wiki.engine-typed-extensions`. +- **`capability.authorization.policy-evaluate`** (flex-auth) → shard-wiki's **X-AUTHZ** policy + decisions. shard-wiki owns the authz *model* (authz-in-core) but can reuse this evaluation + engine rather than building one. +- **`capability.statehub.{progress-log, workstream-coordinate}`** → already in use for + coordination across this work. + +## Status + +Gaps G1/G2 are **suggestions** to the reuse-surface owner (not unilateral registrations, since +they are cross-cutting, not shard-wiki-internal). Consumptions are recorded for the engine +architecture (T5) so it reuses rather than reinvents. diff --git a/history/README.md b/history/README.md index f1b9f39..d1b57b2 100644 --- a/history/README.md +++ b/history/README.md @@ -15,4 +15,5 @@ design evolution. | Date | Record | Subject | |------|--------|---------| | 2026-06-15 | `260615-core-architecture-blueprint-review.md` | Critical review of `spec/CoreArchitectureBlueprint.md` (commit 9b5b393); inputs to `SHARD-WP-0005` | -| 2026-06-15 | `260615-core-architecture-blueprint-review-2.md` | Round-2 review of the hardened blueprint (post-`SHARD-WP-0005`, f21b7b5); inputs to `SHARD-WP-0006` | \ No newline at end of file +| 2026-06-15 | `260615-core-architecture-blueprint-review-2.md` | Round-2 review of the hardened blueprint (post-`SHARD-WP-0005`, f21b7b5); inputs to `SHARD-WP-0006` | +| 2026-06-15 | `260615-reuse-surface-contributions.md` | shard-wiki's reuse-surface registrations, proposed gaps (G1/G2), and consumptions (`SHARD-WP-0013` T3) | \ No newline at end of file diff --git a/workplans/SHARD-WP-0013-wiki-engine-prep.md b/workplans/SHARD-WP-0013-wiki-engine-prep.md index fdc9148..fd42dc9 100644 --- a/workplans/SHARD-WP-0013-wiki-engine-prep.md +++ b/workplans/SHARD-WP-0013-wiki-engine-prep.md @@ -105,7 +105,7 @@ open-vs-governed, lossless-vs-lossy, live-vs-snapshot) and **how the framework m ```task id: SHARD-WP-0013-T3 -status: todo +status: done priority: medium state_hub_task_id: "06b62406-39e7-4227-bcc6-f9cab1c28996" ```