coulomb/shard-wiki
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

spec(SHARD-WP-0002): adapter contract (TSD §A, T11-T16+T18); workplan done

Browse Source 
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>
This commit is contained in:
Bernd Worsch
2026-06-15 02:25:50 +02:00
parent 802a80231a
commit d65f9e21f3
4 changed files with 157 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
workplans/SHARD-WP-0002-federation-architecture.md
View File

@@ -4,7 +4,7 @@ type: workplan
title: "federation architecture design"
domain: whynot
repo: shard-wiki
status: active
status: done
owner: tegwick
topic_slug: whynot
created: "2026-06-08"
@@ -151,7 +151,7 @@ decision records only.
```task
id: SHARD-WP-0002-T1
status: todo
status: done
priority: high
state_hub_task_id: "ea8fdb22-6c7f-4ac1-9799-1346abf3c3b7"
```
@@ -175,7 +175,7 @@ agents/CLI.
```task
id: SHARD-WP-0002-T2
status: todo
status: done
priority: high
state_hub_task_id: "fb7d4bce-5d2e-4602-9b63-85934d90e82d"
```
@@ -201,7 +201,7 @@ and attribution portability vs link-only federation.
```task
id: SHARD-WP-0002-T3
status: todo
status: done
priority: high
state_hub_task_id: "8f2a333d-ddcc-4cc6-b6ed-1ba9b178eee3"
```
@@ -222,7 +222,7 @@ showing all versions vs default canonical with alternates visible.
```task
id: SHARD-WP-0002-T4
status: todo
status: done
priority: high
state_hub_task_id: "5f39f48d-5142-4078-a84f-3245ec1add7e"
```
@@ -245,7 +245,7 @@ import.
```task
id: SHARD-WP-0002-T5
status: todo
status: done
priority: medium
state_hub_task_id: "3ff71e11-d0e9-4fda-b916-d6c34c51aa51"
```
@@ -266,7 +266,7 @@ composition (fedwiki resilience); cache staleness vs live-pull latency.
```task
id: SHARD-WP-0002-T6
status: todo
status: done
priority: medium
state_hub_task_id: "9596e5e8-8d6b-4ed4-bcbc-ebb45e3168be"
```
@@ -289,7 +289,7 @@ infrastructure.
```task
id: SHARD-WP-0002-T7
status: todo
status: done
priority: medium
state_hub_task_id: "38134064-51ce-4f5a-80bf-b2cfbe381c59"
```
@@ -310,7 +310,7 @@ read-only union entries.
```task
id: SHARD-WP-0002-T8
status: todo
status: done
priority: medium
state_hub_task_id: "5607732b-612a-4550-bb17-b8cd34979cf4"
```
@@ -335,7 +335,7 @@ on import; core orchestrator support vs Markdown extension + adapter.
```task
id: SHARD-WP-0002-T9
status: todo
status: done
priority: medium
state_hub_task_id: "adfca8b3-eb21-497d-9f51-65dc9269c810"
```
@@ -359,7 +359,7 @@ vs auto-merge when backends support it.
```task
id: SHARD-WP-0002-T10
status: todo
status: done
priority: medium
state_hub_task_id: "c7a93d06-8631-43b4-bc7f-1b0a1cd1436f"
```
@@ -394,7 +394,7 @@ the versioned-interface-with-swappable-backends pattern** the contract should ad
```task
id: SHARD-WP-0002-T11
status: todo
status: done
priority: high
state_hub_task_id: "a7379621-6694-488b-94ca-846b8e27e745"
```
@@ -452,7 +452,7 @@ static profile vs runtime capability negotiation.
```task
id: SHARD-WP-0002-T12
status: todo
status: done
priority: high
state_hub_task_id: "7334a4a4-ba75-4fac-a8b4-8350d342b299"
```
@@ -515,7 +515,7 @@ metadata snapshot vs live computation.
```task
id: SHARD-WP-0002-T13
status: todo
status: done
priority: high
state_hub_task_id: "6837862a-8f57-410d-9200-a6a5dcf1a7b9"
```
@@ -555,7 +555,7 @@ git-native`.
```task
id: SHARD-WP-0002-T14
status: todo
status: done
priority: medium
state_hub_task_id: "f8835969-d118-4738-952a-5e67e5209f3d"
```
@@ -622,7 +622,7 @@ snapshot simplicity.
```task
id: SHARD-WP-0002-T15
status: todo
status: done
priority: medium
state_hub_task_id: "22b57b3a-b06b-4ff0-a34a-667a0386bf25"
```
@@ -665,7 +665,7 @@ vs native-syntax overlays (safe round-trip); lossy-but-usable vs read-only-but-f
```task
id: SHARD-WP-0002-T16
status: todo
status: done
priority: medium
state_hub_task_id: "b00ca669-59d6-454a-8d6e-f34694e35192"
```
@@ -739,7 +739,7 @@ T1–T6); T18 is an adapter-contract concern (cross-links T11–T16).
```task
id: SHARD-WP-0002-T17
status: todo
status: done
priority: high
state_hub_task_id: "529b32d2-b681-4711-82c5-5298410cfb37"
```
@@ -779,7 +779,7 @@ query-time join freshness vs cost; activity-streams reach vs fediverse dependenc
```task
id: SHARD-WP-0002-T18
status: todo
status: done
priority: medium
state_hub_task_id: "331c2a9b-57bb-4067-8d1f-9a3de10e2873"
```