Skip to content

Latest commit

 

History

History
45 lines (27 loc) · 4.28 KB

HANDOFF.md

File metadata and controls

45 lines (27 loc) · 4.28 KB

Murmuration stopping point — 2026-11-02

Feature work stopped at the user's request. The first browser prototype is implemented; no additional features should be inferred as authorized by this handoff.

Implemented

  • Native browser modules, procedural WebGL water with a Canvas 2D fallback, luminous organisms, persistent trails and translucent medusae.
  • Four species, toy schooling/feeding, bounded reproduction and inherited speed/size mutation.
  • Feed/stir/seed/inspect, bloom, three habitats, speed/pause, optional synthesized sound, fullscreen, picture export, validated pond import/export and starting-condition seed links.
  • Responsive desktop/mobile presentation and reduced-motion handling.
  • Dependency-free local server, static build, tests, MIT license and GitHub check workflow.

Verification boundary

Five Node tests pass: deterministic seeded runs; finite bounded simulation; snapshot continuation parity; invalid snapshots; resource caps. Static build and JavaScript syntax checks passed. Initial desktop (1440×1000) and phone (390×844) screenshots were visually reviewed. A fresh browser closure pass confirmed paused time remains unchanged, bloom adds 80 organisms below the cap, habitat switching, exact exported/imported simulation state, audio enable/disable, and no horizontal overflow at 390×844. The local browser reported zero console errors after that pass. These checks do not establish every browser, real phone performance, accessibility conformance or long-run ecological complexity.

Local browser evidence is in ignored output/playwright/. docs/preview.png is a public-safe screenshot of this generated simulation.

Runtime and publication

Local server: npm run dev, bound to loopback port 4173. Process lifetime depends on the terminal host. Restart it from this directory if it stops.

Public repository: https://github.com/hamanakam1/murmuration

Live page: https://hamanakam1.github.io/murmuration/

Verified application commit: 7b86c17fed054babc454bbdc077cc128793ad332. Local HEAD and GitHub's main commit readback matched at publication. GitHub Check the pond run 41423763054 passed both tests and static build. pages build and deployment run 41423782720 completed successfully.

The public page returned HTTP 200 with the expected content, loaded in a real browser with its simulation advancing, and reported the WebGL + Canvas renderer. The live HTML, JavaScript modules and stylesheet were byte-compared against local source; results are retained in ignored output/playwright/live-asset-checks.json. Live screenshot: output/playwright/live-desktop.png. A final documentation-only commit records these receipts after the verified application commit; its CI is a separate run and should be checked when resuming.

Odin status

Odin was initially absent. Official arm64 compiler dev-2026-10-nightly:84bc3fc was downloaded under ~/.local/share/murmuration-toolchain/odin-macos-arm64-nightly+2026-10-06. Homebrew installed lld 23.1.4 and dependencies llvm 23.1.4 and z3 5.3.3. No Odin kernel was written, compiled or loaded. The application runs JavaScript; do not claim an Odin/WASM implementation.

Resume order

  1. Read this handoff and check the repository revision and live page.
  2. Finish unverified clipboard, picture download, fullscreen, reduced-motion and forced fallback interactions; broaden actual feed/stir/inspect and touch checks as needed.
  3. Decide whether the next slice is visual refinement or an Odin/WASM kernel. Keep it bounded.
  4. For Odin, first prove a minimal export loads in a browser; then port simulation logic with snapshot/parity checks. Do not rewrite the UI or promise automatic performance improvements.
  5. Consider self-hosted fonts, explicit adaptive rendering quality, real-device checks, and more accessible nonvisual controls.

Known limits

The first version simulates at fixed steps but may slow down under sustained rendering load. Maximum population is a safety cap, not a performance guarantee. Seed links reset current/mutation settings to their defaults and recreate initial conditions only. External fonts are optional. Shader fallback is implemented but initially unverified. Snapshot data is untrusted and validated, but this prototype has not had a dedicated security audit. No public reliability or scientific accuracy claim.