Official Codebase of 3DCodeVerse
Python
docs: Law 1 names where the wrappers live (languages/wrappers/, not languages/*/wrappers); the gallery's use is RUNBOOK's
gaoypeng2116ecf66b57
diff --git a/harness/CLAUDE.md b/harness/CLAUDE.mdindex d258b763..93a199f9 100644--- a/harness/CLAUDE.md+++ b/harness/CLAUDE.md@@ -23,7 +23,8 @@ score-vs-complexity corpus study) before changing anything.## Laws (do not break)1. Generated code is raw language — never an SDK/helper import; the harness owns- wrappers/exporters (`codeverse3d/languages/*/wrappers`, `runtime_js/`).+ wrappers/exporters (`codeverse3d/languages/wrappers/`, `languages/opengl_python/wrappers/`,+ `runtime_js/`).2. `codeverse3d/contracts/` is data-only and shared; `conventions.py` is the onlyplace that states frames/units/naming. Import, never restate.3. Deterministic gates/measurements run by the harness; VLM only for perception.diff --git a/harness/docs/ARCHITECTURE.md b/harness/docs/ARCHITECTURE.mdindex 544587f4..b901ba28 100644--- a/harness/docs/ARCHITECTURE.md+++ b/harness/docs/ARCHITECTURE.md@@ -607,8 +607,7 @@ side-car mode); the gallery is `3dcode gallery build --embed`serve` indexes `runs/` + every `eval/bench/out/*/runs`, serves the page **and the rundirectories** on 127.0.0.1 (so every link opens: sheet, renders, `src/`, `object.glb`in an orbit viewer built on the vendored three.js, `record.json`), and re-reads a-run's record per request so a battery that is still writing shows up live. A run-with no record yet is a *pending* card, a half-written one a *broken* card. Two-gates keep it safe: a URL can only name a `(battery, slug)` the scanner found under+run's record per request so a battery that is still writing shows up live (how to use it:+RUNBOOK §4). Two gates keep it safe: a URL can only name a `(battery, slug)` the scanner found undera declared root, and `urls.safe_join` refuses anything that escapes that rundirectory. `3dcode gallery build [--embed]` writes the same page as one file.