Skip to content

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.py
deleted file mode 100644
index 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_CONTRACT
diff --git a/harness/codeverse3d/languages/base.py b/harness/codeverse3d/languages/base.py
index 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) statically
lint 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__.py
index 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 RuntimeDocs
from codeverse3d.proc import run_subprocess, scrub_secrets
from 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.BLENDER
diff --git a/harness/codeverse3d/languages/cadquery/__init__.py b/harness/codeverse3d/languages/cadquery/__init__.py
index 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 RuntimeDocs
from codeverse3d.languages.blender import _fmt, finish_for, instance_centers
from codeverse3d.proc import run_subprocess, scrub_secrets
from 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.CADQUERY
diff --git a/harness/codeverse3d/languages/glsl_shader/__init__.py b/harness/codeverse3d/languages/glsl_shader/__init__.py
index 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, GateReport
from codeverse3d.contracts.common import ENTRY_FILE, Language
from codeverse3d.contracts.plan import GraphicsPlan, Plan
from codeverse3d.languages._common import MISSING_ENTRY
-from codeverse3d.languages._docs import RuntimeDocs
from codeverse3d.languages._gl_common import ( # noqa: F401 — re-exported
GlslMessage,
LineMap,
@@ -379,7 +378,7 @@ def write_skeleton(ws: Workspace, plan: Plan | None) -> list[Path]:
# ===================================================================== runtime
-class GlslShaderRuntime(RuntimeDocs):
+class GlslShaderRuntime:
language = Language.GLSL_SHADER
entry_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__.py
index 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 RuntimeDocs
from 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_PYTHON
entry_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__.py
index 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, Language
from codeverse3d.contracts.plan import AssetPlan, CameraPlan, Plan, ScenePlan, ZonePlan
from codeverse3d.conventions import to_pascal, to_snake
-from codeverse3d.languages._docs import RuntimeDocs
from 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_THREEJS
entry_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__.py
index 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, Language
from codeverse3d.contracts.plan import Plan, StaticPlan
from codeverse3d.conventions import to_pascal, to_snake
from codeverse3d.languages._common import BUILD_TIMEOUT
-from codeverse3d.languages._docs import RuntimeDocs
from 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.THREEJS
diff --git a/harness/codeverse3d/languages/urdf/__init__.py b/harness/codeverse3d/languages/urdf/__init__.py
index 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 RuntimeDocs
from codeverse3d.proc import run_subprocess
from codeverse3d.spatial.joints import (
UrdfError,
@@ -753,7 +752,7 @@ FK_TOL_M = 0.001
STAGED_OUTPUTS = ("build.json", "census.json", "meshes", "robot.urdf", "articulation.json", "object.glb")
-class UrdfBlenderRuntime(RuntimeDocs):
+class UrdfBlenderRuntime:
language = Language.URDF_BLENDER
entry_globs = (ENTRY_FILE[Language.URDF_BLENDER], "src/robot.urdf")
diff --git a/harness/codeverse3d/prompts/catalog.py b/harness/codeverse3d/prompts/catalog.py
index 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 annotations
from 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.py
index 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, Track
from codeverse3d.contracts.plan import CameraPlan, Plan
from codeverse3d.contracts.run import RunRecord
from codeverse3d.conventions import ViewPreset
-from codeverse3d.languages import get_runtime
from codeverse3d.orchestrator import BudgetGuard, RoundPolicy, RunState
from 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_hash
from 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.usage
again.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.py
index 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_text
from 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, Services
from codeverse3d.tracks.generation import GenerationTask, single_shot_model_id
from codeverse3d.tracks.planner import plan as run_planner
from 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 PlanningError
return 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 loop
diff --git a/harness/codeverse3d/tracks/planner.py b/harness/codeverse3d/tracks/planner.py
index 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_sna
from codeverse3d.models.schema_utils import parse_json_lenient
from codeverse3d.proc import sha256_file
from codeverse3d.prompts import load_text, prompt_hash, render
-from codeverse3d.tracks.common import language_contract
+from codeverse3d.prompts.catalog import language_text
from codeverse3d.tracks.prompting import constraints_text
from 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 planner
call → 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: Works
guard.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.language
budget = budget or plan_budget(spec)
return render(
@@ -976,7 +975,7 @@ def build_system_prompt(spec: Spec, plan_model: type[BaseModel], *, runtime: Any
track=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.py
index 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, StaticPlan
from codeverse3d.contracts.run import RoundRecord
from codeverse3d.conventions import LANGUAGE_FRAME, frame_doc, to_authoring_frame, to_snake
from codeverse3d.prompts import render
-from codeverse3d.prompts.catalog import prompt_dir_for
+from codeverse3d.prompts.catalog import language_prompt, language_text
from codeverse3d.tracks.common import RunContext
from codeverse3d.tracks.depth import DepthBudget, PartScope, depth_budget, interfaces_text
from 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, in
the 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 d
diff --git a/harness/codeverse3d/tracks/scene_assets.py b/harness/codeverse3d/tracks/scene_assets.py
index 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_degraded
from codeverse3d.orchestrator import BudgetExceeded
from codeverse3d.proc import fan_out, read_json_or_none, write_json_atomic, write_text_atomic
from codeverse3d.prompts import render
+from codeverse3d.prompts.catalog import language_prompt, language_text
from 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) -> As
budget=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 is
if 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.md
index 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 each
a single __init__.py (lint → skeleton → runtime, in dependency order) beside their
data (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 that
markdown into chapters so a STAGE can name the recipes it needs.
The other half of the split: codeverse3d/skills/ is what an AGENT chooses
to read (SKILL.md + references/ + a _claims file pinning its numbers to
diff --git a/harness/docs/INTERFACES.md b/harness/docs/INTERFACES.md
index e872930a..3b54d407 100644
--- a/harness/docs/INTERFACES.md
+++ b/harness/docs/INTERFACES.md
@@ -209,7 +209,11 @@ rt.language; rt.entry_globs
rt.lint(ws) -> GateReport # gate = "lint:<language>"
rt.build(ws, *, timeout_s=None, **per_runtime) -> BuildResult # Δ BuildResult.error_file is WORKSPACE-relative for
rt.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.py
index 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_text
FAKE_BLENDER = """#!/usr/bin/env python3
import 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 contract
def 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.py
index 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_text
from tests.blender_cadquery.conftest import has_cadquery
needs_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 importabl
def 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 cmd
diff --git a/harness/tests/graphics/test_track.py b/harness/tests/graphics/test_track.py
index 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.py
index 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 / model
class FakeAgent:
diff --git a/harness/tests/orchestrator_tracks/test_generation_planner_repair.py b/harness/tests/orchestrator_tracks/test_generation_planner_repair.py
index 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].text
assert 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) == 3
assert 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.py
index 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, Track
from codeverse3d.contracts.plan import ArticulatedPlan
from codeverse3d.tracks.planner import plan, plan_example
from tests.orchestrator_tracks.conftest import make_spec
-from tests.orchestrator_tracks.fakes import FakeChatModel, FakeRuntime
+from tests.orchestrator_tracks.fakes import FakeChatModel
def _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 once
model = 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-ask
answers = [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) == 2
reask = model.requests[1].messages[-1].text
assert "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) == 2
reask = model.requests[1].messages[-1].text
assert "echoes the schema" in reask and "joints[0].name" in reask and "zero axis" not in reask
diff --git a/harness/tests/orchestrator_tracks/test_planner_restart.py b/harness/tests/orchestrator_tracks/test_planner_restart.py
index 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 FakeChatModel
def _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 == 1
assert 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 answer
diff --git a/harness/tests/orchestrator_tracks/test_planner_truncation_reask.py b/harness/tests/orchestrator_tracks/test_planner_truncation_reask.py
index 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 Language
from codeverse3d.contracts.plan import StaticPlan
from codeverse3d.proc import EventLog
from codeverse3d.tracks.planner import TRUNCATION_NOTE, plan
from tests.orchestrator_tracks.conftest import make_spec
-from tests.orchestrator_tracks.fakes import FakeChatModel, FakeRuntime
+from tests.orchestrator_tracks.fakes import FakeChatModel
from 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) == 2
first, second = model.requests
assert first.thinking == "medium" and second.thinking == "off"
diff --git a/harness/tests/prompts/test_files.py b/harness/tests/prompts/test_files.py
index 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-object
languages 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_prompt
from codeverse3d.tracks.prompting import language_system_prompt
for 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(), role
diff --git a/harness/tests/scene_runtime/test_runtime.py b/harness/tests/scene_runtime/test_runtime.py
index 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 Language
from codeverse3d.languages import get_runtime
from codeverse3d.languages.base import LanguageRuntime
from codeverse3d.languages.scene_threejs import SceneThreeJsRuntime
-from codeverse3d.prompts import PROMPTS_DIR
+from codeverse3d.prompts.catalog import language_text
from 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_THREEJS
assert "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 paths
diff --git a/harness/tests/scene_runtime/test_skeleton.py b/harness/tests/scene_runtime/test_skeleton.py
index 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 Language
from 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.py
index 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 langs
diff --git a/harness/tests/threejs_render/test_skeleton.py b/harness/tests/threejs_render/test_skeleton.py
index 298fb57e..151a97aa 100644
--- a/harness/tests/threejs_render/test_skeleton.py
+++ b/harness/tests/threejs_render/test_skeleton.py
@@ -8,6 +8,7 @@ import pytest
from codeverse3d.contracts.plan import BBox, PartPlan, StaticPlan
from codeverse3d.languages.threejs import ThreeJsRuntime, write_skeleton
+from codeverse3d.prompts.catalog import language_text
from 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.py
index 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 Language
from codeverse3d.languages import get_runtime
from codeverse3d.languages.urdf import UrdfBlenderRuntime
from codeverse3d.proc import ProcResult
+from codeverse3d.prompts.catalog import language_text
from codeverse3d.workspace import Workspace
from 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.md
assert "meshes/<link>.glb" in doc and "pivot" in doc