Skip to content

Commit a4480ae

Browse files
hyperpolymathclaude
andcommitted
chore(naming): estate-wide VQL → VCL + VCL-DT/dt++ → VCL-UT rename sweep
Complete rename across 93 files in nextgen-databases. All stale naming now replaced with the canonical forms: VCL (VeriSim Consonance Language) and VCL-UT (VCL Usage-Tracked types). Changes: - VQL → VCL throughout docs, source, tests, examples, data files - VCL-DT / VCL-dt / VCL-dt++ / VQL-dt++ → VCL-UT everywhere - "VeriSim Query Language" → "VeriSim Consonance Language" - "Verisimilitude Query Language" → "VeriSim Consonance Language" - typeql-experimental/docs/vcl-dtpp-grammar.ebnf → vcl-ut-grammar.ebnf - VCL-SPEC.adoc: two residuals fixed (line 2879 "dt++ clause", line 3027 "vcl-dt++" API string) - Naming note boxes added to VCL-SPEC.adoc and typeql-experimental/README.adoc Deliberate exceptions (preserved as historical context): - verisimdb/docs/vcl-vs-vcl-dt.adoc: "VCL-DT" retained only in explicit historical-note section explaining the old name's origin - Database.res.mjs: generated build artifact; source (Database.res) already correct Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 3396542 commit a4480ae

File tree

93 files changed

+318
-282
lines changed

Some content is hidden

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

93 files changed

+318
-282
lines changed

EXPLAINME.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ bridge between Rust and Elixir. The capability registry at
7070

7171
VeriSimDB is at beta. The drift detection loop works (demo is live). The VCL
7272
query language is approximately 40% complete — basic entity CRUD and
73-
cross-modal consistency queries work; advanced dependent-type queries (VCL-DT)
73+
cross-modal consistency queries work; advanced dependent-type queries (VCL-UT)
7474
are planned. The "formally verified queries" claim in the README refers to
7575
the Idris2 ABI proofs, not end-to-end query verification (which is roadmap).
7676

TOOLING-STATUS.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@ Each query language has the same two tiers:
109109
2. **The safety pipeline** — TypeLL's 10 levels applied progressively behind the
110110
language. Simple queries exit early at L1-L2. Proof-carrying queries go to L9-L10.
111111

112-
There is no "VCL-DT", "KQL-DT", or "GQL-DT" as separate products. Dependent type
112+
There is no "VCL-UT", "KQL-DT", or "GQL-DT" as separate products. Dependent type
113113
features are part of the safety pipeline at the appropriate levels.
114114

115115
=== The 10 Safety Levels

lithoglyph/README.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ toc::[]
2525
====
2626
**Project status: Active, secondary priority.** LithoGlyph is working towards production for specialist use in **journalism, narrative arts, and media/communications**. It is not the primary priority project right now — that is https://github.com/hyperpolymath/verisimdb[VeriSimDB], which is a substantial undertaking in cross-modal database consistency. Lessons learned from VeriSimDB (drift detection, formal verification, federation architecture) will directly improve LithoGlyph when development focus returns here.
2727
28-
**For most journalism, storytelling, and media workflows, LithoGlyph and its query language GQL are likely the database you want.** The narrative-first, reversible, audit-grade design is built specifically for this domain. https://github.com/hyperpolymath/verisimdb[VeriSimDB] and https://github.com/hyperpolymath/gql-dt[VCL/VCL-DT] become more relevant when your work involves cross-source investigative verification, large-scale entity tracking across multiple systems, long-term identity consistency, or situations where you need to prove that data across different databases has not drifted apart. For everything else — the story you want to write, the sources you want to cite, the narrative you want to build — LithoGlyph is designed to be your storage layer.
28+
**For most journalism, storytelling, and media workflows, LithoGlyph and its query language GQL are likely the database you want.** The narrative-first, reversible, audit-grade design is built specifically for this domain. https://github.com/hyperpolymath/verisimdb[VeriSimDB] and https://github.com/hyperpolymath/gql-dt[VCL/VCL-UT] become more relevant when your work involves cross-source investigative verification, large-scale entity tracking across multiple systems, long-term identity consistency, or situations where you need to prove that data across different databases has not drifted apart. For everything else — the story you want to write, the sources you want to cite, the narrative you want to build — LithoGlyph is designed to be your storage layer.
2929
3030
In the long run, LithoGlyph is intended to work intimately with tools like bofig in the portfolio and serve as a database for journalism and PR applications more broadly.
3131
====

