claude-mpm 5.0.9__py3-none-any.whl → 5.4.41__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 (263) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/__init__.py +4 -0
  3. claude_mpm/agents/BASE_AGENT.md +164 -0
  4. claude_mpm/agents/{PM_INSTRUCTIONS_TEACH.md → CLAUDE_MPM_TEACHER_OUTPUT_STYLE.md} +721 -41
  5. claude_mpm/agents/MEMORY.md +1 -1
  6. claude_mpm/agents/PM_INSTRUCTIONS.md +468 -468
  7. claude_mpm/agents/WORKFLOW.md +5 -254
  8. claude_mpm/agents/agent_loader.py +13 -44
  9. claude_mpm/agents/base_agent.json +1 -1
  10. claude_mpm/agents/frontmatter_validator.py +70 -2
  11. claude_mpm/agents/templates/circuit-breakers.md +431 -45
  12. claude_mpm/cli/__init__.py +0 -1
  13. claude_mpm/cli/__main__.py +4 -0
  14. claude_mpm/cli/chrome_devtools_installer.py +175 -0
  15. claude_mpm/cli/commands/agent_state_manager.py +18 -27
  16. claude_mpm/cli/commands/agents.py +175 -37
  17. claude_mpm/cli/commands/auto_configure.py +723 -236
  18. claude_mpm/cli/commands/config.py +88 -2
  19. claude_mpm/cli/commands/configure.py +1262 -157
  20. claude_mpm/cli/commands/configure_agent_display.py +25 -6
  21. claude_mpm/cli/commands/mpm_init/core.py +225 -46
  22. claude_mpm/cli/commands/mpm_init/knowledge_extractor.py +481 -0
  23. claude_mpm/cli/commands/mpm_init/prompts.py +280 -0
  24. claude_mpm/cli/commands/postmortem.py +1 -1
  25. claude_mpm/cli/commands/profile.py +277 -0
  26. claude_mpm/cli/commands/skills.py +214 -189
  27. claude_mpm/cli/commands/summarize.py +413 -0
  28. claude_mpm/cli/executor.py +21 -3
  29. claude_mpm/cli/interactive/agent_wizard.py +85 -10
  30. claude_mpm/cli/parsers/agents_parser.py +54 -9
  31. claude_mpm/cli/parsers/auto_configure_parser.py +13 -138
  32. claude_mpm/cli/parsers/base_parser.py +12 -0
  33. claude_mpm/cli/parsers/config_parser.py +153 -83
  34. claude_mpm/cli/parsers/profile_parser.py +148 -0
  35. claude_mpm/cli/parsers/skills_parser.py +3 -2
  36. claude_mpm/cli/startup.py +879 -149
  37. claude_mpm/commands/mpm-config.md +28 -0
  38. claude_mpm/commands/mpm-doctor.md +9 -22
  39. claude_mpm/commands/mpm-help.md +5 -287
  40. claude_mpm/commands/mpm-init.md +81 -507
  41. claude_mpm/commands/mpm-monitor.md +15 -402
  42. claude_mpm/commands/mpm-organize.md +120 -0
  43. claude_mpm/commands/mpm-postmortem.md +6 -108
  44. claude_mpm/commands/mpm-session-resume.md +12 -363
  45. claude_mpm/commands/mpm-status.md +5 -69
  46. claude_mpm/commands/mpm-ticket-view.md +52 -495
  47. claude_mpm/commands/mpm-version.md +5 -107
  48. claude_mpm/config/agent_sources.py +27 -0
  49. claude_mpm/core/config.py +2 -4
  50. claude_mpm/core/framework/formatters/content_formatter.py +3 -13
  51. claude_mpm/core/framework/loaders/agent_loader.py +8 -5
  52. claude_mpm/core/framework/loaders/instruction_loader.py +52 -11
  53. claude_mpm/core/framework_loader.py +4 -2
  54. claude_mpm/core/logger.py +13 -0
  55. claude_mpm/core/optimized_startup.py +59 -0
  56. claude_mpm/core/output_style_manager.py +173 -43
  57. claude_mpm/core/shared/config_loader.py +1 -1
  58. claude_mpm/core/socketio_pool.py +3 -3
  59. claude_mpm/core/unified_agent_registry.py +134 -16
  60. claude_mpm/core/unified_config.py +22 -0
  61. claude_mpm/dashboard/static/svelte-build/_app/env.js +1 -0
  62. claude_mpm/dashboard/static/svelte-build/_app/immutable/assets/0.B_FtCwCQ.css +1 -0
  63. claude_mpm/dashboard/static/svelte-build/_app/immutable/assets/2.Cl_eSA4x.css +1 -0
  64. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BgChzWQ1.js +1 -0
  65. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CIXEwuWe.js +1 -0
  66. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CWc5urbQ.js +1 -0
  67. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DMkZpdF2.js +2 -0
  68. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DjhvlsAc.js +1 -0
  69. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/N4qtv3Hx.js +2 -0
  70. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/uj46x2Wr.js +1 -0
  71. claude_mpm/dashboard/static/svelte-build/_app/immutable/entry/app.DTL5mJO-.js +2 -0
  72. claude_mpm/dashboard/static/svelte-build/_app/immutable/entry/start.DzuEhzqh.js +1 -0
  73. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/0.CAGBuiOw.js +1 -0
  74. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/1.DFLC8jdE.js +1 -0
  75. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/2.DPvEihJJ.js +10 -0
  76. claude_mpm/dashboard/static/svelte-build/_app/version.json +1 -0
  77. claude_mpm/dashboard/static/svelte-build/favicon.svg +7 -0
  78. claude_mpm/dashboard/static/svelte-build/index.html +36 -0
  79. claude_mpm/hooks/claude_hooks/__pycache__/__init__.cpython-311.pyc +0 -0
  80. claude_mpm/hooks/claude_hooks/__pycache__/correlation_manager.cpython-311.pyc +0 -0
  81. claude_mpm/hooks/claude_hooks/__pycache__/event_handlers.cpython-311.pyc +0 -0
  82. claude_mpm/hooks/claude_hooks/__pycache__/hook_handler.cpython-311.pyc +0 -0
  83. claude_mpm/hooks/claude_hooks/__pycache__/installer.cpython-311.pyc +0 -0
  84. claude_mpm/hooks/claude_hooks/__pycache__/memory_integration.cpython-311.pyc +0 -0
  85. claude_mpm/hooks/claude_hooks/__pycache__/response_tracking.cpython-311.pyc +0 -0
  86. claude_mpm/hooks/claude_hooks/__pycache__/tool_analysis.cpython-311.pyc +0 -0
  87. claude_mpm/hooks/claude_hooks/correlation_manager.py +60 -0
  88. claude_mpm/hooks/claude_hooks/event_handlers.py +211 -78
  89. claude_mpm/hooks/claude_hooks/hook_handler.py +155 -1
  90. claude_mpm/hooks/claude_hooks/installer.py +33 -10
  91. claude_mpm/hooks/claude_hooks/memory_integration.py +28 -0
  92. claude_mpm/hooks/claude_hooks/response_tracking.py +2 -3
  93. claude_mpm/hooks/claude_hooks/services/__pycache__/__init__.cpython-311.pyc +0 -0
  94. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager.cpython-311.pyc +0 -0
  95. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager_http.cpython-311.pyc +0 -0
  96. claude_mpm/hooks/claude_hooks/services/__pycache__/duplicate_detector.cpython-311.pyc +0 -0
  97. claude_mpm/hooks/claude_hooks/services/__pycache__/state_manager.cpython-311.pyc +0 -0
  98. claude_mpm/hooks/claude_hooks/services/__pycache__/subagent_processor.cpython-311.pyc +0 -0
  99. claude_mpm/hooks/claude_hooks/services/connection_manager.py +30 -6
  100. claude_mpm/hooks/memory_integration_hook.py +46 -1
  101. claude_mpm/init.py +63 -19
  102. claude_mpm/models/agent_definition.py +7 -0
  103. claude_mpm/models/git_repository.py +3 -3
  104. claude_mpm/scripts/claude-hook-handler.sh +58 -18
  105. claude_mpm/scripts/launch_monitor.py +93 -13
  106. claude_mpm/scripts/start_activity_logging.py +0 -0
  107. claude_mpm/services/agents/agent_builder.py +3 -3
  108. claude_mpm/services/agents/agent_recommendation_service.py +278 -0
  109. claude_mpm/services/agents/agent_review_service.py +280 -0
  110. claude_mpm/services/agents/cache_git_manager.py +6 -6
  111. claude_mpm/services/agents/deployment/agent_deployment.py +29 -7
  112. claude_mpm/services/agents/deployment/agent_discovery_service.py +4 -5
  113. claude_mpm/services/agents/deployment/agent_template_builder.py +5 -3
  114. claude_mpm/services/agents/deployment/agents_directory_resolver.py +2 -2
  115. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +320 -29
  116. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +546 -68
  117. claude_mpm/services/agents/git_source_manager.py +36 -2
  118. claude_mpm/services/agents/loading/base_agent_manager.py +1 -13
  119. claude_mpm/services/agents/recommender.py +5 -3
  120. claude_mpm/services/agents/single_tier_deployment_service.py +2 -2
  121. claude_mpm/services/agents/sources/git_source_sync_service.py +13 -6
  122. claude_mpm/services/agents/startup_sync.py +22 -2
  123. claude_mpm/services/agents/toolchain_detector.py +10 -6
  124. claude_mpm/services/analysis/__init__.py +11 -1
  125. claude_mpm/services/analysis/clone_detector.py +1030 -0
  126. claude_mpm/services/command_deployment_service.py +81 -10
  127. claude_mpm/services/diagnostics/checks/agent_check.py +2 -2
  128. claude_mpm/services/diagnostics/checks/agent_sources_check.py +1 -1
  129. claude_mpm/services/event_bus/config.py +3 -1
  130. claude_mpm/services/git/git_operations_service.py +101 -16
  131. claude_mpm/services/monitor/daemon.py +9 -2
  132. claude_mpm/services/monitor/daemon_manager.py +39 -3
  133. claude_mpm/services/monitor/management/lifecycle.py +8 -1
  134. claude_mpm/services/monitor/server.py +698 -22
  135. claude_mpm/services/pm_skills_deployer.py +676 -0
  136. claude_mpm/services/profile_manager.py +331 -0
  137. claude_mpm/services/project/project_organizer.py +4 -0
  138. claude_mpm/services/self_upgrade_service.py +120 -12
  139. claude_mpm/services/skills/__init__.py +3 -0
  140. claude_mpm/services/skills/git_skill_source_manager.py +130 -2
  141. claude_mpm/services/skills/selective_skill_deployer.py +704 -0
  142. claude_mpm/services/skills/skill_to_agent_mapper.py +406 -0
  143. claude_mpm/services/skills_deployer.py +126 -9
  144. claude_mpm/services/socketio/dashboard_server.py +1 -0
  145. claude_mpm/services/socketio/event_normalizer.py +51 -6
  146. claude_mpm/services/socketio/server/core.py +386 -108
  147. claude_mpm/services/version_control/git_operations.py +103 -0
  148. claude_mpm/skills/skill_manager.py +92 -3
  149. claude_mpm/utils/agent_dependency_loader.py +14 -2
  150. claude_mpm/utils/agent_filters.py +17 -44
  151. claude_mpm/utils/gitignore.py +3 -0
  152. claude_mpm/utils/migration.py +4 -4
  153. claude_mpm/utils/robust_installer.py +47 -3
  154. {claude_mpm-5.0.9.dist-info → claude_mpm-5.4.41.dist-info}/METADATA +57 -87
  155. {claude_mpm-5.0.9.dist-info → claude_mpm-5.4.41.dist-info}/RECORD +160 -211
  156. claude_mpm-5.4.41.dist-info/entry_points.txt +5 -0
  157. claude_mpm-5.4.41.dist-info/licenses/LICENSE +94 -0
  158. claude_mpm-5.4.41.dist-info/licenses/LICENSE-FAQ.md +153 -0
  159. claude_mpm/agents/BASE_AGENT_TEMPLATE.md +0 -292
  160. claude_mpm/agents/BASE_DOCUMENTATION.md +0 -53
  161. claude_mpm/agents/BASE_OPS.md +0 -219
  162. claude_mpm/agents/BASE_PM.md +0 -480
  163. claude_mpm/agents/BASE_PROMPT_ENGINEER.md +0 -787
  164. claude_mpm/agents/BASE_QA.md +0 -167
  165. claude_mpm/agents/BASE_RESEARCH.md +0 -53
  166. claude_mpm/agents/base_agent_loader.py +0 -601
  167. claude_mpm/cli/commands/agents_detect.py +0 -380
  168. claude_mpm/cli/commands/agents_recommend.py +0 -309
  169. claude_mpm/cli/ticket_cli.py +0 -35
  170. claude_mpm/commands/mpm-agents-auto-configure.md +0 -278
  171. claude_mpm/commands/mpm-agents-detect.md +0 -177
  172. claude_mpm/commands/mpm-agents-list.md +0 -131
  173. claude_mpm/commands/mpm-agents-recommend.md +0 -223
  174. claude_mpm/commands/mpm-config-view.md +0 -150
  175. claude_mpm/commands/mpm-ticket-organize.md +0 -304
  176. claude_mpm/dashboard/analysis_runner.py +0 -455
  177. claude_mpm/dashboard/index.html +0 -13
  178. claude_mpm/dashboard/open_dashboard.py +0 -66
  179. claude_mpm/dashboard/static/css/activity.css +0 -1958
  180. claude_mpm/dashboard/static/css/connection-status.css +0 -370
  181. claude_mpm/dashboard/static/css/dashboard.css +0 -4701
  182. claude_mpm/dashboard/static/js/components/activity-tree.js +0 -1871
  183. claude_mpm/dashboard/static/js/components/agent-hierarchy.js +0 -777
  184. claude_mpm/dashboard/static/js/components/agent-inference.js +0 -956
  185. claude_mpm/dashboard/static/js/components/build-tracker.js +0 -333
  186. claude_mpm/dashboard/static/js/components/code-simple.js +0 -857
  187. claude_mpm/dashboard/static/js/components/connection-debug.js +0 -654
  188. claude_mpm/dashboard/static/js/components/diff-viewer.js +0 -891
  189. claude_mpm/dashboard/static/js/components/event-processor.js +0 -542
  190. claude_mpm/dashboard/static/js/components/event-viewer.js +0 -1155
  191. claude_mpm/dashboard/static/js/components/export-manager.js +0 -368
  192. claude_mpm/dashboard/static/js/components/file-change-tracker.js +0 -443
  193. claude_mpm/dashboard/static/js/components/file-change-viewer.js +0 -690
  194. claude_mpm/dashboard/static/js/components/file-tool-tracker.js +0 -724
  195. claude_mpm/dashboard/static/js/components/file-viewer.js +0 -580
  196. claude_mpm/dashboard/static/js/components/hud-library-loader.js +0 -211
  197. claude_mpm/dashboard/static/js/components/hud-manager.js +0 -671
  198. claude_mpm/dashboard/static/js/components/hud-visualizer.js +0 -1718
  199. claude_mpm/dashboard/static/js/components/module-viewer.js +0 -2764
  200. claude_mpm/dashboard/static/js/components/session-manager.js +0 -579
  201. claude_mpm/dashboard/static/js/components/socket-manager.js +0 -368
  202. claude_mpm/dashboard/static/js/components/ui-state-manager.js +0 -749
  203. claude_mpm/dashboard/static/js/components/unified-data-viewer.js +0 -1824
  204. claude_mpm/dashboard/static/js/components/working-directory.js +0 -920
  205. claude_mpm/dashboard/static/js/connection-manager.js +0 -536
  206. claude_mpm/dashboard/static/js/dashboard.js +0 -1914
  207. claude_mpm/dashboard/static/js/extension-error-handler.js +0 -164
  208. claude_mpm/dashboard/static/js/socket-client.js +0 -1474
  209. claude_mpm/dashboard/static/js/tab-isolation-fix.js +0 -185
  210. claude_mpm/dashboard/static/socket.io.min.js +0 -7
  211. claude_mpm/dashboard/static/socket.io.v4.8.1.backup.js +0 -7
  212. claude_mpm/dashboard/templates/code_simple.html +0 -153
  213. claude_mpm/dashboard/templates/index.html +0 -606
  214. claude_mpm/dashboard/test_dashboard.html +0 -372
  215. claude_mpm/hooks/claude_hooks/__pycache__/__init__.cpython-313.pyc +0 -0
  216. claude_mpm/hooks/claude_hooks/__pycache__/event_handlers.cpython-313.pyc +0 -0
  217. claude_mpm/hooks/claude_hooks/__pycache__/hook_handler.cpython-313.pyc +0 -0
  218. claude_mpm/hooks/claude_hooks/__pycache__/memory_integration.cpython-313.pyc +0 -0
  219. claude_mpm/hooks/claude_hooks/__pycache__/response_tracking.cpython-313.pyc +0 -0
  220. claude_mpm/hooks/claude_hooks/__pycache__/tool_analysis.cpython-313.pyc +0 -0
  221. claude_mpm/hooks/claude_hooks/services/__pycache__/__init__.cpython-313.pyc +0 -0
  222. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager_http.cpython-313.pyc +0 -0
  223. claude_mpm/hooks/claude_hooks/services/__pycache__/duplicate_detector.cpython-313.pyc +0 -0
  224. claude_mpm/hooks/claude_hooks/services/__pycache__/state_manager.cpython-313.pyc +0 -0
  225. claude_mpm/hooks/claude_hooks/services/__pycache__/subagent_processor.cpython-313.pyc +0 -0
  226. claude_mpm/scripts/mcp_server.py +0 -75
  227. claude_mpm/scripts/mcp_wrapper.py +0 -39
  228. claude_mpm/services/mcp_gateway/__init__.py +0 -159
  229. claude_mpm/services/mcp_gateway/auto_configure.py +0 -369
  230. claude_mpm/services/mcp_gateway/config/__init__.py +0 -17
  231. claude_mpm/services/mcp_gateway/config/config_loader.py +0 -296
  232. claude_mpm/services/mcp_gateway/config/config_schema.py +0 -243
  233. claude_mpm/services/mcp_gateway/config/configuration.py +0 -429
  234. claude_mpm/services/mcp_gateway/core/__init__.py +0 -43
  235. claude_mpm/services/mcp_gateway/core/base.py +0 -312
  236. claude_mpm/services/mcp_gateway/core/exceptions.py +0 -253
  237. claude_mpm/services/mcp_gateway/core/interfaces.py +0 -443
  238. claude_mpm/services/mcp_gateway/core/process_pool.py +0 -977
  239. claude_mpm/services/mcp_gateway/core/singleton_manager.py +0 -315
  240. claude_mpm/services/mcp_gateway/core/startup_verification.py +0 -316
  241. claude_mpm/services/mcp_gateway/main.py +0 -589
  242. claude_mpm/services/mcp_gateway/registry/__init__.py +0 -12
  243. claude_mpm/services/mcp_gateway/registry/service_registry.py +0 -412
  244. claude_mpm/services/mcp_gateway/registry/tool_registry.py +0 -489
  245. claude_mpm/services/mcp_gateway/server/__init__.py +0 -15
  246. claude_mpm/services/mcp_gateway/server/mcp_gateway.py +0 -414
  247. claude_mpm/services/mcp_gateway/server/stdio_handler.py +0 -372
  248. claude_mpm/services/mcp_gateway/server/stdio_server.py +0 -712
  249. claude_mpm/services/mcp_gateway/tools/__init__.py +0 -36
  250. claude_mpm/services/mcp_gateway/tools/base_adapter.py +0 -485
  251. claude_mpm/services/mcp_gateway/tools/document_summarizer.py +0 -789
  252. claude_mpm/services/mcp_gateway/tools/external_mcp_services.py +0 -654
  253. claude_mpm/services/mcp_gateway/tools/health_check_tool.py +0 -456
  254. claude_mpm/services/mcp_gateway/tools/hello_world.py +0 -551
  255. claude_mpm/services/mcp_gateway/tools/kuzu_memory_service.py +0 -555
  256. claude_mpm/services/mcp_gateway/utils/__init__.py +0 -14
  257. claude_mpm/services/mcp_gateway/utils/package_version_checker.py +0 -160
  258. claude_mpm/services/mcp_gateway/utils/update_preferences.py +0 -170
  259. claude_mpm-5.0.9.dist-info/entry_points.txt +0 -10
  260. claude_mpm-5.0.9.dist-info/licenses/LICENSE +0 -21
  261. /claude_mpm/agents/{OUTPUT_STYLE.md → CLAUDE_MPM_OUTPUT_STYLE.md} +0 -0
  262. {claude_mpm-5.0.9.dist-info → claude_mpm-5.4.41.dist-info}/WHEEL +0 -0
  263. {claude_mpm-5.0.9.dist-info → claude_mpm-5.4.41.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;