Official Codebase of 3DCodeVerse
Python
prompts: one per-language prompt lookup — the contract, cookbook, system prompt and effects catalog were found four ways
gaoypengc463ecb9e38d
diff --git a/harness/codeverse3d/languages/_docs.py b/harness/codeverse3d/languages/_docs.pydeleted file mode 100644index ff8f48af..00000000--- a/harness/codeverse3d/languages/_docs.py+++ /dev/null@@ -1,40 +0,0 @@-"""Where a language's prompt text lives — one resolver for all seven runtimes.--Each runtime used to spell this out itself, and in three different shapes: a-``Path.is_file()`` check falling back to a packaged ``CONTRACT.md``; a-``try: load_text(...) except FileNotFoundError`` falling back to an inline string;-and urdf's variant of the second. The only thing that actually differed was the-directory name, so it is a declaration now (2026-08-28).--The packaged ``languages/<lang>/CONTRACT.md`` fallbacks went with the merge: they-were unreachable in any installed state (``pyproject`` ships ``prompts/**/*``, and-every ``contract_doc`` read ``prompts/`` first), and two of their numbers had drifted-out of agreement with ``conventions.py`` — 500 k triangles against-``MAX_TRIS_OBJECT = 600_000``, and a 120 s build budget against 300 s. A second home-for a fact is a second answer, which is what law 2 exists to prevent.-"""--from __future__ import annotations--from codeverse3d.contracts.common import Language-from codeverse3d.prompts import load_text-from codeverse3d.prompts.catalog import prompt_dir_for--#: only reachable if the wheel shipped without its prompt data-MINIMAL_CONTRACT = "Write raw code in the language's native frame; meters; named parts."---class RuntimeDocs:- """``contract_doc`` for every ``LanguageRuntime``."""-- language: Language-- @property- def prompt_dir(self) -> str:- return prompt_dir_for(self.language)-- def contract_doc(self) -> str:- try:- return load_text(f"{self.prompt_dir}/contract.md")- except FileNotFoundError:- return MINIMAL_CONTRACTdiff --git a/harness/codeverse3d/languages/base.py b/harness/codeverse3d/languages/base.pyindex 22e4f722..5e651605 100644--- a/harness/codeverse3d/languages/base.py+++ b/harness/codeverse3d/languages/base.py@@ -2,8 +2,9 @@A runtime knows how to (1) lay down starter files for a plan, (2) staticallylint agent code for known pitfalls, (3) execute it in a sandboxed subprocess-and export the canonical artifact(s), (4) describe its authoring contract to-prompts. Runtimes never import agent code into the harness process.+and export the canonical artifact(s). Its authoring contract is prompt material+(``prompts/<lang>/contract.md``, found by ``prompts.catalog.language_prompt``).+Runtimes never import agent code into the harness process."""from __future__ import annotations@@ -36,10 +37,6 @@ class LanguageRuntime(Protocol):"""Execute the code in a subprocess; export ``artifacts/object.glb`` (+extras)."""...- def contract_doc(self) -> str:- """Prompt text: the authoring contract for this language (from prompts/<lang>/)."""- ...-#: Language → (module, class). Adding a language is a row, and the import stays lazy#: (a runtime pulls in bpy / moderngl / node bindings the other six do not need).diff --git a/harness/codeverse3d/languages/blender/__init__.py b/harness/codeverse3d/languages/blender/__init__.pyindex 29fe7d34..b886daa0 100644--- a/harness/codeverse3d/languages/blender/__init__.py+++ b/harness/codeverse3d/languages/blender/__init__.py@@ -21,7 +21,6 @@ from codeverse3d.languages._ast_lint import (safe_parse,)from codeverse3d.languages._common import MISSING_ENTRY, compose_build_result, strip_blender_noise-from codeverse3d.languages._docs import RuntimeDocsfrom codeverse3d.proc import run_subprocess, scrub_secretsfrom codeverse3d.workspace import Workspace@@ -694,7 +693,7 @@ def blender_env() -> dict[str, str]:return env-class BlenderRuntime(RuntimeDocs):+class BlenderRuntime:"""LanguageRuntime for ``Language.BLENDER``."""language = Language.BLENDERdiff --git a/harness/codeverse3d/languages/cadquery/__init__.py b/harness/codeverse3d/languages/cadquery/__init__.pyindex 3c745522..08b7ba05 100644--- a/harness/codeverse3d/languages/cadquery/__init__.py+++ b/harness/codeverse3d/languages/cadquery/__init__.py@@ -22,7 +22,6 @@ from codeverse3d.languages._ast_lint import (safe_parse,)from codeverse3d.languages._common import MISSING_ENTRY, compose_build_result-from codeverse3d.languages._docs import RuntimeDocsfrom codeverse3d.languages.blender import _fmt, finish_for, instance_centersfrom codeverse3d.proc import run_subprocess, scrub_secretsfrom codeverse3d.workspace import Workspace@@ -325,7 +324,7 @@ def cadquery_env() -> dict[str, str]:return env-class CadQueryRuntime(RuntimeDocs):+class CadQueryRuntime:"""LanguageRuntime for ``Language.CADQUERY``."""language = Language.CADQUERYdiff --git a/harness/codeverse3d/languages/glsl_shader/__init__.py b/harness/codeverse3d/languages/glsl_shader/__init__.pyindex aff63044..f2ace1f5 100644--- a/harness/codeverse3d/languages/glsl_shader/__init__.py+++ b/harness/codeverse3d/languages/glsl_shader/__init__.py@@ -11,7 +11,6 @@ from codeverse3d.contracts.artifacts import BuildResult, GateFinding, GateReportfrom codeverse3d.contracts.common import ENTRY_FILE, Languagefrom codeverse3d.contracts.plan import GraphicsPlan, Planfrom codeverse3d.languages._common import MISSING_ENTRY-from codeverse3d.languages._docs import RuntimeDocsfrom codeverse3d.languages._gl_common import ( # noqa: F401 — re-exportedGlslMessage,LineMap,@@ -379,7 +378,7 @@ def write_skeleton(ws: Workspace, plan: Plan | None) -> list[Path]:# ===================================================================== runtime-class GlslShaderRuntime(RuntimeDocs):+class GlslShaderRuntime:language = Language.GLSL_SHADERentry_globs: tuple[str, ...] = (ENTRY_FILE[Language.GLSL_SHADER], COMMON, BUFFER_A)diff --git a/harness/codeverse3d/languages/opengl_python/__init__.py b/harness/codeverse3d/languages/opengl_python/__init__.pyindex 237ef143..1cdb0c0f 100644--- a/harness/codeverse3d/languages/opengl_python/__init__.py+++ b/harness/codeverse3d/languages/opengl_python/__init__.py@@ -16,7 +16,6 @@ from codeverse3d.languages._ast_lint import (safe_parse,)from codeverse3d.languages._common import MISSING_ENTRY-from codeverse3d.languages._docs import RuntimeDocsfrom codeverse3d.languages._gl_common import (finish_build,invalidate_stale_outputs,@@ -336,7 +335,7 @@ def write_skeleton(ws: Workspace, plan: Plan | None) -> list[Path]:# ===================================================================== runtime-class OpenGLPythonRuntime(RuntimeDocs):+class OpenGLPythonRuntime:language = Language.OPENGL_PYTHONentry_globs: tuple[str, ...] = (ENTRY_FILE[Language.OPENGL_PYTHON], "src/*.glsl")diff --git a/harness/codeverse3d/languages/scene_threejs/__init__.py b/harness/codeverse3d/languages/scene_threejs/__init__.pyindex d5e7ca44..e6fba5b2 100644--- a/harness/codeverse3d/languages/scene_threejs/__init__.py+++ b/harness/codeverse3d/languages/scene_threejs/__init__.py@@ -21,7 +21,6 @@ from codeverse3d.contracts.artifacts import (from codeverse3d.contracts.common import ENTRY_FILE, Languagefrom codeverse3d.contracts.plan import AssetPlan, CameraPlan, Plan, ScenePlan, ZonePlanfrom codeverse3d.conventions import to_pascal, to_snake-from codeverse3d.languages._docs import RuntimeDocsfrom codeverse3d.languages._js_lint import (ImportKind,ImportVerdict,@@ -678,7 +677,7 @@ def assemble(ws: Workspace, plan: ScenePlan | None = None, *, cameras: str = "de# ===================================================================== runtime-class SceneThreeJsRuntime(RuntimeDocs):+class SceneThreeJsRuntime:language = Language.SCENE_THREEJSentry_globs: tuple[str, ...] = (ENTRY_FILE[Language.SCENE_THREEJS], "src/zones/*.js", "src/assets/*.js", "src/env.js", "src/shaders/*.js")diff --git a/harness/codeverse3d/languages/threejs/__init__.py b/harness/codeverse3d/languages/threejs/__init__.pyindex b2fc6ba6..2233e166 100644--- a/harness/codeverse3d/languages/threejs/__init__.py+++ b/harness/codeverse3d/languages/threejs/__init__.py@@ -15,7 +15,6 @@ from codeverse3d.contracts.common import ENTRY_FILE, Languagefrom codeverse3d.contracts.plan import Plan, StaticPlanfrom codeverse3d.conventions import to_pascal, to_snakefrom codeverse3d.languages._common import BUILD_TIMEOUT-from codeverse3d.languages._docs import RuntimeDocsfrom codeverse3d.languages._js_lint import (ImportKind,ImportVerdict,@@ -338,7 +337,7 @@ BUILD_JSON = "build.json"NODE_MEM_LIMIT_GB = 8.0 # RLIMIT_AS for the export process (geometry-bomb protection)-class ThreeJsRuntime(RuntimeDocs):+class ThreeJsRuntime:"""LanguageRuntime for ``Language.THREEJS`` (raw ESM three.js, exported via node)."""language = Language.THREEJSdiff --git a/harness/codeverse3d/languages/urdf/__init__.py b/harness/codeverse3d/languages/urdf/__init__.pyindex 4ba61b05..79aabd85 100644--- a/harness/codeverse3d/languages/urdf/__init__.py+++ b/harness/codeverse3d/languages/urdf/__init__.py@@ -31,7 +31,6 @@ from codeverse3d.languages._ast_lint import (safe_parse,)from codeverse3d.languages._common import ProcResult, compose_build_result, strip_blender_noise-from codeverse3d.languages._docs import RuntimeDocsfrom codeverse3d.proc import run_subprocessfrom codeverse3d.spatial.joints import (UrdfError,@@ -753,7 +752,7 @@ FK_TOL_M = 0.001STAGED_OUTPUTS = ("build.json", "census.json", "meshes", "robot.urdf", "articulation.json", "object.glb")-class UrdfBlenderRuntime(RuntimeDocs):+class UrdfBlenderRuntime:language = Language.URDF_BLENDERentry_globs = (ENTRY_FILE[Language.URDF_BLENDER], "src/robot.urdf")diff --git a/harness/codeverse3d/prompts/catalog.py b/harness/codeverse3d/prompts/catalog.pyindex 22436cfd..780e4107 100644--- a/harness/codeverse3d/prompts/catalog.py+++ b/harness/codeverse3d/prompts/catalog.py@@ -1,10 +1,13 @@"""What prompt material exists, and how each piece reaches the model.-ONE answer to a question that had six. Before this, `<lang>/cookbook.md` was resolved in+ONE answer to a question that had six. `<lang>/cookbook.md` was once resolved in`languages/_docs.py`, `tracks/common.py`, `spatial/cookbook_tool.py`, `agents/materialize.py`and `tracks/scene_assets.py`, each with its own path arithmetic — and the``urdf_blender`` → ``prompts/urdf/`` mapping was written out three times and missing in a-fourth, which is why the articulated agent received no cookbook at all for weeks.+fourth, which is why the articulated agent received no cookbook at all for weeks. Until+2026-09-22 the contract still came through the runtime (``contract_doc``), the cookbook+through ``tracks/common``, the system prompt and the effects catalog through+``tracks/prompting``: every per-language prompt file is now found by :func:`language_prompt`.The split this file encodes (owner, 2026-08-28):@@ -21,12 +24,22 @@ A file that tries to be both is the thing this split exists to prevent.from __future__ import annotationsfrom codeverse3d.contracts.common import Language+from codeverse3d.prompts import load_text#: ``Language.URDF_BLENDER`` is ``"urdf_blender"``; its prompts live in ``prompts/urdf/``.-#: THE mapping — importing this is the only supported way to ask.PROMPT_DIRS: dict[Language, str] = {Language.URDF_BLENDER: "urdf"}-def prompt_dir_for(language: Language) -> str:- return PROMPT_DIRS.get(language, language.value)+def language_prompt(language: Language, name: str) -> str:+ """``<dir>/<name>`` under ``prompts/`` — THE path of a language's ``contract.md``,+ ``cookbook.md`` and ``system.md`` (and scene_threejs's ``effects_catalog.md`` / ``asset.md``)."""+ return f"{PROMPT_DIRS.get(language, language.value)}/{name}"++def language_text(language: Language, name: str) -> str:+ """The text of :func:`language_prompt`, or ``""`` for a file the language does not ship+ (only scene_threejs ships an effects catalog)."""+ try:+ return load_text(language_prompt(language, name))+ except FileNotFoundError:+ return ""diff --git a/harness/codeverse3d/tracks/common.py b/harness/codeverse3d/tracks/common.pyindex f37b0d4c..af426e53 100644--- a/harness/codeverse3d/tracks/common.py+++ b/harness/codeverse3d/tracks/common.py@@ -24,11 +24,9 @@ from codeverse3d.contracts.common import Language, Trackfrom codeverse3d.contracts.plan import CameraPlan, Planfrom codeverse3d.contracts.run import RunRecordfrom codeverse3d.conventions import ViewPreset-from codeverse3d.languages import get_runtimefrom codeverse3d.orchestrator import BudgetGuard, RoundPolicy, RunStatefrom codeverse3d.proc import EventLog-from codeverse3d.prompts import load_text, prompt_hash-from codeverse3d.prompts.catalog import prompt_dir_for+from codeverse3d.prompts import prompt_hashfrom codeverse3d.tracks.generation import (SINGLE_SHOT_PREFIX,GenerationResult,@@ -242,29 +240,3 @@ def generate_for(ctx: RunContext, task: GenerationTask) -> GenerationResult:again.usage = res.usage + again.usageagain.notes = f"agent session died in a 503 storm ({res.notes[:120]}) → single-shot: {again.notes}"return again---# ----------------------------------------------------------------------------- prompt helpers-def load_prompt_or(rel: str, fallback: str) -> str:- """``prompts/<rel>`` if it exists, else ``fallback``."""- try:- return load_text(rel)- except FileNotFoundError:- return fallback---def language_contract(ctx_language: Language, runtime: Any) -> str:- """The language authoring contract, as the runtime states it (``LanguageRuntime.contract_doc``- reads prompts/<dir>/contract.md). ONE lookup: a per-language prose fallback here restated- frames/units — conventions.py's job (law 2) — and was unreachable anyway."""- return (runtime or get_runtime(ctx_language)).contract_doc()---def cookbook_rel_for(language: Language) -> str:- """prompts/<dir>/cookbook.md. ``language.value`` is NOT always the directory:- urdf_blender's prompts live in prompts/urdf/, so this returned a path that does not- exist and the articulated agent was told "No cookbook is available in this session"- while its 24 063-character cookbook sat on disk. Unconditional since 2026-08-29- (the C3D_URDF_COOKBOOK A/B switch is gone): every run gets the real cookbook."""- return f"{prompt_dir_for(language)}/cookbook.md"-diff --git a/harness/codeverse3d/tracks/lifecycle.py b/harness/codeverse3d/tracks/lifecycle.pyindex 37257ff2..5f62c491 100644--- a/harness/codeverse3d/tracks/lifecycle.py+++ b/harness/codeverse3d/tracks/lifecycle.py@@ -40,15 +40,10 @@ from codeverse3d.orchestrator import (plan_refine_groups,)from codeverse3d.proc import EventLog-from codeverse3d.prompts import render+from codeverse3d.prompts import load_text, render+from codeverse3d.prompts.catalog import language_prompt, language_textfrom codeverse3d.tracks.candidates import run_best_of_n-from codeverse3d.tracks.common import (- RunContext,- Services,- cookbook_rel_for,- language_contract,- load_prompt_or,-)+from codeverse3d.tracks.common import RunContext, Servicesfrom codeverse3d.tracks.generation import GenerationTask, single_shot_model_idfrom codeverse3d.tracks.planner import plan as run_plannerfrom codeverse3d.tracks.prompting import (@@ -413,9 +408,9 @@ class BaseTrack:ctx = RunContext(spec=spec, ws=ws, events=events, settings=settings, budget=budget, runtime=runtime,services=self.services, state=state, policy=policy, track=self.track, rubric=rubric,agent_id=spec.backends.generator, agent=self._agent, model=self._model)- ctx.contract_text = language_contract(spec.language, runtime)- ctx.cookbook_rel = cookbook_rel_for(spec.language)- ctx.cookbook_text = load_prompt_or(ctx.cookbook_rel, "")+ ctx.contract_text = language_text(spec.language, "contract.md")+ ctx.cookbook_rel = language_prompt(spec.language, "cookbook.md")+ ctx.cookbook_text = language_text(spec.language, "cookbook.md")ctx.tool_cards = self.services.tool_cards(self.track.value, spec.language.value)for name, text in (("contract", ctx.contract_text), ("cookbook", ctx.cookbook_text)):ctx.record_prompt(name, text)@@ -462,7 +457,7 @@ class BaseTrack:ctx.state.save(ctx.ws)try:plan = run_planner(ctx.spec, ctx.spec.backends.planner, self.plan_model, ctx.ws, model=self._planner_model,- events=ctx.events, budget=ctx.budget, runtime=ctx.runtime)+ events=ctx.events, budget=ctx.budget)finally:self._save_budget(ctx) # charged on success AND PlanningErrorreturn plan@@ -496,7 +491,7 @@ class BaseTrack:ctx.events.emit("workspace.materialized", agent_kind=kind)def agent_contract_md(self, ctx: RunContext) -> str:- harness = load_prompt_or("system/harness_contract.md", "")+ harness = load_text("system/harness_contract.md")return (harness + "\n\n" + ctx.contract_text).strip()# ------------------------------------------------------------------ round loopdiff --git a/harness/codeverse3d/tracks/planner.py b/harness/codeverse3d/tracks/planner.pyindex 723bcac2..999245d1 100644--- a/harness/codeverse3d/tracks/planner.py+++ b/harness/codeverse3d/tracks/planner.py@@ -40,7 +40,7 @@ from codeverse3d.conventions import LANGUAGE_FRAME, frame_doc, to_pascal, to_snafrom codeverse3d.models.schema_utils import parse_json_lenientfrom codeverse3d.proc import sha256_filefrom codeverse3d.prompts import load_text, prompt_hash, render-from codeverse3d.tracks.common import language_contract+from codeverse3d.prompts.catalog import language_textfrom codeverse3d.tracks.prompting import constraints_textfrom codeverse3d.workspace import Workspace@@ -812,7 +812,7 @@ def plan_event_stats(plan_obj: Any) -> dict[str, Any]:def plan[P: BaseModel](spec: Spec, model_id: str, plan_model: type[P], ws: Workspace, *, model: Any | None = None,- events: Any | None = None, budget: Any | None = None, runtime: Any | None = None) -> P:+ events: Any | None = None, budget: Any | None = None) -> P:"""Plan and write ``ws.plan_path``: optional brief expansion → one structured plannercall → re-asks (schema, quality, a degenerate-plan restart). ``model`` may be injected (tests).Everything that differs per track is looked up from ``spec.track`` (module docstring);@@ -849,7 +849,7 @@ def plan[P: BaseModel](spec: Spec, model_id: str, plan_model: type[P], ws: Worksguard.add(usage, stage="plan")budget = plan_budget(spec, brief)unit = "passes" if spec.track is Track.GRAPHICS else "parts"- system = build_system_prompt(spec, plan_model, runtime=runtime, budget=budget)+ system = build_system_prompt(spec, plan_model, budget=budget)user = build_user_prompt(spec, brief=brief, budget=budget, unit=unit)images = [ImagePart(path=r.path, label=f"{r.role}: {r.note}".strip(": ")) for r in spec.references]messages = [ChatMessage.user(user, images=images or None)]@@ -967,8 +967,7 @@ def _echo(raw: Any, text: str) -> ChatMessage:# ----------------------------------------------------------------------------- prompts-def build_system_prompt(spec: Spec, plan_model: type[BaseModel], *, runtime: Any | None = None,- budget: PlanBudget | None = None) -> str:+def build_system_prompt(spec: Spec, plan_model: type[BaseModel], *, budget: PlanBudget | None = None) -> str:lang: Language = spec.languagebudget = budget or plan_budget(spec)return render(@@ -976,7 +975,7 @@ def build_system_prompt(spec: Spec, plan_model: type[BaseModel], *, runtime: Anytrack=spec.track.value,language=lang.value,frame_doc=frame_doc(LANGUAGE_FRAME[lang.value]),- contract=language_contract(lang, runtime),+ contract=language_text(lang, "contract.md"),example_json=json.dumps(plan_example(spec.track), indent=1),schema_fields=", ".join(plan_model.model_json_schema().get("properties", {}).keys()),target_parts=budget.target_parts,diff --git a/harness/codeverse3d/tracks/prompting.py b/harness/codeverse3d/tracks/prompting.pyindex ff31e5c6..91c13f4c 100644--- a/harness/codeverse3d/tracks/prompting.py+++ b/harness/codeverse3d/tracks/prompting.py@@ -20,7 +20,7 @@ from codeverse3d.contracts.plan import Plan, StaticPlanfrom codeverse3d.contracts.run import RoundRecordfrom codeverse3d.conventions import LANGUAGE_FRAME, frame_doc, to_authoring_frame, to_snakefrom codeverse3d.prompts import render-from codeverse3d.prompts.catalog import prompt_dir_for+from codeverse3d.prompts.catalog import language_prompt, language_textfrom codeverse3d.tracks.common import RunContextfrom codeverse3d.tracks.depth import DepthBudget, PartScope, depth_budget, interfaces_textfrom codeverse3d.tracks.generation import SINGLE_SHOT_FORMAT@@ -258,13 +258,12 @@ def language_system_prompt(language: Language, *, role: str = "", tools: bool =and three.js BufferGeometry share almost nothing but the word "3D". Per language, inthe prompt corpus, so the seven can diverge and be edited without touching code."""- d = prompt_dir_for(language)# rendered, not read raw: a system prompt that tells a SINGLE-SHOT session to call# gl_probe is instructing something it has no tools to do, and the self-check loop is# the whole point of the graphics prompt. `tools` lets the file say so itself.# (The v0 two-sentence arm of the system-prompt A/B was retired 2026-08-29: a# three-way null, eval/docs/EVAL.md.)- base = render(f"{d}/system.md", tools=tools).strip()+ base = render(language_prompt(language, "system.md"), tools=tools).strip()if not role:return base# roles COMPOSE with the language base rather than replacing it. Replacing was the@@ -274,25 +273,6 @@ def language_system_prompt(language: Language, *, role: str = "", tools: bool =return base + "\n\n" + render(f"system/role_{role}.j2", language=language.value, **vars).strip()-#: the want -> call table for the shipped effect library, per language. Only-#: scene_threejs ships one (D51); everything else gets "" and its templates render-#: byte-identically to before.-EFFECTS_CATALOG_REL: dict[Language, str] = {- Language.SCENE_THREEJS: "scene_threejs/effects_catalog.md",-}---def effects_catalog_text(language: Language) -> str:- """``prompts/<lang>/effects_catalog.md`` — the library table, or "" for a- language that ships no library."""- rel = EFFECTS_CATALOG_REL.get(language)- if not rel:- return ""- from codeverse3d.tracks.common import load_prompt_or-- return load_prompt_or(rel, "")--def base_prompt_context(ctx: RunContext, **extra: Any) -> dict[str, Any]:"""Variables every tracks/*.j2 template may use (StrictUndefined → all present)."""plan = ctx.plan@@ -331,9 +311,9 @@ def base_prompt_context(ctx: RunContext, **extra: Any) -> dict[str, Any]:# for the control arm"turn_discipline": TURN_DISCIPLINE if (fewer_turns_enabled() and not ctx.single_shot) else "",# The want -> call table for the effect library that ships in every- # scene_threejs workspace (D51). "" for every other language, so the- # templates that carry it stay byte-identical elsewhere.- "effects_catalog": effects_catalog_text(ctx.language),+ # scene_threejs workspace (D51). "" for every other language (no such file), so+ # the templates that carry it stay byte-identical elsewhere.+ "effects_catalog": language_text(ctx.language, "effects_catalog.md"),}d.update(extra)return ddiff --git a/harness/codeverse3d/tracks/scene_assets.py b/harness/codeverse3d/tracks/scene_assets.pyindex 23cedd47..9c04a0b0 100644--- a/harness/codeverse3d/tracks/scene_assets.py+++ b/harness/codeverse3d/tracks/scene_assets.py@@ -39,11 +39,10 @@ from codeverse3d.judges.rubrics import is_degradedfrom codeverse3d.orchestrator import BudgetExceededfrom codeverse3d.proc import fan_out, read_json_or_none, write_json_atomic, write_text_atomicfrom codeverse3d.prompts import render+from codeverse3d.prompts.catalog import language_prompt, language_textfrom codeverse3d.tracks.common import (RunContext,generate_for,- language_contract,- load_prompt_or,single_shot_ctx,)from codeverse3d.tracks.generation import GenerationTask, is_single_shot@@ -412,8 +411,9 @@ def build_blender_asset(ctx: RunContext, asset: AssetPlan, *, judge: bool) -> Asbudget=ctx.spec.budget, backends=ctx.spec.backends)sub_ws.write_json(sub_ws.spec_path, sub_spec)sub = replace(ctx, spec=sub_spec, ws=sub_ws, runtime=runtime, plan=None, track=Track.STATIC_OBJECT,- contract_text=language_contract(Language.BLENDER, runtime), cookbook_rel="blender/cookbook.md",- cookbook_text=load_prompt_or("blender/cookbook.md", ""),+ contract_text=language_text(Language.BLENDER, "contract.md"),+ cookbook_rel=language_prompt(Language.BLENDER, "cookbook.md"),+ cookbook_text=language_text(Language.BLENDER, "cookbook.md"),tool_cards=ctx.services.tool_cards(Track.STATIC_OBJECT.value, Language.BLENDER.value),extra={"scene_brief": ctx.spec.prompt, "scene_style": constraints_text(ctx.spec)})sub.plan = hero_plan(sub, asset)@@ -495,7 +495,7 @@ def hero_plan(sub: RunContext, asset: AssetPlan) -> StaticPlan:try:model = sub.services.chat_model(sub.spec.backends.planner)plan = run_planner(sub.spec, sub.spec.backends.planner, StaticPlan, sub.ws, model=model, events=sub.events,- budget=sub.budget, runtime=sub.runtime)+ budget=sub.budget)features = hero_features(asset.description)if len(plan.parts) <= HERO_THIN_PLAN_PARTS and len(features) > HERO_THIN_PLAN_PARTS:# a one-part answer for a prop whose sheet names several features (the windmill got@@ -505,7 +505,7 @@ def hero_plan(sub: RunContext, asset: AssetPlan) -> StaticPlan:sub.events.emit("asset.plan_thin", asset=asset.name, n_parts=len(plan.parts), features=features)spec2 = sub.spec.model_copy(update={"constraints": sub.spec.constraints.model_copy(update={"must_have": features})})plan = run_planner(spec2, spec2.backends.planner, StaticPlan, sub.ws, model=model, events=sub.events,- budget=sub.budget, runtime=sub.runtime)+ budget=sub.budget)except Exception as e: # noqa: BLE001 — PlanningError / outage: the sheet still says what the prop isif isinstance(e, BudgetExceeded):raise@@ -711,10 +711,7 @@ def _asset_system(ctx: RunContext, language: Language) -> str:asset-module prompt instead of that base."""if language is Language.SCENE_THREEJS:- return load_prompt_or(- "scene_threejs/asset.md",- "You write ONE self-contained three.js ESM asset module. Raw three.js only; no DOM; no texture loading.",- ).strip()+ return language_text(Language.SCENE_THREEJS, "asset.md").strip()return language_system_prompt(Language.BLENDER, role="asset", tools=not is_single_shot(ctx.agent_id))diff --git a/harness/docs/ARCHITECTURE.md b/harness/docs/ARCHITECTURE.mdindex 3b1df92f..e0cb2f48 100644--- a/harness/docs/ARCHITECTURE.md+++ b/harness/docs/ARCHITECTURE.md@@ -115,9 +115,10 @@ codeverse3d/blender/ cadquery/ threejs/ urdf/ scene_threejs/ glsl_shader/ opengl_python/ are eacha single __init__.py (lint → skeleton → runtime, in dependency order) beside theirdata (starter/, opengl_python/wrappers/run_gl.py; the contract text is- prompts/<lang>/contract.md, read through RuntimeDocs); wrappers/ holds the python- build wrappers (run_bpy, run_bpy_links, run_cq) and what they share- (_wrapper_common: script run + error mapping + report; _census: the Blender census)+ prompts/<lang>/contract.md, found like every per-language prompt file by+ prompts/catalog.language_prompt — a runtime holds no prompt text); wrappers/+ holds the python build wrappers (run_bpy, run_bpy_links, run_cq) and what they+ share (_wrapper_common: script run + error mapping + report; _census: the Blender census)spatial/ node.py, render.py, observe.py, tool_common.py (shared tool plumbing),render_scene.py (judge view subset, content-fitted orbit),frame_metrics.py (scene_frames gate), frame_motion.py (measured inter-frame motion),@@ -230,8 +231,11 @@ codeverse3d/opengl_python/), system/* (harness contract, single-shot envelope,role_{scope,asset,repair}.j2), texturing/*.md, tracks/*.j2.catalog.py answers "what exists and how does each piece reach the model"- — including the ONE language-id → prompts/<dir> mapping, which used to be- copied four times and missing in a fifth. sections.py splits that+ — including the ONE per-language lookup, language_prompt(language, name) /+ language_text: contract.md, cookbook.md, system.md, effects_catalog.md, asset.md+ (the prompts/<dir> mapping used to be copied four times and missing in a fifth;+ until 2026-09-22 the contract came through the runtime, the cookbook through+ tracks/common, the system prompt and the catalog through tracks/prompting). sections.py splits thatmarkdown into chapters so a STAGE can name the recipes it needs.The other half of the split: codeverse3d/skills/ is what an AGENT choosesto read (SKILL.md + references/ + a _claims file pinning its numbers todiff --git a/harness/docs/INTERFACES.md b/harness/docs/INTERFACES.mdindex e872930a..3b54d407 100644--- a/harness/docs/INTERFACES.md+++ b/harness/docs/INTERFACES.md@@ -209,7 +209,11 @@ rt.language; rt.entry_globsrt.lint(ws) -> GateReport # gate = "lint:<language>"rt.build(ws, *, timeout_s=None, **per_runtime) -> BuildResult # Δ BuildResult.error_file is WORKSPACE-relative forrt.skeleton(ws, plan) -> list[Path] # every runtime ("src/model.py", "src/parts/leg.py", "src/helpers.py")-rt.contract_doc() -> str # cookbook path: tracks/common.cookbook_rel_for (no runtime hook)+from codeverse3d.prompts.catalog import language_prompt, language_text+language_prompt(language, name) -> str # "<dir>/<name>" under prompts/ (urdf_blender → urdf/): THE per-language prompt+language_text(language, name) -> str # its text, "" for a file the language does not ship (Δ 2026-09-22: replaces+ # LanguageRuntime.contract_doc / RuntimeDocs, tracks/common.language_contract / cookbook_rel_for / load_prompt_or,+ # tracks/prompting.effects_catalog_text; planner.plan / build_system_prompt take no runtime=)BuildResult.error_type spellings (languages/_common.py): MISSING_ENTRY = "MissingEntryFile" (every runtime, threejs'export_glb.mjs included) · BUILD_TIMEOUT = "BuildTimeout" (compose_build_result, threejs, urdf)```diff --git a/harness/tests/blender_cadquery/test_blender_runtime.py b/harness/tests/blender_cadquery/test_blender_runtime.pyindex ac7c413e..8a213650 100644--- a/harness/tests/blender_cadquery/test_blender_runtime.py+++ b/harness/tests/blender_cadquery/test_blender_runtime.py@@ -19,6 +19,7 @@ from codeverse3d.languages.blender import (blender_env,lint_blender_file,)+from codeverse3d.prompts.catalog import language_textFAKE_BLENDER = """#!/usr/bin/env python3import json, os, sys@@ -44,7 +45,8 @@ def test_protocol_and_registry() -> None:assert isinstance(rt, BlenderRuntime) and isinstance(rt, LanguageRuntime)assert rt.entry_globs == ("src/model.py", "src/parts/*.py") and rt.language.value == "blender"assert rt.file_for_part("Seat Cushion") == "src/parts/seat_cushion.py" # tracks call this via getattr- assert "bpy" in rt.contract_doc() and "Z is up" in rt.contract_doc()+ contract = language_text(rt.language, "contract.md")+ assert "bpy" in contract and "Z is up" in contractdef test_missing_binary_raises(tmp_ws) -> None:diff --git a/harness/tests/blender_cadquery/test_cadquery_runtime.py b/harness/tests/blender_cadquery/test_cadquery_runtime.pyindex 6527ffac..e2d2c159 100644--- a/harness/tests/blender_cadquery/test_cadquery_runtime.py+++ b/harness/tests/blender_cadquery/test_cadquery_runtime.py@@ -21,6 +21,7 @@ from codeverse3d.languages.cadquery import (cadquery_skeleton_source,lint_cadquery_source,)+from codeverse3d.prompts.catalog import language_textfrom tests.blender_cadquery.conftest import has_cadqueryneeds_cq = pytest.mark.skipif(not has_cadquery(), reason="cadquery not importable")@@ -29,7 +30,7 @@ needs_cq = pytest.mark.skipif(not has_cadquery(), reason="cadquery not importabldef test_protocol_and_contract() -> None:rt = get_runtime("cadquery")assert isinstance(rt, CadQueryRuntime) and isinstance(rt, LanguageRuntime)- assert "cq.Assembly" in rt.contract_doc() and rt.entry_globs == ("src/model.py",)+ assert "cq.Assembly" in language_text(rt.language, "contract.md") and rt.entry_globs == ("src/model.py",)cmd = rt.build_command(__import__("codeverse3d.workspace", fromlist=["Workspace"]).Workspace("/tmp/x"), seed=1)assert cmd[0] == sys.executable and cmd[1] == str(WRAPPER) and "--seed" in cmddiff --git a/harness/tests/graphics/test_track.py b/harness/tests/graphics/test_track.pyindex 608c92bc..a0a46636 100644--- a/harness/tests/graphics/test_track.py+++ b/harness/tests/graphics/test_track.py@@ -77,9 +77,6 @@ class FakeGlRuntime:res = GlResult(ok=True, mode="shader", stage="render", renderer="fake-gl", frames=frames)return finish_build(ws, res, language="glsl_shader", census={"convention": "mainImage"})- def contract_doc(self) -> str:- return "FAKE glsl_shader authoring contract" # the runtime's contract_doc is what the prompt sees-def _writer(job, ws):body = "void mainImage(out vec4 fragColor, in vec2 fragCoord) {\n vec2 uv = fragCoord / u_resolution.xy;\n"diff --git a/harness/tests/orchestrator_tracks/fakes.py b/harness/tests/orchestrator_tracks/fakes.pyindex 4ec92bfc..b29097d9 100644--- a/harness/tests/orchestrator_tracks/fakes.py+++ b/harness/tests/orchestrator_tracks/fakes.py@@ -129,9 +129,6 @@ class FakeRuntime:return BuildResult(ok=True, language=self.language.value, glb_path=str(glb), extra_paths=extras,census={"objects": [p["name"] for p in parts]})- def contract_doc(self) -> str:- return f"FAKE CONTRACT for {self.language.value}"-# ----------------------------------------------------------------------------- agent / modelclass FakeAgent:diff --git a/harness/tests/orchestrator_tracks/test_generation_planner_repair.py b/harness/tests/orchestrator_tracks/test_generation_planner_repair.pyindex dbd32bd3..7ae2199f 100644--- a/harness/tests/orchestrator_tracks/test_generation_planner_repair.py+++ b/harness/tests/orchestrator_tracks/test_generation_planner_repair.py@@ -141,7 +141,7 @@ def test_planner_validates_retries_and_writes(tmp_ws):model = FakeChatModel(lambda req: answers.pop(0))events = EventLog(tmp_ws.events_path)budget = BudgetGuard(spec.budget)- p = plan(spec, "fake:planner", StaticPlan, tmp_ws, model=model, events=events, budget=budget, runtime=FakeRuntime(Language.THREEJS))+ p = plan(spec, "fake:planner", StaticPlan, tmp_ws, model=model, events=events, budget=budget)assert isinstance(p, StaticPlan) and p.object_name == "DiningChair" and tmp_ws.plan_path.is_file()assert len(model.requests) == 2 and "failed validation" in model.requests[1].messages[-1].textassert model.requests[0].response_schema is not None and "PascalCase" in model.requests[0].system@@ -166,7 +166,7 @@ def test_planner_validation_reasks_and_ceiling(tmp_ws):answers = [{"object_name": "X"}, {"object_name": "Y"}, _valid_plan_dict()]model = FakeChatModel(lambda req: answers.pop(0))- p = plan(make_spec(), "fake:planner", StaticPlan, tmp_ws, model=model, runtime=FakeRuntime(Language.THREEJS))+ p = plan(make_spec(), "fake:planner", StaticPlan, tmp_ws, model=model)assert p.object_name == "DiningChair" and len(model.requests) == 3assert all("failed validation" in r.messages[-1].text for r in model.requests[1:])diff --git a/harness/tests/orchestrator_tracks/test_planner_reask.py b/harness/tests/orchestrator_tracks/test_planner_reask.pyindex 7385c60e..466bf0cb 100644--- a/harness/tests/orchestrator_tracks/test_planner_reask.py+++ b/harness/tests/orchestrator_tracks/test_planner_reask.py@@ -9,7 +9,7 @@ from codeverse3d.contracts.common import Language, Trackfrom codeverse3d.contracts.plan import ArticulatedPlanfrom codeverse3d.tracks.planner import plan, plan_examplefrom tests.orchestrator_tracks.conftest import make_spec-from tests.orchestrator_tracks.fakes import FakeChatModel, FakeRuntime+from tests.orchestrator_tracks.fakes import FakeChatModeldef _good() -> dict:@@ -42,7 +42,7 @@ def test_every_moving_joint_gets_an_articulation_acceptance_item(tmp_ws):assert [a.id for a in articulation_acceptance(plan_obj, plan_obj.acceptance)] == ["art_lid"]# and the full planner path appends them exactly oncemodel = FakeChatModel(lambda req: good)- p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model, runtime=FakeRuntime(Language.URDF_BLENDER))+ p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model)ids = [a.id for a in p.acceptance]assert ids.count("art_drawer") == 1 and ids.count("art_lid") == 1@@ -57,7 +57,7 @@ def test_validation_reask_names_the_missing_parts_when_the_plan_is_thin(tmp_ws):thin["root_link"] = "NoSuchLink" # a plain validation failure to trigger the re-askanswers = [thin, _good()]model = FakeChatModel(lambda req: answers.pop(0))- p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model, runtime=FakeRuntime(Language.URDF_BLENDER))+ p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model)assert isinstance(p, ArticulatedPlan) and len(model.requests) == 2reask = model.requests[1].messages[-1].textassert "failed validation" in reask and "lists only 1 part(s)" in reask and "needs about" in reask@@ -69,7 +69,7 @@ def test_schema_echo_is_named_in_the_reask(tmp_ws):echo["joints"][0]["axis"] = [0, 0, 0]answers = [echo, _good()]model = FakeChatModel(lambda req: answers.pop(0))- p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model, runtime=FakeRuntime(Language.URDF_BLENDER))+ p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model)assert isinstance(p, ArticulatedPlan) and len(model.requests) == 2reask = model.requests[1].messages[-1].textassert "echoes the schema" in reask and "joints[0].name" in reask and "zero axis" not in reaskdiff --git a/harness/tests/orchestrator_tracks/test_planner_restart.py b/harness/tests/orchestrator_tracks/test_planner_restart.pyindex eef8c61a..3ae51780 100644--- a/harness/tests/orchestrator_tracks/test_planner_restart.py+++ b/harness/tests/orchestrator_tracks/test_planner_restart.py@@ -23,7 +23,7 @@ from codeverse3d.tracks.planner import (plan_example,)from tests.orchestrator_tracks.conftest import make_spec-from tests.orchestrator_tracks.fakes import FakeChatModel, FakeRuntime+from tests.orchestrator_tracks.fakes import FakeChatModeldef _good() -> dict:@@ -43,8 +43,7 @@ def _spec():def _run(tmp_ws, answers, events=None):model = FakeChatModel(lambda req: answers.pop(0))- p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model, events=events,- runtime=FakeRuntime(Language.URDF_BLENDER))+ p = plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model, events=events)return p, model@@ -98,8 +97,7 @@ def test_a_restart_costs_an_attempt_not_one_of_the_two_reask_slots(tmp_ws):``restarts=1`` at the validation cap (bench/data/plan_stage/restart_on.jsonl)."""model = FakeChatModel(lambda req: _degenerate())with pytest.raises(PlanningError):- plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model,- runtime=FakeRuntime(Language.URDF_BLENDER))+ plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model)assert MAX_PLAN_RESTARTS == 1assert len(model.requests) == 4 # first + restart + two re-asks# 1 = the request alone (a restart replaces the conversation), then one echo+complaint pair each@@ -130,8 +128,7 @@ def test_a_rejected_plan_is_written_where_a_dead_run_can_be_read(tmp_ws):model = FakeChatModel(lambda req: _degenerate())with pytest.raises(PlanningError):- plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model,- runtime=FakeRuntime(Language.URDF_BLENDER))+ plan(_spec(), "fake:planner", ArticulatedPlan, tmp_ws, model=model)written = sorted((tmp_ws.root / INVALID_PLAN_DIR).glob("attempt*.json"))assert len(written) == 4, [p.name for p in written] # one per rejected answerdiff --git a/harness/tests/orchestrator_tracks/test_planner_truncation_reask.py b/harness/tests/orchestrator_tracks/test_planner_truncation_reask.pyindex e757813c..de87e8e3 100644--- a/harness/tests/orchestrator_tracks/test_planner_truncation_reask.py+++ b/harness/tests/orchestrator_tracks/test_planner_truncation_reask.py@@ -2,12 +2,11 @@from __future__ import annotations-from codeverse3d.contracts.common import Languagefrom codeverse3d.contracts.plan import StaticPlanfrom codeverse3d.proc import EventLogfrom codeverse3d.tracks.planner import TRUNCATION_NOTE, planfrom tests.orchestrator_tracks.conftest import make_spec-from tests.orchestrator_tracks.fakes import FakeChatModel, FakeRuntime+from tests.orchestrator_tracks.fakes import FakeChatModelfrom tests.orchestrator_tracks.test_generation_planner_repair import _valid_plan_dict@@ -22,8 +21,7 @@ def test_truncation_retries_compact_with_low_thinking(tmp_ws):model = FakeChatModel(respond)events = EventLog(tmp_ws.events_path)- p = plan(make_spec(), "fake:planner", StaticPlan, tmp_ws, model=model, events=events,- runtime=FakeRuntime(Language.THREEJS))+ p = plan(make_spec(), "fake:planner", StaticPlan, tmp_ws, model=model, events=events)assert p.object_name == "DiningChair" and len(model.requests) == 2first, second = model.requestsassert first.thinking == "medium" and second.thinking == "off"diff --git a/harness/tests/prompts/test_files.py b/harness/tests/prompts/test_files.pyindex 4d1e9bbd..b983e651 100644--- a/harness/tests/prompts/test_files.py+++ b/harness/tests/prompts/test_files.py@@ -68,21 +68,25 @@ def test_system_prompts_cover_the_laws() -> None:# is true by construction and this assertion was checking a file nobody read.-def test_every_language_ships_a_system_prompt() -> None:- """The generator's system prompt is per LANGUAGE and lives in the prompt corpus.+def test_every_language_ships_a_system_prompt_a_contract_and_a_cookbook() -> None:+ """The generator's system prompt, the authoring contract and the cookbook are per+ LANGUAGE and live in the prompt corpus, found by ``prompts.catalog.language_prompt``.- It used to be an f-string in each track class, and the three static-object+ The system prompt used to be an f-string in each track class, and the three static-objectlanguages shared one sentence with the name swapped in — bpy mesh modelling,CadQuery's B-rep workplanes and three.js BufferGeometry, told the same thing.- A missing file here means a language silently falls back to nothing.+ A missing file here means a language silently falls back to nothing (``language_text``+ reads a file a language does not ship as "")."""from codeverse3d.contracts.common import Language- from codeverse3d.prompts.catalog import prompt_dir_for+ from codeverse3d.prompts.catalog import language_promptfrom codeverse3d.tracks.prompting import language_system_promptfor lang in Language:text = language_system_prompt(lang)assert text.strip(), f"{lang.value}: empty system prompt"- assert (PROMPTS_DIR / prompt_dir_for(lang) / "system.md").is_file(), lang.value+ for name in ("system.md", "contract.md", "cookbook.md"):+ assert (PROMPTS_DIR / language_prompt(lang, name)).is_file(), (lang.value, name)+ assert language_prompt(Language.URDF_BLENDER, "cookbook.md") == "urdf/cookbook.md"for role in ("scope", "repair"):assert (PROMPTS_DIR / "system" / f"role_{role}.j2").is_file(), rolediff --git a/harness/tests/scene_runtime/test_runtime.py b/harness/tests/scene_runtime/test_runtime.pyindex 06801d69..36845f67 100644--- a/harness/tests/scene_runtime/test_runtime.py+++ b/harness/tests/scene_runtime/test_runtime.py@@ -10,7 +10,7 @@ from codeverse3d.contracts.common import Languagefrom codeverse3d.languages import get_runtimefrom codeverse3d.languages.base import LanguageRuntimefrom codeverse3d.languages.scene_threejs import SceneThreeJsRuntime-from codeverse3d.prompts import PROMPTS_DIR+from codeverse3d.prompts.catalog import language_textfrom tests.scene_runtime.conftest import needs_browser@@ -20,9 +20,9 @@ def test_runtime_registered_conforms_and_writes_skeleton(ws):assert isinstance(rt, LanguageRuntime)assert rt.language == Language.SCENE_THREEJSassert "src/scene.js" in rt.entry_globs and "src/zones/*.js" in rt.entry_globs- doc = rt.contract_doc()+ doc = language_text(rt.language, "contract.md")assert "createScene" in doc and "update(t, dt)" in doc- assert "`#include <...>` alone on its line" in (PROMPTS_DIR / rt.prompt_dir / "glsl_cookbook.md").read_text()+ assert "`#include <...>` alone on its line" in language_text(rt.language, "glsl_cookbook.md")paths = rt.skeleton(ws, None)assert (ws.src / "scene.js") in pathsdiff --git a/harness/tests/scene_runtime/test_skeleton.py b/harness/tests/scene_runtime/test_skeleton.pyindex 2debe91c..57e74f2a 100644--- a/harness/tests/scene_runtime/test_skeleton.py+++ b/harness/tests/scene_runtime/test_skeleton.py@@ -131,12 +131,12 @@ def test_the_effects_catalog_reaches_the_scene_prompts_and_only_those():asset session inside a scene run must not be told to import three.js modules."""from codeverse3d.contracts.common import Languagefrom codeverse3d.prompts import PROMPTS_DIR- from codeverse3d.tracks.prompting import effects_catalog_text+ from codeverse3d.prompts.catalog import language_text- text = effects_catalog_text(Language.SCENE_THREEJS)+ text = language_text(Language.SCENE_THREEJS, "effects_catalog.md")assert "makeGrass" in text and "makeCanopy" in text and "lib/shader.js" in text- assert effects_catalog_text(Language.BLENDER) == ""- assert effects_catalog_text(Language.GLSL_SHADER) == ""+ assert language_text(Language.BLENDER, "effects_catalog.md") == ""+ assert language_text(Language.GLSL_SHADER, "effects_catalog.md") == ""tpl = PROMPTS_DIR / "tracks"for name in ("scene_env.j2", "scene_zone.j2", "scene_refine.j2"):diff --git a/harness/tests/spatial_tools/test_tools.py b/harness/tests/spatial_tools/test_tools.pyindex 8ee36f24..7ecf917f 100644--- a/harness/tests/spatial_tools/test_tools.py+++ b/harness/tests/spatial_tools/test_tools.py@@ -124,9 +124,6 @@ class _FakeRuntime:ws.write_json(ws.artifacts / "build.json", res)return res- def contract_doc(self):- return "# Fake contract\n\n## Export\nthe harness exports.\n"-def _patch_runtime(monkeypatch: pytest.MonkeyPatch, rt: _FakeRuntime) -> None:import codeverse3d.languages as langsdiff --git a/harness/tests/threejs_render/test_skeleton.py b/harness/tests/threejs_render/test_skeleton.pyindex 298fb57e..151a97aa 100644--- a/harness/tests/threejs_render/test_skeleton.py+++ b/harness/tests/threejs_render/test_skeleton.py@@ -8,6 +8,7 @@ import pytestfrom codeverse3d.contracts.plan import BBox, PartPlan, StaticPlanfrom codeverse3d.languages.threejs import ThreeJsRuntime, write_skeleton+from codeverse3d.prompts.catalog import language_textfrom codeverse3d.workspace import Workspace@@ -51,7 +52,7 @@ def test_runtime_protocol_surface():rt = ThreeJsRuntime()assert rt.language.value == "threejs"assert rt.entry_globs == ("src/object.js", "src/parts/*.js")- doc = rt.contract_doc()+ doc = language_text(rt.language, "contract.md") # the contract is prompt material (prompts/catalog)assert "build" in doc and "three" in doc.lower()diff --git a/harness/tests/urdf_joints/test_runtime_offline.py b/harness/tests/urdf_joints/test_runtime_offline.pyindex 6caed13f..bfb2a18b 100644--- a/harness/tests/urdf_joints/test_runtime_offline.py+++ b/harness/tests/urdf_joints/test_runtime_offline.py@@ -12,6 +12,7 @@ from codeverse3d.contracts.common import Languagefrom codeverse3d.languages import get_runtimefrom codeverse3d.languages.urdf import UrdfBlenderRuntimefrom codeverse3d.proc import ProcResult+from codeverse3d.prompts.catalog import language_textfrom codeverse3d.workspace import Workspacefrom tests.urdf_joints.conftest import box_glb@@ -62,7 +63,7 @@ def _two_link(plan):def test_registry_and_contract():rt = get_runtime(Language.URDF_BLENDER)assert isinstance(rt, UrdfBlenderRuntime) and rt.entry_globs == ("src/model.py", "src/robot.urdf")- doc = rt.contract_doc()+ doc = language_text(rt.language, "contract.md") # prompts/urdf/contract.mdassert "meshes/<link>.glb" in doc and "pivot" in doc