Devlog

This is glemy's real decision log, not a curated highlight reel — every entry states what was tried, what was rejected and why, and how the outcome was actually verified. Newest first.

  1. #0067Publish glemy 0.1.0 to Hex2026-08-09 · toolchain
  2. #0066Declare javascript as gleam.toml's default target, discovered as a real gleam publish blocker2026-08-09 · toolchain
  3. #0065Set Hex-publish metadata (0.1.0, BSD-3-Clause) and audit the public API surface, informed by glemy-games as a real external consumer2026-08-09 · architecture
  4. #0064Extract the three reference games into a new glemy-games repository2026-08-09 · architecture
  5. #0063Dedupe a Shell-side pattern into game_ffi.mjs's setElementVisibilityMessage, mirroring decision 0062's Core-side reasoning one layer up2026-08-09 · architecture
  6. #0062Decompose wall-handling into caller-parameterized Core primitives (resolve_axis/resolve_high_only), parameterize physics.update's wall step, instead of leaving it unused by 2 of 3 games2026-08-09 · architecture
  7. #0061Close out RM-034: circle-vs-Rect detection generalizes to Core, wall/landing restitution policy does not (three games, three distinct answers)2026-08-09 · architecture
  8. #0060Wire the platformer's rendering/input (glemy/game_platformer), verified via a new browser-check using captured-GPU-uniform position checks2026-08-09 · architecture
  9. #0059Build the platformer's pure game logic (glemy/games/platformer), confirming a third distinct wall/landing policy and a real Landed-event design bug found by direct testing2026-08-09 · architecture
  10. #0058Promote circle-vs-Rect detection and the x-fraction/rect-to-CSS helpers from games/breakout into Core, at RM-034's second real caller2026-08-09 · architecture
  11. #0057Fix the Breakout stable-channel deploy crash and replace decision 0046's manual-only stable promotion with CI-gated automatic promotion2026-08-09 · architecture
  12. #0056Extend tools/decisions with a roadmap subcommand to validate and manage docs/development-plan.jsonl (RM-028)2026-08-09 · process
  13. #0055Add Breakout to glemy-website's game catalog, generalizing game_card into a parameterized component at its second real caller2026-08-09 · architecture
  14. #0054Phase 3 (playtesting/tuning): empirical multi-exchange verification confirms Breakout's constants are sane; subjective feel-tuning deferred to the user's own hands-on play2026-08-09 · gameplay
  15. #0053Wire Breakout's rendering/input (glemy/game_breakout), redesign Brick with a stable id for DOM reconciliation, and extract shared browser-check bootstrap at its second real caller2026-08-09 · architecture
  16. #0052Build Breakout's pure game logic (glemy/games/breakout, rect/brick/paddle) with rectangles kept entirely outside physics, and confirm physics.update does not generalize to a second genre2026-08-09 · architecture
  17. #0051Split glemy/game.gleam into glemy/game_tiers.gleam plus a shared game_ffi.mjs, in preparation for a second game runner2026-08-09 · architecture
  18. #0050Add physics/bounds.clamp_x and physics.settle_all, reject a bounds.y_from_top helper, and fix a real float.clamp/bounce_axis divergence on degenerate bounds2026-08-09 · architecture
  19. #0049Extend the Core API with three small utility modules (cooldown, stopwatch, random) and physics.entity_count, and reject a generic PreviewQueue abstraction2026-08-09 · architecture
  20. #0048Rename pe to physics, pair render colors with entities instead of a parallel list, give render.Canvas a public constructor, and fix doc-comment drift left by decision 00472026-08-09 · architecture
  21. #0047Formalize the Core API surface and introduce the glemy/games/<name>/ convention, moving all Suika-specific rule logic out of pe2026-08-09 · architecture
  22. #0046Split the live demo into pinned stable and always-latest edge release channels, promoted via a committed ref file2026-08-09 · architecture
  23. #0045Content-hash glemy-website's built static assets: style.css per-file, the play-demo build as one renamed directory2026-08-09 · architecture
  24. #0044Generalize pe's SoundEvent into GameEvent, returned as #(Model, List(GameEvent)) from tick rather than carried as a Model field2026-08-09 · architecture
  25. #0043Restructure docs/development-plan.md into a status-tracked, item-based living roadmap, replacing prose narrative that required full rewrites2026-08-09 · process
  26. #0042Establish a project-level Technical Architecture Document: engine/game boundary, deployment/live-demo strategy, and versioning policy2026-08-09 · architecture
  27. #0041The project's public website (goals, devlog, live demo) lives in a separate glemy-website repo, not this one2026-08-09 · architecture
  28. #0040Systematic DevOps tooling organization: a researched taxonomy (kind, packaging weight, fixture placement, discoverability) for tools/, not an ad hoc layout2026-08-09 · architecture
  29. #0039Formal modularization thresholds (ARCHITECTURE.md), grounded in SRP/cohesion research not line-count alone -- and one real extraction the audit found: pe/collision_sweep.gleam2026-08-09 · architecture
  30. #0038Zero-unexpected-warnings gate: fixed the one real dead import, enforced the rest via a checked-in baseline diff, not a silent policy2026-08-08 · process
  31. #0037Clamp dt inside pe.tick: a real, confirmed entity-entity tunneling risk after decision 0032 raised speed, made worse by zero dt clamping in the game loop2026-08-08 · physics
  32. #0036Merge visual feedback: a whole-canvas brightness flash, not a per-position particle burst2026-08-08 · gameplay
  33. #0035Added drop/merge sound effects: synthesized via Web Audio, not audio files -- and a new Model.sound_events field so the decision of what happened stays pure and testable2026-08-08 · gameplay
  34. #0034Two-ahead tier queue and a next-tier UI swatch, matching the genre's standard 'next fruit' preview2026-08-08 · gameplay
  35. #0033Added a visible danger-line indicator: a CSS overlay, not a WebGPU-rendered entity2026-08-08 · gameplay
  36. #0032Fall was still too slow after decision 0029's bounce fix -- fixed the real drag mismatch (velocity_damping) plus raised gravity, roughly halving real fall time2026-08-08 · physics
  37. #0031Architecture cleanup: deleted the unused glemy/cs compute-shader layer, added ARCHITECTURE.md as the standing rule set2026-08-08 · architecture
  38. #0030Render the drop preview circle Model.preview_x was tracking but never actually drawing2026-08-08 · gameplay
  39. #0029Root-caused 'falls too fast, hard to predict' to fully elastic restitution (1.0), not gravity -- lowered to 0.1 to match a real reference-game clone2026-08-08 · physics
  40. #0028Fixed a genuine resonance bug in decision 0027's resting-contact threshold: replaced the hard velocity cutoff with a smooth restitution ramp plus a Box2D-style time-based sleep backstop2026-08-08 · bugfix
  41. #0027Fixed a real, previously-documented-as-acceptable bug: entities visibly crossed the play area boundary before bouncing, because radius was never subtracted from the bounce comparison2026-08-08 · bugfix
  42. #0026Fixed silent black-screen failures: dev server now sends no-cache, and the game loop reports errors visibly instead of dying silently2026-08-08 · bugfix
  43. #0025Phase 8 (playtesting/tuning): empirical verification confirms the constants are sane; subjective feel-tuning deferred to the user's own hands-on play2026-08-08 · gameplay
  44. #0024HTML overlay UI: score and game-over text, format computed in Gleam, only non-branching DOM writes in FFI2026-08-08 · rendering
  45. #0023Danger line / game over: plain continuous-time threshold, tick freezes once lost2026-08-08 · gameplay
  46. #0022Drop mechanic: cursor-follow preview, cooldown-gated drop, randomized next tier -- and gleam_stdlib already has a cross-target float.random(), no new FFI needed2026-08-08 · gameplay
  47. #0021Fixed a real latent bug: click-to-spawn passed raw viewport pixels through as world coordinates, unconverted2026-08-08 · bugfix
  48. #0020Per-entity render color is tier-driven, single source of truth in tier.color, sent to the shader as a vec4 uniform2026-08-08 · rendering
  49. #0019Same-tier overlapping entities merge into the next tier instead of bouncing, one pair per sweep pass2026-08-08 · physics
  50. #0018Collision physics is now mass-aware (proportional to area), superseding the equal-mass simplification2026-08-08 · physics
  51. #0017Entity.tier is the authoritative discrete identity; radius is tier-derived data2026-08-08 · physics
  52. #0016Standing rule: JS FFI code must be minimal and every Gleam-callable export must be wrapped by Gleam2026-08-08 · toolchain
  53. #0015Present via a native GPUCanvasContext under Deno, not TypeScript+Playwright, for maximum type safety2026-08-08 · architecture
  54. #0014Cap max_entities rather than build broad-phase collision culling2026-08-08 · physics
  55. #0013Standing rule: use every tool's type safety to the maximum extent available2026-08-08 · toolchain
  56. #0012Headless WebGPU verification does work in this sandbox -- decision 0011's conclusion was wrong2026-08-08 · testing-infrastructure
  57. #0011This dev sandbox cannot run real-browser WebGPU, even headless and even in software2026-08-08 · testing-infrastructure
  58. #0010Present the game runner's frames via Canvas2D putImageData, not a WebGPU canvas context2026-08-08 · architecture
  59. #0009Build a type-safe Gleam CLI tool for decisions.jsonl instead of ad-hoc Python2026-08-08 · devops
  60. #0008Move JavaScript-target testing from Node to Deno; drop the webgpu npm package2026-08-08 · testing-infrastructure
  61. #0007Circle-circle collision assumes equal mass regardless of radius; no per-entity mass field yet2026-08-07 · physics
  62. #0006Use a plain EventTarget for io's testing fallback, not jsdom2026-08-07 · testing-infrastructure
  63. #0005Centralize WebGPU device acquisition in one shared module (gpu_ffi.mjs), not per-FFI-file2026-08-07 · bug-fix
  64. #0004Model game entities as a plain immutable List(Entity) in pe, not an ECS2026-08-07 · architecture
  65. #0003No bundler for the browser build; raw Gleam ESM output plus a hand-written index.html2026-08-07 · architecture
  66. #0002Restructure into a single glemy package with 4 target modules (io, pe, cs, render), rooted at the repo root2026-08-07 · architecture
  67. #0001Install Erlang/OTP via asdf (build from source), not the RabbitMQ PPA2026-08-07 · toolchain