@access-mcp/system-status 0.4.1 → 0.5.1

package/README.md

@@ -1,91 +1,63 @@
 # System Status MCP Server
 
-MCP server providing real-time system status information for ACCESS-CI resources. Provides critical operational information about ACCESS-CI systems, including current outages, scheduled maintenance, and system-wide announcements.
+MCP server for real-time ACCESS-CI system status including current outages, scheduled maintenance, and operational status.
 
 ## Usage Examples
 
-### **Monitor Current Issues**
-
+### Current Status
 ```
-"Are there any current outages on ACCESS-CI?"
-"Is Delta currently operational?"
-"What systems are experiencing issues right now?"
-"Show me all systems that are down"
+"Current ACCESS-CI outages"
+"Delta operational status"
+"Systems experiencing issues"
+"GPU systems status check"
 ```
 
-### **Track Maintenance Windows**
-
+### Maintenance & Incidents
 ```
-"When is the next maintenance for Expanse?"
-"Show me all scheduled maintenance for this week"
-"Is there upcoming maintenance on Bridges-2?"
-"What maintenance is planned for GPU systems?"
-```
-
-### **System Announcements**
-
-```
-"What are the latest system announcements?"
-"Are there any important notices for ACCESS users?"
-"Show me recent updates about system changes"
-"Any policy updates I should know about?"
-```
-
-### **Check Resource Status**
-
-```
-"What's the current status of Anvil?"
-"Is Frontera available for job submission?"
-"Check if all GPU systems are operational"
-"Get status for all TACC resources"
+"Scheduled maintenance this week"
+"Next Expanse maintenance window"
+"Past outages for Bridges-2"
+"All infrastructure news for Delta"
 ```
 
 ## Tools
 
-### get_current_outages
+### `get_infrastructure_news`
 
-Get current system outages and issues affecting ACCESS-CI resources.
+Get infrastructure status, outages, and maintenance information for ACCESS-CI resources.
 
 **Parameters:**
