cmd-internal-refactor
cmd/gormes Internal Refactor
Quick start
Move exactly one cmd/gormes command domain without behavior changes. A domain is not one file: when the user says "too slow", "refactor all", or supplies a file list, use accelerated same-domain mode to select the largest cohesive domain cluster from that list, move its directly owned behavior/tests/facades in one pass, validate once, then stop before a second domain. Start every move with a bug-finding oracle: capture the selected command's current observable behavior, add/keep characterization tests for risky seams, and rerun the same evidence after extraction.
Mission
Thin cmd/gormes toward this final topology:
cmd/gormes/main.go: executable shim and root factory delegation only. Other tracked root entries, including docs such ascodemap.md, must be rehomed or explicitly classified before final topology claims.internal/platform/cli/gormescli: Cobra wiring, flags, args, help, command registration, exit-code seams, CLI/golden tests, root test helpers.internal/app/<domain>: command-local behavior, options/results, formatting/path/env helpers, behavior tests.- deeper
internal/<runtime-domain>packages: reusable gateway, provider, session, persistence, memory, TUI, channel, and tool runtime behavior.
This is refactor-only, not blind relocation. Use the move to expose regressions and preexisting defects, but preserve current Gormes behavior unless the refactor itself introduced the bug. If a slice needs intentional behavior changes, split them out and route through planner/builder/TDD.