Skip to content

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.md
index 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 only
place 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.md
index 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 run
directories** 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 under
a declared root, and `urls.safe_join` refuses anything that escapes that run
directory. `3dcode gallery build [--embed]` writes the same page as one file.