@trentapps/manager-protocol 1.1.1

package/dist/rules/ux.js

@@ -0,0 +1,280 @@
+/**
+ * Enterprise Agent Supervisor - UX Rules
+ *
+ * Built-in rules for ensuring good user experience and interaction patterns.
+ */
+export const uxRules = [
+    // ============================================================================
+    // USER COMMUNICATION RULES
+    // ============================================================================
+    {
+        id: 'ux-001',
+        name: 'Response Length Limit',
+        description: 'Prevents excessively long responses that overwhelm users',
+        type: 'ux',
+        enabled: true,
+        priority: 700,
+        conditions: [
+            { field: 'actionCategory', operator: 'equals', value: 'user_communication' },
+            { field: 'responseLength', operator: 'greater_than', value: 10000 }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Response exceeds 10,000 characters - consider summarizing' }
+        ],
+        riskWeight: 10,
+        tags: ['ux', 'response-length']
+    },
+    {
+        id: 'ux-002',
+        name: 'Jargon Detection',
+        description: 'Warns when technical jargon may confuse non-technical users',
+        type: 'ux',
+        enabled: true,
+        priority: 650,
+        conditions: [
+            { field: 'actionCategory', operator: 'equals', value: 'user_communication' },
+            { field: 'userType', operator: 'equals', value: 'non_technical' },
+            { field: 'technicalTermCount', operator: 'greater_than', value: 5 }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: High technical term count for non-technical user - consider simplifying' }
+        ],
+        riskWeight: 8,
+        tags: ['ux', 'accessibility', 'clarity']
+    },
+    {
+        id: 'ux-003',
+        name: 'Error Message Clarity',
+        description: 'Ensures error messages are user-friendly',
+        type: 'ux',
+        enabled: true,
+        priority: 720,
+        conditions: [
+            { field: 'actionName', operator: 'contains', value: 'error' },
+            { field: 'includesRecoverySteps', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Error messages should include recovery steps for users' }
+        ],
+        riskWeight: 12,
+        tags: ['ux', 'error-handling']
+    },
+    // ============================================================================
+    // INTERACTION PATTERN RULES
+    // ============================================================================
+    {
+        id: 'ux-010',
+        name: 'Confirmation for Destructive Actions',
+        description: 'Requires confirmation before destructive operations',
+        type: 'ux',
+        enabled: true,
+        priority: 850,
+        conditions: [
+            { field: 'operation', operator: 'in', value: ['delete', 'remove', 'purge', 'destroy'] },
+            { field: 'confirmationRequired', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'require_approval', message: 'UX: Destructive actions require user confirmation' }
+        ],
+        riskWeight: 25,
+        tags: ['ux', 'confirmation', 'destructive']
+    },
+    {
+        id: 'ux-011',
+        name: 'Progress Feedback for Long Operations',
+        description: 'Ensures long operations provide progress feedback',
+        type: 'ux',
+        enabled: true,
+        priority: 680,
+        conditions: [
+            { field: 'estimatedDurationMs', operator: 'greater_than', value: 5000 },
+            { field: 'progressCallbackEnabled', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Long operations (>5s) should provide progress feedback' }
+        ],
+        riskWeight: 8,
+        tags: ['ux', 'progress', 'feedback']
+    },
+    {
+        id: 'ux-012',
+        name: 'Undo Support for Modifications',
+        description: 'Recommends undo capability for user modifications',
+        type: 'ux',
+        enabled: true,
+        priority: 660,
+        conditions: [
+            { field: 'actionCategory', operator: 'equals', value: 'data_modification' },
+            { field: 'undoSupported', operator: 'not_equals', value: true },
+            { field: 'userInitiated', operator: 'equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: User-initiated modifications should support undo' }
+        ],
+        riskWeight: 10,
+        tags: ['ux', 'undo', 'reversibility']
+    },
+    // ============================================================================
+    // RATE AND FREQUENCY RULES
+    // ============================================================================
+    {
+        id: 'ux-020',
+        name: 'Notification Frequency Limit',
+        description: 'Prevents notification fatigue',
+        type: 'ux',
+        enabled: true,
+        priority: 750,
+        conditions: [
+            { field: 'actionName', operator: 'contains', value: 'notify' },
+            { field: 'notificationsLastHour', operator: 'greater_than', value: 10 }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'rate_limit', message: 'UX: Notification frequency exceeds limit - batching recommended' }
+        ],
+        riskWeight: 15,
+        tags: ['ux', 'notifications', 'rate-limit']
+    },
+    {
+        id: 'ux-021',
+        name: 'Prompt Frequency Control',
+        description: 'Limits how often users are interrupted with prompts',
+        type: 'ux',
+        enabled: true,
+        priority: 730,
+        conditions: [
+            { field: 'actionName', operator: 'contains', value: 'prompt' },
+            { field: 'promptsLastMinute', operator: 'greater_than', value: 3 }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Too many prompts - consider consolidating interactions' }
+        ],
+        riskWeight: 12,
+        tags: ['ux', 'prompts', 'interruption']
+    },
+    // ============================================================================
+    // ACCESSIBILITY RULES
+    // ============================================================================
+    {
+        id: 'ux-030',
+        name: 'Alt Text for Images',
+        description: 'Ensures images have accessibility text',
+        type: 'ux',
+        enabled: true,
+        priority: 780,
+        conditions: [
+            { field: 'contentType', operator: 'contains', value: 'image' },
+            { field: 'altText', operator: 'not_exists', value: null }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Images should include alt text for accessibility' }
+        ],
+        riskWeight: 10,
+        tags: ['ux', 'accessibility', 'wcag']
+    },
+    {
+        id: 'ux-031',
+        name: 'Color Contrast Check',
+        description: 'Warns about potential color contrast issues',
+        type: 'ux',
+        enabled: true,
+        priority: 760,
+        conditions: [
+            { field: 'actionCategory', operator: 'equals', value: 'user_communication' },
+            { field: 'hasColorContent', operator: 'equals', value: true },
+            { field: 'contrastRatioMet', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Color content may not meet WCAG contrast requirements' }
+        ],
+        riskWeight: 8,
+        tags: ['ux', 'accessibility', 'wcag', 'contrast']
+    },
+    {
+        id: 'ux-032',
+        name: 'Keyboard Navigation Support',
+        description: 'Ensures interactive elements support keyboard navigation',
+        type: 'ux',
+        enabled: true,
+        priority: 770,
+        conditions: [
+            { field: 'actionName', operator: 'contains', value: 'interactive' },
+            { field: 'keyboardAccessible', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Interactive elements should support keyboard navigation' }
+        ],
+        riskWeight: 12,
+        tags: ['ux', 'accessibility', 'keyboard']
+    },
+    // ============================================================================
+    // CONTENT QUALITY RULES
+    // ============================================================================
+    {
+        id: 'ux-040',
+        name: 'Empty State Handling',
+        description: 'Ensures empty states have helpful content',
+        type: 'ux',
+        enabled: true,
+        priority: 690,
+        conditions: [
+            { field: 'actionName', operator: 'contains', value: 'display' },
+            { field: 'resultCount', operator: 'equals', value: 0 },
+            { field: 'emptyStateMessage', operator: 'not_exists', value: null }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Empty states should include helpful guidance for users' }
+        ],
+        riskWeight: 6,
+        tags: ['ux', 'empty-state', 'guidance']
+    },
+    {
+        id: 'ux-041',
+        name: 'Loading State Communication',
+        description: 'Ensures async operations communicate loading state',
+        type: 'ux',
+        enabled: true,
+        priority: 700,
+        conditions: [
+            { field: 'isAsync', operator: 'equals', value: true },
+            { field: 'loadingIndicatorEnabled', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Async operations should display loading state to users' }
+        ],
+        riskWeight: 8,
+        tags: ['ux', 'loading', 'feedback']
+    },
+    {
+        id: 'ux-042',
+        name: 'Timeout Communication',
+        description: 'Ensures timeouts are communicated clearly to users',
+        type: 'ux',
+        enabled: true,
+        priority: 710,
+        conditions: [
+            { field: 'hasTimeout', operator: 'equals', value: true },
+            { field: 'timeoutWarningEnabled', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'UX: Sessions with timeouts should warn users before expiry' }
+        ],
+        riskWeight: 10,
+        tags: ['ux', 'timeout', 'session']
+    }
+];
+export default uxRules;
+//# sourceMappingURL=ux.js.map

package/dist/rules/ux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ux.js","sourceRoot":"","sources":["../../src/rules/ux.ts"],"names":[],"mappings":"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"}

package/dist/rules/websocket.d.ts

@@ -0,0 +1,7 @@
+/**
+ * WebSocket & Real-Time Communication Rules
+ * Governance rules for WebSocket, Socket.IO, and real-time connections
+ */
+import type { BusinessRule } from '../types/index.js';
+export declare const websocketRules: BusinessRule[];
+//# sourceMappingURL=websocket.d.ts.map

package/dist/rules/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/rules/websocket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,cAAc,EAAE,YAAY,EAkIxC,CAAC"}

package/dist/rules/websocket.js

@@ -0,0 +1,136 @@
+/**
+ * WebSocket & Real-Time Communication Rules
+ * Governance rules for WebSocket, Socket.IO, and real-time connections
+ */
+export const websocketRules = [
+    {
+        id: 'ws-001',
+        name: 'Require WebSocket Authentication',
+        description: 'WebSocket connections must authenticate before upgrade',
+        type: 'security',
+        enabled: true,
+        priority: 970,
+        conditions: [
+            { field: 'actionCategory', operator: 'equals', value: 'network' },
+            { field: 'protocol', operator: 'in', value: ['websocket', 'socket.io'] },
+            { field: 'authenticated', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'deny', message: 'WebSocket connections require authentication before upgrade' }
+        ],
+        riskWeight: 60,
+        tags: ['websocket', 'socket.io', 'security', 'authentication']
+    },
+    {
+        id: 'ws-002',
+        name: 'Enforce Message Rate Limiting',
+        description: 'WebSocket messages must be rate limited per connection',
+        type: 'security',
+        enabled: true,
+        priority: 920,
+        conditions: [
+            { field: 'protocol', operator: 'in', value: ['websocket', 'socket.io'] },
+            { field: 'messageRateLimitEnabled', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'Implement message rate limiting to prevent flood attacks (e.g., 100 msg/min)' }
+        ],
+        riskWeight: 40,
+        tags: ['websocket', 'rate-limiting', 'dos', 'security']
+    },
+    {
+        id: 'ws-003',
+        name: 'Validate Binary Message Size',
+        description: 'Binary WebSocket messages must have size limits',
+        type: 'security',
+        enabled: true,
+        priority: 900,
+        conditions: [
+            { field: 'protocol', operator: 'in', value: ['websocket', 'socket.io'] },
+            { field: 'messageType', operator: 'equals', value: 'binary' },
+            { field: 'maxMessageSize', operator: 'not_exists', value: null }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'Set maximum binary message size to prevent memory exhaustion' }
+        ],
+        riskWeight: 35,
+        tags: ['websocket', 'binary', 'validation', 'dos']
+    },
+    {
+        id: 'ws-004',
+        name: 'Require Connection Heartbeat',
+        description: 'WebSocket connections should implement ping/pong heartbeat',
+        type: 'architecture',
+        enabled: true,
+        priority: 850,
+        conditions: [
+            { field: 'protocol', operator: 'in', value: ['websocket', 'socket.io'] },
+            { field: 'heartbeatEnabled', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'Implement heartbeat (ping/pong) to detect dead connections' }
+        ],
+        riskWeight: 25,
+        tags: ['websocket', 'heartbeat', 'connection-health']
+    },
+    {
+        id: 'ws-005',
+        name: 'Limit Concurrent Connections',
+        description: 'Limit concurrent WebSocket connections per user',
+        type: 'operational',
+        enabled: true,
+        priority: 880,
+        conditions: [
+            { field: 'protocol', operator: 'in', value: ['websocket', 'socket.io'] },
+            { field: 'concurrentConnections', operator: 'greater_than', value: 10 }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'User has >10 concurrent WebSocket connections - possible abuse or leaked connections' }
+        ],
+        riskWeight: 30,
+        tags: ['websocket', 'limits', 'abuse-prevention']
+    },
+    {
+        id: 'ws-006',
+        name: 'Validate Message Schema',
+        description: 'WebSocket messages should be validated against schema',
+        type: 'security',
+        enabled: true,
+        priority: 860,
+        conditions: [
+            { field: 'protocol', operator: 'in', value: ['websocket', 'socket.io'] },
+            { field: 'messageValidation', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'warn', message: 'Validate WebSocket message structure/schema to prevent injection attacks' }
+        ],
+        riskWeight: 35,
+        tags: ['websocket', 'validation', 'security']
+    },
+    {
+        id: 'ws-007',
+        name: 'WebSocket TLS Requirement',
+        description: 'Production WebSocket connections must use TLS (wss://)',
+        type: 'security',
+        enabled: true,
+        priority: 950,
+        conditions: [
+            { field: 'protocol', operator: 'in', value: ['websocket', 'socket.io'] },
+            { field: 'environment', operator: 'equals', value: 'production' },
+            { field: 'tlsEnabled', operator: 'not_equals', value: true }
+        ],
+        conditionLogic: 'all',
+        actions: [
+            { type: 'deny', message: 'Production WebSocket connections must use wss:// (TLS encrypted)' }
+        ],
+        riskWeight: 55,
+        tags: ['websocket', 'tls', 'encryption', 'security']
+    }
+];
+//# sourceMappingURL=websocket.js.map

package/dist/rules/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/rules/websocket.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Enterprise Agent Supervisor - MCP Server
+ *
+ * Model Context Protocol server exposing agent governance tools.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+declare const server: Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        task?: {
+            [x: string]: unknown;
+            ttl?: number | null | undefined;
+            pollInterval?: number | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        "io.modelcontextprotocol/related-task"?: {
+            [x: string]: unknown;
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+export { server };
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAs8CnE,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWX,CAAC;AAwgCF,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}