typeql-experimental/0-AI-MANIFEST.a2ml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
## WHAT IS THIS?
77

8-
This is the AI manifest for **typeql-experimental** (VCL-dt++ / TypeQL-experimental).
8+
This is the AI manifest for **typeql-experimental** (VCL-UT / TypeQL-experimental).
99
An experimental exploration of six advanced type-theoretic extensions to VCL:
1010

1111
1. **Linear types** — resource-counted connections via Idris2 QTT
@@ -101,7 +101,7 @@ grep -rn 'believe_me\|assert_total\|assert_smaller' src/abi/
101101
## KEY RELATIONSHIPS
102102

103103
- **Parent**: `nextgen-databases` monorepo
104-
- **Sibling**: `verisimdb` (VCL v3.0 base grammar, VCL-dt ~35% wired)
104+
- **Sibling**: `verisimdb` (VCL v3.0 base grammar, VCL-UT ~35% wired)
105105
- **Sibling**: `lithoglyph` (GQL-dt, Idris2 ABI patterns)
106106
- **Reference**: `proven` (formal verification library)
107107

@@ -119,7 +119,7 @@ grep -rn 'believe_me\|assert_total\|assert_smaller' src/abi/
119119
- Read `.machine_readable/STATE.scm` for current status
120120
- Understand the dual-language split (Idris2 + ReScript)
121121
- Know the banned patterns (believe_me, assert_total, assert_smaller)
122-
- Check `docs/vcl-dtpp-grammar.ebnf` for the grammar delta
122+
- Check `docs/vcl-ut-grammar.ebnf` for the grammar delta
123123

124124
## META
125125

typeql-experimental/DESIGN-2026-03-01-typeql-experimental.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
// SPDX-License-Identifier: PMPL-1.0-or-later
2-
= Design Document: typeql-experimental (VCL-dt++)
2+
= Design Document: typeql-experimental (VCL-UT)
33
Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
:date: 2026-03-01
55
:repo: nextgen-databases/typeql-experimental
@@ -8,18 +8,18 @@ Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
88
== Summary
99

1010
Create an experimental exploration space for six advanced type-theoretic
11-
extensions to VCL (VeriSim Query Language). These extensions leverage Idris2's
11+
extensions to VCL (VeriSim Consonance Language). These extensions leverage Idris2's
1212
native quantitative type theory (QTT) to provide compiler-enforced resource
1313
safety, session protocols, and effect tracking for database queries.
1414

1515
== Motivation
1616

17-
VCL-dt (dependently-typed VCL) is ~35% wired end-to-end in VeriSimDB, covering
17+
VCL-UT (dependently-typed VCL) is ~35% wired end-to-end in VeriSimDB, covering
1818
Pi/Sigma types, proof clauses, and basic type checking. The next frontier is
1919
type-level resource management — ensuring connections aren't leaked, transactions
2020
follow protocols, and effects are tracked statically.
2121

22-
These features are too experimental for the production VCL-dt codebase. A
22+
These features are too experimental for the production VCL-UT codebase. A
2323
standalone exploration space allows rapid iteration without destabilising the
2424
existing type checker.
2525

typeql-experimental/Justfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# SPDX-License-Identifier: PMPL-1.0-or-later
2-
# typeql-experimental — Build recipes for VCL-dt++ experimental type system
2+
# typeql-experimental — Build recipes for VCL-UT experimental type system
33

44
# Default recipe: type-check all Idris2 modules
55
default: check

typeql-experimental/README.adoc

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,29 @@
11
// SPDX-License-Identifier: PMPL-1.0-or-later
2-
= typeql-experimental (VCL-dt++)
2+
= typeql-experimental (VCL-UT)
33
Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
:description: Experimental type-theoretic extensions to VCL
55
:toc: macro
66
:icons: font
77

8+
[NOTE]
9+
====
10+
**Naming.** This module is the **VCL-UT** extension tier.
11+
12+
* *VCL* = VeriSim Consonance Language — the base query/type language.
13+
_Consonance_ = cross-modal harmony; VeriSimDB keeps eight modality representations
14+
in agreement with each other.
15+
* *VCL-UT* = VCL with Usage-Tracked types.
16+
_Usage-Tracked_ = these extensions track resource consumption: linear consumption
17+
counts, session state, side-effects, and usage limits.
18+
File extension: `.vclut`.
19+
20+
Prior names *VCL-UT* and *VCL-UT* are retired. Use **VCL-UT** exclusively.
21+
====
22+
823
== Overview
924

