Skip to content

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

feat: update changelog and roadmap

kokorolx396bd1755a15
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 35790af..28acbdd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,54 @@ All notable changes to **img2threejs** are documented here.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.4.1] — 2026-07-26
+
+The hardening update for the CS2 reconstruction pipeline: explicit component coverage, a pistol
+assembly contract, and review evidence that distinguishes real structure from a convincing texture.
+
+### Added
+- **Assembly coverage gate** — `stage4_review/check_part_coverage.py` verifies that every specified
+ component is built, prevents multiple specified components from collapsing into one mesh, and
+ reports unowned meshes and inventory details that never reached the spec.
+- **Glock-18 adapter** — the CS2 route now supports a dedicated `pistol` / `glock-18` component tree
+ with separate slide, frame, magazine, trigger-guard, control, barrel, and internal-mechanism
+ contracts; it does not reuse the knife topology.
+- **Structure-first guidance** — documented rules for named, explodable and selectable parts, plus
+ correct layout scaling for exploded views in `SKILL.md` and
+ `grimoire/build/geometry_patterns.md`.
+
+### Changed
+- **Strict review evidence** — the pipeline requires map-stripped blockout evidence, ordered pass
+ credit, and thickness- and long-axis viewpoints before a visual pass can continue.
+- **Geometry-integrity checks** — Tier 1 now surfaces open separate geometry, insufficient seams,
+ constant blade grinds, and missing distal taper so projection cannot hide structural defects.
+
+## [1.4.0] — 2026-07-25
+
+**Theme: Weapon Pipeline.** Image-matched CS2 hard-surface reconstruction: evidence-backed identity,
+projection-first finish matching, family-specific geometry, and gate-driven review.
+
+### Added
+- **CS2 intake and provenance contract** — reference admission, technical probing, identity routing,
+ metadata lookup, VPK/texture discovery, and an atomic `cs2-intake.json` hand-off that preserves
+ uncertainty instead of guessing.
+- **CS2 knowledge base and local search** — bilingual BM25 search profiles, curated vocabulary and
+ anatomy references, plus provenance-aware result handling for specification work.
+- **Family-specific reconstruction** — knife adapters, supported subtype validation, component-tree
+ contracts, projected-texture baking, and a strict-quality route for CS2 assets.
+- **Evidence-backed CS2 review** — `cs2_review.py`, geometry-integrity measurements, fixed and orbit
+ review views, family/finish/projection/critical-detail gates, and versioned review-scene metadata.
+- **Reference preview and prompt assets** — a browser smoke-tested CS2 knife preview, reference
+ fixture, and focused knife, pistol, and technical-analysis skill prompts.
+
+### Changed
+- **Projection-first finish workflow** — de-lit reference crops are the default path for matching
+ skin patterns, decals, and painted surfaces; procedural finishes remain an explicitly disclosed
+ fallback.
+- **Divine Eye calibration** — scale and aspect signals are live, and the reconstruction rescue path
+ now requires objectness, soft-fidelity, and proportion evidence rather than accepting an IoU-only
+ result.
+
## [1.3.0] — 2026-07-22
The "quality & efficiency" line: a deterministic-first review harness (Divine Eye), stronger
@@ -131,6 +179,9 @@ and harness improvements to the underlying code generator.
- Action-ready runtime hierarchy exposing pivots, sockets, and colliders.
- Token-efficient, code-only output (diffable TypeScript + JSON spec, no binaries).
+[1.4.1]: https://github.com/hoainho/img2threejs/compare/v1.4.0...4e9fbecae0e63b370581737c89991d4dca84c287
+[1.4.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.4.0
+[1.3.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.3
[1.2.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.2.0
[1.1.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.1.0
[1.0.0]: https://github.com/hoainho/img2threejs/releases/tag/v1.0.0
diff --git a/ROADMAP.md b/ROADMAP.md
index 23d4631..cda1515 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -15,11 +15,7 @@ can plan around.
| v1.1 | Detail-first analysis | 2026-07-15 | Required `detailInventory` artifact (gloss, bevel, fasteners, linework, stains), strict-quality gate blocking shallow specs before codegen |
| v1.2 | Humanoid character generator | 2026-07-21 | Character/hybrid domain detection, anatomy-aware track, proportion-lock and feature-placement gated passes, per-part character materials |
| v1.3 | Quality & efficiency (Divine Eye) | 2026-07-22 | Deterministic multi-signal review harness, input-integrity and geometry-truth gates, reference-grounded texture/material analysis, CIEDE2000 colour math |
-| — | Creature generator | 2026-07-23 | 4 body plans (quadruped / avian / winged-dragon / serpentine), `animalAnatomy` spec, spine-loft (RMF) / membrane-wing / instanced-scale geometry, ΔE00 colour gates, straight-bind rig data |
-
-> **Note on numbering.** The creature-generator tranche is shipped but currently tagged `1.4.0` in
-> `CHANGELOG.md`, and `SKILL.md` reads `1.5.0`. Both are being re-tagged onto a `1.3.x` line so that
-> v1.4 onward can carry the themed roadmap below.
+| v1.4 | Weapon Pipeline | 2026-07-25–26 | CS2 image-matched reconstruction, provenance-aware intake and local search, projection-first finishes, family-specific adapters, structural review and component-coverage gates |
### v1.2 — Humanoid character generator
@@ -76,7 +72,6 @@ judgment is spent only where a script cannot decide.
| Version | Theme | Primary goal | Highlights |
|---|---|---|---|
-| **v1.4** | Weapon Pipeline | Become the best tool for hard-surface game assets | Weapon reconstruction accuracy · better mechanical reasoning · better materials (metal, polymer, wood) · optimized cost & speed · better prompting & docs |
| **v1.5** | Character Pipeline | Start supporting characters properly | Character reconstruction · facial features · rigging-ready topology · blendshape preparation · hair & clothing improvements |
| **v1.6** | Environment Pipeline | Build scenes, not just objects | Buildings · rooms · streets · trees & vegetation · terrain-aware generation · multi-object reconstruction |
| **v1.7** | Game Pipeline | Game-ready assets | Unity exporter · Unreal exporter · Blender bridge · FBX / OBJ / glTF improvements · LOD generation · collision mesh generation |
@@ -86,7 +81,6 @@ judgment is spent only where a script cannot decide.
### Release names
-- **v1.4 — The Weapon Update**
- **v1.5 — The Character Update**
- **v1.6 — The Environment Update**
- **v1.7 — The Game Pipeline Update**
@@ -96,19 +90,19 @@ judgment is spent only where a script cannot decide.
## Version details
-### v1.4 — The Weapon Update · *shipping soon*
+### v1.4 — The Weapon Update · *shipped 2026-07-25–26*
-A 1:1 photorealistic, non-stylized rendering pipeline for CS2-class hard-surface assets, built on
-strict PBR standards and texture projection. Where earlier versions accepted a stylized read of a
-weapon, v1.4 targets reference-exactness: correct metal response, correct polymer sheen, correct
-wood grain, and a projected-texture path that puts the reference's own pixels onto the observed
-surfaces instead of approximating them.
+v1.4 establishes image-matched reconstruction for CS2 hard-surface assets. The pipeline records
+reference admission, family/subtype identity, metadata and texture provenance, exactness tier, and
+hidden-region confidence before authoring geometry. It defaults patterned finishes, decals, and skin
+surfaces to a de-lit reference projection, rather than presenting a procedural approximation as an
+exact match.
-Mechanical reasoning improves alongside the materials. A weapon is an assembly with function —
-slide, magazine well, trigger group, rail, muzzle — and the pipeline reasons about those parts as
-mechanism rather than silhouette, which is what makes seams, insets, and part boundaries land where
-a player expects them. Cost and speed are tuned in the same tranche, and the prompting guidance and
-docs are rewritten around the weapon workflow.
+The initial family route covers supported knives and the Glock-18 with dedicated component contracts.
+Review now combines fixed and orbit renders with family, finish, projection, critical-detail,
+geometry-integrity, and component-coverage gates. The v1.4.1 hardening update also requires
+map-stripped blockout evidence and ordered pass credit, so a fused or incomplete assembly cannot pass
+on the strength of a projected texture alone.
### v1.5 — The Character Update