Skip to content

Commit 07ee72f

Browse files
docs(v-ecosystem): document estate-wide V-lang carve-out (#92)
## Summary Estate-wide V-lang→Zig remediation companion. The v-ecosystem subtree is the only non-archive V-lang location remaining in the estate. This PR adds a NOTE banner to \`v-ecosystem/README.adoc\` cross-referencing the enforcement mechanism: hypatia's \`cicd_rules/vlang_detected\` rule allowlists this path via \`path_allow_prefixes\`. ## Test plan - [ ] Banner renders correctly in AsciiDoc - [ ] Hypatia rule allowlist already includes \`developer-ecosystem/v-ecosystem/\` 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 268b46c commit 07ee72f

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

v-ecosystem/README.adoc

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,21 @@ Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
66

77
Monorepo for V programming language ecosystem tools and bridges.
88

9+
[NOTE]
10+
.Estate carve-out
11+
====
12+
This directory is the **only** non-archive carve-out for V-lang source in
13+
the hyperpolymath estate. Per the 2026-05-28 owner directive, Zig is the
14+
default for APIs/FFIs and Idris2 owns ABIs everywhere else.
15+
16+
The v-ecosystem is exempted in `hypatia/lib/rules/cicd_rules.ex` via the
17+
`:vlang_detected` rule's `path_allow_prefixes`, which lists
18+
`developer-ecosystem/v-ecosystem/` as an allowlist prefix. Any V-lang
19+
work outside this tree (and outside the `asdf-vlang-plugin` /
20+
`asdf-plugin-collection/plugins/vlang/` toolchain-installer trees) will
21+
be flagged by hypatia as `cicd_rules/vlang_detected`.
22+
====
23+
924
== Projects
1025

1126
=== v-rest (Standard)

0 commit comments

Comments
 (0)