refactor(core): group root modules into stable namespaces #556

Merged

barrettruth merged 1 commit from refactor/root-module-layout into main

2026-04-29 20:30:03 +00:00

barrettruth commented

2026-04-29 20:28:51 +00:00

Problem

The root lua/forge/ directory was still carrying 43 top-level modules, which made the filesystem harder to scan as an architectural map even though several of those files already belonged to obvious internal families.

Solution

Group the action, ci, compose, format, log, pr, state, and surface families under stable namespace directories with init.lua facades, update internal requires and specs to follow the new owning paths, and keep documented public module names such as require('forge.pr') and require('forge.format') stable while cutting the lua/forge root down to 20 top-level files.

## Problem The root `lua/forge/` directory was still carrying 43 top-level modules, which made the filesystem harder to scan as an architectural map even though several of those files already belonged to obvious internal families. ## Solution Group the action, ci, compose, format, log, pr, state, and surface families under stable namespace directories with `init.lua` facades, update internal requires and specs to follow the new owning paths, and keep documented public module names such as `require('forge.pr')` and `require('forge.format')` stable while cutting the `lua/forge` root down to 20 top-level files.