0-AI-MANIFEST.a2ml

// SPDX-License-Identifier: MPL-2.0
// SPDX-FileCopyrightText: 2024-2026 Jonathan D.A. Jewell (hyperpolymath)

// ══════════════════════════════════════════════════════════════════════════════
// ⚠  DISAMBIGUATION — READ THIS FIRST
// ══════════════════════════════════════════════════════════════════════════════
//
// This repo is named vcs-ircd (GitHub: hyperpolymath/vcs-ircd).
// The local directory may still read "vext" — that is a stale path artefact
// from the rename; the canonical name is vcs-ircd.
//
// THREE THINGS WERE CALLED "VEXT". THEY ARE ALL UNRELATED.
//
//  ┌─ YOU ARE HERE ─────────────────────────────────────────────────────────┐
//  │  vcs-ircd  (formerly: vext)                                            │
//  │  A pooled IRC notification daemon for version-control systems.         │
//  │  Rust async daemon (Tokio). Inspired by irker (Eric S. Raymond).       │
//  │  Sends commit/push notifications from Git repos to IRC channels.       │
//  │  Has nothing to do with cryptographic verification.                    │
//  │                                                                        │
//  │  Repo:  github.com/hyperpolymath/vcs-ircd                              │
//  │  Home:  developer-ecosystem/satellites/git-tools/vcs-ircd              │
//  └────────────────────────────────────────────────────────────────────────┘
//
//  ┌─ NOT HERE — WRONG PLACE (CANONICAL SPEC) ──────────────────────────────┐
//  │  Vext — Verifiable, Extensible Communications Protocol (THE SPEC)      │
//  │  BLAKE3 hash chains proving feeds are chronological, complete,         │
//  │  uninjected, and attributable. Idris2 proofs. Ed25519 signatures.      │
//  │                                                                        │
//  │  Canonical spec: github.com/hyperpolymath/vext                         │
//  └────────────────────────────────────────────────────────────────────────┘
//
//  ┌─ NOT HERE — WRONG PLACE (PROTOCOL CONSUMER) ───────────────────────────┐
//  │  Burble's Vext integration (implements the protocol above)             │
//  │  Lives at: burble/server/lib/burble/verification/vext.ex               │
//  └────────────────────────────────────────────────────────────────────────┘
//
//  ┌─ NOT HERE — WRONG PLACE (ISA COMPONENT) ───────────────────────────────┐
//  │  vexometer/vext — named "vext" as in "vexed" (frustrated with LLMs)   │
//  │  Part of the Irritation Surface Analyser. Also unrelated to this.      │
//  └────────────────────────────────────────────────────────────────────────┘
//
// If you want the Vext protocol spec → github.com/hyperpolymath/vext
// If you want the IRC VCS notifier → you are in the right place.
//
// ══════════════════════════════════════════════════════════════════════════════

[identity]
name        = "vcs-ircd"
formerly    = "vext"
kind        = "satellite"
parent-repo = "developer-ecosystem"
path        = "satellites/git-tools/vcs-ircd"
github      = "hyperpolymath/vcs-ircd"

[purpose]
summary = "Pooled IRC notification daemon for VCS events (Git push, commit, PR)"
tech    = "Rust (Tokio async), connection pooling, TLS, rate-limiting"
origin  = "Inspired by irker (ESR); modernised rewrite with async I/O"

[disambiguation]
this-is-not      = "The Vext cryptographic verification protocol"
protocol-spec    = "github.com/hyperpolymath/vext"
protocol-impl    = "burble/server/lib/burble/verification/vext.ex"
also-unrelated   = "vexometer/vext (ISA component named 'vext' = vexed, not verification)"

[invariants]
// Critical rules for AI agents working in this repo
rules = [
  "Do NOT confuse this with the Vext feed-verification protocol (spec: hyperpolymath/vext)",
  "The local directory may still be named 'vext' — the canonical name is vcs-ircd",
  "This is an IRC daemon. It does not do cryptographic verification of anything",
  "Parent: developer-ecosystem satellite. Push to github.com/hyperpolymath/vcs-ircd",
]