claude-mpm 5.1.9__py3-none-any.whl → 5.4.14__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of claude-mpm might be problematic. Click here for more details.

Files changed (162) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/__init__.py +4 -0
  3. claude_mpm/agents/PM_INSTRUCTIONS.md +85 -0
  4. claude_mpm/agents/agent_loader.py +13 -44
  5. claude_mpm/agents/templates/circuit-breakers.md +138 -1
  6. claude_mpm/cli/__main__.py +4 -0
  7. claude_mpm/cli/commands/agent_state_manager.py +8 -17
  8. claude_mpm/cli/commands/auto_configure.py +210 -25
  9. claude_mpm/cli/commands/config.py +88 -2
  10. claude_mpm/cli/commands/configure.py +1097 -158
  11. claude_mpm/cli/commands/configure_agent_display.py +15 -6
  12. claude_mpm/cli/commands/mpm_init/core.py +160 -46
  13. claude_mpm/cli/commands/mpm_init/knowledge_extractor.py +481 -0
  14. claude_mpm/cli/commands/mpm_init/prompts.py +280 -0
  15. claude_mpm/cli/commands/skills.py +21 -2
  16. claude_mpm/cli/commands/summarize.py +413 -0
  17. claude_mpm/cli/executor.py +11 -3
  18. claude_mpm/cli/parsers/base_parser.py +5 -0
  19. claude_mpm/cli/parsers/config_parser.py +153 -83
  20. claude_mpm/cli/parsers/skills_parser.py +3 -2
  21. claude_mpm/cli/startup.py +333 -89
  22. claude_mpm/commands/mpm-config.md +266 -0
  23. claude_mpm/commands/{mpm-ticket-organize.md → mpm-organize.md} +4 -5
  24. claude_mpm/config/agent_sources.py +27 -0
  25. claude_mpm/core/framework/formatters/content_formatter.py +3 -13
  26. claude_mpm/core/framework/loaders/agent_loader.py +8 -5
  27. claude_mpm/core/framework_loader.py +4 -2
  28. claude_mpm/core/logger.py +13 -0
  29. claude_mpm/core/socketio_pool.py +3 -3
  30. claude_mpm/core/unified_agent_registry.py +5 -15
  31. claude_mpm/hooks/claude_hooks/correlation_manager.py +60 -0
  32. claude_mpm/hooks/claude_hooks/event_handlers.py +206 -78
  33. claude_mpm/hooks/claude_hooks/hook_handler.py +6 -0
  34. claude_mpm/hooks/claude_hooks/installer.py +33 -10
  35. claude_mpm/hooks/claude_hooks/memory_integration.py +26 -9
  36. claude_mpm/hooks/claude_hooks/response_tracking.py +2 -3
  37. claude_mpm/hooks/claude_hooks/services/connection_manager.py +4 -0
  38. claude_mpm/hooks/memory_integration_hook.py +46 -1
  39. claude_mpm/init.py +0 -19
  40. claude_mpm/scripts/claude-hook-handler.sh +58 -18
  41. claude_mpm/scripts/launch_monitor.py +93 -13
  42. claude_mpm/services/agents/agent_recommendation_service.py +278 -0
  43. claude_mpm/services/agents/agent_review_service.py +280 -0
  44. claude_mpm/services/agents/deployment/agent_discovery_service.py +2 -3
  45. claude_mpm/services/agents/deployment/agent_template_builder.py +4 -2
  46. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +78 -9
  47. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +335 -53
  48. claude_mpm/services/agents/git_source_manager.py +34 -0
  49. claude_mpm/services/agents/loading/base_agent_manager.py +1 -13
  50. claude_mpm/services/agents/sources/git_source_sync_service.py +8 -1
  51. claude_mpm/services/agents/toolchain_detector.py +10 -6
  52. claude_mpm/services/analysis/__init__.py +11 -1
  53. claude_mpm/services/analysis/clone_detector.py +1030 -0
  54. claude_mpm/services/command_deployment_service.py +71 -10
  55. claude_mpm/services/event_bus/config.py +3 -1
  56. claude_mpm/services/git/git_operations_service.py +93 -8
  57. claude_mpm/services/monitor/daemon.py +9 -2
  58. claude_mpm/services/monitor/daemon_manager.py +39 -3
  59. claude_mpm/services/monitor/server.py +225 -19
  60. claude_mpm/services/self_upgrade_service.py +120 -12
  61. claude_mpm/services/skills/__init__.py +3 -0
  62. claude_mpm/services/skills/git_skill_source_manager.py +32 -2
  63. claude_mpm/services/skills/selective_skill_deployer.py +230 -0
  64. claude_mpm/services/skills/skill_to_agent_mapper.py +406 -0
  65. claude_mpm/services/skills_deployer.py +64 -3
  66. claude_mpm/services/socketio/event_normalizer.py +15 -1
  67. claude_mpm/services/socketio/server/core.py +160 -21
  68. claude_mpm/services/version_control/git_operations.py +103 -0
  69. claude_mpm/utils/agent_filters.py +17 -44
  70. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.14.dist-info}/METADATA +47 -84
  71. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.14.dist-info}/RECORD +76 -150
  72. claude_mpm-5.4.14.dist-info/entry_points.txt +5 -0
  73. claude_mpm-5.4.14.dist-info/licenses/LICENSE +94 -0
  74. claude_mpm-5.4.14.dist-info/licenses/LICENSE-FAQ.md +153 -0
  75. claude_mpm/agents/BASE_AGENT_TEMPLATE.md +0 -292
  76. claude_mpm/agents/BASE_DOCUMENTATION.md +0 -53
  77. claude_mpm/agents/BASE_ENGINEER.md +0 -658
  78. claude_mpm/agents/BASE_OPS.md +0 -219
  79. claude_mpm/agents/BASE_PM.md +0 -480
  80. claude_mpm/agents/BASE_PROMPT_ENGINEER.md +0 -787
  81. claude_mpm/agents/BASE_QA.md +0 -167
  82. claude_mpm/agents/BASE_RESEARCH.md +0 -53
  83. claude_mpm/agents/base_agent.json +0 -31
  84. claude_mpm/agents/base_agent_loader.py +0 -601
  85. claude_mpm/cli/ticket_cli.py +0 -35
  86. claude_mpm/commands/mpm-config-view.md +0 -150
  87. claude_mpm/dashboard/analysis_runner.py +0 -455
  88. claude_mpm/dashboard/index.html +0 -13
  89. claude_mpm/dashboard/open_dashboard.py +0 -66
  90. claude_mpm/dashboard/static/css/activity.css +0 -1958
  91. claude_mpm/dashboard/static/css/connection-status.css +0 -370
  92. claude_mpm/dashboard/static/css/dashboard.css +0 -4701
  93. claude_mpm/dashboard/static/js/components/activity-tree.js +0 -1871
  94. claude_mpm/dashboard/static/js/components/agent-hierarchy.js +0 -777
  95. claude_mpm/dashboard/static/js/components/agent-inference.js +0 -956
  96. claude_mpm/dashboard/static/js/components/build-tracker.js +0 -333
  97. claude_mpm/dashboard/static/js/components/code-simple.js +0 -857
  98. claude_mpm/dashboard/static/js/components/connection-debug.js +0 -654
  99. claude_mpm/dashboard/static/js/components/diff-viewer.js +0 -891
  100. claude_mpm/dashboard/static/js/components/event-processor.js +0 -542
  101. claude_mpm/dashboard/static/js/components/event-viewer.js +0 -1155
  102. claude_mpm/dashboard/static/js/components/export-manager.js +0 -368
  103. claude_mpm/dashboard/static/js/components/file-change-tracker.js +0 -443
  104. claude_mpm/dashboard/static/js/components/file-change-viewer.js +0 -690
  105. claude_mpm/dashboard/static/js/components/file-tool-tracker.js +0 -724
  106. claude_mpm/dashboard/static/js/components/file-viewer.js +0 -580
  107. claude_mpm/dashboard/static/js/components/hud-library-loader.js +0 -211
  108. claude_mpm/dashboard/static/js/components/hud-manager.js +0 -671
  109. claude_mpm/dashboard/static/js/components/hud-visualizer.js +0 -1718
  110. claude_mpm/dashboard/static/js/components/module-viewer.js +0 -2764
  111. claude_mpm/dashboard/static/js/components/session-manager.js +0 -579
  112. claude_mpm/dashboard/static/js/components/socket-manager.js +0 -368
  113. claude_mpm/dashboard/static/js/components/ui-state-manager.js +0 -749
  114. claude_mpm/dashboard/static/js/components/unified-data-viewer.js +0 -1824
  115. claude_mpm/dashboard/static/js/components/working-directory.js +0 -920
  116. claude_mpm/dashboard/static/js/connection-manager.js +0 -536
  117. claude_mpm/dashboard/static/js/dashboard.js +0 -1914
  118. claude_mpm/dashboard/static/js/extension-error-handler.js +0 -164
  119. claude_mpm/dashboard/static/js/socket-client.js +0 -1474
  120. claude_mpm/dashboard/static/js/tab-isolation-fix.js +0 -185
  121. claude_mpm/dashboard/static/socket.io.min.js +0 -7
  122. claude_mpm/dashboard/static/socket.io.v4.8.1.backup.js +0 -7
  123. claude_mpm/dashboard/templates/code_simple.html +0 -153
  124. claude_mpm/dashboard/templates/index.html +0 -606
  125. claude_mpm/dashboard/test_dashboard.html +0 -372
  126. claude_mpm/scripts/mcp_server.py +0 -75
  127. claude_mpm/scripts/mcp_wrapper.py +0 -39
  128. claude_mpm/services/mcp_gateway/__init__.py +0 -159
  129. claude_mpm/services/mcp_gateway/auto_configure.py +0 -369
  130. claude_mpm/services/mcp_gateway/config/__init__.py +0 -17
  131. claude_mpm/services/mcp_gateway/config/config_loader.py +0 -296
  132. claude_mpm/services/mcp_gateway/config/config_schema.py +0 -243
  133. claude_mpm/services/mcp_gateway/config/configuration.py +0 -429
  134. claude_mpm/services/mcp_gateway/core/__init__.py +0 -43
  135. claude_mpm/services/mcp_gateway/core/base.py +0 -312
  136. claude_mpm/services/mcp_gateway/core/exceptions.py +0 -253
  137. claude_mpm/services/mcp_gateway/core/interfaces.py +0 -443
  138. claude_mpm/services/mcp_gateway/core/process_pool.py +0 -977
  139. claude_mpm/services/mcp_gateway/core/singleton_manager.py +0 -315
  140. claude_mpm/services/mcp_gateway/core/startup_verification.py +0 -316
  141. claude_mpm/services/mcp_gateway/main.py +0 -589
  142. claude_mpm/services/mcp_gateway/registry/__init__.py +0 -12
  143. claude_mpm/services/mcp_gateway/registry/service_registry.py +0 -412
  144. claude_mpm/services/mcp_gateway/registry/tool_registry.py +0 -489
  145. claude_mpm/services/mcp_gateway/server/__init__.py +0 -15
  146. claude_mpm/services/mcp_gateway/server/mcp_gateway.py +0 -414
  147. claude_mpm/services/mcp_gateway/server/stdio_handler.py +0 -372
  148. claude_mpm/services/mcp_gateway/server/stdio_server.py +0 -712
  149. claude_mpm/services/mcp_gateway/tools/__init__.py +0 -36
  150. claude_mpm/services/mcp_gateway/tools/base_adapter.py +0 -485
  151. claude_mpm/services/mcp_gateway/tools/document_summarizer.py +0 -789
  152. claude_mpm/services/mcp_gateway/tools/external_mcp_services.py +0 -654
  153. claude_mpm/services/mcp_gateway/tools/health_check_tool.py +0 -456
  154. claude_mpm/services/mcp_gateway/tools/hello_world.py +0 -551
  155. claude_mpm/services/mcp_gateway/tools/kuzu_memory_service.py +0 -555
  156. claude_mpm/services/mcp_gateway/utils/__init__.py +0 -14
  157. claude_mpm/services/mcp_gateway/utils/package_version_checker.py +0 -160
  158. claude_mpm/services/mcp_gateway/utils/update_preferences.py +0 -170
  159. claude_mpm-5.1.9.dist-info/entry_points.txt +0 -10
  160. claude_mpm-5.1.9.dist-info/licenses/LICENSE +0 -21
  161. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.14.dist-info}/WHEEL +0 -0
  162. {claude_mpm-5.1.9.dist-info → claude_mpm-5.4.14.dist-info}/top_level.txt +0 -0
