Files
shard-wiki/registry/capabilities/capability.wiki.page-model.md
tegwick b31e9bc337 Add capability registry scaffold and seed entries from reuse-surface
Bootstrap registry/indexes/capabilities.yaml and migrate helix_forge
capability entries owned by this repository for federation publishing.
2026-06-16 01:34:23 +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.