Skip to content

Development

m4bwav edited this page Nov 14, 2026 · 2 revisions

Layout

  • scripts/fw.py: the CLI and the render, measure and video core. Command groups live beside it: fw_deep.py (perturbation), fw_serve.py (explorer), fw_audio.py, fw_ai.py (AI styling pass), fw_extra.py (ifs, attractor-search, fif, terrain), fw_gen.py (flame, lsystem, attractor), fw_neighbours.py, fw_3d.py; the browser page and shaders are in scripts/page/.
  • skills/fractalwright/SKILL.md: the hub skill agents read.
  • references/: research notes by topic (escape time, deep zoom, IFS, L-systems, noise, 3D, measuring, audio visuals, AI models, prior art), each with dated sources.
  • tests/: proof bars per module (determinism, symmetry, dimensions of known shapes, Mandelbrot area, deep zoom against high-precision references, video seams and flash checks, browser against NumPy).
  • CODEMAP.md: where each function lives.
  • Evergreen files at the root (evergreen.json, RESEARCH.md, LEARNINGS.md, TESTS.md) keep the research on a refresh schedule.

Tests

python -m pytest -q tests

On 2026-11-14 all 111 tests passed in about 96 seconds (with Playwright, Edge and ffmpeg present). Measured errors per test are logged in TESTS.md.

Changes

Work happens on a branch per change and merges into main. The licence is MIT; SECURITY.md says how to report a security problem.

Clone this wiki locally