Skip to content

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.py
index 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 them
EFFORTS = ("low", "medium", "high")
diff --git a/harness/codeverse/judges/vlm_judge.py b/harness/codeverse/judges/vlm_judge.py
index 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.py
index aa014ef9..1740d3e3 100644
--- a/harness/codeverse/models/gemini.py
+++ b/harness/codeverse/models/gemini.py
@@ -15,7 +15,7 @@ import threading
import time
from collections.abc import Callable, Iterable, Sequence
from pathlib import Path
-from typing import Any, Protocol, runtime_checkable
+from typing import Any
import httpx
from 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.py
index ef5efca8..58075639 100644
--- a/harness/codeverse/models/retry.py
+++ b/harness/codeverse/models/retry.py
@@ -34,7 +34,7 @@ from collections.abc import Callable, Sequence
from concurrent.futures import Future, ThreadPoolExecutor, as_completed
from dataclasses import dataclass, field
from functools import partial
-from typing import TYPE_CHECKING, Any, Literal, TypeVar
+from typing import TYPE_CHECKING, Any, Literal
from codeverse.contracts.chat import ChatRequest, ImagePart, TextPart, ToolResultPart
@@ -126,7 +126,6 @@ class _KeyState:
n_dead: int = 0
n_acquired: int = 0
tokens_used: int = 0
- last_used: float = 0.0
health_ts: float = 0.0
def 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 = now
self._in_flight += 1
self._peak_in_flight = max(self._peak_in_flight, self._in_flight)
return chosen.key
@@ -587,11 +585,9 @@ DEFAULT_HEDGE = 2
if TYPE_CHECKING: # pragma: no cover
from codeverse.models.base import ModelError
- from codeverse.models.retry import KeyPool, Outcome, StormGate
log = logging.getLogger(__name__)
-T = TypeVar("T")
OnRetry = Callable[[int, BaseException, float], None]
diff --git a/harness/codeverse/orchestrator.py b/harness/codeverse/orchestrator.py
index 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 went
OTHER_STAGE = "other"
diff --git a/harness/codeverse/proc.py b/harness/codeverse/proc.py
index 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.py
index 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 target
ASPECT_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.py
index 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
-
# --------------------------------------------------------------------------- build
def _measure_after_build(ctx: ToolContext, br: BuildResult) -> tuple[Measurement | None, str]:
diff --git a/harness/codeverse/texturing/apply.py b/harness/codeverse/texturing/apply.py
index 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.py
index 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.01
MIN_MATERIALS_DELTA = 0.0
diff --git a/harness/codeverse/texturing/plan.py b/harness/codeverse/texturing/plan.py
index 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__.py
index 7cceec7c..09160eea 100644
--- a/harness/codeverse/tracks/__init__.py
+++ b/harness/codeverse/tracks/__init__.py
@@ -10,7 +10,6 @@ from __future__ import annotations
from typing import Any, Protocol
from codeverse.contracts.common import Track
-from codeverse.contracts.plan import Plan
from codeverse.contracts.run import RunRecord
from codeverse.contracts.spec import Spec
from codeverse.workspace import Workspace
@@ -20,10 +19,6 @@ class TrackPipeline(Protocol):
track: Track
rubric: 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.py
index 8e05bc72..b04676eb 100644
--- a/harness/codeverse/tracks/common.py
+++ b/harness/codeverse/tracks/common.py
@@ -117,9 +117,6 @@ class Services:
return renders
return 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.py
index 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.py
index 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.