Skip to content

Commit 8ba039e

Browse files
hyperpolymathclaude
andcommitted
docs(v-ecosystem): flesh out v-rest in TRANSFER.adoc + update licence wording
v-rest entry now covers: 200/503 health semantics, query-param context endpoint, ABI proof structure identical to v-grpc, REST vs gRPC-Web distinction. Licence wording updated: PMPL-1.0-or-later is primary; MPL-2.0 is automatic legal fallback (no request needed); explicit MPL-2.0 available for package registries on request. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 4bc2775 commit 8ba039e

File tree

1 file changed

+20
-6
lines changed

1 file changed

+20
-6
lines changed

v-ecosystem/TRANSFER.adoc

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,12 @@ ecosystem-fit decision — too many parallel systems languages — not a
1919
judgement on V as a language.
2020

2121
All work listed here is offered to the V community under
22-
**PMPL-1.0-or-later** (or **MPL-2.0** if an OSI-approved licence is
23-
required). The code is functional, documented, and tested where noted.
22+
**PMPL-1.0-or-later**. PMPL-1.0-or-later is the primary stated licence;
23+
until it achieves formal legal recognition, MPL-2.0 is the automatic
24+
operative fallback — no separate request is needed. If an explicit
25+
OSI-approved licence identifier is required for your package registry,
26+
MPL-2.0 is available on request. The code is functional, documented, and
27+
tested where noted.
2428

2529
== Fully Implemented Protocol Runtimes
2630

@@ -54,11 +58,21 @@ yet connected. Protobuf binary framing not yet implemented.
5458

5559
*Repo:* https://github.com/hyperpolymath/v-rest
5660

57-
REST API server for the same Gnosis backend. Implements four endpoints:
58-
`POST /render`, `GET /context`, `GET /health`, `GET /` (API discovery).
59-
Same Idris2 ABI + Zig FFI architecture as v-grpc.
61+
Conventional REST/JSON server for the same Gnosis backend. Four endpoints:
62+
`POST /render`, `GET /context?scm=path`, `GET /health`, `GET /` (API
63+
discovery). Notable detail: `/health` returns HTTP 200 (Gnosis reachable)
64+
or HTTP 503 (Gnosis unavailable) — status-code semantics that load
65+
balancers and container health checks can act on directly.
6066

61-
*Status:* Transport complete and working. Zig FFI scaffold present.
67+
ABI layer (`src/abi/`) is identical in structure to v-grpc: same `Handle`
68+
non-null proof, `Result` round-trips, `ptrSize` dependent on `Platform`,
69+
`%default total`. Zig FFI scaffold (`ffi/zig/`) is present.
70+
71+
Main difference from v-grpc: conventional REST (GET/POST with query params
72+
and `application/json`) rather than gRPC-Web path-based dispatch.
73+
74+
*Status:* Transport complete and working. Zig FFI scaffold present but not
75+
yet connected.
6276

6377
== Monorepo: developer-ecosystem/v-ecosystem
6478

0 commit comments

Comments
 (0)