Private
Public Access
0
0
Commit Graph

75 Commits

Author SHA1 Message Date
ed 1208ccd89d docs(docker): add Gitea registry push and pull instructions 2026-06-03 08:48:42 -04:00
ed dd52df7e11 conductor(plan): Mark docker web frontend plan complete 2026-06-03 08:28:22 -04:00
ed ea3bbbc828 docs(docker): add Unraid deployment guide 2026-06-03 08:26:35 -04:00
ed db177e4494 docs(api): correct endpoint /api/mma_status -> /api/gui/mma_status across docs 2026-06-03 00:56:32 -04:00
ed 87d5870076 docs(readme): add 8 new guide entries to Guides table 2026-06-02 23:40:16 -04:00
ed 7ade88d577 docs(models): add guide_models.md 2026-06-02 23:38:52 -04:00
ed 9ea7989f90 docs(mma): add guide_multi_agent_conductor.md 2026-06-02 23:37:10 -04:00
ed 6415e84994 docs(app-controller): add guide_app_controller.md 2026-06-02 23:35:29 -04:00
ed a58a2fd887 docs(mcp-client): add guide_mcp_client.md 2026-06-02 23:33:17 -04:00
ed f7663ab2e8 docs(api-hooks): add guide_api_hooks.md 2026-06-02 23:27:13 -04:00
ed 0426239a13 docs(ai-client): add guide_ai_client.md 2026-06-02 23:25:28 -04:00
ed 779eb006ba docs(gui_2): add guide_gui_2.md
Comprehensive guide for the main GUI file (~260KB, 5400 lines):
- Architecture (UI delegation pattern: module-level render functions + App class)
- App class breakdown (init, key state, render entry point)
- The render_main_interface flow (calls ~15 hub renderers)
- Modal pattern via _render_window_if_open helper
- Keyboard shortcuts (Ctrl+Shift+P, Ctrl+Alt+R, Ctrl+L, Ctrl+Enter)
- Key patterns: hot reload, snapshots, window state, modal
- Public methods worth knowing table
- Performance considerations (60 FPS target, perf monitor)
- Testing approaches (pure, integration via live_gui, mock_app)
- Common operations: adding toggleable window, modal, hook API exposure
2026-06-02 23:23:35 -04:00
ed 9a39492617 docs(readme): update ASCII file tree visualizations to match current state
docs/Readme.md: was showing 5 guides (architecture, tools, mma, simulations, meta_boundary); now shows all 14 current guides plus MMA_Support/, reports/, superpowers/. Also expanded src/ tree from 22 modules to 53 modules, added simulation/ sim_* files, tests/ test infrastructure, scripts/ audit + docker scripts, and corrected entry-point paths (sloppy.py, manual_slop.toml).

