From 8a5dc7002e66c822d7ca039d2e3035a685ecd769 Mon Sep 17 00:00:00 2001 From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com> Date: Thu, 28 May 2026 09:58:10 +0100 Subject: [PATCH] docs(v-ecosystem): document estate-wide V-lang carve-out MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per estate-wide owner directive (2026-05-28): Zig is the default for APIs/FFIs across the estate; this v-ecosystem/ subtree is the only non-archive carve-out for V-lang source. The new banner cross-references the enforcement mechanism — hypatia's cicd_rules/vlang_detected rule allowlists this path via path_allow_prefixes. Co-Authored-By: Claude Opus 4.7 (1M context) --- v-ecosystem/README.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/v-ecosystem/README.adoc b/v-ecosystem/README.adoc index 22f9091a..54967d9f 100644 --- a/v-ecosystem/README.adoc +++ b/v-ecosystem/README.adoc @@ -6,6 +6,21 @@ Jonathan D.A. Jewell (hyperpolymath) Monorepo for V programming language ecosystem tools and bridges. +[NOTE] +.Estate carve-out +==== +This directory is the **only** non-archive carve-out for V-lang source in +the hyperpolymath estate. Per the 2026-05-28 owner directive, Zig is the +default for APIs/FFIs and Idris2 owns ABIs everywhere else. + +The v-ecosystem is exempted in `hypatia/lib/rules/cicd_rules.ex` via the +`:vlang_detected` rule's `path_allow_prefixes`, which lists +`developer-ecosystem/v-ecosystem/` as an allowlist prefix. Any V-lang +work outside this tree (and outside the `asdf-vlang-plugin` / +`asdf-plugin-collection/plugins/vlang/` toolchain-installer trees) will +be flagged by hypatia as `cicd_rules/vlang_detected`. +==== + == Projects === v-rest (Standard)