-
-- `resource_filter` (string, optional): Filter by specific resource name or ID
-
-**Example:**
-```typescript
-// User: "Are there any current outages on Delta?"
-const outages = await get_current_outages({
-  resource_filter: "delta"
-});
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `resource` | string | Filter by resource name (e.g., "delta", "bridges2") |
+| `time` | enum | Time period: `current`, `scheduled`, `past`, `all` (default: "current") |
+| `resource_ids` | array | Check status for specific resource IDs |
+| `limit` | number | Max results (default: 50 for "all", 100 for "past") |
+| `use_group_api` | boolean | Use resource group API for status checking (default: false) |
+
+**Examples:**
+```javascript
+// Get current outages across all resources
+get_infrastructure_news({})
+
+// Get scheduled maintenance
+get_infrastructure_news({ time: "scheduled" })
+
+// Get comprehensive overview
+get_infrastructure_news({ time: "all" })
+
+// Check current status for specific resource
+get_infrastructure_news({ resource: "delta", time: "current" })
+
+// Check operational status of specific resources
+get_infrastructure_news({
+  resource_ids: ["delta.ncsa.access-ci.org", "bridges2.psc.access-ci.org"]
+})
+
+// Get past outages with limit
+get_infrastructure_news({ time: "past", limit: 50 })
 ```
 
-### get_scheduled_maintenance
-
-Get scheduled maintenance and future outages for ACCESS-CI resources.
-
-**Parameters:**
-
-- `resource_filter` (string, optional): Filter by specific resource name or ID
-
-### get_system_announcements
-
-Get all system announcements (current and scheduled).
-
-**Parameters:**
-
-- `limit` (number, optional): Maximum number of announcements to return (default: 50)
-
-### get_resource_status
-
-Get the current operational status of a specific resource.
-
-**Parameters:**
-
-- `resource_id` (string): The resource ID to check status for
-
-## Resources
-
-- `accessci://system-status`: Current operational status of all ACCESS-CI resources
-
 ## Installation
 
 ```bash
@@ -94,8 +66,6 @@ npm install -g @access-mcp/system-status
 
 ## Configuration
 
-Add to your Claude Desktop configuration:
-
 ```json
 {
   "mcpServers": {
@@ -107,104 +77,6 @@ Add to your Claude Desktop configuration:
 }
 ```
 
-## Usage Examples
-
-### 🚨 **Monitor Current Issues**
-
-- "Are there any current outages on ACCESS-CI?"
-- "Is Delta currently operational?"
-- "What systems are experiencing issues right now?"
-
-### 🔧 **Track Maintenance Windows**
-
-- "When is the next maintenance for Expanse?"
-- "Show me all scheduled maintenance for this week"
-- "Is there upcoming maintenance on Bridges-2?"
-
-### 📢 **System Announcements**
-
-- "What are the latest system announcements?"
-- "Are there any important notices for ACCESS users?"
-- "Show me recent updates about system changes"
-
-### ✅ **Check Resource Status**
-
-- "What's the current status of Anvil?"
-- "Is Frontera available for job submission?"
-- "Check if all GPU systems are operational"
-
-## Detailed Usage Examples
-
-### Checking Current Outages
-
-**Natural Language**: "Are there any systems down right now?"
-
-**Tool Call**:
-```typescript
-const outages = await get_current_outages();
-```
-
-**Returns**: List of active outages with:
-- Affected resources
-- Start time and expected resolution
-- Impact description
-- Workaround information if available
-
-### Finding Scheduled Maintenance
-
-**Natural Language**: "When is Delta scheduled for maintenance?"
-
-**Tool Call**:
-```typescript
-const maintenance = await get_scheduled_maintenance({
-  resource_filter: "delta"
-});
-```
-
-**Returns**: Upcoming maintenance windows including:
-- Scheduled start and end times
-- Systems affected
-- Type of maintenance
-- Expected impact on users
-
-### Getting System Announcements
-
-**Natural Language**: "What are the latest announcements?"
-
-**Tool Call**:
-```typescript
-const announcements = await get_system_announcements({
-  limit: 10
-});
-```
-
-**Returns**: Recent announcements about:
-- Policy changes
-- New features or services
-- Important deadlines
-- System-wide updates
-
-### Checking Specific Resource Status
-
-**Natural Language**: "Is Expanse available?"
-
-**Tool Call**:
-```typescript
-const status = await get_resource_status({
-  resource_id: "expanse.sdsc.xsede.org"
-});
-```
-
-**Returns**: Current operational status:
-- Overall system health
-- Service availability
-- Performance metrics
-- Any active issues or limitations
-
-## API Endpoints
-
-This server connects to the ACCESS-CI Operations API at `https://operations-api.access-ci.org`
-
-## License
+## Resources
 
-MIT
+- `accessci://system-status` - Current operational status of all ACCESS-CI resources

package/dist/__tests__/server.integration.test.js

@@ -8,12 +8,14 @@ describe("SystemStatusServer Integration Tests", () => {
     describe("Real API Integration", () => {
         it("should fetch current outages from real API", async () => {
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "get_current_outages",
-                    arguments: { limit: 5 }
-                }
+                    name: "get_infrastructure_news",
+                    arguments: { time: "current", limit: 5 },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("total_outages");
             expect(responseData).toHaveProperty("affected_resources");
             expect(responseData).toHaveProperty("severity_counts");
@@ -26,18 +28,20 @@ describe("SystemStatusServer Integration Tests", () => {
             if (responseData.outages.length > 0) {
                 const outage = responseData.outages[0];
                 expect(outage).toHaveProperty("severity");
-                expect(outage).toHaveProperty("posted_time");
-                expect(outage).toHaveProperty("last_updated");
+                // The API response includes original fields like Subject, OutageStart, OutageEnd, etc.
+                expect(outage).toHaveProperty("Subject");
             }
         }, 10000);
         it("should fetch scheduled maintenance from real API", async () => {
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "get_scheduled_maintenance",
-                    arguments: { limit: 5 }
-                }
+                    name: "get_infrastructure_news",
+                    arguments: { time: "scheduled", limit: 5 },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("total_scheduled");
             expect(responseData).toHaveProperty("upcoming_24h");
             expect(responseData).toHaveProperty("upcoming_week");
@@ -53,12 +57,14 @@ describe("SystemStatusServer Integration Tests", () => {
         }, 10000);
         it("should fetch past outages from real API", async () => {
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "get_past_outages",
-                    arguments: { limit: 10 }
-                }
+                    name: "get_infrastructure_news",
+                    arguments: { time: "past", limit: 5 },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("total_past_outages");
             expect(responseData).toHaveProperty("recent_outages_30_days");
             expect(responseData).toHaveProperty("affected_resources");
@@ -76,12 +82,14 @@ describe("SystemStatusServer Integration Tests", () => {
         }, 10000);
         it("should get comprehensive system announcements", async () => {
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "get_system_announcements",
-                    arguments: { limit: 20 }
-                }
+                    name: "get_infrastructure_news",
+                    arguments: { time: "all", limit: 20 },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("total_announcements");
             expect(responseData).toHaveProperty("current_outages");
             expect(responseData).toHaveProperty("scheduled_maintenance");
@@ -101,15 +109,17 @@ describe("SystemStatusServer Integration Tests", () => {
         it("should check resource status with direct method", async () => {
             // Test with common resource names that might exist
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "check_resource_status",
+                    name: "get_infrastructure_news",
                     arguments: {
-                        resource_ids: ["anvil", "bridges", "jetstream"],
-                        use_group_api: false
-                    }
-                }
+                        ids: ["anvil", "bridges", "jetstream"],
+                        use_group_api: false,
+                    },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("checked_at");
             expect(responseData).toHaveProperty("resources_checked", 3);
             expect(responseData).toHaveProperty("operational");
@@ -129,15 +139,17 @@ describe("SystemStatusServer Integration Tests", () => {
         it("should test group API functionality", async () => {
             // Test group API with a resource that might have a group ID
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "check_resource_status",
+                    name: "get_infrastructure_news",
                     arguments: {
-                        resource_ids: ["anvil"],
-                        use_group_api: true
-                    }
-                }
+                        ids: ["anvil"],
+                        use_group_api: true,
+                    },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("api_method", "resource_group_api");
             expect(responseData).toHaveProperty("resources_checked", 1);
             expect(responseData.resource_status).toHaveLength(1);
@@ -158,31 +170,36 @@ describe("SystemStatusServer Integration Tests", () => {
         }, 10000);
         it("should filter outages by resource correctly", async () => {
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "get_current_outages",
-                    arguments: { resource_filter: "anvil" }
-                }
+                    name: "get_infrastructure_news",
+                    arguments: { time: "current", query: "anvil" },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("total_outages");
             // If there are any results, they should match the filter
-            responseData.outages.forEach((outage) => {
-                const matchesFilter = outage.Subject?.toLowerCase().includes("anvil") ||
-                    outage.AffectedResources?.some((resource) => resource.ResourceName?.toLowerCase().includes("anvil") ||
-                        resource.ResourceID?.toString().includes("anvil"));
-                expect(matchesFilter).toBe(true);
-            });
+            if (responseData.outages.length > 0) {
+                responseData.outages.forEach((outage) => {
+                    const matchesFilter = outage.Subject?.toLowerCase().includes("anvil") ||
+                        outage.AffectedResources?.some((resource) => resource.ResourceName?.toLowerCase().includes("anvil") ||
+                            resource.ResourceID?.toString().includes("anvil"));
+                    expect(matchesFilter).toBe(true);
+                });
+            }
         }, 10000);
         it("should handle resource reads for all endpoints", async () => {
             const resources = [
                 "accessci://system-status",
                 "accessci://outages/current",
                 "accessci://outages/scheduled",
-                "accessci://outages/past"
+                "accessci://outages/past",
             ];
             for (const uri of resources) {
                 const result = await server["handleResourceRead"]({
-                    params: { uri }
+                    method: "resources/read",
+                    params: { uri },
                 });
                 expect(result.contents).toHaveLength(1);
                 expect(result.contents[0]).toHaveProperty("uri", uri);
@@ -199,24 +216,28 @@ describe("SystemStatusServer Integration Tests", () => {
         it("should handle empty API responses", async () => {
             // This tests the robustness of our logic with potentially empty responses
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "get_current_outages",
-                    arguments: { resource_filter: "nonexistent-resource-xyz" }
-                }
+                    name: "get_infrastructure_news",
+                    arguments: { time: "current", query: "nonexistent-resource-xyz-12345" },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("total_outages", 0);
             expect(responseData.outages).toHaveLength(0);
             expect(responseData.affected_resources).toHaveLength(0);
         }, 10000);
         it("should handle large limit values gracefully", async () => {
             const result = await server["handleToolCall"]({
+                method: "tools/call",
                 params: {
-                    name: "get_past_outages",
-                    arguments: { limit: 1000 }
-                }
+                    name: "get_infrastructure_news",
+                    arguments: { time: "past", limit: 1000 },
+                },
             });
-            const responseData = JSON.parse(result.content[0].text);
+            const content = result.content[0];
+            const responseData = JSON.parse(content.text);
             expect(responseData).toHaveProperty("total_past_outages");
             // Should not crash or timeout
             expect(responseData.outages.length).toBeLessThanOrEqual(1000);