Skip to content

Commit 77b4d10

Browse files
hyperpolymathclaude
andcommitted
refactor: rename hexad→octad universally across VeriSimDB
372 files changed across Rust core, Elixir/V/Zig/Gleam/Julia SDKs, Idris2 ABI, JSON schemas, proto files, docs, and data directories. All type names (HexadId→OctadId, HexadStore→OctadStore, etc.), API routes (/hexads→/octads), and module/file names updated. cargo build --release compiles clean. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 6e82681 commit 77b4d10

372 files changed

Lines changed: 3591 additions & 3430 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.hypatia/activity.jsonl

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"timestamp":"2026-03-08T02:04:48Z","bot":"hypatia-autofix","action":"scan","details":"fixes=5"}

.hypatia/last-visit.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"last_visit": "2026-03-08T02:04:48Z",
3+
"last_bot": "hypatia-autofix",
4+
"last_action": "scan",
5+
"visits_total": 1
6+
}

verisimdb/.claude/CLAUDE.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ The following files in `.machine_readable/` contain structured project metadata:
3131
│ ├── verisim-temporal (versioning/time-series) │
3232
│ ├── verisim-provenance (origin/lineage tracking) │
3333
│ ├── verisim-spatial (geospatial/R-tree) │
34-
│ ├── verisim-hexad (unified entity → octad evolution) │
34+
│ ├── verisim-octad (unified entity → octad evolution) │
3535
│ ├── verisim-drift (drift detection) │
3636
│ └── verisim-normalizer (self-normalization) │
3737
└─────────────────────────────────────────────────────────────┘
@@ -148,7 +148,7 @@ All images use `cgr.dev/chainguard/wolfi-base:latest`.
148148

149149
## Key Concepts
150150

151-
### Octad Entity (formerly Hexad)
151+
### Octad Entity (formerly Octad)
152152
An Octad is one entity with 8 synchronized representations:
153153
- **Graph**: RDF triples and property graph edges
154154
- **Vector**: Embedding for similarity search
@@ -177,16 +177,16 @@ When drift exceeds thresholds, the normalizer:
177177

178178
## Code Patterns
179179

180-
### Creating a Hexad (Rust)
180+
### Creating a Octad (Rust)
181181
```rust
182-
let input = HexadBuilder::new()
182+
let input = OctadBuilder::new()
183183
.with_document("Title", "Body content")
184184
.with_embedding(vec![0.1, 0.2, ...])
185185
.with_types(vec!["http://example.org/Document"])
186186
.with_relationships(vec![("relates_to", "other-entity-id")])
187187
.build();
188188

189-
let hexad = store.create(input).await?;
189+
let octad = store.create(input).await?;
190190
```
191191

