Skip to content

Commit 66a945c

Browse files
hyperpolymathclaude
andcommitted
fix(vcs-ircd): update disambiguation to reference hyperpolymath/vext as protocol home
Now that hyperpolymath/vext exists as the canonical Vext protocol spec repository, update the disambiguation notices in both README.adoc and 0-AI-MANIFEST.a2ml to point there directly, rather than pointing to burble's consumer implementation. Also adds vexometer/vext to the disambiguation (ISA component named "vext" meaning vexed — a fourth naming collision now documented). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 2844936 commit 66a945c

2 files changed

Lines changed: 31 additions & 19 deletions

File tree

0-AI-MANIFEST.a2ml

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
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) │
@@ -22,18 +22,26 @@
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"
5159
origin = "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
5969
rules = [
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",

README.adoc

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,20 @@
11
= vcs-ircd — VCS IRC Notification Daemon
22
// Formerly named "vext". Renamed to avoid confusion with the Vext
3-
// cryptographic verification protocol in burble/. See disambiguation below.
3+
// cryptographic verification protocol. See disambiguation below.
44

55
[WARNING]
66
====
7-
*Name disambiguation* — two things were called "vext". They are unrelated.
7+
*Name disambiguation* — three things were called "vext". They are unrelated.
88
99
* *You are here:* `vcs-ircd` (formerly `vext`) — a *pooled IRC notification daemon* for
1010
VCS events (Git push, commit, PR). Rust/Tokio. Nothing to do with cryptography.
11-
* *Not here:* the *Vext verification protocol* in Burble — BLAKE3 hash-chain feed
12-
integrity for voice/chat. Lives at
13-
`burble/server/lib/burble/verification/vext.ex`.
11+
* *Not here (canonical spec):* the *Vext verification protocol* — BLAKE3 hash-chain feed
12+
integrity, Idris2 proofs, Ed25519 signatures.
13+
GitHub: https://github.com/hyperpolymath/vext[hyperpolymath/vext]
14+
* *Not here (protocol consumer):* Burble's Vext integration lives at
15+
`burble/server/lib/burble/verification/vext.ex`. (implements the spec above)
1416
15-
If you want the verification protocol → go to the `burble` repo. +
17+
If you want the verification protocol spec → go to `hyperpolymath/vext`. +
1618
If you want to send Git commit notifications to IRC → you are in the right place.
1719
====
1820

0 commit comments

Comments
 (0)