Skip to content

Commit fba0013

Browse files
hyperpolymathclaude
andcommitted
docs(explainme): improve completeness per README-EXPLAINME-STANDARD
Replace two-sentence prose dogfooding section with a proper 5-row table covering Idris2 ABI, cartridge architecture, PanLL ReScript, panic-attack security gate, and Deno runtime — each with cross-account usage context. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent bd84259 commit fba0013

1 file changed

Lines changed: 23 additions & 2 deletions

File tree

EXPLAINME.adoc

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,30 @@ This is the Model-Controller-Processor pattern: cartridges are pluggable service
3232

3333
== Dogfooded Across The Account
3434

35-
Uses the hyperpolymath ABI/FFI standard (Idris2 + Zig) for cartridge FFI bridges. Critical path: Elixir server ↔ Idris2 ABI definitions ↔ Zig FFI ↔ C system libraries.
35+
[cols="1,2,2", options="header"]
36+
|===
37+
| Technology / Pattern | Role in boj-server | Also Used In
38+
39+
| *Idris2 ABI + Zig FFI standard*
40+
| `src/abi/Boj/` — Idris2 ABI definitions (Protocol, Domain, Catalogue, Safety); Zig FFI layer for cartridge C bridges
41+
| gossamer, burble, ephapax, hypatia, verisimdb, typed-wasm — universal ABI/FFI pattern across the estate
42+
43+
| *Pluggable cartridge architecture*
44+
| 96 cartridge directories (`cartridges/*/`), each with `abi/`, `ffi/`, `adapter/` structure; auto-discovered at startup via manifest scan
45+
| echidna (prover orchestration as cartridges), hypatia (rule composition), gitbot-fleet (bot cartridges per service)
3646

37-
Cartridge pattern is reused in echidna (prover orchestration), gossamer (window management), and hypatia (rule composition).
47+
| *PanLL ReScript workspace layer*
48+
| `panll/` — ReScript/TEA panel framework, autowiring constraint solver, 108 panels for UI
49+
| idaptik (game UI panels), gossamer-powered SPAs, PanLL monorepo panels estate-wide
50+
51+
| *panic-attack security gate*
52+
| Pre-commit `panic-attack assail` enforces PA001-PA025 across all 96 cartridges; security module (`lib/security.js`) tests cover injection, unicode bypass, SSRF
53+
| Every RSR repo in the estate; panicbot wraps it in CI
54+
55+
| *Deno runtime*
56+
| MCP bridge (`mcp-bridge/`) uses Deno-compatible patterns; cartridge test harness (`tests/*.ts`) runs under Deno
57+
| nextgen-languages (Deno test runner), standards (Deno axel-protocol tests), 0-ai-gatekeeper-protocol (Deno 36 tests)
58+
|===
3859

3960
== File Map
4061

0 commit comments

Comments
 (0)