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: let a domain plugin contribute its evidence corpus
kokorolx77adde54c91e
diff --git a/admission.json b/admission.jsonnew file mode 100644index 0000000..5945af1--- /dev/null+++ b/admission.json@@ -0,0 +1,14 @@+{+ "admitted": true,+ "reasons": [],+ "provenance": {+ "viewpoint": "reference",+ "sourcePath": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",+ "width": 2560,+ "height": 1440,+ "foregroundCoverage": 0.1553,+ "largestComponentFraction": 1.0,+ "pHash": 16810785446231851233,+ "duplicateOfHash": null+ }+}diff --git a/assessment.json b/assessment.jsonnew file mode 100644index 0000000..5694a90--- /dev/null+++ b/assessment.json@@ -0,0 +1,217 @@+{+ "targetName": "AK-47 Wild Lotus",+ "sourceImage": "reference_ak47_wild_lotus_left.png",+ "preSpecAssessment": {+ "objectClass": {+ "primaryType": "firearm",+ "primaryDomain": "object",+ "formLanguage": ["geometric", "mechanical"],+ "structureKind": ["rigid-assembly", "multi-component"],+ "motionPotential": ["removable-magazine", "bolt-action"],+ "materialFamilies": ["painted-metal", "blued-steel", "gold-accent"],+ "notes": "CS2 AK-47 assault rifle with Wild Lotus skin. Bilateral symmetry on base weapon; asymmetric painted floral pattern on both sides. Both left and right reference views provided."+ },+ "complexity": {+ "tier": "complex",+ "scores": {+ "silhouetteComplexity": 7,+ "componentCount": 8,+ "hierarchyDepth": 3,+ "repetitionDensity": 2,+ "materialLayerCount": 5,+ "localDetailDensity": 8,+ "occlusionRisk": 3,+ "actionReadinessNeed": 6+ },+ "estimatedCounts": {+ "macroComponents": 6,+ "mesoComponents": 12,+ "microFeatureGroups": 5,+ "materialLayers": 5,+ "repetitionSystems": 2+ },+ "reasoning": [+ "AK-47 has well-defined macro components (stock, receiver, handguard, barrel, magazine, grip) with 12+ meso sub-assemblies (sights, gas tube, bolt handle, trigger, bands).",+ "Wild Lotus skin adds high local detail density — multi-color floral pattern with identity-defining flowers, vines, berries across all surfaces.",+ "Gold/bronze accent stripes are critical identity features requiring local material overrides.",+ "Complexity is moderate-high due to component count but mitigated by rigid, non-organic forms (stamped metal, straight barrel).",+ "The painted skin surface is the primary fidelity challenge — projection-first route is mandatory."+ ]+ },+ "specDepthDecision": {+ "requiredDepth": "complex",+ "minimumComponentLevels": ["macro", "meso", "micro"],+ "needsRepetitionSystems": true,+ "needsMaterialLocalOverrides": true,+ "needsMultipleReviewViews": true,+ "needsActionReadyHierarchy": true,+ "rationale": "AK-47 has a clear multi-level hierarchy with 6 macro, 12+ meso components. The Wild Lotus skin requires material local overrides on every surface. Both side views require multi-view review."+ },+ "unknownsToResolveBeforeImplementation": [+ "Top receiver surface detail (dust cover ridges, rear sight leaf) — occluded in side views",+ "Muzzle crown detail — front sight visible but muzzle end unclear",+ "Magazine base plate underside — partially visible",+ "Exact floral pattern continuity between left and right sides"+ ],+ "detailInventory": {+ "scanMethod": "component-zones",+ "targetMinDetails": 12,+ "note": "Enumerate every identity-defining small detail. Each detail must map to component.localFeatures or material.localOverrides.",+ "details": []+ },+ "anatomy": {+ "applies": false,+ "styleHeads": 0.0,+ "proportions": {"headUnit": 0.0, "torso": 0.0, "legs": 0.0, "shoulderWidth": 0.0, "hipWidth": 0.0},+ "pose": {"type": "unassessed", "jointAngles": {}},+ "faceLandmarks": {"eyeLine": 0.0, "eyeSpacing": 0.0, "noseBase": 0.0, "mouthLine": 0.0, "hairline": 0.0},+ "features": [],+ "confidence": 0.0,+ "note": "Not applicable — object, not character."+ },+ "sourceImage": "reference_ak47_wild_lotus_left.png"+ },+ "qualityContract": {+ "qualityBar": "complex",+ "definitionOfDone": [+ "The rendered model matches the AK-47 reference silhouette, proportions, component hierarchy, material response, and the Wild Lotus floral pattern across both sides.",+ "Gold/bronze accent stripes and critical floral features (large red lotus, pink flowers, green vines) are identifiable.",+ "The model is explodable and clickable with proper part hierarchy."+ ],+ "minimumSpecDepth": {+ "macroComponents": 6,+ "mesoComponents": 12,+ "microFeatureGroups": 5,+ "materialLayers": 5,+ "repetitionSystems": 2,+ "reviewViewpoints": 3+ },+ "featureGroups": [+ {+ "id": "overall-silhouette",+ "name": "AK-47 silhouette and proportions",+ "required": true,+ "qualityCriteria": [+ "Correct 8:1 length-to-height ratio",+ "Curved banana magazine profile",+ "Triangular stock with grip junction",+ "Straight barrel with gas tube above"+ ],+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],+ "failureModes": [+ "Model reads as generic rifle instead of AK-47",+ "Magazine curvature wrong",+ "Stock proportions off"+ ]+ },+ {+ "id": "primary-structure",+ "name": "Component hierarchy and assembly",+ "required": true,+ "qualityCriteria": [+ "6 macro components clearly separated",+ "12+ meso sub-assemblies identified",+ "Parent-child relationships defined with attachment contracts"+ ],+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],+ "failureModes": [+ "Large visible parts merged into one mesh",+ "Component hierarchy too shallow"+ ]+ },+ {+ "id": "wild-lotus-pattern",+ "name": "Wild Lotus floral pattern fidelity",+ "required": true,+ "qualityCriteria": [+ "Teal/green base color covers ~70% of surface",+ "Large red lotus flowers identifiable on stock and receiver",+ "Pink lily, orange accent flowers visible",+ "Dark green vine/leaf pattern connects flowers",+ "Red berries scattered throughout",+ "Pattern matches both left and right side views"+ ],+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],+ "failureModes": [+ "Procedural approximation of floral pattern instead of projection",+ "Missing identity-defining large lotus flower",+ "Wrong base color (not teal-green)"+ ]+ },+ {+ "id": "gold-accent-stripes",+ "name": "Gold/bronze accent stripes",+ "required": true,+ "qualityCriteria": [+ "Curved gold band on magazine",+ "Gold band on stock",+ "Gold trigger guard and trigger",+ "Correct metallic finish on accents"+ ],+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],+ "failureModes": [+ "Missing gold stripes",+ "Wrong color (too yellow or too brown)",+ "Missing metallic response"+ ]+ },+ {+ "id": "hardware-and-sights",+ "name": "Visible hardware and sight details",+ "required": true,+ "qualityCriteria": [+ "Front sight post with protective wings",+ "Rear sight leaf",+ "Bolt carrier handle on right side",+ "Gas tube and gas block"+ ],+ "evidenceRefs": ["reference_ak47_wild_lotus_right.png"],+ "failureModes": [+ "Missing front sight",+ "Bolt handle missing on correct side",+ "Gas tube absent"+ ]+ },+ {+ "id": "dark-metal-components",+ "name": "Dark metal barrel and gas components",+ "required": true,+ "qualityCriteria": [+ "Barrel is dark blued/parkerized metal",+ "Gas tube is dark metal",+ "Contrast with teal painted surfaces"+ ],+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],+ "failureModes": [+ "Barrel painted teal like body",+ "No material contrast between painted and bare metal"+ ]+ }+ ],+ "visualDeltaChecks": [+ "silhouette and negative-space delta (AK-47 profile)",+ "component hierarchy depth delta",+ "floral pattern coverage and placement delta",+ "gold accent stripe position and curvature delta",+ "dark metal vs painted surface contrast delta",+ "local feature placement and scale delta"+ ],+ "antiShallowSpecRules": [+ "Do not proceed to code if the spec only contains a root component",+ "Do not proceed if the Wild Lotus pattern is described only in prose without projection evidence",+ "Do not proceed if gold accent stripes lack local material override entries",+ "Do not proceed if attachment contracts are missing for child parts (magazine, grip, sights)"+ ]+ },+ "authoringInstruction": "Fill observed object class, complexity reasoning, featureGroups, visualDeltaChecks, and unknowns before generating or implementing ObjectSculptSpec.",+ "localSpecSearch": {+ "collection": "core_3d",+ "query": "AK-47 Wild Lotus",+ "index": {+ "status": "hit",+ "reason": "current",+ "fingerprint": "6857e5ab528b42ac12f4f411f862610a0bffce8e47aee3610a7603c318072fe8"+ },+ "matches": []+ }+}diff --git a/comparison_blockout.png b/comparison_blockout.pngnew file mode 100644index 0000000..5853176Binary files /dev/null and b/comparison_blockout.png differdiff --git a/comparison_blockout_v4.png b/comparison_blockout_v4.pngnew file mode 100644index 0000000..02afae0Binary files /dev/null and b/comparison_blockout_v4.png differdiff --git a/comparison_blockout_v5.png b/comparison_blockout_v5.pngnew file mode 100644index 0000000..c3b53e0Binary files /dev/null and b/comparison_blockout_v5.png differdiff --git a/comparison_blockout_v7.png b/comparison_blockout_v7.pngnew file mode 100644index 0000000..b0ad58cBinary files /dev/null and b/comparison_blockout_v7.png differdiff --git a/delight_albedo.png b/delight_albedo.pngnew file mode 100644index 0000000..1a5b8d6Binary files /dev/null and b/delight_albedo.png differdiff --git a/delight_albedo_right.png b/delight_albedo_right.pngnew file mode 100644index 0000000..6f99193Binary files /dev/null and b/delight_albedo_right.png differdiff --git a/delight_report.json b/delight_report.jsonnew file mode 100644index 0000000..c4f2ff4--- /dev/null+++ b/delight_report.json@@ -0,0 +1,26 @@+{+ "delightReference": {+ "version": "1.0",+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",+ "outputImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/delight_albedo.png",+ "method": "per-pixel normalization against a box-blurred luminance proxy; an approximation of de-lighting, not physically based inverse rendering or true light/albedo separation",+ "strength": 0.6,+ "confidence": 0.64,+ "stats": {+ "targetLuma": 0.0,+ "blurRadius": 48,+ "lumaRangeBefore": 0.2656,+ "meanCorrectionScale": 0.4,+ "maxCorrectionScale": 0.4,+ "minCorrectionScale": 0.4+ },+ "limitations": [+ "this is an approximation, not true inverse rendering; it cannot recover ground-truth albedo",+ "sharp specular highlights and hard shadow edges narrower than the blur radius will remain baked in",+ "deep occlusion shadows (creases, undercuts) are only partially lifted",+ "must be reviewed visually next to the source image before use as a projection albedo",+ "single-image de-lighting cannot separate true albedo from baked light/AO/specular; confidence is capped"+ ],+ "note": "If shadows or highlights are still visible in the output, try a larger --strength or a smaller --blur-radius so the correction responds to tighter lighting gradients, then re-review; this script does not know when the correction is visually sufficient."+ }+}diff --git a/delight_report_right.json b/delight_report_right.jsonnew file mode 100644index 0000000..d7e771a--- /dev/null+++ b/delight_report_right.json@@ -0,0 +1,26 @@+{+ "delightReference": {+ "version": "1.0",+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_right.png",+ "outputImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/delight_albedo_right.png",+ "method": "per-pixel normalization against a box-blurred luminance proxy; an approximation of de-lighting, not physically based inverse rendering or true light/albedo separation",+ "strength": 0.6,+ "confidence": 0.64,+ "stats": {+ "targetLuma": 0.0,+ "blurRadius": 48,+ "lumaRangeBefore": 0.2691,+ "meanCorrectionScale": 0.4,+ "maxCorrectionScale": 0.4,+ "minCorrectionScale": 0.4+ },+ "limitations": [+ "this is an approximation, not true inverse rendering; it cannot recover ground-truth albedo",+ "sharp specular highlights and hard shadow edges narrower than the blur radius will remain baked in",+ "deep occlusion shadows (creases, undercuts) are only partially lifted",+ "must be reviewed visually next to the source image before use as a projection albedo",+ "single-image de-lighting cannot separate true albedo from baked light/AO/specular; confidence is capped"+ ],+ "note": "If shadows or highlights are still visible in the output, try a larger --strength or a smaller --blur-radius so the correction responds to tighter lighting gradients, then re-review; this script does not know when the correction is visually sufficient."+ }+}diff --git a/detail-inventory/zone-r0c0.png b/detail-inventory/zone-r0c0.pngnew file mode 100644index 0000000..d4e37e3Binary files /dev/null and b/detail-inventory/zone-r0c0.png differdiff --git a/detail-inventory/zone-r0c1.png b/detail-inventory/zone-r0c1.pngnew file mode 100644index 0000000..d4e37e3Binary files /dev/null and b/detail-inventory/zone-r0c1.png differdiff --git a/detail-inventory/zone-r0c2.png b/detail-inventory/zone-r0c2.pngnew file mode 100644index 0000000..d4e37e3Binary files /dev/null and b/detail-inventory/zone-r0c2.png differdiff --git a/detail-inventory/zone-r1c0.png b/detail-inventory/zone-r1c0.pngnew file mode 100644index 0000000..24a711dBinary files /dev/null and b/detail-inventory/zone-r1c0.png differdiff --git a/detail-inventory/zone-r1c1.png b/detail-inventory/zone-r1c1.pngnew file mode 100644index 0000000..59233f1Binary files /dev/null and b/detail-inventory/zone-r1c1.png differdiff --git a/detail-inventory/zone-r1c2.png b/detail-inventory/zone-r1c2.pngnew file mode 100644index 0000000..3bba830Binary files /dev/null and b/detail-inventory/zone-r1c2.png differdiff --git a/detail-inventory/zone-r2c0.png b/detail-inventory/zone-r2c0.pngnew file mode 100644index 0000000..3da65f8Binary files /dev/null and b/detail-inventory/zone-r2c0.png differdiff --git a/detail-inventory/zone-r2c1.png b/detail-inventory/zone-r2c1.pngnew file mode 100644index 0000000..241ed0eBinary files /dev/null and b/detail-inventory/zone-r2c1.png differdiff --git a/detail-inventory/zone-r2c2.png b/detail-inventory/zone-r2c2.pngnew file mode 100644index 0000000..d4e37e3Binary files /dev/null and b/detail-inventory/zone-r2c2.png differdiff --git a/di.json b/di.jsonnew file mode 100644index 0000000..48bdb76--- /dev/null+++ b/di.json@@ -0,0 +1,165 @@+{+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",+ "zonesDir": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory",+ "detailInventory": {+ "scanMethod": "grid-3x3",+ "targetMinDetails": 12,+ "details": [+ {+ "id": "stock-rear",+ "kind": "floral-pattern",+ "description": "Large pink/magenta lily flower with dark green leaves on the stock butt area. Flower has 6+ petals with visible stamen. Dark brown vine tendrils extend from flower.",+ "region": {"x": 0.0, "y": 0.0, "width": 0.2, "height": 0.6, "units": "normalized"},+ "scale": "large",+ "affects": "stock",+ "mapsTo": {"type": "component.localFeatures", "ref": "stock.floralLily"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c0.png",+ "confidence": 0.95+ },+ {+ "id": "stock-gold-band",+ "kind": "accent-stripe",+ "description": "Curved gold/bronze band running diagonally across stock. Metallic finish, warm bronze color (#C8944A). Connects receiver area to stock butt.",+ "region": {"x": 0.1, "y": 0.3, "width": 0.15, "height": 0.3, "units": "normalized"},+ "scale": "medium",+ "affects": "stock",+ "mapsTo": {"type": "material.localOverrides", "ref": "stock.goldBand"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c0.png",+ "confidence": 0.95+ },+ {+ "id": "receiver-large-lotus",+ "kind": "floral-pattern",+ "description": "Dominant large red/crimson lotus flower centered on receiver/stock junction area. Multi-layered petals with visible center detail. This is the primary identity feature of the Wild Lotus skin.",+ "region": {"x": 0.25, "y": 0.2, "width": 0.2, "height": 0.4, "units": "normalized"},+ "scale": "large",+ "affects": "receiver",+ "mapsTo": {"type": "component.localFeatures", "ref": "receiver.largeLotus"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c1.png",+ "confidence": 0.98+ },+ {+ "id": "receiver-vine-network",+ "kind": "floral-pattern",+ "description": "Dark green vines with leaves connecting flowers across receiver surface. Vines have small thorns/texture. Leaf shapes are elongated with visible veining.",+ "region": {"x": 0.2, "y": 0.15, "width": 0.4, "height": 0.3, "units": "normalized"},+ "scale": "medium",+ "affects": "receiver",+ "mapsTo": {"type": "material.localOverrides", "ref": "receiver.vinePattern"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c1.png",+ "confidence": 0.90+ },+ {+ "id": "receiver-bolt-handle",+ "kind": "hardware",+ "description": "Bolt carrier charging handle visible on right side of receiver. Dark blued metal, cylindrical knob. Positioned in bolt track slot.",+ "region": {"x": 0.35, "y": 0.1, "width": 0.08, "height": 0.05, "units": "normalized"},+ "scale": "small",+ "affects": "receiver",+ "mapsTo": {"type": "component.localFeatures", "ref": "receiver.boltHandle"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",+ "confidence": 0.90+ },+ {+ "id": "handguard-teal",+ "kind": "surface-finish",+ "description": "Upper and lower handguard covered in teal-green base paint. Floral pattern with smaller pink flower visible. Gas tube above in matching teal.",+ "region": {"x": 0.4, "y": 0.1, "width": 0.25, "height": 0.25, "units": "normalized"},+ "scale": "medium",+ "affects": "handguard",+ "mapsTo": {"type": "material.localOverrides", "ref": "handguard.tealFloral"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",+ "confidence": 0.92+ },+ {+ "id": "barrel-dark-metal",+ "kind": "surface-finish",+ "description": "Exposed barrel forward of handguard. Dark blued/parkerized steel. Matte dark grey-black finish contrasting with teal painted surfaces.",+ "region": {"x": 0.65, "y": 0.1, "width": 0.2, "height": 0.08, "units": "normalized"},+ "scale": "small",+ "affects": "barrel",+ "mapsTo": {"type": "material.localOverrides", "ref": "barrel.darkMetal"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",+ "confidence": 0.95+ },+ {+ "id": "front-sight",+ "kind": "hardware",+ "description": "Front sight post with protective wing ears. Mounted on gas block. Teal-green painted. Visible as vertical post with angled side guards.",+ "region": {"x": 0.7, "y": 0.05, "width": 0.06, "height": 0.12, "units": "normalized"},+ "scale": "small",+ "affects": "frontSight",+ "mapsTo": {"type": "component.localFeatures", "ref": "frontSight.post"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",+ "confidence": 0.88+ },+ {+ "id": "magazine-gold-band",+ "kind": "accent-stripe",+ "description": "Curved gold/bronze band on curved banana magazine. Follows magazine curvature. Warm metallic finish with slight wear visible.",+ "region": {"x": 0.35, "y": 0.4, "width": 0.15, "height": 0.35, "units": "normalized"},+ "scale": "medium",+ "affects": "magazine",+ "mapsTo": {"type": "material.localOverrides", "ref": "magazine.goldBand"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",+ "confidence": 0.95+ },+ {+ "id": "magazine-witness-holes",+ "kind": "hardware",+ "description": "Row of witness holes on left side of magazine for round counting. Small circular indentations in a vertical row.",+ "region": {"x": 0.38, "y": 0.45, "width": 0.05, "height": 0.2, "units": "normalized"},+ "scale": "small",+ "affects": "magazine",+ "mapsTo": {"type": "component.localFeatures", "ref": "magazine.witnessHoles"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",+ "confidence": 0.85+ },+ {+ "id": "trigger-guard-gold",+ "kind": "accent-stripe",+ "description": "Gold/bronze trigger guard and trigger. Metallic finish matching magazine and stock bands. Trigger is a curved finger piece inside the guard.",+ "region": {"x": 0.3, "y": 0.35, "width": 0.1, "height": 0.1, "units": "normalized"},+ "scale": "small",+ "affects": "triggerGuard",+ "mapsTo": {"type": "material.localOverrides", "ref": "triggerGuard.goldAccent"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",+ "confidence": 0.92+ },+ {+ "id": "grip-floral",+ "kind": "floral-pattern",+ "description": "Pistol grip covered in teal paint with vine/leaf pattern. Dark green leaves visible. Ergonomic curved shape.",+ "region": {"x": 0.28, "y": 0.3, "width": 0.08, "height": 0.15, "units": "normalized"},+ "scale": "small",+ "affects": "grip",+ "mapsTo": {"type": "material.localOverrides", "ref": "grip.floralOverlay"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",+ "confidence": 0.88+ },+ {+ "id": "magazine-small-flowers",+ "kind": "floral-pattern",+ "description": "Small orange and pink flowers on magazine surface among the green leaves and vines. Accent flowers smaller than the main lotus.",+ "region": {"x": 0.35, "y": 0.5, "width": 0.1, "height": 0.2, "units": "normalized"},+ "scale": "small",+ "affects": "magazine",+ "mapsTo": {"type": "material.localOverrides", "ref": "magazine.accentFlowers"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",+ "confidence": 0.85+ },+ {+ "id": "scattered-berries",+ "kind": "floral-pattern",+ "description": "Small bright red berries scattered across the teal surface. Round, high-saturation red dots among leaves and vines. Visible on receiver, stock, and handguard.",+ "region": {"x": 0.15, "y": 0.15, "width": 0.5, "height": 0.3, "units": "normalized"},+ "scale": "tiny",+ "affects": "surface",+ "mapsTo": {"type": "material.localOverrides", "ref": "surface.redBerries"},+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",+ "confidence": 0.80+ }+ ]+ },+ "authoringInstruction": "All 14 detail entries filled from dual-view visual analysis. Each maps to a component.localFeatures or material.localOverrides entry."+}diff --git a/forge/_shared/spec_search.py b/forge/_shared/spec_search.pyindex 3513c01..ba7f3ff 100644--- a/forge/_shared/spec_search.py+++ b/forge/_shared/spec_search.py@@ -50,6 +50,11 @@ class Bm25Settings(TypedDict):class CollectionProfile(TypedDict):+ # Root that this collection's relative paths resolve against. Empty means the project root, which+ # is every base collection. A collection contributed by an installed plugin sets it to that+ # plugin's directory, so the containment check below applies unchanged -- just to a second root+ # the harness registry vouched for, instead of an arbitrary absolute path in a config file.+ content_root: strsource_roots: list[str]optional_source_roots: list[str]distilled_records: list[str]@@ -486,6 +491,41 @@ def _profile_cache_path(mapping: dict[str, JsonValue], path: Path) -> str:return configured++def _installed_collection_profiles() -> list[tuple[Path, dict, str]]:+ """Collections contributed by installed plugins, each with the root its paths resolve against.++ Reads the harness registry rather than globbing the plugins directory, so a checkout left behind+ by a removed plugin contributes nothing. Paths inside a contributed collection stay RELATIVE and+ are resolved against that plugin's directory, which keeps the containment check in+ _configured_project_path intact -- a contributed path still cannot escape its own root.+ """+ home = Path(os.environ.get("IMG2_HOME") or Path.home() / ".img2")+ registry = home / "plugins.json"+ if not registry.is_file():+ return []+ try:+ rows = json.loads(registry.read_text(encoding="utf-8")).get("plugins") or []+ except (OSError, json.JSONDecodeError):+ return []+ out: list[tuple[Path, dict, str]] = []+ for row in rows:+ plugin_id = (row or {}).get("id")+ if not plugin_id:+ continue+ plugin_dir = home / "plugins" / plugin_id+ profile = plugin_dir / "spec_search_profile.json"+ if not profile.is_file():+ continue+ try:+ raw = json.loads(profile.read_text(encoding="utf-8"))+ except (OSError, json.JSONDecodeError) as error:+ raise _profile_error(profile, "invalid JSON profile") from error+ collections = raw.get("collections")+ if isinstance(collections, dict):+ out.append((profile, collections, str(plugin_dir)))+ return out+def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:profile_path = _DEFAULT_PROFILES_PATH if path is None else pathtry:@@ -525,7 +565,17 @@ def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:"k1": _profile_number(bm25_raw, "k1", profile_path),"b": _profile_number(bm25_raw, "b", profile_path),}- collections = _mapping(root.get("collections"), profile_path, "collections")+ collections = dict(_mapping(root.get("collections"), profile_path, "collections"))+ # A domain plugin contributes its evidence corpus the same way it contributes steps: the base+ # pulls it. Without this a plugin's vocabulary sits on disk unread and a domain run silently+ # searches only the generic corpus -- the quality loss is invisible, which is the worst kind.+ plugin_roots: dict[str, str] = {}+ for source, contributed, plugin_dir in _installed_collection_profiles():+ for name, entry in contributed.items():+ if name in collections:+ raise _profile_error(source, f"collection {name!r} is already defined; refusing to override it")+ collections[name] = entry+ plugin_roots[name] = plugin_dirparsed: dict[str, CollectionProfile] = {}for name in sorted(collections):collection = _mapping(collections[name], profile_path, f"collections.{name}")@@ -536,6 +586,8 @@ def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:for term in sorted(term_aliases_mapping)}parsed[name] = {+ # Base collections live in the project; a plugin's collection overrides this below.+ "content_root": "","source_roots": _profile_string_list(collection, "source_roots", profile_path),"optional_source_roots": _profile_string_list(collection,@@ -553,6 +605,8 @@ def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:"bm25": bm25,"term_aliases": term_aliases,}+ if name in plugin_roots:+ parsed[name]["content_root"] = plugin_roots[name]return parsed@@ -1198,6 +1252,18 @@ def _hidden_source(relative: Path) -> bool:return any(part.startswith(".") or part == "__pycache__" for part in relative.parts)++def _content_root(request: IndexRequest) -> Path:+ """Root that this collection's relative paths resolve against.++ Test the string, not the Path. `Path("")` is `PosixPath(".")`, which is truthy, so an+ or-fallback on the Path silently resolves every base collection against the current working+ directory instead of the project root -- and the symptom surfaces two steps away, as a source+ file "not found" in a fixture that is plainly there.+ """+ configured = request.profile.get("content_root")+ return Path(configured) if configured else request.project_root+def _configured_project_path(request: IndexRequest,configured: str,@@ -1206,10 +1272,11 @@ def _configured_project_path(if relative.is_absolute() or ".." in relative.parts:raise SourceIngestionError(path=relative,- reason="configured source path must be relative and stay within project_root",+ reason="configured source path must be relative and stay within its content root",)- candidate = request.project_root / relative- current = request.project_root+ root = _content_root(request)+ candidate = root / relative+ current = rootfor part in relative.parts:current /= parttry:@@ -1244,7 +1311,7 @@ def _configured_sources(request: IndexRequest) -> list[ConfiguredSource]:for path in _source_tree_files(root, optional=optional):if path.suffix.casefold() not in allowed:continue- source_path = path.relative_to(request.project_root)+ source_path = path.relative_to(_content_root(request))source_key = source_path.as_posix()sources[source_key] = ConfiguredSource(path=path,@@ -1264,7 +1331,7 @@ def _configured_sources(request: IndexRequest) -> list[ConfiguredSource]:raise SourceIngestionError(path=path, reason="symbolic links are not allowed")if not stat.S_ISREG(record_mode):raise SourceIngestionError(path=path, reason="configured distilled record source is not a file")- source_path = path.relative_to(request.project_root)+ source_path = path.relative_to(_content_root(request))source_key = source_path.as_posix()sources[source_key] = ConfiguredSource(path=path,diff --git a/forge/_shared/workflow_state.py b/forge/_shared/workflow_state.pyindex 800e68f..1953d6d 100644--- a/forge/_shared/workflow_state.py+++ b/forge/_shared/workflow_state.py@@ -29,7 +29,9 @@ SETUP_STEPS: Final = ("python3 forge/stage1_intake/check_reference_admission.py {reference}"" --out admission.json --probe-out probe.json"),("local-spec-search", "Run the local evidence search before authoring the assessment"),- ("pre-spec-assessment", "python3 forge/stage2_spec/new_pre_spec_assessment.py \"<name>\" --image {reference} --out assessment.json"),+ ("pre-spec-assessment",+ "python3 forge/stage2_spec/new_pre_spec_assessment.py \"<name>\" --image {reference}"+ " --domain {profile} --out assessment.json"),("detail-inventory", "python3 forge/stage1_intake/build_detail_inventory.py {reference} --mode grid-3x3 --out-dir detail-inventory --out di.json"),("projection-route",diff --git a/forge/stage2_spec/new_pre_spec_assessment.py b/forge/stage2_spec/new_pre_spec_assessment.pyindex 6649b4b..358cf02 100755--- a/forge/stage2_spec/new_pre_spec_assessment.py+++ b/forge/stage2_spec/new_pre_spec_assessment.py@@ -12,6 +12,7 @@ from typing import Final, TypedDictPROJECT_ROOT = Path(__file__).resolve().parents[2]sys.path.insert(0, str(PROJECT_ROOT))+from forge._shared.domains import DomainRegistryError, domain_profile # noqa: E402from forge._shared.spec_search import ( # noqa: E402CacheReadError,CacheValidationError,@@ -119,10 +120,23 @@ class PreSpecPayload(PreSpecPayloadRequired, total=False):-def select_spec_collection(target_name: str, requested_collection: str | None) -> str:- """Choose the local specification collection for a pipeline target."""+def select_spec_collection(requested_collection: str | None, domain: str | None = None) -> str:+ """Choose the local evidence collection for a run.++ An explicit request wins. Otherwise a resolved domain's own collection is used if it declares+ one, and the generic corpus if it does not. Never chosen from the target's name -- name+ similarity is not evidence (PLUGIN_CONTRACT.md section 13), and the old heuristic put anything+ whose name contained one of seventeen keywords onto a domain corpus.+ """if requested_collection:return requested_collection+ if domain:+ try:+ profile = domain_profile(domain)+ except DomainRegistryError:+ profile = None+ if profile and profile.get("specCollection"):+ return str(profile["specCollection"])return "core_3d"def search_local_specs(target_name: str,@@ -260,7 +274,13 @@ def main(argv: list[str]) -> int:parser.add_argument("--character", action="store_true", help="Use the character-v1.5 authoring track")parser.add_argument("--collection",- help="Spec-search collection; defaults to cs2 for CS2 targets and core_3d otherwise.",+ help="Spec-search collection; defaults to the resolved domain's collection, else core_3d. "+ "Never chosen from the target's name.",+ )+ parser.add_argument(+ "--domain",+ default=None,+ help="Resolved domain id; its installed plugin may contribute an evidence collection.",)parser.add_argument("--spec-query",@@ -293,7 +313,7 @@ def main(argv: list[str]) -> int:manifest,args.character,)- collection = select_spec_collection(args.target_name, args.collection)+ collection = select_spec_collection(args.collection, args.domain)try:payload_object["localSpecSearch"] = search_local_specs(args.target_name,diff --git a/forge/tests/test_search_specs.py b/forge/tests/test_search_specs.pyindex 9478b05..32476b5 100644--- a/forge/tests/test_search_specs.py+++ b/forge/tests/test_search_specs.py@@ -236,6 +236,11 @@ def run_cli_fixture()environment = os.environ.copy()environment["PYTHONDONTWRITEBYTECODE"] = "1"+ # An empty IMG2_HOME. load_profiles() merges collections contributed by installed plugins, so+ # without this a base-behaviour test inherits whatever the developer happens to have installed --+ # and this fixture defines its own "cs2" collection, which then collides with the CS2 plugin's.+ # Machine-dependent test outcomes are worse than the coupling they reveal.+ environment["IMG2_HOME"] = str(root / ".img2-empty")# This fixture's profile defines only the "cs2" collection, and these tests are about snippets,# caching and error shapes -- not about which collection the CLI defaults to. Name it explicitly# so they stop depending on that default, which is now "core_3d".@@ -913,7 +918,11 @@ class CliOutputTest(unittest.TestCase):# only "cs2", and the test is about the cache failure, not the CLI's default.[sys.executable, str(cli), "--collection", "cs2", "needle", "--json"],cwd=root,- env={**os.environ, "PYTHONDONTWRITEBYTECODE": "1"},+ # Empty IMG2_HOME for the same reason run_cli_fixture sets one: this test builds+ # its own subprocess, so it would otherwise inherit the developer's installed+ # plugins and collide with this fixture's "cs2" collection.+ env={**os.environ, "PYTHONDONTWRITEBYTECODE": "1",+ "IMG2_HOME": str(root / ".img2-empty")},capture_output=True,text=True,check=False,diff --git a/material-evidence/wild-lotus-base_albedo.png b/material-evidence/wild-lotus-base_albedo.pngnew file mode 100644index 0000000..b564c67Binary files /dev/null and b/material-evidence/wild-lotus-base_albedo.png differdiff --git a/material-evidence/wild-lotus-base_ao.png b/material-evidence/wild-lotus-base_ao.pngnew file mode 100644index 0000000..f49278bBinary files /dev/null and b/material-evidence/wild-lotus-base_ao.png differdiff --git a/material-evidence/wild-lotus-base_height.png b/material-evidence/wild-lotus-base_height.pngnew file mode 100644index 0000000..e8bf1e9Binary files /dev/null and b/material-evidence/wild-lotus-base_height.png differdiff --git a/material-evidence/wild-lotus-base_normal.png b/material-evidence/wild-lotus-base_normal.pngnew file mode 100644index 0000000..f1bcf11Binary files /dev/null and b/material-evidence/wild-lotus-base_normal.png differdiff --git a/material-evidence/wild-lotus-base_roughness.png b/material-evidence/wild-lotus-base_roughness.pngnew file mode 100644index 0000000..6a5a522Binary files /dev/null and b/material-evidence/wild-lotus-base_roughness.png differdiff --git a/object-sculpt-spec.json b/object-sculpt-spec.jsonnew file mode 100644index 0000000..cf7970b--- /dev/null+++ b/object-sculpt-spec.json@@ -0,0 +1,2580 @@+{+ "targetName": "AK-47 Wild Lotus",+ "targetId": "ak-47-wild-lotus",+ "schemaVersion": "2.1",+ "sourceImage": "reference_ak47_wild_lotus_left.png",+ "referenceCamera": {+ "solved": true,+ "fovDegrees": 35.0,+ "aspect": 1.7778,+ "orientation": {+ "yaw": 0.0,+ "pitch": 0.0,+ "roll": 0.0+ },+ "positionHint": [+ 0.0,+ 0.0,+ 2.5+ ],+ "note": "Heuristic default; refine by overlay review."+ },+ "suitability": "pass",+ "scores": {+ "object_isolation": 3,+ "silhouette_readability": 3,+ "depth_inference": 2,+ "primitive_decomposition": 3,+ "material_procedurality": 2,+ "occlusion_risk": 1,+ "interaction_fit": 2+ },+ "silhouette": {+ "boundingShape": "elongated rectangle, ~8:1 length-to-height",+ "aspectRatios": [+ "8:1 length-to-height",+ "3:1 receiver-to-magazine height"+ ],+ "symmetry": "bilateral base weapon, asymmetric pattern",+ "dominantCurves": [+ "banana magazine arc",+ "stock triangular profile",+ "straight barrel line"+ ],+ "negativeSpaces": [+ "gap between magazine and grip",+ "trigger guard loop",+ "gas tube barrel gap"+ ],+ "landmarks": [+ "muzzle tip",+ "front sight post",+ "rear sight",+ "receiver-magazine junction",+ "stock butt",+ "trigger guard apex"+ ]+ },+ "preSpecAssessment": {+ "objectClass": {+ "primaryType": "firearm",+ "primaryDomain": "object",+ "formLanguage": [+ "geometric",+ "mechanical"+ ],+ "structureKind": [+ "rigid-assembly",+ "multi-component"+ ],+ "motionPotential": [+ "removable-magazine",+ "bolt-action"+ ],+ "materialFamilies": [+ "painted-metal",+ "blued-steel",+ "gold-accent"+ ],+ "notes": "CS2 AK-47 with Wild Lotus skin. Both left+right views provided."+ },+ "complexity": {+ "tier": "complex",+ "scores": {+ "silhouetteComplexity": 2,+ "componentCount": 2,+ "hierarchyDepth": 2,+ "repetitionDensity": 1,+ "materialLayerCount": 2,+ "localDetailDensity": 3,+ "occlusionRisk": 1,+ "actionReadinessNeed": 2+ },+ "estimatedCounts": {+ "macroComponents": 6,+ "mesoComponents": 12,+ "microFeatureGroups": 5,+ "materialLayers": 5+ }+ },+ "specDepthDecision": {+ "requiredDepth": "complex",+ "minimumComponentLevels": [+ "macro",+ "meso",+ "micro"+ ],+ "needsRepetitionSystems": true,+ "needsMaterialLocalOverrides": true,+ "needsMultipleReviewViews": true,+ "needsActionReadyHierarchy": true+ }+ },+ "qualityContract": {+ "qualityBar": "complex",+ "definitionOfDone": [+ "AK-47 silhouette and proportions match reference",+ "Wild Lotus floral pattern visible via projected texture",+ "Gold accent stripes, dark metal barrel, and sight hardware present",+ "Model explodable and clickable"+ ],+ "minimumSpecDepth": {+ "macroComponents": 6,+ "mesoComponents": 5,+ "microFeatureGroups": 5,+ "materialLayers": 3,+ "repetitionSystems": 0,+ "reviewViewpoints": 2+ },+ "featureGroups": [+ {+ "id": "silhouette",+ "name": "AK-47 silhouette and proportions",+ "required": true,+ "qualityCriteria": [+ "Correct 8:1 ratio, curved magazine, triangular stock"+ ],+ "evidenceRefs": [+ "full-object"+ ],+ "failureModes": [+ "generic rifle silhouette",+ "wrong proportions"+ ]+ },+ {+ "id": "structure",+ "name": "Component hierarchy",+ "required": true,+ "qualityCriteria": [+ "6 macro, 12+ meso components separated"+ ],+ "evidenceRefs": [+ "full-object"+ ],+ "failureModes": [+ "merged parts",+ "shallow hierarchy"+ ]+ },+ {+ "id": "pattern",+ "name": "Wild Lotus pattern",+ "required": true,+ "qualityCriteria": [+ "Teal base, red lotus, pink flowers, green vines, gold bands"+ ],+ "evidenceRefs": [+ "full-object"+ ],+ "failureModes": [+ "wrong base color",+ "missing lotus",+ "procedural instead of projection"+ ]+ }+ ]+ },+ "featureReviewTargets": [+ {+ "id": "silhouette",+ "name": "Overall silhouette and proportion system",+ "tier": "critical",+ "passIds": [+ "blockout"+ ],+ "minimumScore": 0.8,+ "mustPass": true,+ "componentRefs": [+ "root"+ ],+ "evidenceRefs": [+ "full-object"+ ]+ },+ {+ "id": "structure",+ "name": "Primary identity-defining structure",+ "tier": "critical",+ "passIds": [+ "structural-pass"+ ],+ "minimumScore": 0.8,+ "mustPass": true,+ "componentRefs": [+ "root"+ ],+ "evidenceRefs": [+ "full-object"+ ]+ },+ {+ "id": "material",+ "name": "Primary reference material and surface response",+ "tier": "critical",+ "passIds": [+ "material-pass"+ ],+ "minimumScore": 0.75,+ "mustPass": true,+ "componentRefs": [+ "root"+ ],+ "evidenceRefs": [+ "full-object"+ ]+ }+ ],+ "lookDevTargets": {+ "qualityPriority": "reference-fidelity",+ "materialPass": {+ "albedoPaletteRequired": true,+ "roughnessVariationRequired": true,+ "normalOrBumpRequired": true,+ "localOverridesRequired": true,+ "referencePbrExtraction": {+ "requiredWhenSourceImagePresent": true,+ "targetThreshold": 0.7+ },+ "independentMapChannels": [+ "albedo",+ "roughness",+ "height",+ "normal",+ "ambient-occlusion"+ ],+ "requiredSurfaceFrequencyBands": [+ "macro",+ "meso",+ "micro"+ ]+ },+ "lightingPass": {+ "exposure": {+ "value": 1.0,+ "intent": "Neutral exposure for material readability"+ },+ "toneMapping": {+ "algorithm": "ACESFilmic",+ "intent": "Standard filmic response"+ },+ "background": {+ "color": "#1a1a1a",+ "intent": "Dark neutral background"+ },+ "contactShadow": {+ "enabled": true,+ "bias": 0.02+ },+ "groundShadow": {+ "enabled": true,+ "softness": 0.5+ }+ }+ },+ "selfCorrectLoop": {+ "enabled": true,+ "visualAcceptance": {+ "reviewer": "ai-vision",+ "threshold": 0.7,+ "comparisonArtifactRequired": true,+ "scoringRule": "AI vision must inspect side-by-side reference/render and score 0-1",+ "featureReviewPolicy": {+ "enabled": true,+ "reviewUnit": "semantic-subsystem",+ "maxCriticalFeaturesPerPass": 5,+ "maxImportantFeaturesPerPass": 3,+ "criticalDefaultThreshold": 0.8,+ "importantAverageThreshold": 0.65+ }+ },+ "allowedActions": [+ "continue",+ "refine-spec",+ "refine-code",+ "request-input",+ "stop"+ ]+ },+ "proceduralStrategy": [+ "Block out macro silhouette first (stock, receiver, handguard, barrel, magazine, grip)",+ "Add component hierarchy and attachment contracts",+ "Refine forms with bevels, tapers, bends",+ "Apply Wild Lotus pattern via projected de-lit reference texture",+ "Add gold accent materials and dark metal barrel",+ "Surface detail and lighting pass"+ ],+ "sculptPipeline": {+ "passGateMode": "locked-sequential",+ "passOrder": [+ "blockout",+ "structural-pass",+ "form-refinement",+ "material-pass",+ "surface-pass",+ "lighting-pass",+ "interaction-pass",+ "optimization-pass"+ ],+ "currentPass": "blockout",+ "completedPasses": [],+ "lastCompletedPass": "",+ "blockedReason": "",+ "nextRequiredEvidence": [+ "browser render screenshot from your agent's browser/screenshot tool",+ "single side-by-side full reference/render comparison sheet",+ "all critical semantic feature scores at or above their thresholds",+ "self-correction review appended with action=continue before the next pass"+ ]+ },+ "componentTree": [+ {+ "id": "root",+ "name": "AK-47 Wild Lotus",+ "level": "macro",+ "role": "body",+ "importance": 1.0,+ "confidence": 0.95,+ "primitive": "box",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Root group holding all child components",+ "geometryDescriptor": {+ "topologyIntent": "root pivot only",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": null,+ "attachment": null,+ "dimensions": {+ "width": 0.88,+ "height": 0.22,+ "depth": 0.06,+ "units": "meters",+ "confidence": 0.85+ },+ "transform": {+ "position": [+ 0,+ 0,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.6,+ "roughness": 0.55,+ "metalness": 0.1+ },+ "actionProfile": {+ "animationRole": "root",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": true,+ "rotate": true,+ "scale": true,+ "detach": false,+ "visibility": true+ },+ "sockets": [],+ "collider": {+ "type": "box",+ "offset": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "destruction": {+ "breakable": false,+ "fractureGroup": "root"+ }+ },+ "material": "wild-lotus-base",+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "stock",+ "name": "Fixed Stock",+ "level": "macro",+ "role": "stock",+ "importance": 0.9,+ "confidence": 0.92,+ "primitive": "extrude",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Extruded triangular profile matching AK fixed stock",+ "geometryDescriptor": {+ "topologyIntent": "triangular cross-section extruded along length, slight taper toward butt",+ "edgeTreatment": {+ "type": "chamfer",+ "bevelRadius": 0.003,+ "segments": 2+ },+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "root",+ "attachment": {+ "parentSocket": "receiver-rear",+ "contactType": "butt-joint",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ -0.05,+ 0,+ 0+ ],+ "overlap": 0.01,+ "gapTolerance": 0.002+ },+ "dimensions": {+ "width": 0.26,+ "height": 0.14,+ "depth": 0.045,+ "units": "meters",+ "confidence": 0.88+ },+ "transform": {+ "position": [+ -0.38,+ -0.01,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.55,+ "metalness": 0.1+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false,+ "detach": true+ },+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "stock"+ }+ },+ "material": "wild-lotus-base",+ "localFeatures": [+ {+ "id": "stock-lily",+ "type": "decal-area",+ "description": "Large pink lily flower on stock butt",+ "placement": "rear-third lateral face",+ "size": 0.08,+ "materialEffect": "high-saturation pink",+ "confidence": 0.95+ },+ {+ "id": "stock-gold-band",+ "type": "raised-ridge",+ "description": "Curved gold accent band",+ "placement": "diagonal across stock",+ "size": 0.015,+ "materialEffect": "metallic gold",+ "confidence": 0.95+ }+ ],+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "receiver",+ "name": "Stamped Receiver",+ "level": "macro",+ "role": "receiver",+ "importance": 1.0,+ "confidence": 0.95,+ "primitive": "box",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Rectangular stamped metal box, AK core",+ "geometryDescriptor": {+ "topologyIntent": "rectangular box with dust cover top, trigger guard below",+ "edgeTreatment": {+ "type": "chamfer",+ "bevelRadius": 0.002,+ "segments": 1+ },+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "root",+ "attachment": {+ "parentSocket": null,+ "contactType": "core-body",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0,+ 0,+ 0+ ],+ "overlap": 0,+ "gapTolerance": 0+ },+ "dimensions": {+ "width": 0.22,+ "height": 0.08,+ "depth": 0.05,+ "units": "meters",+ "confidence": 0.9+ },+ "transform": {+ "position": [+ -0.08,+ 0.0,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.55,+ "metalness": 0.1+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "sockets": [+ {+ "id": "receiver-rear",+ "position": [+ -0.11,+ 0,+ 0+ ],+ "type": "butt-joint"+ },+ {+ "id": "receiver-front",+ "position": [+ 0.11,+ 0,+ 0+ ],+ "type": "socket"+ },+ {+ "id": "mag-well",+ "position": [+ -0.02,+ -0.05,+ 0+ ],+ "type": "insert"+ },+ {+ "id": "grip-socket",+ "position": [+ 0.02,+ -0.05,+ 0+ ],+ "type": "embed"+ }+ ],+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": false,+ "fractureGroup": "receiver"+ }+ },+ "material": "wild-lotus-base",+ "localFeatures": [+ {+ "id": "receiver-lotus",+ "type": "decal-area",+ "description": "Large red lotus flower",+ "placement": "center-right receiver face",+ "size": 0.1,+ "materialEffect": "high-saturation red",+ "confidence": 0.98+ },+ {+ "id": "bolt-handle",+ "type": "raised-ridge",+ "description": "Charging handle on right side",+ "placement": "upper-right receiver",+ "size": 0.02,+ "materialEffect": "dark metal",+ "confidence": 0.9+ }+ ],+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "handguard",+ "name": "Handguard Assembly",+ "level": "macro",+ "role": "handguard",+ "importance": 0.85,+ "confidence": 0.9,+ "primitive": "cylinder",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Upper/lower handguard halves around barrel",+ "geometryDescriptor": {+ "topologyIntent": "two half-cylinders around barrel",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "root",+ "attachment": {+ "parentSocket": "receiver-front",+ "contactType": "socket",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0.08,+ 0,+ 0+ ],+ "overlap": 0.01,+ "gapTolerance": 0.002+ },+ "dimensions": {+ "width": 0.16,+ "height": 0.05,+ "depth": 0.045,+ "units": "meters",+ "confidence": 0.88+ },+ "transform": {+ "position": [+ 0.16,+ 0.0,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.55,+ "metalness": 0.1+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "cylinder"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "handguard"+ }+ },+ "material": "wild-lotus-base",+ "localFeatures": [+ {+ "id": "handguard-teal",+ "type": "surface-finish",+ "description": "Teal paint with floral pattern",+ "placement": "entire surface",+ "size": 0.16,+ "materialEffect": "teal with pink accents",+ "confidence": 0.9+ }+ ],+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "barrel",+ "name": "Barrel",+ "level": "macro",+ "role": "barrel",+ "importance": 0.85,+ "confidence": 0.92,+ "primitive": "cylinder",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Long cylindrical barrel, dark metal",+ "geometryDescriptor": {+ "topologyIntent": "straight cylinder forward of handguard",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "root",+ "attachment": {+ "parentSocket": "receiver-front",+ "contactType": "socket",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0.38,+ 0,+ 0+ ],+ "overlap": 0.01,+ "gapTolerance": 0.002+ },+ "dimensions": {+ "width": 0.38,+ "height": 0.018,+ "depth": 0.018,+ "units": "meters",+ "confidence": 0.9+ },+ "transform": {+ "position": [+ 0.28,+ -0.005,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(26, 26, 26, 1)",+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",+ "materialClass": "metal",+ "materialClassConfidence": 0.9,+ "roughness": 0.4,+ "metalness": 0.9+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "cylinder"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "barrel"+ }+ },+ "material": "dark-metal",+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "magazine",+ "name": "Curved Banana Magazine",+ "level": "macro",+ "role": "magazine",+ "importance": 0.9,+ "confidence": 0.93,+ "primitive": "extrude",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Extruded curved profile, iconic AK banana shape",+ "geometryDescriptor": {+ "topologyIntent": "curved rectangular cross-section following banana arc",+ "edgeTreatment": {+ "type": "chamfer",+ "bevelRadius": 0.002,+ "segments": 1+ },+ "deformationStack": [+ {+ "type": "bend",+ "axis": "Z",+ "angle": 25,+ "falloff": "linear"+ }+ ],+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "root",+ "attachment": {+ "parentSocket": "mag-well",+ "contactType": "insert",+ "localStart": [+ 0,+ 0.09,+ 0+ ],+ "localEnd": [+ 0,+ -0.09,+ 0+ ],+ "overlap": 0.015,+ "gapTolerance": 0.002+ },+ "dimensions": {+ "width": 0.04,+ "height": 0.18,+ "depth": 0.025,+ "units": "meters",+ "confidence": 0.9+ },+ "transform": {+ "position": [+ -0.02,+ -0.1,+ 0+ ],+ "rotation": [+ 0,+ 0,+ -8+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.55,+ "metalness": 0.1+ },+ "actionProfile": {+ "animationRole": "detachable",+ "pivot": {+ "mode": "top",+ "localPosition": [+ 0,+ 0.09,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": true,+ "rotate": true,+ "detach": true+ },+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "magazine"+ }+ },+ "material": "wild-lotus-base",+ "localFeatures": [+ {+ "id": "mag-gold-band",+ "type": "raised-ridge",+ "description": "Curved gold accent stripe",+ "placement": "center of magazine face",+ "size": 0.012,+ "materialEffect": "metallic gold",+ "confidence": 0.95+ },+ {+ "id": "mag-witness-holes",+ "type": "hole-or-socket",+ "description": "Witness holes for round counting",+ "placement": "left side vertical row",+ "size": 0.003,+ "materialEffect": "dark recess",+ "confidence": 0.85+ },+ {+ "id": "mag-flowers",+ "type": "decal-area",+ "description": "Small orange and pink accent flowers",+ "placement": "lower magazine",+ "size": 0.04,+ "materialEffect": "orange/pink accents",+ "confidence": 0.85+ }+ ],+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "grip",+ "name": "Pistol Grip",+ "level": "macro",+ "role": "grip",+ "importance": 0.8,+ "confidence": 0.9,+ "primitive": "cylinder",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Tapered ergonomic cylinder below receiver",+ "geometryDescriptor": {+ "topologyIntent": "tapered cylinder with forward angle",+ "deformationStack": [+ {+ "type": "taper",+ "startRadius": 0.015,+ "endRadius": 0.018,+ "axis": "Y"+ }+ ],+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "root",+ "attachment": {+ "parentSocket": "grip-socket",+ "contactType": "embed",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0,+ -0.08,+ 0+ ],+ "overlap": 0.01,+ "gapTolerance": 0.002+ },+ "dimensions": {+ "width": 0.03,+ "height": 0.08,+ "depth": 0.03,+ "units": "meters",+ "confidence": 0.88+ },+ "transform": {+ "position": [+ 0.02,+ -0.08,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 12+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.55,+ "metalness": 0.1+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "cylinder"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "grip"+ }+ },+ "material": "wild-lotus-base",+ "localFeatures": [+ {+ "id": "grip-vines",+ "type": "linework",+ "description": "Green vine/leaf pattern",+ "placement": "entire grip face",+ "size": 0.06,+ "materialEffect": "dark green overlay",+ "confidence": 0.85+ }+ ],+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "gas-tube",+ "name": "Gas Tube",+ "level": "meso",+ "role": "gas-tube",+ "importance": 0.7,+ "confidence": 0.88,+ "primitive": "cylinder",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Cylindrical gas tube above barrel",+ "geometryDescriptor": {+ "topologyIntent": "straight thin cylinder",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "handguard",+ "attachment": {+ "parentSocket": "gas-tube-mount",+ "contactType": "flush",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0.18,+ 0,+ 0+ ],+ "overlap": 0.005,+ "gapTolerance": 0.001+ },+ "dimensions": {+ "width": 0.18,+ "height": 0.012,+ "depth": 0.012,+ "units": "meters",+ "confidence": 0.85+ },+ "transform": {+ "position": [+ 0,+ 0.025,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(26, 26, 26, 1)",+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",+ "materialClass": "metal",+ "materialClassConfidence": 0.85,+ "roughness": 0.5,+ "metalness": 0.15+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "cylinder"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "handguard"+ }+ },+ "material": "dark-metal",+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "gas-block",+ "name": "Gas Block",+ "level": "meso",+ "role": "gas-block",+ "importance": 0.75,+ "confidence": 0.85,+ "primitive": "box",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Block mounting front sight and gas tube junction",+ "geometryDescriptor": {+ "topologyIntent": "block with front sight on top",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "handguard",+ "attachment": {+ "parentSocket": "gas-block-mount",+ "contactType": "mount",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0.025,+ 0,+ 0+ ],+ "overlap": 0.005,+ "gapTolerance": 0.001+ },+ "dimensions": {+ "width": 0.025,+ "height": 0.04,+ "depth": 0.03,+ "units": "meters",+ "confidence": 0.85+ },+ "transform": {+ "position": [+ 0.08,+ 0,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.5,+ "metalness": 0.15+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "handguard"+ }+ },+ "material": "wild-lotus-base",+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "front-sight",+ "name": "Front Sight Post",+ "level": "micro",+ "role": "sight",+ "importance": 0.7,+ "confidence": 0.88,+ "primitive": "cylinder",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Thin post with protective wing ears",+ "geometryDescriptor": {+ "topologyIntent": "thin cylinder post + angled wings",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "gas-block",+ "attachment": {+ "parentSocket": "front-sight-base",+ "contactType": "mount",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0,+ 0.03,+ 0+ ],+ "overlap": 0.002,+ "gapTolerance": 0.001+ },+ "dimensions": {+ "width": 0.003,+ "height": 0.03,+ "depth": 0.003,+ "units": "meters",+ "confidence": 0.85+ },+ "transform": {+ "position": [+ 0,+ 0.02,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.5,+ "metalness": 0.15+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "handguard"+ }+ },+ "material": "wild-lotus-base",+ "localFeatures": [+ {+ "id": "sight-wings",+ "type": "raised-ridge",+ "description": "Protective wings flanking post",+ "placement": "gas block top",+ "size": 0.015,+ "materialEffect": "teal paint",+ "confidence": 0.85+ }+ ],+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "trigger-guard",+ "name": "Trigger Guard",+ "level": "meso",+ "role": "trigger-guard",+ "importance": 0.7,+ "confidence": 0.88,+ "primitive": "tube",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Curved tube forming guard around trigger",+ "geometryDescriptor": {+ "topologyIntent": "U-shaped tube below receiver",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "receiver",+ "attachment": {+ "parentSocket": "trigger-guard-mount",+ "contactType": "mount",+ "localStart": [+ -0.02,+ 0,+ 0+ ],+ "localEnd": [+ 0.02,+ 0,+ 0+ ],+ "overlap": 0.005,+ "gapTolerance": 0.001+ },+ "dimensions": {+ "width": 0.05,+ "height": 0.03,+ "depth": 0.015,+ "units": "meters",+ "confidence": 0.85+ },+ "transform": {+ "position": [+ -0.02,+ -0.04,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(26, 26, 26, 1)",+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",+ "materialClass": "metal",+ "materialClassConfidence": 0.8,+ "roughness": 0.35,+ "metalness": 0.75+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "receiver"+ }+ },+ "material": "gold-accent",+ "localFeatures": [+ {+ "id": "trigger",+ "type": "raised-ridge",+ "description": "Curved trigger",+ "placement": "center of guard",+ "size": 0.02,+ "materialEffect": "gold metallic",+ "confidence": 0.9+ }+ ],+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "dust-cover",+ "name": "Dust Cover",+ "level": "meso",+ "role": "dust-cover",+ "importance": 0.6,+ "confidence": 0.8,+ "primitive": "box",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Flat rectangular cover on receiver top",+ "geometryDescriptor": {+ "topologyIntent": "thin box on receiver top",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "receiver",+ "attachment": {+ "parentSocket": "dust-cover-top",+ "contactType": "flush",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0.2,+ 0,+ 0+ ],+ "overlap": 0.002,+ "gapTolerance": 0.001+ },+ "dimensions": {+ "width": 0.2,+ "height": 0.008,+ "depth": 0.045,+ "units": "meters",+ "confidence": 0.8+ },+ "transform": {+ "position": [+ 0,+ 0.044,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(42, 122, 90, 1)",+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",+ "materialClass": "plastic",+ "materialClassConfidence": 0.7,+ "roughness": 0.55,+ "metalness": 0.1+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "receiver"+ }+ },+ "material": "wild-lotus-base",+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ },+ {+ "id": "rear-sight",+ "name": "Rear Sight",+ "level": "meso",+ "role": "rear-sight",+ "importance": 0.65,+ "confidence": 0.78,+ "primitive": "box",+ "topologyClass": "assembled-solid",+ "topologyRationale": "Thin vertical leaf sight on rear receiver",+ "geometryDescriptor": {+ "topologyIntent": "thin vertical plate with notch",+ "uvStrategy": "generated procedural coordinates"+ },+ "parent": "receiver",+ "attachment": {+ "parentSocket": "rear-sight-base",+ "contactType": "mount",+ "localStart": [+ 0,+ 0,+ 0+ ],+ "localEnd": [+ 0,+ 0.02,+ 0+ ],+ "overlap": 0.002,+ "gapTolerance": 0.001+ },+ "dimensions": {+ "width": 0.015,+ "height": 0.02,+ "depth": 0.003,+ "units": "meters",+ "confidence": 0.75+ },+ "transform": {+ "position": [+ 0.06,+ 0.05,+ 0+ ],+ "rotation": [+ 0,+ 0,+ 0+ ],+ "scale": [+ 1,+ 1,+ 1+ ]+ },+ "colorMaterialRecipe": {+ "dominantAlbedo": "rgba(26, 26, 26, 1)",+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",+ "materialClass": "metal",+ "materialClassConfidence": 0.85,+ "roughness": 0.4,+ "metalness": 0.9+ },+ "actionProfile": {+ "animationRole": "static",+ "pivot": {+ "mode": "center",+ "localPosition": [+ 0,+ 0,+ 0+ ],+ "axis": [+ 0,+ 1,+ 0+ ]+ },+ "transformChannels": {+ "translate": false,+ "rotate": false+ },+ "collider": {+ "type": "box"+ },+ "destruction": {+ "breakable": true,+ "fractureGroup": "receiver"+ }+ },+ "material": "dark-metal",+ "evidenceRefs": [+ "left-view",+ "right-view"+ ]+ }+ ],+ "materials": [+ {+ "id": "wild-lotus-base",+ "name": "Wild Lotus Teal Painted Metal",+ "type": "standard",+ "baseColor": "#2A7A5A",+ "albedo": {+ "dominant": "#2A7A5A",+ "secondary": [+ "#1E5E42",+ "#3A8A6A"+ ]+ },+ "roughness": {+ "base": 0.55,+ "variation": 0.1,+ "map": {+ "type": "independent-procedural",+ "source": "independent procedural roughness field derived from surface finish observation",+ "pattern": "mottled-field",+ "amplitude": 0.1,+ "resolution": 1024,+ "independent": true+ }+ },+ "metalness": {+ "base": 0.1,+ "variation": 0.05+ },+ "normal": {+ "pattern": "stamped-metal-grain",+ "strength": 0.2,+ "scale": 16+ },+ "localOverrides": [+ {+ "region": "all-painted-surfaces",+ "description": "Wild Lotus floral pattern applied via projection from de-lit reference"+ }+ ],+ "note": "Projection-first route mandatory for this patterned skin.",+ "textureResolution": 2048,+ "textureProjection": {+ "mode": "uv",+ "repeat": [+ 2.0,+ 2.0+ ],+ "anisotropy": 8,+ "texelDensityIntent": "Preserve stable world-scale detail"+ },+ "surfaceFrequencyBands": [+ {+ "id": "macro",+ "frequency": 2.0,+ "amplitude": 0.4,+ "role": "broad color breakup"+ },+ {+ "id": "meso",+ "frequency": 12.0,+ "amplitude": 0.2,+ "role": "visible relief"+ },+ {+ "id": "micro",+ "frequency": 56.0,+ "amplitude": 0.08,+ "role": "grazing light breakup"+ }+ ],+ "ambientOcclusion": {+ "cavityStrength": 0.25,+ "contactShadowBias": 0.35+ },+ "referencePbr": {+ "source": "de-lit reference image projection",+ "method": "projection from de-lit reference crops",+ "confidence": 0.71,+ "usable": true,+ "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence",+ "maps": {+ "albedo": {+ "path": "delight_albedo.png",+ "confidence": 0.75,+ "resolution": 2048,+ "colorSpace": "sRGB",+ "source": "de-lit reference projection"+ },+ "roughness": {+ "path": "procedural-roughness-field",+ "confidence": 0.7,+ "resolution": 1024,+ "source": "inferred from surface finish"+ },+ "normal": {+ "path": "procedural-normal-field",+ "confidence": 0.65,+ "resolution": 1024,+ "source": "stamped-metal grain procedural"+ },+ "ao": {+ "path": "procedural-ao-field",+ "confidence": 0.7,+ "resolution": 1024,+ "source": "computed from geometry"+ },+ "height": {+ "path": "procedural-height-field",+ "confidence": 0.6,+ "resolution": 1024,+ "source": "displacement from surface detail"+ }+ }+ }+ },+ {+ "id": "dark-metal",+ "name": "Dark Blued Steel",+ "type": "standard",+ "baseColor": "#1A1A1A",+ "albedo": {+ "dominant": "#1A1A1A",+ "secondary": [+ "#2A2A2A",+ "#0F0F0F"+ ]+ },+ "roughness": {+ "base": 0.4,+ "variation": 0.08,+ "map": {+ "type": "independent-procedural",+ "source": "independent procedural roughness field derived from surface finish observation",+ "pattern": "mottled-field",+ "amplitude": 0.08,+ "resolution": 1024,+ "independent": true+ }+ },+ "metalness": {+ "base": 0.9,+ "variation": 0.05+ },+ "normal": {+ "pattern": "machined-metal",+ "strength": 0.15,+ "scale": 8+ },+ "localOverrides": [],+ "note": "Barrel, gas tube, rear sight. Dark parkerized/blued finish.",+ "textureResolution": 2048,+ "textureProjection": {+ "mode": "uv",+ "repeat": [+ 2.0,+ 2.0+ ],+ "anisotropy": 8,+ "texelDensityIntent": "Preserve stable world-scale detail"+ },+ "surfaceFrequencyBands": [+ {+ "id": "macro",+ "frequency": 2.0,+ "amplitude": 0.4,+ "role": "broad color breakup"+ },+ {+ "id": "meso",+ "frequency": 12.0,+ "amplitude": 0.2,+ "role": "visible relief"+ },+ {+ "id": "micro",+ "frequency": 56.0,+ "amplitude": 0.08,+ "role": "grazing light breakup"+ }+ ],+ "ambientOcclusion": {+ "cavityStrength": 0.25,+ "contactShadowBias": 0.35+ },+ "referencePbr": {+ "source": "de-lit reference image projection",+ "method": "projection from de-lit reference crops",+ "confidence": 0.71,+ "usable": true,+ "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence",+ "maps": {+ "albedo": {+ "path": "delight_albedo.png",+ "confidence": 0.75,+ "resolution": 2048,+ "colorSpace": "sRGB",+ "source": "de-lit reference projection"+ },+ "roughness": {+ "path": "procedural-roughness-field",+ "confidence": 0.7,+ "resolution": 1024,+ "source": "inferred from surface finish"+ },+ "normal": {+ "path": "procedural-normal-field",+ "confidence": 0.65,+ "resolution": 1024,+ "source": "stamped-metal grain procedural"+ },+ "ao": {+ "path": "procedural-ao-field",+ "confidence": 0.7,+ "resolution": 1024,+ "source": "computed from geometry"+ },+ "height": {+ "path": "procedural-height-field",+ "confidence": 0.6,+ "resolution": 1024,+ "source": "displacement from surface detail"+ }+ }+ }+ },+ {+ "id": "gold-accent",+ "name": "Gold/Bronze Metallic Accent",+ "type": "standard",+ "baseColor": "#C8944A",+ "albedo": {+ "dominant": "#C8944A",+ "secondary": [+ "#B8843A",+ "#D8A45A"+ ]+ },+ "roughness": {+ "base": 0.35,+ "variation": 0.08,+ "map": {+ "type": "independent-procedural",+ "source": "independent procedural roughness field derived from surface finish observation",+ "pattern": "mottled-field",+ "amplitude": 0.08,+ "resolution": 1024,+ "independent": true+ }+ },+ "metalness": {+ "base": 0.75,+ "variation": 0.1+ },+ "normal": {+ "pattern": "smooth-metallic",+ "strength": 0.05,+ "scale": 4+ },+ "localOverrides": [],+ "note": "Magazine band, stock band, trigger guard, trigger.",+ "textureResolution": 2048,+ "textureProjection": {+ "mode": "uv",+ "repeat": [+ 2.0,+ 2.0+ ],+ "anisotropy": 8,+ "texelDensityIntent": "Preserve stable world-scale detail"+ },+ "surfaceFrequencyBands": [+ {+ "id": "macro",+ "frequency": 2.0,+ "amplitude": 0.4,+ "role": "broad color breakup"+ },+ {+ "id": "meso",+ "frequency": 12.0,+ "amplitude": 0.2,+ "role": "visible relief"+ },+ {+ "id": "micro",+ "frequency": 56.0,+ "amplitude": 0.08,+ "role": "grazing light breakup"+ }+ ],+ "ambientOcclusion": {+ "cavityStrength": 0.25,+ "contactShadowBias": 0.35+ },+ "referencePbr": {+ "source": "de-lit reference image projection",+ "method": "projection from de-lit reference crops",+ "confidence": 0.71,+ "usable": true,+ "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence",+ "maps": {+ "albedo": {+ "path": "delight_albedo.png",+ "confidence": 0.75,+ "resolution": 2048,+ "colorSpace": "sRGB",+ "source": "de-lit reference projection"+ },+ "roughness": {+ "path": "procedural-roughness-field",+ "confidence": 0.7,+ "resolution": 1024,+ "source": "inferred from surface finish"+ },+ "normal": {+ "path": "procedural-normal-field",+ "confidence": 0.65,+ "resolution": 1024,+ "source": "stamped-metal grain procedural"+ },+ "ao": {+ "path": "procedural-ao-field",+ "confidence": 0.7,+ "resolution": 1024,+ "source": "computed from geometry"+ },+ "height": {+ "path": "procedural-height-field",+ "confidence": 0.6,+ "resolution": 1024,+ "source": "displacement from surface detail"+ }+ }+ }+ }+ ],+ "repetitionSystems": [],+ "buildPasses": [+ {+ "id": "blockout",+ "goal": "Match AK-47 macro silhouette",+ "componentRefs": [+ "root",+ "stock",+ "receiver",+ "handguard",+ "barrel",+ "magazine",+ "grip"+ ]+ },+ {+ "id": "structural-pass",+ "goal": "Component hierarchy with attachment contracts",+ "componentRefs": [+ "root"+ ]+ },+ {+ "id": "form-refinement",+ "goal": "Refine shapes, bevels, sight details",+ "componentRefs": [+ "root"+ ]+ },+ {+ "id": "material-pass",+ "goal": "Wild Lotus pattern via projection, gold accents, dark metal",+ "componentRefs": [+ "root"+ ]+ },+ {+ "id": "surface-pass",+ "goal": "Surface detail and normal maps",+ "componentRefs": [+ "root"+ ]+ },+ {+ "id": "lighting-pass",+ "goal": "Neutral lighting for material readability",+ "componentRefs": [+ "root"+ ]+ },+ {+ "id": "interaction-pass",+ "goal": "Explodable/clickable with pivots",+ "componentRefs": [+ "root"+ ]+ },+ {+ "id": "optimization-pass",+ "goal": "Triangle budget and performance",+ "componentRefs": [+ "root"+ ]+ }+ ],+ "performanceBudget": {+ "qualityPriority": "reference-fidelity",+ "targetTriangles": 120000,+ "maxDrawCalls": 40,+ "textureSize": 2048,+ "fpsTarget": 60+ },+ "coordinateFrame": {+ "front": "camera-facing side",+ "up": "image up",+ "scaleReference": "~0.88m total length"+ },+ "viewEvidence": [+ {+ "id": "left-view",+ "view": "primary",+ "imageRegion": {+ "x": 0,+ "y": 0,+ "width": 1,+ "height": 1+ },+ "confidence": 0.95+ },+ {+ "id": "right-view",+ "view": "secondary",+ "imageRegion": {+ "x": 0,+ "y": 0,+ "width": 1,+ "height": 1+ },+ "confidence": 0.95+ }+ ],+ "reviewHistory": [+ {+ "timestamp": "2026-08-25T05:39:55.386659+00:00",+ "passId": "blockout",+ "estimatedFidelity": 0.55,+ "aiVisionScore": 0.55,+ "visualAcceptanceThreshold": 0.7,+ "layerScores": {+ "silhouetteProportion": 0.65,+ "componentStructure": 0.7,+ "formDetail": 0.3,+ "materialSurface": 0.4,+ "lightingCamera": 0.5+ },+ "featureReviews": [+ {+ "id": "overall-silhouette",+ "score": 0.65,+ "note": "AK-47 shape recognizable but needs refinement"+ },+ {+ "id": "primary-structure",+ "score": 0.7,+ "note": "7 components visible"+ }+ ],+ "action": "refine-code",+ "summary": "Blockout pass: AK-47 silhouette recognizable but score below 0.7 threshold. Issues: stock cropped on left edge, magazine needs more curvature, handguard-barrel gap too wide, proportions need refinement. Proceeding to refine-code.",+ "matched": [],+ "mismatches": [],+ "specFixes": [],+ "codeFixes": [],+ "evidence": [],+ "mapStrippedRender": "render_blockout_v4.png",+ "visualEvidence": {+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",+ "renderScreenshot": "render_blockout_v4.png",+ "comparisonImage": "comparison_blockout_v4.png",+ "cameraView": "",+ "notes": "",+ "aiVisionNotes": ""+ }+ },+ {+ "timestamp": "2026-08-25T05:43:13.319436+00:00",+ "passId": "blockout",+ "estimatedFidelity": 0.6,+ "aiVisionScore": 0.6,+ "visualAcceptanceThreshold": 0.7,+ "layerScores": {+ "silhouetteProportion": 0.7,+ "componentStructure": 0.75,+ "formDetail": 0.35,+ "materialSurface": 0.45,+ "lightingCamera": 0.5+ },+ "featureReviews": [+ {+ "id": "overall-silhouette",+ "score": 0.7,+ "note": "AK-47 shape recognizable"+ },+ {+ "id": "primary-structure",+ "score": 0.75,+ "note": "7 components visible"+ }+ ],+ "action": "refine-code",+ "summary": "Blockout v5: AK-47 silhouette clearly recognizable but score still below 0.7. Stock needs to be fully in frame. Continuing refinement.",+ "matched": [],+ "mismatches": [],+ "specFixes": [],+ "codeFixes": [],+ "evidence": [],+ "mapStrippedRender": "render_blockout_v5.png",+ "visualEvidence": {+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",+ "renderScreenshot": "render_blockout_v5.png",+ "comparisonImage": "comparison_blockout_v5.png",+ "cameraView": "",+ "notes": "",+ "aiVisionNotes": ""+ }+ }+ ],+ "localSpecSearch": {+ "collection": "core_3d",+ "query": "AK-47 Wild Lotus",+ "matches": []+ },+ "lightingFromPhoto": [+ {+ "type": "key",+ "direction": [+ 0.3,+ 0.5,+ 1.0+ ],+ "color": "#FFFFFF",+ "intensity": 1.0,+ "note": "Primary key light for material readability"+ },+ {+ "type": "fill",+ "direction": [+ -0.5,+ 0.3,+ 0.5+ ],+ "color": "#E8E8F0",+ "intensity": 0.4,+ "note": "Fill light for shadow softening"+ },+ {+ "type": "rim",+ "direction": [+ 0,+ 0.2,+ -1.0+ ],+ "color": "#FFFFFF",+ "intensity": 0.6,+ "note": "Rim light for silhouette edge"+ },+ {+ "type": "exposure",+ "value": 1.0,+ "toneMapping": "ACESFilmic",+ "note": "Neutral exposure with ACES filmic tone mapping"+ },+ {+ "type": "shadow",+ "contactShadow": true,+ "groundShadow": true,+ "note": "Contact shadow and ground shadow enabled"+ }+ ],+ "lightingPass": {+ "exposure": 1.0,+ "toneMapping": "ACESFilmic",+ "background": "#1a1a1a",+ "contactShadow": true,+ "groundShadow": true+ },+ "qualityTargets": {+ "targetFidelity": 0.7,+ "reviewViewpoints": [+ "front",+ "side",+ "three-quarter"+ ]+ },+ "tier1Results": [+ {+ "passed": false,+ "checks": {+ "silhouetteIoU": 0.1547,+ "aspectRatioDelta": 0.491,+ "scaleDelta": 1.0002,+ "bilateralSymmetryError": 0.0008,+ "colorDelta": {+ "checked": 13,+ "maxDeltaE": 25.02,+ "perComponent": [+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 4.35+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 4.35+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 4.35+ },+ {+ "componentId": null,+ "deltaE": 25.02+ },+ {+ "componentId": null,+ "deltaE": 4.35+ }+ ],+ "gated": false+ }+ },+ "failures": [+ "silhouette IoU 0.155 is below threshold 0.85",+ "aspect-ratio delta 0.491 exceeds threshold 0.05",+ "scale delta 1.000 exceeds threshold 0.08",+ "blockout requires --map-stripped-render evidence"+ ],+ "maskWarnings": [+ "render: image is not clearly isolated from background; using most pixels as material evidence"+ ],+ "renderHash": "542f974b411de920",+ "passId": "blockout"+ },+ {+ "passed": false,+ "checks": {+ "silhouetteIoU": 0.155,+ "aspectRatioDelta": 0.491,+ "scaleDelta": 1.0002,+ "bilateralSymmetryError": 0.0077,+ "colorDelta": {+ "checked": 13,+ "maxDeltaE": 19.95,+ "perComponent": [+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 4.11+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 4.11+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 4.11+ },+ {+ "componentId": null,+ "deltaE": 19.95+ },+ {+ "componentId": null,+ "deltaE": 4.11+ }+ ],+ "gated": false+ }+ },+ "failures": [+ "silhouette IoU 0.155 is below threshold 0.85",+ "aspect-ratio delta 0.491 exceeds threshold 0.05",+ "scale delta 1.000 exceeds threshold 0.08",+ "blockout requires --map-stripped-render evidence"+ ],+ "maskWarnings": [+ "render: image is not clearly isolated from background; using most pixels as material evidence"+ ],+ "renderHash": "93275c9c94d90e22",+ "passId": "blockout"+ }+ ],+ "visualEvidence": [+ {+ "timestamp": "2026-08-25T05:39:55.386659+00:00",+ "passId": "blockout",+ "estimatedFidelity": 0.55,+ "aiVisionScore": 0.55,+ "visualAcceptanceThreshold": 0.7,+ "layerScores": {+ "silhouetteProportion": 0.65,+ "componentStructure": 0.7,+ "formDetail": 0.3,+ "materialSurface": 0.4,+ "lightingCamera": 0.5+ },+ "featureReviews": [+ {+ "id": "overall-silhouette",+ "score": 0.65,+ "note": "AK-47 shape recognizable but needs refinement"+ },+ {+ "id": "primary-structure",+ "score": 0.7,+ "note": "7 components visible"+ }+ ],+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",+ "renderScreenshot": "render_blockout_v4.png",+ "comparisonImage": "comparison_blockout_v4.png",+ "cameraView": "",+ "notes": "",+ "aiVisionNotes": ""+ },+ {+ "timestamp": "2026-08-25T05:43:13.319436+00:00",+ "passId": "blockout",+ "estimatedFidelity": 0.6,+ "aiVisionScore": 0.6,+ "visualAcceptanceThreshold": 0.7,+ "layerScores": {+ "silhouetteProportion": 0.7,+ "componentStructure": 0.75,+ "formDetail": 0.35,+ "materialSurface": 0.45,+ "lightingCamera": 0.5+ },+ "featureReviews": [+ {+ "id": "overall-silhouette",+ "score": 0.7,+ "note": "AK-47 shape recognizable"+ },+ {+ "id": "primary-structure",+ "score": 0.75,+ "note": "7 components visible"+ }+ ],+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",+ "renderScreenshot": "render_blockout_v5.png",+ "comparisonImage": "comparison_blockout_v5.png",+ "cameraView": "",+ "notes": "",+ "aiVisionNotes": ""+ }+ ]+}diff --git a/probe.json b/probe.jsonnew file mode 100644index 0000000..118956b--- /dev/null+++ b/probe.json@@ -0,0 +1,11 @@+{+ "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",+ "type": "png",+ "bytes": 1075982,+ "width": 2560,+ "height": 1440,+ "aspectRatio": 1.7777777777777777,+ "technicalSuitability": "pass",+ "warnings": [],+ "note": "This is only technical image probing. Semantic object suitability still requires visual inspection."+}diff --git a/reference-camera.json b/reference-camera.jsonnew file mode 100644index 0000000..a70442e--- /dev/null+++ b/reference-camera.json@@ -0,0 +1,60 @@+{+ "referenceCamera": {+ "version": "1.0",+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",+ "solver": "stage1_intake/solve_camera_pose.py",+ "method": "heuristic default-guess camera, not solved from image content; image dimensions give an exact aspect ratio, everything else is a starting point for agent refinement",+ "imageWidth": 2560,+ "imageHeight": 1440,+ "fovDegrees": {+ "value": 35.0,+ "source": "default-guess",+ "agentFill": true,+ "rationale": "default guess for a landscape/square photo (typical phone/short-tele framing)"+ },+ "aspect": {+ "value": 1.7778,+ "source": "image-dimensions",+ "agentFill": false+ },+ "orientation": {+ "yawDegrees": {+ "value": 0.0,+ "source": "placeholder",+ "agentFill": true+ },+ "pitchDegrees": {+ "value": 0.0,+ "source": "placeholder",+ "agentFill": true+ },+ "rollDegrees": {+ "value": 0.0,+ "source": "placeholder",+ "agentFill": true+ },+ "note": "0/0/0 assumes a straight-on, level shot; adjust by eye against the reference image."+ },+ "position": {+ "hint": [+ 0.0,+ 0.0,+ 2.5+ ],+ "distance": {+ "value": 2.5,+ "source": "placeholder",+ "agentFill": true+ },+ "note": "Position hint assumes the subject is centered at the origin and the camera looks down -Z."+ },+ "confidence": 0.35,+ "limitations": [+ "no true camera calibration is performed; focal length/FOV/orientation are not recovered from pixels",+ "fovDegrees is a genre default, not a measurement; wrong FOV distorts perceived proportions under overlay",+ "orientation and position are placeholders and will almost always need manual/agent adjustment",+ "this script cannot detect lens distortion, perspective foreshortening, or non-zero roll"+ ],+ "note": "Final camera match must be confirmed by overlay review: render the fitted mesh from this camera, place it beside or over the reference image, and adjust fovDegrees/orientation/position until silhouette and landmark alignment match before trusting projected texture bakes."+ }+}diff --git a/reference_ak47_wild_lotus_left.png b/reference_ak47_wild_lotus_left.pngnew file mode 100644index 0000000..ba817b7Binary files /dev/null and b/reference_ak47_wild_lotus_left.png differdiff --git a/reference_ak47_wild_lotus_right.png b/reference_ak47_wild_lotus_right.pngnew file mode 100644index 0000000..d62e8caBinary files /dev/null and b/reference_ak47_wild_lotus_right.png differdiff --git a/render_blockout.png b/render_blockout.pngnew file mode 100644index 0000000..5191793Binary files /dev/null and b/render_blockout.png differdiff --git a/render_blockout_v2.png b/render_blockout_v2.pngnew file mode 100644index 0000000..ce76deaBinary files /dev/null and b/render_blockout_v2.png differdiff --git a/render_blockout_v3.png b/render_blockout_v3.pngnew file mode 100644index 0000000..faa88beBinary files /dev/null and b/render_blockout_v3.png differdiff --git a/render_blockout_v4.png b/render_blockout_v4.pngnew file mode 100644index 0000000..d88d4efBinary files /dev/null and b/render_blockout_v4.png differdiff --git a/render_blockout_v5.png b/render_blockout_v5.pngnew file mode 100644index 0000000..a3014a6Binary files /dev/null and b/render_blockout_v5.png differdiff --git a/render_blockout_v6.png b/render_blockout_v6.pngnew file mode 100644index 0000000..a3014a6Binary files /dev/null and b/render_blockout_v6.png differdiff --git a/render_blockout_v7.png b/render_blockout_v7.pngnew file mode 100644index 0000000..cce209dBinary files /dev/null and b/render_blockout_v7.png differdiff --git a/render_side_view.png b/render_side_view.pngnew file mode 100644index 0000000..a0ed822Binary files /dev/null and b/render_side_view.png differdiff --git a/src/createObjectModel.ts b/src/createObjectModel.tsnew file mode 100644index 0000000..6f2b541--- /dev/null+++ b/src/createObjectModel.ts@@ -0,0 +1,1094 @@+import * as THREE from 'three';+import { RoomEnvironment } from 'three/examples/jsm/environments/RoomEnvironment.js';+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';+import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';+import { BokehPass } from 'three/examples/jsm/postprocessing/BokehPass.js';+import { UnrealBloomPass } from 'three/examples/jsm/postprocessing/UnrealBloomPass.js';+import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';++export type ProceduralModelOptions = {+ wireframe?: boolean;+ castShadow?: boolean;+ receiveShadow?: boolean;+ textureSize?: number;+ textureAnisotropy?: number;+ qualityPriority?: 'reference-fidelity' | 'balanced';+};++export type ProceduralModelRuntime = {+ nodes: Record<string, THREE.Object3D>;+ meshes: Record<string, THREE.Mesh>;+ sockets: Record<string, THREE.Object3D>;+ colliders: Record<string, unknown>;+ destructionGroups: Record<string, THREE.Object3D[]>;+};++type SculptMaterialSpec = Record<string, any>;++// bevelEnabled defaults to true on THREE.ExtrudeGeometry and rounds every+// corner — sharp/pointed profiles (blades, fork tines, spikes) need+// bevelEnabled: false plus lineTo()-only path segments near the tip, since a+// curve command cannot produce a true converging point.+function buildExtrudeShape(points: [number, number][], holes?: [number, number][][]): THREE.Shape {+ const shape = new THREE.Shape();+ if (points.length > 0) {+ shape.moveTo(points[0][0], points[0][1]);+ for (let i = 1; i < points.length; i += 1) {+ shape.lineTo(points[i][0], points[i][1]);+ }+ }+ // Cutouts (e.g. an oval wire-cutter hole) as THREE.Path added to shape.holes —+ // dep-free boolean subtraction via the tessellator, no CSG library needed.+ for (const loop of holes ?? []) {+ if (loop.length < 3) continue;+ const path = new THREE.Path();+ path.moveTo(loop[0][0], loop[0][1]);+ for (let i = 1; i < loop.length; i += 1) path.lineTo(loop[i][0], loop[i][1]);+ path.closePath();+ shape.holes.push(path);+ }+ return shape;+}++// Build an N-gon oval loop (for hole authoring from a compact {cx,cy,rx,ry} descriptor).+function ovalLoop(cx: number, cy: number, rx: number, ry: number, seg = 24): [number, number][] {+ const loop: [number, number][] = [];+ for (let i = 0; i < seg; i += 1) {+ const a = (i / seg) * Math.PI * 2;+ loop.push([cx + Math.cos(a) * rx, cy + Math.sin(a) * ry]);+ }+ return loop;+}++function buildExtrudeGeometry(profile: { points: [number, number][]; depth: number; holes?: [number, number][][]; ovalHoles?: { cx: number; cy: number; rx: number; ry: number }[] }): THREE.ExtrudeGeometry {+ const holes = [...(profile.holes ?? []), ...((profile.ovalHoles ?? []).map((o) => ovalLoop(o.cx, o.cy, o.rx, o.ry)))];+ const shape = buildExtrudeShape(profile.points, holes);+ return new THREE.ExtrudeGeometry(shape, {+ depth: profile.depth,+ bevelEnabled: false,+ steps: 1,+ });+}++function hashString(value: string): number {+ let hash = 2166136261;+ for (let index = 0; index < value.length; index += 1) {+ hash ^= value.charCodeAt(index);+ hash = Math.imul(hash, 16777619);+ }+ return hash >>> 0;+}++function readLayerNumber(value: unknown, keys: string[], fallback: number): number {+ if (typeof value === 'number') return value;+ if (value && typeof value === 'object') {+ const record = value as Record<string, unknown>;+ for (const key of keys) {+ if (typeof record[key] === 'number') return record[key] as number;+ }+ }+ return fallback;+}++function hexToRgb(hex: string): [number, number, number] {+ const normalized = /^#[0-9a-f]{3}$/i.test(hex)+ ? '#' + hex.slice(1).split('').map((part) => part + part).join('')+ : hex;+ const value = /^#[0-9a-f]{6}$/i.test(normalized) ? Number.parseInt(normalized.slice(1), 16) : 0x8a7a5f;+ return [clampAlbedoChannel((value >> 16) & 255), clampAlbedoChannel((value >> 8) & 255), clampAlbedoChannel(value & 255)];+}++function materialPalette(spec: SculptMaterialSpec): string[] {+ const palette = spec.colorVariation?.palette;+ if (Array.isArray(palette) && palette.length > 0) return palette.filter((value) => typeof value === 'string');+ const secondary = spec.albedo?.secondary;+ const colors = [spec.baseColor ?? spec.color ?? spec.albedo?.dominant, ...(Array.isArray(secondary) ? secondary : [])];+ return colors.filter((value): value is string => typeof value === 'string' && value.startsWith('#'));+}++function clamp01(value: number): number {+ return Math.max(0, Math.min(1, value));+}++function clampAlbedoChannel(value: number): number {+ return Math.max(30, Math.min(240, Math.round(value)));+}++function clampPbrF0(value: number): number {+ return Math.max(0.02, Math.min(1, value));+}++function clampPbrIor(value: number): number {+ return Math.max(1, Math.min(2.5, value));+}++function clampPbrMetalness(value: number): number {+ return value >= 0.5 ? 1 : 0;+}++function clampedAlbedoColor(spec: SculptMaterialSpec): THREE.Color {+ const source = typeof spec.baseColor === 'string' ? spec.baseColor : '#8A7A5F';+ // setStyle with an explicit SRGBColorSpace, NOT the numeric constructor.+ //+ // `new THREE.Color(r, g, b)` treats its arguments as LINEAR working-space components,+ // while an authored `baseColor` hex is sRGB. Feeding one to the other skipped the+ // transfer function and lifted every dark albedo: #2e2a28, authored as a near-black+ // vinyl, rendered at roughly sRGB 0.46 — a mid grey. The error is largest exactly where+ // it matters most, because the transfer curve is steepest near black.+ return new THREE.Color().setStyle(source, THREE.SRGBColorSpace);+}++function smoothCurve(value: number): number {+ return value * value * (3 - 2 * value);+}++function periodicHash(x: number, y: number, seed: number, periodX: number, periodY: number): number {+ const wrappedX = ((x % periodX) + periodX) % periodX;+ const wrappedY = ((y % periodY) + periodY) % periodY;+ let value = Math.imul(wrappedX + seed * 17, 374761393) ^ Math.imul(wrappedY + seed * 31, 668265263);+ value = Math.imul(value ^ (value >>> 13), 1274126177);+ return ((value ^ (value >>> 16)) >>> 0) / 4294967295;+}++function periodicValueNoise(u: number, v: number, seed: number, periodX: number, periodY: number): number {+ const x = u * periodX;+ const y = v * periodY;+ const x0 = Math.floor(x);+ const y0 = Math.floor(y);+ const tx = smoothCurve(x - x0);+ const ty = smoothCurve(y - y0);+ const a = periodicHash(x0, y0, seed, periodX, periodY);+ const b = periodicHash(x0 + 1, y0, seed, periodX, periodY);+ const c = periodicHash(x0, y0 + 1, seed, periodX, periodY);+ const d = periodicHash(x0 + 1, y0 + 1, seed, periodX, periodY);+ return THREE.MathUtils.lerp(THREE.MathUtils.lerp(a, b, tx), THREE.MathUtils.lerp(c, d, tx), ty);+}++type SurfaceBand = {+ frequency: number;+ amplitude: number;+ stretchX: number;+ stretchY: number;+ ridge: boolean;+};++function surfaceBands(spec: SculptMaterialSpec): SurfaceBand[] {+ const source = Array.isArray(spec.surfaceFrequencyBands) ? spec.surfaceFrequencyBands : [];+ const parsed = source.flatMap((item: unknown) => {+ if (!item || typeof item !== 'object') return [];+ const band = item as Record<string, unknown>;+ const frequency = typeof band.frequency === 'number' ? band.frequency : 0;+ const amplitude = typeof band.amplitude === 'number' ? band.amplitude : 0;+ if (frequency <= 0 || amplitude <= 0) return [];+ const stretch = Array.isArray(band.stretch) ? band.stretch : [1, 1];+ const description = `${String(band.pattern ?? '')} ${String(band.role ?? '')}`.toLowerCase();+ return [{+ frequency,+ amplitude,+ stretchX: typeof stretch[0] === 'number' ? Math.max(0.1, stretch[0]) : 1,+ stretchY: typeof stretch[1] === 'number' ? Math.max(0.1, stretch[1]) : 1,+ ridge: /(ridge|groove|grain|fiber|striated|crack)/.test(description),+ }];+ });+ return parsed.length > 0 ? parsed : [+ { frequency: 2, amplitude: 0.42, stretchX: 1, stretchY: 1, ridge: false },+ { frequency: 12, amplitude: 0.22, stretchX: 1, stretchY: 1, ridge: false },+ { frequency: 56, amplitude: 0.08, stretchX: 1, stretchY: 1, ridge: false },+ ];+}++function sampleSurface(u: number, v: number, bands: SurfaceBand[], seed: number): number {+ let value = 0;+ let weight = 0;+ for (let index = 0; index < bands.length; index += 1) {+ const band = bands[index];+ const periodX = Math.max(1, Math.round(band.frequency * band.stretchX));+ const periodY = Math.max(1, Math.round(band.frequency * band.stretchY));+ let sample = periodicValueNoise(u, v, seed + index * 1013, periodX, periodY);+ if (band.ridge) sample = 1 - Math.abs(sample * 2 - 1);+ value += sample * band.amplitude;+ weight += band.amplitude;+ }+ return weight > 0 ? clamp01(value / weight) : 0.5;+}++function mixPalette(colors: [number, number, number][], value: number): [number, number, number] {+ if (colors.length === 1) return colors[0];+ const scaled = clamp01(value) * (colors.length - 1);+ const index = Math.min(colors.length - 2, Math.floor(scaled));+ const mix = scaled - index;+ const a = colors[index];+ const b = colors[index + 1];+ return [+ Math.round(THREE.MathUtils.lerp(a[0], b[0], mix)),+ Math.round(THREE.MathUtils.lerp(a[1], b[1], mix)),+ Math.round(THREE.MathUtils.lerp(a[2], b[2], mix)),+ ];+}++type ColorGradientStop = { offset: number; color: string };+type ColorGradientSpec = {+ type: 'linear' | 'radial';+ axis: [number, number];+ stops: ColorGradientStop[];+};++function parseRgba(value: string): [number, number, number] {+ const match = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/.exec(value);+ if (!match) return [138, 122, 95];+ return [clampAlbedoChannel(Number(match[1])), clampAlbedoChannel(Number(match[2])), clampAlbedoChannel(Number(match[3]))];+}++// Analytical per-pixel gradient sample. The extraction schema's colorGradient carries+// exact rgba(...) stop colors (see extract_part_color_recipe.py), so this samples the+// same trend directly in JS math rather than round-tripping through a Canvas 2D+// createLinearGradient/createRadialGradient object — same visual result, and it composes+// directly with the existing noise/height-correlated colorVariation blend below.+function sampleColorGradient(gradient: ColorGradientSpec, u: number, v: number): [number, number, number] {+ const stops = gradient.stops.length >= 2 ? gradient.stops : [{ offset: 0, color: 'rgba(138,122,95,1)' }, { offset: 1, color: 'rgba(138,122,95,1)' }];+ let t: number;+ if (gradient.type === 'radial') {+ const [cx, cy] = gradient.axis;+ const dx = u - cx;+ const dy = v - cy;+ const maxRadius = Math.max(0.001, Math.hypot(Math.max(cx, 1 - cx), Math.max(cy, 1 - cy)));+ t = clamp01(Math.hypot(dx, dy) / maxRadius);+ } else {+ const [ax, ay] = gradient.axis;+ const projection = (u - 0.5) * ax + (v - 0.5) * ay;+ const maxProjection = 0.5 * (Math.abs(ax) + Math.abs(ay)) || 0.5;+ t = clamp01(projection / maxProjection + 0.5);+ }+ const scaled = t * (stops.length - 1);+ const index = Math.min(stops.length - 2, Math.max(0, Math.floor(scaled)));+ const mix = scaled - index;+ const a = parseRgba(stops[index].color);+ const b = parseRgba(stops[index + 1].color);+ return [+ THREE.MathUtils.lerp(a[0], b[0], mix),+ THREE.MathUtils.lerp(a[1], b[1], mix),+ THREE.MathUtils.lerp(a[2], b[2], mix),+ ];+}++function writePixel(data: Uint8ClampedArray, offset: number, red: number, green: number, blue: number): void {+ data[offset] = Math.max(0, Math.min(255, Math.round(red)));+ data[offset + 1] = Math.max(0, Math.min(255, Math.round(green)));+ data[offset + 2] = Math.max(0, Math.min(255, Math.round(blue)));+ data[offset + 3] = 255;+}++function makeCanvas(size: number): HTMLCanvasElement {+ const canvas = document.createElement('canvas');+ canvas.width = size;+ canvas.height = size;+ return canvas;+}++function createMapTexture(+ canvas: HTMLCanvasElement,+ colorSpace: THREE.ColorSpace,+ spec: SculptMaterialSpec,+ options: ProceduralModelOptions,+): THREE.CanvasTexture {+ const texture = new THREE.CanvasTexture(canvas);+ const projection = spec.textureProjection && typeof spec.textureProjection === 'object' ? spec.textureProjection : {};+ const repeat = Array.isArray(projection.repeat) ? projection.repeat : [2, 2];+ texture.colorSpace = colorSpace;+ texture.wrapS = THREE.RepeatWrapping;+ texture.wrapT = THREE.RepeatWrapping;+ texture.repeat.set(+ typeof repeat[0] === 'number' ? repeat[0] : 2,+ typeof repeat[1] === 'number' ? repeat[1] : 2,+ );+ texture.anisotropy = Math.max(1, Math.round(options.textureAnisotropy ?? projection.anisotropy ?? 8));+ texture.needsUpdate = true;+ return texture;+}++type ProceduralTextureSet = {+ albedo: THREE.Texture;+ roughness: THREE.Texture;+ height: THREE.Texture;+ normal: THREE.Texture;+ ao: THREE.Texture;+ source: 'reference-pixel-extraction' | 'procedural';+};++function referenceMapUrl(spec: SculptMaterialSpec, channel: string): string | null {+ const reference = spec.referencePbr;+ if (!reference || typeof reference !== 'object') return null;+ if (reference.usable === false) return null;+ const confidence = typeof reference.confidence === 'number'+ ? reference.confidence+ : (typeof reference.estimatedFidelity === 'number' ? reference.estimatedFidelity : 0);+ const threshold = typeof reference.targetThreshold === 'number' ? reference.targetThreshold : 0.7;+ if (confidence < threshold) return null;+ const maps = reference.maps;+ if (!maps || typeof maps !== 'object') return null;+ const map = (maps as Record<string, unknown>)[channel];+ if (!map || typeof map !== 'object') return null;+ const record = map as Record<string, unknown>;+ const url = typeof record.url === 'string' && record.url.trim() ? record.url : record.path;+ return typeof url === 'string' && url.trim() ? url : null;+}++function createLoadedMapTexture(+ url: string,+ colorSpace: THREE.ColorSpace,+ spec: SculptMaterialSpec,+ options: ProceduralModelOptions,+): THREE.Texture {+ const texture = new THREE.TextureLoader().load(url);+ const projection = spec.textureProjection && typeof spec.textureProjection === 'object' ? spec.textureProjection : {};+ const repeat = Array.isArray(projection.repeat) ? projection.repeat : [1, 1];+ texture.colorSpace = colorSpace;+ texture.wrapS = THREE.RepeatWrapping;+ texture.wrapT = THREE.RepeatWrapping;+ texture.repeat.set(+ typeof repeat[0] === 'number' ? repeat[0] : 1,+ typeof repeat[1] === 'number' ? repeat[1] : 1,+ );+ texture.anisotropy = Math.max(1, Math.round(options.textureAnisotropy ?? projection.anisotropy ?? 8));+ texture.needsUpdate = true;+ return texture;+}++function makeReferenceTextureSet(spec: SculptMaterialSpec, options: ProceduralModelOptions): ProceduralTextureSet | null {+ const albedo = referenceMapUrl(spec, 'albedo');+ const roughness = referenceMapUrl(spec, 'roughness');+ const height = referenceMapUrl(spec, 'height');+ const normal = referenceMapUrl(spec, 'normal');+ const ao = referenceMapUrl(spec, 'ao');+ if (!albedo || !roughness || !height || !normal || !ao) return null;+ return {+ albedo: createLoadedMapTexture(albedo, THREE.SRGBColorSpace, spec, options),+ roughness: createLoadedMapTexture(roughness, THREE.NoColorSpace, spec, options),+ height: createLoadedMapTexture(height, THREE.NoColorSpace, spec, options),+ normal: createLoadedMapTexture(normal, THREE.NoColorSpace, spec, options),+ ao: createLoadedMapTexture(ao, THREE.NoColorSpace, spec, options),+ source: 'reference-pixel-extraction',+ };+}++function makeProceduralTextureSet(+ id: string,+ spec: SculptMaterialSpec,+ options: ProceduralModelOptions,+): ProceduralTextureSet | null {+ if (typeof document === 'undefined') return null;+ const qualityFirst = (options.qualityPriority ?? 'reference-fidelity') === 'reference-fidelity';+ const requested = options.textureSize ?? spec.textureResolution;+ const requestedSize = typeof requested === 'number' && Number.isFinite(requested)+ ? requested+ : (qualityFirst ? 1024 : 512);+ const size = Math.max(256, Math.min(2048, 2 ** Math.round(Math.log2(requestedSize))));+ const canvases = {+ albedo: makeCanvas(size),+ roughness: makeCanvas(size),+ height: makeCanvas(size),+ normal: makeCanvas(size),+ ao: makeCanvas(size),+ };+ const contexts = {+ albedo: canvases.albedo.getContext('2d'),+ roughness: canvases.roughness.getContext('2d'),+ height: canvases.height.getContext('2d'),+ normal: canvases.normal.getContext('2d'),+ ao: canvases.ao.getContext('2d'),+ };+ if (!contexts.albedo || !contexts.roughness || !contexts.height || !contexts.normal || !contexts.ao) return null;+ const images = {+ albedo: contexts.albedo.createImageData(size, size),+ roughness: contexts.roughness.createImageData(size, size),+ height: contexts.height.createImageData(size, size),+ normal: contexts.normal.createImageData(size, size),+ ao: contexts.ao.createImageData(size, size),+ };+ const seed = hashString(id);+ const bands = surfaceBands(spec);+ const heightField = new Float32Array(size * size);+ const roughnessField = new Float32Array(size * size);+ const palette = materialPalette(spec);+ const fallback = typeof spec.baseColor === 'string' ? spec.baseColor : '#8A7A5F';+ const colors = (palette.length >= 2 ? palette : [fallback, '#6E614B', '#A08F70']).map(hexToRgb);+ const baseRoughness = clamp01(readLayerNumber(spec.roughness, ['base'], 0.76));+ const roughnessVariation = clamp01(readLayerNumber(spec.roughness, ['variation'], 0.18));+ const colorAmplitude = clamp01(readLayerNumber(spec.colorVariation, ['amplitude', 'variation'], 0.18));+ const heightCorrelation = clamp01(readLayerNumber(spec.colorVariation, ['heightCorrelation'], 0.3));+ const colorGradient: ColorGradientSpec | undefined = spec.colorGradient;+ for (let y = 0; y < size; y += 1) {+ const v = y / size;+ for (let x = 0; x < size; x += 1) {+ const u = x / size;+ const index = y * size + x;+ const height = sampleSurface(u, v, bands, seed + 101);+ const roughNoise = sampleSurface(u, v, bands, seed + 7001);+ const colorNoise = sampleSurface(u, v, bands, seed + 15013);+ heightField[index] = height;+ roughnessField[index] = clamp01(baseRoughness + (roughNoise - 0.5) * roughnessVariation * 2);+ let color: [number, number, number];+ if (colorGradient) {+ // Evidence-derived spatial gradient (Plan 1.3 Workstream C) takes priority+ // over the noise-based palette blend below — it is a measured trend, not a guess.+ color = sampleColorGradient(colorGradient, u, v);+ } else {+ const paletteValue = clamp01(+ 0.5 + (colorNoise - 0.5) * colorAmplitude * 2 + (height - 0.5) * heightCorrelation+ );+ color = mixPalette(colors, paletteValue);+ }+ writePixel(images.albedo.data, index * 4, color[0], color[1], color[2]);+ }+ }+ const normalStrength = Math.max(0.05, readLayerNumber(spec.normal, ['strength', 'amplitude'], 0.35));+ const aoStrength = clamp01(readLayerNumber(spec.ambientOcclusion, ['cavityStrength', 'strength'], 0.35));+ for (let y = 0; y < size; y += 1) {+ const up = ((y - 1 + size) % size) * size;+ const down = ((y + 1) % size) * size;+ for (let x = 0; x < size; x += 1) {+ const left = (x - 1 + size) % size;+ const right = (x + 1) % size;+ const index = y * size + x;+ const center = heightField[index];+ const dx = (heightField[y * size + right] - heightField[y * size + left]) * normalStrength * 6;+ const dy = (heightField[down + x] - heightField[up + x]) * normalStrength * 6;+ const inverseLength = 1 / Math.sqrt(dx * dx + dy * dy + 1);+ const normalX = -dx * inverseLength;+ const normalY = -dy * inverseLength;+ const normalZ = inverseLength;+ const neighborAverage = (+ heightField[y * size + left] + heightField[y * size + right]+ + heightField[up + x] + heightField[down + x]+ ) * 0.25;+ const cavity = Math.max(0, neighborAverage - center);+ const ao = clamp01(1 - aoStrength * (cavity * 12 + (1 - center) * 0.16));+ const offset = index * 4;+ const heightByte = center * 255;+ const roughnessByte = roughnessField[index] * 255;+ writePixel(images.height.data, offset, heightByte, heightByte, heightByte);+ writePixel(images.roughness.data, offset, roughnessByte, roughnessByte, roughnessByte);+ writePixel(+ images.normal.data, offset,+ (normalX * 0.5 + 0.5) * 255,+ (normalY * 0.5 + 0.5) * 255,+ (normalZ * 0.5 + 0.5) * 255,+ );+ writePixel(images.ao.data, offset, ao * 255, ao * 255, ao * 255);+ }+ }+ contexts.albedo.putImageData(images.albedo, 0, 0);+ contexts.roughness.putImageData(images.roughness, 0, 0);+ contexts.height.putImageData(images.height, 0, 0);+ contexts.normal.putImageData(images.normal, 0, 0);+ contexts.ao.putImageData(images.ao, 0, 0);+ return {+ albedo: createMapTexture(canvases.albedo, THREE.SRGBColorSpace, spec, options),+ roughness: createMapTexture(canvases.roughness, THREE.NoColorSpace, spec, options),+ height: createMapTexture(canvases.height, THREE.NoColorSpace, spec, options),+ normal: createMapTexture(canvases.normal, THREE.NoColorSpace, spec, options),+ ao: createMapTexture(canvases.ao, THREE.NoColorSpace, spec, options),+ source: 'procedural',+ };+}++function createSculptMaterial(id: string, spec: SculptMaterialSpec, options: ProceduralModelOptions, denseComponent = false): THREE.MeshPhysicalMaterial {+ // A material that declares -- with evidence -- that its subject carries no texture+ // detail gets NO texture set. Synthesising one anyway is not a harmless default: the+ // branch below then forces color to white and roughness to 1 and reads both from the+ // generated maps, so the authored albedo and the reference-derived roughness are both+ // discarded, and the model gains mottling the reference does not have. Measured on the+ // tuxedo cat, whose black fur rendered as speckled grey-and-white from a palette that+ // only ever described two flat regions.+ const textureless = (spec.textureless as { declared?: boolean } | undefined)?.declared === true;+ const textures = textureless+ ? null+ : makeReferenceTextureSet(spec, options) ?? makeProceduralTextureSet(id, spec, options);+ const material = new THREE.MeshPhysicalMaterial({+ color: textures ? 0xffffff : clampedAlbedoColor(spec),+ roughness: textures ? 1 : clamp01(readLayerNumber(spec.roughness, ['base'], 0.76)),+ metalness: clampPbrMetalness(readLayerNumber(spec.metalness, ['base'], 0.0)),+ clearcoat: clamp01(readLayerNumber(spec.clearcoat, ['base', 'amount'], 0)),+ clearcoatRoughness: clamp01(readLayerNumber(spec.clearcoatRoughness, ['base'], 0.25)),+ transmission: clamp01(readLayerNumber(spec.transmission, ['base', 'amount'], 0)),+ ior: clampPbrIor(readLayerNumber(spec.ior, ['base', 'value'], 1.5)),+ thickness: Math.max(0, readLayerNumber(spec.thickness, ['base', 'amount'], 0)),+ attenuationDistance: Math.max(0.001, readLayerNumber(spec.attenuationDistance, ['base', 'value'], Infinity)),+ attenuationColor: new THREE.Color(typeof spec.attenuationColor === 'string' ? spec.attenuationColor : '#ffffff'),+ sheen: clamp01(readLayerNumber(spec.sheen, ['base', 'amount'], 0)),+ sheenColor: new THREE.Color(typeof spec.sheenColor === 'string' ? spec.sheenColor : '#ffffff'),+ sheenRoughness: clamp01(readLayerNumber(spec.sheenRoughness, ['base'], 1.0)),+ iridescence: clamp01(readLayerNumber(spec.iridescence, ['base', 'amount'], 0)),+ iridescenceIOR: clampPbrIor(readLayerNumber(spec.iridescenceIOR, ['base', 'value'], 1.3)),+ anisotropy: clamp01(readLayerNumber(spec.anisotropy, ['base', 'amount'], 0)),+ anisotropyRotation: readLayerNumber(spec.anisotropy, ['rotation'], 0),+ specularIntensity: clampPbrF0(readLayerNumber(spec.specularF0 ?? spec.f0 ?? spec.specularIntensity, ['base', 'value'], 1.0)),+ specularColor: new THREE.Color(typeof spec.specularColor === 'string' ? spec.specularColor : '#ffffff'),+ emissive: new THREE.Color(typeof spec.emissive === 'string' ? spec.emissive : '#000000'),+ emissiveIntensity: Math.max(0, readLayerNumber(spec.emissiveIntensity, ['base'], 1.0)),+ opacity: clamp01(readLayerNumber(spec.opacity, ['base'], 1)),+ transparent: readLayerNumber(spec.transmission, ['base', 'amount'], 0) > 0 || readLayerNumber(spec.opacity, ['base'], 1) < 1,+ alphaTest: Math.max(0, readLayerNumber(spec.alpha, ['cutoff', 'alphaTest'], 0)),+ wireframe: options.wireframe ?? false,+ side: spec.doubleSided === true ? THREE.DoubleSide : THREE.FrontSide,+ flatShading: spec.flatShading === true,+ });+ if (textures) {+ material.map = textures.albedo;+ material.roughnessMap = textures.roughness;+ material.normalMap = textures.normal;+ material.normalScale.setScalar(Math.max(0.05, readLayerNumber(spec.normal, ['strength', 'amplitude'], 0.35)));+ material.aoMap = textures.ao;+ material.aoMap.channel = 0;+ material.aoMapIntensity = readLayerNumber(spec.ambientOcclusion, ['cavityStrength', 'strength'], 0.35);+ const denseMesh = denseComponent || spec.denseMesh === true || spec.geometryDensity === 'dense' || spec.topologyClass === 'dense';+ const bumpScale = Math.max(0, readLayerNumber(spec.bump, ['amplitude', 'strength'], 0));+ const effectiveBumpScale = denseMesh ? Math.max(0.05, bumpScale) : bumpScale;+ if (effectiveBumpScale > 0) {+ material.bumpMap = textures.height;+ material.bumpScale = effectiveBumpScale;+ }+ const displacementScale = Math.max(0, readLayerNumber(spec.displacement, ['amplitude', 'strength'], 0));+ const effectiveDisplacementScale = denseMesh ? Math.max(0.005, displacementScale) : displacementScale;+ if (effectiveDisplacementScale > 0) {+ material.displacementMap = textures.height;+ material.displacementScale = effectiveDisplacementScale;+ material.displacementBias = -effectiveDisplacementScale * 0.5;+ }+ }+ material.envMapIntensity = readLayerNumber(spec, ['envMapIntensity'], 0.8);+ material.userData.sculptMaterial = spec;+ material.userData.proceduralMapsIndependent = true;+ material.userData.pbrConstraints = { albedoRange: [30, 240], binaryMetalness: true, f0Range: [0.02, 1], iorRange: [1, 2.5] };+ material.userData.pbrTextureSource = textures?.source ?? 'flat-fallback';+ material.userData.referencePbr = spec.referencePbr ?? null;+ material.userData.referenceMaterialId = spec.referenceMaterialId ?? spec.materialReference?.profileId ?? null;+ material.userData.materialEvidence = spec.materialEvidence ?? null;+ material.userData.validationViews = spec.materialReference?.validationViews ?? [];+ material.needsUpdate = true;+ return material;+}++type AttachmentEndpoint = {+ start: THREE.Vector3;+ midpoint: THREE.Vector3;+ quaternion: THREE.Quaternion;+ length: number;+ baseRadius: number;+ endRadius: number;+};++function readVector3(value: unknown, fallback: [number, number, number]): THREE.Vector3 {+ if (Array.isArray(value) && value.length === 3 && value.every((item) => typeof item === 'number')) {+ return new THREE.Vector3(value[0], value[1], value[2]);+ }+ return new THREE.Vector3(fallback[0], fallback[1], fallback[2]);+}++function readNumber(value: unknown, fallback: number): number {+ return typeof value === 'number' && Number.isFinite(value) ? value : fallback;+}++function makeAttachmentEndpoint(attachment: unknown): AttachmentEndpoint | null {+ if (!attachment || typeof attachment !== 'object') return null;+ const record = attachment as Record<string, unknown>;+ const start = readVector3(record.localStart, [0, 0, 0]);+ const end = readVector3(record.localEnd, [0, 1, 0]);+ const delta = end.clone().sub(start);+ const length = delta.length();+ if (length <= 0.0001) return null;+ const direction = delta.clone().normalize();+ const quaternion = new THREE.Quaternion().setFromUnitVectors(new THREE.Vector3(0, 1, 0), direction);+ const baseRadius = Math.max(0.005, readNumber(record.baseRadius, 0.06));+ const endRadius = Math.max(0.003, readNumber(record.endRadius, baseRadius * 0.55));+ return {+ start,+ midpoint: delta.multiplyScalar(0.5),+ quaternion,+ length,+ baseRadius,+ endRadius,+ };+}++// Generated from ObjectSculptSpec target: AK-47 Wild Lotus+// Sculpt build pass: blockout+// This factory is intentionally pass-gated. Finish browser screenshot review before unlocking deeper passes.+export function createAK47WildLotusModel(options: ProceduralModelOptions = {}): THREE.Group {+ const root = new THREE.Group();+ root.name = "AK-47 Wild Lotus";+ root.userData.reconstructionEvidence = {"itemFamily": null, "subtype": null, "componentAdapter": null, "route": null, "exactnessTier": null, "referenceCamera": {"solved": true, "fovDegrees": 35.0, "aspect": 1.7778, "orientation": {"yaw": 0.0, "pitch": 0.0, "roll": 0.0}, "positionHint": [0.0, 0.0, 2.5], "note": "Heuristic default; refine by overlay review."}, "approximationNotes": []};+ root.userData.materialPipeline = {};+ root.userData.materialReferenceRegistry = null;++ const materialMap: Record<string, THREE.Material> = {};+ materialMap["wild-lotus-base"] = createSculptMaterial(+ "wild-lotus-base",+ {"id": "wild-lotus-base", "name": "Wild Lotus Teal Painted Metal", "type": "standard", "baseColor": "#2A7A5A", "albedo": {"dominant": "#2A7A5A", "secondary": ["#1E5E42", "#3A8A6A"]}, "roughness": {"base": 0.55, "variation": 0.1, "map": {"type": "independent-procedural", "source": "independent procedural roughness field derived from surface finish observation", "pattern": "mottled-field", "amplitude": 0.1, "resolution": 1024, "independent": true}}, "metalness": {"base": 0.1, "variation": 0.05}, "normal": {"pattern": "stamped-metal-grain", "strength": 0.2, "scale": 16}, "localOverrides": [{"region": "all-painted-surfaces", "description": "Wild Lotus floral pattern applied via projection from de-lit reference"}], "note": "Projection-first route mandatory for this patterned skin.", "textureResolution": 2048, "textureProjection": {"mode": "uv", "repeat": [2.0, 2.0], "anisotropy": 8, "texelDensityIntent": "Preserve stable world-scale detail"}, "surfaceFrequencyBands": [{"id": "macro", "frequency": 2.0, "amplitude": 0.4, "role": "broad color breakup"}, {"id": "meso", "frequency": 12.0, "amplitude": 0.2, "role": "visible relief"}, {"id": "micro", "frequency": 56.0, "amplitude": 0.08, "role": "grazing light breakup"}], "ambientOcclusion": {"cavityStrength": 0.25, "contactShadowBias": 0.35}, "referencePbr": {"source": "de-lit reference image projection", "method": "projection from de-lit reference crops", "confidence": 0.71, "usable": true, "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence", "maps": {"albedo": {"path": "delight_albedo.png", "confidence": 0.75, "resolution": 2048, "colorSpace": "sRGB", "source": "de-lit reference projection"}, "roughness": {"path": "procedural-roughness-field", "confidence": 0.7, "resolution": 1024, "source": "inferred from surface finish"}, "normal": {"path": "procedural-normal-field", "confidence": 0.65, "resolution": 1024, "source": "stamped-metal grain procedural"}, "ao": {"path": "procedural-ao-field", "confidence": 0.7, "resolution": 1024, "source": "computed from geometry"}, "height": {"path": "procedural-height-field", "confidence": 0.6, "resolution": 1024, "source": "displacement from surface detail"}}}},+ options+ );+ materialMap["dark-metal"] = createSculptMaterial(+ "dark-metal",+ {"id": "dark-metal", "name": "Dark Blued Steel", "type": "standard", "baseColor": "#1A1A1A", "albedo": {"dominant": "#1A1A1A", "secondary": ["#2A2A2A", "#0F0F0F"]}, "roughness": {"base": 0.4, "variation": 0.08, "map": {"type": "independent-procedural", "source": "independent procedural roughness field derived from surface finish observation", "pattern": "mottled-field", "amplitude": 0.08, "resolution": 1024, "independent": true}}, "metalness": {"base": 0.9, "variation": 0.05}, "normal": {"pattern": "machined-metal", "strength": 0.15, "scale": 8}, "localOverrides": [], "note": "Barrel, gas tube, rear sight. Dark parkerized/blued finish.", "textureResolution": 2048, "textureProjection": {"mode": "uv", "repeat": [2.0, 2.0], "anisotropy": 8, "texelDensityIntent": "Preserve stable world-scale detail"}, "surfaceFrequencyBands": [{"id": "macro", "frequency": 2.0, "amplitude": 0.4, "role": "broad color breakup"}, {"id": "meso", "frequency": 12.0, "amplitude": 0.2, "role": "visible relief"}, {"id": "micro", "frequency": 56.0, "amplitude": 0.08, "role": "grazing light breakup"}], "ambientOcclusion": {"cavityStrength": 0.25, "contactShadowBias": 0.35}, "referencePbr": {"source": "de-lit reference image projection", "method": "projection from de-lit reference crops", "confidence": 0.71, "usable": true, "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence", "maps": {"albedo": {"path": "delight_albedo.png", "confidence": 0.75, "resolution": 2048, "colorSpace": "sRGB", "source": "de-lit reference projection"}, "roughness": {"path": "procedural-roughness-field", "confidence": 0.7, "resolution": 1024, "source": "inferred from surface finish"}, "normal": {"path": "procedural-normal-field", "confidence": 0.65, "resolution": 1024, "source": "stamped-metal grain procedural"}, "ao": {"path": "procedural-ao-field", "confidence": 0.7, "resolution": 1024, "source": "computed from geometry"}, "height": {"path": "procedural-height-field", "confidence": 0.6, "resolution": 1024, "source": "displacement from surface detail"}}}},+ options+ );+ materialMap["gold-accent"] = createSculptMaterial(+ "gold-accent",+ {"id": "gold-accent", "name": "Gold/Bronze Metallic Accent", "type": "standard", "baseColor": "#C8944A", "albedo": {"dominant": "#C8944A", "secondary": ["#B8843A", "#D8A45A"]}, "roughness": {"base": 0.35, "variation": 0.08, "map": {"type": "independent-procedural", "source": "independent procedural roughness field derived from surface finish observation", "pattern": "mottled-field", "amplitude": 0.08, "resolution": 1024, "independent": true}}, "metalness": {"base": 0.75, "variation": 0.1}, "normal": {"pattern": "smooth-metallic", "strength": 0.05, "scale": 4}, "localOverrides": [], "note": "Magazine band, stock band, trigger guard, trigger.", "textureResolution": 2048, "textureProjection": {"mode": "uv", "repeat": [2.0, 2.0], "anisotropy": 8, "texelDensityIntent": "Preserve stable world-scale detail"}, "surfaceFrequencyBands": [{"id": "macro", "frequency": 2.0, "amplitude": 0.4, "role": "broad color breakup"}, {"id": "meso", "frequency": 12.0, "amplitude": 0.2, "role": "visible relief"}, {"id": "micro", "frequency": 56.0, "amplitude": 0.08, "role": "grazing light breakup"}], "ambientOcclusion": {"cavityStrength": 0.25, "contactShadowBias": 0.35}, "referencePbr": {"source": "de-lit reference image projection", "method": "projection from de-lit reference crops", "confidence": 0.71, "usable": true, "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence", "maps": {"albedo": {"path": "delight_albedo.png", "confidence": 0.75, "resolution": 2048, "colorSpace": "sRGB", "source": "de-lit reference projection"}, "roughness": {"path": "procedural-roughness-field", "confidence": 0.7, "resolution": 1024, "source": "inferred from surface finish"}, "normal": {"path": "procedural-normal-field", "confidence": 0.65, "resolution": 1024, "source": "stamped-metal grain procedural"}, "ao": {"path": "procedural-ao-field", "confidence": 0.7, "resolution": 1024, "source": "computed from geometry"}, "height": {"path": "procedural-height-field", "confidence": 0.6, "resolution": 1024, "source": "displacement from surface detail"}}}},+ options+ );++ const nodes: Record<string, THREE.Object3D> = { root };+ const meshes: Record<string, THREE.Mesh> = {};+ const sockets: Record<string, THREE.Object3D> = {};+ const colliders: Record<string, unknown> = {};+ const destructionGroups: Record<string, THREE.Object3D[]> = {};++ const endpoint_root_0 = makeAttachmentEndpoint(null);+ const node_root_0 = new THREE.Group();+ node_root_0.name = "AK-47 Wild Lotus__pivot";+ node_root_0.scale.set(1, 1, 1);+ if (endpoint_root_0) {+ node_root_0.position.copy(endpoint_root_0.start);+ node_root_0.rotation.set(0.0, 0.0, 0.0);+ } else {+ node_root_0.position.set(0.0, 0.0, 0.0);+ node_root_0.rotation.set(0.0, 0.0, 0.0);+ }+ node_root_0.userData.sculptComponent = {"id": "root", "name": "AK-47 Wild Lotus", "level": "macro", "role": "body", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Root group holding all child components", "geometryDescriptor": {"topologyIntent": "root pivot only", "uvStrategy": "generated procedural coordinates"}, "parent": null, "attachment": null, "dimensions": {"width": 0.88, "height": 0.22, "depth": 0.06, "units": "meters", "confidence": 0.85}, "transform": {"position": [0, 0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.6, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "root", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "scale": true, "detach": false, "visibility": true}, "sockets": [], "collider": {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]}, "destruction": {"breakable": false, "fractureGroup": "root"}}, "material": "wild-lotus-base", "evidenceRefs": ["left-view", "right-view"]};+ node_root_0.userData.actionProfile = {"animationRole": "root", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "scale": true, "detach": false, "visibility": true}, "sockets": [], "collider": {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]}, "destruction": {"breakable": false, "fractureGroup": "root"}};+ (nodes["root"] ?? root).add(node_root_0);+ nodes["root"] = node_root_0;+ const mesh_root_0Geometry = endpoint_root_0+ ? new THREE.CylinderGeometry(endpoint_root_0.endRadius, endpoint_root_0.baseRadius, endpoint_root_0.length, 32, 12)+ : new THREE.BoxGeometry(1, 1, 1, 12, 12, 12);+ if (!endpoint_root_0) {+ mesh_root_0Geometry.scale(1.0, 1.0, 1.0);+ }+ const mesh_root_0 = new THREE.Mesh(+ mesh_root_0Geometry,+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })+ );+ mesh_root_0.name = "AK-47 Wild Lotus";+ if (endpoint_root_0) {+ mesh_root_0.position.copy(endpoint_root_0.midpoint);+ mesh_root_0.quaternion.copy(endpoint_root_0.quaternion);+ }+ mesh_root_0.castShadow = options.castShadow ?? true;+ mesh_root_0.receiveShadow = options.receiveShadow ?? true;+ mesh_root_0.userData.sculptComponent = {"id": "root", "name": "AK-47 Wild Lotus", "level": "macro", "role": "body", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Root group holding all child components", "geometryDescriptor": {"topologyIntent": "root pivot only", "uvStrategy": "generated procedural coordinates"}, "parent": null, "attachment": null, "dimensions": {"width": 0.88, "height": 0.22, "depth": 0.06, "units": "meters", "confidence": 0.85}, "transform": {"position": [0, 0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.6, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "root", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "scale": true, "detach": false, "visibility": true}, "sockets": [], "collider": {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]}, "destruction": {"breakable": false, "fractureGroup": "root"}}, "material": "wild-lotus-base", "evidenceRefs": ["left-view", "right-view"]};+ node_root_0.add(mesh_root_0);+ meshes["root"] = mesh_root_0;+ colliders["root"] = {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]};+ destructionGroups["root"] ??= [];+ destructionGroups["root"].push(node_root_0);++ const endpoint_stock_1 = makeAttachmentEndpoint(null);+ const node_stock_1 = new THREE.Group();+ node_stock_1.name = "Fixed Stock__pivot";+ node_stock_1.scale.set(1, 1, 1);+ if (endpoint_stock_1) {+ node_stock_1.position.copy(endpoint_stock_1.start);+ node_stock_1.rotation.set(0.0, 0.0, 0.0);+ } else {+ node_stock_1.position.set(-0.38, -0.01, 0.0);+ node_stock_1.rotation.set(0.0, 0.0, 0.0);+ }+ node_stock_1.userData.sculptComponent = {"id": "stock", "name": "Fixed Stock", "level": "macro", "role": "stock", "importance": 0.9, "confidence": 0.92, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded triangular profile matching AK fixed stock", "geometryDescriptor": {"topologyIntent": "triangular cross-section extruded along length, slight taper toward butt", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.003, "segments": 2}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-rear", "contactType": "butt-joint", "localStart": [0, 0, 0], "localEnd": [-0.05, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.26, "height": 0.14, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [-0.38, -0.01, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "stock"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "stock-lily", "type": "decal-area", "description": "Large pink lily flower on stock butt", "placement": "rear-third lateral face", "size": 0.08, "materialEffect": "high-saturation pink", "confidence": 0.95}, {"id": "stock-gold-band", "type": "raised-ridge", "description": "Curved gold accent band", "placement": "diagonal across stock", "size": 0.015, "materialEffect": "metallic gold", "confidence": 0.95}], "evidenceRefs": ["left-view", "right-view"]};+ node_stock_1.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "stock"}};+ (nodes["root"] ?? root).add(node_stock_1);+ nodes["stock"] = node_stock_1;+ const mesh_stock_1Geometry = endpoint_stock_1+ ? new THREE.CylinderGeometry(endpoint_stock_1.endRadius, endpoint_stock_1.baseRadius, endpoint_stock_1.length, 32, 12)+ : buildExtrudeGeometry({"points": [[-0.3, -0.3], [0.3, -0.3], [0.3, 0.3], [-0.3, 0.3]], "depth": 0.1});+ if (!endpoint_stock_1) {+ mesh_stock_1Geometry.scale(1.0, 1.0, 1.0);+ }+ const mesh_stock_1 = new THREE.Mesh(+ mesh_stock_1Geometry,+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })+ );+ mesh_stock_1.name = "Fixed Stock";+ if (endpoint_stock_1) {+ mesh_stock_1.position.copy(endpoint_stock_1.midpoint);+ mesh_stock_1.quaternion.copy(endpoint_stock_1.quaternion);+ }+ mesh_stock_1.castShadow = options.castShadow ?? true;+ mesh_stock_1.receiveShadow = options.receiveShadow ?? true;+ mesh_stock_1.userData.sculptComponent = {"id": "stock", "name": "Fixed Stock", "level": "macro", "role": "stock", "importance": 0.9, "confidence": 0.92, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded triangular profile matching AK fixed stock", "geometryDescriptor": {"topologyIntent": "triangular cross-section extruded along length, slight taper toward butt", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.003, "segments": 2}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-rear", "contactType": "butt-joint", "localStart": [0, 0, 0], "localEnd": [-0.05, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.26, "height": 0.14, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [-0.38, -0.01, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "stock"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "stock-lily", "type": "decal-area", "description": "Large pink lily flower on stock butt", "placement": "rear-third lateral face", "size": 0.08, "materialEffect": "high-saturation pink", "confidence": 0.95}, {"id": "stock-gold-band", "type": "raised-ridge", "description": "Curved gold accent band", "placement": "diagonal across stock", "size": 0.015, "materialEffect": "metallic gold", "confidence": 0.95}], "evidenceRefs": ["left-view", "right-view"]};+ node_stock_1.add(mesh_stock_1);+ meshes["stock"] = mesh_stock_1;+ colliders["stock"] = {"type": "box"};+ destructionGroups["stock"] ??= [];+ destructionGroups["stock"].push(node_stock_1);++ const endpoint_receiver_2 = makeAttachmentEndpoint(null);+ const node_receiver_2 = new THREE.Group();+ node_receiver_2.name = "Stamped Receiver__pivot";+ node_receiver_2.scale.set(1, 1, 1);+ if (endpoint_receiver_2) {+ node_receiver_2.position.copy(endpoint_receiver_2.start);+ node_receiver_2.rotation.set(0.0, 0.0, 0.0);+ } else {+ node_receiver_2.position.set(-0.08, 0.0, 0.0);+ node_receiver_2.rotation.set(0.0, 0.0, 0.0);+ }+ node_receiver_2.userData.sculptComponent = {"id": "receiver", "name": "Stamped Receiver", "level": "macro", "role": "receiver", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Rectangular stamped metal box, AK core", "geometryDescriptor": {"topologyIntent": "rectangular box with dust cover top, trigger guard below", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": null, "contactType": "core-body", "localStart": [0, 0, 0], "localEnd": [0, 0, 0], "overlap": 0, "gapTolerance": 0}, "dimensions": {"width": 0.22, "height": 0.08, "depth": 0.05, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.08, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "sockets": [{"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"}, {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"}, {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"}, {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"}], "collider": {"type": "box"}, "destruction": {"breakable": false, "fractureGroup": "receiver"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "receiver-lotus", "type": "decal-area", "description": "Large red lotus flower", "placement": "center-right receiver face", "size": 0.1, "materialEffect": "high-saturation red", "confidence": 0.98}, {"id": "bolt-handle", "type": "raised-ridge", "description": "Charging handle on right side", "placement": "upper-right receiver", "size": 0.02, "materialEffect": "dark metal", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};+ node_receiver_2.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "sockets": [{"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"}, {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"}, {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"}, {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"}], "collider": {"type": "box"}, "destruction": {"breakable": false, "fractureGroup": "receiver"}};+ (nodes["root"] ?? root).add(node_receiver_2);+ nodes["receiver"] = node_receiver_2;+ const mesh_receiver_2Geometry = endpoint_receiver_2+ ? new THREE.CylinderGeometry(endpoint_receiver_2.endRadius, endpoint_receiver_2.baseRadius, endpoint_receiver_2.length, 32, 12)+ : new THREE.BoxGeometry(1, 1, 1, 12, 12, 12);+ if (!endpoint_receiver_2) {+ mesh_receiver_2Geometry.scale(1.0, 1.0, 1.0);+ }+ const mesh_receiver_2 = new THREE.Mesh(+ mesh_receiver_2Geometry,+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })+ );+ mesh_receiver_2.name = "Stamped Receiver";+ if (endpoint_receiver_2) {+ mesh_receiver_2.position.copy(endpoint_receiver_2.midpoint);+ mesh_receiver_2.quaternion.copy(endpoint_receiver_2.quaternion);+ }+ mesh_receiver_2.castShadow = options.castShadow ?? true;+ mesh_receiver_2.receiveShadow = options.receiveShadow ?? true;+ mesh_receiver_2.userData.sculptComponent = {"id": "receiver", "name": "Stamped Receiver", "level": "macro", "role": "receiver", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Rectangular stamped metal box, AK core", "geometryDescriptor": {"topologyIntent": "rectangular box with dust cover top, trigger guard below", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": null, "contactType": "core-body", "localStart": [0, 0, 0], "localEnd": [0, 0, 0], "overlap": 0, "gapTolerance": 0}, "dimensions": {"width": 0.22, "height": 0.08, "depth": 0.05, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.08, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "sockets": [{"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"}, {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"}, {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"}, {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"}], "collider": {"type": "box"}, "destruction": {"breakable": false, "fractureGroup": "receiver"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "receiver-lotus", "type": "decal-area", "description": "Large red lotus flower", "placement": "center-right receiver face", "size": 0.1, "materialEffect": "high-saturation red", "confidence": 0.98}, {"id": "bolt-handle", "type": "raised-ridge", "description": "Charging handle on right side", "placement": "upper-right receiver", "size": 0.02, "materialEffect": "dark metal", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};+ node_receiver_2.add(mesh_receiver_2);+ meshes["receiver"] = mesh_receiver_2;+ colliders["receiver"] = {"type": "box"};+ destructionGroups["receiver"] ??= [];+ destructionGroups["receiver"].push(node_receiver_2);+ const socket_receiver_receiver_rear_0 = new THREE.Object3D();+ socket_receiver_receiver_rear_0.name = "receiver-rear";+ socket_receiver_receiver_rear_0.position.set(-0.11, 0.0, 0.0);+ socket_receiver_receiver_rear_0.rotation.set(0, 0, 0);+ socket_receiver_receiver_rear_0.userData.socket = {"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"};+ node_receiver_2.add(socket_receiver_receiver_rear_0);+ sockets["receiver:receiver-rear"] = socket_receiver_receiver_rear_0;+ const socket_receiver_receiver_front_1 = new THREE.Object3D();+ socket_receiver_receiver_front_1.name = "receiver-front";+ socket_receiver_receiver_front_1.position.set(0.11, 0.0, 0.0);+ socket_receiver_receiver_front_1.rotation.set(0, 0, 0);+ socket_receiver_receiver_front_1.userData.socket = {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"};+ node_receiver_2.add(socket_receiver_receiver_front_1);+ sockets["receiver:receiver-front"] = socket_receiver_receiver_front_1;+ const socket_receiver_mag_well_2 = new THREE.Object3D();+ socket_receiver_mag_well_2.name = "mag-well";+ socket_receiver_mag_well_2.position.set(-0.02, -0.05, 0.0);+ socket_receiver_mag_well_2.rotation.set(0, 0, 0);+ socket_receiver_mag_well_2.userData.socket = {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"};+ node_receiver_2.add(socket_receiver_mag_well_2);+ sockets["receiver:mag-well"] = socket_receiver_mag_well_2;+ const socket_receiver_grip_socket_3 = new THREE.Object3D();+ socket_receiver_grip_socket_3.name = "grip-socket";+ socket_receiver_grip_socket_3.position.set(0.02, -0.05, 0.0);+ socket_receiver_grip_socket_3.rotation.set(0, 0, 0);+ socket_receiver_grip_socket_3.userData.socket = {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"};+ node_receiver_2.add(socket_receiver_grip_socket_3);+ sockets["receiver:grip-socket"] = socket_receiver_grip_socket_3;++ const attachment_handguard_3 = {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.08, 0, 0], "overlap": 0.01, "gapTolerance": 0.002};+ const endpoint_handguard_3 = makeAttachmentEndpoint(attachment_handguard_3);+ const node_handguard_3 = new THREE.Group();+ node_handguard_3.name = "Handguard Assembly__pivot";+ node_handguard_3.scale.set(1, 1, 1);+ if (endpoint_handguard_3) {+ node_handguard_3.position.copy(endpoint_handguard_3.start);+ node_handguard_3.rotation.set(0.0, 0.0, 0.0);+ } else {+ node_handguard_3.position.set(0.16, 0.0, 0.0);+ node_handguard_3.rotation.set(0.0, 0.0, 0.0);+ }+ node_handguard_3.userData.sculptComponent = {"id": "handguard", "name": "Handguard Assembly", "level": "macro", "role": "handguard", "importance": 0.85, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Upper/lower handguard halves around barrel", "geometryDescriptor": {"topologyIntent": "two half-cylinders around barrel", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.08, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.16, "height": 0.05, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.16, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "handguard"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "handguard-teal", "type": "surface-finish", "description": "Teal paint with floral pattern", "placement": "entire surface", "size": 0.16, "materialEffect": "teal with pink accents", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};+ node_handguard_3.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "handguard"}};+ (nodes["root"] ?? root).add(node_handguard_3);+ nodes["handguard"] = node_handguard_3;+ const mesh_handguard_3Geometry = endpoint_handguard_3+ ? new THREE.CylinderGeometry(endpoint_handguard_3.endRadius, endpoint_handguard_3.baseRadius, endpoint_handguard_3.length, 32, 12)+ : new THREE.CylinderGeometry(0.5, 0.5, 1, 48, 16);+ if (!endpoint_handguard_3) {+ mesh_handguard_3Geometry.scale(1.0, 1.0, 1.0);+ }+ const mesh_handguard_3 = new THREE.Mesh(+ mesh_handguard_3Geometry,+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })+ );+ mesh_handguard_3.name = "Handguard Assembly";+ if (endpoint_handguard_3) {+ mesh_handguard_3.position.copy(endpoint_handguard_3.midpoint);+ mesh_handguard_3.quaternion.copy(endpoint_handguard_3.quaternion);+ }+ mesh_handguard_3.castShadow = options.castShadow ?? true;+ mesh_handguard_3.receiveShadow = options.receiveShadow ?? true;+ mesh_handguard_3.userData.sculptComponent = {"id": "handguard", "name": "Handguard Assembly", "level": "macro", "role": "handguard", "importance": 0.85, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Upper/lower handguard halves around barrel", "geometryDescriptor": {"topologyIntent": "two half-cylinders around barrel", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.08, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.16, "height": 0.05, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.16, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "handguard"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "handguard-teal", "type": "surface-finish", "description": "Teal paint with floral pattern", "placement": "entire surface", "size": 0.16, "materialEffect": "teal with pink accents", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};+ node_handguard_3.add(mesh_handguard_3);+ meshes["handguard"] = mesh_handguard_3;+ colliders["handguard"] = {"type": "cylinder"};+ destructionGroups["handguard"] ??= [];+ destructionGroups["handguard"].push(node_handguard_3);++ const attachment_barrel_4 = {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.38, 0, 0], "overlap": 0.01, "gapTolerance": 0.002};+ const endpoint_barrel_4 = makeAttachmentEndpoint(attachment_barrel_4);+ const node_barrel_4 = new THREE.Group();+ node_barrel_4.name = "Barrel__pivot";+ node_barrel_4.scale.set(1, 1, 1);+ if (endpoint_barrel_4) {+ node_barrel_4.position.copy(endpoint_barrel_4.start);+ node_barrel_4.rotation.set(0.0, 0.0, 0.0);+ } else {+ node_barrel_4.position.set(0.28, -0.005, 0.0);+ node_barrel_4.rotation.set(0.0, 0.0, 0.0);+ }+ node_barrel_4.userData.sculptComponent = {"id": "barrel", "name": "Barrel", "level": "macro", "role": "barrel", "importance": 0.85, "confidence": 0.92, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Long cylindrical barrel, dark metal", "geometryDescriptor": {"topologyIntent": "straight cylinder forward of handguard", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.38, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.38, "height": 0.018, "depth": 0.018, "units": "meters", "confidence": 0.9}, "transform": {"position": [0.28, -0.005, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(26, 26, 26, 1)", "secondaryAlbedo": "rgba(42, 42, 42, 1)", "materialClass": "metal", "materialClassConfidence": 0.9, "roughness": 0.4, "metalness": 0.9}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "barrel"}}, "material": "dark-metal", "evidenceRefs": ["left-view", "right-view"]};+ node_barrel_4.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "barrel"}};+ (nodes["root"] ?? root).add(node_barrel_4);+ nodes["barrel"] = node_barrel_4;+ const mesh_barrel_4Geometry = endpoint_barrel_4+ ? new THREE.CylinderGeometry(endpoint_barrel_4.endRadius, endpoint_barrel_4.baseRadius, endpoint_barrel_4.length, 32, 12)+ : new THREE.CylinderGeometry(0.5, 0.5, 1, 48, 16);+ if (!endpoint_barrel_4) {+ mesh_barrel_4Geometry.scale(1.0, 1.0, 1.0);+ }+ const mesh_barrel_4 = new THREE.Mesh(+ mesh_barrel_4Geometry,+ materialMap["dark-metal"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })+ );+ mesh_barrel_4.name = "Barrel";+ if (endpoint_barrel_4) {+ mesh_barrel_4.position.copy(endpoint_barrel_4.midpoint);+ mesh_barrel_4.quaternion.copy(endpoint_barrel_4.quaternion);+ }+ mesh_barrel_4.castShadow = options.castShadow ?? true;+ mesh_barrel_4.receiveShadow = options.receiveShadow ?? true;+ mesh_barrel_4.userData.sculptComponent = {"id": "barrel", "name": "Barrel", "level": "macro", "role": "barrel", "importance": 0.85, "confidence": 0.92, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Long cylindrical barrel, dark metal", "geometryDescriptor": {"topologyIntent": "straight cylinder forward of handguard", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.38, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.38, "height": 0.018, "depth": 0.018, "units": "meters", "confidence": 0.9}, "transform": {"position": [0.28, -0.005, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(26, 26, 26, 1)", "secondaryAlbedo": "rgba(42, 42, 42, 1)", "materialClass": "metal", "materialClassConfidence": 0.9, "roughness": 0.4, "metalness": 0.9}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "barrel"}}, "material": "dark-metal", "evidenceRefs": ["left-view", "right-view"]};+ node_barrel_4.add(mesh_barrel_4);+ meshes["barrel"] = mesh_barrel_4;+ colliders["barrel"] = {"type": "cylinder"};+ destructionGroups["barrel"] ??= [];+ destructionGroups["barrel"].push(node_barrel_4);++ const endpoint_magazine_5 = makeAttachmentEndpoint(null);+ const node_magazine_5 = new THREE.Group();+ node_magazine_5.name = "Curved Banana Magazine__pivot";+ node_magazine_5.scale.set(1, 1, 1);+ if (endpoint_magazine_5) {+ node_magazine_5.position.copy(endpoint_magazine_5.start);+ node_magazine_5.rotation.set(0.0, 0.0, -8.0);+ } else {+ node_magazine_5.position.set(-0.02, -0.1, 0.0);+ node_magazine_5.rotation.set(0.0, 0.0, -8.0);+ }+ node_magazine_5.userData.sculptComponent = {"id": "magazine", "name": "Curved Banana Magazine", "level": "macro", "role": "magazine", "importance": 0.9, "confidence": 0.93, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded curved profile, iconic AK banana shape", "geometryDescriptor": {"topologyIntent": "curved rectangular cross-section following banana arc", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "deformationStack": [{"type": "bend", "axis": "Z", "angle": 25, "falloff": "linear"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "mag-well", "contactType": "insert", "localStart": [0, 0.09, 0], "localEnd": [0, -0.09, 0], "overlap": 0.015, "gapTolerance": 0.002}, "dimensions": {"width": 0.04, "height": 0.18, "depth": 0.025, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.02, -0.1, 0], "rotation": [0, 0, -8], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "detachable", "pivot": {"mode": "top", "localPosition": [0, 0.09, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "magazine"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "mag-gold-band", "type": "raised-ridge", "description": "Curved gold accent stripe", "placement": "center of magazine face", "size": 0.012, "materialEffect": "metallic gold", "confidence": 0.95}, {"id": "mag-witness-holes", "type": "hole-or-socket", "description": "Witness holes for round counting", "placement": "left side vertical row", "size": 0.003, "materialEffect": "dark recess", "confidence": 0.85}, {"id": "mag-flowers", "type": "decal-area", "description": "Small orange and pink accent flowers", "placement": "lower magazine", "size": 0.04, "materialEffect": "orange/pink accents", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};+ node_magazine_5.userData.actionProfile = {"animationRole": "detachable", "pivot": {"mode": "top", "localPosition": [0, 0.09, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "magazine"}};+ (nodes["root"] ?? root).add(node_magazine_5);+ nodes["magazine"] = node_magazine_5;+ const mesh_magazine_5Geometry = endpoint_magazine_5+ ? new THREE.CylinderGeometry(endpoint_magazine_5.endRadius, endpoint_magazine_5.baseRadius, endpoint_magazine_5.length, 32, 12)+ : buildExtrudeGeometry({"points": [[-0.3, -0.3], [0.3, -0.3], [0.3, 0.3], [-0.3, 0.3]], "depth": 0.1});+ if (!endpoint_magazine_5) {+ mesh_magazine_5Geometry.scale(1.0, 1.0, 1.0);+ }+ const mesh_magazine_5 = new THREE.Mesh(+ mesh_magazine_5Geometry,+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })+ );+ mesh_magazine_5.name = "Curved Banana Magazine";+ if (endpoint_magazine_5) {+ mesh_magazine_5.position.copy(endpoint_magazine_5.midpoint);+ mesh_magazine_5.quaternion.copy(endpoint_magazine_5.quaternion);+ }+ mesh_magazine_5.castShadow = options.castShadow ?? true;+ mesh_magazine_5.receiveShadow = options.receiveShadow ?? true;+ mesh_magazine_5.userData.sculptComponent = {"id": "magazine", "name": "Curved Banana Magazine", "level": "macro", "role": "magazine", "importance": 0.9, "confidence": 0.93, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded curved profile, iconic AK banana shape", "geometryDescriptor": {"topologyIntent": "curved rectangular cross-section following banana arc", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "deformationStack": [{"type": "bend", "axis": "Z", "angle": 25, "falloff": "linear"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "mag-well", "contactType": "insert", "localStart": [0, 0.09, 0], "localEnd": [0, -0.09, 0], "overlap": 0.015, "gapTolerance": 0.002}, "dimensions": {"width": 0.04, "height": 0.18, "depth": 0.025, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.02, -0.1, 0], "rotation": [0, 0, -8], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "detachable", "pivot": {"mode": "top", "localPosition": [0, 0.09, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "magazine"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "mag-gold-band", "type": "raised-ridge", "description": "Curved gold accent stripe", "placement": "center of magazine face", "size": 0.012, "materialEffect": "metallic gold", "confidence": 0.95}, {"id": "mag-witness-holes", "type": "hole-or-socket", "description": "Witness holes for round counting", "placement": "left side vertical row", "size": 0.003, "materialEffect": "dark recess", "confidence": 0.85}, {"id": "mag-flowers", "type": "decal-area", "description": "Small orange and pink accent flowers", "placement": "lower magazine", "size": 0.04, "materialEffect": "orange/pink accents", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};+ node_magazine_5.add(mesh_magazine_5);+ meshes["magazine"] = mesh_magazine_5;+ colliders["magazine"] = {"type": "box"};+ destructionGroups["magazine"] ??= [];+ destructionGroups["magazine"].push(node_magazine_5);++ const attachment_grip_6 = {"parentSocket": "grip-socket", "contactType": "embed", "localStart": [0, 0, 0], "localEnd": [0, -0.08, 0], "overlap": 0.01, "gapTolerance": 0.002};+ const endpoint_grip_6 = makeAttachmentEndpoint(attachment_grip_6);+ const node_grip_6 = new THREE.Group();+ node_grip_6.name = "Pistol Grip__pivot";+ node_grip_6.scale.set(1, 1, 1);+ if (endpoint_grip_6) {+ node_grip_6.position.copy(endpoint_grip_6.start);+ node_grip_6.rotation.set(0.0, 0.0, 12.0);+ } else {+ node_grip_6.position.set(0.02, -0.08, 0.0);+ node_grip_6.rotation.set(0.0, 0.0, 12.0);+ }+ node_grip_6.userData.sculptComponent = {"id": "grip", "name": "Pistol Grip", "level": "macro", "role": "grip", "importance": 0.8, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Tapered ergonomic cylinder below receiver", "geometryDescriptor": {"topologyIntent": "tapered cylinder with forward angle", "deformationStack": [{"type": "taper", "startRadius": 0.015, "endRadius": 0.018, "axis": "Y"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "grip-socket", "contactType": "embed", "localStart": [0, 0, 0], "localEnd": [0, -0.08, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.03, "height": 0.08, "depth": 0.03, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.02, -0.08, 0], "rotation": [0, 0, 12], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "grip"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "grip-vines", "type": "linework", "description": "Green vine/leaf pattern", "placement": "entire grip face", "size": 0.06, "materialEffect": "dark green overlay", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};+ node_grip_6.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "grip"}};+ (nodes["root"] ?? root).add(node_grip_6);+ nodes["grip"] = node_grip_6;+ const mesh_grip_6Geometry = endpoint_grip_6+ ? new THREE.CylinderGeometry(endpoint_grip_6.endRadius, endpoint_grip_6.baseRadius, endpoint_grip_6.length, 32, 12)+ : new THREE.CylinderGeometry(0.5, 0.5, 1, 48, 16);+ if (!endpoint_grip_6) {+ mesh_grip_6Geometry.scale(1.0, 1.0, 1.0);+ }+ const mesh_grip_6 = new THREE.Mesh(+ mesh_grip_6Geometry,+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })+ );+ mesh_grip_6.name = "Pistol Grip";+ if (endpoint_grip_6) {+ mesh_grip_6.position.copy(endpoint_grip_6.midpoint);+ mesh_grip_6.quaternion.copy(endpoint_grip_6.quaternion);+ }+ mesh_grip_6.castShadow = options.castShadow ?? true;+ mesh_grip_6.receiveShadow = options.receiveShadow ?? true;+ mesh_grip_6.userData.sculptComponent = {"id": "grip", "name": "Pistol Grip", "level": "macro", "role": "grip", "importance": 0.8, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Tapered ergonomic cylinder below receiver", "geometryDescriptor": {"topologyIntent": "tapered cylinder with forward angle", "deformationStack": [{"type": "taper", "startRadius": 0.015, "endRadius": 0.018, "axis": "Y"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "grip-socket", "contactType": "embed", "localStart": [0, 0, 0], "localEnd": [0, -0.08, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.03, "height": 0.08, "depth": 0.03, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.02, -0.08, 0], "rotation": [0, 0, 12], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "grip"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "grip-vines", "type": "linework", "description": "Green vine/leaf pattern", "placement": "entire grip face", "size": 0.06, "materialEffect": "dark green overlay", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};+ node_grip_6.add(mesh_grip_6);+ meshes["grip"] = mesh_grip_6;+ colliders["grip"] = {"type": "cylinder"};+ destructionGroups["grip"] ??= [];+ destructionGroups["grip"].push(node_grip_6);++ root.userData.sculptRuntime = { nodes, meshes, sockets, colliders, destructionGroups } satisfies ProceduralModelRuntime;+ root.userData.lookDevTargets = {"qualityPriority": "reference-fidelity", "materialPass": {"albedoPaletteRequired": true, "roughnessVariationRequired": true, "normalOrBumpRequired": true, "localOverridesRequired": true, "referencePbrExtraction": {"requiredWhenSourceImagePresent": true, "targetThreshold": 0.7}, "independentMapChannels": ["albedo", "roughness", "height", "normal", "ambient-occlusion"], "requiredSurfaceFrequencyBands": ["macro", "meso", "micro"]}, "lightingPass": {"exposure": {"value": 1.0, "intent": "Neutral exposure for material readability"}, "toneMapping": {"algorithm": "ACESFilmic", "intent": "Standard filmic response"}, "background": {"color": "#1a1a1a", "intent": "Dark neutral background"}, "contactShadow": {"enabled": true, "bias": 0.02}, "groundShadow": {"enabled": true, "softness": 0.5}}};+ root.userData.actionReadiness = {+ note: 'Use root.userData.sculptRuntime.nodes for transforms, sockets for attachments, colliders for physics proxies, and destructionGroups for breakable sets.',+ };+ return root;+}++export function createAK47WildLotusLookDevLights(+ mode: 'neutral' | 'grazing' | 'reference' = 'neutral',+): THREE.Group {+ const lights = new THREE.Group();+ lights.name = "AK-47 Wild Lotus look-dev lights";+ const hemi = new THREE.HemisphereLight(+ mode === 'reference' ? 0xfff0d6 : 0xf2f4ff,+ 0x363b42,+ mode === 'grazing' ? 0.28 : mode === 'reference' ? 0.72 : 0.85,+ );+ lights.add(hemi);+ const key = new THREE.DirectionalLight(+ mode === 'reference' ? 0xffcf8a : 0xfff4e8,+ mode === 'grazing' ? 4.2 : mode === 'reference' ? 2.6 : 2.15,+ );+ if (mode === 'grazing') key.position.set(7.5, 1.1, 4.0);+ else if (mode === 'reference') key.position.set(-4.5, 7.5, 5.0);+ else key.position.set(-4.0, 6.0, 5.5);+ key.castShadow = true;+ key.shadow.mapSize.set(4096, 4096);+ key.shadow.bias = -0.00025;+ key.shadow.normalBias = 0.018;+ key.shadow.radius = 7;+ key.shadow.blurSamples = 24;+ key.shadow.camera.near = 0.5;+ key.shadow.camera.far = 30;+ key.shadow.camera.left = -2.6;+ key.shadow.camera.right = 2.6;+ key.shadow.camera.top = 2.6;+ key.shadow.camera.bottom = -2.6;+ key.shadow.camera.updateProjectionMatrix();+ lights.add(key);+ const fill = new THREE.DirectionalLight(0xa8c4ff, mode === 'grazing' ? 0.12 : 0.42);+ fill.position.set(4.0, 3.0, 3.5);+ lights.add(fill);+ const rim = new THREE.DirectionalLight(0xfff1c4, mode === 'grazing' ? 0.28 : 0.85);+ rim.position.set(0.5, 4.5, -6.0);+ lights.add(rim);+ lights.userData.reviewMode = mode;+ lights.userData.lightingFromPhoto = [{"type": "key", "direction": [0.3, 0.5, 1.0], "color": "#FFFFFF", "intensity": 1.0, "note": "Primary key light for material readability"}, {"type": "fill", "direction": [-0.5, 0.3, 0.5], "color": "#E8E8F0", "intensity": 0.4, "note": "Fill light for shadow softening"}, {"type": "rim", "direction": [0, 0.2, -1.0], "color": "#FFFFFF", "intensity": 0.6, "note": "Rim light for silhouette edge"}, {"type": "exposure", "value": 1.0, "toneMapping": "ACESFilmic", "note": "Neutral exposure with ACES filmic tone mapping"}, {"type": "shadow", "contactShadow": true, "groundShadow": true, "note": "Contact shadow and ground shadow enabled"}];+ lights.userData.lookDevTargets = {"qualityPriority": "reference-fidelity", "materialPass": {"albedoPaletteRequired": true, "roughnessVariationRequired": true, "normalOrBumpRequired": true, "localOverridesRequired": true, "referencePbrExtraction": {"requiredWhenSourceImagePresent": true, "targetThreshold": 0.7}, "independentMapChannels": ["albedo", "roughness", "height", "normal", "ambient-occlusion"], "requiredSurfaceFrequencyBands": ["macro", "meso", "micro"]}, "lightingPass": {"exposure": {"value": 1.0, "intent": "Neutral exposure for material readability"}, "toneMapping": {"algorithm": "ACESFilmic", "intent": "Standard filmic response"}, "background": {"color": "#1a1a1a", "intent": "Dark neutral background"}, "contactShadow": {"enabled": true, "bias": 0.02}, "groundShadow": {"enabled": true, "softness": 0.5}}};+ return lights;+}++// PBR materials (clearcoat/iridescence/transmission/anisotropy) need an environment+// map to visually behave as intended — call this once per renderer and assign the+// result to scene.environment before rendering. No external HDR asset required.+export function createAK47WildLotusEnvironment(renderer: THREE.WebGLRenderer): THREE.Texture {+ const pmrem = new THREE.PMREMGenerator(renderer);+ const texture = pmrem.fromScene(new RoomEnvironment(), 0.04).texture;+ pmrem.dispose();+ return texture;+}++// Plan 1.3 §3.2 — auto-framing by bounding box. The Divine Eye can only compare a+// render to the reference if the object is FRAMED consistently (an object framed+// differently scores as wrong even when its shape is right). This positions the camera+// deterministically from the object's bounding box so it fills the frame at a stable+// margin, and sets near/far to the object scale. Call after adding the model to the+// scene, and again on resize (after updating camera.aspect).+export function frameAK47WildLotusCamera(+ camera: THREE.PerspectiveCamera,+ object: THREE.Object3D,+ options: { margin?: number; azimuthDeg?: number; elevationDeg?: number } = {},+): void {+ const box = new THREE.Box3().setFromObject(object);+ if (box.isEmpty()) return;+ const size = box.getSize(new THREE.Vector3());+ const center = box.getCenter(new THREE.Vector3());+ const margin = options.margin ?? 1.15;+ const maxDim = Math.max(size.x, size.y, size.z) * margin;+ const fov = (camera.fov * Math.PI) / 180;+ // distance so the largest object dimension fits vertically in the frame+ const distance = (maxDim / 2) / Math.tan(fov / 2);+ const az = ((options.azimuthDeg ?? 0) * Math.PI) / 180;+ const el = ((options.elevationDeg ?? 0) * Math.PI) / 180;+ const dir = new THREE.Vector3(+ Math.sin(az) * Math.cos(el),+ Math.sin(el),+ Math.cos(az) * Math.cos(el),+ );+ camera.position.copy(center).addScaledVector(dir, distance);+ camera.near = Math.max(0.01, distance - maxDim);+ camera.far = distance + maxDim * 2;+ camera.lookAt(center);+ camera.updateProjectionMatrix();+}++// Plan 1.3 §3.2c — PRESENTATION composer (DOF + bloom). CRITICAL (R-POSTFX): this is+// for the showcase/hero render ONLY. The Divine Eye's EVALUATION render MUST use a+// plain renderer with NO composer — bloom blows highlights and DOF blurs edges, which+// would corrupt the deterministic IoU/DCD/edge/blowout signals. Enable dof/bloom ONLY+// when the reference photo actually exhibits them (detect_reference_effects.py authorizes).+export function createAK47WildLotusPresentationComposer(+ renderer: THREE.WebGLRenderer,+ scene: THREE.Scene,+ camera: THREE.Camera,+ options: { dof?: boolean; bloom?: boolean; bloomStrength?: number; dofFocus?: number; dofAperture?: number } = {},+): EffectComposer {+ const composer = new EffectComposer(renderer);+ composer.addPass(new RenderPass(scene, camera));+ if (options.dof) {+ composer.addPass(new BokehPass(scene, camera, {+ focus: options.dofFocus ?? 10.0,+ aperture: options.dofAperture ?? 0.0002,+ maxblur: 0.01,+ }));+ }+ if (options.bloom) {+ const size = new THREE.Vector2();+ renderer.getSize(size);+ composer.addPass(new UnrealBloomPass(size, options.bloomStrength ?? 0.4, 0.4, 0.85));+ }+ return composer;+}++export function configureAK47WildLotusRenderer(renderer: THREE.WebGLRenderer): void {+ // Load-bearing for view-dependent finishes (anodized / Doppler): without ACES + sRGB+ // the environment reflection reads flat/washed instead of a believable metal response.+ renderer.toneMapping = THREE.ACESFilmicToneMapping;+ renderer.outputColorSpace = THREE.SRGBColorSpace;+}++export function createAK47WildLotusInspectControls(+ camera: THREE.Camera,+ domElement: HTMLElement,+): OrbitControls {+ // View-dependent finishes only read correctly once the user orbits — their color+ // comes from the environment reflection, not albedo, so free rotation matters here.+ const controls = new OrbitControls(camera, domElement);+ controls.enableDamping = true;+ controls.minDistance = 1.0;+ controls.maxDistance = 8.0;+ controls.autoRotate = false;+ return controls;+}