192192
### Entity Server (Elixir)
@@ -242,7 +242,7 @@ hyperpolymath/verisimdb-data (new repo)
242242
│ └── latest-scan.json
243243
├── drift/ # drift detection snapshots
244244
│ └── drift-status.json
245-
├── index.json # Master index of all hexads
245+
├── index.json # Master index of all octads
246246
└── .github/workflows/
247247
└── ingest.yml # Workflow: receive data, update index
248248
```
@@ -277,13 +277,13 @@ When ready to scale beyond flat files:
277277
### Data Flow (IMPLEMENTED)
278278

279279
```
280-
panic-attack assail → ScanIngester → octad hexads → PatternQuery → DispatchBridge → gitbot-fleet
280+
panic-attack assail → ScanIngester → octad octads → PatternQuery → DispatchBridge → gitbot-fleet
281281
↑ WORKS ↑ WORKS ↑ WORKS ↑ WORKS ↑ JSONL logged
282282
```
283283

284284
### VeriSimDB-Side Modules (elixir-orchestration/lib/verisim/hypatia/)
285285

286-
1. **ScanIngester** (`scan_ingester.ex`): Ingests panic-attack scan results as octad hexad entities
286+
1. **ScanIngester** (`scan_ingester.ex`): Ingests panic-attack scan results as octad octad entities
287287
- Builds Document (searchable text), Graph (triples), Temporal (timestamps), Vector (embeddings),
288288
Provenance (scanner origin), Semantic (category tags) modalities
289289
- Falls back to ETS (`:hypatia_scans`) when Rust core unavailable
@@ -351,7 +351,7 @@ Resolved in recent sessions:
351351
## Hypatia Integration Status
352352

353353
**Working (VeriSimDB side — 3 modules, 37 tests):**
354-
- ScanIngester: panic-attack JSON → octad hexads (Document, Graph, Temporal, Vector, Provenance, Semantic)
354+
- ScanIngester: panic-attack JSON → octad octads (Document, Graph, Temporal, Vector, Provenance, Semantic)
355355
- PatternQuery: cross-repo analytics (pipeline health, severity distribution, temporal trends, hotspots)
356356
- DispatchBridge: reads JSONL dispatch manifests, summarizes outcomes, feeds drift tracking
357357
- Hypatia VQL layer reads verisimdb-data flat files directly
@@ -380,7 +380,7 @@ verisimdb/
380380
│ ├── verisim-semantic/
381381
│ ├── verisim-document/
382382
│ ├── verisim-temporal/
383-
│ ├── verisim-hexad/
383+
│ ├── verisim-octad/
384384
│ ├── verisim-drift/
385385
│ ├── verisim-normalizer/
386386
│ └── verisim-api/

verisimdb/.machine_readable/AGENTIC.scm

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -111,18 +111,18 @@
111111
"- Monitor cache hit rate per query pattern
112112
- Adjust TTL dynamically (5 min → 1 hour if high hit rate)
113113
- Evict stale cache entries proactively
114-
- Prefetch frequently accessed hexads
114+
- Prefetch frequently accessed octads
115115
- Invalidate cache on drift detection")
116116
(decision-making
117117
(rules
118118
"IF cache_hit_rate > 90% THEN increase_ttl (1.5×)
119119
IF cache_hit_rate < 40% THEN decrease_ttl (0.7×)
120-
IF drift_detected(hexad_id) THEN invalidate_cache(hexad_id)
121-
IF query_frequency > 100/hour THEN prefetch_related_hexads")
120+
IF drift_detected(octad_id) THEN invalidate_cache(octad_id)
121+
IF query_frequency > 100/hour THEN prefetch_related_octads")
122122
(learning
123123
"- Observe: Cache hit rate, query patterns, drift frequency
124124
- Decide: Optimal TTL per query type, what to prefetch
125-
- Act: Adjust TTL, prefetch hexads, evict stale entries
125+
- Act: Adjust TTL, prefetch octads, evict stale entries
126126
- Measure: Cache hit rate, query latency, memory usage")
127127
(constraints
128128
"- Must not exceed memory budget (2 GB cache per store)
@@ -132,9 +132,9 @@
132132
(language . "Rust")
133133
(file . "src/verisim-cache/")
134134
(state
135-
"- cache_entries: LRU cache (hexad_id → cached result + TTL)
135+
"- cache_entries: LRU cache (octad_id → cached result + TTL)
136136
- ttl_policy: Map of query pattern to TTL
137-
- prefetch_queue: Hexads to prefetch (priority queue)"))))
137+
- prefetch_queue: Octads to prefetch (priority queue)"))))
138138

139139
;; ============================================================================
140140
;; AGENT COORDINATION
@@ -147,7 +147,7 @@
147147
((drift-detected
148148
(from . "drift-repair-agent")
149149
(to . "cache-manager-agent")
150-
(payload . "{hexad_id, drift_type, severity}"))
150+
(payload . "{octad_id, drift_type, severity}"))
151151

152152
(query-slow
153153
(from . "query-optimizer-agent")
@@ -162,7 +162,7 @@
162162
(cache-invalidate
163163
(from . "drift-repair-agent")
164164
(to . "cache-manager-agent")
165-
(payload . "{hexad_id, reason}")))))
165+
(payload . "{octad_id, reason}")))))
166166

167167
(conflict-resolution
168168
(scenario . "Drift repair agent wants to push, but network budget exceeded")

verisimdb/.machine_readable/ECOSYSTEM.scm

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@
5454
(project "datomic")
5555
(relationship "architectural-inspiration")
5656
(url "https://www.datomic.com")
57-
(rationale "Datomic's immutable temporal log and separation of storage/query influenced VeriSimDB's temporal modality and hexad architecture."))
57+
(rationale "Datomic's immutable temporal log and separation of storage/query influenced VeriSimDB's temporal modality and octad architecture."))
5858

5959
(inspiration
6060
(project "apache-kafka")
Lines changed: 154 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
1+
; SPDX-License-Identifier: PMPL-1.0-or-later
2+
; Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
;
4+
; ENSAID_CONFIG.a2ml — PanLL configuration for VeriSimDB.
5+
; VeriSimDB is a formally verified database with Idris2 ABI, Zig FFI,
6+
; V-lang API gateway, VQL query language, and a registry subsystem.
7+
; This is a key dogfooding project for the full ABI→FFI→Adapter stack.
8+
9+
; ─────────────────────────────────────────────────────────────────────
10+
; [ensaid] — eNSAID environment identity
11+
; ─────────────────────────────────────────────────────────────────────
12+
[ensaid]
13+
version = "1.0"
14+
name = "verisimdb-dev"
15+
description = "Formally verified database development environment"
16+
humidity = "dry"
17+
; Humidity: "dry" = symbolic-heavy. VeriSimDB is a formally verified system —
18+
; proofs and type checking dominate. Neural assists with query optimisation
19+
; and test generation, but never overrides the formal guarantees.
20+
21+
; ─────────────────────────────────────────────────────────────────────
22+
; [workspace] — file watching, language detection, build integration
23+
; ─────────────────────────────────────────────────────────────────────
24+
[workspace]
25+
root = "."
26+
watch_extensions = [".idr", ".zig", ".v", ".vql", ".gleam", ".toml"]
27+
; .idr = ABI definitions, .zig = FFI bridge, .v = API gateway,
28+
; .vql = VeriSimDB Query Language, .gleam = REPL/tooling
29+
ignore_patterns = ["build/", ".git/", "zig-cache/", "zig-out/", "_build/"]
30+
editor = "vscodium"
31+
build_command = "just build"
32+
test_command = "just test"
33+
language_id = "idris2"
34+
; Primary specification language. Implementation spans Zig + V + Gleam.
35+
36+
; ─────────────────────────────────────────────────────────────────────
37+
; [preferences] — developer preferences and UI settings
38+
; ─────────────────────────────────────────────────────────────────────
39+
[preferences]
40+
theme = "dark"
41+
font_size = 14
42+
show_line_numbers = true
43+
auto_save = true
44+
auto_format_on_save = true
45+
tab_size = 2
46+
panel_layout = "three-column"
47+
48+
; ─────────────────────────────────────────────────────────────────────
49+
; [panels] — which PanLL panels are enabled for this project
50+
; ─────────────────────────────────────────────────────────────────────
51+
[panels]
52+
enabled = [
53+
"valence-shell", ; Terminal + command execution
54+
"editor-bridge", ; Editor integration
55+
"build-dashboard", ; Multi-language build status (Idris2 + Zig + V)
56+
"boj", ; BoJ dashboard — VeriSimDB is a BoJ consumer
57+
"database", ; Database inspection — dogfooding VeriSimDB itself
58+
"vm-inspector", ; Query engine / VQL inspection
59+
"security", ; Security scanning (Hypatia)
60+
"reposystem", ; Repository management
61+
"panic-attack", ; Error analysis
62+
"tsdm", ; Type System Design Mode — ABI type exploration
63+
"migration", ; Schema migration tracking
64+
]
65+
66+
disabled = [
67+
"network", ; Network handled by V-lang adapter
68+
"container", ; Container builds handled externally
69+
"fleet", ; Single-repo work
70+
]
71+
72+
; ─────────────────────────────────────────────────────────────────────
73+
; [workflows] — project-specific workflow definitions
74+
; ─────────────────────────────────────────────────────────────────────
75+
[workflows]
76+
77+
[workflows.zig-on-abi-change]
78+
trigger = "file_save"
79+
match = "src/abi/*.idr"
80+
action = "run_command"
81+
command = "cd ffi/zig && zig build test"
82+
description = "Rebuild and test Zig FFI when Idris2 ABI definitions change"
83+
84+
[workflows.adapter-on-ffi-change]
85+
trigger = "file_save"
86+
match = "ffi/zig/src/*.zig"
87+
action = "run_command"
88+
command = "cd v-api-gateway && v build ."
89+
description = "Rebuild V-lang API gateway when Zig FFI changes"
90+
91+
[workflows.vql-test-on-save]
92+
trigger = "file_save"
93+
match = "src/vql/*.idr"
94+
action = "run_command"
95+
command = "idris2 --check src/vql/Parser.idr"
96+
description = "Verify VQL parser when query language definitions change"
97+
98+
[workflows.registry-test]
99+
trigger = "file_save"
100+
match = "src/registry/*.idr"
101+
action = "run_command"
102+
command = "idris2 --check src/registry/Registry.idr"
103+
description = "Verify registry types when registry definitions change"
104+
105+
[workflows.debugger-rebuild]
106+
trigger = "file_save"
107+
match = "debugger/src/**"
108+
action = "run_command"
109+
command = "cd debugger && just build"
110+
description = "Rebuild debugger when debugger source changes"
111+
112+
; ─────────────────────────────────────────────────────────────────────
113+
; [clades] — panel clade taxonomy for this project
114+
; ─────────────────────────────────────────────────────────────────────
115+
[clades]
116+
active = ["builder", "database", "terminal", "scanner", "viewer", "bridge"]
117+
; Database development uses builder (multi-lang compilation), database
118+
; (dogfooding VeriSimDB), terminal (VQL REPL), scanner (security),
119+
; viewer (query plans), bridge (editor integration).
120+
121+
; ─────────────────────────────────────────────────────────────────────
122+
; [portfolios] — named panel/workflow presets
123+
; ─────────────────────────────────────────────────────────────────────
124+
[portfolios]
125+
126+
[portfolios.abi-focus]
127+
description = "Formal ABI development — Idris2 type definitions"
128+
panels = ["editor-bridge", "tsdm", "build-dashboard"]
129+
layout = "three-column"
130+
focus = "tsdm"
131+
132+
[portfolios.ffi-testing]
133+
description = "FFI bridge testing — Zig implementation"
134+
panels = ["valence-shell", "build-dashboard", "panic-attack"]
135+
layout = "three-column"
136+
focus = "build-dashboard"
137+
138+
[portfolios.query-dev]
139+
description = "VQL query language development"
140+
panels = ["editor-bridge", "vm-inspector", "database"]
141+
layout = "three-column"
142+
focus = "vm-inspector"
143+
144+
[portfolios.full-stack]
145+
description = "Full VeriSimDB development view"
146+
panels = ["valence-shell", "editor-bridge", "build-dashboard", "boj", "database", "tsdm"]
147+
layout = "three-column"
148+
focus = "build-dashboard"
149+
150+
[portfolios.integration]
151+
description = "End-to-end integration testing"
152+
panels = ["valence-shell", "database", "panic-attack", "security"]
153+
layout = "two-column"
154+
focus = "valence-shell"

0 commit comments

Comments
 (0)