Files
reuse-surface/registry/capabilities/capability.wiki.page-model.md
tegwick a7c813eec8
Some checks failed
ci / validate-registry (push) Has been cancelled
Register shard-wiki capabilities (7 wiki.* registry entries)
Adds capability.wiki.{shard-orchestration, adapter-contract, page-model,
coordination-journal, overlay, federation-models, engine-typed-extensions}
with honest D/A/C/R maturity vectors, relations, and shard-wiki spec/test
evidence; updates registry/indexes/capabilities.yaml. reuse-surface validate: ok.
Source: shard-wiki SHARD-WP-0013 T1.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-15 22:10:00 +02:00

3.6 KiB

id, name, summary, owner, status, domain, tags, maturity, external_evidence, discovery, availability, relations, evidence, consumer_guidance
id name summary owner status domain tags maturity external_evidence discovery availability relations evidence consumer_guidance
capability.wiki.page-model Backend-Neutral Wiki Page Model A Markdown-first but stretchable page model with stable identity separate from placement and layered provenance, spanning prose to typed-graph and computational shapes. shard-wiki draft helix_forge
wiki
page-model
identity
provenance
markdown
shard-wiki
discovery availability
current target confidence rationale
D5 D6 high Page shapes (prose, typed records, typed-graph, inline-embedded, non-Markdown, and four computational shapes) plus identity != placement and layered provenance are specified and grounded in the dive research.
current target confidence rationale
A2 A5 medium Identity/Placement/Span/Page and layered ProvenanceEnvelope exist as a source module; richer shapes (typed-graph, notebook) are modeled but not all built.
completeness reliability
level name confidence basis satisfied_expectations broken_expectations out_of_scope_expectations
C2 Partial medium scope_vs_intent_and_consumer_expectations
stable identity distinct from placement and from content fingerprint
layered (effective-vs-own) provenance with near-zero per-span cost
non-prose shapes (typed-graph, notebook, inline-embedded) not fully realized
rendering / presentation
level confidence basis known_reliability_risks
R1 low consumer_quality_signals
prose shape is the only exercised path so far
intent includes excludes use_cases
One backend-neutral lingua franca every consumer sees; every shape reduces to (content|source, structure, provenance envelope, optional derivation rule).
page identity (stable handle) vs placement (N paths/shards) vs equivalence (fingerprint)
layered provenance envelope (page + span deltas)
page-shape taxonomy incl. computational shapes
deriving identity from content (a fingerprint identifies a version, not a page)
shard-wiki UseCaseCatalog UC-34, UC-39, UC-44..UC-49, UC-55, UC-73, UC-83, UC-84
current_level target_level current_artifacts consumption_modes
A2 A5
shard-wiki/src/shard_wiki/model/
shard-wiki/src/shard_wiki/provenance/
source module
supports
capability.wiki.adapter-contract
capability.wiki.shard-orchestration
documentation tests
shard-wiki/spec/CoreArchitectureBlueprint.md (Section 7)
shard-wiki/spec/FederationRequirements.md (ADR-02, ADR-04)
shard-wiki/tests/test_model.py
shard-wiki/tests/test_provenance.py
recommended_for not_recommended_for known_limitations
a portable, provenance-carrying representation of wiki pages across backends
cases needing a single canonical path per page (use identity, not path)
non-prose shapes specified ahead of implementation

Backend-Neutral Wiki Page Model

The top narrow waist: a Markdown-first model that stretches to typed records, typed-graph statements, inline-embedded objects, non-Markdown assets, and computational shapes. Identity is a stable handle; placement and equivalence are separate mechanisms; provenance is layered (effective = page envelope + span delta).

Assessment notes

Discovery

Specified in CoreArchitectureBlueprint Section 7 and FederationRequirements ADR-02/04.

Availability

model/ + provenance/ ship the prose path and the layered envelope today.