ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

more diagrams (claude on agy)

Browse Source
This commit is contained in:
ed
2026-06-12 22:48:09 -04:00
parent c00161a13d
commit d4fbcb16d9
1 changed files with 228 additions and 80 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/gui_2.py
+228 -80
View File
@@ -1648,6 +1648,30 @@ if __name__ == "__main__":
main() main()
def render_main_interface(app: App) -> None: def render_main_interface(app: App) -> None:
"""
Top-level per-frame orchestrator. Dispatches every subsystem in the correct order:
error/stale overlay tints, perf bookends, GUI task draining, modal rendering,
auto-save, comms/tool-log caching, and all dockable windows.
SSDL Shape:
`[I:overlays] -> [I:task_drain] -> [I:modals] -> [I:windows] -> [I:popups]`
ASCII Layout Map:
Full-screen dockspace (managed by imgui_bundle):
+-------------------+------------------------------------+
| Project Settings | Discussion Hub |
| AI Settings | +--------------------------------+ |
| Files & Media | | History entries (scrollable) | |
| Usage Analytics | +--------------------------------+ |
| MMA Dashboard | [splitter] |
| Task DAG | [Message] [Response] |
| Tier 1..4 streams | |
+-------------------+------------------+-----------------+
| Operations Hub (tab-bar) | Theme window |
| [Comms][Tools][Usage][Ext][Layouts] | |
+---------------------------------------+-----------------+
(Modals: Approve Script, MMA Step/Spawn, Context, Patch...)
"""
if hasattr(app, "controller") and hasattr(app.controller, "mark_first_frame_rendered"): if hasattr(app, "controller") and hasattr(app.controller, "mark_first_frame_rendered"):
app.controller.mark_first_frame_rendered() app.controller.mark_first_frame_rendered()
render_error_tint(app) render_error_tint(app)
@@ -1760,13 +1784,23 @@ def render_custom_title_bar(app: App) -> None:
def render_usage_analytics_panel(app: App) -> None: def render_usage_analytics_panel(app: App) -> None:
""" """
Renders the aggregate dashboard panel for usage, budgeting, cache analytics, Renders the aggregate dashboard panel for usage, budgeting, cache analytics,
tool performance metrics, and session insights. tool performance metrics, session insights, and RAG status.
State Mutations:
None directly (delegated to sub-panels).
SSDL Shape: SSDL Shape:
`[I] -> [B:token_budget] -> [B:cache_panel] -> [B:tool_analytics] -> [B:session_insights]` `[I:token_budget] -> [I:cache_panel] -> [I:tool_analytics] -> [I:session_insights] -> [I:rag_status]`
ASCII Layout Map:
+---------------------------------------------------------+
| [Prompt Utilization sub-panel] |
| --- |
| [Cache Analytics sub-panel] |
| --- |
| [Tool Usage sub-panel] |
| --- |
| [Session Insights sub-panel] |
| --- |
| [RAG: indexing...] (clickable status badge) |
+---------------------------------------------------------+
""" """
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_usage_analytics_panel") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_usage_analytics_panel")
render_token_budget_panel(app) render_token_budget_panel(app)
@@ -1794,15 +1828,32 @@ def render_usage_analytics_panel(app: App) -> None:
def render_diagnostics_panel(app: App) -> None: def render_diagnostics_panel(app: App) -> None:
""" """
Renders the Diagnostics panel, displaying performance telemetry metrics. Renders the Diagnostics window. Shows FPS, frame time, CPU%, and input lag in a
Shows frame time, FPS, event queue throughput, and memory usage. summary table; when profiling is on, shows per-component moving-average timings,
optional sparkline graphs, and the diagnostic message log.
State Mutations: SSDL Shape:
Updates app.perf_profiling_enabled and visibility in app.show_windows["Diagnostics"]. `[I:perf_summary_table] -> [B:enable_profiling] => [I:component_timings_table] -> [I:graphs] -> [I:diag_log]`
SSDL Shape: ASCII Layout Map:
`[I] -> [B:perf_metrics] => [I:detailed_timings]` +---------------------------------------------------------+
""" | Performance Telemetry [ ] Enable Profiling |
| +----------------+---------+-------+ |
| | FPS | 120.0 | [ ] | |
| | Frame Time(ms) | 8.33 | [ ] | |
| | CPU % | 4.2 | [ ] | |
| +----------------+---------+-------+ |
| (when profiling enabled) |
| Detailed Component Timings |
| +--------------------+------+-----+------+------+----+ |
| | Component | Avg | Cnt | Max | Min | G | |
| +--------------------+------+-----+------+------+----+ |
| Diagnostic Log |
| +--------------------+------+---------------------+ |
| | 2026-06-12 22:00 | info | Cache rebuilt | |
| +--------------------+------+---------------------+ |
+---------------------------------------------------------+
"""
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_diagnostics_panel") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_diagnostics_panel")
with imscope.window("Diagnostics", app.show_windows.get("Diagnostics", False)) as (exp, opened): with imscope.window("Diagnostics", app.show_windows.get("Diagnostics", False)) as (exp, opened):
app.show_windows["Diagnostics"] = bool(opened) app.show_windows["Diagnostics"] = bool(opened)
@@ -1909,14 +1960,21 @@ def render_diagnostics_panel(app: App) -> None:
def render_cache_panel(app: App) -> None: def render_cache_panel(app: App) -> None:
""" """
Renders caching analytics and a clear cache utility for providers that support caching (Gemini). Renders Gemini cache analytics. Shows cache age, TTL remaining as a colour-coded
progress bar (green > 50%, yellow > 20%, red otherwise), and a [Clear Cache] button.
State Mutations: Skips rendering for non-Gemini providers.
app.controller (clears cached files)
app._cache_cleared_timestamp (updates trigger timestamp)
SSDL Shape: SSDL Shape:
`[I:cache_stats] -> [B:progress_bar] => [B:clear_cache]` `[I:cache_stats] -> [B:progress_bar] => [B:clear_cache]`
ASCII Layout Map:
+---------------------------------------------------------+
| Cache Analytics |
| Age: 4m 12s TTL: 55m 48s (93%) |
| [============================================= ] 93% |
| [Clear Cache] |
| Cache cleared - will rebuild on next request |
+---------------------------------------------------------+
""" """
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_cache_panel") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_cache_panel")
if app.current_provider != "gemini": if app.current_provider != "gemini":
@@ -1951,13 +2009,22 @@ def render_cache_panel(app: App) -> None:
def render_tool_analytics_panel(app: App) -> None: def render_tool_analytics_panel(app: App) -> None:
""" """
Renders a breakdown of tool execution telemetry, including calls, average latency, and failure rates. Renders a breakdown of tool execution telemetry: calls, average latency ms, and
failure rate percentage per tool. Results are sorted by invocation count descending.
State Mutations:
app._cached_tool_stats, app._tool_stats_cache_time (throttled caching of tool telemetry)
SSDL Shape: SSDL Shape:
`[I:tool_stats] -> [B:stats_table]` `[I:tool_stats] -> [B:stats_table]`
ASCII Layout Map:
+---------------------------------------------------------+
| Tool Usage |
| +------------------------+-------+----------+-------+ |
| | Tool | Count | Avg (ms) | Fail% | |
| +------------------------+-------+----------+-------+ |
| | py_get_definition | 42 | 35 | 0% | |
| | run_powershell | 18 | 820 | 5% | |
| +------------------------+-------+----------+-------+ |
+---------------------------------------------------------+
""" """
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_tool_analytics_panel") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_tool_analytics_panel")
imgui.text_colored(C_LBL(), 'Tool Usage') imgui.text_colored(C_LBL(), 'Tool Usage')
@@ -1998,13 +2065,30 @@ def render_tool_analytics_panel(app: App) -> None:
def render_token_budget_panel(app: App) -> None: def render_token_budget_panel(app: App) -> None:
""" """
Renders prompt token utilization breakdown, system/tools/history usage, and estimated pricing/costs. Renders prompt token utilization breakdown: session totals, cache read/creation stats,
a colour-coded utilisation progress bar, component breakdown table (System/Tools/History),
State Mutations: per-tier MMA cost table, trim warnings, and cache activity badge.
app._token_stats_dirty, app._token_stats (requests API metrics calculations via background worker)
SSDL Shape: SSDL Shape:
`[I:session_tokens] -> [B:utilization_bar] -> [B:breakdown_table] -> [B:tier_costs_table]` `[I:session_tokens] -> [B:utilization_bar] -> [B:breakdown_table] -> [B:tier_costs_table]`
ASCII Layout Map:
+---------------------------------------------------------+
| Prompt Utilization |
| Tokens: 24,200 (In: 18,000 Out: 6,200) Latency: 2.1s |
| Cache Read: 12,000 Creation: 2,000 |
| [============================== ] 63.2% |
| 24,200 / 38,000 tokens (13,800 remaining) |
| +-------------+--------+------+ |
| | System | 8,000 | 33% | |
| | Tools | 4,000 | 17% | |
| | History | 12,200 | 50% | |
| +-------------+--------+------+ |
| MMA Tier Costs |
| | Tier 1 | gemini | 14,000 | $0.0012 | |
| ⚠ WARNING: Next call will trim history |
| Cache Usage: ACTIVE | Age: 252s / 3600s |
+---------------------------------------------------------+
""" """
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_token_budget_panel") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_token_budget_panel")
imgui.text_colored(C_LBL(), 'Prompt Utilization') imgui.text_colored(C_LBL(), 'Prompt Utilization')
@@ -2123,14 +2207,25 @@ def render_token_budget_panel(app: App) -> None:
def render_log_management(app: App) -> None: def render_log_management(app: App) -> None:
""" """
Renders log management window, enabling browsing, starring/whitelisting, and loading of prior log sessions. Renders the Log Management window. Enables browsing, starring (whitelisting), and loading
of prior log sessions from the log registry. Provides one-click prune and refresh actions.
State Mutations:
app.show_windows["Log Management"]
app._log_registry (creates and loads session logs registry toml)
SSDL Shape: SSDL Shape:
`[I:sessions] -> [B:registry_actions] -> [B:sessions_table]` `[B:refresh | load | prune] -> [I:sessions_table] => [B:load | star/unstar per row]`
ASCII Layout Map:
+---------------------------------------------------------+
| Log Management [x] |
| [Refresh Registry] [Load Log] [Force Prune Logs] |
| +------------+------------------+-----+--------+------+ |
| | Session ID | Start Time | Star| Size KB| Msgs | |
| +------------+------------------+-----+--------+------+ |
| | 20260612_2 | 2026-06-12 22:00 | YES | 120 | 84 | |
| | | | | [Load] [Unstar] |
| | 20260611_1 | 2026-06-11 18:30 | NO | 340 | 210 | |
| | | | | [Load] [Star] |
| +------------+------------------+-----+--------+------+ |
+---------------------------------------------------------+
""" """
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_log_management") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_log_management")
with imscope.window("Log Management", app.show_windows["Log Management"]) as (exp, opened): with imscope.window("Log Management", app.show_windows["Log Management"]) as (exp, opened):
@@ -2213,13 +2308,18 @@ def render_log_management(app: App) -> None:
def render_project_settings_hub(app: App) -> None: def render_project_settings_hub(app: App) -> None:
""" """
Renders the Project Settings Hub containing tabs for project lists and paths. Renders the Project Settings Hub: a two-tab container for Projects and Paths configuration.
State Mutations:
None directly (delegated to sub-panels).
SSDL Shape: SSDL Shape:
`[I] -> [B:tabs] => [I:sub-panel]` `[I:tab_bar] => [I:projects_panel] | [I:paths_panel]`
ASCII Layout Map:
+---------------------------------------------------------+
| [Projects] [Paths] |
| +-----------------------------------------------------+ |
| | <active tab content> | |
| +-----------------------------------------------------+ |
+---------------------------------------------------------+
""" """
with imscope.tab_bar('context_hub_tabs'): with imscope.tab_bar('context_hub_tabs'):
with imscope.tab_item('Projects') as (exp, _): with imscope.tab_item('Projects') as (exp, _):
@@ -2230,20 +2330,27 @@ def render_project_settings_hub(app: App) -> None:
def render_projects_panel(app: App) -> None: def render_projects_panel(app: App) -> None:
""" """
Renders the project configuration panel. Allows setting execution mode, Renders the project configuration panel. Allows setting execution mode,
repository path, output directory, managing projects, and layout wrapping/scrolling behavior. repository path, output/conductor directories, managing projects list,
and global layout toggles (word-wrap, auto-scroll).
State Mutations:
app.ui_project_execution_mode
app.ui_project_git_dir
app.ui_output_dir
app.ui_project_conductor_dir
app.project_paths
app.ui_word_wrap
app.ui_auto_scroll_comms
app.ui_auto_scroll_tool_calls
SSDL Shape: SSDL Shape:
`[I:active_project] -> [B:execution_mode] -> [B:directories] -> [I:project_files] -> [B:project_actions] -> [B:toggles]` `[I:active_project] -> [B:execution_mode] -> [B:directories] -> [I:project_files] -> [B:project_actions] -> [B:toggles]`
ASCII Layout Map:
+---------------------------------------------------------+
| Active: my-feature-project |
| Execution Mode: [native v] |
| Git Directory: [C:\projects\manual_slop___] [Browse] |
| Output Dir: [C:\output____________________] [Browse] |
| Conductor Dir: [C:\projects\...\conductor___] [Browse] |
| Project Files |
| +-----------------------------------------------------+ |
| | [x] my-feature * (active) C:\proj\... | |
| | [x] chore-cleanup C:\proj\... | |
| +-----------------------------------------------------+ |
| [Add Project] [New Project] [Save All] |
| [ ] Word-Wrap [ ] Auto-scroll Comms [ ] Auto-scroll |
+---------------------------------------------------------+
""" """
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_projects_panel") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_projects_panel")
proj_name = app.project.get("project", {}).get("name", Path(app.active_project_path).stem) proj_name = app.project.get("project", {}).get("name", Path(app.active_project_path).stem)
@@ -2331,14 +2438,21 @@ def render_projects_panel(app: App) -> None:
def render_paths_panel(app: App) -> None: def render_paths_panel(app: App) -> None:
""" """
Renders the System Path Configuration panel, allowing editing of logs Renders the System Path Configuration panel. Shows source-tagged logs and scripts
and scripts directories. Updates the directories on user input. directory fields, each with a Browse button, and Apply / Reset buttons.
State Mutations:
app.ui_logs_dir, app.ui_scripts_dir (via input text or file dialog select)
SSDL Shape: SSDL Shape:
`[I] -> [B:inputs] => [B:apply_reset]` `[I:path_fields] => [B:apply_reset]`
ASCII Layout Map:
+---------------------------------------------------------+
| System Path Configuration |
| Logs Directory (Source: env) |
| [C:\projects\manual_slop\logs___________] [Browse] |
| Scripts Directory (Source: default) |
| [C:\projects\manual_slop\scripts________] [Browse] |
| [Apply] [Reset] |
+---------------------------------------------------------+
""" """
if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_paths_panel") if app.perf_profiling_enabled: app.perf_monitor.start_component("_render_paths_panel")
path_info = paths.get_full_path_info() path_info = paths.get_full_path_info()
@@ -2383,13 +2497,22 @@ def render_paths_panel(app: App) -> None:
def render_ai_settings_hub(app: App) -> None: def render_ai_settings_hub(app: App) -> None:
""" """
Groups and renders all AI-related configuration panels in a unified hub sidebar. Groups and renders all AI-related configuration panels in a unified hub sidebar.
Includes persona selection, LLM provider settings, system prompts, RAG switches, and tools. Includes persona selection, LLM provider settings, system prompts, RAG config, and tools.
State Mutations:
None directly (delegated to child panels).
SSDL Shape: SSDL Shape:
`[I] -> [B:headers] => [I:sub-panels]` `[I:persona_selector] -> [B:provider_header] -> [B:system_prompts_header] -> [B:rag_header] -> [I:agent_tools]`
ASCII Layout Map:
+---------------------------------------------------------+
| [Persona Selector sub-panel] |
| > Provider & Model (collapsible) |
| [Provider sub-panel content] |
| > System Prompts (collapsible) |
| [System Prompts sub-panel content] |
| > RAG Settings (collapsible) |
| [RAG sub-panel content] |
| [Agent Tools sub-panel] |
+---------------------------------------------------------+
""" """
render_persona_selector_panel(app) render_persona_selector_panel(app)
if imgui.collapsing_header("Provider & Model"): render_provider_panel(app) if imgui.collapsing_header("Provider & Model"): render_provider_panel(app)
@@ -2399,14 +2522,22 @@ def render_ai_settings_hub(app: App) -> None:
def render_rag_panel(app: App) -> None: def render_rag_panel(app: App) -> None:
""" """
Renders RAG configuration panel, exposing switches, provider selection, chunking parameters, Renders RAG configuration panel. Exposes enable toggle, vector-store and embedding
and index rebuild triggers. provider selectors, chunk size/overlap inputs, RAG status label, and a Rebuild Index button.
State Mutations:
app.controller.rag_config (provider, embedding, chunk size, overlap)
SSDL Shape: SSDL Shape:
`[I:config] -> [B:rag_switch] -> [B:combo_selectors] -> [B:chunking_inputs] => [B:rebuild_index]` `[B:rag_switch] -> [B:combo_selectors] -> [B:chunking_inputs] => [B:rebuild_index]`
ASCII Layout Map:
+---------------------------------------------------------+
| [x] Enable RAG |
| Vector Store Provider: [chroma v] |
| Embedding Provider: [gemini v] |
| Chunk Size: [512] |
| Chunk Overlap: [64] |
| Status: indexing... |
| [Rebuild Index] |
+---------------------------------------------------------+
""" """
conf = app.controller.rag_config conf = app.controller.rag_config
if not conf: return if not conf: return
@@ -2446,17 +2577,30 @@ def render_rag_panel(app: App) -> None:
def render_system_prompts_panel(app: App) -> None: def render_system_prompts_panel(app: App) -> None:
""" """
Renders the System Prompts panel, exposing global and project-specific prompt selection, Renders the System Prompts panel. Exposes global preset selector + multiline edit,
editing boxes, base prompt defaults, and diff comparisons. base prompt toggle (default vs custom) with diff + reset, and project-level preset
selector + multiline edit.
State Mutations:
app.controller.ui_global_preset_name, app.controller.ui_project_preset_name
app.ui_global_system_prompt, app.ui_project_system_prompt
app.ui_base_system_prompt, app.ui_use_default_base_prompt
app.show_preset_manager_window (to open modal)
SSDL Shape: SSDL Shape:
`[I:presets] -> [B:global_preset] -> [B:base_preset_customizer] -> [B:project_preset]` `[B:global_preset_combo] -> [I:global_text] -> [B:base_prompt_header] -> [I:base_text] -> [B:project_preset_combo] -> [I:project_text]`
ASCII Layout Map:
+---------------------------------------------------------+
| Global System Prompt (all projects) |
| [coding-assistant v] [Manage Presets] |
| +-----------------------------------------------------+ |
| | You are a coding assistant... | |
| +-----------------------------------------------------+ |
| [x] Use Default Base System Prompt |
| [Reset to Default] [Show Diff] (?) |
| > Base System Prompt (foundational instructions) |
| [read-only or editable text area] |
| Project System Prompt |
| [feature-mode v] [Manage Presets] |
| +-----------------------------------------------------+ |
| | Focus on the rendering pipeline refactor... | |
| +-----------------------------------------------------+ |
+---------------------------------------------------------+
""" """
imgui.text("Global System Prompt (all projects)") imgui.text("Global System Prompt (all projects)")
preset_names = sorted(app.controller.presets.keys()) preset_names = sorted(app.controller.presets.keys())
@@ -2511,16 +2655,20 @@ def render_system_prompts_panel(app: App) -> None:
def render_agent_tools_panel(app: App) -> None: def render_agent_tools_panel(app: App) -> None:
""" """
Renders active tool presets and configuration options. Renders the Active Tool Presets & Biases collapsible section. Shows a preset combo,
Allows selecting tool presets, toggling individual capability flags, and showing bias managers. a Manage Presets button, and a Bias Profile combo. Displays a disabled notice when
tool calling is unsupported by the active provider/model.
State Mutations:
Modifies app.ui_active_tool_preset and local UI flags.
SSDL Shape: SSDL Shape:
`[Q:caps] -> [B:tool_calling] => [S:preset]` `[B:collapsing_header] => [B:preset_combo] -> [B:manage_presets] -> [B:bias_combo]`
ASCII Layout Map:
+---------------------------------------------------------+
| > Active Tool Presets & Biases (open by default) |
| Tool Preset: [mcp-only v] [Manage Presets] |
| Bias Profile: [None v] |
+---------------------------------------------------------+
""" """
caps = app._get_active_capabilities()
if not caps.tool_calling: if not caps.tool_calling:
if imgui.collapsing_header("Active Tool Presets & Biases", imgui.TreeNodeFlags_.default_open): if imgui.collapsing_header("Active Tool Presets & Biases", imgui.TreeNodeFlags_.default_open):
imgui.text_disabled(f"(tools not supported by {app.current_provider}/{app.current_model})") imgui.text_disabled(f"(tools not supported by {app.current_provider}/{app.current_model})")