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
feat: update changelog and roadmap
kokorolx396bd1755a15
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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-22The "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.0diff --git a/ROADMAP.md b/ROADMAP.mdindex 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