refactor(layout): reduce lua/forge root sprawl with clearer namespaces #550

New issue

Closed

opened 2026-04-29 18:40:25 +00:00 by barrettruth · 0 comments

barrettruth commented

2026-04-29 18:40:25 +00:00

Problem

lua/forge/ currently has around fifty top-level entries. Even with better seams, that root is still denser than it should be for quick navigation.

Scope

Identify a behavior-preserving layout step that reduces top-level sprawl by moving a coherent family of modules behind clearer directories or namespace facades, while preserving compatibility through thin root shims where needed.

This issue should produce a real structural reduction in root-level clutter, not just rename files.

Constraints

one coherent family at a time
keep compatibility where current requires would otherwise break
no giant one-shot tree rewrite

Dependency

This should follow the init/export-discipline work so the ownership model is clearer before moving files around.

## Problem `lua/forge/` currently has around fifty top-level entries. Even with better seams, that root is still denser than it should be for quick navigation. ## Scope Identify a behavior-preserving layout step that reduces top-level sprawl by moving a coherent family of modules behind clearer directories or namespace facades, while preserving compatibility through thin root shims where needed. This issue should produce a real structural reduction in root-level clutter, not just rename files. ## Constraints - one coherent family at a time - keep compatibility where current requires would otherwise break - no giant one-shot tree rewrite ## Dependency This should follow the init/export-discipline work so the ownership model is clearer before moving files around.