vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1642

package/src/agents/AgentStatus.js

@@ -0,0 +1,183 @@
+/**
+ * Agent Status Enumeration
+ * 
+ * Defines possible states for agent installation and verification.
+ * Follows constitutional requirements: <555 lines, test-first approach.
+ */
+
+/**
+ * Agent status enumeration
+ * These represent the lifecycle states of an AI agent
+ */
+const AgentStatus = {
+  // Agent not detected on system
+  NOT_INSTALLED: 'NOT_INSTALLED',
+  
+  // Installation in progress
+  INSTALLING: 'INSTALLING',
+  
+  // Agent detected but not verified
+  INSTALLED: 'INSTALLED',
+  
+  // Verification test in progress
+  VERIFYING: 'VERIFYING',
+  
+  // Agent installed and verified as functional
+  VERIFIED: 'VERIFIED',
+  
+  // Installation or verification failed
+  ERROR: 'ERROR',
+  
+  // Agent functional but rate limited
+  RATE_LIMITED: 'RATE_LIMITED',
+  
+  // Agent disabled by user (not checked)
+  DISABLED: 'DISABLED'
+};
+
+/**
+ * Check if status is a terminal state (no further transitions possible)
+ * @param {string} status - Status to check
+ * @returns {boolean}
+ */
+function isTerminalStatus(status) {
+  return [
+    AgentStatus.VERIFIED,
+    AgentStatus.ERROR,
+    AgentStatus.DISABLED
+  ].includes(status);
+}
+
+/**
+ * Check if status represents an error state
+ * @param {string} status - Status to check
+ * @returns {boolean}
+ */
+function isErrorStatus(status) {
+  return status === AgentStatus.ERROR;
+}
+
+/**
+ * Check if status represents a working/functional state
+ * @param {string} status - Status to check
+ * @returns {boolean}
+ */
+function isWorkingStatus(status) {
+  return [
+    AgentStatus.INSTALLING,
+    AgentStatus.INSTALLED,
+    AgentStatus.VERIFYING,
+    AgentStatus.VERIFIED,
+    AgentStatus.RATE_LIMITED
+  ].includes(status);
+}
+
+/**
+ * Check if status allows checking operations
+ * @param {string} status - Status to check
+ * @returns {boolean}
+ */
+function allowsChecking(status) {
+  return status !== AgentStatus.DISABLED;
+}
+
+/**
+ * Get valid next statuses from current status
+ * @param {string} currentStatus - Current status
+ * @returns {string[]} - Array of possible next statuses
+ */
+function getNextValidStatuses(currentStatus) {
+  const transitions = {
+    [AgentStatus.NOT_INSTALLED]: [AgentStatus.INSTALLING, AgentStatus.ERROR],
+    [AgentStatus.INSTALLING]: [AgentStatus.INSTALLED, AgentStatus.ERROR],
+    [AgentStatus.INSTALLED]: [AgentStatus.VERIFYING, AgentStatus.ERROR],
+    [AgentStatus.VERIFYING]: [AgentStatus.VERIFIED, AgentStatus.ERROR, AgentStatus.RATE_LIMITED],
+    [AgentStatus.VERIFIED]: [AgentStatus.ERROR, AgentStatus.RATE_LIMITED], // Can degrade
+    [AgentStatus.ERROR]: [AgentStatus.NOT_INSTALLED, AgentStatus.INSTALLING], // Can retry
+    [AgentStatus.RATE_LIMITED]: [AgentStatus.VERIFIED, AgentStatus.ERROR], // Can recover or fail
+    [AgentStatus.DISABLED]: [] // No transitions from disabled
+  };
+
+  return transitions[currentStatus] || [];
+}
+
+/**
+ * Validate status transition
+ * @param {string} fromStatus - Current status
+ * @param {string} toStatus - Target status
+ * @returns {boolean} - True if transition is valid
+ */
+function isValidTransition(fromStatus, toStatus) {
+  return getNextValidStatuses(fromStatus).includes(toStatus);
+}
+
+/**
+ * Get status description for user display
+ * @param {string} status - Status to describe
+ * @returns {string} - Human-readable description
+ */
+function getStatusDescription(status) {
+  const descriptions = {
+    [AgentStatus.NOT_INSTALLED]: 'Not installed',
+    [AgentStatus.INSTALLING]: 'Installing...',
+    [AgentStatus.INSTALLED]: 'Installed (not verified)',
+    [AgentStatus.VERIFYING]: 'Verifying...',
+    [AgentStatus.VERIFIED]: 'Verified and ready',
+    [AgentStatus.ERROR]: 'Error occurred',
+    [AgentStatus.RATE_LIMITED]: 'Rate limited',
+    [AgentStatus.DISABLED]: 'Disabled'
+  };
+
+  return descriptions[status] || 'Unknown status';
+}
+
+/**
+ * Get all possible statuses
+ * @returns {string[]} - Array of all status values
+ */
+function getAllStatuses() {
+  return Object.values(AgentStatus);
+}
+
+/**
+ * Check if a value is a valid AgentStatus
+ * @param {string} status - Status to validate
+ * @returns {boolean} - True if valid
+ */
+function isValidStatus(status) {
+  return getAllStatuses().includes(status);
+}
+
+/**
+ * Get status priority for sorting (higher numbers = higher priority)
+ * @param {string} status - Status to get priority for
+ * @returns {number} - Priority value
+ */
+function getStatusPriority(status) {
+  const priorities = {
+    [AgentStatus.ERROR]: 100, // Highest priority for attention
+    [AgentStatus.INSTALLING]: 90,
+    [AgentStatus.VERIFYING]: 80,
+    [AgentStatus.NOT_INSTALLED]: 70,
+    [AgentStatus.RATE_LIMITED]: 60,
+    [AgentStatus.INSTALLED]: 50,
+    [AgentStatus.VERIFIED]: 10, // Lowest priority (working well)
+    [AgentStatus.DISABLED]: 0  // Ignore disabled
+  };
+
+  return priorities[status] || 0;
+}
+
+module.exports = {
+  AgentStatus,
+  isTerminalStatus,
+  isErrorStatus,
+  isWorkingStatus,
+  allowsChecking,
+  getNextValidStatuses,
+  isValidTransition,
+  getStatusDescription,
+  getAllStatuses,
+  isValidStatus,
+  getStatusPriority
+};