@@ -1,749 +0,0 @@
1
- /**
2
- * UI State Manager Module
3
- *
4
- * Manages UI state including tab switching, card selection, keyboard navigation,
5
- * and visual feedback across the dashboard interface.
6
- *
7
- * WHY: Extracted from main dashboard to centralize UI state management and
8
- * provide better separation between business logic and UI state. This makes
9
- * the UI behavior more predictable and easier to test.
10
- *
11
- * DESIGN DECISION: Maintains centralized state for current tab, selected cards,
12
- * and navigation context while providing a clean API for other modules to
13
- * interact with UI state changes.
14
- */
15
- class UIStateManager {
16
- constructor() {
17
- // Switching lock to prevent race conditions
18
- this._switching = false;
19
-
20
- // Hash to tab mapping
21
- this.hashToTab = {
22
- '#events': 'events',
23
- '#agents': 'agents',
24
- '#tools': 'tools',
25
- '#files': 'files',
26
- '#activity': 'activity',
27
- '#file_tree': 'claude-tree',
28
- '': 'events', // default
29
- };
30
-
31
- // Tab to hash mapping (reverse lookup)
32
- this.tabToHash = {
33
- 'events': '#events',
34
- 'agents': '#agents',
35
- 'tools': '#tools',
36
- 'files': '#files',
37
- 'activity': '#activity',
38
- 'claude-tree': '#file_tree'
39
- };
40
-
41
- // Current active tab - will be set based on URL hash
42
- this.currentTab = this.getTabFromHash();
43
-
44
- // Auto-scroll behavior
45
- this.autoScroll = true;
46
-
47
- // Selection state - tracks the currently selected card across all tabs
48
- this.selectedCard = {
49
- tab: null, // which tab the selection is in
50
- index: null, // index of selected item in that tab
51
- type: null, // 'event', 'agent', 'tool', 'file'
52
- data: null // the actual data object
53
- };
54
-
55
- // Navigation state for each tab
56
- this.tabNavigation = {
57
- events: { selectedIndex: -1, items: [] },
58
- agents: { selectedIndex: -1, items: [] },
59
- tools: { selectedIndex: -1, items: [] },
60
- files: { selectedIndex: -1, items: [] }
61
- };
62
-
63
- this.setupEventHandlers();
64
- console.log('UI state manager initialized with hash navigation');
65
-
66
- // Initialize with current hash
67
- this.handleHashChange();
68
- }
69
-
70
- /**
71
- * Get tab name from current URL hash
72
- * @returns {string} - Tab name based on hash
73
- */
74
- getTabFromHash() {
75
- const hash = window.location.hash || '';
76
- return this.hashToTab[hash] || 'events';
77
- }
78
-
79
- /**
80
- * Set up event handlers for UI interactions
81
- */
82
- setupEventHandlers() {
83
- this.setupHashNavigation();
84
- this.setupTabClickHandlers(); // Add explicit tab click handlers
85
- this.setupUnifiedKeyboardNavigation();
86
- }
87
-
88
- /**
89
- * Set up hash-based navigation
90
- */
91
- setupHashNavigation() {
92
- // Handle hash changes
93
- window.addEventListener('hashchange', (e) => {
94
- console.log('[Hash Navigation] Hash changed from', new URL(e.oldURL).hash, 'to', window.location.hash);
95
- this.handleHashChange();
96
- });
97
-
98
- // Handle initial page load
99
- document.addEventListener('DOMContentLoaded', () => {
100
- console.log('[Hash Navigation] Initial hash:', window.location.hash);
101
- this.handleHashChange();
102
- });
103
- }
104
-
105
- /**
106
- * Handle hash change events
107
- */
108
- handleHashChange() {
109
- const hash = window.location.hash || '';
110
- console.log('[Hash Navigation] DETAILED DEBUG:');
111
- console.log('[Hash Navigation] - Current hash:', hash);
112
- console.log('[Hash Navigation] - hashToTab mapping:', this.hashToTab);
113
- console.log('[Hash Navigation] - Direct lookup result:', this.hashToTab[hash]);
114
- console.log('[Hash Navigation] - Is hash in mapping?', hash in this.hashToTab);
115
- console.log('[Hash Navigation] - Hash length:', hash.length);
116
- console.log('[Hash Navigation] - Hash char codes:', hash.split('').map(c => c.charCodeAt(0)));
117
-
118
- const tabName = this.hashToTab[hash] || 'events';
119
- console.log('[Hash Navigation] Final resolved tab name:', tabName);
120
-
121
- // Special logging for File Tree tab
122
- if (tabName === 'claude-tree' || hash === '#file_tree') {
123
- console.log('[UIStateManager] FILE TREE TAB SELECTED via hash:', hash);
124
- console.log('[UIStateManager] Tab name resolved to:', tabName);
125
- }
126
-
127
- this.switchTab(tabName, false); // false = don't update hash (we're responding to hash change)
128
- }
129
-
130
- /**
131
- * DEPRECATED: Tab navigation is now handled by hash navigation
132
- * This method is kept for backward compatibility but does nothing
133
- */
134
- setupTabNavigation() {
135
- console.log('[Hash Navigation] setupTabNavigation is deprecated - using hash navigation instead');
136
- }
137
-
138
- /**
139
- * Set up explicit click handlers for tab buttons to ensure proper routing
140
- * This ensures tab clicks work even if other modules interfere
141
- */
142
- setupTabClickHandlers() {
143
- document.querySelectorAll('.tab-button').forEach(button => {
144
- button.addEventListener('click', (e) => {
145
- console.log('[UIStateManager] Tab button clicked:', e.target);
146
-
147
- // Prevent default only if we're going to handle it
148
- const tabName = this.getTabNameFromButton(e.target);
149
- console.log('[UIStateManager] Resolved tab name:', tabName);
150
-
151
- if (tabName) {
152
- // Let the href attribute update the hash naturally, which will trigger our hashchange handler
153
- // But also explicitly trigger the switch in case href doesn't work
154
- setTimeout(() => {
155
- const expectedHash = this.tabToHash[tabName];
156
- if (window.location.hash !== expectedHash && expectedHash) {
157
- console.log('[UIStateManager] Hash not updated, forcing update:', expectedHash);
158
- window.location.hash = expectedHash;
159
- }
160
- }, 10);
161
- }
162
- });
163
- });
164
-
165
- console.log('[UIStateManager] Tab click handlers set up for', document.querySelectorAll('.tab-button').length, 'buttons');
166
- }
167
-
168
- /**
169
- * Set up unified keyboard navigation across all tabs
170
- */
171
- setupUnifiedKeyboardNavigation() {
172
- document.addEventListener('keydown', (e) => {
173
- // Only handle if not in an input field
174
- if (document.activeElement &&
175
- ['INPUT', 'TEXTAREA', 'SELECT'].includes(document.activeElement.tagName)) {
176
- return;
177
- }
178
-
179
- if (e.key === 'ArrowUp' || e.key === 'ArrowDown') {
180
- e.preventDefault();
181
- this.handleUnifiedArrowNavigation(e.key === 'ArrowDown' ? 1 : -1);
182
- } else if (e.key === 'Enter') {
183
- e.preventDefault();
184
- this.handleUnifiedEnterKey();
185
- } else if (e.key === 'Escape') {
186
- this.clearUnifiedSelection();
187
- }
188
- });
189
- }
190
-
191
- /**
192
- * Get tab name from button element
193
- * @param {HTMLElement} button - Tab button element
194
- * @returns {string} - Tab name
195
- */
196
- getTabNameFromButton(button) {
197
- console.log('[getTabNameFromButton] DEBUG: button object:', button);
198
- console.log('[getTabNameFromButton] DEBUG: button.nodeType:', button.nodeType);
199
- console.log('[getTabNameFromButton] DEBUG: button.tagName:', button.tagName);
200
-
201
- // CRITICAL FIX: Make sure we're dealing with the actual button element
202
- // Sometimes the click target might be a child element (like the emoji icon)
203
- let targetButton = button;
204
- if (button && button.closest && button.closest('.tab-button')) {
205
- targetButton = button.closest('.tab-button');
206
- console.log('[getTabNameFromButton] DEBUG: Used closest() to find actual button');
207
- }
208
-
209
- // First check for data-tab attribute
210
- const dataTab = targetButton ? targetButton.getAttribute('data-tab') : null;
211
- console.log('[getTabNameFromButton] DEBUG: data-tab attribute:', dataTab);
212
- console.log('[getTabNameFromButton] DEBUG: dataTab truthy:', !!dataTab);
213
-
214
- // CRITICAL: Specifically handle the File Tree case
215
- if (dataTab === 'claude-tree') {
216
- console.log('[getTabNameFromButton] DEBUG: Found claude-tree data-tab, returning it');
217
- return 'claude-tree';
218
- }
219
-
220
- if (dataTab) {
221
- console.log('[getTabNameFromButton] DEBUG: Returning dataTab:', dataTab);
222
- return dataTab;
223
- }
224
-
225
- // Fallback to text content matching
226
- const text = targetButton ? targetButton.textContent.toLowerCase() : '';
227
- console.log('[getTabNameFromButton] DEBUG: text content:', text);
228
- console.log('[getTabNameFromButton] DEBUG: text includes file tree:', text.includes('file tree'));
229
- console.log('[getTabNameFromButton] DEBUG: text includes events:', text.includes('events'));
230
-
231
- // CRITICAL: Check File Tree FIRST since it's the problematic one
232
- if (text.includes('file tree') || text.includes('📝')) {
233
- console.log('[getTabNameFromButton] DEBUG: Matched file tree, returning claude-tree');
234
- return 'claude-tree';
235
- }
236
- if (text.includes('activity') || text.includes('🌳')) return 'activity';
237
- if (text.includes('agents') || text.includes('🤖')) return 'agents';
238
- if (text.includes('tools') || text.includes('🔧')) return 'tools';
239
- if (text.includes('files') || text.includes('📁')) return 'files';
240
- if (text.includes('code')) return 'code';
241
- if (text.includes('sessions')) return 'sessions';
242
- if (text.includes('system')) return 'system';
243
- if (text.includes('events') || text.includes('📊')) return 'events';
244
-
245
- console.log('[getTabNameFromButton] DEBUG: No match, falling back to events');
246
- return 'events';
247
- }
248
-
249
- /**
250
- * Switch to specified tab - BULLETPROOF VERSION
251
- * @param {string} tabName - Name of tab to switch to
252
- * @param {boolean} updateHash - Whether to update URL hash (default: true)
253
- */
254
- switchTab(tabName, updateHash = true) {
255
- // CRITICAL: Prevent race conditions by using a switching lock
256
- if (this._switching) {
257
- console.log(`[UIStateManager] Tab switch already in progress, queuing: ${tabName}`);
258
- setTimeout(() => this.switchTab(tabName, updateHash), 50);
259
- return;
260
- }
261
- this._switching = true;
262
-
263
- console.log(`[UIStateManager] BULLETPROOF switchTab: ${tabName}, updateHash: ${updateHash}`);
264
-
265
- try {
266
- // Extra logging for File Tree debugging
267
- if (tabName === 'claude-tree') {
268
- console.log('[UIStateManager] SWITCHING TO FILE TREE TAB');
269
- console.log('[UIStateManager] Current tab before switch:', this.currentTab);
270
- }
271
-
272
- // Update URL hash if requested (when triggered by user action, not hash change)
273
- if (updateHash && this.tabToHash[tabName]) {
274
- const newHash = this.tabToHash[tabName];
275
- if (window.location.hash !== newHash) {
276
- console.log(`[UIStateManager] Updating hash to: ${newHash}`);
277
- this._switching = false; // Release lock before hash change
278
- window.location.hash = newHash;
279
- return; // The hashchange event will trigger switchTab again
280
- }
281
- }
282
-
283
- const previousTab = this.currentTab;
284
- this.currentTab = tabName;
285
-
286
- // STEP 1: NUCLEAR RESET - Remove ALL active states unconditionally
287
- this._removeAllActiveStates();
288
-
289
- // STEP 2: Set the ONE correct tab as active
290
- this._setActiveTab(tabName);
291
-
292
- // STEP 3: Show ONLY the correct content
293
- this._showTabContent(tabName);
294
-
295
- // STEP 4: Cleanup and validation
296
- this._validateTabState(tabName);
297
-
298
- // Clear previous selections when switching tabs
299
- this.clearUnifiedSelection();
300
-
301
- // Trigger tab change event for other modules
302
- document.dispatchEvent(new CustomEvent('tabChanged', {
303
- detail: {
304
- newTab: tabName,
305
- previousTab: previousTab
306
- }
307
- }));
308
-
309
- // Auto-scroll to bottom after a brief delay to ensure content is rendered
310
- setTimeout(() => {
311
- if (this.autoScroll) {
312
- this.scrollCurrentTabToBottom();
313
- }
314
-
315
- // Special handling for File Tree tab - trigger the tree render
316
- // But DON'T let it manipulate tabs itself
317
- if (tabName === 'claude-tree' && window.CodeViewer) {
318
- // Call a new method that only renders content, not tab switching
319
- if (window.CodeViewer.renderContent) {
320
- window.CodeViewer.renderContent();
321
- } else {
322
- // Fallback to show() but it should be fixed to not switch tabs
323
- window.CodeViewer.show();
324
- }
325
- }
326
- }, 100);
327
-
328
- } finally {
329
- // ALWAYS release the lock
330
- setTimeout(() => {
331
- this._switching = false;
332
- }, 200);
333
- }
334
- }
335
-
336
- /**
337
- * NUCLEAR RESET: Remove ALL active states from ALL elements
338
- * This ensures no stale states remain
339
- */
340
- _removeAllActiveStates() {
341
- // Remove active class from ALL tab buttons
342
- document.querySelectorAll('.tab-button').forEach(btn => {
343
- btn.classList.remove('active');
344
- // Also remove any inline styling that might interfere
345
- btn.style.removeProperty('border-bottom');
346
- btn.style.removeProperty('color');
347
- });
348
-
349
- // Remove active class from ALL tab content
350
- document.querySelectorAll('.tab-content').forEach(content => {
351
- content.classList.remove('active');
352
- // Clear any inline display styles
353
- content.style.removeProperty('display');
354
-
355
- // CRITICAL: Clean leaked content in non-events tabs
356
- if (content.id !== 'events-tab') {
357
- this._cleanLeakedEventContent(content);
358
- }
359
- });
360
-
361
- console.log('[UIStateManager] NUCLEAR: All active states removed');
362
- }
363
-
364
- /**
365
- * Set ONLY the specified tab as active
366
- */
367
- _setActiveTab(tabName) {
368
- const targetTab = document.querySelector(`[data-tab="${tabName}"]`);
369
- if (targetTab) {
370
- targetTab.classList.add('active');
371
- console.log(`[UIStateManager] Set active: ${tabName}`);
372
- } else {
373
- console.error(`[UIStateManager] Could not find tab button for: ${tabName}`);
374
- }
375
- }
376
-
377
- /**
378
- * Show ONLY the specified tab content
379
- */
380
- _showTabContent(tabName) {
381
- const targetContent = document.getElementById(`${tabName}-tab`);
382
- if (targetContent) {
383
- targetContent.classList.add('active');
384
- console.log(`[UIStateManager] Showing content: ${tabName}-tab`);
385
-
386
- // Special handling for File Tree tab
387
- if (tabName === 'claude-tree') {
388
- this._prepareFileTreeContent(targetContent);
389
- }
390
- } else {
391
- console.error(`[UIStateManager] Could not find content for: ${tabName}`);
392
- }
393
- }
394
-
395
- /**
396
- * Clean any leaked event content from non-event tabs
397
- */
398
- _cleanLeakedEventContent(contentElement) {
399
- // Remove any event items that may have leaked
400
- const leakedEventItems = contentElement.querySelectorAll('.event-item');
401
- if (leakedEventItems.length > 0) {
402
- console.warn(`[UIStateManager] Found ${leakedEventItems.length} leaked event items in ${contentElement.id}, removing...`);
403
- leakedEventItems.forEach(item => item.remove());
404
- }
405
-
406
- // Remove any events-list elements
407
- const leakedEventsList = contentElement.querySelectorAll('#events-list, .events-list');
408
- if (leakedEventsList.length > 0) {
409
- console.warn(`[UIStateManager] Found leaked events-list in ${contentElement.id}, removing...`);
410
- leakedEventsList.forEach(list => list.remove());
411
- }
412
- }
413
-
414
- /**
415
- * Prepare File Tree content area
416
- */
417
- _prepareFileTreeContent(fileTreeContent) {
418
- const claudeTreeContainer = document.getElementById('claude-tree-container');
419
- if (claudeTreeContainer) {
420
- // Final cleanup check
421
- this._cleanLeakedEventContent(claudeTreeContainer);
422
-
423
- // Ensure container is properly marked for CodeViewer
424
- claudeTreeContainer.setAttribute('data-owner', 'code-viewer');
425
- claudeTreeContainer.setAttribute('data-component', 'CodeViewer');
426
-
427
- console.log('[UIStateManager] File Tree container prepared');
428
- }
429
- }
430
-
431
- /**
432
- * Validate that tab state is correct after switching
433
- */
434
- _validateTabState(expectedTab) {
435
- setTimeout(() => {
436
- const activeTabs = document.querySelectorAll('.tab-button.active');
437
- const activeContents = document.querySelectorAll('.tab-content.active');
438
-
439
- if (activeTabs.length !== 1) {
440
- console.error(`[UIStateManager] VALIDATION FAILED: Expected 1 active tab, found ${activeTabs.length}`);
441
- activeTabs.forEach((tab, idx) => {
442
- console.error(` - Active tab ${idx + 1}: ${tab.textContent.trim()} (${tab.getAttribute('data-tab')})`);
443
- });
444
- // Force fix
445
- this._removeAllActiveStates();
446
- this._setActiveTab(expectedTab);
447
- }
448
-
449
- if (activeContents.length !== 1) {
450
- console.error(`[UIStateManager] VALIDATION FAILED: Expected 1 active content, found ${activeContents.length}`);
451
- activeContents.forEach((content, idx) => {
452
- console.error(` - Active content ${idx + 1}: ${content.id}`);
453
- });
454
- // Force fix
455
- this._removeAllActiveStates();
456
- this._showTabContent(expectedTab);
457
- }
458
-
459
- console.log(`[UIStateManager] Tab state validated for: ${expectedTab}`);
460
- }, 50);
461
- }
462
-
463
- /**
464
- * Handle unified arrow navigation across tabs
465
- * @param {number} direction - Navigation direction (1 for down, -1 for up)
466
- */
467
- handleUnifiedArrowNavigation(direction) {
468
- const tabNav = this.tabNavigation[this.currentTab];
469
- if (!tabNav) return;
470
-
471
- let newIndex = tabNav.selectedIndex + direction;
472
-
473
- // Handle bounds
474
- if (tabNav.items.length === 0) return;
475
-
476
- if (newIndex < 0) {
477
- newIndex = tabNav.items.length - 1;
478
- } else if (newIndex >= tabNav.items.length) {
479
- newIndex = 0;
480
- }
481
-
482
- this.selectCardByIndex(this.currentTab, newIndex);
483
- }
484
-
485
- /**
486
- * Handle unified Enter key across all tabs
487
- */
488
- handleUnifiedEnterKey() {
489
- const tabNav = this.tabNavigation[this.currentTab];
490
- if (!tabNav || tabNav.selectedIndex === -1) return;
491
-
492
- const selectedElement = tabNav.items[tabNav.selectedIndex];
493
- if (selectedElement && selectedElement.onclick) {
494
- selectedElement.onclick();
495
- }
496
- }
497
-
498
- /**
499
- * Clear all unified selection states
500
- */
501
- clearUnifiedSelection() {
502
- // Clear all tab navigation states
503
- Object.keys(this.tabNavigation).forEach(tabName => {
504
- this.tabNavigation[tabName].selectedIndex = -1;
505
- });
506
-
507
- // Clear card selection
508
- this.clearCardSelection();
509
- }
510
-
511
- /**
512
- * Update tab navigation items for current tab
513
- * Should be called after tab content is rendered
514
- */
515
- updateTabNavigationItems() {
516
- const tabNav = this.tabNavigation[this.currentTab];
517
- if (!tabNav) return;
518
-
519
- let containerSelector;
520
- switch (this.currentTab) {
521
- case 'events':
522
- containerSelector = '#events-list .event-item';
523
- break;
524
- case 'agents':
525
- containerSelector = '#agents-list .event-item';
526
- break;
527
- case 'tools':
528
- containerSelector = '#tools-list .event-item';
529
- break;
530
- case 'files':
531
- containerSelector = '#files-list .event-item';
532
- break;
533
- }
534
-
535
- if (containerSelector) {
536
- tabNav.items = Array.from(document.querySelectorAll(containerSelector));
537
- }
538
- }
539
-
540
- /**
541
- * Select card by index for specified tab
542
- * @param {string} tabName - Tab name
543
- * @param {number} index - Index of item to select
544
- */
545
- selectCardByIndex(tabName, index) {
546
- const tabNav = this.tabNavigation[tabName];
547
- if (!tabNav || index < 0 || index >= tabNav.items.length) return;
548
-
549
- // Update navigation state
550
- tabNav.selectedIndex = index;
551
-
552
- // Update visual selection
553
- this.updateUnifiedSelectionUI();
554
-
555
- // If this is a different tab selection, record the card selection
556
- const selectedElement = tabNav.items[index];
557
- if (selectedElement) {
558
- // Extract data from the element to populate selectedCard
559
- this.selectCard(tabName, index, this.getCardType(tabName), index);
560
- }
561
-
562
- // Show details for the selected item
563
- this.showCardDetails(tabName, index);
564
- }
565
-
566
- /**
567
- * Update visual selection UI for unified navigation
568
- */
569
- updateUnifiedSelectionUI() {
570
- // Clear all existing selections
571
- document.querySelectorAll('.event-item.keyboard-selected').forEach(el => {
572
- el.classList.remove('keyboard-selected');
573
- });
574
-
575
- // Apply selection to current tab's selected item
576
- const tabNav = this.tabNavigation[this.currentTab];
577
- if (tabNav && tabNav.selectedIndex !== -1 && tabNav.items[tabNav.selectedIndex]) {
578
- tabNav.items[tabNav.selectedIndex].classList.add('keyboard-selected');
579
- }
580
- }
581
-
582
- /**
583
- * Show card details for specified tab and index
584
- * @param {string} tabName - Tab name
585
- * @param {number} index - Item index
586
- */
587
- showCardDetails(tabName, index) {
588
- // Dispatch event for other modules to handle
589
- document.dispatchEvent(new CustomEvent('showCardDetails', {
590
- detail: {
591
- tabName: tabName,
592
- index: index
593
- }
594
- }));
595
- }
596
-
597
- /**
598
- * Select a specific card
599
- * @param {string} tabName - Tab name
600
- * @param {number} index - Item index
601
- * @param {string} type - Item type
602
- * @param {*} data - Item data
603
- */
604
- selectCard(tabName, index, type, data) {
605
- // Clear previous selection
606
- this.clearCardSelection();
607
-
608
- // Update selection state
609
- this.selectedCard = {
610
- tab: tabName,
611
- index: index,
612
- type: type,
613
- data: data
614
- };
615
-
616
- this.updateCardSelectionUI();
617
-
618
- console.log('Card selected:', this.selectedCard);
619
- }
620
-
621
- /**
622
- * Clear card selection
623
- */
624
- clearCardSelection() {
625
- // Clear visual selection from all tabs
626
- document.querySelectorAll('.event-item.selected, .file-item.selected').forEach(el => {
627
- el.classList.remove('selected');
628
- });
629
-
630
- // Reset selection state
631
- this.selectedCard = {
632
- tab: null,
633
- index: null,
634
- type: null,
635
- data: null
636
- };
637
- }
638
-
639
- /**
640
- * Update card selection UI
641
- */
642
- updateCardSelectionUI() {
643
- if (!this.selectedCard.tab || this.selectedCard.index === null) return;
644
-
645
- // Get the list container for the selected tab
646
- let listContainer;
647
- switch (this.selectedCard.tab) {
648
- case 'events':
649
- listContainer = document.getElementById('events-list');
650
- break;
651
- case 'agents':
652
- listContainer = document.getElementById('agents-list');
653
- break;
654
- case 'tools':
655
- listContainer = document.getElementById('tools-list');
656
- break;
657
- case 'files':
658
- listContainer = document.getElementById('files-list');
659
- break;
660
- }
661
-
662
- if (listContainer) {
663
- const items = listContainer.querySelectorAll('.event-item, .file-item');
664
- if (items[this.selectedCard.index]) {
665
- items[this.selectedCard.index].classList.add('selected');
666
- }
667
- }
668
- }
669
-
670
- /**
671
- * Get card type based on tab name
672
- * @param {string} tabName - Tab name
673
- * @returns {string} - Card type
674
- */
675
- getCardType(tabName) {
676
- switch (tabName) {
677
- case 'events': return 'event';
678
- case 'agents': return 'agent';
679
- case 'tools': return 'tool';
680
- case 'files': return 'file';
681
- default: return 'unknown';
682
- }
683
- }
684
-
685
- /**
686
- * Scroll current tab to bottom
687
- */
688
- scrollCurrentTabToBottom() {
689
- const tabId = `${this.currentTab}-list`;
690
- const element = document.getElementById(tabId);
691
- if (element && this.autoScroll) {
692
- element.scrollTop = element.scrollHeight;
693
- }
694
- }
695
-
696
- /**
697
- * Clear selection for cleanup
698
- */
699
- clearSelection() {
700
- this.clearCardSelection();
701
- this.clearUnifiedSelection();
702
- }
703
-
704
- /**
705
- * Get current tab name
706
- * @returns {string} - Current tab name
707
- */
708
- getCurrentTab() {
709
- return this.currentTab;
710
- }
711
-
712
- /**
713
- * Get selected card info
714
- * @returns {Object} - Selected card state
715
- */
716
- getSelectedCard() {
717
- return { ...this.selectedCard };
718
- }
719
-
720
- /**
721
- * Get tab navigation state
722
- * @returns {Object} - Tab navigation state
723
- */
724
- getTabNavigation() {
725
- return { ...this.tabNavigation };
726
- }
727
-
728
- /**
729
- * Set auto-scroll behavior
730
- * @param {boolean} enabled - Whether to enable auto-scroll
731
- */
732
- setAutoScroll(enabled) {
733
- this.autoScroll = enabled;
734
- }
735
-
736
- /**
737
- * Get auto-scroll state
738
- * @returns {boolean} - Auto-scroll enabled state
739
- */
740
- getAutoScroll() {
741
- return this.autoScroll;
742
- }
743
- }
744
- // ES6 Module export
745
- export { UIStateManager };
746
- export default UIStateManager;
747
-
748
- // Make UIStateManager globally available for dist/dashboard.js
749
- window.UIStateManager = UIStateManager;