feat(verisim-modular-experiment): Phase 3 runtime validation of Path B

Phase 3 decision gate PASSED. 70/70 assertions green across 3 suites.
Federated aggregate-drift numerically equals monolithic aggregate-drift
for the same octad data over a {Semantic,Vector} federation. Path B
is runtime-confirmed: a non-trivial VerisimCore exists.

Julia reference impl (impl/):
- VerisimCore.jl — Store, enrich!, attest, verify_attest, inv:persist
- FederationManager.jl — DriftWeights, renormalise, aggregate_drift,
  PeerAttestation, runtime IsFederable validation (Core shapes rejected)
- drift/Metrics.jl — cosine_distance, hash_embedding, d_SV, dispatcher
- peers/VectorPeer.jl — DriftProjector + CoherenceProjector + LWWAcceptor
- Crypto.jl — Ed25519 wrapper over libsodium (wiring in progress)

Test suites (test/):
- test_verisim_core.jl (25 assertions): enrichment atomicity, Identity
  Persistence, hash-chain integrity, attestation round-trip, freshness
- test_federation_parity.jl (24 assertions): parity vs monolithic,
  multi-octad parity, reduced-scope drift, Clause 1/5 behaviours
- test_seams.jl (21 assertions): register_peer! rejects Core shapes,
  PeerAttestation struct matches Idris2 record, classification constants

Seam audit (docs/SEAMS.adoc): ABI↔impl alignment post-Phase 3.
Fixed: PeerAttestation struct, is_fresh signature, runtime Core rejection.
Documented: driftAgainst transport abstraction, enrich payload, naming.

Documentation (human + machine):
- EXPLAINME.adoc — plain-language repo overview
- docs/SHAPES.adoc — central mapping (TeX letters ↔ Idris2 ↔ Julia)
- docs/PHASE-3-IMPLEMENTATION-PLAN.adoc — scope + defaults rationale
- .machine_readable/6a2/{STATE,META,ECOSYSTEM}.a2ml — structured metadata
- LICENSE pointer, PLAN.adoc updated with Phase 3 outcome
- PROOF-NEEDS.md updated with discharged obligations
- src/Abi/FederationContract.idr — driftAgainst transport docstring

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: hyperpolymath

verisim-modular-experiment/.gitignore

@@ -1,3 +1,4 @@
 build/
 *.ttc
 *.ttm
+Manifest.toml

verisim-modular-experiment/.machine_readable/6a2/ECOSYSTEM.a2ml

