@masonator/coolify-mcp 0.7.0 → 0.8.1

package/README.md

@@ -1,16 +1,17 @@
-[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/stumason-coolify-mcp-badge.png)](https://mseep.ai/app/stumason-coolify-mcp)
-
 # Coolify MCP Server
 
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/stumason-coolify-mcp-badge.png)](https://mseep.ai/app/stumason-coolify-mcp)
+
 A Model Context Protocol (MCP) server for [Coolify](https://coolify.io/), enabling AI assistants to manage and debug your Coolify instances through natural language.
 
 ## Features
 
-This MCP server provides **58 tools** focused on **debugging, management, and deployment**:
+This MCP server provides **61 tools** focused on **debugging, management, and deployment**:
 
 | Category           | Tools                                                                                                    |
 | ------------------ | -------------------------------------------------------------------------------------------------------- |
 | **Infrastructure** | overview (all resources at once)                                                                         |
+| **Diagnostics**    | diagnose_app, diagnose_server, find_issues (smart lookup by name/domain/IP)                              |
 | **Servers**        | list, get, validate, resources, domains                                                                  |
 | **Projects**       | list, get, create, update, delete                                                                        |
 | **Environments**   | list, get, create, delete                                                                                |
@@ -82,11 +83,12 @@ The Coolify API returns extremely verbose responses - a single application can c
 
 ### Response Size Comparison
 
-| Endpoint          | Full Response | Summary Response | Reduction |
-| ----------------- | ------------- | ---------------- | --------- |
-| list_applications | ~170KB        | ~4.4KB           | **97%**   |
-| list_services     | ~367KB        | ~1.2KB           | **99%**   |
-| list_servers      | ~4KB          | ~0.4KB           | **90%**   |
+| Endpoint              | Full Response | Summary Response | Reduction |
+| --------------------- | ------------- | ---------------- | --------- |
+| list_applications     | ~170KB        | ~4.4KB           | **97%**   |
+| list_services         | ~367KB        | ~1.2KB           | **99%**   |
+| list_servers          | ~4KB          | ~0.4KB           | **90%**   |
+| list_application_envs | ~3KB/var      | ~0.1KB/var       | **97%**   |
 
 ### Recommended Workflow
 
@@ -108,7 +110,7 @@ list_applications(page=2, per_page=10)
 
 ### Getting Started
 
-```
+```text
 Give me an overview of my infrastructure
 Show me all my applications
 What's running on my servers?
@@ -116,9 +118,12 @@ What's running on my servers?
 
 ### Debugging & Monitoring
 
-```
+```text
+Diagnose my stuartmason.co.uk app
+What's wrong with my-api application?
+Check the status of server 192.168.1.100
+Find any issues in my infrastructure
 Get the logs for application {uuid}
-What's the status of application {uuid}?
 What environment variables are set for application {uuid}?
 Show me recent deployments for application {uuid}
 What resources are running on server {uuid}?
@@ -126,7 +131,7 @@ What resources are running on server {uuid}?
 
 ### Application Management
 
-```
+```text
 Restart application {uuid}
 Stop the database {uuid}
 Start service {uuid}
@@ -136,7 +141,7 @@ Update the DATABASE_URL env var for application {uuid}
 
 ### Project Setup
 
-```
+```text
 Create a new project called "my-app"
 Create a staging environment in project {uuid}
 Deploy my app from private GitHub repo org/repo on branch main
@@ -176,6 +181,14 @@ node dist/index.js
 - `get_version` - Get Coolify API version
 - `get_infrastructure_overview` - Get a high-level overview of all infrastructure (servers, projects, applications, databases, services)
 
+### Diagnostics (Smart Lookup)
+
+These tools accept human-friendly identifiers instead of just UUIDs:
+
+- `diagnose_app` - Get comprehensive app diagnostics (status, logs, env vars, deployments). Accepts UUID, name, or domain (e.g., "stuartmason.co.uk" or "my-app")
+- `diagnose_server` - Get server diagnostics (status, resources, domains, validation). Accepts UUID, name, or IP address (e.g., "coolify-apps" or "192.168.1.100")
+- `find_issues` - Scan entire infrastructure for unhealthy apps, databases, services, and unreachable servers
+
 ### Servers
 
 - `list_servers` - List all servers (returns summary)

package/dist/__tests__/coolify-client.test.js

@@ -649,6 +649,34 @@ describe('CoolifyClient', () => {
             expect(result).toEqual([mockEnvVar]);
             expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/applications/app-uuid/envs', expect.any(Object));
         });
+        it('should list application env vars with summary', async () => {
+            const fullEnvVar = {
+                id: 1,
+                uuid: 'env-var-uuid',
+                key: 'API_KEY',
+                value: 'secret123',
+                is_build_time: false,
+                is_literal: true,
+                is_multiline: false,
+                is_preview: false,
+                is_shared: false,
+                is_shown_once: false,
+                application_id: 1,
+                created_at: '2024-01-01',
+                updated_at: '2024-01-01',
+            };
+            mockFetch.mockResolvedValueOnce(mockResponse([fullEnvVar]));
+            const result = await client.listApplicationEnvVars('app-uuid', { summary: true });
+            // Summary should only include uuid, key, value, is_build_time
+            expect(result).toEqual([
+                {
+                    uuid: 'env-var-uuid',
+                    key: 'API_KEY',
+                    value: 'secret123',
+                    is_build_time: false,
+                },
+            ]);
+        });
         it('should create application env var', async () => {
             mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-env-uuid' }));
             const result = await client.createApplicationEnvVar('app-uuid', {
@@ -1101,4 +1129,544 @@ describe('CoolifyClient', () => {
             expect(result).toEqual({ message: 'Deployment cancelled' });
         });
     });
+    // ===========================================================================
+    // Smart Lookup Tests
+    // ===========================================================================
+    describe('Smart Lookup', () => {
+        describe('resolveApplicationUuid', () => {
+            const mockApps = [
+                {
+                    id: 1,
+                    uuid: 'app-uuid-1',
+                    name: 'tidylinker',
+                    status: 'running',
+                    fqdn: 'https://tidylinker.com',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'app-uuid-2',
+                    name: 'my-api',
+                    status: 'running',
+                    fqdn: 'https://api.example.com',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            it('should return UUID directly if it looks like a UUID', async () => {
+                // UUIDs are alphanumeric, 20+ chars - no API call should be made
+                const result = await client.resolveApplicationUuid('xs0sgs4gog044s4k4c88kgsc');
+                expect(result).toBe('xs0sgs4gog044s4k4c88kgsc');
+                expect(mockFetch).not.toHaveBeenCalled();
+            });
+            it('should find application by name', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockApps));
+                const result = await client.resolveApplicationUuid('tidylinker');
+                expect(result).toBe('app-uuid-1');
+            });
+            it('should find application by partial name (case-insensitive)', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockApps));
+                const result = await client.resolveApplicationUuid('TidyLink');
+                expect(result).toBe('app-uuid-1');
+            });
+            it('should find application by domain', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockApps));
+                const result = await client.resolveApplicationUuid('tidylinker.com');
+                expect(result).toBe('app-uuid-1');
+            });
+            it('should find application by partial domain', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockApps));
+                const result = await client.resolveApplicationUuid('api.example.com');
+                expect(result).toBe('app-uuid-2');
+            });
+            it('should throw error if no application found', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockApps));
+                await expect(client.resolveApplicationUuid('nonexistent')).rejects.toThrow('No application found matching "nonexistent"');
+            });
+            it('should throw error if multiple applications match', async () => {
+                const multiMatchApps = [
+                    { ...mockApps[0], name: 'test-app-1' },
+                    { ...mockApps[1], name: 'test-app-2' },
+                ];
+                mockFetch.mockResolvedValueOnce(mockResponse(multiMatchApps));
+                await expect(client.resolveApplicationUuid('test-app')).rejects.toThrow('Multiple applications match');
+            });
+        });
+        describe('resolveServerUuid', () => {
+            const mockServers = [
+                {
+                    id: 1,
+                    uuid: 'server-uuid-1',
+                    name: 'coolify-apps',
+                    ip: '192.168.1.100',
+                    user: 'root',
+                    port: 22,
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'server-uuid-2',
+                    name: 'production-db',
+                    ip: '10.0.0.50',
+                    user: 'root',
+                    port: 22,
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            it('should return UUID directly if it looks like a UUID', async () => {
+                const result = await client.resolveServerUuid('ggkk8w4c08gw48oowsg4g0oc');
+                expect(result).toBe('ggkk8w4c08gw48oowsg4g0oc');
+                expect(mockFetch).not.toHaveBeenCalled();
+            });
+            it('should find server by name', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockServers));
+                const result = await client.resolveServerUuid('coolify-apps');
+                expect(result).toBe('server-uuid-1');
+            });
+            it('should find server by partial name (case-insensitive)', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockServers));
+                const result = await client.resolveServerUuid('Coolify');
+                expect(result).toBe('server-uuid-1');
+            });
+            it('should find server by IP address', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockServers));
+                const result = await client.resolveServerUuid('192.168.1.100');
+                expect(result).toBe('server-uuid-1');
+            });
+            it('should find server by partial IP', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockServers));
+                const result = await client.resolveServerUuid('10.0.0');
+                expect(result).toBe('server-uuid-2');
+            });
+            it('should throw error if no server found', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockServers));
+                await expect(client.resolveServerUuid('nonexistent')).rejects.toThrow('No server found matching "nonexistent"');
+            });
+            it('should throw error if multiple servers match', async () => {
+                const multiMatchServers = [
+                    { ...mockServers[0], name: 'prod-server-1' },
+                    { ...mockServers[1], name: 'prod-server-2' },
+                ];
+                mockFetch.mockResolvedValueOnce(mockResponse(multiMatchServers));
+                await expect(client.resolveServerUuid('prod-server')).rejects.toThrow('Multiple servers match');
+            });
+        });
+    });
+    // ===========================================================================
+    // Diagnostic Methods Tests
+    // ===========================================================================
+    describe('Diagnostic Methods', () => {
+        describe('diagnoseApplication', () => {
+            // Use UUID-like format that matches the isLikelyUuid check
+            const testAppUuid = 'app0uuid0test0001234567';
+            const mockApp = {
+                id: 1,
+                uuid: testAppUuid,
+                name: 'test-app',
+                status: 'running:healthy',
+                fqdn: 'https://test.com',
+                git_repository: 'org/repo',
+                git_branch: 'main',
+                created_at: '2024-01-01',
+                updated_at: '2024-01-01',
+            };
+            const mockLogs = 'Log line 1\nLog line 2\nLog line 3';
+            const mockEnvVars = [
+                {
+                    id: 1,
+                    uuid: 'env-1',
+                    key: 'DATABASE_URL',
+                    value: 'postgres://...',
+                    is_build_time: false,
+                },
+                { id: 2, uuid: 'env-2', key: 'NODE_ENV', value: 'production', is_build_time: true },
+            ];
+            const mockDeployments = [
+                {
+                    id: 1,
+                    uuid: 'deploy-1',
+                    deployment_uuid: 'deploy-1',
+                    status: 'finished',
+                    force_rebuild: false,
+                    is_webhook: false,
+                    is_api: false,
+                    restart_only: false,
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'deploy-2',
+                    deployment_uuid: 'deploy-2',
+                    status: 'finished',
+                    force_rebuild: false,
+                    is_webhook: false,
+                    is_api: false,
+                    restart_only: false,
+                    created_at: '2024-01-02',
+                    updated_at: '2024-01-02',
+                },
+            ];
+            it('should aggregate all application data successfully', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApp))
+                    .mockResolvedValueOnce(mockResponse(mockLogs))
+                    .mockResolvedValueOnce(mockResponse(mockEnvVars))
+                    .mockResolvedValueOnce(mockResponse(mockDeployments));
+                const result = await client.diagnoseApplication(testAppUuid);
+                expect(result.application).toEqual({
+                    uuid: testAppUuid,
+                    name: 'test-app',
+                    status: 'running:healthy',
+                    fqdn: 'https://test.com',
+                    git_repository: 'org/repo',
+                    git_branch: 'main',
+                });
+                expect(result.health.status).toBe('healthy');
+                expect(result.logs).toBe(mockLogs);
+                expect(result.environment_variables.count).toBe(2);
+                expect(result.environment_variables.variables).toEqual([
+                    { key: 'DATABASE_URL', is_build_time: false },
+                    { key: 'NODE_ENV', is_build_time: true },
+                ]);
+                expect(result.recent_deployments).toHaveLength(2);
+                expect(result.errors).toBeUndefined();
+            });
+            it('should detect unhealthy application status', async () => {
+                const unhealthyApp = { ...mockApp, status: 'exited:unhealthy' };
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(unhealthyApp))
+                    .mockResolvedValueOnce(mockResponse(mockLogs))
+                    .mockResolvedValueOnce(mockResponse(mockEnvVars))
+                    .mockResolvedValueOnce(mockResponse([]));
+                const result = await client.diagnoseApplication(testAppUuid);
+                expect(result.health.status).toBe('unhealthy');
+                expect(result.health.issues).toContain('Status: exited:unhealthy');
+            });
+            it('should detect failed deployments as issues', async () => {
+                const failedDeployments = [
+                    { ...mockDeployments[0], status: 'failed' },
+                    { ...mockDeployments[1], status: 'failed' },
+                ];
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApp))
+                    .mockResolvedValueOnce(mockResponse(mockLogs))
+                    .mockResolvedValueOnce(mockResponse(mockEnvVars))
+                    .mockResolvedValueOnce(mockResponse(failedDeployments));
+                const result = await client.diagnoseApplication(testAppUuid);
+                expect(result.health.issues).toContain('2 failed deployment(s) in last 5');
+            });
+            it('should handle partial failures gracefully', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApp))
+                    .mockRejectedValueOnce(new Error('Logs unavailable'))
+                    .mockResolvedValueOnce(mockResponse(mockEnvVars))
+                    .mockResolvedValueOnce(mockResponse(mockDeployments));
+                const result = await client.diagnoseApplication(testAppUuid);
+                expect(result.application).not.toBeNull();
+                expect(result.logs).toBeNull();
+                expect(result.errors).toContain('logs: Logs unavailable');
+            });
+            it('should handle complete failure gracefully', async () => {
+                mockFetch
+                    .mockRejectedValueOnce(new Error('App not found'))
+                    .mockRejectedValueOnce(new Error('Logs unavailable'))
+                    .mockRejectedValueOnce(new Error('Env vars unavailable'))
+                    .mockRejectedValueOnce(new Error('Deployments unavailable'));
+                const result = await client.diagnoseApplication(testAppUuid);
+                expect(result.application).toBeNull();
+                expect(result.logs).toBeNull();
+                expect(result.health.status).toBe('unknown');
+                expect(result.errors).toHaveLength(4);
+            });
+            it('should find application by name and diagnose it', async () => {
+                const mockApps = [{ ...mockApp, uuid: 'found-uuid', name: 'my-app' }];
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps)) // listApplications for lookup
+                    .mockResolvedValueOnce(mockResponse(mockApp))
+                    .mockResolvedValueOnce(mockResponse(mockLogs))
+                    .mockResolvedValueOnce(mockResponse(mockEnvVars))
+                    .mockResolvedValueOnce(mockResponse(mockDeployments));
+                const result = await client.diagnoseApplication('my-app');
+                expect(result.application).not.toBeNull();
+                // First call should be to list apps for lookup
+                expect(mockFetch).toHaveBeenNthCalledWith(1, 'http://localhost:3000/api/v1/applications', expect.any(Object));
+            });
+            it('should find application by domain and diagnose it', async () => {
+                const mockApps = [{ ...mockApp, uuid: 'found-uuid', fqdn: 'https://tidylinker.com' }];
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps)) // listApplications for lookup
+                    .mockResolvedValueOnce(mockResponse(mockApp))
+                    .mockResolvedValueOnce(mockResponse(mockLogs))
+                    .mockResolvedValueOnce(mockResponse(mockEnvVars))
+                    .mockResolvedValueOnce(mockResponse(mockDeployments));
+                const result = await client.diagnoseApplication('tidylinker.com');
+                expect(result.application).not.toBeNull();
+            });
+            it('should return error in result when application not found by name', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse([])); // Empty app list
+                const result = await client.diagnoseApplication('nonexistent-app');
+                expect(result.application).toBeNull();
+                expect(result.errors).toContain('No application found matching "nonexistent-app"');
+            });
+        });
+        describe('diagnoseServer', () => {
+            // Use UUID-like format that matches the isLikelyUuid check
+            const testServerUuid = 'srv0uuid0test0001234567';
+            const mockServer = {
+                id: 1,
+                uuid: testServerUuid,
+                name: 'test-server',
+                ip: '192.168.1.1',
+                user: 'root',
+                port: 22,
+                status: 'running',
+                is_reachable: true,
+                is_usable: true,
+                created_at: '2024-01-01',
+                updated_at: '2024-01-01',
+            };
+            const mockResources = [
+                {
+                    id: 1,
+                    uuid: 'res-1',
+                    name: 'app-1',
+                    type: 'application',
+                    status: 'running:healthy',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'res-2',
+                    name: 'db-1',
+                    type: 'database',
+                    status: 'running:healthy',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            const mockDomains = [{ ip: '192.168.1.1', domains: ['example.com', 'api.example.com'] }];
+            const mockValidation = { message: 'Server is reachable and validated' };
+            it('should aggregate all server data successfully', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockServer))
+                    .mockResolvedValueOnce(mockResponse(mockResources))
+                    .mockResolvedValueOnce(mockResponse(mockDomains))
+                    .mockResolvedValueOnce(mockResponse(mockValidation));
+                const result = await client.diagnoseServer(testServerUuid);
+                expect(result.server).toEqual({
+                    uuid: testServerUuid,
+                    name: 'test-server',
+                    ip: '192.168.1.1',
+                    status: 'running',
+                    is_reachable: true,
+                });
+                expect(result.health.status).toBe('healthy');
+                expect(result.resources).toHaveLength(2);
+                expect(result.domains).toHaveLength(1);
+                expect(result.validation?.message).toBe('Server is reachable and validated');
+                expect(result.errors).toBeUndefined();
+            });
+            it('should detect unreachable server', async () => {
+                const unreachableServer = { ...mockServer, is_reachable: false };
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(unreachableServer))
+                    .mockResolvedValueOnce(mockResponse(mockResources))
+                    .mockResolvedValueOnce(mockResponse(mockDomains))
+                    .mockResolvedValueOnce(mockResponse(mockValidation));
+                const result = await client.diagnoseServer(testServerUuid);
+                expect(result.health.status).toBe('unhealthy');
+                expect(result.health.issues).toContain('Server is not reachable');
+            });
+            it('should detect unhealthy resources', async () => {
+                const unhealthyResources = [
+                    { ...mockResources[0], status: 'exited:unhealthy' },
+                    { ...mockResources[1], status: 'running:healthy' },
+                ];
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockServer))
+                    .mockResolvedValueOnce(mockResponse(unhealthyResources))
+                    .mockResolvedValueOnce(mockResponse(mockDomains))
+                    .mockResolvedValueOnce(mockResponse(mockValidation));
+                const result = await client.diagnoseServer(testServerUuid);
+                expect(result.health.issues).toContain('1 unhealthy resource(s)');
+            });
+            it('should handle partial failures gracefully', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockServer))
+                    .mockRejectedValueOnce(new Error('Resources unavailable'))
+                    .mockResolvedValueOnce(mockResponse(mockDomains))
+                    .mockResolvedValueOnce(mockResponse(mockValidation));
+                const result = await client.diagnoseServer(testServerUuid);
+                expect(result.server).not.toBeNull();
+                expect(result.resources).toEqual([]);
+                expect(result.errors).toContain('resources: Resources unavailable');
+            });
+            it('should find server by name and diagnose it', async () => {
+                const mockServers = [{ ...mockServer, uuid: 'found-uuid', name: 'coolify-apps' }];
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockServers)) // listServers for lookup
+                    .mockResolvedValueOnce(mockResponse(mockServer))
+                    .mockResolvedValueOnce(mockResponse(mockResources))
+                    .mockResolvedValueOnce(mockResponse(mockDomains))
+                    .mockResolvedValueOnce(mockResponse(mockValidation));
+                const result = await client.diagnoseServer('coolify-apps');
+                expect(result.server).not.toBeNull();
+                // First call should be to list servers for lookup
+                expect(mockFetch).toHaveBeenNthCalledWith(1, 'http://localhost:3000/api/v1/servers', expect.any(Object));
+            });
+            it('should find server by IP and diagnose it', async () => {
+                const mockServers = [{ ...mockServer, uuid: 'found-uuid', ip: '10.0.0.5' }];
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockServers)) // listServers for lookup
+                    .mockResolvedValueOnce(mockResponse(mockServer))
+                    .mockResolvedValueOnce(mockResponse(mockResources))
+                    .mockResolvedValueOnce(mockResponse(mockDomains))
+                    .mockResolvedValueOnce(mockResponse(mockValidation));
+                const result = await client.diagnoseServer('10.0.0.5');
+                expect(result.server).not.toBeNull();
+            });
+            it('should return error in result when server not found by name', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse([])); // Empty server list
+                const result = await client.diagnoseServer('nonexistent-server');
+                expect(result.server).toBeNull();
+                expect(result.errors).toContain('No server found matching "nonexistent-server"');
+            });
+        });
+        describe('findInfrastructureIssues', () => {
+            const mockServers = [
+                {
+                    id: 1,
+                    uuid: 'server-1',
+                    name: 'healthy-server',
+                    ip: '1.1.1.1',
+                    user: 'root',
+                    port: 22,
+                    is_reachable: true,
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'server-2',
+                    name: 'unreachable-server',
+                    ip: '2.2.2.2',
+                    user: 'root',
+                    port: 22,
+                    is_reachable: false,
+                    status: 'error',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            const mockApplications = [
+                {
+                    id: 1,
+                    uuid: 'app-1',
+                    name: 'healthy-app',
+                    status: 'running:healthy',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'app-2',
+                    name: 'unhealthy-app',
+                    status: 'exited:unhealthy',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            const mockDatabases = [
+                {
+                    id: 1,
+                    uuid: 'db-1',
+                    name: 'healthy-db',
+                    type: 'postgresql',
+                    status: 'running:healthy',
+                    is_public: false,
+                    image: 'postgres:16',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'db-2',
+                    name: 'stopped-db',
+                    type: 'redis',
+                    status: 'exited:unhealthy',
+                    is_public: false,
+                    image: 'redis:7',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            const mockServices = [
+                {
+                    id: 1,
+                    uuid: 'svc-1',
+                    name: 'healthy-service',
+                    type: 'pocketbase',
+                    status: 'running:healthy',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'svc-2',
+                    name: 'exited-service',
+                    type: 'n8n',
+                    status: 'exited',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            it('should find all infrastructure issues', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockServers))
+                    .mockResolvedValueOnce(mockResponse(mockApplications))
+                    .mockResolvedValueOnce(mockResponse(mockDatabases))
+                    .mockResolvedValueOnce(mockResponse(mockServices));
+                const result = await client.findInfrastructureIssues();
+                expect(result.summary.total_issues).toBe(4);
+                expect(result.summary.unreachable_servers).toBe(1);
+                expect(result.summary.unhealthy_applications).toBe(1);
+                expect(result.summary.unhealthy_databases).toBe(1);
+                expect(result.summary.unhealthy_services).toBe(1);
+                expect(result.issues).toHaveLength(4);
+                expect(result.errors).toBeUndefined();
+            });
+            it('should return empty issues when everything is healthy', async () => {
+                const healthyServers = [mockServers[0]];
+                const healthyApps = [mockApplications[0]];
+                const healthyDbs = [mockDatabases[0]];
+                const healthySvcs = [mockServices[0]];
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(healthyServers))
+                    .mockResolvedValueOnce(mockResponse(healthyApps))
+                    .mockResolvedValueOnce(mockResponse(healthyDbs))
+                    .mockResolvedValueOnce(mockResponse(healthySvcs));
+                const result = await client.findInfrastructureIssues();
+                expect(result.summary.total_issues).toBe(0);
+                expect(result.issues).toHaveLength(0);
+            });
+            it('should handle partial failures and still report issues', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockServers))
+                    .mockRejectedValueOnce(new Error('Applications unavailable'))
+                    .mockResolvedValueOnce(mockResponse(mockDatabases))
+                    .mockResolvedValueOnce(mockResponse(mockServices));
+                const result = await client.findInfrastructureIssues();
+                expect(result.summary.unreachable_servers).toBe(1);
+                expect(result.summary.unhealthy_databases).toBe(1);
+                expect(result.summary.unhealthy_services).toBe(1);
+                expect(result.summary.unhealthy_applications).toBe(0); // Failed to fetch
+                expect(result.errors).toContain('applications: Applications unavailable');
+            });
+        });
+    });
 });