John McCardle 2a29e1b0a1 docs(roadmap): record the grid input revival + GridData/GridView type split

Adds the July 13 entry for the #355 branch (15 issues closed at 36e74e0),
refreshes Active Follow-Ups now that the memory-model review is down to
#336/#337/#338, and rebuilds the open-issue inventory against the tracker
(33 -> 29; new bug grouping for #369/#372/#356).

api/manifest.json carries only the pre-commit hook's provenance stamp
(commit c696b4e/dirty -> 36e74e0/clean); no API surface changed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-13 21:55:52 -04:00

27 KiB

Raw Blame History

McRogueFace - Development Roadmap

Version: 0.2.8 | Era: McRogueFace (2D roguelikes) -- on the road to 1.0

For detailed architecture, philosophy, and decision framework, see the Strategic Direction wiki page. For per-issue tracking, see the Issue Roadmap.

What Has Shipped

Alpha 0.1 (2024) -- First complete release. Milestone: all datatypes behaving.

0.2 series (Jan-Mar 2026) -- Weekly updates to GitHub. Key additions:

3D/Voxel pipeline (experimental): Viewport3D, Camera3D, Entity3D, VoxelGrid with greedy meshing and serialization
Procedural generation: HeightMap, BSP, NoiseSource, DiscreteMap
Tiled and LDtk import with Wang tile / AutoRule resolution
Emscripten/SDL2 backend for WebAssembly deployment
Animation callbacks, mouse event system, grid cell callbacks
Multi-layer grid system with chunk-based rendering and dirty-flag caching
Documentation macro system with auto-generated API docs, man pages, and type stubs
Windows cross-compilation, mobile-ish WASM support, SDL2_mixer audio
Behavior/Trigger turn manager: grid.step(), entity labels, cell_pos, Dijkstra-backed pathfinding (#295-#303)

Proving grounds: Crypt of Sokoban (7DRL 2025), then 7DRL 2026 -- both shipped on the same engine. The 2026 jam surfaced hotfix-worthy issues (SDL key scancodes, composite textures) that have since landed on master.

Current Focus: API Freeze + Memory Safety Sweep

7DRL 2026 is behind us (Feb 28 -- Mar 8). The engine has two concurrent tracks to 1.0:

Track 1: API Freeze

The process is underway. Closed in this pass: camelCase module functions (#304), deprecated sprite_number (#305), legacy string enum comparisons (#306), Color.__eq__/__ne__ (#307), Grid.position alias (#308). The freeze decisions are now locked behind a public API-surface snapshot regression test (#314), so accidental signature drift fails CI.

Remaining freeze work:

Catalog every public Python class, method, and property -- audit against stubs/mcrfpy.pyi and generated docs (snapshot test now enforces the catalog)
Identify any last naming/signature/default changes before committing
Final breaking-change pass, bundled
Document the stable API as the contract
Experimental modules (3D/Voxel) stay out of the freeze with an experimental label

Track 2: Fuzz-Driven Bug Sweep

The libFuzzer+ASan harness (#283) has nine work tranches merged: build plumbing (W1), native harness (W2/W3), then six targeted fuzzers under tests/fuzz/:

fuzz_grid_entity -- EntityCollection lifetime (W4, fixed #258-#263, #273, #274)
fuzz_property_types -- refcount / type confusion (W5, fixed #267, #268, #272)
fuzz_anim_timer_scene -- animation/timer/scene lifecycles (W6)
fuzz_fov -- compute_fov parameters (W8, fixed #310)
fuzz_maps_procgen -- HeightMap/DiscreteMap interfaces (W7)
fuzz_pathfinding_behavior -- Dijkstra + turn manager (W9, fixed #311)

Coverage extension (#312) added four more: fuzz_audio_dsp (SoundBuffer DSP), fuzz_import_parsers (Tiled/LDtk file parsers), fuzz_texture_factory (byte ingestion), fuzz_shader_bindings (uniform-binding lifetime), plus Tier C surface folded into the existing targets. That run found five new bugs: #321 (HIGH -- ColorLayer.draw_fov bad-free), #322 (WangSet.terrain_enum error-pending abort), #323/#324/#325 (float→int UB in pitch_shift/hsl_shift/Vector) -- all five now fixed and merged, see Recently Shipped.

Recently Shipped (April 2026)

#294 -- entity.perspective_map replaces flat vector<UIGridPointState> with a 3-state DiscreteMap (UNKNOWN/DISCOVERED/VISIBLE). Per-entity FOV memory is now serializable, swappable, and structurally enforces visible-as-subset-of-discovered.
#315 -- Pathfinding API extended with built-in heuristics (Euclidean/Manhattan/Chebyshev/Diagonal/Zero), multi-root Dijkstra, FLEE primitives (invert + descent), and an interactive demo. EntityBehavior SEEK/FLEE refactored to a PathProvider strategy.
Phase 5.2 -- six performance benchmark scripts under tests/benchmarks/ covering grid.step(), FOV writeback cost, spatial hash vs. O(n), pathfinding with collision labels, multi-GridView render, and Dijkstra variants. Baselines under tests/benchmarks/baseline/phase5_2/.
Phase 5.3 -- documentation regenerated; tools/generate_stubs_v2.py rewritten as introspection-based so it can no longer drift from the C++ source.

Recently Shipped (July 2026)

Grid input revival + the GridData/GridView type split (#355, #357-#368, #370, #371) -- merged to master as 36e74e0; 15 issues closed. Grid input had been dead since the #252 GridView unification: cell callbacks never fired, grid children were unclickable, cell hover was stuck. The cause was structural -- UIGrid inherited both UIDrawable and GridData, so every map secretly carried a second camera and RenderTexture that nothing on screen corresponded to, and input, children, and dirty propagation all dead-ended in it. Input fix (#355, #357, #358, #360, #362, #363, #365, #366): cell callbacks and hit-testing move to UIGridView -- input belongs to the camera, not the data, so two views over one map track hover independently; a weak_ptr view registry replaces the single owning_view (N views, one map); find()/findAll() descend into grids again; the ImGui scene explorer can expand them; hover-exit fires when the cursor leaves the window; UICollection.repr names Grids instead of "UIDrawable". Type split (#359, #361, #364, #370, #371): UIGrid is deleted, not demoted. mcrfpy.GridData is now public and standalone-constructible -- a map with no position, size, camera, or render(); only UIGridView is a UIDrawable. mcrfpy.Grid is an alias bound to the same type object as GridView (not a subclass -- isinstance works both ways, no MRO to explain). Overlay children belong to the view; entities belong to the map. Breaking change: entity.grid now returns a GridData (the setter still accepts a view). The split flushed out four latent bugs, each verified against unmodified master before being fixed: #370 Grid.center_camera() and Grid.size = ... were silent no-ops (writing to the ghost camera nothing rendered); #371 the shader uniform binder did type-confused pointer arithmetic, reading a GridView wrapper as a _GridData wrapper -- which "worked" only because both wrappers had identical layout and both C++ classes happened to put UIDrawable at offset 0; #368 markContentDirty()'s walk up the parent chain was gated on a flag with exactly one clearDirty() call site in the whole engine, so the guard was permanently false and content invalidation propagated nowhere -- Frame(cache_subtree=True) silently froze its subtree's content (text never updated, colours never changed; only movement survived, being already on an unconditional path). The walk is now unconditional; entity movement, the hot path, is unaffected (164 ns/move). #367: hover state is cleared on focus loss. Suite 329/329. Riding along on the same branch: generated docs are untracked (regenerated by tools/hooks/pre-commit, installed via make install-hooks, and shipped inside release artifacts), with a compact api/manifest.json -- signatures + docstring hashes + carried-forward since/modified lifecycle metadata -- as the one committed exception, so API drift stays diffable by ref via tools/api_delta.py REF1 REF2 without rebuilding at old commits.
Grid render/memory sprint (#351, #334, #338, #332, #335; safety #353/#354) -- a batch review closed dead/unbottlenecked issues (#117 entity pool, #145 TexturePool -- no demonstrated allocation gate; reopen after profiling) and shipped six grid-layer changes. #351: UIGridView::render() had no dirty check post-#252 and cleared+redrew every frame -- added a GridData::content_generation counter (bumped at every data/layer/entity mutation choke point) so an idle, non-perspective, childless view re-blits its cached texture instead of re-rendering; fixed a latent bug where Python entity set_position/set_spritenumber updated the spatial hash but never invalidated render (masked by the unconditional redraw). A follow-on regression (6b99a1b): the C++ turn manager py_step mutates entity cells directly, bypassing the setters -- it now calls GridData::markCompositeDirty() once per step (must qualify GridData::; using UIDrawable::markCompositeDirty shadows the data-layer override). #334: DiscreteMap exposes its uint8_t plane via the Python buffer protocol (tp_as_buffer, 2D zero-copy numpy/memoryview views). #332: GridData migrated from per-cell UIGridPoint structs (24 B for 2 B payload) + the whole chunk manager to two dense std::vector<uint8_t> planes (walkable/transparent) -- deleted GridChunk/ChunkManager/CHUNK_THRESHOLD, stripped UIGridPoint to a Python-accessor namespace, net -257 lines; pathfinding's isCellWalkable/cellWalkable were the critical non-obvious callers. #335: ColorLayer/TileLayer get zero-copy numpy views through a new with layer.edit() as view: context manager (implements the #328 convention; __exit__ marks the layer dirty) -- (h,w,4) uint8 and (h,w) int32. #338 (issue left open): safe subset only -- rotationTexture is now lazily allocated (unique_ptr) on Grid/GridView; deferred the render_sprite relocation as not worth the churn. Validation was delivered via The Crucible (#354, tests/benchmarks/crucible.py) -- a headless, deterministic, wall-clock A/B harness that safely replaces the windowed Gauntlet (which OOM-hard-locked the desktop during grid ramp). #353 hardened the Gauntlet with predict_bytes/max_load refusal + an RLIMIT_AS backstop + RSS watchdog. Crucible A/B, current master vs the 0.2.8 dist artifact (both headless): grid_alloc -58.9%, layer_fill -56.1%, entity_churn -43.0%, grid_fill -25.4%, fov_storm/step_swarm/path_queries single-digit; geomean 0.673 = ~32.7% faster overall, peak RSS ~103 vs ~119 MB -- the big wins track #332 SoA + #329 indexing. Suite 314/314. Remaining in the thread: #333 (lazy TCOD map rebuild, unblocked by #332), #352 (perspective-grid early-out), and the deferred #338 relocation.
Native profiling rig + hot-path perf batch (#345, #331, #342/#343/#344/#348) -- a Callgrind/perf profiling workflow (make profile -> build-profile/ RelWithDebInfo + frame pointers; make callgrind SCRIPT=...; docs/profiling.md) landed as #345, then drove five measured fixes. #331: hot property getters stop re-importing mcrfpy per call. #348 (found by Callgrind, not by guessing): UIGridView::get_grid re-allocated a throwaway Grid wrapper + weakref every call at 0% cache hit -- now holds one persistent strong ref (get_grid inclusive 72.6M -> 2.1M Ir, -97%). #342: scalar-float animation fast path bypasses two per-frame std::variant visits (Animation::update -18%, variant machinery 473M -> 99M Ir) -- the profiler disproved the guessed strcmp-cascade and weak_ptr-lock hypotheses and found the real cost. #344: memoized Key/InputState enum members instead of rebuilding via EnumMeta.__call__ per event (enum-ctor 19.18M -> 0.228M Ir, -99%; wall-clock -31%). #343: skip the per-frame GetAttrString("update") for non-subclassed scenes (4,559 -> 3 Ir/frame on the real doFrame loop; measuring it required bypassing headless step(), which doesn't call updatePythonScenes() -- filed as #350). Harness total instructions 3,522.9M -> 3,211.5M (-8.8%); suite 307/307 with new regression tests issue_34{2,4,8}_*. Durable sprint doc with A/B numbers at docs/sprint-perf-342-348.md. Spun out #349 (hybrid declarative scene serialization, Major Feature, tier2) from the finding that automation.screenshot() PNG encode is ~96% of a render-profile's instructions.
Tier1 memory-model batch resolved -- all five pre-1.0 freeze decisions from the 2026-07-02 review are closed on master. #326: Color/Vector are value types forever (copies at every property boundary; write-through proxies rejected); #328: with layer.edit() as view: is the single bulk-edit convention for future buffer/numpy APIs (conservative invalidation on __exit__; unblocks #335); #327: threading contract documented -- docs/threading-model.md + normative mcrfpy.lock() docstring ("off-main-thread access outside the lock is undefined"); #330: subinterpreters explicitly excluded from 1.x compatibility; #329: grid.entities re-backed by std::vector -- indexing is O(1) (5000-entity indexed sweep: 49.7 ms -> 0.5 ms), iterator is index-based with the same mutation-guard semantics, suite 304/304. #326/#328/#330 are recorded in the new docs/api-stability.md compatibility policy, enforced by the api-surface snapshot test.
#340 The Gauntlet -- interactive on-screen stress benchmark (tests/benchmarks/gauntlet/). Six trials (ENTITY SWARM, ANIMATION STORM, GRID TITAN, PATHFINDER RUSH, UI AVALANCHE, SIGHTLINE SIEGE) ramp load geometrically until p95 frame time breaks the 16.67 ms budget; live HUD with frame-time sparkline; menu + results screens diff against a committed JSON baseline with letter grades and a geometric-mean GAUNTLET SCORE. First real baseline captured windowed on 0.2.8 (e.g. 10,555 entities, 450 pathfinding queries/tick, 4,123 UI elements at budget). Caveat: desktop noise made callback-heavy trials vary run-to-run -- recapture on a quiet system for a canonical baseline. Found #341 (get_metrics draw_calls/render counters read 0).

Recently Shipped (June 2026)

0.2.8 release -- Version bumped to 0.2.8 (dropped the in-development -7DRL-2026 suffix) and cut for distribution: dist/McRogueFace-0.2.8-{Linux-full.tar.gz,Windows-full.zip,WASM.zip}. Shipped libtcod (Linux .so / Windows .dll / Emscripten .a) rebuilt from submodule 79abc66 so release binaries carry the #321 FOV fix; the Linux build is SDL3=OFF with vendored utf8proc to stay self-contained (only libz + system libs), matching prior releases. Also fixed a pre-existing tools/package.sh bug that affected 0.2.7 too: the Linux package shipped the bare libtcod.so instead of its DT_NEEDED SONAME libtcod.so.2 (+ compat symlink, mirroring the SFML packaging), so the runtime loader couldn't resolve it on a clean machine -- an absolute dev RUNPATH had masked this locally. No Gitea issue tracks this release (declined). Local commit cf844f4, pushed to origin/master; the 0.2.8 tag exists locally but has not been pushed yet.
#321 (HIGH) -- Fixed the ColorLayer.draw_fov heap-buffer-overflow by bumping libtcod-headless to 79abc66, pulling in upstream FOV overflow fixes (root cause: off-by-one in view_array_insert overflowing active_views in fov_permissive2.c; the "bad-free in ~GridData" of the issue title is the downstream symptom). Verified by A/B replay of the #312 fuzz_fov crash corpus under clang-18 ASan -- pre-fix (8835239) inputs abort with the overflow inside GridData::computeFOV, post-fix (79abc66) all clean plus a 45s/21,952-run fuzz smoke. (The gitignored shipped __lib/libtcod.so needed rebuilding from this commit for release binaries to carry the fix -- done for 0.2.8, see above.)
#322-#325 (fuzz-surfaced safety batch) -- the four remaining #312 fuzz bugs fixed and regression-tested. #322: WangSet.terrain_enum (and the parallel AutoRuleSet.terrain_enum) ignored Python C-API return codes, so an invalid-UTF-8 import name left an exception pending and the next PyObject_Call tripped a _PyErr_Occurred assertion/abort; every C-API return is now checked and the real exception propagated. #323/#324/#325: NaN/inf (or out-of-long-range) floats reached unchecked float->integer casts -- pitch_shift factor (AudioEffects.cpp:27, nan->unsigned long), hsl_shift shifts (PyTexture.cpp:458, nan->unsigned char), and Vector.int components (PyVector.cpp:610, inf->long), all undefined behavior; each now validates finiteness/range at the binding boundary and raises ValueError/OverflowError. Verified by A/B replay of the #312 crash corpus under clang-18 UBSan/ASan: all four inputs abort pre-fix at the exact cited lines and run clean post-fix, with four new regression tests (tests/regression/issue_322..325_*).
#312 -- Fuzz coverage extended to the remaining public API surface. Four new libFuzzer targets (fuzz_audio_dsp, fuzz_import_parsers, fuzz_texture_factory, fuzz_shader_bindings) cover the Tier A/B gaps (external file parsers, audio DSP math, raw-byte texture ingestion, shader uniform-binding lifetime); Tier C surface (Line/Circle/Arc, Scene.children collections, find/find_all/bresenham/lock, grid spatial queries, GridPoint dynamic attrs, Grid.find_path+AStarPath, ColorLayer perspective/draw_fov, layer apply_*) folded into the five existing targets. Each new target is signature-validated against the live API and seeded from real fixtures. The campaign immediately found five new bugs -- filed #321-#325 (no fixes this round; targets only). A pre-existing infra fix rode along: tools/build_debug_libs.sh flag-quoting bug that broke instrumented debug-lib rebuilds. The benchmark triplet is deliberately excluded from fuzzing (end_benchmark() writes a file per call).
#320 -- Caption constructor positional signature now matches its frozen docstring. The docstring advertised Caption(pos, font, text, ...) (parallel to Sprite/Entity, whose 2nd positional is the resource), but the implementation laid its two positional slots out as (pos, text) with font keyword-only, so Caption((x,y), None, "text") raised TypeError. Fixed UICaption::init to (pos, font, text) positional-or-keyword. Audited zero live callers of the old (pos, text) 2-positional form. Also added the matching read-only Caption.font getter (the class docstring listed font as an attribute but no getter existed; it now reflects the supplied or engine-default font). Also rewrote two stale unit tests (test_animation_raii, test_animation_property_locking) that called the removed mcrfpy.Animation(...) constructor to use drawable.animate(...) -- preserving the suite's only conflict_mode (#120) coverage and the weak-target RAII checks. Suite now 297/297.
#317 / #318 / #319 -- The three code-level bugs surfaced by the #314 docstring-accuracy verify pass, fixed together. #317: automation.scroll() dropped the x of its position argument (the scroll delta now has its own injectMouseEvent parameter, so the real x/y is forwarded). #318: GridView.texture always returned None (a TODO stub) -- it now returns a Texture wrapper (and since mcrfpy.Grid/mcrfpy.GridView are one type post-#252, both names benefit). #319: Entity.visible_entities(radius=None) raised TypeError (the i format code rejects None) -- radius is now parsed as an object so None/omitted/-1 mean "grid default". Regression tests for each; api-surface snapshot re-baselined and docs/stubs regenerated.
#316 -- Sparse (windowed) perspective writeback in UIEntity::updateVisibility. The demote+promote passes are now clipped to an AABB sized to fov_radius (with a prev_fov window cache so a moving entity leaves no trailing "ghost vision"), replacing two full-W*H walks per entity. The Phase 5.2 benchmark's flat ~25-36 ms/entity writeback overhead on a 1000x1000 grid collapses to single-digit microseconds (384x-6577x on the cheap algorithms; lost in timing noise on the rest). Adversarial verify caught a regression the happy-path test missed -- externally-assigned maps (the documented from_bytes load/resume path) need a one-shot full demote (perspective_full_demote_pending) since prev_fov only bounds engine-promoted cells; fixed and locked with a 7-section regression test.
#313 -- UIEntity::grid migrated from shared_ptr<UIGrid> to shared_ptr<GridData> (post-#252 refactor cleanup), adding a new public entity.texture read/write property. Merged to master.
#314 -- API audit follow-through complete. (1) Snapshot lock: a public API-surface regression test (tests/unit/api_surface_snapshot_test.py) enshrines the frozen contract. (2) F15: all 289 raw docstring slots across the 20 frozen binding files converted to MCRF_* macros (frozen surface 100% compliant), driven by two one-agent-per-file workflows with build/doc gates and an adversarial signature-accuracy verify pass. Property types now resolve to real types (not Any) and read-only flags are correct. (3) A strict frozen-docstring gate (tools/check_frozen_docstrings.sh, wired into generate_all_docs.sh) locks it against regression. Breaking-change findings (F1/F4/F6/F11/F13) closed earlier; F7/F8/F10 deferred as non-1.0. Code-level bugs surfaced by the verify pass filed as #317/#318/#319.

Active Follow-Ups

The memory-model review (#326-#338) is nearly closed out: the five tier1 freeze decisions (#326-#330), #331 (hot-getter fast path), #332 (GridData SoA), #333 (lazy TCOD map rebuild), #334 (DiscreteMap buffer protocol), and #335 (numpy layer views) are all resolved on master. Still open: #338 (per-instance memory diet -- shipped as a safe subset, the render_sprite relocation deferred), #336 (free-threading hardening), #337 (numpy availability strategy), and #352 (perspective-grid render early-out).
Two bugs surfaced by the grid type-split are open: #369 (.parent allocates a fresh wrapper on every read, so child.parent is parent is always False -- the same identity problem the type split fixed elsewhere) and #372 (tests/demo/ is rotted and unrunnable -- screens/base.py calls mcrfpy.sceneUI, removed long ago; the demos are not in the test suite, so nothing caught it). #356 (doc/stub generators miss module-level dynamic attributes like current_scene, scenes) is also open.
#350 (headless mcrfpy.step() bypasses updatePythonScenes(), so scene.update() never fires under step() -- a testability gap surfaced while benchmarking #343) is open, tier2. #349 (declarative scene serialization) is an open tier2 design proposal.
Gauntlet baseline should be recaptured on a quiet system (tests/benchmarks/gauntlet/run_gauntlet.py) -- the committed first baseline is real but desktop-noisy for the callback-heavy trials. #341 (render counters read 0 in get_metrics) blocks richer per-subsystem attribution in the HUD.
0.2.8 is released to master (cf844f4, pushed) but the 0.2.8 git tag is still local-only -- push it when ready to publish the release. Master is current at 36e74e0 (grid input revival + type split); the closes #... commit trailers took their issues down on merge.

Engine Eras

One engine, accumulating capabilities. Nothing is thrown away.

Era	Focus	Status
McRogueFace	2D tiles, roguelike systems, procgen	Active -- approaching 1.0
McVectorFace	Sparse grids, vector graphics, physics	Planned
McVoxelFace	Voxel terrain, 3D gameplay	Proof-of-concept complete

3D/Voxel Pipeline (Experimental)

The 3D pipeline is proof-of-concept scouting for the McVoxelFace era. It works and is tested but is explicitly not part of the 1.0 API freeze.

What exists: Viewport3D, Camera3D, Entity3D, MeshLayer, Model3D (glTF), Billboard, Shader3D, VoxelGrid with greedy meshing, face culling, RLE serialization, and navigation projection.

Known gaps: Some Entity3D collection methods, animation stubs, shader pipeline incomplete.

Maturity track: These modules will mature on their own timeline, driven by games that need 3D. They won't block 2D stability.

Future Directions

These are ideas on the horizon -- not yet concrete enough for issues, but worth capturing.

McRogueFace Lite

A spiritual port to MicroPython targeting the PicoCalc and other microcontrollers. Could provide a migration path to retro ROMs or compete in the Pico-8 space. The core idea: strip McRogueFace down to its essential tile/entity/scene model and run it on constrained hardware.

McVectorFace Era

The next major capability expansion. Sparse grid layers, a polygon/shape rendering class, and eventually physics integration. This would support games that aren't purely tile-based -- top-down action, strategy maps with irregular regions, or hybrid tile+vector visuals. See the Strategic Direction wiki for the full era model.

McRogueFace Standard Library

A built-in collection of reusable GUI widgets and game UI patterns: menus, dialogs, inventory screens, stat bars, text input fields, scrollable lists. These would ship with the engine as importable Python modules, saving every game from reimplementing the same UI primitives. Think of it as mcrfpy.widgets -- batteries included.

Pip/Virtualenv Integration

Rather than inverting the architecture to make McRogueFace a pip-installable package, the nearer-term goal is better integration in the other direction: making it easy to install and use third-party Python packages within McRogueFace's embedded interpreter. This could mean virtualenv awareness, a mcrf install command, or bundling pip itself.

Open Issues by Area

29 open issues across the tracker. Key groupings:

Bugs (#369, #372, #356, #341, #350) -- .parent identity churn; rotted tests/demo/; doc generators miss module-level dynamic attributes; get_metrics render counters read 0 (found by the Gauntlet #340); headless step() bypasses updatePythonScenes()
Memory-model review, July 2026 (#336, #337, #338 remaining; #326-#335 resolved) -- per-instance memory diet, free-threading hardening, numpy availability strategy
Grid / rendering (#352, #152, #67, #124, #107, #347) -- perspective-grid render early-out; sparse layers; infinite worlds; grid point animation; particle system; SFML vs SDL2/WebGL renderer parity
Design proposals (#349) -- hybrid declarative scene serialization (test oracle + save/load)
Demos / tutorials (#167, #248, #154, #156, #55) -- r/roguelikedev series, Crypt of Sokoban remaster, LLM agent simulations
Platform/distribution (#70, #54, #62, #53) -- Packaging without the embedded interpreter, Jupyter, multiple windows, input methods
WASM tooling (#239, #346) -- Automated browser testing; web-build profiling docs (sibling to #345)
Deferred (#220, #46, #45) -- Subinterpreter support / tests, accessibility modes

See the Forgejo issue tracker for current status.

Resources

Issue Tracker: Forgejo Issues
Wiki: Strategic Direction, Issue Roadmap, Development Workflow
Build Guide: See CLAUDE.md for build instructions
Tutorial: roguelike_tutorial/ for implementation examples

27 KiB Raw Blame History