ed
01b6c68e20
docs(reports): FOLLOWUP_module_taxonomy_20260627 - models.py audit + refactor plan
User directive: models.py is a dumping ground. Needs clean mma_/project_
taxonomy per AGENTS.md 'File Size and Naming Convention' HARD RULE.
Audit findings:
- models.py is 1044 lines, 13 regions, 5+ unrelated domains
- 36 classes/functions in 1 file
- Top docstring claims MMA + project config but actually contains:
editor configs, MCP config, file contexts, persona configs, Pydantic proxies
- Phase 2 of cruft_elimination_20260627 just added 6 more (ProjectContext)
making the mess worse
Proposed taxonomy:
- src/mma.py = main MMA file (Ticket, Track, WorkerContext, ThinkingSegment,
TrackState)
- src/project.py = main project-config file (ProjectContext + 5 sub + config IO
+ parse_history_entries)
- src/project_files.py = file-related (FileItem, ContextPreset, ContextFileEntry,
NamedViewPreset, Preset)
- Tool/Persona/Editor/MCP/Workspace dataclasses merge into their existing
sub-system files (tool_presets.py, tool_bias.py, personas.py, external_editor.py,
mcp_client.py, workspace_manager.py)
- src/models.py reduced to ~60 lines (Pydantic proxies + AGENT_TOOL_NAMES only)
5-phase refactor plan:
- Phase 1: src/mma.py + 5 file imports updated
- Phase 2: src/project.py + project_manager.py imports updated
- Phase 3: src/project_files.py + 4 file imports updated
- Phase 4: Merge 8+ dataclasses into 6 existing sub-system files
- Phase 5: Reduce src/models.py to ~60 lines
11 VCs. 1 atomic commit per file move. Regression-guard tests after each.
Critical: the cruft_elimination_20260627 Phase 2 spec must be updated to
say 'add ProjectContext to src/project.py' (NOT src/models.py). Tier 2
should re-execute Phase 2 with the corrected file location before this
broader taxonomy refactor starts.
User instruction: 'I need top-level prefix for modules that cannot have
their definitions in the single file (mma_ with mma.py being the main one,
project_, with project.py, etc)'.
2026-06-26 05:59:29 -04:00
..
2026-06-22 13:34:29 -04:00
2026-06-07 15:15:30 -04:00
2026-05-13 16:05:57 -04:00
2026-06-21 14:28:16 -04:00
2026-06-08 20:32:42 -04:00
2026-06-07 18:08:04 -04:00
2026-06-08 21:17:54 -04:00
2026-06-26 04:41:43 -04:00
2026-06-08 23:42:21 -04:00
2026-06-23 21:52:57 -04:00
2026-06-24 15:49:18 -04:00
2026-06-20 17:57:05 -04:00
2026-06-20 18:55:20 -04:00
2026-06-25 21:18:01 -04:00
2026-06-07 12:27:20 -04:00
2026-06-12 12:52:20 -04:00
2026-05-13 08:10:56 -04:00
2026-06-11 00:02:34 -04:00
2026-06-12 22:16:40 -04:00
2026-06-16 09:07:42 -04:00
2026-06-25 16:47:21 -04:00
2026-06-26 05:59:29 -04:00
2026-05-13 08:10:56 -04:00
2026-06-11 20:56:16 -04:00
2026-05-13 08:10:56 -04:00
2026-06-12 13:29:51 -04:00
2026-06-11 17:50:11 -04:00
2026-06-17 12:25:29 -04:00
2026-06-17 12:23:03 -04:00
2026-06-21 18:32:02 -04:00
2026-06-21 22:39:14 -04:00
2026-05-13 08:10:56 -04:00
2026-06-19 01:00:03 -04:00
2026-06-18 09:41:33 -04:00
2026-06-18 09:41:33 -04:00
2026-05-13 08:10:56 -04:00
2026-06-25 14:33:21 -04:00
2026-06-06 20:56:12 -04:00
2026-06-21 12:36:41 -04:00
2026-06-21 09:37:19 -04:00
2026-06-22 10:52:01 -04:00
2026-06-21 09:37:41 -04:00
2026-06-20 12:32:57 -04:00
2026-06-12 12:52:20 -04:00
2026-06-11 09:33:18 -04:00
2026-06-11 21:20:44 -04:00
2026-06-11 22:33:19 -04:00
2026-06-11 19:46:09 -04:00
2026-06-09 12:31:21 -04:00
2026-06-09 14:38:30 -04:00
2026-06-09 15:04:42 -04:00
2026-06-21 08:43:38 -04:00
2026-06-17 16:18:14 -04:00
2026-06-18 15:28:53 -04:00
2026-06-17 22:26:38 -04:00
2026-06-18 09:06:03 -04:00
2026-06-18 00:46:29 -04:00
2026-06-24 23:05:10 -04:00
2026-06-24 21:39:58 -04:00
2026-06-16 10:48:15 -04:00
2026-06-22 01:07:33 -04:00
2026-06-19 20:45:11 -04:00
2026-06-25 00:41:13 -04:00
2026-06-12 12:52:20 -04:00
2026-06-24 16:24:53 -04:00
2026-06-13 18:51:14 -04:00
2026-06-13 18:44:57 -04:00
2026-06-13 18:49:01 -04:00
2026-06-06 14:22:18 -04:00
2026-06-06 14:22:18 -04:00
2026-05-13 08:10:56 -04:00
2026-06-19 18:15:46 -04:00
2026-06-09 16:58:33 -04:00
2026-06-08 21:17:54 -04:00
2026-06-08 23:45:25 -04:00
2026-06-08 21:17:54 -04:00
2026-06-08 09:24:14 -04:00
2026-06-09 00:26:05 -04:00
2026-06-10 18:08:26 -04:00
2026-06-09 10:21:45 -04:00
2026-06-09 00:26:05 -04:00
2026-06-13 18:57:56 -04:00
2026-06-17 10:45:54 -04:00
2026-06-20 11:27:44 -04:00
2026-06-24 21:25:50 -04:00
2026-06-13 18:29:21 -04:00
2026-06-15 11:32:33 -04:00
2026-06-20 18:00:26 -04:00
2026-06-22 11:49:00 -04:00
2026-06-24 18:27:24 -04:00
2026-06-25 13:23:13 -04:00
2026-06-24 10:20:07 -04:00
2026-06-26 05:20:58 -04:00
2026-06-21 13:03:07 -04:00
2026-06-15 14:57:08 -04:00
2026-06-24 13:50:30 -04:00
2026-06-18 15:36:01 -04:00
2026-06-24 15:49:18 -04:00
2026-06-25 18:52:34 -04:00
2026-06-20 12:33:55 -04:00
2026-06-21 23:38:51 -04:00
2026-06-15 21:28:29 -04:00
2026-06-16 00:36:24 -04:00
2026-06-19 19:35:52 -04:00
2026-06-20 17:17:06 -04:00
2026-06-21 09:10:18 -04:00
2026-06-20 02:51:05 -04:00
2026-06-17 17:01:19 -04:00
2026-06-18 15:28:53 -04:00
2026-06-17 10:45:54 -04:00
2026-06-19 14:29:19 -04:00
2026-06-16 23:29:00 -04:00
2026-06-20 07:46:10 -04:00
2026-06-18 18:30:11 -04:00
2026-06-17 16:35:44 -04:00
2026-06-25 21:24:39 -04:00
2026-06-07 12:27:20 -04:00
2026-06-22 00:01:34 -04:00
2026-06-21 15:44:06 -04:00
2026-06-22 01:46:07 -04:00
2026-06-21 16:28:24 -04:00
2026-06-22 01:25:50 -04:00
2026-06-23 17:20:37 -04:00
2026-06-23 15:54:08 -04:00
2026-06-23 21:10:51 -04:00
2026-06-23 16:18:02 -04:00
2026-06-23 15:17:50 -04:00
2026-06-21 17:16:05 -04:00
2026-06-21 23:07:20 -04:00
2026-06-21 23:31:03 -04:00
2026-06-22 01:04:43 -04:00
2026-06-22 00:52:05 -04:00
2026-06-21 22:41:50 -04:00
2026-06-21 16:46:19 -04:00
2026-06-21 22:21:05 -04:00
2026-06-22 19:39:47 -04:00
2026-06-22 01:07:33 -04:00
2026-06-10 21:25:56 -04:00