refactor(rename): VQL → VCL (VeriSim Consonance Language) — complete propagation

VQL (VeriSim Query Language) has been renamed to VCL (VeriSim Consonance
Language) across the entire nextgen-databases monorepo.

File renames (58 files):
- verisimdb/src/vql/ → verisimdb/src/vcl/ (11 ReScript modules)
- verisimdb/playground/src/VqlKeywords.res → VclKeywords.res
- verisimdb/elixir-orchestration/lib/verisim/query/vql_*.ex → vcl_*.ex (4 files)
- verisimdb/elixir-orchestration/test/**vql*.ex/exs → vcl* (10 files)
- verisimdb/rust-core/**/vql*.rs → vcl*.rs (4 files)
- verisimdb/connectors/clients/*/vql.* → vcl.* (6 files across all SDKs)
- verisimdb/connectors/clients/rescript/src/VeriSimVql.res → VeriSimVcl.res
- verisimdb/vql-bridge/ → verisimdb/vcl-bridge/
- verisimdb/examples/vql-queries/ → vcl-queries/ + .vql → .vcl (10 files)
- verisimdb/elixir-orchestration/test/fixtures/vql/ → vcl/ + .vql → .vcl
- verisimdb/docs/vql-*.adoc → vcl-*.adoc + VQL-SPEC → VCL-SPEC (8 files)
- typeql-experimental/docs/vql-dtpp-grammar.ebnf → vcl-dtpp-grammar.ebnf
- typeql-experimental/examples/*.vqlut → *.vclut (7 files)

Content updates: all VQL/vql/Vql occurrences → VCL/vcl/Vcl in ~160 files
(source, docs, configs, specs — excluding .verisimdb/octads/ historical data)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: hyperpolymath

.machine_readable/6a2/STATE.a2ml

@@ -33,7 +33,7 @@ vcl-clauses = "ProofIntegrity, ProofConsistency, ProofFreshness, ProofConsonance
 [test-coverage]
 unit-tests = "~40 (Elixir consensus + federation adapters)"
 integration-tests = "~12 (federation adapter integration)"
-e2e-tests = "18 (e2e_verisimdb_test.exs — lifecycle, VQL, schema, error handling)"
+e2e-tests = "18 (e2e_verisimdb_test.exs — lifecycle, VCL, schema, error handling)"
 p2p-property-tests = "5 properties + 1 unit (kraft_property_test.exs)"
 aspect-security = "10 tests (aspect/security_test.exs)"
 aspect-concurrency = "14 tests (aspect/concurrency_test.exs)"
@@ -42,24 +42,24 @@ benchmarks = "2 Rust files (modality_benchmarks.rs + throughput_benchmarks.rs)"
 total-new-tests = "43 new tests + 5 properties (2026-04-04)"
 
 [test-status]
-mix-test-failures = "6 pre-existing (VQLTypeChecker binary_to_existing_atom crash, KRaft remove_server timeout)"
+mix-test-failures = "6 pre-existing (VCLTypeChecker binary_to_existing_atom crash, KRaft remove_server timeout)"
 new-test-failures = "0"
 cargo-bench-compile = "PASS (throughput_benchmarks.rs — no errors, no warnings in bench file)"
 gleam-smoke = "Written; requires compiled lith_nif.so to run connection/lifecycle tests"
 
 [blockers]
-- "VQLTypeChecker calls :erlang.binary_to_existing_atom for unknown proof types → ArgumentError (P1 hardening gap)"
-- "VQL parser does not strip null bytes from entity IDs (C-string truncation risk at FFI, P1)"
+- "VCLTypeChecker calls :erlang.binary_to_existing_atom for unknown proof types → ArgumentError (P1 hardening gap)"
+- "VCL parser does not strip null bytes from entity IDs (C-string truncation risk at FFI, P1)"
 - "Integration test (tests/integration_test.rs) uses old API — does not compile (pre-existing)"
 - "modality_benchmarks.rs uses old API — does not compile (pre-existing)"
 
 [route-to-mvp]
 next = "Add Tropical_Determinants.thy + ProofOptimalAssignment VCL clause"
-then = "Fix VQLTypeChecker binary_to_existing_atom crash (P1 hardening)"
-then = "Fix null-byte entity ID sanitisation in VQL parser"
+then = "Fix VCLTypeChecker binary_to_existing_atom crash (P1 hardening)"
+then = "Fix null-byte entity ID sanitisation in VCL parser"
 then = "Update integration_test.rs to current API"
 
 [critical-next-actions]
 1 = "Tropical_Determinants.thy new file — permanent = optimal assignment"
-2 = "Fix VQLTypeChecker to use String.to_existing_atom with rescue guard (P1)"
-3 = "Add null-byte sanitisation in VQLBridge built-in parser (P1)"
+2 = "Fix VCLTypeChecker to use String.to_existing_atom with rescue guard (P1)"
+3 = "Add null-byte sanitisation in VCLBridge built-in parser (P1)"

EXPLAINME.adoc

@@ -39,7 +39,7 @@ The architecture shared across all three databases follows a layered stack:
   Web Frontend (ReScript SPA)
 ----
 
-Each layer is domain-specific. VeriSimDB uses VQL over a Rust/Elixir engine.
+Each layer is domain-specific. VeriSimDB uses VCL over a Rust/Elixir engine.
 QuandleDB uses KQL over a Julia (Skein.jl) engine. LithoGlyph uses GQL over
 a Forth/Factor/Zig engine with Idris2 proofs.
 
@@ -59,7 +59,7 @@ cd verisimdb/elixir-orchestration && mix run ../demos/drift-detection/run_demo.e
 This demo creates 1000 entities, corrupts 50, and verifies that the drift
 detector identifies all 50 with zero false positives (in the sample output).
 The Elixir orchestration layer (`verisimdb/elixir-orchestration/`) coordinates
-the Rust core (`verisimdb/src/`) and the VQL parser (`verisimdb/src/vql/`).
+the Rust core (`verisimdb/src/`) and the VCL parser (`verisimdb/src/vcl/`).
 
 The ABI layer at `verisimdb/src/abi/` (Idris2: `Types.idr`, `Layout.idr`,
 `Foreign.idr`) provides machine-checked memory layout proofs for the C-ABI
@@ -68,9 +68,9 @@ bridge between Rust and Elixir. The capability registry at
 
 === Honest caveat
 
-VeriSimDB is at beta. The drift detection loop works (demo is live). The VQL
+VeriSimDB is at beta. The drift detection loop works (demo is live). The VCL
 query language is approximately 40% complete — basic entity CRUD and
-cross-modal consistency queries work; advanced dependent-type queries (VQL-DT)
+cross-modal consistency queries work; advanced dependent-type queries (VCL-DT)
 are planned. The "formally verified queries" claim in the README refers to
 the Idris2 ABI proofs, not end-to-end query verification (which is roadmap).
 
@@ -92,7 +92,7 @@ ____
 
 | *VeriSimDB*
 | PRIMARY — active development
-| Beta. Drift detection, octad entity model, Elixir orchestration, VQL parser
+| Beta. Drift detection, octad entity model, Elixir orchestration, VCL parser
 (~40% complete), Idris2 ABI proofs. Deployed with per-project instances
 (per VeriSimDB policy: one instance per consumer repo, never shared).
 
@@ -136,15 +136,15 @@ use VeriSimDB.
 | Technology | Role in Next-Gen Databases | Also Used In
 
 | *Rust* (VeriSimDB core)
-| Storage engine, VQL parser, drift detection algorithms
+| Storage engine, VCL parser, drift detection algorithms
 | ephapax, gitbot-fleet, protocol-squisher
 
 | *Elixir* (VeriSimDB orchestration)
 | Distributed coordination, Phoenix API, BEAM fault tolerance
 | burble (voice platform), gossamer (service discovery target)
 
 | *ReScript* (all frontends)
-| VQL query UI, QuandleDB frontend, planned LithoGlyph frontend
+| VCL query UI, QuandleDB frontend, planned LithoGlyph frontend
 | idaptik, panll, gossamer-powered SPAs
 
 | *Idris2 ABI* (VeriSimDB + planned LithoGlyph)
@@ -180,10 +180,10 @@ repo for cross-modal entity consistency
 | Path | What It Proves
 
 | `verisimdb/`
-| Primary database. `src/` — Rust core (storage, drift detection, VQL parser).
+| Primary database. `src/` — Rust core (storage, drift detection, VCL parser).
 `src/abi/` — Idris2 ABI proofs (Types.idr, Layout.idr, Foreign.idr).
 `src/registry/` — modality capability registry.
-`src/vql/` — VQL query language parser and evaluator.
+`src/vcl/` — VCL query language parser and evaluator.
 `elixir-orchestration/` — Elixir/Phoenix distributed coordinator.
 `api/` — JSON HTTP API surface.
 `demos/` — drift-detection demo (the live proof that octad consistency works).

ROADMAP.adoc

@@ -21,8 +21,8 @@ Portfolio established with four database projects.
 
 === VeriSimDB
 * [x] Rust core engine
-* [x] VQL parser (ReScript)
-* [ ] VQL executor (Elixir)
+* [x] VCL parser (ReScript)
+* [ ] VCL executor (Elixir)
 * [ ] Web frontend
 
 === Lithoglyph

TEST-NEEDS.md

@@ -11,43 +11,43 @@
 |-------------|--------|-------|
 | Unit tests   | ~40    | VeriSimDB Elixir: consensus (kraft_node, kraft_wal, kraft_recovery, kraft_transport), federation adapters (mongodb, redis, duckdb, clickhouse, surrealdb, sqlite, neo4j, vector_db, influxdb, object_storage), resolver, adapter + base tests |
 | Integration  | ~12    | Federation adapter integration tests (mongodb, redis, neo4j, clickhouse, surrealdb, influxdb) |
-| E2E          | 18     | `verisimdb/elixir-orchestration/test/verisim/e2e_verisimdb_test.exs` — lifecycle, VQL, schema, error handling |
+| E2E          | 18     | `verisimdb/elixir-orchestration/test/verisim/e2e_verisimdb_test.exs` — lifecycle, VCL, schema, error handling |
 | P2P (property) | 5 props + 1 test | `verisimdb/elixir-orchestration/test/verisim/consensus/kraft_property_test.exs` — leader uniqueness, log replication, state machine, partition tolerance, read-your-writes |
-| Aspect: Security | 10 tests | `verisimdb/elixir-orchestration/test/verisim/aspect/security_test.exs` — VQL injection, unauthorised access, cross-tenant isolation, error disclosure |
-| Aspect: Concurrency | 14 tests | `verisimdb/elixir-orchestration/test/verisim/aspect/concurrency_test.exs` — concurrent entity writes, parallel VQL, concurrent Kraft proposals, DriftMonitor load, SchemaRegistry concurrency |
+| Aspect: Security | 10 tests | `verisimdb/elixir-orchestration/test/verisim/aspect/security_test.exs` — VCL injection, unauthorised access, cross-tenant isolation, error disclosure |
+| Aspect: Concurrency | 14 tests | `verisimdb/elixir-orchestration/test/verisim/aspect/concurrency_test.exs` — concurrent entity writes, parallel VCL, concurrent Kraft proposals, DriftMonitor load, SchemaRegistry concurrency |
 | lithoglyph smoke | Gleam | `lithoglyph/beam/test/lith_beam_smoke_test.gleam` — version, connect, lifecycle, error handling |
-| Benchmarks   | 2 real files | `verisimdb/benches/modality_benchmarks.rs` (Rust, pre-existing), `verisimdb/benches/throughput_benchmarks.rs` (Rust, new — write throughput, read latency, VQL complexity) |
+| Benchmarks   | 2 real files | `verisimdb/benches/modality_benchmarks.rs` (Rust, pre-existing), `verisimdb/benches/throughput_benchmarks.rs` (Rust, new — write throughput, read latency, VCL complexity) |
 
 **Source modules:** ~833 across 2 major subsystems. verisimdb: ~248 files (Rust core, Elixir orchestration, Gleam, Idris2 ABI, Zig FFI, ReScript). lithoglyph: ~212 files (Gleam, Rust, Factor).
 
 ## What's Done (2026-04-04)
 
 ### Completed
-- [x] VeriSimDB E2E tests (18 tests): write→read lifecycle, VQL pipeline, schema validation, error handling
+- [x] VeriSimDB E2E tests (18 tests): write→read lifecycle, VCL pipeline, schema validation, error handling
 - [x] Kraft consensus P2P property tests (5 properties + 1 unit): leader uniqueness, log replication, state machine safety, partition tolerance, read-your-writes
-- [x] VQL security aspect tests (10 tests): injection hardening, auth rejection, cross-tenant isolation, error disclosure
-- [x] Concurrency aspect tests (14 tests): concurrent EntityServer writes, parallel VQL, concurrent Kraft proposals, DriftMonitor load, SchemaRegistry concurrent registration
+- [x] VCL security aspect tests (10 tests): injection hardening, auth rejection, cross-tenant isolation, error disclosure
+- [x] Concurrency aspect tests (14 tests): concurrent EntityServer writes, parallel VCL, concurrent Kraft proposals, DriftMonitor load, SchemaRegistry concurrent registration
 - [x] lithoglyph Gleam smoke test: lifecycle smoke (graceful-failure when NIF not compiled)
-- [x] Rust throughput benchmarks: write throughput (1/10/100 batch), read latency (hot/cold), VQL complexity tiers, write-read round-trip latency
+- [x] Rust throughput benchmarks: write throughput (1/10/100 batch), read latency (hot/cold), VCL complexity tiers, write-read round-trip latency
 
 ### Known Gaps Surfaced by Tests
-- VQLTypeChecker calls `:erlang.binary_to_existing_atom/1` for unknown proof types → ArgumentError (hardening gap, P1)
-- VQL built-in parser does NOT strip null bytes from entity IDs (C-string truncation risk at FFI layer, P1)
+- VCLTypeChecker calls `:erlang.binary_to_existing_atom/1` for unknown proof types → ArgumentError (hardening gap, P1)
+- VCL built-in parser does NOT strip null bytes from entity IDs (C-string truncation risk at FFI layer, P1)
 - SchemaRegistry.register_type/1 returns `{:error, :already_exists}` for duplicate IRIs rather than idempotent `:ok` (P2)
 - `kraft_node_test.exs` `remove_server` test has a GenServer timeout (pre-existing, P2)
 
 ## What's Still Missing
 
 ### P2P (Property-Based) Tests
 - [ ] CRDT convergence: property tests for VeriSimDB's CRDT operations
-- [ ] VQL query parsing: arbitrary query fuzzing (replace fuzz placeholder)
+- [ ] VCL query parsing: arbitrary query fuzzing (replace fuzz placeholder)
 - [ ] Federation: property tests for data consistency across adapters
 - [ ] lithoglyph: data structure invariant tests
 
 ### E2E Tests
 - [ ] Federation: write through adapter → verify in external DB → read back
 - [ ] Kraft consensus: cluster formation → leader election → write → node failure → recovery
-- [ ] VQL: complex query execution with joins/aggregations
+- [ ] VCL: complex query execution with joins/aggregations
 
 ### Build & Execution
 - [ ] `mix test` for VeriSimDB Elixir (currently 6 pre-existing failures, not from new tests)
@@ -73,11 +73,11 @@
 - Unit + smoke: pre-existing + new E2E lifecycle tests
 - Build verification: `mix test` runs (6 pre-existing failures, not from new tests)
 - P2P: KRaft property tests
-- E2E: full lifecycle + VQL + schema + error paths
+- E2E: full lifecycle + VCL + schema + error paths
 - Reflexive: type hierarchy, schema self-validation
-- Contract: VQL proof certificate tests (pre-existing)
+- Contract: VCL proof certificate tests (pre-existing)
 - Aspect: security injection + concurrency tests
-- Benchmarks: Rust throughput/latency/VQL complexity baselines
+- Benchmarks: Rust throughput/latency/VCL complexity baselines
 
 ## FAKE-FUZZ ALERT
 

TOOLING-STATUS.adoc

@@ -18,7 +18,7 @@ management, query execution, and PanLL dashboard panels.
 | Database | Query Language | BoJ ID | Status | Key Components
 
 | **VeriSimDB**
-| VQL (Verified Query Language)
+| VCL (Verified Query Language)
 | 1
 | Mature
 | 10 ReScript modules: Parser, TypeChecker, BiDir, Subtyping, ProofObligation, Circuit, Explain, Context, Error, Types
@@ -65,7 +65,7 @@ Located at `boj-server/cartridges/database-mcp/`:
 * `db_connect_sqlite(path) → slot`
 * `db_disconnect(slot) → result`
 * `db_execute_sql(slot, query) → result` — PostgreSQL, SQLite
-* `db_execute_vql(slot, query) → result` — VeriSimDB
+* `db_execute_vcl(slot, query) → result` — VeriSimDB
 * `db_execute_kql(slot, query) → result` — QuandleDB
 * `db_execute_gql(slot, query) → result` — LithoGlyph
 * `db_begin_query(slot) / db_end_query(slot)` — Transaction boundaries
@@ -80,23 +80,23 @@ Located at `boj-server/cartridges/database-mcp/`:
 | `db-status`              | Connection pool health across all backends
 | `db-connections`         | Active connections, QPS metrics
 | `db-verisimdb`           | Octad counts, proof counts, modality status
-| `vql-ut-safety-dashboard` | 10-level safety pipeline visualisation
-| `vql-ut-query-editor`    | Live type-checking with Idris2 kernel (TypeLL)
-| `vql-ut-proof-explorer`  | Obligation tracking and proof certificates
-| `vql-ut-horror-stories`  | Interactive education — what each safety level prevents
+| `vcl-ut-safety-dashboard` | 10-level safety pipeline visualisation
+| `vcl-ut-query-editor`    | Live type-checking with Idris2 kernel (TypeLL)
+| `vcl-ut-proof-explorer`  | Obligation tracking and proof certificates
+| `vcl-ut-horror-stories`  | Interactive education — what each safety level prevents
 |===
 
 == Universal Safety Pipeline (TypeLL → Query Languages)
 
 All query languages share the same 10-level safety model, originating in TypeLL.
-VQL-UT is the reference implementation. KQL and GQL map their constructs to the
+VCL-UT is the reference implementation. KQL and GQL map their constructs to the
 same levels — no separate "-UT" or "-DT" repos needed.
 
 [source]
 ----
 TypeLL (type theory core — defines the 10 levels)
    │
-   ├──→ VQL-UT  (reference implementation, VeriSimDB)
+   ├──→ VCL-UT  (reference implementation, VeriSimDB)
    ├──→ KQL     (applies same levels, QuandleDB)
    └──→ GQL     (applies same levels, LithoGlyph)
 ----
@@ -105,11 +105,11 @@ TypeLL (type theory core — defines the 10 levels)
 
 Each query language has the same two tiers:
 
-1. **The language** (VQL / KQL / GQL) — what users write
+1. **The language** (VCL / KQL / GQL) — what users write
 2. **The safety pipeline** — TypeLL's 10 levels applied progressively behind the
    language. Simple queries exit early at L1-L2. Proof-carrying queries go to L9-L10.
 
-There is no "VQL-DT", "KQL-DT", or "GQL-DT" as separate products. Dependent type
+There is no "VCL-DT", "KQL-DT", or "GQL-DT" as separate products. Dependent type
 features are part of the safety pipeline at the appropriate levels.
 
 === The 10 Safety Levels
@@ -161,7 +161,7 @@ features are part of the safety pipeline at the appropriate levels.
 
 === Per-Database Safety Documentation
 
-* **VQL:** `verisimdb/docs/vql-vs-vql-dt.adoc` — full spec with architecture diagram
+* **VCL:** `verisimdb/docs/vcl-vs-vcl-dt.adoc` — full spec with architecture diagram
 * **KQL:** `quandledb/docs/kql-safety-model.adoc` — KQL-specific mappings + Idris2 proofs
 * **GQL:** `lithoglyph/docs/gql-safety-model.adoc` — GQL-specific mappings + dependent types
 

TOPOLOGY.md

@@ -9,7 +9,7 @@
 ```
                         ┌─────────────────────────────────────────┐
                         │              DB ANALYST / USER          │
-                        │        (KQL, VQL, Web Dashboards)       │
+                        │        (KQL, VCL, Web Dashboards)       │
                         └───────────────────┬─────────────────────┘
                                             │
                                             ▼
@@ -31,7 +31,7 @@
                         ┌─────────────────────────────────────────┐
                         │          SATELLITE REPOSITORIES         │
                         │  ┌───────────┐  ┌───────────┐  ┌───────┐│
-                        │  │ Skein.jl  │  │ VQL Parser│  │ FBQL- ││
+                        │  │ Skein.jl  │  │ VCL Parser│  │ FBQL- ││
                         │  │ (Engine)  │  │ (ReScript)│  │ DT    ││
                         │  └───────────┘  └───────────┘  └───────┘│
                         │  ┌───────────┐  ┌───────────┐  ┌───────┐│
@@ -67,7 +67,7 @@ DATABASE PORTFOLIO
 
 QUERY LANGUAGES
   KQL (Knot Query)                  ██████░░░░  60%    Topology invariants active
-  VQL (Verification)                ████░░░░░░  40%    Compiler in progress
+  VCL (Verification)                ████░░░░░░  40%    Compiler in progress
   FBQL-DT (Dependently Typed)       █████░░░░░  50%    Compile-time proofs active
 
 REPO INFRASTRUCTURE