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,920 +0,0 @@
1
- /**
2
- * Working Directory Module
3
- *
4
- * Manages working directory state, session-specific directory tracking,
5
- * and git branch monitoring for the dashboard.
6
- *
7
- * WHY: Extracted from main dashboard to isolate working directory management
8
- * logic that involves coordination between UI updates, local storage persistence,
9
- * and git integration. This provides better maintainability for directory state.
10
- *
11
- * DESIGN DECISION: Maintains per-session working directories with persistence
12
- * in localStorage, provides git branch integration, and coordinates with
13
- * footer directory display for consistent state management.
14
- */
15
- class WorkingDirectoryManager {
16
- constructor(socketManager) {
17
- this.socketManager = socketManager;
18
- this.currentWorkingDir = null;
19
- this.footerDirObserver = null;
20
- this._updatingFooter = false;
21
-
22
- this.setupEventHandlers();
23
- this.initialize();
24
-
25
- console.log('Working directory manager initialized');
26
- }
27
-
28
- /**
29
- * Initialize working directory management
30
- */
31
- initialize() {
32
- this.initializeWorkingDirectory();
33
- this.watchFooterDirectory();
34
- }
35
-
36
- /**
37
- * Set up event handlers for working directory controls
38
- */
39
- setupEventHandlers() {
40
- const changeDirBtn = document.getElementById('change-dir-btn');
41
- const workingDirPath = document.getElementById('working-dir-path');
42
-
43
- if (changeDirBtn) {
44
- changeDirBtn.addEventListener('click', () => {
45
- this.showChangeDirDialog();
46
- });
47
- }
48
-
49
- if (workingDirPath) {
50
- workingDirPath.addEventListener('click', (e) => {
51
- // Check if Shift key is held for directory change, otherwise show file viewer
52
- if (e.shiftKey) {
53
- this.showChangeDirDialog();
54
- } else {
55
- this.showWorkingDirectoryViewer();
56
- }
57
- });
58
- }
59
-
60
- // Listen for session changes to update working directory
61
- document.addEventListener('sessionChanged', (e) => {
62
- const sessionId = e.detail.sessionId;
63
- console.log('[WORKING-DIR-DEBUG] sessionChanged event received, sessionId:', this.repr(sessionId));
64
- if (sessionId) {
65
- this.loadWorkingDirectoryForSession(sessionId);
66
- }
67
- });
68
-
69
- // Listen for git branch responses
70
- if (this.socketManager && this.socketManager.getSocket) {
71
- const socket = this.socketManager.getSocket();
72
- if (socket) {
73
- console.log('[WORKING-DIR-DEBUG] Setting up git_branch_response listener');
74
- socket.on('git_branch_response', (response) => {
75
- console.log('[GIT-BRANCH-DEBUG] Received git_branch_response:', response);
76
- this.handleGitBranchResponse(response);
77
- });
78
- }
79
- }
80
- }
81
-
82
- /**
83
- * Initialize working directory for current session
84
- */
85
- initializeWorkingDirectory() {
86
- // Set initial loading state to prevent early Git requests
87
- const pathElement = document.getElementById('working-dir-path');
88
- if (pathElement && !pathElement.textContent.trim()) {
89
- pathElement.textContent = 'Loading...';
90
- }
91
-
92
- // Check if there's a selected session
93
- const sessionSelect = document.getElementById('session-select');
94
- if (sessionSelect && sessionSelect.value && sessionSelect.value !== 'all') {
95
- // Load working directory for selected session
96
- this.loadWorkingDirectoryForSession(sessionSelect.value);
97
- } else {
98
- // Use default working directory
99
- this.setWorkingDirectory(this.getDefaultWorkingDir());
100
- }
101
- }
102
-
103
- /**
104
- * Watch footer directory for changes and sync working directory
105
- */
106
- watchFooterDirectory() {
107
- const footerDir = document.getElementById('footer-working-dir');
108
- if (!footerDir) return;
109
-
110
- // Store observer reference for later use
111
- this.footerDirObserver = new MutationObserver((mutations) => {
112
- // Skip if we're updating from setWorkingDirectory
113
- if (this._updatingFooter) return;
114
-
115
- mutations.forEach((mutation) => {
116
- if (mutation.type === 'childList' || mutation.type === 'characterData') {
117
- const newDir = footerDir.textContent.trim();
118
- console.log('Footer directory changed to:', newDir);
119
-
120
- // Only update if it's different from current
121
- if (newDir && newDir !== this.currentWorkingDir) {
122
- console.log('Syncing working directory from footer change');
123
- this.setWorkingDirectory(newDir);
124
- }
125
- }
126
- });
127
- });
128
-
129
- // Observe changes to footer directory
130
- this.footerDirObserver.observe(footerDir, {
131
- childList: true,
132
- characterData: true,
133
- subtree: true
134
- });
135
-
136
- console.log('Started watching footer directory for changes');
137
- }
138
-
139
- /**
140
- * Load working directory for a specific session
141
- * @param {string} sessionId - Session ID
142
- */
143
- loadWorkingDirectoryForSession(sessionId) {
144
- console.log('[WORKING-DIR-DEBUG] loadWorkingDirectoryForSession called with sessionId:', this.repr(sessionId));
145
-
146
- if (!sessionId || sessionId === 'all') {
147
- console.log('[WORKING-DIR-DEBUG] No sessionId or sessionId is "all", using default working dir');
148
- const defaultDir = this.getDefaultWorkingDir();
149
- console.log('[WORKING-DIR-DEBUG] Default working dir:', this.repr(defaultDir));
150
- this.setWorkingDirectory(defaultDir);
151
- return;
152
- }
153
-
154
- // Load from localStorage
155
- const sessionDirs = JSON.parse(localStorage.getItem('sessionWorkingDirs') || '{}');
156
- console.log('[WORKING-DIR-DEBUG] Session directories from localStorage:', sessionDirs);
157
-
158
- const sessionDir = sessionDirs[sessionId];
159
- const defaultDir = this.getDefaultWorkingDir();
160
- const dir = sessionDir || defaultDir;
161
-
162
- console.log('[WORKING-DIR-DEBUG] Directory selection:', {
163
- sessionId: sessionId,
164
- sessionDir: this.repr(sessionDir),
165
- defaultDir: this.repr(defaultDir),
166
- finalDir: this.repr(dir)
167
- });
168
-
169
- this.setWorkingDirectory(dir);
170
- }
171
-
172
- /**
173
- * Set the working directory for the current session
174
- * @param {string} dir - Directory path
175
- */
176
- setWorkingDirectory(dir) {
177
- console.log('[WORKING-DIR-DEBUG] setWorkingDirectory called with:', this.repr(dir));
178
-
179
- this.currentWorkingDir = dir;
180
-
181
- // Store in session storage for persistence during the session
182
- if (dir && this.validateDirectoryPath(dir)) {
183
- sessionStorage.setItem('currentWorkingDirectory', dir);
184
- console.log('[WORKING-DIR-DEBUG] Stored working directory in session storage:', dir);
185
- }
186
-
187
- // Update UI
188
- const pathElement = document.getElementById('working-dir-path');
189
- if (pathElement) {
190
- console.log('[WORKING-DIR-DEBUG] Updating UI path element to:', dir);
191
- pathElement.textContent = dir;
192
- } else {
193
- console.warn('[WORKING-DIR-DEBUG] working-dir-path element not found');
194
- }
195
-
196
- // Update footer directory (sync across components)
197
- const footerDir = document.getElementById('footer-working-dir');
198
- if (footerDir) {
199
- const currentFooterText = footerDir.textContent;
200
- console.log('[WORKING-DIR-DEBUG] Footer directory current text:', this.repr(currentFooterText), 'new text:', this.repr(dir));
201
-
202
- if (currentFooterText !== dir) {
203
- // Set flag to prevent observer from triggering
204
- this._updatingFooter = true;
205
- footerDir.textContent = dir;
206
- console.log('[WORKING-DIR-DEBUG] Updated footer directory to:', dir);
207
-
208
- // Clear flag after a short delay
209
- setTimeout(() => {
210
- this._updatingFooter = false;
211
- console.log('[WORKING-DIR-DEBUG] Cleared _updatingFooter flag');
212
- }, 100);
213
- } else {
214
- console.log('[WORKING-DIR-DEBUG] Footer directory already has correct text');
215
- }
216
- } else {
217
- console.warn('[WORKING-DIR-DEBUG] footer-working-dir element not found');
218
- }
219
-
220
- // Save to localStorage for session persistence
221
- const sessionSelect = document.getElementById('session-select');
222
- if (sessionSelect && sessionSelect.value && sessionSelect.value !== 'all') {
223
- const sessionId = sessionSelect.value;
224
- const sessionDirs = JSON.parse(localStorage.getItem('sessionWorkingDirs') || '{}');
225
- sessionDirs[sessionId] = dir;
226
- localStorage.setItem('sessionWorkingDirs', JSON.stringify(sessionDirs));
227
- console.log(`[WORKING-DIR-DEBUG] Saved working directory for session ${sessionId}:`, dir);
228
- } else {
229
- console.log('[WORKING-DIR-DEBUG] No session selected or session is "all", not saving to localStorage');
230
- }
231
-
232
- // Update git branch for new directory - only if it's a valid path
233
- console.log('[WORKING-DIR-DEBUG] About to call updateGitBranch with:', this.repr(dir));
234
- if (this.validateDirectoryPath(dir)) {
235
- this.updateGitBranch(dir);
236
- } else {
237
- console.log('[WORKING-DIR-DEBUG] Skipping git branch update for invalid directory:', this.repr(dir));
238
- }
239
-
240
- // Dispatch event for other modules
241
- document.dispatchEvent(new CustomEvent('workingDirectoryChanged', {
242
- detail: { directory: dir }
243
- }));
244
-
245
- console.log('[WORKING-DIR-DEBUG] Working directory set to:', dir);
246
- }
247
-
248
- /**
249
- * Update git branch display for current working directory
250
- * @param {string} dir - Working directory path
251
- */
252
- updateGitBranch(dir) {
253
- console.log('[GIT-BRANCH-DEBUG] updateGitBranch called with dir:', this.repr(dir), 'type:', typeof dir);
254
-
255
- if (!this.socketManager || !this.socketManager.isConnected()) {
256
- console.log('[GIT-BRANCH-DEBUG] Not connected to socket server');
257
- // Not connected, set to unknown
258
- const footerBranch = document.getElementById('footer-git-branch');
259
- if (footerBranch) {
260
- footerBranch.textContent = 'Not Connected';
261
- footerBranch.style.display = 'inline';
262
- }
263
- return;
264
- }
265
-
266
- // Enhanced validation with specific checks for common invalid states
267
- const isValidPath = this.validateDirectoryPath(dir);
268
- const isLoadingState = dir === 'Loading...' || dir === 'Loading';
269
- const isUnknown = dir === 'Unknown';
270
- const isEmptyOrWhitespace = !dir || (typeof dir === 'string' && dir.trim() === '');
271
-
272
- console.log('[GIT-BRANCH-DEBUG] Validation results:', {
273
- dir: dir,
274
- isValidPath: isValidPath,
275
- isLoadingState: isLoadingState,
276
- isUnknown: isUnknown,
277
- isEmptyOrWhitespace: isEmptyOrWhitespace,
278
- shouldReject: !isValidPath || isLoadingState || isUnknown || isEmptyOrWhitespace
279
- });
280
-
281
- // Validate directory before sending to server - reject common invalid states
282
- if (!isValidPath || isLoadingState || isUnknown || isEmptyOrWhitespace) {
283
- console.warn('[GIT-BRANCH-DEBUG] Invalid working directory for git branch request:', dir);
284
- const footerBranch = document.getElementById('footer-git-branch');
285
- if (footerBranch) {
286
- if (isLoadingState) {
287
- footerBranch.textContent = 'Loading...';
288
- } else if (isUnknown || isEmptyOrWhitespace) {
289
- footerBranch.textContent = 'No Directory';
290
- } else {
291
- footerBranch.textContent = 'Invalid Directory';
292
- }
293
- footerBranch.style.display = 'inline';
294
- }
295
- return;
296
- }
297
-
298
- // Request git branch from server
299
- const socket = this.socketManager.getSocket();
300
- if (socket) {
301
- console.log('[GIT-BRANCH-DEBUG] Requesting git branch for directory:', dir);
302
- console.log('[GIT-BRANCH-DEBUG] Socket state:', {
303
- connected: socket.connected,
304
- id: socket.id
305
- });
306
- // Server expects working_dir as a direct parameter, not as an object
307
- socket.emit('get_git_branch', dir);
308
- } else {
309
- console.error('[GIT-BRANCH-DEBUG] No socket available for git branch request');
310
- }
311
- }
312
-
313
- /**
314
- * Get default working directory
315
- * @returns {string} - Default directory path
316
- */
317
- getDefaultWorkingDir() {
318
- console.log('[WORKING-DIR-DEBUG] getDefaultWorkingDir called');
319
-
320
- // Try to get from the current working directory if set
321
- if (this.currentWorkingDir && this.validateDirectoryPath(this.currentWorkingDir)) {
322
- console.log('[WORKING-DIR-DEBUG] Using current working directory:', this.currentWorkingDir);
323
- return this.currentWorkingDir;
324
- }
325
-
326
- // Try to get from header display
327
- const headerWorkingDir = document.querySelector('.working-dir-text');
328
- if (headerWorkingDir?.textContent?.trim()) {
329
- const headerPath = headerWorkingDir.textContent.trim();
330
- if (headerPath !== 'Loading...' && headerPath !== 'Unknown' && this.validateDirectoryPath(headerPath)) {
331
- console.log('[WORKING-DIR-DEBUG] Using header working directory:', headerPath);
332
- return headerPath;
333
- }
334
- }
335
-
336
- // Try to get from footer
337
- const footerDir = document.getElementById('footer-working-dir');
338
- if (footerDir?.textContent?.trim()) {
339
- const footerPath = footerDir.textContent.trim();
340
- console.log('[WORKING-DIR-DEBUG] Footer path found:', this.repr(footerPath));
341
-
342
- // Don't use 'Unknown' as a valid directory
343
- const isUnknown = footerPath === 'Unknown';
344
- const isValid = this.validateDirectoryPath(footerPath);
345
-
346
- console.log('[WORKING-DIR-DEBUG] Footer path validation:', {
347
- footerPath: this.repr(footerPath),
348
- isUnknown: isUnknown,
349
- isValid: isValid,
350
- shouldUse: !isUnknown && isValid
351
- });
352
-
353
- if (!isUnknown && isValid) {
354
- console.log('[WORKING-DIR-DEBUG] Using footer path as default:', footerPath);
355
- return footerPath;
356
- }
357
- } else {
358
- console.log('[WORKING-DIR-DEBUG] No footer directory element or no text content');
359
- }
360
-
361
- // Fallback to a reasonable default - try to get the current project directory
362
- // This should be set when the dashboard initializes
363
-
364
- // Try getting from events that have a working directory
365
- if (window.socketClient && window.socketClient.events) {
366
- // Look for the most recent event with a working directory
367
- const eventsWithDir = window.socketClient.events
368
- .filter(e => e.data && (e.data.working_directory || e.data.cwd || e.data.working_dir))
369
- .reverse();
370
-
371
- if (eventsWithDir.length > 0) {
372
- const recentEvent = eventsWithDir[0];
373
- const dir = recentEvent.data.working_directory ||
374
- recentEvent.data.cwd ||
375
- recentEvent.data.working_dir;
376
- console.log('[WORKING-DIR-DEBUG] Using working directory from recent event:', dir);
377
- return dir;
378
- }
379
- }
380
- const workingDirPath = document.getElementById('working-dir-path');
381
- if (workingDirPath?.textContent?.trim()) {
382
- const pathText = workingDirPath.textContent.trim();
383
- console.log('[WORKING-DIR-DEBUG] Found working-dir-path element text:', this.repr(pathText));
384
- if (pathText !== 'Unknown' && this.validateDirectoryPath(pathText)) {
385
- console.log('[WORKING-DIR-DEBUG] Using working-dir-path as fallback:', pathText);
386
- return pathText;
387
- }
388
- }
389
-
390
- // Try to get from session storage or environment
391
- const sessionWorkingDir = sessionStorage.getItem('currentWorkingDirectory');
392
- if (sessionWorkingDir && this.validateDirectoryPath(sessionWorkingDir)) {
393
- console.log('[WORKING-DIR-DEBUG] Using session storage working directory:', this.repr(sessionWorkingDir));
394
- return sessionWorkingDir;
395
- }
396
-
397
- // Try to get the current working directory from environment/process
398
- // This should be the directory where claude-mpm was started from
399
- const processWorkingDir = window.processWorkingDirectory || process?.cwd?.() || null;
400
- if (processWorkingDir && this.validateDirectoryPath(processWorkingDir)) {
401
- console.log('[WORKING-DIR-DEBUG] Using process working directory:', this.repr(processWorkingDir));
402
- return processWorkingDir;
403
- }
404
-
405
- // Final fallback - use current working directory if available, otherwise home directory
406
- // Never default to root "/" as it's not a useful default for code viewing
407
- const homeDir = window.homeDirectory || process?.env?.HOME || process?.env?.USERPROFILE || null;
408
- const fallback = homeDir || process?.cwd?.() || os?.homedir?.() || '/Users/masa';
409
- console.log('[WORKING-DIR-DEBUG] Using fallback directory (home or cwd):', this.repr(fallback));
410
- return fallback;
411
- }
412
-
413
- /**
414
- * Show change directory dialog
415
- */
416
- showChangeDirDialog() {
417
- const newDir = prompt('Enter new working directory:', this.currentWorkingDir || '');
418
- if (newDir && newDir.trim() !== '') {
419
- this.setWorkingDirectory(newDir.trim());
420
- }
421
- }
422
-
423
- /**
424
- * Show working directory file viewer overlay
425
- * WHY: Provides quick file browsing from the header without opening a full modal
426
- * DESIGN DECISION: Uses overlay positioned below the blue bar for easy access
427
- */
428
- showWorkingDirectoryViewer() {
429
- // Create or show the directory viewer overlay
430
- this.createDirectoryViewerOverlay();
431
- }
432
-
433
- /**
434
- * Create directory viewer overlay positioned below the working directory display
435
- * WHY: Positions overlay near the trigger for intuitive user experience
436
- * without disrupting the main dashboard layout
437
- */
438
- createDirectoryViewerOverlay() {
439
- // Remove existing overlay if present
440
- this.removeDirectoryViewerOverlay();
441
-
442
- const workingDirDisplay = document.querySelector('.working-dir-display');
443
- if (!workingDirDisplay) return;
444
-
445
- // Create overlay element
446
- const overlay = document.createElement('div');
447
- overlay.id = 'directory-viewer-overlay';
448
- overlay.className = 'directory-viewer-overlay';
449
-
450
- // Create overlay content
451
- overlay.innerHTML = `
452
- <div class="directory-viewer-content">
453
- <div class="directory-viewer-header">
454
- <h3 class="directory-viewer-title">
455
- 📁 ${this.currentWorkingDir || 'Working Directory'}
456
- </h3>
457
- <button class="close-btn" onclick="workingDirectoryManager.removeDirectoryViewerOverlay()">✕</button>
458
- </div>
459
- <div class="directory-viewer-body">
460
- <div class="loading-indicator">Loading directory contents...</div>
461
- </div>
462
- <div class="directory-viewer-footer">
463
- <span class="directory-hint">Click file to view • Shift+Click directory path to change</span>
464
- </div>
465
- </div>
466
- `;
467
-
468
- // Position overlay below the working directory display
469
- const rect = workingDirDisplay.getBoundingClientRect();
470
- overlay.style.cssText = `
471
- position: fixed;
472
- top: ${rect.bottom + 5}px;
473
- left: ${rect.left}px;
474
- min-width: 400px;
475
- max-width: 600px;
476
- max-height: 400px;
477
- z-index: 1001;
478
- background: white;
479
- border-radius: 8px;
480
- box-shadow: 0 8px 32px rgba(0, 0, 0, 0.15);
481
- border: 1px solid #e2e8f0;
482
- `;
483
-
484
- // Add to document
485
- document.body.appendChild(overlay);
486
-
487
- // Load directory contents
488
- this.loadDirectoryContents();
489
-
490
- // Add click outside to close
491
- setTimeout(() => {
492
- document.addEventListener('click', this.handleOutsideClick.bind(this), true);
493
- }, 100);
494
- }
495
-
496
- /**
497
- * Remove directory viewer overlay
498
- */
499
- removeDirectoryViewerOverlay() {
500
- const overlay = document.getElementById('directory-viewer-overlay');
501
- if (overlay) {
502
- overlay.remove();
503
- document.removeEventListener('click', this.handleOutsideClick.bind(this), true);
504
- }
505
- }
506
-
507
- /**
508
- * Handle clicks outside the overlay to close it
509
- * @param {Event} event - Click event
510
- */
511
- handleOutsideClick(event) {
512
- const overlay = document.getElementById('directory-viewer-overlay');
513
- const workingDirPath = document.getElementById('working-dir-path');
514
-
515
- if (overlay && !overlay.contains(event.target) && event.target !== workingDirPath) {
516
- this.removeDirectoryViewerOverlay();
517
- }
518
- }
519
-
520
- /**
521
- * Load directory contents using socket connection
522
- * WHY: Uses existing socket infrastructure to get directory listing
523
- * without requiring new endpoints
524
- */
525
- loadDirectoryContents() {
526
- if (!this.socketManager || !this.socketManager.isConnected()) {
527
- this.showDirectoryError('Not connected to server');
528
- return;
529
- }
530
-
531
- const socket = this.socketManager.getSocket();
532
- if (!socket) {
533
- this.showDirectoryError('No socket connection available');
534
- return;
535
- }
536
-
537
- // Request directory listing
538
- socket.emit('get_directory_listing', {
539
- directory: this.currentWorkingDir,
540
- limit: 50 // Reasonable limit for overlay display
541
- });
542
-
543
- // Listen for response
544
- const responseHandler = (data) => {
545
- socket.off('directory_listing_response', responseHandler);
546
- this.handleDirectoryListingResponse(data);
547
- };
548
-
549
- socket.on('directory_listing_response', responseHandler);
550
-
551
- // Timeout after 5 seconds
552
- setTimeout(() => {
553
- socket.off('directory_listing_response', responseHandler);
554
- const overlay = document.getElementById('directory-viewer-overlay');
555
- if (overlay && overlay.querySelector('.loading-indicator')) {
556
- this.showDirectoryError('Request timeout');
557
- }
558
- }, 5000);
559
- }
560
-
561
- /**
562
- * Handle directory listing response from server
563
- * @param {Object} data - Directory listing data
564
- */
565
- handleDirectoryListingResponse(data) {
566
- const bodyElement = document.querySelector('.directory-viewer-body');
567
- if (!bodyElement) return;
568
-
569
- if (!data.success) {
570
- this.showDirectoryError(data.error || 'Failed to load directory');
571
- return;
572
- }
573
-
574
- // Create file listing
575
- const files = data.files || [];
576
- const directories = data.directories || [];
577
-
578
- let html = '';
579
-
580
- // Add parent directory link if not root
581
- if (this.currentWorkingDir && this.currentWorkingDir !== '/') {
582
- const parentDir = this.currentWorkingDir.split('/').slice(0, -1).join('/') || '/';
583
- html += `
584
- <div class="file-item directory-item" onclick="workingDirectoryManager.setWorkingDirectory('${parentDir}')">
585
- <span class="file-icon">📁</span>
586
- <span class="file-name">..</span>
587
- <span class="file-type">parent directory</span>
588
- </div>
589
- `;
590
- }
591
-
592
- // Add directories
593
- directories.forEach(dir => {
594
- const fullPath = `${this.currentWorkingDir}/${dir}`.replace(/\/+/g, '/');
595
- html += `
596
- <div class="file-item directory-item" onclick="workingDirectoryManager.setWorkingDirectory('${fullPath}')">
597
- <span class="file-icon">📁</span>
598
- <span class="file-name">${dir}</span>
599
- <span class="file-type">directory</span>
600
- </div>
601
- `;
602
- });
603
-
604
- // Add files
605
- files.forEach(file => {
606
- const filePath = `${this.currentWorkingDir}/${file}`.replace(/\/+/g, '/');
607
- const fileExt = file.split('.').pop().toLowerCase();
608
- const fileIcon = this.getFileIcon(fileExt);
609
-
610
- html += `
611
- <div class="file-item" onclick="workingDirectoryManager.viewFile('${filePath}')">
612
- <span class="file-icon">${fileIcon}</span>
613
- <span class="file-name">${file}</span>
614
- <span class="file-type">${fileExt}</span>
615
- </div>
616
- `;
617
- });
618
-
619
- if (html === '') {
620
- html = '<div class="no-files">Empty directory</div>';
621
- }
622
-
623
- bodyElement.innerHTML = html;
624
- }
625
-
626
- /**
627
- * Show directory error in the overlay
628
- * @param {string} message - Error message
629
- */
630
- showDirectoryError(message) {
631
- const bodyElement = document.querySelector('.directory-viewer-body');
632
- if (bodyElement) {
633
- bodyElement.innerHTML = `
634
- <div class="directory-error">
635
- <span class="error-icon">⚠️</span>
636
- <span class="error-message">${message}</span>
637
- </div>
638
- `;
639
- }
640
- }
641
-
642
- /**
643
- * Get file icon based on extension
644
- * @param {string} extension - File extension
645
- * @returns {string} - File icon emoji
646
- */
647
- getFileIcon(extension) {
648
- const iconMap = {
649
- 'js': '📄',
650
- 'py': '🐍',
651
- 'html': '🌐',
652
- 'css': '🎨',
653
- 'json': '📋',
654
- 'md': '📝',
655
- 'txt': '📝',
656
- 'yml': '⚙️',
657
- 'yaml': '⚙️',
658
- 'xml': '📄',
659
- 'pdf': '📕',
660
- 'png': '🖼️',
661
- 'jpg': '🖼️',
662
- 'jpeg': '🖼️',
663
- 'gif': '🖼️',
664
- 'svg': '🖼️',
665
- 'zip': '📦',
666
- 'tar': '📦',
667
- 'gz': '📦',
668
- 'sh': '🔧',
669
- 'bat': '🔧',
670
- 'exe': '⚙️',
671
- 'dll': '⚙️'
672
- };
673
-
674
- return iconMap[extension] || '📄';
675
- }
676
-
677
- /**
678
- * View a file using the existing file viewer modal
679
- * @param {string} filePath - Path to the file to view
680
- */
681
- viewFile(filePath) {
682
- // Close the directory viewer overlay
683
- this.removeDirectoryViewerOverlay();
684
-
685
- // Use the existing file viewer modal functionality
686
- if (window.showFileViewerModal) {
687
- window.showFileViewerModal(filePath);
688
- } else {
689
- console.warn('File viewer modal function not available');
690
- }
691
- }
692
-
693
- /**
694
- * Get current working directory
695
- * @returns {string} - Current working directory
696
- */
697
- getCurrentWorkingDir() {
698
- return this.currentWorkingDir;
699
- }
700
-
701
- /**
702
- * Get session working directories from localStorage
703
- * @returns {Object} - Session directories mapping
704
- */
705
- getSessionDirectories() {
706
- return JSON.parse(localStorage.getItem('sessionWorkingDirs') || '{}');
707
- }
708
-
709
- /**
710
- * Set working directory for a specific session
711
- * @param {string} sessionId - Session ID
712
- * @param {string} directory - Directory path
713
- */
714
- setSessionDirectory(sessionId, directory) {
715
- const sessionDirs = this.getSessionDirectories();
716
- sessionDirs[sessionId] = directory;
717
- localStorage.setItem('sessionWorkingDirs', JSON.stringify(sessionDirs));
718
-
719
- // If this is the current session, update the current directory
720
- const sessionSelect = document.getElementById('session-select');
721
- if (sessionSelect && sessionSelect.value === sessionId) {
722
- this.setWorkingDirectory(directory);
723
- }
724
- }
725
-
726
- /**
727
- * Remove session directory from storage
728
- * @param {string} sessionId - Session ID to remove
729
- */
730
- removeSessionDirectory(sessionId) {
731
- const sessionDirs = this.getSessionDirectories();
732
- delete sessionDirs[sessionId];
733
- localStorage.setItem('sessionWorkingDirs', JSON.stringify(sessionDirs));
734
- }
735
-
736
- /**
737
- * Clear all session directories from storage
738
- */
739
- clearAllSessionDirectories() {
740
- localStorage.removeItem('sessionWorkingDirs');
741
- }
742
-
743
- /**
744
- * Extract working directory from event pair
745
- * Used by file operations tracking
746
- * @param {Object} pair - Event pair object
747
- * @returns {string} - Working directory path
748
- */
749
- extractWorkingDirectoryFromPair(pair) {
750
- // Try different sources for working directory
751
- if (pair.pre?.working_dir) return pair.pre.working_dir;
752
- if (pair.post?.working_dir) return pair.post.working_dir;
753
- if (pair.pre?.data?.working_dir) return pair.pre.data.working_dir;
754
- if (pair.post?.data?.working_dir) return pair.post.data.working_dir;
755
-
756
- // Fallback to current working directory
757
- return this.currentWorkingDir || this.getDefaultWorkingDir();
758
- }
759
-
760
- /**
761
- * Validate directory path
762
- * @param {string} path - Directory path to validate
763
- * @returns {boolean} - True if path appears valid
764
- */
765
- validateDirectoryPath(path) {
766
- if (!path || typeof path !== 'string') return false;
767
-
768
- // Basic path validation
769
- const trimmed = path.trim();
770
- if (trimmed.length === 0) return false;
771
-
772
- // Check for obviously invalid paths
773
- if (trimmed.includes('\0')) return false;
774
-
775
- // Check for common invalid placeholder states
776
- const invalidStates = [
777
- 'Loading...',
778
- 'Loading',
779
- 'Unknown',
780
- 'undefined',
781
- 'null',
782
- 'Not Connected',
783
- 'Invalid Directory',
784
- 'No Directory'
785
- ];
786
-
787
- if (invalidStates.includes(trimmed)) return false;
788
-
789
- // Basic path structure validation - should start with / or drive letter on Windows
790
- if (!trimmed.startsWith('/') && !(/^[A-Za-z]:/.test(trimmed))) {
791
- // Allow relative paths that look reasonable
792
- if (trimmed.startsWith('./') || trimmed.startsWith('../') ||
793
- /^[a-zA-Z0-9._-]+/.test(trimmed)) {
794
- return true;
795
- }
796
- return false;
797
- }
798
-
799
- return true;
800
- }
801
-
802
- /**
803
- * Handle git branch response from server
804
- * @param {Object} response - Git branch response
805
- */
806
- handleGitBranchResponse(response) {
807
- console.log('[GIT-BRANCH-DEBUG] handleGitBranchResponse called with:', response);
808
-
809
- const footerBranch = document.getElementById('footer-git-branch');
810
- if (!footerBranch) {
811
- console.warn('[GIT-BRANCH-DEBUG] footer-git-branch element not found');
812
- return;
813
- }
814
-
815
- if (response.success) {
816
- console.log('[GIT-BRANCH-DEBUG] Git branch request successful, branch:', response.branch);
817
- footerBranch.textContent = response.branch;
818
- footerBranch.style.display = 'inline';
819
-
820
- // Optional: Add a class to indicate successful git status
821
- footerBranch.classList.remove('git-error');
822
- footerBranch.classList.add('git-success');
823
- } else {
824
- // Handle different error types more gracefully
825
- let displayText = 'Git Error';
826
- const error = response.error || 'Unknown error';
827
-
828
- if (error.includes('Directory not found') || error.includes('does not exist')) {
829
- displayText = 'Dir Not Found';
830
- } else if (error.includes('Not a directory')) {
831
- displayText = 'Invalid Path';
832
- } else if (error.includes('Not a git repository')) {
833
- displayText = 'No Git Repo';
834
- } else if (error.includes('git')) {
835
- displayText = 'Git Error';
836
- } else {
837
- displayText = 'Unknown';
838
- }
839
-
840
- console.log('[GIT-BRANCH-DEBUG] Git branch request failed:', error, '- showing as:', displayText);
841
- footerBranch.textContent = displayText;
842
- footerBranch.style.display = 'inline';
843
-
844
- // Optional: Add a class to indicate error state
845
- footerBranch.classList.remove('git-success');
846
- footerBranch.classList.add('git-error');
847
- }
848
-
849
- // Log additional debug info from server
850
- if (response.original_working_dir) {
851
- console.log('[GIT-BRANCH-DEBUG] Server received original working_dir:', this.repr(response.original_working_dir));
852
- }
853
- if (response.working_dir) {
854
- console.log('[GIT-BRANCH-DEBUG] Server used working_dir:', this.repr(response.working_dir));
855
- }
856
- if (response.git_error) {
857
- console.log('[GIT-BRANCH-DEBUG] Git command stderr:', response.git_error);
858
- }
859
- }
860
-
861
- /**
862
- * Check if working directory is ready for Git operations
863
- * @returns {boolean} - True if directory is ready
864
- */
865
- isWorkingDirectoryReady() {
866
- const dir = this.getCurrentWorkingDir();
867
- return this.validateDirectoryPath(dir) && dir !== 'Loading...' && dir !== 'Unknown';
868
- }
869
-
870
- /**
871
- * Wait for working directory to be ready, then execute callback
872
- * @param {Function} callback - Function to call when directory is ready
873
- * @param {number} timeout - Maximum time to wait in milliseconds
874
- */
875
- whenDirectoryReady(callback, timeout = 5000) {
876
- const startTime = Date.now();
877
-
878
- const checkReady = () => {
879
- if (this.isWorkingDirectoryReady()) {
880
- callback();
881
- } else if (Date.now() - startTime < timeout) {
882
- setTimeout(checkReady, 100); // Check every 100ms
883
- } else {
884
- console.warn('[WORKING-DIR-DEBUG] Timeout waiting for directory to be ready');
885
- }
886
- };
887
-
888
- checkReady();
889
- }
890
-
891
- /**
892
- * Helper function for detailed logging
893
- * @param {*} value - Value to represent
894
- * @returns {string} - String representation
895
- */
896
- repr(value) {
897
- if (value === null) return 'null';
898
- if (value === undefined) return 'undefined';
899
- if (typeof value === 'string') return `"${value}"`;
900
- return String(value);
901
- }
902
-
903
- /**
904
- * Cleanup resources
905
- */
906
- cleanup() {
907
- if (this.footerDirObserver) {
908
- this.footerDirObserver.disconnect();
909
- this.footerDirObserver = null;
910
- }
911
-
912
- console.log('Working directory manager cleaned up');
913
- }
914
- }
915
- // ES6 Module export
916
- export { WorkingDirectoryManager };
917
- export default WorkingDirectoryManager;
918
-
919
- // Make WorkingDirectoryManager globally available for dist/dashboard.js
920
- window.WorkingDirectoryManager = WorkingDirectoryManager;