Skip to content

Official Codebase of 3DCodeVerse

Python

cli: `make --seed` says what it is - a run label that re-keys the plan and the reference images

gaoypengbfd0aedf43c4
diff --git a/harness/codeverse3d/cli/main.py b/harness/codeverse3d/cli/main.py
index bd456c2e..97aa9fc8 100644
--- a/harness/codeverse3d/cli/main.py
+++ b/harness/codeverse3d/cli/main.py
@@ -317,7 +317,15 @@ def make(
"(`3dcode pick <slug>` does it later)",
),
] = False,
- seed: Annotated[int, typer.Option("--seed")] = 0,
+ seed: Annotated[
+ int,
+ typer.Option(
+ "--seed",
+ help="a run label, not a sampling seed: another value re-plans (it keys the plan cache) and "
+ "re-draws the --reference images; the models, the coding agent, the judge and the builds "
+ "(always seed 0) do not read it",
+ ),
+ ] = 0,
force: Annotated[bool, typer.Option("--force", help="overwrite an existing run dir")] = False,
no_run: Annotated[
bool,
diff --git a/harness/docs/RUNBOOK.md b/harness/docs/RUNBOOK.md
index 5027c2c8..550ce109 100644
--- a/harness/docs/RUNBOOK.md
+++ b/harness/docs/RUNBOOK.md
@@ -50,7 +50,8 @@ a scene writes its baseline in its stages, so `--candidates N>1` is refused ther
profile's best-of-2 runs one), `--texture` (texture the PICKED round
after the run; see §6), `--no-pick` (package nothing: no `deliverable/`, no `selection.json` —
`3dcode pick` later), `--max-minutes`, `--dim height=0.45`, `--must`,
-`--must-not`, `--style`, `--tag`, `--seed`, `--slug`, `--runs-dir`, `--force`,
+`--must-not`, `--style`, `--tag`, `--seed` (a label: it re-keys the plan and the reference
+images, nothing else is seeded by it), `--slug`, `--runs-dir`, `--force`,
`--no-run` (workspace + spec.json only — except that `--reference` still runs its
paid grounding pass first, since the grounded spec is what it writes).