New L1 module `dnut_interpreter` owns the shared lexer, the registry-driven
compiler, the compiled sequence model and the cross-frame interpreter. Domain
vocabularies are registered by the modules that own them; the core never
interprets a domain payload.
- `DnutLexer` / `DnutCompiler`: shared `.dnut` front end with statement-level
error recovery, skipping of non-`story` top-level blocks, and step legality
deferred entirely to the registry.
- `SequenceAsset` / `SequenceRuntime`: compiled sequence model plus a
cross-frame interpreter with call frames, a bounded execution budget, and
version-checked capture/restore of the cursor.
- `StepKindRegistry`: strict step validation that rejects undeclared fields and
runs the descriptor's own domain invariants.
- `rpg`: `RpgDialect` registers the RPG vocabulary (movement, animation, object
selection, skill/attribute/inventory/equipment changes) behind a Pimpl
boundary, so public headers stay free of cross-module includes.
- 17 unit tests across `test/dnut_interpreter.cpp` and `test/rpg_dialect.cpp`.
`examples/<name>/` was a tested surface in name only. The source-quality job had
no examples check at all, and scripts/smoke_examples.sh accepted any process that
had not printed one of its error markers: a project that died during startup,
exited after a single frame, or crashed without a marker was reported as PASS.
Nothing stopped a malformed or unregistered example from reaching dev, which is
how 14 examples arrived without READMEs and 20 were never registered in the
overview table.
Source side
- scripts/check_examples.py classifies every directory under examples/ as either
runnable (main.nut plus a config.nut that assigns the engine `config` table) or
as a reviewed non-runnable sample listed in NON_RUNNABLE_EXAMPLES with a
reason. Both kinds must own a README.md and appear in examples/README.md.
Stale exemptions and overview links to missing directories fail as well.
- `make check/examples` and a new source-quality CI step run the gate.
- scripts/tests/test_check_examples.py covers it and pins each failure mode
against fixtures.
Runtime side
- scripts/smoke_examples.sh now enforces liveness, not just marker absence: every
runnable example must still be running after MIN_RUN_SECONDS (default 2s; CI
passes 2s), and a process that dies inside that window fails whatever its exit
code. A clean self-exit after the window passes with an explicit note instead
of being silently accepted as a pass.
- The Linux CI step sets MIN_RUN_SECONDS=2 and keeps RUN_SECONDS=6, so the job's
wall clock is unchanged (13.7 min of its 20 min budget on dev).
Windows / GBK
- scripts/utf8_stdio.py re-encodes stdout/stderr as UTF-8 and every scripts/*.py
program calls it as the first statement of its __main__ block. On a Chinese
Windows a redirected stream falls back to the ANSI code page (cp936), and
printing a character that code page cannot encode (arrows, superscripts, bullet
separators, emoji - all common in this repository) raised UnicodeEncodeError
and turned a checker into a traceback.
- The mirror image is input: read_text() without encoding= decoded UTF-8
repository text as cp936 and raised UnicodeDecodeError.
- scripts/tests/test_utf8_stdio.py enforces both conventions for every script and
test module; text file I/O and child-process decoding now pass encoding="utf-8"
explicitly.
- Unit-test invocations run with `python3 -X utf8` so the runner's own output
never follows the host code page.
Violations the new gates found on top of dev, fixed here: 14 examples shipped
without a README (fluid3d, mesh-impact-lab, mesh-modifier-lab, spline-tube-lab on
the earlier dev tip, plus pcg-depth-of-field, pcg-detail-overwrite,
pcg-layer-culling, pcg-location-system, pcg-runtime-orchestration,
pcg-scene-player-culling, pcg-snow-wind, pcg-thunder-strike, pcg-ui-scaler and
pcg-underwater added by #397), 20 were missing from the overview table (those 14
plus archspace-editor, geometry-stroke-lab, interior-mapping, layered-animation,
triplanar-decal, terrain-stamping), and scripts/export_meshret_onnx.py had no
UTF-8 stdio guard.
Verified locally: `python -m ruff check scripts` (All checks passed);
scripts/check_test_manifest.py; scripts/check_quality_metadata.py;
scripts/check_architecture_contracts.py --base HEAD; scripts/check_nodiscard.py;
`make -n check/examples`; scripts/check_examples.py (125 examples: 118 runnable,
7 reviewed non-runnable); and `python -X utf8 -m unittest discover -s scripts/tests
-p "test_*.py"` (155 tests, OK). The runtime half of the contract needs a Linux
headless build, so it is verified by the CI examples smoke step rather than
locally.
* feat(graphics): add Phase 1 hair/groom subsystem under graphics/hair
Introduce a UE5-Groom-inspired strand data model, procedural growth,
ribbon expansion, GroomAsset/GroomInstance, design doc, and CPU tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* fix(graphics): move GroomInstance getters to .cpp for binding contracts
Binding contract generation only resolves methods defined in translation
units; inline header getters were reported as unresolved.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(graphics): record Phase 1 hair/groom implementation status
Note ctest results and the binding-contract getter-in-cpp requirement.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(graphics): add ClusterGrid cull for hair groom Phase 2
Wire optional CPU cluster frustum culling into GroomInstance and keep
Cards geometric LOD owned by HairCards (PR #400) instead of duplicating
a CardsBuilder under graphics/hair.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(graphics): multi-group groom bake and Marschner lobe weights
Merge all groom groups into one ribbon mesh via appendRibbonMesh, and
expose Marschner R/TT/TRT push-constant weights on the hair shader
(GLSL/WGSL/SPIR-V) with script bindings and coverage tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* test(graphics): begin 3D frame before groom Marschner draw smoke
GroomInstance::draw routes through drawMeshShader, which requires an
active 3D frame; wrap the multi-group GPU smoke accordingly.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(graphics): add analytical hair self-shadow and root AO
Finish Phase 3 shading with push-constant fiber self-shadow and
along-strand root AO (not deep shadow maps), wired through
GroomInstance and script bindings, with updated SPIR-V/WGSL and tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(graphics): add groom skin binding and guide interpolation
Phase 4 CPU binding projects strand roots onto skin triangles with
Rigid/Offset deform, and guide extraction/weights drive
Rigid/Offset/Smooth strand interpolation without animation coupling.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(graphics): add guide XPBD/Verlet simulation for groom Phase 5
Introduce GuideSimulator (Verlet + XPBD distance constraints, pinned roots,
optional ground plane) without a physics-module include, wire it through
GroomInstance::enableGuideSimulation/update, and cover it with hair unit tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(graphics): wire groom Cards LOD through HairCards
Representation::Cards now expands strands via HairCards polylines and
uploadCardMesh; default mid LOD switches to Cards. Adds Cards LOD bake/draw
coverage after merging #400.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(graphics): document GroomInstance script bindings
Source quality was failing on NEW binding gaps for hair/groom APIs.
Add newGroomInstance and GroomInstance LOD/shading getters to graphics.md.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(graphics): add ownership/lifetime contracts for groom APIs
Satisfy api-lifetime architecture gate for newGroomInstance,
GroomInstance::primaryGroup, and kHairFragWgsl.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
* feat(animation): unify layered poses via IAnimPoseSource
Allow AnimLayerMixer base/layers to consume AnimPlayer, AnimGraph, or
AnimStateMachine through a shared pose-source interface, add explicit
bind/identity additive references on mixer and graph, keep disabled layers
advancing, and cover the path with unit tests plus a layered-animation example.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(animation): document getAdditiveReference and getBasePlayer
Source quality requires every new Squirrel binding to appear in
docs/usr/modules/animation.md; fill the two NEW gaps from the layered
mixer / additive-reference APIs.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(examples): layered-animation demo with three KayKit clips
Replace the procedural stick figure with KayKit Knight + Walking_A,
Melee_1H_Attack_Chop, and Hit_A. Show each clip alone and the
AnimLayerMixer result (walk base, spine-masked attack override,
additive hit) side by side.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
* feat(archspace): add Pascal-like architectural space editor domain
Introduce archspace as a document model separate from RTS building and
housegen, with editing DomainOperations, automation commands, mesh bake,
tests, and a thin example host.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(archspace): make document editing and viewport bake path usable
Complete wall/opening/item helpers, opening cutout mesh bake, property undo
inverses, automation commands, and an example that uploads the baked mesh and
captures a screenshot as evidence the domain is more than a shell.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(archspace): document ArchSpaceDocument script bindings
Source quality CI failed because newly bound ArchSpaceDocument methods were
missing from docs/usr/modules/archspace.md. Add an API quick reference that
covers every addFunc name.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(archspace): bake catalog furniture and parametric opening reveals
Replace item marker boxes with multi-part catalog meshes, and carve wall
openings with merged cavities plus explicit reveal liners (not CSG/IFC).
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(archspace): add wall, opening, and item placement editor tools
Interactive tools preview on move and commit DomainOperations through
IEditAuthority on pointer up, matching the building editor tool pattern.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* test(archspace): cover interactive tools, catalog bake, and reveals
Add authority-routed tool tests, assert reveal/catalog primitives, and
document the honest parametric opening + furniture catalog limits.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
* feat(animation): add classical SMR skinned interaction retarget pass
Port the portable ideas from MeshRet/SMR (semantically consistent bone
sensors + dense interaction pairs) into an offline post-FK retarget
refine step that restores body-part proximity with two-bone IK, without
pulling in a neural runtime.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(animation): MeshRet neural retarget via animation_tensor
Add L6 animation_tensor satellite that provides ISmrNeuralRetarget over
builtin tensor MeshRet and optional ONNX, with classical two-bone IK as
fallback when neural is disabled or unavailable.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(animation): document AnimRetargetProfile getter bindings
Source quality's check_bindings --strict failed on six new getters
bound for SMR/MeshRet retarget that were missing from animation.md.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* fix(animation): avoid new fallback-debt comment markers
Reword neural SMR Doxygen so classical IK is described as the active
path, keeping fallback-contract-inventory at baseline (budget 0).
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* fix(ci): keep animation_tensor off web and skip Dawn LPM
animation_tensor in GROUP web pulled animation→model3d into the
Emscripten profile, which skips medialoader_model and then fails WASM
link. Restrict it to GROUP 3d.
Also force DAWN_BUILD_PROTOBUF/TINT fuzzers off so the Windows native
Dawn parity configure does not require a flaky libprotobuf-mutator
checkout.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
* docs(animation): research LitMotion vs EVEngine Tween roadmap
Map Unity LitMotion's builder/bind/sequence/punch model onto the
existing animation Tween and ControlAnim stack, and outline a phased
Motion + Capability-binder plan that keeps SimulationStep and module
layering intact.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(animation): add LitMotion-style Motion builder, runtime, and sinks
Introduce typed float/Vec2/Vec3 motion storage with generation-checked
handles, fluent builders, and borrowed push sinks. Animation::advance
now pumps MotionRuntime alongside Tween. Phase 1 covers bind/run,
complete/cancel, delay/loops/yoyo, and shared ease kinds.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(animation): Phase 2 MotionSequence, ease extensions, and script bindings
Add LitMotion-style Append/Join/Insert/AppendInterval sequencing on MotionRuntime,
Back/Elastic/Bounce ease kinds, builder to()/takeDesc for unspawned scheduling,
and Squirrel newMotion/newMotionSequence wrappers with matching docs and tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(animation): document Motion script bindings for Source quality gate
List cancelOnError, childCount, cursor, getMotionCount, and itemCount in
animation.md so check_bindings --strict no longer reports NEW gaps.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* docs(animation): add ownership/lifetime contracts on MotionRuntime resolvers
Document borrowed-pointer lifetime for resolveFloat/Vec2/Vec3 so the
architecture api-lifetime gate no longer flags them as undocumented.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(animation): Phase 3 Punch/Shake adapters and Color/Quat motions
Add LitMotion-style Punch/Shake oscillation evaluation on float/Vec2/Vec3
motions, plus Color lerp and Quat slerp pools with builders, Animation
factories, script bindings, tests, and docs.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(animation): Phase 4 motion pool ensureCapacity and free-list recycle
Pre-size float/typed motion pools with ensureCapacity, recycle completed
slots via O(1) free-lists, add FloatBufferSink for contiguous batch writes,
expose capacity queries to script, and cover with recycle/buffer/bench tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* ci(linux): raise Build linux debug timeout from 40m to 60m
Cold third-party + sccache misses were hitting the 40-minute step timeout
at ~94% of unit_test compile (PR #389). Job budget remains 90m.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* ci(linux): raise ASan RelWithDebInfo build timeout from 100m to 130m
Cold PR builds with sccache READ_ONLY miss hit the 100-minute step timeout
at ~94% of unit_test compile (run 34823491554). Job budget remains 270m.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* ci(macos): retry Dawn Metal configure after incomplete abseil clone
Dawn's googlesource shallow fetch can leave third_party/abseil-cpp without
CMakeLists.txt (macOS job 103997514884). Retry configure up to 3 times after
clearing the incomplete checkout; apply the same guard on the Windows Dawn
parity lane.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* ci: retrigger after transient GitHub/Vulkan download 504s
macOS passed with the Dawn abseil retry. Windows/iOS/ASan/WebGPU failed
early on versions.json / utf8proc / zstd / emdawnwebgpu HTTP 504s unrelated
to this PR; re-run permissions are unavailable so nudge CI with an empty
commit.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Reword the modifyPointBounds Doxygen note so the architecture POINTER_API
heuristic no longer treats the comment as a raw-pointer declaration, and
document borrow/lifetime for assignWeightedMeshAttribute's mesh/weight tables.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* feat(decal): add local-space triplanar projection to avoid side stretch
Classic planar box decals stretch or cull on faces nearly orthogonal to the
projection axis. Add a triplanar mode that samples YZ/XZ/XY in decal-local
space and blends by |nLocal|^sharpness (UE5-style 三维投射贴花), with API,
editor properties, Vulkan/WGSL shaders, tests, and a corner demo.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* fix(decal): harden triplanar demo and windowed grazing-wall test
Use a procedural grid texture and larger corner volume in the example so
side faces stay inside the box. Replace the flaky headless layer check with
a windowed forward-path assertion (planar culls, triplanar tints red).
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* fix(decal): return DecalProjectionStatus from setProjection
Architecture api-shape rejects new operation bools. Use a named status
enum (Applied / UnknownId / InvalidMode / InvalidSharpness) so callers
can distinguish failure modes without a parallel lastError channel.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* ci(linux): raise cold-build timeouts for PR sccache misses
Linux debug timed out at 40m with a third-party cache miss and
read-only sccache (0 hits). Match the cold-path headroom used on
Windows/ASan so full rebuilds can finish and still run tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* ci(asan): raise cold sanitizer build timeout past 100m
PR ASan builds are sccache READ_ONLY and routinely hit the old
100-minute cap near the end of unit_test (94% on run 34820985249).
Allow 140 minutes so linking can finish before tests.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
* ci: re-trigger after ASan runner lost communication
Previous Linux (ASan+UBSan) job died mid-build with a hosted-runner
disconnect (no compile/test failure). Empty commit to retry.
Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
西风逍遥游