Readme.md: 'Module by Domain' table was showing 22 src/ modules; now shows all 53 current modules. Updated MCP tool count from 26 to 45. Added all modules added since 2026-02 doc refresh: rag_engine, beads_client, hot_reloader, personas, presets, context_presets, tool_presets, tool_bias, command_palette, commands, workspace_manager, theme_2, theme_nerv, theme_nerv_fx, fuzzy_anchor, history, imgui_scopes, summary_cache, markdown_helper, patch_modal, diff_viewer, external_editor, orchestrator_pm, synthesis_formatter, thinking_parser.
2026-06-02 23:13:50 -04:00
ed 7825588200 docs(testing): add comprehensive guide_testing.md
Comprehensive guide covering the 251-test-file suite:
- Test file layout and naming conventions
- 7 conftest.py fixtures (isolate_workspace, reset_paths, reset_ai_client, vlogger, kill_process_tree, mock_app, app_instance, live_gui) with their mechanisms
- 5 test categories (unit, integration, mock app, headless, opt-in)
- Markers (integration, clean_install, docker) and how to filter by them
- Hook API for integration tests (ApiHookClient methods, predefined_callbacks pattern)
- Common test patterns (pure function, mock, live_gui, exception, parametrized)
- Test configuration in pyproject.toml
- Running tests (all, by file, by marker, with timeout, etc.)
- Adding new tests (pure, integration, opt-in)
- Debugging failed tests (common failure modes and fixes)
- The check_test_toml_paths.py audit script
- Test data flow diagram
2026-06-02 23:05:02 -04:00
ed 86d093e101 docs(command-palette): rewrite guide to match actual implementation
- Updated to reflect 13 tests (6 unit + 7 live_gui) instead of hypothetical async test
- Removed Everything mode and async context preview sections (not yet implemented; marked as future work)
- Updated Commands Registry section to reference actual src/commands.py file
- Added Implementation section with file layout and Command/CommandRegistry/CommandModal reference
- Added Built-in Commands table reflecting the actual 11 commands shipped
- Added Adding Custom Commands section with decorator and explicit-Command patterns
- Added Keyboard Reference table
- Updated Testing section with accurate coverage and test pattern
- Moved unimplemented features (Everything mode, user-defined commands, plugin system) to Future Work
2026-06-02 22:46:48 -04:00
ed 0d6e31bf09 docs(plans): implementation plans for 4 tracks - command palette, test consolidation, clean install, docker web 2026-06-02 21:23:37 -04:00
ed b382279888 docs(spec): designs for 4 new tracks - command palette, test consolidation, clean install test, docker web frontend 2026-06-02 21:15:02 -04:00
ed 3251cb57b7 docs(nerv-theme): fix symbol parity - apply_nerv_theme -> apply_nerv 2026-06-02 20:11:56 -04:00
ed f5c0d054fe docs(index): replace 7 new-guide placeholders with real summaries pointing to completed guides 2026-06-02 19:59:56 -04:00
ed 3b3c37a298 docs(command-palette): new guide covering fuzzy search, async context preview, Everything mode, and performance 2026-06-02 19:57:50 -04:00
ed 5379312bc7 docs(workspace-profiles): new guide covering profile schema, manager, scope inheritance, and auto-switch 2026-06-02 19:55:08 -04:00
ed 94a8d06724 docs(nerv-theme): new guide covering palette, geometry, FX, configuration, performance, and accessibility 2026-06-02 19:51:27 -04:00
ed 7fd7294747 docs(personas): new guide covering data model, scope inheritance, MMA integration, editor modal 2026-06-02 19:48:42 -04:00
ed 6b6b3b066c docs(hot-reload): new guide covering state-preserving reload, delegation pattern, error handling, and registration 2026-06-02 19:42:52 -04:00
ed 941b459bc8 docs(beads): new guide for Beads mode covering architecture, mock client, MCP tools, and MMA integration roadmap 2026-06-02 19:40:15 -04:00
ed 3ad6615ec2 docs(rag): new guide for RAG subsystem covering architecture, components, data flow, configuration, and testing 2026-06-02 19:36:04 -04:00
ed 4f125241dd docs(meta-boundary): add cross-tool abstraction section, OpenCode as secondary toolchain, bridge status notes 2026-06-02 19:24:41 -04:00
ed 8444285d70 docs(context-curation,shaders): add Structural File Editor (Phase 7) and NERV theme effects sections 2026-06-02 19:21:13 -04:00
ed 959e7f30a3 docs(simulations): add workspace isolation, mock_app/app_instance fixtures, and Test Areas by Subsystem table 2026-06-02 19:18:36 -04:00
ed 3cf0539641 docs(tools): update tool count from 26 to 45, add edit_file, derive_code_path, and Beads tools section 2026-06-02 19:11:58 -04:00
ed a9cb8cae11 docs(mma): add persona application, expanded tier_usage schema, Beads and Workspace profile roadmap sections 2026-06-02 19:07:28 -04:00
ed f81f1f5eaa docs(architecture): add MiniMax provider, RAG integration, Tier 4 patch flow, discussion compression, subagent summarization, async tool execution 2026-06-02 18:57:56 -04:00
ed a66878c168 docs(index): link guide_context_curation and guide_shaders_and_window; add legacy MMA section and 7 new-guide placeholders 2026-06-02 18:49:42 -04:00
ed 560c5dd131 docs(plans): implementation plans for comprehensive documentation refresh (3 sub-tracks) 2026-06-02 18:39:04 -04:00
ed 8175c94ddf docs(spec): comprehensive documentation refresh design (3 sub-tracks) 2026-06-02 18:30:59 -04:00
ed 29244acc74 docs(superpowers): Add agent fix design and implementation plan 2026-05-16 02:20:31 -04:00
ed e6d9374e69 spec to hopefully unfuck opencode 2026-05-16 02:14:43 -04:00
ed 14d45e9dd0 superpowers- plan for hot reload(minimax) 2026-05-16 01:30:44 -04:00
ed 5fa933728e docs(spec): Add profiling system design spec (Phase 1 Diagnostics + Phase 2 Tracy) 2026-05-15 00:03:57 -04:00
ed 07ddcf068b docs(spec): Add hot reloader design spec 2026-05-14 22:06:44 -04:00
ed 46a415c9a0 docs(mcp): Document new Python structural tools 2026-05-13 22:01:39 -04:00
ed 5babdc16ae docs: Add ai_client.py style curation implementation plan 2026-05-13 18:18:32 -04:00
ed bcca433f27 docs: Add ai_client.py style curation design spec 2026-05-13 18:17:59 -04:00
ed ae063c77ed docs: update decoupling report with deletion commit details 2026-05-13 16:05:57 -04:00
ed 4025a7130d revert(ai_client): remove incomplete decoupling, restore clean startup
The AI client decoupling was never properly implemented and added
unnecessary complexity. The actual startup bottleneck was RAG initialization
which is now handled via async initialization.

Report written to docs/reports/ai_decoupling_revert_report.md
2026-05-13 16:01:58 -04:00
ed 38270ffa16 docs: Add AI Server IPC implementation plan 2026-05-13 08:35:09 -04:00
ed 0c79e76bad docs: Add AI Server IPC design spec 2026-05-13 08:33:09 -04:00
ed 0704b76fc4 move MMA_Support to docs 2026-05-13 08:13:18 -04:00
ed 4fe5fbd7d2 move reports in docs to a dedicated folder. 2026-05-13 08:10:56 -04:00
ed cb87aacafe conductor(plan): Add ImGui context manager implementation plan 2026-05-11 22:30:58 -04:00