Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
HUMANOID-X0 — Canonical adult humanoid foundation
Date: 2026-09-16
Verdict: Meaningful progression
X1 status correction: The procedural body below is now explicitly
NONCANONICAL-SyntheticRegressionFixture; historical identity and test APIs
remain for replay only. The earlier proposed follow-up of improving its Antonia
fit is superseded by HUMANOID-X1, which adopts original
Antonia topology as an unpromoted candidate. Historical descriptions of the X0
surface as canonical are not a current usability or production-admission claim.
Did Aetheris successfully create and validate an independently authored canonical adult humanoid topology that can be deterministically fitted to a screened licensed reference and used as a stable semantic humanoid substrate?
Partly. Aetheris now owns and validates a real canonical adult domain: independently generated topology, stable identity, semantic regions, skeleton, skin weights, typed landmarks, measurement protocols, morphs, attachment frames, display export, diagnostics, and provenance. Deterministic Antonia registration runs and preserves connectivity, but it does not meet X0 fit budgets. The pose sweep also reports orientation-reversal proxies at the major joints. In addition, the recon review does not clear the converted char.blend component as canonical output. The authored neutral template therefore remains canonical; fitted positions are local research evidence only.
The next blocker is narrow and measured: replace the current coarse same-region nearest-surface correspondence with reviewed source landmarks and a deformation graph or cage that can reduce the 74.58 mm bidirectional RMS without violating the 3.0 edge-stretch bound, then requalify shoulder/hand, crotch, knee, and foot regions. Pose weights at shoulders, elbows, hips, and knees also need refinement before the deformation witness can pass.
Canonical authority
Aetheris.Humanoid is a domain module beside the existing engineering domains. ImportedHumanoid retains external topology, source pose, and provenance. CanonicalHumanoid requires the stricter Aetheris identity and validation laws. No Firmament syntax is frozen.
The canonical frame is millimetres, right-handed, +X anatomical right, +Y forward, +Z up. The origin is the mid-sagittal pelvis projection on the common sole plane. The authored neutral is normalized to exactly 1750 mm; this is an engineering normalization, not a population mean.
The canonical artifact is generated by repository code from explicit anatomical SDF primitives on a fixed 24 mm lattice, split into six deterministic tetrahedra per cell and polygonized at the zero isovalue. Faces below 0.0001 mm2 are deterministically rejected. Antonia coordinates and connectivity do not participate in generation.
| Property | X0 result |
|---|---|
| Topology ID | aetheris.humanoid.adult.standard.v1 |
| Binding triangulation | aetheris.humanoid.adult.standard.v1.binding-triangles.v1 |
| Vertices | 16,868 |
| Triangles | 33,716 |
| Semantic regions represented | 31 |
| Outer-skin triangles | 33,268 |
| Eye triangles | 224 left + 224 right |
| Connectivity SHA-256 | 1d4828e1966c6be96409b1bc9f285ae8a5b1f6ded2ba0c523da61d71bc51e2eb |
The surface has stable vertex and face IDs, binding triangles, explicit region symmetry, vertex symmetry involution, component declarations, and semantic material regions. The outer skin, left eye, and right eye are separate components. The mouth seam is surface-only; a mouth interior, teeth, and tongue are deferred. Connectivity is triangle-based and generated from a tetrahedral lattice. It is not quad-dominant and does not yet provide artist-authored deformation loops. Hands have separated authored finger primitives and semantic chains, but the lattice resolution limits finger and facial detail.
The full JSON/OBJ artifacts and before-fit renders are generated under artifacts/local/humanoid-x0/. The compact tracked fixture is fixtures/Canonical/Humanoid/adult-standard-v1.fixture.json.
Antonia reference and admission
The only X0 geometric reference is Antonia Polygon from https://github.com/Upliner/CharMorph-db at revision a8512ac299c0cb1724c7b5417267c94bef024d64:
- file:
characters/antonia/char.blend - object:
cm_antonia - SHA-256:
4bc468c44c8ca7c6971cac3692c5d670b09f6723687e89cd49f258c2a8251c69 - license evidence: character
config.yamlandlicense.txt, CC-BY 3.0 - attribution: based on Antonia Polygon by Olaf Delgado-Friedrichs, with phantom3D, MikeJ, DieTrying, Fenrissa, and the other contributors credited in the source package; no endorsement implied
The research fit reads only outer-skin polygons using material indices 5, 6, 9, 10, 11, and 12. It does not execute CharMorph code and does not ingest source connectivity, texture images, morph arrays, source rigs, source weights, scripts, shared libraries, clothes, or hair. Blender is launched with --factory-startup --disable-autoexec.
The mission authorizes this bounded local study with attribution. The earlier recon found no separate grant for the converted char.blend component. The tracked sidecar therefore says canonicalOutputAdmission = blocked-pending-review-of-char-blend-conversion-component-scope. No Antonia geometry or fitted coordinates are packaged as Aetheris canonical source.
Registration evidence
The frozen config is aetheris.humanoid.registration.antonia-x0.v1, seed 0. It verifies the source hash and admission sidecar, normalizes admitted Antonia outer skin to a common 1750 mm sole frame, evaluates the canonical LBS A-pose in the source study pose, builds same-region BVHs, and runs five bounded projection/smoothing passes. Correspondence is gated by semantic region, side, distance, and surface-normal compatibility. Paired displacements enforce symmetry. Pair-local backtracking prevents newly inverted or collapsed faces. Tie-breaking and every weight, cutoff, iteration count, projection bound, and validation budget are tracked in fixtures/Canonical/Humanoid/x0-registration-config.json.
The template connectivity hash before and after fitting is identical. The pipeline copied no source connectivity. A separate same-topology synthetic test recovers a known smooth displacement to below 0.001 mm while preserving faces and connectivity identity.
| Metric | Result | X0 budget | Pass |
|---|---|---|---|
| Same-region landmark proxy RMS | 110.84 mm | 5 mm | No |
| Same-region landmark proxy max | 257.73 mm | 15 mm | No |
| Bidirectional area-weighted surface RMS | 74.58 mm | 5 mm | No |
| Bidirectional area-weighted surface p95 | 180.85 mm | 10 mm | No |
| Surface max | 325.84 mm | reported | — |
| Canonical vertex correspondence coverage | 98.65% | reported | — |
| Newly inverted faces | 0 | 0 | Yes |
| Collapsed faces | 0 | 0 | Yes |
| Edge-stretch p95 | 2.74× | reported | — |
| Edge-stretch max | 51.47× | 3.0× | No |
| Symmetry residual RMS | 0.0000046 mm | reported | — |
| Self-intersections | not implemented | 0 if detector qualified | Not qualified |
The “landmark” values above are explicitly nearest same-region surface proxies. There is no reviewed Antonia landmark sidecar, so they cannot satisfy the landmark-correspondence acceptance gate. They are retained to expose the failure rather than invent source anatomy.
The five projection passes reduce accepted-vertex preprojection RMS from 70.87 to 43.52 mm. The face region is close by this proxy (4.40 mm RMS, 7.57 mm p95), but its maximum is 44.25 mm and visual review remains mandatory. Shoulders/armpits/hands are the dominant failure at 154.10 mm RMS. The combined crotch proxy is 41.84 mm RMS; knee/foot proxies are 52.97 mm RMS. Ears currently share the coarse head region statistic and need their own correspondence class.
On the recorded Blender 5.2.2 run, input admission, loading, pose alignment, fitting, metrics, and evidence assembly took 2.13 seconds before rendering. Canonical template generation took 2.08 seconds on the same machine. These are reproducibility observations, not performance budgets.
Matched front, back, side, and iso renders, a fitted wire overlay, landmark overlay, and error heatmap are emitted locally. The three bodies in matched renders are Antonia admitted outer skin, the independently authored pre-fit template, and the local fitted canonical topology. Visual evidence does not override the numerical failure.
Skeleton, bind, and pose
The canonical skeleton has 55 semantic joints: root/pelvis/spine/chest/neck/head; bilateral clavicle, shoulder, elbow, wrist, hip, knee, ankle, and toe base; three-joint thumb chains; three-joint index/middle/ring/little chains. Eye and jaw kinds are declared optional but are not required by the X0 skeleton. External rig names are never canonical authority.
Rest and bind are the shaped instance's canonical A-pose. Local transforms map child-local coordinates into the parent. Runtime math uses System.Numerics row-vector matrices: pWorld = pModel * InverseBind * GlobalPose. Bind reconstruction is validated to 0.001 mm. Procedural region-based weights are finite, nonnegative, bounded, and normalized per vertex. X0 uses linear blend skinning.
The bounded sweep evaluates shoulder 35°/70°, elbow 45°/90°, hip 35°/70°, and knee 45°/90°. All eight cases are finite, preserve face identity, have zero collapsed triangles, and move surface-bound attachment points with their semantic follow joints. Surface-area ratios range from 1.003 to 1.119 and absolute-volume ratios from 0.985 to 1.006. The current orientation-reversal proxy reports 48–203 affected triangles depending on pose, so the sweep is not accepted as stable deformation. This isolates procedural joint weights and coarse joint-region topology as a remaining foundation blocker; no cinematic-quality claim is made.
Landmarks, measurements, and attachments
Landmark types remain separate: SurfaceLandmark, JointLandmark, MeasurementLandmark, and AttachmentLandmark. Surface landmarks bind by topology ID, stable face ID, binding triangle, and barycentric coordinates. X0 contains 33 surface and 55 joint landmarks. Placement protocol, confidence, symmetry partner, provenance, and review status are explicit. Authored surface points are marked unreviewed pending human anatomical review.
Measurement protocols name their version, measurement pose, operands, units, evaluator, and validity. Neutral engineering values are:
| Measurement | Value |
|---|---|
| Height | 1750.00 mm |
| Shoulder width | 467.60 mm |
| Hip-width proxy | 222.11 mm |
| Arm link-chain length | 584.19 mm |
| Leg link-chain length | 842.06 mm |
| Foot-length proxy | 309.26 mm |
| Hand-length proxy | 168.11 mm |
| Chest-depth region extent | 249.99 mm |
These are reproducible engineering proxies, not certified anthropometry. Waist and chest circumference remain unsupported rather than estimated from arbitrary bounds.
Nineteen attachment sites cover head, face, chest, upper back, waist, bilateral upper arm, wrist, hand, thigh, shin, ankle, and foot. Each stores a surface binding, neutral tangent/normal/binormal frame, semantic follow joint, and offset policy. The pose evidence serializes all neutral/posed positions. For example, left-wrist position moves from approximately (-528, -48.83, 877.97) mm to (-600.32, -48.83, 1276.29) mm under 90° elbow flexion; chest and waist remain on their unchanged follow joints. Foot sites move with hip/knee poses. Orientation follows the same skeleton transform as position.
Morph system
Four bounded MeasuredDimension channels are implemented without ML:
| Channel | Min | Default | Max | Method |
|---|---|---|---|---|
| Height | 1650 mm | 1750 mm | 1850 mm | piecewise leg/torso stature distribution |
| Arm length | -50 mm | 0 | +50 mm | bilateral weighted shoulder-elbow-wrist extension |
| Leg length | -60 mm | 0 | +60 mm | bilateral hip-knee-ankle extension with sole fixed |
| Shoulder width | -40 mm | 0 | +40 mm | symmetric transverse shift with torso blend |
Every endpoint is tested for unchanged topology and canonical validation. Shape-dependent joint positions, local rest transforms, inverse binds, landmarks, measurements, and attachment positions are recomputed from the shaped surface/skeleton. Out-of-range controls fail with HUM013_MorphOutOfBounds.
A combined Height=1800 mm, LegLength=+35 mm variant measures 1800.00 mm tall and 882.78 mm in the leg link-chain, while retaining the same topology hash. Shoulder width stays within 0.002 mm of neutral. Arm and hand proxy values also change slightly because stature is distributed semantically through the torso; that cross-effect is recorded rather than described as independent anthropometric solving.
Provenance and replay
Tracked authority and local evidence form this chain:
adult-standard-v1.fixture.jsonidentifies the Aetheris generator and expected topology.antonia-reference.sidecar.jsonpins Antonia source, hash, attribution, component scope, exclusions, and the unresolved output-admission gate.x0-registration-config.jsonfreezes the deterministic fit.- Generated
canonical-adult-standard-v1.jsoncontains surface, semantics, skeleton, weights, landmarks, measurements, morphs, sites, and authored-template provenance. - Local
fit-provenance.jsonhashes canonical input, reference, sidecar, config, fitted positions, and connectivity. - Local
fit-evidence.jsonrecords screening metrics and failure reasons;pose-sweep-evidence.jsonrecords pose behavior.
From the repository root:
pwsh -File scripts/qualify-humanoid-x0.ps1
# Cached reference and focused development replay:
pwsh -File scripts/qualify-humanoid-x0.ps1 -SkipFetch -SkipFullTests
The script fetches/verifies pinned research inputs, generates and inspects the canonical artifact, runs Blender with source scripts disabled, renders evidence, emits fit and pose evidence, runs focused tests, builds the solution serially, and runs the full solution tests. -SkipFetch is available for a verified local cache and -SkipFullTests for a focused iteration. Generated and third-party data remain under ignored artifacts/local/.
Hash mismatch, missing admission, invalid topology, missing bindings, non-finite coordinates, invalid skin sums, and out-of-range morphs fail closed with structured HUM diagnostics. The fit itself emits evidence with screeningVerdict: fail; it is never promoted to the canonical artifact.
Fresh-agent handoff results
Three agents began from this guide and the named compact fixtures without reading implementation source:
- Domain use: PASS. The agent generated and inspected the fixture, reported height 1750 mm and shoulder width 467.60 mm, posed the left elbow to 45°, and retrieved the complete left-wrist attachment frame. The posed wrist position was
(-646.65, -48.83, 1062.15)mm with tangent/normal/binormal present. - Morph use: PASS. The agent created the documented 1800 mm, leg +35 mm variant, independently inspected it as valid, measured 882.78 mm leg link-chain length, and verified the same topology ID, connectivity hash, 16,868 vertices, and 33,716 faces.
- Fit handoff: PASS for reproducibility. Using
pwsh -File scripts/qualify-humanoid-x0.ps1 -SkipFetch -SkipFullTests, the agent regenerated the evidence without CharMorph internals. The run preserved the connectivity hash, reproduced the failing 74.58 mm/180.85 mm surface RMS/p95 and 51.47× maximum edge stretch, emitted the blocked output-admission status, and passed 25/25 focused tests.
The first two agents needed --help because the initial guide named commands without copyable argument forms; the exact forms and joint/frame conventions below were added in response. The fit agent noted a Blender 6.0 deprecation warning for Material.use_nodes; Blender 5.2.2 replay remains successful.
Validation record
dotnet build Aetheris.slnx -m:1: passed with 0 errors and seven existing WebAssembly/analyzer warnings.Aetheris.Humanoid.Tests: 25/25 passed, including deterministic template generation, invariants, synthetic registration/replay, fit rejection diagnostics, all morph endpoints, measurements, bind reconstruction, attachments, and pose evidence.- Built-in module and CLI module-list checks pass with
Aetheris.HumanoidandHumanoid.CanonicalSurfacevisible through the realaetheris modules --jsonpath. - The full solution test run completed. Its concurrent pass exposed the just-added CLI expected-module-list fixture and one timing-sensitive server tessellation assertion. The fixture was updated and its exact test passed; the unchanged server test passed on immediate isolated rerun. All other reported test projects passed, including 977 Kernel Core, 1,550 Firmament, 148 Continuum, 103 Modules, 99 Sheet Metal, and 43 FEA tests.
Intended API use
var humanoid = CanonicalAdultTemplate.Create();
var measurements = HumanoidMeasurements.Evaluate(humanoid);
var pose = new HumanoidPoseState(
"elbow-45",
[new(HumanoidJointKind.LeftElbow,
Quaternion.CreateFromAxisAngle(Vector3.UnitY, MathF.PI / 4))],
HumanoidTransform.Identity);
var wrist = HumanoidPosing.EvaluateAttachment(humanoid, "site:Wrist.Left", pose);
var tall = HumanoidMorphing.Apply(humanoid, new Dictionary<HumanoidMorphId,double>
{
[HumanoidMorphId.Height] = 1800,
[HumanoidMorphId.LegLength] = 35
});
The CLI artifact path supports the same operations through generate, inspect, morph, pose, and sweep commands. The fit handoff requires only this guide, the sidecar, template artifact/ID, frozen config, Blender, and the hash-pinned blend; it does not require CharMorph internals.
dotnet run --project tools/Aetheris.Humanoid.X0 -- generate --out-dir artifacts/local/humanoid-x0
dotnet run --project tools/Aetheris.Humanoid.X0 -- inspect --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json
dotnet run --project tools/Aetheris.Humanoid.X0 -- morph --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json --output artifacts/local/humanoid-x0/adult-1800.json --height 1800 --leg-length 35
dotnet run --project tools/Aetheris.Humanoid.X0 -- pose --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json --output artifacts/local/humanoid-x0/elbow-45.obj --left-elbow-deg 45
dotnet run --project tools/Aetheris.Humanoid.X0 -- sweep --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json --output artifacts/local/humanoid-x0/pose-sweep-evidence.json
CLI joint-degree controls use the same right-handed local rotation axes as the C# API: shoulder/elbow use +Y and hip/knee use +X. left-elbow-deg 45 therefore matches the C# example. Attachment JSON orders its orthonormal basis as tangent, normal, binormal, followed by its posed position. A height morph updates both the evaluated Height protocol and Frame.NormalizedHeightMm; the unchanged 1750 mm value identifies only the neutral authored template.
Boundaries
This is one adult reference and one authored neutral. Diversity and cross-body qualification are deferred. There is no mean-body, PCA, broad-population, medical, child, or elderly claim. There is no second admitted reference. Reom remains excluded.
The face is neutral and coarse, without expression basis, FACS, lip sync, or a qualified mouth interior. Shoulder and hip skinning fail the current pose-orientation screen. Hands and feet are semantic but low-detail. There is no qualified self-intersection detector, garment or hair system, gait or grasp solver, ML model, VRoid parser, runtime dependency on CharMorph, or manufacturing-BRep representation of skin.
The completed substrate removes the need to rediscover IDs, frame, region vocabulary, skeleton, binding convention, typed landmarks, measurements, attachments, morph boundaries, diagnostics, and provenance. Acceptance now depends on improving registration correspondence/deformation and joint-region skinning, not on inventing another humanoid architecture.