You can now generate creatures directly within your project. Drop the open-source into your Agent, and start prompting what you want.
CHANGELOG
1.3.2 — the creature declares what its parts are for, and the engine makes it pay
The declaration
functionon each chain:axis/locomotion/effector/ornament. Manufacturing vocabulary only — nothing about damage, hardness or worth. A part bolted to a chain inherits that chain's function, so the blade on the neck is covered without naming it.- Six checks make the declaration cost something. A label nobody verifies rots, and each of the six blocks a defect class the engine could not see before.
Joint limits are declared, and the body is asked whether it agrees
joint_rangeon each joint: degrees per axis, in the joint's own frame, the same axis names the tracks use. An axis left out is LOCKED at 0;"free"opts one out. The L side is authored and the R side is generated —ry/rznegate, which swaps the interval's ends — because a hand-written mirror is the bug this release just finished fixing.- The numbers are authored because a spec writer already knows a knee is a hinge and an elbow does not twist, and that is not computable from vertices. They are then CHECKED because the author does not know how thick THIS body is: every declared bound is swept against the geometry, and a limit the body cannot reach blocks with the angle that can. A gorilla's shoulder swings 60° back; a gorilla with a wrecking ball hanging off a crane on its back stops at 50°, and only the sweep knows that.
- Three failures with three different fixes:
undeclared(a clip turns a joint with no entry),overrun(a track leaves its own interval),unreachable(the body collides first).
Every part has a name, and the name reaches the file
nameis required on every part and must be unique. A material is a CLASS — primitives merge one per material so a forty-plate body does not ship forty draw calls — so a material name can never say WHICH part something is. The samepawmaterial sits on a foot pad and on a nose-leaf, and anything aggregating by material adds them together.asset.extras.part_spansrecords, per part, the primitive and the[first, count]vertex range it owns. Same materials, same primitives, same bytes of geometry: the identity simply stops being thrown away at merge time. Mirrored twins carry.R, an eye pair carries.L/.R.- This was not cosmetic.
self_clipkeyed its meshes by material and host, so thirteensteel_boltparts on one creature collapsed to one entry and twelve of them were never narrow-phase tested. With names, the check found a real interpenetration on the first rebuild.
Mirroring was truncating every mirrored limb
mirrorTrackresamples instead of shifting keys. The old code mapped a key att=1ontot=phase, where it collided with the key already there and the sort dropped the rest of the track — the mirrored limb froze partway through the cycle. Every mirrored track was affected. Fixing it also clearedroot_drivefailures that were downstream of it.
Checks
gait_footfall— a step must land in FRONT of where it lifts, measured against the foot's own liftoff point, not the hip: a bird's hip sits inside the body and a hip-relative test calls a correct walk wrong. The contact window now expands contiguously from the foot's lowest frame; thresholding the whole cycle split the window the moment the pelvis bobbed.effector_leads— at the frame the attack reaches furthest forward, the declared effector must be the frontmost mesh. The frame that matters is peak reach, not the last frame.attack_windup— 5% back, or 15% out to the side. Either route passes; a weapon that cannot pull straight back without sweeping through the body goes around.self_clip— swept self-collision. Sphere proxies bound to the dominant bone for the broad phase, real mesh distance only for the pairs it names: 0.3–0.7 s for all three clips. Pairs that already touch at rest are excluded — that ispart_overlap's question.clip_closes— a clip that does not loop still snaps back when it ends.ground_clip— nothing below the plane the creature stands on. The receiving physics builds its collision proxy from the mesh; a hand under the floor lifts the whole body.
harness/autofix.mjs
- The arithmetic corrections, run before a round is spent: the ground offset onto the root's
ty(chasing it with joint angles does not converge), loop closure, and compensation for joints that must hold their own aim while the body turns for some other purpose. - Compensation is written as the parent's inverse rotation, not solved by iterating on
angles — past vertical the
atan2jumps and the correction diverges. - Compensation is subordinate to the purpose. A head aimed forward pushes its muzzle out in front; if that overtakes the effector the strike reads as a head-butt. The share is solved for, not assumed.
- It never touches decisions: which way a leg swings, what the creature attacks with, how far it lunges. Those stay with the designer.
The browser is gone
- Nothing in this package launches a renderer any more.
setup.shinstalls no Chromium, so the class of install failures where a blocked CDN stalls setup is gone with it, and the harness isthreeplus numpy/pillow/scipy. - Every number the renderer used to produce is arithmetic on the vertices, and now lives
in ONE file:
harness/outline.pyalready owned the silhouettes and the z-buffer that attributes part shares, so it took the rest. Part shares, the colour numbers, the clip and skin list, per-part bounding boxes — all of it read from the file it was already reading.judge.mjsstopped taking its own photograph of the same model and now checks its claims against outline's numbers. - The colour ruler is verified, not asserted: run both ways over a reference shelf, the
saturated-area measure agrees with the browser's at r=0.999 and the same thresholds
carry over untouched.
style_dark/style_lightdeliberately changed meaning — they now read the creature's OWN colour instead of a studio render of it, which is what the designer controls; the two correlate at r≈0.96 but are not the same scale, so a pre-1.3.2 threshold needs re-picking once. hero.pngis projected, not rendered. The entire L1–L8 shading stack is baked into the vertex colours at build time, so lighting it again in three.js was lighting a photograph. Same z-buffer, transparent background, framed to its own content.- Two view conventions moved to the tool that survived:
sideis the LONG profile rather than a fixed +X camera (the old one showed a spread-winged creature edge-on and called it a side view), and the three-quarter view ishero—tqstill resolves to it. - Retired:
silmetrics.mjs,maskmetrics.py,hero.mjs,pwlaunch.mjs,pwprobe.mjs,calibrate.py. The SHARED-TOOL QUEUE that named their duplicate measures now prints nothing.synccheck.pyrefuses any file that imports playwright or launches chromium.
The trap list became code where it could
- Four engine traps that were previously only written down are now the engine's own words, at the moment they happen, instead of a document
someone has to have read:
- a
finwhose outline has two nearly-coincident points is refused BY NAME, with the two indices and the distance. It used to extrude into flipped triangles and surface later as amesh_integritycount with no address, costing a round of bisection. - a
joints_Rentry written relative to itself says so, instead of "dependency cycle", which sends the author hunting for a loop between joints that does not exist. eye_pupilnames a lone eye sphere for what it is: a flat coloured disc, which at reading size is a sticker. An eye reads by the value step between iris and pupil.part_overlapabove.
- a
- The rest of that list is process advice already covered by the cards, or notes that belong to the operator. It does not ship as a document.
part_overlap was comparing boxes
- The check that reports one part sitting inside another tested A's vertices against B's axis-aligned BOUNDING BOX. A box is not a shape: a 2.8 m spear's box contains any hand gripping it, so the check reported the hand as buried in the spear. The signal was not noisy, it was wrong, and acting on it removes parts that are correctly placed. Same error class as the sphere below.
- Measured against the real surfaces now. On a reference creature the count halved (32 → 16) and what disappeared was box artefact.
- Two severities, because they are different problems: COMPLETELY buried is invisible geometry that still costs triangles, and partial is a seam, which is usually the point.
The signature has to say whether it is visible in black
- Gate 1 reads a 48px silhouette, which has exactly one dimension. A feature made of colour, of COUNT (nine faces, one leg), of something soft, or of a face has no boundary in one — so betting a creature's identity on it asks Gate 1 to measure what it cannot see.
brief.pynow blocks a signature slot that does not endsilhouette: yesorsilhouette: no. It does not forbid the bet; it forbids it being an accident. "No" is allowed and often right — it declares that MID or HIGH carries the feature and the body has to carry the identity on its own, decided before the rounds are paid for.
The trap list ships
cards/PITMAP.md— facts about this engine that are expensive to discover by trial: the shapes it refuses, the fields that must be declared a particular way, the corrections that never converge. Card 00 sends you there before you author anything.
A volume is not a string of spheres
root_containment,limb_clearanceandpart_attachmentall asked the same question — "is this point inside that volume, and if not, how far out?" — and all three answered it by finding the nearest ring CENTRE and comparing against a SPHERE of that ring's widest radius. A volume is a lofted tube, and that sphere bulges past the END CAP by a whole half-width. The error is therefore worst exactly where it matters most: at the end of a chain, which is where the next chain attaches. A torso 0.80 m wide handed out 0.4 m of phantom "inside" straight off the chest, so a head sitting 0.33 m in front of the last ring centre was declared buried while its real distance to the surface was 0.24 m — a floating head, attached only by two stray vertices of a foreleg.engine/core/inside.jsmeasures against the triangles the file will actually ship, and all three checks now call it. The sign comes from the closest triangle's own normal, not from a ray cast, because an attached chain leaves its root ring open on purpose and ray casting needs a closed surface.root_containmentnow judges by the ring's MEDIAN rather than a count of points. A ring meets a CURVED host, so a few of its points always poke out; across a reference set of 102 joints the median sits inside on 95 of them, and the 7 it does not are the ones you can see.- The corrected distance is stricter than the sphere was hiding: the same 1.5%-of-height
tolerance that
part_attachmentalways had now sits on the 99th percentile of that set instead of nowhere, and it catches parts standing 4–6 cm clear of their host.
One creature is one connected body
body_islandswalks every piece, unions the ones that share material, and refuses anything that comes back as more than one object. The weld is 3% of model height at three points — two stray vertices poking in is a coincidence, not an attachment.- It exists because the three checks above all ask a LOCAL question (is this piece seated in ITS host) and the failure was global, and because a silhouette cannot see it either: a head floating inside the outline is not a hole in the mask.
- 3% is a floor, not a target. Well-built parts sit anywhere from fully embedded to ~3% of height off their host and there is no gap in that distribution to put a threshold in, so this takes the loosest value that is still correct. The failure it exists for is 9.3% — three times the bar.
Gate 1 stopped grading itself
identity.pyused to ask you which rank the brief's noun reached, and one judgment sat under that number: does "hound" count as "wolf"? The only party available to make it was the party being graded. A brief can already carry an accepted list, and nothing compared the reader's words against it.- Now you hand over the reader's words, verbatim and in order (
--guesses side="…"), and the machine matches them against the brief's accepted list. Widening the family is still the designer's call — it just has to happen in the brief, before the geometry exists, instead of at r3 with a shape to defend. brief.pyblocks an identity slot with no accepted list. It is one line, it costs nothing to write generously, and it has to be on the record.
Housekeeping
synccheck.pyrefuses any file namedDEVLOG*: a lab notebook never ships, and the filename is the only rule that works in every language.example/wolf.jsonbuilds green under the 1.3.2 checks: named parts, declared joint limits, and a stride that no longer walks the hind paw through the front one. The shipped example is the reference the cards point at; it has to pass its own gates.outline.pysays so out loud when scipy is missing. It used to return four keys short — protrusions, thinnest feature, convexity, mirror symmetry — so the legibility and boldness gates had nothing to read and every build passed them by default.
1.3.1 — reads are scored, the brief is checked, and everything computable is computed
Publishing hands back two links, and the second one is checked (2026-09-03)
- The server answers a successful upload with a claim link as well as the one-time
takedown code. This build matched exactly one field name,
manage_token, so the claim link never reached anyone using it.harness/publish.mjsnow reads a family of names, classifies each value by shape, and keeps the first link AND the first code — neither may shadow the other: the link lists the model under your account (Google sign-in, dies once used), the code removes it (one-time, cannot be re-issued, no sign-in). - The claim link is GETted before it is handed over.
claim_link_liveistrue,falseornull(could not ask — which changes nothing, since the upload just succeeded through the same network). Onfalse,harness/ship.pygivesclaim_fallback_urlinstead: the standing claim page, which takes the same key. Nobody is ever sent to a 404. cards/04_SHIP.mdhas a row formanage_kind: both, which is the normal case.- Behaviour is verified against all four shapes the server can answer with.
The blind read
- Gate 1 is SCORED by rank and view count (
harness/identity.py) instead of demanding one exact word: rank R passes if the noun reached R in at least R views, and the requirement loosens by one view per repair round. 3 of 4 views, the brief's identity view among them. - A round builds TWO OPPOSITE POLES of one named axis, not one attempt and not three near-copies.
round.pymeasures how far apart they sit on the mass-layout ruler and refuses to spend a reader on one design built twice (floor 0.25). - ONE reader does a whole gate — choosing the winner AND confirming 3-of-4 — in a single batch.
- On an identity FAIL,
identity.pynames the views not yet read and requires them to be tried before a rebuild. - The "wider or taller?" binding question is retired; the bump count and the canary remain.
- Thumbnails are letterboxed, not squashed, so the proportion the reader sees is the proportion the file records.
Computed instead of read
harness/outline.pyproduces silhouettes from the GEOMETRY — no browser in the LOW loop. Same camera, same masks, same measures, plusiou_vs_prevand mass-layout thirds.value_ordersorts every material by OKLab lightness on each build; whatever is brightest owns the eye, and anything within 0.05 L competes.contrast_adjacentcompares every part against the material of the thing it sits on; under 0.10 OKLab they read as one mass.thinnest_px48is information only and no longer blocks.- MID spends NO reader: both the isolated part read and the colour read are deleted, replaced by the two checks above.
The brief
harness/brief.pychecks the brief for PRESENCE, never content, and runs insideround.pyat r1. Five slots plus the one exaggeration block when blank; the other four are noted.- Slots that name parts also name their CHAINS, and the r1 spec must contain them.
- Material is not judged anywhere: no "what is it made of", no roughness words in the value plan.
The engine
soft_mass— a volume that cannot break anywhere renders as a bean, and that is the DEFAULT. Blocked, with the fix in numbers;"soft": trueopts a mass out.gait_direction— a planted foot must sweep BACKWARD; a forward sweep is a walk cycle playing in reverse.root_drive— a lunge must be driven on the skeleton ROOT, or the creature is nailed down by the end that did not move.- The L1–L8 shading stack moved into the engine (
engine/core/shade.js) and runs on every build. - Every blocking message states the FIX with the number to apply, not just the fault.
<out>.checks.jsonis written on refused builds too.
The harness
harness/fit.pymakes a spec LEGAL before a round is spent on it. A refused build is refused for two different reasons: DESIGN (the shape does not read) and ARITHMETIC (a root ring is not buried, two bones came out the same length, the height is off). The engine already prints the exact correction for the arithmetic ones;fit.pyreads them back, applies them, rebuilds and repeats. It never touchesbalance,mesh_integrity,touch,part_seator any style threshold — those need a decision.root_containmentnow names the CHAIN'S OWN root joint instead of the host joint it hangs from. Moving the host drags the chain with it, so the old advice could not converge; applying it repeatedly just walked the pair across the model.- One command per round (
harness/round.py): build, render, measure, pre-check, one report. harness/gates.jsonmaps all 35 checks on five axes — enforce, when, by, kind, dept — andgates.pyprints them.stageis a field: LOW/MID/HIGH are levels of refinement, not a fixed department order.byis A/B/C: which source produces the verdict.pwlaunch.mjsfinds a cached browser underPLAYWRIGHT_BROWSERS_PATHbefore any download; a build-number mismatch is not a missing browser.synccheck.pyguards the version strings, the promised features, the required files, duplicate measure definitions and the public/private boundary. Its site-specific leak words moved OUT of the script intoharness/leakwords.local.txt(git-ignored, never packed) — a list of names you refuse to publish, written into a public file, publishes them. It also refuses a tree in which any shipped file points at adocs/page that stayed home: a dangling filename names the private document and no one can open it. And it refuses a tree that describes a version which is not out yet: saying a file behaves "identically to" an unreleased build announces that build, its feature set, and that it has users.- Iron law 3 is counted by
roundcheck.py, not self-applied; iron law 9 — one creature, one agent, the reader is the only subagent.
1.3.0 — the first-users release: joins verified, fresh installs survive
Field reports (first two public days) split into two classes; both are closed here.
Install class — "setup said OK, then everything broke"
setup.shnow installs the browser (npx playwright install chromium; skipped whenPW_CHROMIUM_PATHis set) and probes a real launch (harness/pwprobe.mjs) before printing "calibrate OK". The npm package alone ships no browser, calibration never needed one, so 1.2.0's setup passed on a fresh machine and the FIRST silhouette died with a Playwright stack trace.- All render tools share one launcher (
harness/pwlaunch.mjs): a missing browser now prints one actionable line —run npx playwright install chromium— never a stack. - A hero failure no longer kills the delivery: the GLB and viewer are the deliverable; heroes degrade to a warning with the fix printed.
playwrightpinned (1.62.1);setup.ps1for Windows PowerShell; CI smoke workflow runs the whole fresh-user path (setup → build → silhouettes → delivery) on every push.harness/synccheck.py— the ship gatekeeper: verifies VERSION == CHANGELOG, every promised feature is present in the shipping code, every file the cards point at exists, and no forbidden string leaks. Born from a real leak: two finished features existed in one working copy but not the one that got pushed. Run it before every push; CI runs it first.
Field-report class — the first outside user, verbatim
handpart type: palm + four fingers + an opposable thumb from onesizenumber (curl,spread,fist: truewith the thumb wrapped across); built in ONE authoritative hand frame — "issues with hands, palms, fingers and especially thumb placement" was the top quality report, and improvised sphere-and-stick hands always shipped mittens.pawgains"toes": 2..5.- Declared-height gate: the spec carries
"height"(metres); the build must land within ±15% or BLOCK, and the CLI now prints the built dimensions — "correct scaling is a skill completely missing". - README gains the copy-paste agent prompt — "how do u prompt the agent to use it in his VM exactly? thats missing in your readme". Verbatim block + three field-learned rules: don't invent a workflow prompt (it skips every gate), let the agent run setup itself (don't pre-bundle node_modules), image orders become a text brief first.
- Multi-leg gait doctrine in HIGH: diagonal pairs for quadrupeds, alternating tripods/tetrapods for 6-8 legs, adjacent legs never in sync.
- The output contract is ENFORCED, not documented: every GLB is checked against it the moment the engine writes it (a violating file is deleted, never left on disk),
deliver.pyre-checks the stamped bytes, andpublish.mjsrefuses to upload a file that fails — no card instruction, no human step. The contract: two chunks, zero trailing bytes, one embedded buffer, no URIs, no images at all, no compression extensions, semantic material names, convention bone names, metres/+Z, sane accessors, no paths or markup in any string. Creature names and signatures typed by a person are CLEANED at stamping (control characters, angle brackets, 80/60 caps) rather than failing a delivery. One implementation (harness/glbcheck.mjs, zero-dependencycheckGLB(bytes), ~1.4 ms) mirrored into the engine asengine/core/contract.jsbytools/sync-contract.mjs; synccheck fails the build if the two drift. Verified against five hostile fixtures — ZIP tail, extra chunk, external URI, path leak, duplicate JSON keys — plus an end-to-end hostile spec whose build is refused.docs/OUTPUT_CONTRACT.mdwrites the same rules down for the community server, which rebuilds submissions independently (docs/HANDOVER_sanitize.md). - Every GLB carries its birth certificate:
asset.extras.source_spec(the pristine authored spec — a second parse, since the in-memory spec is mutated by resolution) +extras.partsmanifest (kind/type/name/material/host/join per piece). Extract → edit → recompile round-trips green.embed_spec: falseopts out. On the CC0 community wall this makes every creature REMIXABLE by design. harness/graft.py— spec-level organ transplant: takes two GLBs, copies a named part (plus its palette, and for membranes the rib chains, joints, attach/mirror entries and matching animation tracks, rebased onto the new host), rescales by the two declared heights, writes a fused spec. The normal gates judge the transplant — a graft that does not seat is BLOCKED, not shipped. Never touches meshes, so AO and whole-body shading re-bake coherently on the fused creature.- example/wolf.json now declares
"height": 1.45(models best practice; enables graft auto-scaling). - Reader verification — assume every reader is lazy: every blind read (both LOW gates, every MID part read) now carries three traps — per-image binding questions checked against measured aspect/bump counts, one known-answer canary from
harness/canary/shuffled into every batch, and shuffled neutral image labels. Any tripped trap voids the whole read. A reader that glances at one image and confabulates the rest can no longer pass.
Colour portability (a creature published to a gallery came back white-and-black)
- The hue now lives in the material, not only in the vertices. Until now every material shipped
baseColorFactorwhite with the entire palette in COLOR_0, so any viewer that does not apply vertex colours rendered the creature pure white — reproduced here by stripping COLOR_0 from a build. The engine now splits the baked colour:baseColorFactortakes the per-channel MAXIMUM (the unoccluded colour) and COLOR_0 keeps the ratio (≤ 1, the AO and banding multiplier). Where COLOR_0 IS applied the result is identical — a controlled A/B measured a maximum per-channel difference of 5e-08 — and where it is not, the creature keeps its hues and loses only the shading. - Found while implementing it: dividing the colours in place corrupted them, because one vertex-colour array can be referenced from several vertices (flat fills, crease splits) and was scaled twice. The pass now builds new arrays; the A/B above is the proof.
- The colour ruler was blinded by the split, and is now calibrated. The judge's albedo pass forced
baseColorFactorto white wheneverCOLOR_0was present — correct only while the whole palette lived in the vertices. After the split it therefore measured the near-grey shading ratio alone: the wolf read 26.0% saturated before and 0.0% after, so the standard claims sheet would have failed EVERY creature at HIGH with "the creature reads as a grey mass". Albedo is nowbaseColorFactorxCOLOR_0, always both. The reason nothing caught it is the deeper fault:calibrate.pyhad never run the judge at all, so five colour norms shipped with no sample proving they separate anything. It now runs the colour ruler in both directions — the shipped example wolf must land inside the 10%-34% band (measured 26.3%), and a desaturated copy of that same file, meshes and vertex colours untouched, must be BLOCKED bysaturation_area. The colour sample isexample/wolf.json, notcalibration/wolf_green.json: wolf_green still carries the pre-1.2.0 beige palette (0.2% saturated) and exists to exercise engine blocks, where palette is irrelevant. glbcheckgains two portability warnings:flat_white_base(a material with a white base carrying vertex colours) andhigh_metal(metalness above 0.3 — with no environment map, which is the default in most galleries and engines, metal renders near-black; this is the second half of the same field failure). Card 03 states the material limits: no textures, hue in the material, metal ≤ 0.2, roughness free.
Bypass
- MANUAL.md opens with a stop sign: you do not need to build a GLB writer, a renderer, a screenshot tool or a modelling script — they are all here, they work, and starting one means you have already left the pipeline. Also corrects the header (1.3.0) and the interview line (exactly ONE question, not two).
- Delivery refuses a GLB this engine did not build. Observed twice in the field (an outside user on Reddit, then a 1.3.0 test run): an agent given the package skips the cards, writes its own GLB generator and its own render pipeline, and arrives at delivery with a file that passed no gate — no blind reads, no
attack_reach, nopart_seat, no output contract.deliver.pynow checksasset.extras.harnessand stops there: the gates ARE the product, and a file that skipped them cannot carry the stamp. The refusal names the two commands that constitute the real pipeline.
Thin orders
- The customer is asked exactly ONE question, and asking it is MANDATORY (skipping it is as wrong as asking five: picking a direction is what makes the creature theirs — one that simply arrived never gets shown to anyone) (report: a test run stopped to ask which delivery format to use and whether to add the result to a local gallery — both are the harness's decisions, and both read as incompetence to a non-designer). Card 01 branches on the order instead of interrogating: a thin order gets three directions to point at (diverging on mass / weaponised part / broken anatomy — never three colours of one idea, no answer = take the first), a specific order gets "which of the things you named should people notice first?" (that answer becomes the signature part, and with no answer the most unusual one wins). Size, temperament, proportion, palette and animations are decided silently. Card 00 adds the forbidden-question list: never ask about delivery format, file type, triangle count, folders, whether to run a check, whether to list the result anywhere, or whether the expansion is acceptable.
- A recoloured example is refused (
example_copy): a thin order tempts the shortest path — openexample/wolf.json, change the colours, ship it — and the customer who asked for a dragon receives a wolf that reads as a fox. The engine BLOCKs any build whose joints are a shipped reference spec's with the numbers barely moved (≥90% of joints identical in name AND position within 2% of height); building the reference specs themselves is exempt, so calibration is untouched. Templates were deleted from this harness for this exact disease; this stops the example becoming the last template. Card 01 also makes the identity verdict explicit: the blind reader's noun must BE the brief's noun — "a fox" when the order said dragon is a failed gate, not a near miss. - The brief is now derived from the rulers, and expanded without asking. A thin order ("a dragon") is an UNDECLARED order: every empty slot is one no gate can test, so it drifts to the trope. Card 01 lists the nine slots that downstream machinery actually reads — identity, feel, height, signature part + carrying view, mass hierarchy, the two focals, stance, the attack, the value plan — each traced to the check or claim that consumes it. The session fills them itself, in one pass, and never shows the expansion for approval (a confirmation step is a lost customer, and the gates already catch a wrong guess). Two rules keep the expansion from converging: discard the first three ideas (they are the tropes), and commit to ONE exaggeration that distorts every other slot.
Closing & community (server contract re-checked against gobkit.com/docs)
- One command closes the job —
harness/ship.py: package, or package AND publish with--publish. The old flow was two commands taking the same arguments twice, so the signature drifted between the file and the listing and the upload got skipped when the second command was forgotten. Ask the person once (name / signature / share?), run one command, read one JSON line back. The signature is remembered in~/.anyCreature.json. - Uploads survive a flaky network: the publisher retries twice with a backoff on transport errors and 5xx before declaring the network blocked — a submission lost to one cold start is a creature that never reaches the wall. Verified against a server that fails the first attempt.
--upload-only: publish an already-packaged creature without rebuilding or re-stamping it — for the person who said no and changed their mind, or whose upload failed. Card 04 requires offering it in one line.- The server's one-time
manage_tokenis no longer discarded — it is the only way a person can ever take their own model down, and the API issues it exactly once.publish.mjsnow saves it todelivery/manage_token.txtand returns it; card 04 requires it to be read out in the same message as the share link. Also accepts a bareslug(the server no longer always sendsshare_url) and builds the URL from it. - A successful upload is no longer reported as an error. The server renamed its own success state (
published→visible) andpublish.mjs, which matched the literal word, printed{"status":"error"}on a HTTP 201 and dropped the one-timemanage_tokenon the floor — the user was told their upload failed and lost the only takedown key they will ever be issued. Success is no longer a magic word: any 2xx the server acknowledges (ok !== false) that carries ashare_url,slugorurland does not name a review state IS published; a review state (/pending|review|queue/i) ispending_review; an acknowledged response with nothing to link to is also treated as uploaded, not refused.manage_tokenis now saved and returned on EVERY branch, refusals included, because a refusal can still carry the token for an earlier upload. Verified against a mock server across six responses (visible,pending_review,queued_for_moderation, a 400 refusal carrying a token, a relativeshare_url, and a bare{"ok":true}). KHR_materials_anisotropyon a mesh with no UVs or tangents is a BLOCK (anisotropy_without_direction). Reported from the server side: a brushed-metal attempt came out a flat white smear, and dropping the strength from 0.9 to 0.15 changed nothing — anisotropy stretches the highlight ALONG THE TANGENT, so what was missing is a direction, not an amount. With noTANGENTand noTEXCOORD_0to derive one from, every renderer invents its own and the model is correct in none. Untunable by definition, therefore refused rather than warned; a primitive that has one of the two getsanisotropy_derived_tangent(viewers will disagree on the direction). The fix is to unwrap first ("keep_uv": true) or to get the look from geometry and vertex colour.- Role presets removed — every creature is judged at boss standard.
harness/presets/{minion,npc,boss}.jsoncollapse into oneharness/claims.json; a cheaper creature is not a different ruler, it is the same ruler with a smallertri_budget. Interview Q2 changes from "which role?" to "how big is it in the real world?", which feeds the height gate and graft scaling.
Quality class — "parts don't stick to the body"
part_seatcheck + declared joins: every hostedcurve/spikecarries its base ring; the spec declares HOW the part meets the body —"join":"insert"(base ring ≥60% buried or BLOCK),"extrude"(base centre inside a body or BLOCK),"snap"(must ride an anchor or BLOCK),"place"(deliberately free). Undeclared roots under 50% buried warn. Kills the exposed-root class: tusks starting in mid-air, beaks hovering off the face, trunks reading as bolted-on objects.- Card 02 adds the four join verbs and the colour-continuity rule (flesh parts continue the host colour at the base); card 01's pit-map gains the join line; SYNTAX shows
"join"on the curve example.
Version renumber (at 1.2.0). 1.2.0 is the FIRST PUBLIC RELEASE. All earlier development versions were renumbered to 0.3.0–0.12.0 in release order (old 0.1.0→0.3.0 … old 1.7.0→0.12.0); the full mapping lives in the version-library README. Entries below keep their original content; their old numbers are shown with the new number in front.
1.2.0 — smooth bodies, one shading pass, saturation measured
Stage cards
- HIGH gains a fifth colour norm —
saturation_area, band 10%–34%: the share of the view whose colour carries HSV saturation ≥ 0.50, Verified: the UNLIT baked vertex colour so brightness, AO and lighting cannot skew it. Below the floor the creature reads as a grey mass; above the ceiling saturation stops working as a spotlight. It rules AMOUNT, never LOCATION — the designer picks which surfaces carry the colour. The reshipped wolf measures 26.0%; the previous wolf measured 0.2% and would fail. The accent norm now reads as a cap on the ACCENT alone (<5%), not on total saturated area. - MID's fold-and-carve vocabulary no longer offers
facetedfor masses: concave sections,sharpprofile rows and a lower per-volumesmooth_angleinstead; parts may still be faceted freely. - SYNTAX.md gains
shading,smooth_angleandbuild, marksfacetedparts-only, and dropscolors.gradient/colors.noisefrom the volume example. 04_SHIP's gate.json example listsfaceted_bodyandsaturation_area.
Engine
- Vertex normals are ANGLE-weighted and carry a smoothing angle —
smooth_angle, spec-level default 50, overridable per volume and per part. Faces meeting at a vertex average when their normals sit within the angle; the vertex is duplicated only where it genuinely carries two smoothing groups, so creases cost a handful of vertices instead of tripling the mesh."faceted": trueis now exactlysmooth_angle: 0. Area weighting let one big skinny triangle drag a normal off by tens of degrees — and AO bakes from those normals. faceted: trueon a VOLUME now BLOCKs (faceted_body): two real runs came back 89% and 93% hard-edged because the model setfacetedon the big masses; an 800-triangle torso became 800 shards, and since AO bakes from those normals the mess ships inside COLOR_0 where relighting cannot reach it. The right tools for a hard break on a body are"sharp": trueon the profile row or a lowersmooth_angleon that volume. Escape hatch for robots, constructs, golems and vehicles:"build": "rigid"at spec level. Parts (fin/spike/curve/paw/membrane) may still be faceted freely.- Shading moved from per-volume to spec-level:
"shading": {"gradient":{"top":0.30,"bottom":-0.88}, "noise":{"size":0.018,"amount":0.26}}(the defaults). The ramp is measured over the WHOLE body's Y range and applied to EVERY mesh — volumes, paws, ears, eyes, horns. Each volume used to ramp over its own bbox, so the same numbers meant different things on an upright leg and a horizontal torso (the old wolf wrote bottom -0.16 on legs and -0.04 on the torso to fake one consistent light), and parts received no shading at all, so paws read as stickers.noise.sizeis a FRACTION OF THE MODEL DIAGONAL, not an absolute distance: an absolute cell keeps its world size as the creature scales, so the same spec on a 5x larger creature produced grain finer than the vertex spacing and aliased into banding.colors.arcsstays per volume;colors.gradient/colors.noiseare ignored and emit aninfo:line. - Gamma bug fixed:
hex2linin compile.js applies the sRGB transfer function, as ao.js and glb.js always did. Before, any volume with acolorsblock shipped about 1.5x too bright with its value steps collapsed — the wolf's spine-band-to-base contrast fell from 5.3x to 2.1x, so the arc bands were effectively invisible. - AO defaults retuned: samples 14 → 16, strength 0.75 → 0.59, radius 0.35 → 0.60 of the model diagonal. One AO pass only; there is no second crevice pass and none is planned.
Harness & fixes
saturation_areaclaim in judge.mjs —{"type":"saturation_area","view":"tq","min":0.14,"max":0.34}— added at stage HIGH to all three role presets (minion/npc/boss) and tospecs/_TEMPLATE.json.setup.shinstalls scipy: harness/maskmetrics.py importsscipy.ndimage, and setup used to print "calibrate OK" then blow up mid-LOW.proportiondecides limb exemption fromspec.mirrorinstead of the chain name's first letter — renaming a chain "axis" to "Laxis" used to bypass the 50:50 ruler entirely.- example/README.md rewritten accurate: the wolf is the reference example (high-saturation area 26.0%), not a copy of the
templates/anchor removed in 1.2.0, and it ships with UV off.
1.2.0 — first public release: MID/HIGH doctrine + Gobkit delivery
Stage cards
- MID = whitelist part blind-reads, identity only: face (always) + signature part + order-named parts are rendered ALONE (
qa_isolatebuilds) and shown 4-view to a context-free reader with one question — "what is this?" A face that reads as "a ball" fails. Edit vocabulary: swap local shapes / fold-carve / bend the pose (elbows are MID); no naked sphere/cube/cone on whitelisted parts. Silhouette share demoted to a budget check. - HIGH = free colour under four norms (one high-sat main on the signature, one secondary, accent <5%, brightness floor Verified: the render) + three animations always (idle/move/attack).
- 04_SHIP (new card): gate stamp (real results only) → name + signature questions (ownership first; signature remembered in ~/.anyCreature.json) → scripted delivery → the share ask LAST, CC0 in one sentence → publish only on an explicit yes. Never auto-upload, never background, ask every time.
Engine
- Per-vertex AO bakes at compile into COLOR_0 (hemisphere rays, grid-accelerated, deterministic) — the "solid" look ships in the file;
"ao":falseis debug-only. attack_reachcheck: attack clips must drive some part ≥ half the body span past the bind front or the build BLOCKs — kills the in-place-wave class.touchdeclarations: chains declared connected must overlap or BLOCK (the floating-snake-body class).part_overlapwarn: measures gross part-into-part interpenetration (the self-intersecting-fist class) — a measure, not a law.joints_Rpose overrides: mirrored pairs grow symmetric, bind pose staggers; the mirrored skin follows its joints.- Public bone naming: exported limb bones follow
^[LR][A-Z][A-Za-z]*\d+[A-Z][a-z]$(LArm1Sh, RFrontLeg1Kn) natively — no.l/.rsuffixes, no rename pass; meshcreature, skincreature_rig; internal spec names never leak. - Primitive merge: one primitive + one material per palette entry (kills the 67-material class from mirrored parts) — semantic part names survive as material names.
- UV atlas now opt-in (
keep_uv): without textures TEXCOORD_0 was dead weight; AO no longer needs it. - Language cleanup: part types settled on
curveandmembrane, and the surface-snapping switch on anchored parts settled onconform. - Harness stamp in
asset: generatoranyCreature v1.2.0,extras.harness/.harness_version/.spec; delivery addsextras.monster+asset.copyright(user's name + signature travel INSIDE the file); publish addsextras.license: CC0-1.0at consent time.
Engine correctness — the "invisible until a human looks" class
part_attachment(new BLOCK): parts were never checked for being attached to anything.root_containmentwalksspec.attach, whose candidates must carry both_ringsandchain— curve / fin / eye / paw / spike / membrane have neither, so no part ever entered the loop. Real runs shipped a tusk whose whole root ring stood 0.031 clear of the skull, a trunk 6/15 outside, a forehead plate 0.050 above the surface, all reported all green and all caught by eye in the most expensive repair round. A part must now come within 1.5% of model height of its host's surface. Deliberately generous: eyes and conformed plates sit ON the surface and pass; something hanging in the air does not. Mirrored twins are skipped — the source carries the verdict for both.mirror_distortion(new BLOCK + warn):joints_Rshears the twin instead of posing it. The mirrored mesh is grown along the LEFT bone path and then dragged onto the right joints by weighted TRANSLATION, so a large offset squashes the volume. Verified: the wolf: offsets up to 10% of limb length are clean, 16% costs 12% of a dimension, 24% costs 19%, 39% costs 31% and blocks. A reported case had a right thigh 0.152 deep against 0.381 on the left with its width intact — invisible from the left, invisible in the log. Warn past 12% deviation, BLOCK past 30%. Doctrine added to SYNTAX and MID:joints_Ris for a few centimetres of stagger; a genuinely different pose belongs in its own chain outsidemirror.attack_reachno longer demands a whole-body lunge. It required half a body span PAST the bind front, which rejected every stand-and-swing design. Now either route passes: REACH (≥15% of span past the front) or SWING (a part travels forward ≥45% of ITS OWN length — the limb's travel is bounded by the limb, not the body; the old rule was a dimensional error). Verified: ±20° twitch blocked, ±35° foreleg swing passes, forward tail slam passes, sideways sweep blocked, full lunge passes.anim_integritysays WHERE. It is ~83% of all blocks in practice and used to report only"move" @0.5 folds mesh (10 flipped tris), forcing a binary search. It now names the worst mesh for folds, and the mesh plus the driving joint for stretches, with the three fixes that actually apply.- Profile-slope warning at compile. Scaling a volume without scaling
ring_stepcrowds rings relative to how fast the radius changes; past a slope of ~0.8 the next bend flips triangles. The engine now warns with the number and the location, instead of letting it surface later as flipped tris during an animation. - Anchored parts narrate the world direction they actually face.
aroundis read in the host section's frame; the documented 0=spine / 90=side / 180=belly is the BODY chain's frame. On a leg: 0=inner, 90=FRONT, 180=OUTER, 270=back — so a plate aimed at the outside of a thigh with 90 silently lands on its front. deliver.pyrefuses a self-contradicting gate stamp. A delivered model was found carrying"passed": truewithmid_face_blindreadfailed in the same object, and it had already been published. The stamp travels inside the GLB forever; delivery now stops unless the aggregate matches the checks.
Security & open-sourcing
- Arbitrary file read in
judge.mjsclosed (the one real vulnerability). The static handler didpath.join(base, urlPath)with no containment check, and the listener bound to0.0.0.0. A raw request line carrying/../../../../etc/passwd(a socket does not normalise it the wayfetchdoes) escaped every base and the file was served —/proc/self/environincluded, which is where credentials live. Any host on the same network could read any file, for as long as a judge run lasted. Now: resolve then require containment, serve only.js .mjs .map .json .wasm, and listen on127.0.0.1. silmetrics.mjsandhero.mjsbind to127.0.0.1on an OS-assigned port instead of0.0.0.0:8961/0.0.0.0:8963. Their handlers were already whitelisted so nothing leaked beyond the model, but the pages and models were network-visible during a run, and two concurrent runs collided on the port.- Creature names and signatures are HTML-escaped before they go into the
delivered viewer (
deliver.py). A creature named</h1><script>…executed in the page; the same string also rides in the GLB to the community wall, so SECURITY.md states plainly that the server must escape it independently too. - Chromium keeps its OS sandbox.
--no-sandboxwas unconditional injudge.mjs; it is now opt-in viaPW_NO_SANDBOX=1. The hardcoded/opt/pw-browsers/chromiumpath is gone from all three render tools — Playwright locates its own browser,PW_CHROMIUM_PATHpins one. That path made every clone fail on macOS and Windows. - Licensing corrected. MANUAL claimed "no third-party code is bundled"; it does
bundle three.js (MIT) as
harness/assets/three-bundle.js. The upstream notice was always preserved in the file, so nothing was ever out of compliance — the sentence was simply wrong. AddedTHIRD-PARTY-NOTICES.mdwith the full MIT text plus the licences of everythingsetup.shinstalls. - Added
LICENSE(MIT, © 2026 Alsomind Tech Co., Ltd.),README.md,SECURITY.mdand.gitignore;gobkit.json's_key_labelnow says the key is public by design and that rotation cannot retract what is already in git history.
Delivery & publish
Showroom viewer redesigned and moved out of the Python into
harness/assets/showroom.html(placeholders__TITLE____BYLINE____BUNDLE____B64__), so the room can be restyled without touchingdeliver.py. Gallery room: radial backdrop, floor wash, vignette, a small-caps name plate reading<signature> · anyCreature <version>, and three tool buttons — cycle the file's own animation clips, turntable, hard-edge clay with a wireframe overlay. Shadow-casting key light over a ShadowMaterial ground; camera auto-framed to the bounding sphere and the model rested on the floor. Fully offline: three.js inlined, model base64'd, no CDN and no webfont (system serif stack) — double-click and it runs.publish.mjs: try the upload, always. New doctrine written into the script header and card 04 — never pre-judge the environment as offline. Cloud sandboxes and Cowork sessions frequently do have egress; run the command and answer from what it prints. Saying "in a sandbox you can only upload by hand" without attempting is now explicitly wrong.offlinerenamed toblocked, and 403 is classified as network filtering, not a key problem. The submit endpoint always answers in JSON, so an HTTP 403 or any non-JSON body means an intermediary replied — a proxy, captive portal or corporate filter.blockedis a normal outcome, reported as the next step ("the pack is ready, drag it into the page") rather than an error. Nothing tells the user to fetch or change a key.hero.png is now required in practice: a submission without a thumbnail is accepted but never lists automatically — it waits for a human reviewer, and that is the one common post-upload stall.
publish.mjswarns loudly when the file is missing and reportsthumbin its JSON line.deliver.pyv2: stamped GLB + showroom viewer (studio backdrop, title card, animation pills) +hero.mjsauto-framed hero.png (1024² transparent 45°, ≥8% margins, idle mid-frame) / hero.jpg + backup upload pack.publish.mjs: multipart POST to gobkit.com/api/community (fields model/thumb/title/creator_name/channel/key) with three scripted outcomes — published (echo the SERVER's title/creator + share link), pending_review (one calm line), offline (backup path: drag delivery/upload/creature.glb into gobkit.com/community/upload).
0.12.0 (was 1.7.0) — clean painter, strict inspector (validated by 7 head-to-head experiments)
Architecture
- Creation side stripped to a pit-map: no design doctrine upfront — free design won or tied every duel where part character mattered; doctrine text taxed boldness. Design knowledge now lives in gates and rulers only.
- Two gates, four views each, read by context-free agents (self-grading shipped the worst failure in project history): Gate 1 RECOGNISED — any stick/slab view kills; Gate 2 PUNCHIER — after identity passes, rounds may only exaggerate, judged prev-vs-curr; compliance-only edits forbidden. LOW's deliverable is an exaggerated silhouette.
- Stop-loss: same symptom failed twice → concept restart, never a third tweak (verdict-driven micro-repair oscillated: human→bell, trousers→rooster).
- Signature parts get real geometry at LOW (a fist is fingers and knuckles, not a sphere); 6:3:1 governs geometry budget, not just screen share.
- Scale calibration: 24px = feel, 48px = identity (control reads on the approved standard proved single-scale gates miscalibrated). Front view alone may be symmetric; paired features still stagger.
- Templates removed entirely (anchor became a topology prison — a giant order produced a wolf skeleton).
Engine wave-1 (~+250 lines; required reading stays ~1 page)
curve: curved horns/tusks/trunks — per-segment steering that accumulates down the chain (rise/fall/ahead/behind/coil); the mammoth-tusk class of failure was a vocabulary gap, not a design gap.membrane: skin between rib chains with blend skinning, a scooped trailing edge, and the root-gap warning — the bat-wing failure class, where a shape that never encloses reads as spread fingers.- Named sections incl. CONCAVE outlines (
"sections"): bark flutes, crescents — relief is geometry. facetedhard-edge shading; anchored parts snap onto the host surface normal by default (conform:falseopts out).- Compiler narration:
info:lines report the accumulated bend of a curve and how far a plate was rotated to meet its surface. - Membranes exempt from the closed-surface fold check (saddle regions are legitimate).
- maskmetrics dullness flags:
sq_fill(1:1-frame volume),mirror_sym,straight_max(plank detector) — measures only, judgment stays with the reader/LLM.
0.11.0 (was 1.6.0) — method over conclusions (cards + silmetrics)
Constitutional rule added: cards carry method and rulers, never instance conclusions — a specific creature's ratio numbers or 24px phrases are per-order products; baking them in anchors every future creature to one answer and pollutes context. Accordingly:
- Ratio table (design 2c) rewritten method-only: the session decomposes the order's creature-noun itself — picks WHICH 3–5 ratios carry the identity, justifies each against the temperament. The giant's worked numbers are gone.
- New general art direction: ratios checked in all three orthographic views (one-view drama = cardboard); per-axis decomposition (a mass's elongation axis is identity information); colour philosophy in HIGH (value-first 70/25/5, saturation as spotlight, one temperature story, pattern follows form).
- silmetrics now renders side + front + top and reports per-view aspect/fill.
- Instance residue swept from 1.5.0's cards (giant example lines, magic numbers).
0.10.0 (was 1.5.0) — doctrine patch: the giant lessons (cards only; engine unchanged from 1.4.0)
Distilled from an approved no-harness mountain-giant build — the reasoning that made it work, sedimented into the cards:
- Ratio table (design 2c): the identity noun translates DIRECTLY into a mass-allocation table vs a baseline; scaling up ≠ giant, changed ratios = giant. The exaggeration vector is the table's extreme rows.
- Three contour layers (LOWRES): primary masses (3–5, = 80% of silhouette, verified FIRST) → breakers (straight lines & sharp angles on the contour) → details. Order never reverses.
- Blob-pile trap + the glue: elongate ~1.7×, overlap seams, and the decisive fix — a hard plate spanning ≥2 masses fuses them into one structure (why pauldrons span shoulder+arm).
- Negative space, pose, curve-vs-hard coexistence added to the silhouette declarations; ≥3 read points and a ~15° asymmetry nudge added to the stage-1 human checklist.
0.9.0 (was 1.4.0) — the big-form release (core competence: silhouette tension)
Engine
- Relational joints:
{"from":X,"fwd/up/side":d},{"from":X,"dir":[..],"len":d},"ground":yfor feet — specs think in proportions again; absolute coords stay legal. Verified bit-identical against the absolute wolf spec. - Game-ready UVs: automatic unwrap (cylindrical tubes + planar caps, box unwrap for parts), seam-vertex duplication, one non-overlapping world-density atlas (
TEXCOORD_0); overlap audit 0.2% (corner texels only) → AO/lightmap bakeable. - Fixed inverted normals in
paw(winding) andfin(outline now canonicalised CCW, rim rewound). - Fixed floating surface anchors (eyes/ears): lookup by true arc-length
ringTinstead of ring index (bevel-skip had shifted indices). proportiongate aligned to the styling rule: 0.96 → 0.923 (the 0.92–0.96 blind band caught nothing); minor-segment filter now relative to mean segment length (checks 6–7 pairs on a 9-joint spine, was 1).limb_clearanceexposed-test gets a 5% seam tolerance (groin-seam verts are host geometry, not exposed limbs).- Wolf: head split into its own volume (rooted inside the neck), slab thighs (
exp2.2–2.6), eyes moved to the head's side (around62).
Harness
- silmetrics.mjs: side+front silhouettes, 24px thumbnail, and the numbers —
W_over_H, fill, mass_thirds, torso_depth, mass_contrast, leg_fraction, turn_count, zigzag_alignment, iou_vs_prev. - Calibration: green = the bred wolf; red = legacy broken wolf plus
red_5050.json, which violates ONLY the 50:50 rule — proving that specific ruler bites.
Doctrine (cards, all-English rewrite)
- 24px contract (identity phrase / per-part features / signature survival) + blind-read gate with recall scoring and signature veto.
- Exaggeration vector + character axes: declared tension, verified by the loop; floors-are-not-goals iron law.
- Knob table (symptom → spec knob) distilled from the wolf's measured convergence.
templates/library with breeding pipeline: in-house references only, human sign-off mandatory; shipsquadruped_light.- Docs/cards no longer reference the retired pre-0.8 spec language or its tooling; syntax quick-refs show the real JSON.