Skip to content

Commit 1357146

Browse files
hyperpolymathclaude
andcommitted
docs: fix 6→8 modalities drift (add Provenance + Spatial)
deployment-modes.adoc and federation-readiness.adoc both described the octad as six modalities. Authoritative sources (CLAUDE.md, the TeX data model, rust-core/ crate layout) have eight — Provenance and Spatial were added but docs never caught up. Also adds the two missing normalizer regeneration strategies (Provenance hash-chain reconstruction, Spatial coord re-extraction). Foldback from verisim-modular-experiment Phase 0 archaeology. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent da46c06 commit 1357146

3 files changed

Lines changed: 6 additions & 4 deletions

File tree

File renamed without changes.

docs/deployment-modes.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ VeriSimDB is **both** a database and a federation coordinator—the architecture
88

99
=== Mode 1: Standalone Database (Traditional)
1010

11-
Deploy VeriSimDB as a **complete database system** with all six modalities local.
11+
Deploy VeriSimDB as a **complete database system** with all eight modalities local.
1212

1313
[cols="1,3"]
1414
|===
@@ -18,7 +18,7 @@ Deploy VeriSimDB as a **complete database system** with all six modalities local
1818
|Local in-memory namespace
1919

2020
|Modality Stores
21-
|All 6 modalities running on the same machine/cluster
21+
|All 8 modalities running on the same machine/cluster (Graph, Vector, Tensor, Semantic, Document, Temporal, Provenance, Spatial)
2222

2323
|Use Case
2424
|Single institution, traditional database replacement

docs/federation-readiness.adoc

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
== What Federation Means in VeriSimDB
1010

11-
Federation is the ability for multiple VeriSimDB instances to coordinate queries across their respective octad stores. Each instance maintains its own six modality stores (Graph, Vector, Tensor, Semantic, Document, Temporal) and its own set of octad entities. A federated query spans multiple instances, retrieving and correlating data from peers that may be geographically distributed, operated by different organizations, or running different versions of VeriSimDB.
11+
Federation is the ability for multiple VeriSimDB instances to coordinate queries across their respective octad stores. Each instance maintains its own eight modality stores (Graph, Vector, Tensor, Semantic, Document, Temporal, Provenance, Spatial) and its own set of octad entities. A federated query spans multiple instances, retrieving and correlating data from peers that may be geographically distributed, operated by different organizations, or running different versions of VeriSimDB.
1212

1313
Federation in VeriSimDB is distinct from database replication. Replicated databases maintain identical copies of the same data. Federated VeriSimDB instances hold _different_ octad entities that may reference each other through graph edges, share semantic vocabularies, or have vector embeddings in the same latent space. The federation layer coordinates cross-instance queries while each instance retains sovereignty over its own data.
1414

@@ -60,14 +60,16 @@ If VCL were removed or not used, VeriSimDB would lose the following federation-c
6060

6161
=== Normalizer Regeneration Strategies Are Stubs
6262

63-
The `verisim-normalizer` crate's regeneration strategies currently return hardcoded `[regenerated]` placeholder values. When drift is detected and normalization is triggered, the normalizer identifies the authoritative modality and calls the appropriate regeneration strategy, but that strategy does not actually regenerate the drifted modality's data. Each of the six modalities needs a real regeneration implementation:
63+
The `verisim-normalizer` crate's regeneration strategies currently return hardcoded `[regenerated]` placeholder values. When drift is detected and normalization is triggered, the normalizer identifies the authoritative modality and calls the appropriate regeneration strategy, but that strategy does not actually regenerate the drifted modality's data. Each of the eight modalities needs a real regeneration implementation:
6464

6565
* **Graph**: Re-derive edges from document content and semantic annotations.
6666
* **Vector**: Re-embed from document text using the configured embedding model.
6767
* **Tensor**: Re-compute tensor representation from source data.
6868
* **Semantic**: Re-extract type annotations and RDF triples from document and graph.
6969
* **Document**: Re-generate searchable text from graph, semantic, and temporal data.
7070
* **Temporal**: Re-build version chain from modification history.
71+
* **Provenance**: Re-construct SHA-256 hash chain from temporal modification history and recorded actor trail.
72+
* **Spatial**: Re-extract geographic coordinates from document (via NER) and graph geographic references.
7173

7274
=== Federation Executor Always Returns Empty
7375

0 commit comments

Comments
 (0)