Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.
Python 3dai-agentsclaude-codecomputer-graphicsgenerativeimage-to-3dprocedural-generationthreejstypescriptwebgl
docs: repoint every reference to a file that moved to the CS2 plugin
kokorolx12fd6bb60cc7
diff --git a/README.md b/README.mdindex 4150471..8a3892d 100644--- a/README.md+++ b/README.md@@ -88,7 +88,7 @@ It runs under Claude Code, Codex, or OpenCode. It is agent-agnostic: wherever th- **Detail-first analysis.** Before code generation the pipeline enumerates a `detailInventory` of identity-defining small details (gloss, bevel/rounding, screws/rivets, engraved or painted linework, contours, stains and wear). Every detail must map to a real component or material entry, and a strict-quality gate blocks generation until the inventory is complete. Taxonomy: `grimoire/intake/detail_inventory.md`.- **Maximum likeness for a specific person or character.** An opt-in projection-first path fits a parametric template to image landmarks, de-lights the photo, camera-matches the render, and projects the reference onto the mesh. A single image cannot guarantee 100 percent likeness, so the pipeline reports per-region confidence and asks for more views when it matters. Details: `grimoire/character/likeness_maximization.md`.- **Multi-view silhouette carving.** An opt-in `geometryDescriptor.visualHull` intersects at least two deterministic orthographic binary silhouettes into a bounded, welded voxel mesh. It records unseen areas as low-confidence rather than inventing hidden detail. Schema and runtime check: `grimoire/scripts.md`.-- **CS2 weapon review gates.** Knife and Glock-18 routes use family-specific component contracts. The review records exactness tier, family identity, painted-region and projection coverage, per-region confidence, approximation notes, and versioned review-scene metadata; component-coverage and map-stripped blockout gates prevent a convincing texture from standing in for real structure. See [`docs/cs2/review-gates.md`](docs/cs2/review-gates.md).+- **CS2 weapon review gates.** Knife and Glock-18 routes use family-specific component contracts. The review records exactness tier, family identity, painted-region and projection coverage, per-region confidence, approximation notes, and versioned review-scene metadata; component-coverage and map-stripped blockout gates prevent a convincing texture from standing in for real structure. Ships with the CS2 domain plugin; see its `docs/cs2/review-gates.md`.- **Resumable local workflow.** `forge/state.py` records an ordered, evidence-backed intake/pass checklist for generic, character, and CS2 profiles. `forge/next.py --state` resumes from that checklist while the existing spec, render, and review gates remain authoritative.- **Material reference pipeline.** Every visible material region can be cropped, analyzed, resolved against the versioned Three.js material registry, fitted into `ObjectSculptSpec`, rendered from controlled camera views, and accepted only after a per-region comparison gate. See [`docs/materials/README.md`](docs/materials/README.md).- **Python-assisted browser rendering.** Python may orchestrate camera batches, hashes, manifests, and deterministic diagnostics, but the target browser Three.js route remains the rendering authority. See [`grimoire/build/python_threejs_render_bridge.md`](grimoire/build/python_threejs_render_bridge.md).diff --git a/SKILL.md b/SKILL.mdindex 253535c..aa102a5 100644--- a/SKILL.md+++ b/SKILL.md@@ -227,8 +227,10 @@ Full flags: `grimoire/scripts.md`. Never let a script *score* visuals — that i10. Record the review (overall + per-layer + per-feature scores + decision):`forge/stage4_review/append_review.py object-sculpt-spec.json --pass-id <pass> --fidelity <0-1> --action <continue|refine-spec|refine-code|request-input|stop> --summary "..." --render-screenshot <shot> --comparison-image cmp.png --ai-vision-score <0-1> --layer-scores-json '{...}' --feature-reviews-json <f.json> --in-place`.For the CS2 family path, produce the versioned report first with- the CS2 plugin's `tools/cs2_review.py --manifest cs2-intake.json --metrics cs2-review-inputs.json --scene forge/tests/fixtures/knife_review_scene.json --out cs2-review.json`- and attach it with `--cs2-review-json cs2-review.json --review-scene-json forge/tests/fixtures/knife_review_scene.json`.+ the command the `cs2-review` checklist step names (the CS2 plugin's `tools/cs2_review.py`, with the+ review-scene fixture the plugin ships)+ and attach it with `--cs2-review-json cs2-review.json --review-scene-json <the plugin's+ tests/fixtures/knife_review_scene.json>`. The checklist step carries the resolved path.A failed family, painted-region, projection-coverage, critical-detail, or orbit gate blocks`continue` even when the global score passes. See the CS2 plugin's `docs/cs2/review-gates.md`.11. Sync pipeline state after manual review edits, record checklist evidence, then re-run the localdiff --git a/forge/stage2_spec/validate_sculpt_spec.py b/forge/stage2_spec/validate_sculpt_spec.pyindex 79eb5e7..a688927 100644--- a/forge/stage2_spec/validate_sculpt_spec.py+++ b/forge/stage2_spec/validate_sculpt_spec.py@@ -827,7 +827,7 @@ def validate_cs2_view_dependent_environment(spec: dict[str, Any], errors: list[sfailure, not a quality nit. The code-generated default environment always exists unlessexplicitly disabled (cs2Finish.environmentAvailable = false), so this only fires as thelast-resort guard described in design.md, never on the default image-only path.- See grimoire/build/cs2_finishes.md."""+ See the CS2 domain plugin's finish rulebook."""materials = [m for m in spec.get("materials", []) if isinstance(m, dict)]view_dependent = [m for m in materials if m.get("needsEnvironment") is True]if not view_dependent:@@ -840,7 +840,7 @@ def validate_cs2_view_dependent_environment(spec: dict[str, Any], errors: list[sf"material(s) {names} are view-dependent and need an environment map (scene.environment) ""or they render muddy, but cs2Finish.environmentAvailable is false -- enable the ""code-generated default environment or supply a user HDRI before generating "- "(see grimoire/build/cs2_finishes.md)"+ "(see the CS2 domain plugin's finish rulebook)")diff --git a/grimoire/intake/image_analysis.md b/grimoire/intake/image_analysis.mdindex 913e028..0de47b6 100644--- a/grimoire/intake/image_analysis.md+++ b/grimoire/intake/image_analysis.md@@ -115,8 +115,9 @@ this protocol IS the raw material for `new_pre_spec_assessment.py` and `build_deThis generic pass runs for every subject. When Layer 1 identifies a specialized domain, layer itsextra rules on top **without** skipping any generic layer:-- **CS2 weapon/knife/glove skins** → `grimoire/build/cs2_finishes.md` (finish style, float, paint- seed, view-dependent environment) and `grimoire/intake/cs2_texture_acquisition.md`.+- **CS2 weapon/knife/glove skins** → the CS2 plugin's `grimoire/build/cs2_finishes.md` (finish style, float, paint+ seed, view-dependent environment) and its `grimoire/intake/cs2_texture_acquisition.md`. Both ship+ with the plugin; with no CS2 plugin installed, infer the finish from the reference.- **Characters / hybrids** → `grimoire/character/reconstruction.md` (head-units, landmarks,proportion lock).diff --git a/grimoire/review/gates_reference.md b/grimoire/review/gates_reference.mdindex cea0182..1341869 100644--- a/grimoire/review/gates_reference.md+++ b/grimoire/review/gates_reference.md@@ -19,7 +19,7 @@ only the executable order and one-line summary; this file defines the mandatory`forge/stage4_review/diagnose_render_multi_angle.py` flags `degenerate-view` when an orbitedsilhouette collapses (a flat plane faking a volume). Orbit angles use reference-freeself-consistency — never scored against a reference angle the photo doesn't cover.-- **CS2 knife review contract**: `forge/stage4_review/cs2_review.py` consumes the manifest and+- **CS2 knife review contract** (ships with the CS2 domain plugin): its `tools/cs2_review.py` consumes the manifest andversioned scene fixture, then blocks wrong family identity, missing projection coverage,painted-region mismatch, critical identity-detail failure, finish/material response failure,and degenerate orbit form. It records exactness tier, hidden-region confidence, per-region@@ -28,7 +28,7 @@ only the executable order and one-line summary; this file defines the mandatorythe **Glock-18** pistol; every other family and unknown subtype must stop with`unsupported-family` or `unsupported-subtype`, and must never receive another family's componenttree as a generic fallback. Registering a family is not implementing its geometry. Authoritative- boundary and intake order: `grimoire/intake/cs2_intake_contract.md` and `SKILL.md`'s CS2 section.+ boundary and intake order: the CS2 plugin's `cs2_intake_contract.md` and `SKILL.md`'s CS2 section.- **Bounded correction loop (token-burn safety)**: `forge/stage4_review/correction_loop.py`guarantees termination (success/repeated-defect/oscillation/plateau/hard-ceiling), escalating to`request-input` — never a silent infinite burn. Hard gates route to `refine-code`; repeated defectsdiff --git a/grimoire/scripts.md b/grimoire/scripts.mdindex fcfbd3e..0df899c 100644--- a/grimoire/scripts.md+++ b/grimoire/scripts.md@@ -32,7 +32,7 @@ not targets; stop earlier on success, repeated defects, oscillation, or plateau.The pass checklist is executable in dependency order: generate, render, Tier 1, multi-angle,`orchestrate_passes.py check`, profile-specific review, AI review, then sync. The CS2 profile runs:-`stage4_review/cs2_review.py --manifest cs2-intake.json --metrics cs2-review-inputs.json --scene forge/tests/fixtures/knife_review_scene.json --out cs2-review.json`+`<cs2-plugin>/tools/cs2_review.py --manifest cs2-intake.json --metrics cs2-review-inputs.json --scene <cs2-plugin>/tests/fixtures/knife_review_scene.json --out cs2-review.json` (the `cs2-review` checklist step carries the resolved paths)The character profile requires the reconstruction/likeness contracts, landmark evidence, and anexplicit stylized-versus-projection route decision before pre-spec authoring.