Skip to content

Commit 7d709da

Browse files
hyperpolymathclaude
andcommitted
chore(v-lang): add MIGRATION.adoc for lol v-gateway and v-lol stubs
Both deprecated 2026-04-12 (estate-wide V-lang ban 2026-04-10). v-gateway → zig-gateway; v-lol bindings → zig-gateway FFI layer. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 0442592 commit 7d709da

2 files changed

Lines changed: 68 additions & 0 deletions

File tree

lol/api/v-gateway/MIGRATION.adoc

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
// SPDX-License-Identifier: PMPL-1.0-or-later
2+
// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
= LOL v-gateway — V-lang Deprecated (2026-04-12)
4+
:toc:
5+
6+
== Status
7+
8+
The V-lang implementation in `src/` is *deprecated* as of 2026-04-12
9+
following the estate-wide V-lang ban (2026-04-10).
10+
11+
== Migration Target: Zig
12+
13+
The canonical replacement is the Zig gateway at `../zig-gateway/`:
14+
15+
[source,bash]
16+
----
17+
# From standards/lol/api/zig-gateway/
18+
zig build
19+
./zig-out/bin/lol-gateway
20+
----
21+
22+
The Zig gateway is a three-port listener matching the V layout:
23+
24+
[cols="1,1,1"]
25+
|===
26+
| Mount | Port | V source
27+
28+
| REST | `LOL_PORT` (default 7800) | `src/main.v` (REST routes)
29+
| gRPC | `LOL_PORT+1` (default 7801) | `src/main.v` (gRPC listener)
30+
| GraphQL | `LOL_PORT+2` (default 7802) | `src/main.v` (GraphQL listener)
31+
|===
32+
33+
== Next Steps
34+
35+
. Confirm `zig-gateway` handles `/api/v1/languages`, `/api/v1/corpus`,
36+
`/api/v1/crawl`, and `/api/v1/health`.
37+
. Update `compose.yml` (if any) to replace the V container.
38+
. Once confirmed healthy, delete `src/*.v` and `v.mod`.

lol/api/v-lol/MIGRATION.adoc

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
// SPDX-License-Identifier: PMPL-1.0-or-later
2+
// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
= LOL v-lol — V-lang Deprecated (2026-04-12)
4+
:toc:
5+
6+
== Status
7+
8+
The V-lang LOL API bindings in `src/` are *deprecated* as of 2026-04-12
9+
following the estate-wide V-lang ban (2026-04-10).
10+
The source was already sidelined (see `src/SIDELINED.adoc`).
11+
12+
== Migration Target: Zig FFI
13+
14+
`v-lol` wrapped `liblol` (the LOL i18n Zig FFI library) with idiomatic V types.
15+
The canonical replacement is the Zig FFI directly at `../zig-gateway/` which
16+
links `liblol` without a V shim layer.
17+
18+
[cols="1,1"]
19+
|===
20+
| V module (deprecated) | Replacement
21+
22+
| `src/lol.v` | `../zig-gateway/src/lol_ffi.zig` (direct Zig call)
23+
| `src/types.v` | `../zig-gateway/src/types.zig`
24+
| `src/ffi.v` | `../zig-gateway/src/` (FFI inlined)
25+
|===
26+
27+
== Next Steps
28+
29+
. Confirm `zig-gateway` compiles and links `liblol` successfully.
30+
. Delete `src/*.v` and `v.mod` once zig-gateway is healthy.

0 commit comments

Comments
 (0)