Goal
Reduce contributor context and merge conflicts only where six-month churn and present ownership pain
justify a split. This is not a blanket LOC initiative.
Evidence
The architecture review found persistent churn in client-types.ts, core/interaction dispatch,
CLI/help surfaces, and large mirrored tests. The descriptor registry is large but materially less
hot over six months, so it should not be split merely because of size.
Candidate work, after owning contract moves
- split
src/core/dispatch-interactions.ts by interaction concept;
- split CLI flag/help data by existing command family while retaining parser-level aggregation and
hand-authored help prose;
- split client options/results by domain as canonical contracts move below the client;
- mirror each source split in its tests, prioritizing monolithic interaction/platform test files.
Before opening an implementation PR, refresh churn × size on current paths and select one coherent
surface. One issue/PR should answer one ownership question.
Constraints
- No blanket
>500 LOC failure.
- No one-folder-per-command mechanical layout.
- Do not split stable cohesive files solely to reduce line count.
- Prefer deep domain modules and package-boundary barrels only.
Completion criteria
- Child issues link current churn × size evidence.
- Each split reduces the files/concepts an agent must load for a focused change.
- Dependency direction is unchanged or improved.
- Fallow, layering, focused tests, typecheck, lint, and build pass.
Origin: post-#1174 architecture follow-up.
Goal
Reduce contributor context and merge conflicts only where six-month churn and present ownership pain
justify a split. This is not a blanket LOC initiative.
Evidence
The architecture review found persistent churn in
client-types.ts, core/interaction dispatch,CLI/help surfaces, and large mirrored tests. The descriptor registry is large but materially less
hot over six months, so it should not be split merely because of size.
Candidate work, after owning contract moves
src/core/dispatch-interactions.tsby interaction concept;hand-authored help prose;
Before opening an implementation PR, refresh churn × size on current paths and select one coherent
surface. One issue/PR should answer one ownership question.
Constraints
>500 LOCfailure.Completion criteria
Origin: post-#1174 architecture follow-up.