| 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 |
|
|
|
| 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/ |
|
|
|
| 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 |
|
|