Skip to content

Commit d8bf79e

Browse files
hyperpolymathclaude
andcommitted
docs: update CHANGELOG + STATE.a2ml for 2026-04-05 session
VCL rename + V4 certs + prover expansion + RBF recommender + idris2 fixes + /api/verify guard — all tonight's work captured for humans (CHANGELOG) and machines (STATE.a2ml session history). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent a040713 commit d8bf79e

2 files changed

Lines changed: 85 additions & 1 deletion

File tree

.machine_readable/6a2/STATE.a2ml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,4 +83,6 @@
8383

8484
(session-history
8585
("2026-04-04: CRG C blitz - added 55 tests across E2E, contract, aspect, reflexive, property categories")
86-
("2026-04-05: added proof_attempts learning loop (table + MV + /strategy endpoint) and Zig client SDK; closes loop with echidna/hypatia"))))
86+
("2026-04-05: added proof_attempts learning loop (table + MV + /strategy endpoint) and Zig client SDK; closes loop with echidna/hypatia")
87+
("2026-04-05: V4 proof certificates - proof_attempts_cert_policy table, mv_proven_certificates + mv_sanctify_certificates + mv_cert_evidence views, GET /api/v1/proof_attempts/certificates endpoint with window-function evidence pagination; 8 PROVEN + 2 SANCTIFIED certs live against 1156 attempts")
88+
("2026-04-05: VQL->VCL + verisimdb->verisim rename - ClickHouse database renamed (1108 rows migrated via TSV), Prover Enum8 extended to 42 variants, Rust + ReScript identifiers updated, VCL-SPEC.adoc documents 8 proof kinds (was 6), github.com/hyperpolymath/verisimdb URL preserved"))))

CHANGELOG.adoc

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,90 @@ All notable changes to VeriSimDB are documented here. This project uses https://
99

1010
== [Unreleased]
1111

12+
=== Changed
13+
14+
==== VQL → VCL + VeriSimDB → Verisim Rename (2026-04-05)
15+
16+
*Ecosystem-wide identity migration.* The interaction language and
17+
engine name have been reframed:
18+
19+
- *VQL → VCL*: VeriSim *Query* Language becomes VeriSim *Consonance* Language.
20+
Verisim operations are **propositions to a consonance engine**, not
21+
queries against a passive store. Operations split into propositional
22+
(`DECLARE`, `ASSERT`, `RETRACT`) and epistemic (`INSPECT`, `VERIFY`).
23+
- *VeriSimDB → Verisim*: the engine name shortens in discussion, module
24+
names, crates, and the ClickHouse database. The GitHub repository URL
25+
stays `hyperpolymath/verisimdb` to avoid rename damage.
26+
27+
Changed in this repo:
28+
29+
- ClickHouse database: `verisimdb.*` → `verisim.*`, all 1,108 historical
30+
proof_attempts rows migrated via TSV backup/restore
31+
- Prover enum extended to 42 variants (cadical, kissat, spass, eprover,
32+
and all other echidna backends now accepted)
33+
- Rust workspace crates continue to use the `verisim-*` prefix (already
34+
in place before this rename)
35+
- Prometheus metric names: `verisimdb_*` → `verisim_*`
36+
- Documentation prose across `docs/`, `*.adoc`, `*.md`, `CHANGELOG`
37+
- ReScript `.res` VCL modules: mechanical rename of bridge/parser/type-checker
38+
identifiers
39+
- File extension: `.vql` → `.vcl`, directories `src/vql/` → `src/vcl/`,
40+
`vql-bridge/` → `vcl-bridge/`, `examples/vql-queries/` → `examples/vcl-queries/`
41+
- Operation verbs in VCL-context files only: `SELECT` → `INSPECT`,
42+
`INSERT`/`UPDATE`/`UPSERT` → `ASSERT`, `DELETE` → `RETRACT`,
43+
`CREATE`/`ALTER` (DDL) → `DECLARE`, `CHECK CONSTRAINT` → `VERIFY CONSTRAINT`
44+
- Query-phrase prose: `query result(s)` → `inspection result(s)`,
45+
`query builder` → `statement builder`, `run a query` → `perform an inspection`,
46+
etc.
47+
48+
Preserved deliberately: `github.com/hyperpolymath/verisimdb` URLs
49+
(GitHub repo rename pending), `connectors/test-infra/seed/*.sql` (real
50+
ClickHouse DDL, left as SQL), `docs/vcl-vs-sql.adoc` (SQL comparison prose),
51+
generic-English "query language" and "SQL query" references.
52+
53+
The rename cascaded through 18+ dependent repos in the ecosystem
54+
(hypatia, gitbot-fleet, echidna, vql-ut → vcl-total, nesy-solver,
55+
typell, panll, gv-clade-index, typedqliser, squeakwell,
56+
protocol-squisher, nextgen-languages, aerie, typed-wasm,
57+
metadata-grammar, ambientops, verisimiser) over the same day.
58+
1259
=== Added
1360

61+
==== V4: Proof Certificates (2026-04-05)
62+
63+
*PROVEN* and *SANCTIFY* — two new VCL proof types that resolve against
64+
the learning loop's accumulated evidence:
65+
66+
- `proof_attempts_cert_policy` (ReplacingMergeTree): singleton config
67+
table holding `tau_proven`, `n_proven`, `k_sanctify`, `n_sanctify`
68+
thresholds. Default seed: τ=0.80, n=20, k=2, n_s=50.
69+
- `mv_proven_certificates`: view computing PROVEN status per
70+
(obligation_class, prover) pair by joining `mv_prover_success_by_class`
71+
with current policy.
72+
- `mv_sanctify_certificates`: view computing SANCTIFY status per class
73+
when ≥k_sanctify provers hold PROVEN status with ≥n_sanctify combined
74+
attempts.
75+
- `mv_cert_evidence`: view exposing the backing `proof_attempts` rows
76+
for each certificate, enabling falsifiability.
77+
- `GET /api/v1/proof_attempts/certificates`: returns current PROVEN +
78+
SANCTIFY status with optional `class`/`prover` filters, policy echo,
79+
and per-cert evidence cursors. N+1 query pattern collapsed into a
80+
single window-function query (`row_number() OVER (PARTITION BY ...)`).
81+
- Validation at API boundary: `obligation_class` rejected with HTTP 400
82+
if not in the 11-value allowed set (catches typos before they
83+
pollute the strategy MV).
84+
- 5 new unit tests for the certificate surface (26 total passing).
85+
86+
Live certificate snapshot as of 2026-04-05:
87+
8 PROVEN certs (safety/{z3,cvc5,vampire,eprover}, correctness/{z3,cvc5},
88+
linearity/idris2, model-check/cadical).
89+
2 SANCTIFIED classes (safety: 4 provers × 282 attempts,
90+
correctness: 2 provers × 198 attempts).
91+
92+
VCL-SPEC.adoc updated with the eight proof kinds (was six). See
93+
`docs/design/DESIGN-2026-04-05-V4-proof-attempts-vqldt.adoc` for the
94+
full design rationale.
95+
1496
==== Proof-Attempts Learning Loop (2026-04-05)
1597
- **proof_attempts ClickHouse table**: Records every prover invocation across the estate (attempt_id, obligation_id, repo, file, claim, obligation_class, prover_used, outcome, duration_ms, confidence, strategy_tag, timestamps). 20-prover enum covering the echidna portfolio.
1698
- **mv_prover_success_by_class materialized view**: SummingMergeTree aggregation of success_count / total_attempts / total_duration_ms per (obligation_class, prover_used) — the source of truth for strategy recommendations.

0 commit comments

Comments
 (0)