@@ -0,0 +1,75 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(ecosystem
+  (version "1.0.0")
+  (last-updated "2026-04-05")
+
+  (name "verisim-modular-experiment")
+  (type "research-experiment")
+  (purpose "Test whether a non-trivial VerisimCore (identity-core subset of the octad)
+            exists such that VCL consonance claims compose soundly over federations
+            that omit non-core shapes entirely at store level.")
+
+  (position-in-ecosystem
+    (parent "nextgen-databases"
+      (relationship "sub-project")
+      (description "Lives within the nextgen-databases monorepo; no own .git."))
+    (siblings
+      (sibling "verisimdb"
+        (relationship "parent-architecture")
+        (description "Canonical paved-road octad. Experiment is read-only w.r.t. its sources.
+                      Foldback items (doc drift, soundness remarks) track in docs/FOLDBACK.adoc."))
+      (sibling "typeql-experimental"
+        (relationship "sibling-experiment")
+        (description "Experimental sister project exploring VCL type-theoretic extensions.
+                      Same experiment-repo pattern (deno.json / ipkg / machine_readable).")))
+    (description "Opens an architectural question neither verisimdb nor typeql-experimental
+                  asks: the presence axis for modality shapes. Independent falsifier."))
+
+  (related-projects
+    (project "verisimdb"
+      (relationship "reference")
+      (description "Authoritative formal data model (arcvix-octad-data-model.tex)
+                    and 8-shape octad implementation in rust-core/.")
+      (artefacts-used "arcvix-octad-data-model.tex"
+                      "rust-core/verisim-octad/src/query_octad.rs"
+                      "docs/federation-readiness.adoc"
+                      "docs/deployment-modes.adoc"
+                      "CLAUDE.md (octad modality list)"))
+
+    (project "krladapter-jl"
+      (relationship "intended-phase-4-dogfood")
+      (description "Julia package earmarked as first dogfood client for VerisimCore.
+                    Current upstream keeps a VeriSim interface slot open (per vcl-rename
+                    memory). Phase 4 wires KRLAdapter.jl against VerisimCore + federation.")
+      (artefacts-used "(planned: KRLAdapter.jl VeriSim interface slot)"))
+
+    (project "idris2-ecosystem"
+      (relationship "abi-toolchain")
+      (description "Idris2 v0.8.0 used for ABI specification per hyperpolymath standard.")
+      (artefacts-used "idris2 compiler")))
+
+  (standards-followed
+    (standard "hyperpolymath-abi-ffi-standard"
+      (description "Idris2 ABI + (intended) Zig FFI per ~/Documents/hyperpolymath-repos/rsr-template-repo")
+      (conformance "partial — Idris2 ABI done, Zig FFI deferred past Phase 4"))
+    (standard "a2ml-machine-readable"
+      (description "This .machine_readable/6a2/*.a2ml directory")
+      (conformance "complete — STATE, META, ECOSYSTEM all present"))
+    (standard "pmpl-1.0-license"
+      (description "All original code uses SPDX-License-Identifier: PMPL-1.0-or-later")
+      (conformance "complete — all files headered")))
+
+  (deliverables
+    (deliverable "idris2-abi"
+      (description "3-module typechecked ABI: Types, VerisimCore, FederationContract")
+      (status "complete"))
+    (deliverable "julia-reference-impl"
+      (description "Core + Vector peer + federation manager; 70 test assertions green")
+      (status "complete"))
+    (deliverable "path-b-validation"
+      (description "Runtime-confirmed: Core={S,T,R} admits sound federation with
+                    one Federable peer (Vector) on the parity test")
+      (status "complete"))
+    (deliverable "full-nondivisibility-decision"
+      (description "Multi-peer N≥2 non-interference + formal proof + VCL surface")
+      (status "pending (Phase 3 follow-ups + Phase 4)"))))

verisim-modular-experiment/.machine_readable/6a2/META.a2ml

@@ -0,0 +1,84 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(meta
+  (version "1.0.0")
+  (last-updated "2026-04-05")
+
+  (architecture-decisions
+    (decision "shape-absence-as-novel-axis"
+      (status accepted)
+      (date "2026-04-05")
+      (context "Existing verisimdb federation architecture treats all 8 shapes as
+                present-but-located-variably. User raised question: what if shapes
+                can be entirely absent (not just remote)?")
+      (decision "Open 'presence axis' as orthogonal to existing 'location axis'.
+                 Store-level absence is the novel axis this experiment explores.")
+      (rationale "Existing axis: where does each shape live (standalone/federated/hybrid).
+                  New axis: which shapes exist at all. Per-octad absence already handled
+                  (def:octad allows φ(m)=⊥). Store-level absence is new."))
+
+    (decision "core-identity-set"
+      (status accepted)
+      (date "2026-04-05")
+      (context "Phase 1 closure test per shape against formal data model.")
+      (decision "Core={Semantic, Temporal, Provenance}. Federable={Vector, Tensor,
+                 Document, Spatial}. Conditional={Graph}.")
+      (rationale "Semantic=VCL proof substrate. Temporal=inv:persist+def:enrichment+
+                  LWW-total-order+attestation-freshness. Provenance=def:enrichment+
+                  federation-trust-substrate. Others admit absence via d(⊥,·)=0.
+                  Graph required iff cross-entity consonance claims in scope."))
+
+    (decision "idris2-abi-plus-julia-impl"
+      (status accepted)
+      (date "2026-04-05")
+      (context "Hyperpolymath standard: Idris2 ABI + Zig FFI. Phase 3 needs a
+                runnable reference implementation.")
+      (decision "Keep Idris2 ABI per standard. Write Phase 3 prototype in Julia
+                 (not Zig). Zig FFI port deferred to Phase 5+ if Path B validates.")
+      (rationale "Julia aligns with Phase 4 dogfood client (KRLAdapter.jl).
+                  Research prototype pays for iteration speed over runtime speed.
+                  ABI remains canonical; Julia is one valid implementation."))
+
+    (decision "single-shape-phase-3-scope"
+      (status accepted)
+      (date "2026-04-05")
+      (context "Phase 3 scope: reference impl + parity test. Choice of which
+                Federable shape to federate first.")
+      (decision "Vector first (per Phase 3 plan). Vector-Document drift is first
+                 pairwise metric in TeX §4.3; HNSW has clean algebraic drift.")
+      (rationale "PLAN.adoc originally named Temporal — corrected (Temporal is Core,
+                  cannot be federated). Vector is natural first Federable peer."))
+
+    (decision "federated-parity-as-decision-gate"
+      (status accepted)
+      (date "2026-04-05")
+      (context "Phase 3 decision gate needs a concrete falsifier.")
+      (decision "Decision gate = aggregate_drift over {Core + peers} numerically
+                 equals aggregate_drift over monolithic store with same data.
+                 If parity fails, revisit Phase 1 classification.")
+      (rationale "Parity at drift level is stronger than VCL-surface-level parity
+                  — if drift computation is identical, any VCL claim evaluating
+                  via drift is preserved.")
+      (outcome "PASSED — 24/24 parity assertions green.")))
+
+  (development-practices
+    (practice "tex-grounded"
+      (description "Every classification verdict traceable to a TeX definition or
+                    theorem in verisimdb/arcvix-octad-data-model.tex.")
+      (enforcement "docs/CORE-CANDIDATES.adoc cites each def/inv/thm."))
+    (practice "seam-audit-every-phase"
+      (description "After each phase, audit ABI↔impl seams and document in SEAMS.adoc.")
+      (enforcement "docs/SEAMS.adoc updated 2026-04-05 after Phase 3."))
+    (practice "typecheck-before-commit"
+      (description "idris2 --build must pass. Julia test suites must pass.")
+      (enforcement "Pre-commit verification noted in session log.")))
+
+  (design-rationale
+    (why-not-subset-of-verisimdb "verisimdb/ is the paved-road canonical octad.
+      Fragmenting its code is not the goal; opening the presence axis is. Experiment
+      stays read-only w.r.t. main verisimdb sources.")
+    (why-not-zig-phase-3 "Zig FFI is the hyperpolymath production standard but
+      carries a porting cost premature for a falsifier experiment. Julia is sufficient
+      to test the central hypothesis.")
+    (why-path-b-over-path-a "Path A (formalise existing federation) is high-probability
+      low-payoff. Path B (shape-absence) is lower-probability higher-payoff. Path B
+      turned out to be live — non-trivial Core exists.")))

verisim-modular-experiment/.machine_readable/6a2/STATE.a2ml

@@ -0,0 +1,110 @@
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+(state
+  (metadata
+    (version "0.1.0")
+    (last-updated "2026-04-05")
+    (status active))
+
+  (project-context
+    (name "verisim-modular-experiment")
+    (purpose "Research experiment: can any octad shape be entirely absent (store-level)
+              without making VCL consonance claims unsound?")
+    (type "research-prototype")
+    (completion-percentage 55))
+
+  (current-position
+    (phase "phase-3-complete-seams-sorted")
+    (summary "Phase 0-3 complete. Core={Semantic,Temporal,Provenance}, Federable={V,T,D,X},
+              Graph conditional. Idris2 ABI typechecks in v0.8.0. Julia reference impl
+              runs 70/70 assertions green across three suites. Federated aggregate-drift
+              numerically equals monolithic aggregate-drift for same data. Path B
+              runtime-confirmed. Seam audit completed and fixes applied."))
+
+  (phases
+    (phase "phase-0-octad-archaeology"
+      (status complete)
+      (artefact "docs/OCTAD-SHAPES.adoc"))
+    (phase "phase-1-core-identification"
+      (status complete)
+      (decision-gate "passed")
+      (result "Core={S,T,R} Federable={V,T,D,X} Conditional={G}")
+      (artefact "docs/CORE-CANDIDATES.adoc"))
+    (phase "phase-2-federation-contract"
+      (status complete)
+      (artefact "src/Abi/FederationContract.idr" "spec/federation-contract.adoc")
+      (verified "idris2 --build"))
+    (phase "phase-3-reference-impl"
+      (status complete)
+      (decision-gate "passed")
+      (result "70/70 assertions green, federated=monolithic parity confirmed")
+      (language "julia")
+      (federated-shape "vector")
+      (deferred "ed25519" "multi-peer-noninterference" "vcl-parser"))
+    (phase "phase-4-krladapter-dogfood"
+      (status pending))
+    (phase "phase-5-findings-writeup"
+      (status pending)))
+
+  (components
+    (component "idris2-abi"
+      (status complete)
+      (description "3 modules: Types, VerisimCore, FederationContract. Typechecks clean.")
+      (completion 100))
+    (component "julia-core"
+      (status complete)
+      (description "VerisimCore.jl: enrich!, attest, verify_attest, Identity Persistence.")
+      (completion 100))
+    (component "julia-federation"
+      (status complete)
+      (description "FederationManager.jl: renormalise, aggregate_drift, PeerAttestation.")
+      (completion 100))
+    (component "julia-vector-peer"
+      (status complete)
+      (description "First Federable peer: DriftProjector, CoherenceProjector, LWWAcceptor.")
+      (completion 100))
+    (component "julia-crypto-ed25519"
+      (status in-progress)
+      (description "Replacing placeholder SHA-256 with real Ed25519 via libsodium.")
+      (completion 50))
+    (component "documentation"
+      (status complete)
+      (description "README, PLAN, PROOF-NEEDS, DESIGN, OCTAD-SHAPES, CORE-CANDIDATES,
+                    FOLDBACK, SEAMS, PHASE-3-IMPL-PLAN, federation-contract spec, AI manifest.")
+      (completion 90)))
+
+  (verified-results
+    (result "idris2-typecheck"
+      (command "idris2 --build verisim-modular-experiment.ipkg")
+      (status pass))
+    (result "verisim-core-tests"
+      (command "julia --project=. test/test_verisim_core.jl")
+      (status pass)
+      (assertions 25))
+    (result "federation-parity-tests"
+      (command "julia --project=. test/test_federation_parity.jl")
+      (status pass)
+      (assertions 24))
+    (result "seam-tests"
+      (command "julia --project=. test/test_seams.jl")
+      (status pass)
+      (assertions 21)))
+
+  (foldback-to-main-verisimdb
+    (applied
+      (item "docs/deployment-modes.adoc: 6→8 modalities")
+      (item "docs/federation-readiness.adoc: 6→8 modalities + normalizer strategies")
+      (item "arcvix-octad-data-model.tex: rem:agg-drift-renorm added to §4.2"))
+    (pending
+      (item "Normalizer regeneration stub-status doc update (documented in FOLDBACK.adoc)")))
+
+  (critical-next-actions
+    (action "Finish Ed25519 wiring (impl/Crypto.jl written, needs VerisimCore/VectorPeer update)")
+    (action "Add second Federable peer (Document) for multi-peer non-interference test")
+    (action "Write minimal VCL parser/evaluator exercising FROM FEDERATION syntax")
+    (action "Update this STATE.a2ml after each"))
+
+  (session-history
+    (session "2026-04-05"
+      (focus "Full experiment scaffold → Phase 3 runtime validation")
+      (phases-closed "0" "1" "2" "3")
+      (highlight "Path B confirmed: non-trivial Core exists"))))