Official Codebase of 3DCodeVerse
Python
core: what the 2026-08-28 merges left behind, and four seams with no caller
gaoypengb578d5c6f46d
diff --git a/harness/codeverse/agents/backends.py b/harness/codeverse/agents/backends.pyindex 68dbbeb9..106f3fde 100644--- a/harness/codeverse/agents/backends.py+++ b/harness/codeverse/agents/backends.py@@ -618,7 +618,6 @@ class CodexAgent:# ===================================================================== antigravity# (merged from codeverse/agents/antigravity.py, 2026-08-28)-log = logging.getLogger(__name__)#: reasoning efforts agy exposes for the models that have themEFFORTS = ("low", "medium", "high")diff --git a/harness/codeverse/judges/vlm_judge.py b/harness/codeverse/judges/vlm_judge.pyindex e9c68d51..888c08df 100644--- a/harness/codeverse/judges/vlm_judge.py+++ b/harness/codeverse/judges/vlm_judge.py@@ -241,7 +241,6 @@ class VlmJudge:# ===================================================================== reference# (merged from codeverse/judges/reference.py, 2026-08-28)-log = logging.getLogger(__name__)SilhouetteFn = Callable[[str, str], dict[str, Any]]diff --git a/harness/codeverse/models/gemini.py b/harness/codeverse/models/gemini.pyindex aa014ef9..1740d3e3 100644--- a/harness/codeverse/models/gemini.py+++ b/harness/codeverse/models/gemini.py@@ -15,7 +15,7 @@ import threadingimport timefrom collections.abc import Callable, Iterable, Sequencefrom pathlib import Path-from typing import Any, Protocol, runtime_checkable+from typing import Anyimport httpxfrom google import genai@@ -744,7 +744,6 @@ class GeminiModel:# ===================================================================== gemini_image# (merged from codeverse/models/gemini_image.py, 2026-08-28)-log = logging.getLogger(__name__)DEFAULT_IMAGE_MODEL = "gemini-3.1-flash-image"FALLBACK_IMAGE_MODEL = "gemini-2.5-flash-image"@@ -759,36 +758,6 @@ IMAGE_USD: dict[str, float] = {_IMAGE_SIZE_TOKEN: dict[int, str] = {512: "1K", 1024: "1K", 2048: "2K", 4096: "4K"}-@runtime_checkable-class ImageModel(Protocol):- """Text-to-image backend. Implementations must be thread-safe."""-- model: str-- @property- def id(self) -> str: ...-- def generate(- self,- prompt: str,- *,- size: int = 1024,- n: int = 1,- seed: int | None = None,- reference_images: Sequence[Image.Image | Path | str] = (),- ) -> list[Image.Image]: ...-- def generate_with_usage(- self,- prompt: str,- *,- size: int = 1024,- n: int = 1,- seed: int | None = None,- reference_images: Sequence[Image.Image | Path | str] = (),- ) -> tuple[list[Image.Image], Usage]: ...--def image_cost(model: str, usage: Usage, n_images: int) -> float:"""Token-priced cost floored by the per-image price (approximate)."""token_cost = estimate_cost("gemini", model, usage)diff --git a/harness/codeverse/models/retry.py b/harness/codeverse/models/retry.pyindex ef5efca8..58075639 100644--- a/harness/codeverse/models/retry.py+++ b/harness/codeverse/models/retry.py@@ -34,7 +34,7 @@ from collections.abc import Callable, Sequencefrom concurrent.futures import Future, ThreadPoolExecutor, as_completedfrom dataclasses import dataclass, fieldfrom functools import partial-from typing import TYPE_CHECKING, Any, Literal, TypeVar+from typing import TYPE_CHECKING, Any, Literalfrom codeverse.contracts.chat import ChatRequest, ImagePart, TextPart, ToolResultPart@@ -126,7 +126,6 @@ class _KeyState:n_dead: int = 0n_acquired: int = 0tokens_used: int = 0- last_used: float = 0.0health_ts: float = 0.0def recover(self, now: float, rate: float = 0.01) -> None:@@ -272,7 +271,6 @@ class KeyPool:if chosen.tpm is not None and tokens_hint > 0:chosen.tpm.try_take(float(tokens_hint), now)chosen.n_acquired += 1- chosen.last_used = nowself._in_flight += 1self._peak_in_flight = max(self._peak_in_flight, self._in_flight)return chosen.key@@ -587,11 +585,9 @@ DEFAULT_HEDGE = 2if TYPE_CHECKING: # pragma: no coverfrom codeverse.models.base import ModelError- from codeverse.models.retry import KeyPool, Outcome, StormGatelog = logging.getLogger(__name__)-T = TypeVar("T")OnRetry = Callable[[int, BaseException, float], None]diff --git a/harness/codeverse/orchestrator.py b/harness/codeverse/orchestrator.pyindex cb3aead4..715aa593 100644--- a/harness/codeverse/orchestrator.py+++ b/harness/codeverse/orchestrator.py@@ -115,7 +115,6 @@ class StateCorrupt(RuntimeError):# ===================================================================== runner# (merged from codeverse/orchestrator/runner.py, 2026-08-28)-log = logging.getLogger(__name__)T = TypeVar("T")@@ -219,7 +218,6 @@ def _revive(data: dict[str, Any], model: type[BaseModel] | None, list_of: type[B# ===================================================================== refine_tasks# (merged from codeverse/orchestrator/refine_tasks.py, 2026-08-28)-log = logging.getLogger(__name__)class RefineTask(BaseModel):@@ -801,12 +799,8 @@ def _build_failed(r: RoundRecord) -> bool:return r.build is not None and not r.build.ok-# ----------------------------------------------------------------------------- refine tasks--# ===================================================================== budget# (merged from codeverse/orchestrator/budget.py, 2026-08-28)-log = logging.getLogger(__name__)#: stage label used when a caller does not say where the money wentOTHER_STAGE = "other"diff --git a/harness/codeverse/proc.py b/harness/codeverse/proc.pyindex 94826457..0a380213 100644--- a/harness/codeverse/proc.py+++ b/harness/codeverse/proc.py@@ -653,7 +653,6 @@ def exclusive(run_root: Path | str, *, what: str = "", action: str = "enter") -># ===================================================================== fanout# (merged from codeverse/fanout.py, 2026-08-28 — same stdlib-leaf layer as proc)-log = logging.getLogger(__name__)T = TypeVar("T")R = TypeVar("R")diff --git a/harness/codeverse/reference.py b/harness/codeverse/reference.pyindex b172b23a..e868ee2e 100644--- a/harness/codeverse/reference.py+++ b/harness/codeverse/reference.py@@ -386,7 +386,6 @@ Rules:# ===================================================================== cache# (merged from codeverse/reference/cache.py, 2026-08-28)-log = logging.getLogger(__name__)CACHE_SUBDIR = "references"@@ -445,7 +444,6 @@ def image_dir(key: str, *, cache_dir: Path | None = None) -> Path:# ===================================================================== proportions# (merged from codeverse/reference/proportions.py, 2026-08-28)-log = logging.getLogger(__name__)#: relative aspect disagreement above which the picture's proportions are not a targetASPECT_TOL = 0.25@@ -527,7 +525,6 @@ def conflict_note(info: dict[str, Any]) -> str:# ===================================================================== gate# (merged from codeverse/reference/gate.py, 2026-08-28)-log = logging.getLogger(__name__)class GateAnswer(BaseModel):@@ -658,7 +655,6 @@ def attach(spec: Spec, refset: ReferenceSet) -> tuple[Spec, str]:# ===================================================================== synth# (merged from codeverse/reference/synth.py, 2026-08-28)-log = logging.getLogger(__name__)MAX_VIEWS = len(VIEW_ORDER)DEFAULT_SIZE = 1024@@ -822,7 +818,6 @@ def _publish(rs: ReferenceSet, out_dir: Path | None) -> ReferenceSet:# ===================================================================== mismatch# (merged from codeverse/reference/mismatch.py, 2026-08-28)-log = logging.getLogger(__name__)MAX_MISMATCHES = 6#: how many mismatches become refine tasks@@ -933,7 +928,6 @@ def refine_tasks(diff: ReferenceDiff, *, top: int = TOP_TASKS) -> list[Any]:# ===================================================================== run# (merged from codeverse/reference/run.py, 2026-08-28)-log = logging.getLogger(__name__)ARTIFACT_SUBDIR = "reference"diff --git a/harness/codeverse/spatial/tools.py b/harness/codeverse/spatial/tools.pyindex 344e314f..885386ef 100644--- a/harness/codeverse/spatial/tools.py+++ b/harness/codeverse/spatial/tools.py@@ -59,8 +59,6 @@ from codeverse.spatial.tool_common import (tool_out_dir,)-_STDERR_TAIL_LINES = 30-# --------------------------------------------------------------------------- builddef _measure_after_build(ctx: ToolContext, br: BuildResult) -> tuple[Measurement | None, str]:diff --git a/harness/codeverse/texturing/apply.py b/harness/codeverse/texturing/apply.pyindex 3bdbd950..b0eb548e 100644--- a/harness/codeverse/texturing/apply.py+++ b/harness/codeverse/texturing/apply.py@@ -508,7 +508,6 @@ def textured_summary(glb: Path | str) -> dict[str, int]:# ===================================================================== normalise# (merged from codeverse/texturing/normalise.py, 2026-08-28)-log = logging.getLogger(__name__)class MaterialChange(BaseModel):diff --git a/harness/codeverse/texturing/generate.py b/harness/codeverse/texturing/generate.pyindex 624a439a..e0816692 100644--- a/harness/codeverse/texturing/generate.py+++ b/harness/codeverse/texturing/generate.py@@ -336,7 +336,6 @@ def generate_textures(# ===================================================================== gate# (merged from codeverse/texturing/gate.py, 2026-08-28)-log = logging.getLogger(__name__)MIN_OVERALL_DELTA = -0.01MIN_MATERIALS_DELTA = 0.0diff --git a/harness/codeverse/texturing/plan.py b/harness/codeverse/texturing/plan.pyindex b1234eb4..29b72736 100644--- a/harness/codeverse/texturing/plan.py+++ b/harness/codeverse/texturing/plan.py@@ -346,7 +346,6 @@ def plan_table(tp: TexturePlan) -> str:# ===================================================================== scene_pack# (merged from codeverse/texturing/scene_pack.py, 2026-08-28)-log = logging.getLogger(__name__)PACK_TEMPLATE = "texturing/scene_pack.md"DEFAULT_URL_PREFIX = "/public/textures"diff --git a/harness/codeverse/tracks/__init__.py b/harness/codeverse/tracks/__init__.pyindex 7cceec7c..09160eea 100644--- a/harness/codeverse/tracks/__init__.py+++ b/harness/codeverse/tracks/__init__.py@@ -10,7 +10,6 @@ from __future__ import annotationsfrom typing import Any, Protocolfrom codeverse.contracts.common import Track-from codeverse.contracts.plan import Planfrom codeverse.contracts.run import RunRecordfrom codeverse.contracts.spec import Specfrom codeverse.workspace import Workspace@@ -20,10 +19,6 @@ class TrackPipeline(Protocol):track: Trackrubric: str # judges/rubrics/<rubric>.yaml- def plan(self, spec: Spec, ws: Workspace) -> Plan:- """Planner model call(s) → validated Plan (re-asked on validation errors)."""- ...-def run(self, spec: Spec, ws: Workspace, *, resume: bool = False) -> RunRecord:"""Full pipeline: plan → baseline → rounds → finalise. Must be resumable."""...diff --git a/harness/codeverse/tracks/common.py b/harness/codeverse/tracks/common.pyindex 8e05bc72..b04676eb 100644--- a/harness/codeverse/tracks/common.py+++ b/harness/codeverse/tracks/common.py@@ -117,9 +117,6 @@ class Services:return rendersreturn fn(renders, max_n=max_n)- def contact_sheet(self, images: list[tuple[str, Path]], out: Path) -> Path:- return _import("codeverse.spatial.sheet", "contact_sheet")(images, out)-def silhouette(self, render_png: Path | str, reference_png: Path | str) -> dict[str, Any]:"""Outline IoU of a render vs a reference image (``{iou, reliable, ...}``)."""return _import("codeverse.spatial.silhouette", "compare_silhouette")(render_png, reference_png)diff --git a/harness/codeverse/tracks/lifecycle.py b/harness/codeverse/tracks/lifecycle.pyindex f4081c69..5cf1b868 100644--- a/harness/codeverse/tracks/lifecycle.py+++ b/harness/codeverse/tracks/lifecycle.py@@ -338,13 +338,6 @@ class BaseTrack:kind="rebuild", temperature=0.7, thinking="high")# ------------------------------------------------------------------ public API- def plan(self, spec: Spec, ws: Workspace) -> Plan:- ws.create()- events = EventLog(ws.events_path)- runtime = self._runtime or self.services.runtime(spec.language)- return run_planner(spec, spec.backends.planner, self.plan_model, ws, model=self._planner_model,- events=events, runtime=runtime, **self._plan_kwargs(spec))-def run(self, spec: Spec, ws: Workspace, *, resume: bool = False, force: bool = False) -> RunRecord:ws.create()if not ws.spec_path.is_file() or not resume:diff --git a/harness/codeverse/tracks/steps.py b/harness/codeverse/tracks/steps.pyindex 7891ff24..cada450a 100644--- a/harness/codeverse/tracks/steps.py+++ b/harness/codeverse/tracks/steps.py@@ -64,11 +64,6 @@ def round_record_path(ctx: RunContext, index: int) -> Path:return ctx.ws.root / "rounds" / f"r{index:02d}.json"-def load_round_records(ctx: RunContext) -> list[RoundRecord]:- """Rounds persisted so far (sorted by index, contiguous prefix only)."""- return load_round_journal(ctx.ws)--def load_round_journal(ws: Workspace) -> list[RoundRecord]:"""The on-disk round journal: ``rounds/r*.json`` sorted, contiguous prefix only.