99// The local directory may still read "vext" — that is a stale path artefact
1010// from the rename; the canonical name is vcs-ircd.
1111//
12- // TWO THINGS WERE CALLED "VEXT". THEY ARE COMPLETELY UNRELATED.
12+ // THREE THINGS WERE CALLED "VEXT". THEY ARE ALL UNRELATED.
1313//
1414// ┌─ YOU ARE HERE ─────────────────────────────────────────────────────────┐
1515// │ vcs-ircd (formerly: vext) │
2222// │ Home: developer-ecosystem/satellites/git-tools/vcs-ircd │
2323// └────────────────────────────────────────────────────────────────────────┘
2424//
25- // ┌─ NOT HERE — WRONG PLACE IF THIS IS WHAT YOU WANT ─────────────────────┐
26- // │ Vext (verification protocol) │
27- // │ A cryptographic feed-integrity protocol used by Burble. │
28- // │ BLAKE3 hash chains proving text feeds are chronological, complete, │
29- // │ uninjected, and attributable. Nothing to do with IRC or VCS. │
25+ // ┌─ NOT HERE — WRONG PLACE (CANONICAL SPEC) ──────────────────────────────┐
26+ // │ Vext — Verifiable, Extensible Communications Protocol (THE SPEC) │
27+ // │ BLAKE3 hash chains proving feeds are chronological, complete, │
28+ // │ uninjected, and attributable. Idris2 proofs. Ed25519 signatures. │
3029// │ │
31- // │ Lives at: burble/server/lib/burble/verification/vext.ex │
32- // │ burble/server/lib/burble/verification/vext_groove.ex │
30+ // │ Canonical spec: github.com/hyperpolymath/vext │
3331// └────────────────────────────────────────────────────────────────────────┘
3432//
35- // If you landed here looking for the Vext verification protocol → go to burble.
36- // If you landed here looking for the IRC VCS notifier → you are in the right place.
33+ // ┌─ NOT HERE — WRONG PLACE (PROTOCOL CONSUMER) ───────────────────────────┐
34+ // │ Burble's Vext integration (implements the protocol above) │
35+ // │ Lives at: burble/server/lib/burble/verification/vext.ex │
36+ // └────────────────────────────────────────────────────────────────────────┘
37+ //
38+ // ┌─ NOT HERE — WRONG PLACE (ISA COMPONENT) ───────────────────────────────┐
39+ // │ vexometer/vext — named "vext" as in "vexed" (frustrated with LLMs) │
40+ // │ Part of the Irritation Surface Analyser. Also unrelated to this. │
41+ // └────────────────────────────────────────────────────────────────────────┘
42+ //
43+ // If you want the Vext protocol spec → github.com/hyperpolymath/vext
44+ // If you want the IRC VCS notifier → you are in the right place.
3745//
3846// ══════════════════════════════════════════════════════════════════════════════
3947
@@ -51,13 +59,15 @@ tech = "Rust (Tokio async), connection pooling, TLS, rate-limiting"
5159origin = "Inspired by irker (ESR); modernised rewrite with async I/O"
5260
5361[disambiguation]
54- this-is-not = "The Vext cryptographic verification protocol"
55- that-lives-at = "burble/server/lib/burble/verification/vext.ex"
62+ this-is-not = "The Vext cryptographic verification protocol"
63+ protocol-spec = "github.com/hyperpolymath/vext"
64+ protocol-impl = "burble/server/lib/burble/verification/vext.ex"
65+ also-unrelated = "vexometer/vext (ISA component named 'vext' = vexed, not verification)"
5666
5767[invariants]
5868// Critical rules for AI agents working in this repo
5969rules = [
60- "Do NOT confuse this with the Vext feed-verification protocol in burble ",
70+ "Do NOT confuse this with the Vext feed-verification protocol (spec: hyperpolymath/vext) ",
6171 "The local directory may still be named 'vext' — the canonical name is vcs-ircd",
6272 "This is an IRC daemon. It does not do cryptographic verification of anything",
6373 "Parent: developer-ecosystem satellite. Push to github.com/hyperpolymath/vcs-ircd",
0 commit comments