1025
**typeql-experimental** explores six advanced type-theoretic extensions to the
11-
VeriSim Query Language (VCL), building on the VCL-dt dependent type system
26+
VeriSim Consonance Language (VCL), building on the VCL-UT dependent type system
1227
(~35% wired in VeriSimDB). Rather than bolting these onto the production
1328
codebase, this is a standalone exploration space within the `nextgen-databases`
1429
monorepo.
@@ -130,7 +145,7 @@ grep -rn 'believe_me\|assert_total\|assert_smaller' src/abi/
130145
== Grammar
131146

132147
The query language extends VCL v3.0 with six new optional clauses appended
133-
after the standard query. See `docs/vcl-dtpp-grammar.ebnf` for the delta
148+
after the standard query. See `docs/vcl-ut-grammar.ebnf` for the delta
134149
grammar. No keyword conflicts — all new clause keywords are disjoint from
135150
VCL's 60+ reserved keywords.
136151

typeql-experimental/WHITEPAPER.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212

1313
## Abstract
1414

15-
TypeQL-Experimental (VCL-dt++) explores the application of Quantitative Type
15+
TypeQL-Experimental (VCL-UT) explores the application of Quantitative Type
1616
Theory (QTT) to database query languages, demonstrating that six categories of
1717
runtime database errors—connection leaks, protocol violations, effect misuse,
1818
scope leakage, missing postcondition guarantees, and resource over-consumption—
@@ -78,7 +78,7 @@ a native feature of the language, not an encoding.
7878

7979
### 1.3 Contributions
8080

81-
1. **Six type-theoretic extensions** to VCL (VeriSim Query Language) that
81+
1. **Six type-theoretic extensions** to VCL (VeriSim Consonance Language) that
8282
eliminate the six bug categories above at compile time (Section 3).
8383

8484
2. **A dual-language architecture** where Idris2 proves properties and ReScript
@@ -96,7 +96,7 @@ a native feature of the language, not an encoding.
9696

9797
### 2.1 VCL v3.0
9898

99-
VeriSim Query Language (VCL) is the query language for VeriSimDB, a multi-modal
99+
VeriSim Consonance Language (VCL) is the query language for VeriSimDB, a multi-modal
100100
database with eight query modalities (GRAPH, DOCUMENT, VECTOR, TIME_SERIES,
101101
SPATIAL, STATISTICAL, SEMANTIC, RELATIONAL). VCL supports cross-modal queries
102102
via HEXAD references (content-addressed UUIDs).

typeql-experimental/docs/type-system-spec.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
// SPDX-License-Identifier: PMPL-1.0-or-later
2-
= VCL-dt++ Type System Specification
2+
= VCL-UT Type System Specification
33
Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
:date: 2026-03-01
55
:toc: macro
66
:icons: font
77

88
== Overview
99

10-
This document specifies the formal type system for the six VCL-dt++ extensions.
10+
This document specifies the formal type system for the six VCL-UT extensions.
1111
Each extension is defined by its Idris2 types, key judgements, and soundness
1212
properties. The implementation lives in `src/abi/`.
1313

typeql-experimental/docs/vcl-dtpp-grammar.ebnf renamed to typeql-experimental/docs/vcl-ut-grammar.ebnf

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
(* SPDX-License-Identifier: PMPL-1.0-or-later *)
2-
(* VCL-dt++ (TypeQL-experimental) Grammar Delta *)
2+
(* VCL-UT (TypeQL-experimental) Grammar Delta *)
33
(* Extends: VCL v3.0 (verisimdb/docs/vcl-grammar.ebnf, 317 lines) *)
44
(* Version: 0.1.0 *)
55
(* Date: 2026-03-01 *)
@@ -176,7 +176,7 @@ usage_clause = 'USAGE', 'LIMIT', positive_integer ;
176176
8. EXTENDED RESERVED KEYWORDS
177177
============================================================================
178178
179-
New keywords added by VCL-dt++ (disjoint from VCL v3.0's 60+ keywords):
179+
New keywords added by VCL-UT (disjoint from VCL v3.0's 60+ keywords):
180180
============================================================================ *)
181181
182182
vcldtpp_keywords = 'CONSUME' | 'AFTER' | 'USE'

0 commit comments

Comments
 (0)