Skip to content

Latest commit

 

History

History
68 lines (43 loc) · 6.51 KB

PHASE_16.md

File metadata and controls

68 lines (43 loc) · 6.51 KB

⚡ Phase 16: Mjölnir — The Hammer That Never Misses — ✅ COMPLETE

Þá kom Mjölnir, hamarr ins mikla, skýja síðan skreytifors váru, ok þat munu dvergar at sakna, er hann óx í odd ok í járnganr — en þó sjaldan sást hann á slóð ne einni er hann eigi sótti höfuð þeim er sóttu ótypeiði.


The Name

Mjölnir (Old Norse: Mjölnir — "That Which Smashes" or "The Crusher") — the hammer of Þórr (Thor), forged by the dwarven smiths Eitri and Brokkr in a legendary contest. Though the handle came out slightly short, Mjölnir became the most coveted weapon in all the Nine Realms: it never misses its target, it always returns to the thrower's hand, and it can be made small enough to conceal beneath a cloak. It is the weapon that has passed through fire and testing and now flies — certain, unerring — into the world.

Where Vápnatak was the arming — the hefting, the edge-check, the declaration of readiness — Mjölnir is the throw. The hammer has left the hand. It arcs through open sky, and it does not miss.


Evocative Description

The forge-fires of Three Forges went cold long ago. Heimdallr's horn sounded across the Nine Realms. The war-band took up tested arms in Vápnatak and found every blade sound. Now Mjölnir flies — the dwarven hammer that passes through every test and returns, unswerving, to the open hand. This is not the making of a weapon; this is the weapon in flight. New capabilities are inscribed upon its returning arc: toon-shading for anime skins, spring-physics for living hair and cloth, pose-libraries for a thousand expressions of stillness and motion. The hammer strikes the anvil of public release, tags the version, publishes the artifact, polishes the readme until it gleams — and then Mjölnir returns, whole and v0.8.0, to the hand that threw it. The world receives what was forged in secret; the Nine Realms hear the thunder.


Task List (7 Tasks)

T1 — Eitri's Glaze: MToon Shader System

Implement anime toon-shading for VRM avatars. MToon is the standard shader for VRM — it gives anime characters their characteristic cel-shaded look with adjustable rim lighting, outline rendering, and lit/unlit threshold control. This is the skin that makes a mesh feel drawn, not merely rendered. Integrate the MToon specification into Hamr's material pipeline so every exported model carries its stylistic soul.

T2 — Living Weave: Spring Bone Physics Tuning

Tune and finalize spring bone physics for realistic secondary motion — hair that sways, ribbons that trail, skirts that catch the wind. VRM spring bones are the invisible skeleton beneath cloth and strand, and their parameters (stiffness, gravity, drag, hit radius) must be calibrated so motion feels organic rather than robotic. Build a tuning harness with visual feedback and sensible defaults per bone group (hair, skirt, accessory).

T3 — The Thousand Stances: Pose Library

Build a pose library system covering rest poses (T-pose, A-pose, I-pose for VRM interoperability), hand gesture presets (fist, open, point, grip, relax — the gestural vocabulary of anime hands), and facial expression presets (neutral, happy, angry, sad, surprised, relaxed — the six pillars of VRM BlendShape emotion). Each pose is a named, serializable snapshot that can be applied, blended, or exported. This is the vocabulary the character speaks before animation begins.

T4 — Anvil Strike: Merge Main & Tag v0.7.0 Release

Merge the Development branch into Main with all 2021 tests passing, all 6 promotion checks cleared, and a clean version tag at v0.7.0. This is the moment Mjölnir strikes the anvil and declares the work done. The tag is permanent history; the merge is irreversible. Ensure CI is green, changelogs are finalized, and the commit message bears the phase sigil.

T5 — Dry Run Across the Bifröst: TestPyPI Dry-Run Publish

Execute a TestPyPI dry-run publish of the v0.7.0 wheel before the real PyPI release in Phase 17. Validate that twine upload --repository testpypi succeeds, that pip install --index-url testpypi resolves dependencies correctly, and that the installed package imports cleanly. This is Mjölnir's trial throw across the Bifröst — the real throw comes next, but the arc must be proven first.

T6 — The Open Gate: Public README Polish

Polish the public README.md until it gleams — the shopfront of the project. Add screenshots showing Hamr's output, CI/coverage badges, a quickstart demo that gets a user from pip install to a rendered character in under five minutes, and a project mission statement in the mythic voice. This is what visitors see before they ever touch the code; it must be beautiful, clear, and true.

T7 — Thunder Returns: v0.8.0 Feature Release

Bump the version to v0.8.0, aggregate the Phase 16 changelog (MToon shaders, spring bones, pose library, release merge, TestPyPI validation, README polish), and publish the feature release. Mjölnir always returns to the hand — v0.8.0 is the hammer coming back, proven in flight, carrying the dents and markings of every test it passed through. This is a feature release, not a patch; it signals that Hamr has grown new capabilities, not merely fixed old ones.


What Comes After — The Road Forward

Phase 17 — Gungnir: The Spear That Always Finds Its Mark
The public release. If Mjölnir is the hammer thrown, Gungnir is Óðinn's spear — guaranteed to strike. This phase is PyPI public publish, conda-forge submission, and the project's first standing in the open world. No more dry runs; no more trial throws. The artifact is live, discoverable, installable by strangers.

Phase 18 — Fólkvangr: The Field of the Host
Community. Documentation site, API reference, contributor onboarding, issue templates, and the governance structures that turn a solo weapon into a war-band. Fólkvangr is Freyja's field — where the chosen gather, where the project's people begin to outnumber its author.

Phase 19 — Hliðskjálf: The High Seat of Vision
Governance and long-range planning. From Hliðskjálf, Óðinn sees all the Nine Realms. This phase establishes roadmap transparency, RFC processes, and the project's outward posture toward the ecosystem it inhabits.

Phase 20+ — Ragnarøkkr: The Twilight Reborn
The major version. When the old world breaks and a new one rises from the ashes — that is v1.0.0. Not destruction, but transformation. The mythic cycle ends and begins again.


Phase 16: Mjölnir — the hammer flies. It does not miss.