@trentapps/manager-protocol 1.1.3 → 1.2.1

package/dist/utils/shared.js

@@ -0,0 +1,464 @@
+/**
+ * Enterprise Agent Supervisor - Shared Utilities
+ *
+ * Common utility functions used across the codebase.
+ * Extracted from various modules to reduce duplication and ensure consistency.
+ *
+ * Tasks: #40, #41, #42, #48
+ */
+// ============================================================================
+// HASH UTILITIES (#42)
+// ============================================================================
+/**
+ * Simple string hash function for generating IDs.
+ * Uses a fast, non-cryptographic hash algorithm (djb2 variant).
+ *
+ * @param str - The string to hash
+ * @param options - Optional configuration
+ * @returns Hexadecimal hash string (default) or base36 string
+ *
+ * @example
+ * ```typescript
+ * hashString('hello world'); // Returns: 'a3e45bc1'
+ * hashString('hello world', { base: 36 }); // Returns: 'x7k2m'
+ * hashString('hello world', { length: 16 }); // Returns: '00000000a3e45bc1'
+ * ```
+ */
+export function hashString(str, options = {}) {
+    const { base = 16, length = 8 } = options;
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    const result = Math.abs(hash).toString(base);
+    return result.substring(0, length);
+}
+/**
+ * Common time window durations
+ */
+export const TimeWindows = {
+    /** 1 hour in milliseconds */
+    HOUR: 60 * 60 * 1000,
+    /** 24 hours in milliseconds */
+    DAY: 24 * 60 * 60 * 1000,
+    /** 7 days in milliseconds */
+    WEEK: 7 * 24 * 60 * 60 * 1000,
+    /** 30 days in milliseconds */
+    MONTH: 30 * 24 * 60 * 60 * 1000,
+};
+/**
+ * Create a time window for filtering data.
+ *
+ * @param options - Time window options
+ * @returns TimeWindowResult with start/end times and contains() function
+ *
+ * @example
+ * ```typescript
+ * // Last 24 hours
+ * const window = createTimeWindow();
+ *
+ * // Last hour
+ * const hourWindow = createTimeWindow({ durationMs: TimeWindows.HOUR });
+ *
+ * // Check if a timestamp is in the window
+ * if (window.contains(event.timestamp)) {
+ *   // Event is within the time window
+ * }
+ * ```
+ */
+export function createTimeWindow(options = {}) {
+    const { durationMs = TimeWindows.DAY, referenceTime = Date.now() } = options;
+    const endMs = referenceTime;
+    const startMs = endMs - durationMs;
+    return {
+        start: new Date(startMs).toISOString(),
+        end: new Date(endMs).toISOString(),
+        startMs,
+        endMs,
+        contains: (timestamp) => {
+            const ts = typeof timestamp === 'string'
+                ? new Date(timestamp).getTime()
+                : timestamp instanceof Date
+                    ? timestamp.getTime()
+                    : timestamp;
+            return ts >= startMs && ts <= endMs;
+        }
+    };
+}
+/**
+ * Check if a window has expired based on start time and duration.
+ * Uses >= comparison for consistency (window expires AT the boundary).
+ *
+ * @param windowStart - Window start timestamp in milliseconds
+ * @param windowMs - Window duration in milliseconds
+ * @param now - Current time (defaults to Date.now())
+ * @returns true if the window has expired
+ *
+ * @example
+ * ```typescript
+ * if (isWindowExpired(bucket.windowStart, config.windowMs)) {
+ *   // Reset the window
+ *   bucket.count = 0;
+ *   bucket.windowStart = Date.now();
+ * }
+ * ```
+ */
+export function isWindowExpired(windowStart, windowMs, now = Date.now()) {
+    return now - windowStart >= windowMs;
+}
+/**
+ * Calculate the reset time for a window.
+ *
+ * @param windowStart - Window start timestamp in milliseconds
+ * @param windowMs - Window duration in milliseconds
+ * @returns Date object for when the window resets
+ */
+export function getWindowResetTime(windowStart, windowMs) {
+    return new Date(windowStart + windowMs);
+}
+/**
+ * Calculate aggregate metrics from an array of data items.
+ *
+ * @param items - Array of items to analyze
+ * @param valueExtractor - Function to extract numeric value from each item
+ * @param options - Configuration options
+ * @returns Aggregated metrics
+ *
+ * @example
+ * ```typescript
+ * const activities = [
+ *   { tokensUsed: 100, timestamp: '2024-01-01T00:00:00Z', outcome: 'success' },
+ *   { tokensUsed: 200, timestamp: '2024-01-01T01:00:00Z', outcome: 'failure' },
+ * ];
+ *
+ * const metrics = calculateMetrics(
+ *   activities,
+ *   item => item.tokensUsed,
+ *   {
+ *     timestampField: 'timestamp',
+ *     outcomeField: 'outcome',
+ *     failureValue: 'failure'
+ *   }
+ * );
+ * // Returns: { total: 300, count: 2, average: 150, min: 100, max: 200, ... }
+ * ```
+ */
+export function calculateMetrics(items, valueExtractor, options = {}) {
+    const { timestampField = 'timestamp', outcomeField = 'outcome', failureValue = 'failure', include24h = true } = options;
+    const now = Date.now();
+    const last24h = now - TimeWindows.DAY;
+    let total = 0;
+    let count = 0;
+    let min = Infinity;
+    let max = -Infinity;
+    let errorCount = 0;
+    let total24h = 0;
+    let count24h = 0;
+    let errors24h = 0;
+    for (const item of items) {
+        const value = valueExtractor(item);
+        const timestamp = item[timestampField];
+        const outcome = item[outcomeField];
+        const isRecent = include24h && timestamp
+            ? new Date(timestamp).getTime() > last24h
+            : false;
+        // Count all items for error rate calculation
+        count++;
+        if (isRecent)
+            count24h++;
+        // Track failures
+        if (outcome === failureValue) {
+            errorCount++;
+            if (isRecent)
+                errors24h++;
+        }
+        // Aggregate numeric values (skip undefined)
+        if (value !== undefined && value !== null) {
+            total += value;
+            if (value < min)
+                min = value;
+            if (value > max)
+                max = value;
+            if (isRecent)
+                total24h += value;
+        }
+    }
+    // Handle edge cases
+    if (min === Infinity)
+        min = 0;
+    if (max === -Infinity)
+        max = 0;
+    const result = {
+        total,
+        count,
+        average: count > 0 ? total / count : 0,
+        min,
+        max,
+        errorCount,
+        errorRate: count > 0 ? errorCount / count : 0
+    };
+    if (include24h) {
+        result.last24h = {
+            total: total24h,
+            count: count24h,
+            errors: errors24h
+        };
+    }
+    return result;
+}
+/**
+ * Calculate grouped metrics (e.g., by category, by type).
+ *
+ * @param items - Array of items to analyze
+ * @param groupExtractor - Function to extract group key from each item
+ * @returns Map of group key to count
+ *
+ * @example
+ * ```typescript
+ * const events = [
+ *   { eventType: 'action_evaluated' },
+ *   { eventType: 'action_approved' },
+ *   { eventType: 'action_evaluated' },
+ * ];
+ *
+ * const byType = calculateGroupedCounts(events, e => e.eventType);
+ * // Returns: { 'action_evaluated': 2, 'action_approved': 1 }
+ * ```
+ */
+export function calculateGroupedCounts(items, groupExtractor) {
+    const groups = {};
+    for (const item of items) {
+        const group = groupExtractor(item);
+        if (group !== undefined) {
+            groups[group] = (groups[group] || 0) + 1;
+        }
+    }
+    return groups;
+}
+/**
+ * Get top N items from a count record.
+ *
+ * @param counts - Record of key to count
+ * @param limit - Maximum number of items to return
+ * @returns Array of { key, count } sorted by count descending
+ */
+export function getTopCounts(counts, limit = 5) {
+    return Object.entries(counts)
+        .map(([key, count]) => ({ key, count }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, limit);
+}
+/**
+ * Collection of common input validators.
+ *
+ * Each validator returns { valid: true } or { valid: false, error: 'message' }
+ */
+export const validators = {
+    /**
+     * Validate email format
+     *
+     * @example
+     * ```typescript
+     * validators.email('user@example.com'); // { valid: true }
+     * validators.email('invalid'); // { valid: false, error: '...' }
+     * ```
+     */
+    email(value) {
+        if (!value || typeof value !== 'string') {
+            return { valid: false, error: 'Email is required' };
+        }
+        // RFC 5322 simplified regex
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        if (!emailRegex.test(value)) {
+            return { valid: false, error: 'Invalid email format' };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate URL format
+     *
+     * @example
+     * ```typescript
+     * validators.url('https://example.com'); // { valid: true }
+     * validators.url('not-a-url'); // { valid: false, error: '...' }
+     * ```
+     */
+    url(value, options = {}) {
+        if (!value || typeof value !== 'string') {
+            return { valid: false, error: 'URL is required' };
+        }
+        try {
+            const url = new URL(value);
+            if (options.requireHttps && url.protocol !== 'https:') {
+                return { valid: false, error: 'URL must use HTTPS' };
+            }
+            return { valid: true };
+        }
+        catch {
+            return { valid: false, error: 'Invalid URL format' };
+        }
+    },
+    /**
+     * Validate file path (basic validation, no traversal attacks)
+     *
+     * @example
+     * ```typescript
+     * validators.path('/valid/path'); // { valid: true }
+     * validators.path('../traversal'); // { valid: false, error: '...' }
+     * ```
+     */
+    path(value, options = {}) {
+        if (!value || typeof value !== 'string') {
+            return { valid: false, error: 'Path is required' };
+        }
+        // Check for path traversal attempts
+        if (value.includes('..')) {
+            return { valid: false, error: 'Path traversal not allowed' };
+        }
+        // Check for null bytes
+        if (value.includes('\0')) {
+            return { valid: false, error: 'Invalid characters in path' };
+        }
+        // Check if absolute path is required
+        if (!options.allowRelative && !value.startsWith('/')) {
+            return { valid: false, error: 'Path must be absolute' };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate that a string is non-empty
+     */
+    nonEmpty(value, fieldName = 'Value') {
+        if (!value || typeof value !== 'string' || value.trim().length === 0) {
+            return { valid: false, error: `${fieldName} cannot be empty` };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate string length
+     */
+    length(value, options = {}) {
+        const { min = 0, max = Infinity, fieldName = 'Value' } = options;
+        if (!value || typeof value !== 'string') {
+            return { valid: false, error: `${fieldName} is required` };
+        }
+        if (value.length < min) {
+            return { valid: false, error: `${fieldName} must be at least ${min} characters` };
+        }
+        if (value.length > max) {
+            return { valid: false, error: `${fieldName} must be at most ${max} characters` };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate number within range
+     */
+    numberRange(value, options = {}) {
+        const { min = -Infinity, max = Infinity, fieldName = 'Value' } = options;
+        if (value === undefined || value === null || typeof value !== 'number' || isNaN(value)) {
+            return { valid: false, error: `${fieldName} must be a number` };
+        }
+        if (value < min) {
+            return { valid: false, error: `${fieldName} must be at least ${min}` };
+        }
+        if (value > max) {
+            return { valid: false, error: `${fieldName} must be at most ${max}` };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate port number
+     */
+    port(value) {
+        return validators.numberRange(value, {
+            min: 1,
+            max: 65535,
+            fieldName: 'Port'
+        });
+    },
+    /**
+     * Validate identifier (alphanumeric with dashes/underscores)
+     */
+    identifier(value, fieldName = 'Identifier') {
+        if (!value || typeof value !== 'string') {
+            return { valid: false, error: `${fieldName} is required` };
+        }
+        const idRegex = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+        if (!idRegex.test(value)) {
+            return {
+                valid: false,
+                error: `${fieldName} must start with a letter and contain only letters, numbers, dashes, and underscores`
+            };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate enum value
+     */
+    enum(value, allowedValues, fieldName = 'Value') {
+        if (!allowedValues.includes(value)) {
+            return {
+                valid: false,
+                error: `${fieldName} must be one of: ${allowedValues.join(', ')}`
+            };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate ISO date string
+     */
+    isoDate(value) {
+        if (!value || typeof value !== 'string') {
+            return { valid: false, error: 'Date is required' };
+        }
+        const date = new Date(value);
+        if (isNaN(date.getTime())) {
+            return { valid: false, error: 'Invalid date format' };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate GitHub repository format (owner/repo)
+     */
+    githubRepo(value) {
+        if (!value || typeof value !== 'string') {
+            return { valid: false, error: 'Repository is required' };
+        }
+        const repoRegex = /^[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/;
+        if (!repoRegex.test(value)) {
+            return { valid: false, error: 'Repository must be in format: owner/repo' };
+        }
+        return { valid: true };
+    },
+    /**
+     * Compose multiple validators (all must pass)
+     */
+    all(...validations) {
+        for (const validation of validations) {
+            if (!validation.valid) {
+                return validation;
+            }
+        }
+        return { valid: true };
+    }
+};
+/**
+ * Helper to run validation and throw on failure
+ *
+ * @example
+ * ```typescript
+ * assertValid(validators.email(userEmail), 'email');
+ * // Throws if invalid: "Validation failed for email: Invalid email format"
+ * ```
+ */
+export function assertValid(result, context) {
+    if (!result.valid) {
+        const message = context
+            ? `Validation failed for ${context}: ${result.error}`
+            : `Validation failed: ${result.error}`;
+        throw new Error(message);
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/utils/shared.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trentapps/manager-protocol",
-  "version": "1.1.3",
+  "version": "1.2.1",
   "description": "Enterprise Agent Supervisor - Rules Engine MCP Server for AI Agent Governance",
   "type": "module",
   "main": "dist/index.js",
@@ -35,6 +35,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@octokit/rest": "^22.0.1",
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^12.5.0",
     "uuid": "^9.0.1",
@@ -51,7 +52,7 @@
     "prettier": "^3.1.1",
     "tsx": "^4.6.2",
     "typescript": "^5.3.2",
-    "vitest": "^1.0.4"
+    "vitest": "^4.0.17"
   },
   "engines": {
     "node": ">=18.0.0"