agileflow 3.2.1 → 3.4.0

package/scripts/lib/tmux-group-colors.js

@@ -0,0 +1,113 @@
+/**
+ * tmux-group-colors.js - Color palette for tmux tab groups
+ *
+ * Provides a curated palette of 8 colors optimized for dark terminal
+ * backgrounds (Tokyo Night compatible). Supports color assignment by
+ * audit type and random selection with avoidance of in-use colors.
+ *
+ * Usage:
+ *   const { getColorForAudit, pickGroupColor } = require('./tmux-group-colors');
+ *   const color = getColorForAudit('security');  // '#f7768e'
+ *   const random = pickGroupColor(['#f7768e']);   // random excluding coral
+ */
+
+/**
+ * Curated palette for dark backgrounds.
+ * Each color has sufficient contrast against #1a1b26 (Tokyo Night bg)
+ * and #2d2f3a (tab bg).
+ */
+const GROUP_PALETTE = [
+  { name: 'coral', hex: '#f7768e', audit: 'security' },
+  { name: 'sky', hex: '#7aa2f7', audit: 'logic' },
+  { name: 'mint', hex: '#73daca', audit: 'performance' },
+  { name: 'amber', hex: '#e0af68', audit: 'test' },
+  { name: 'violet', hex: '#bb9af7', audit: 'completeness' },
+  { name: 'lime', hex: '#9ece6a', audit: 'legal' },
+  { name: 'rose', hex: '#ff9e64', audit: null },
+  { name: 'ice', hex: '#89ddff', audit: null },
+];
+
+/**
+ * Map audit type to its assigned color.
+ */
+const AUDIT_COLOR_MAP = {};
+for (const entry of GROUP_PALETTE) {
+  if (entry.audit) {
+    AUDIT_COLOR_MAP[entry.audit] = entry.hex;
+  }
+}
+
+/**
+ * Get the assigned color for an audit type.
+ *
+ * @param {string} auditType - Audit type key (security, logic, etc.)
+ * @returns {string} Hex color string
+ */
+function getColorForAudit(auditType) {
+  return AUDIT_COLOR_MAP[auditType] || pickGroupColor([]);
+}
+
+/**
+ * Pick a group color, avoiding colors currently in use.
+ *
+ * @param {string[]} [inUseColors] - Array of hex colors currently in use
+ * @returns {string} Hex color string not in the in-use list
+ */
+function pickGroupColor(inUseColors) {
+  const avoid = new Set((inUseColors || []).map(c => c.toLowerCase()));
+  const available = GROUP_PALETTE.filter(entry => !avoid.has(entry.hex.toLowerCase()));
+
+  if (available.length === 0) {
+    // All colors in use, pick first from full palette
+    return GROUP_PALETTE[0].hex;
+  }
+
+  // Deterministic pick: first available for consistency
+  return available[0].hex;
+}
+
+/**
+ * Get a palette entry by name.
+ *
+ * @param {string} name - Color name (e.g. 'coral', 'sky')
+ * @returns {object|null} Palette entry or null
+ */
+function getColorByName(name) {
+  return GROUP_PALETTE.find(entry => entry.name === name) || null;
+}
+
+/**
+ * Build tmux window format string with group color.
+ *
+ * @param {string} groupColor - Hex color for the group
+ * @param {string} prefix - Short prefix (e.g. 'Sec', 'Logic')
+ * @param {boolean} [isActive=false] - Whether this is the active window
+ * @returns {string} tmux format string
+ */
+function buildGroupWindowFormat(groupColor, prefix, isActive) {
+  if (isActive) {
+    // Active: colored bg for index, dark bg for name
+    return `#[fg=#1a1b26 bg=${groupColor} bold] #I #[fg=${groupColor} bg=#2d2f3a]#[fg=#e0e0e0] ${prefix}:#{window_name} #[bg=#1a1b26 fg=#2d2f3a]`;
+  }
+  // Inactive: colored dot prefix + gray text
+  return `#[fg=${groupColor}]#[fg=#8a8a8a] #I:${prefix}:#{window_name} `;
+}
+
+/**
+ * Get all palette colors.
+ *
+ * @returns {Array<{ name: string, hex: string, audit: string|null }>}
+ */
+function getAllColors() {
+  return [...GROUP_PALETTE];
+}
+
+module.exports = {
+  GROUP_PALETTE,
+  AUDIT_COLOR_MAP,
+  getColorForAudit,
+  pickGroupColor,
+  getColorByName,
+  buildGroupWindowFormat,
+  getAllColors,
+};

package/scripts/messaging-bridge.js

@@ -49,6 +49,18 @@ function getFeatureFlags() {
   return _featureFlags;
 }
 
+let _teamEvents;
+function getTeamEvents() {
+  if (!_teamEvents) {
+    try {
+      _teamEvents = require('./lib/team-events');
+    } catch (e) {
+      return null;
+    }
+  }
+  return _teamEvents;
+}
+
 let _busUtils;
 function getBusUtils() {
   if (!_busUtils) {
@@ -277,6 +289,168 @@ function sendPlanDecision(rootDir, from, to, taskId, approved, reason, traceId)
   return sendMessage(rootDir, msg);
 }
 
+/**
+ * Send an inter-agent team message to the JSONL bus.
+ * Logs communication between teammates with optional trace_id for correlation.
+ *
+ * @param {string} rootDir - Project root
+ * @param {string} from - Sending agent name
+ * @param {string} to - Receiving agent name
+ * @param {string} content - Message content
+ * @param {string} [traceId] - Trace ID for team lifecycle correlation
+ * @returns {{ ok: boolean, native?: boolean }}
+ */
+function sendTeamMessage(rootDir, from, to, content, traceId) {
+  const msg = { from, to, type: 'team_message', content };
+  if (traceId) msg.trace_id = traceId;
+  const result = sendMessage(rootDir, msg);
+
+  // Always track in session-state for observability parity (both native and subagent modes)
+  try {
+    const teamEvents = getTeamEvents();
+    if (teamEvents) {
+      teamEvents.trackEvent(rootDir, 'team_message', {
+        from,
+        to,
+        trace_id: traceId,
+      });
+    }
+  } catch (e) {
+    // Non-critical
+  }
+
+  return result;
+}
+
+/**
+ * Send a team_completed event to the JSONL bus.
+ * Signals that a team run has finished all work.
+ *
+ * @param {string} rootDir - Project root
+ * @param {string} templateName - Team template name
+ * @param {string} [traceId] - Trace ID for team lifecycle correlation
+ * @param {object} [summary] - Optional summary data (duration_ms, tasks_completed, etc.)
+ * @returns {{ ok: boolean, native?: boolean }}
+ */
+function sendTeamCompleted(rootDir, templateName, traceId, summary) {
+  const msg = {
+    from: 'team-manager',
+    to: 'system',
+    type: 'team_completed',
+    template: templateName,
+    ...summary,
+  };
+  if (traceId) msg.trace_id = traceId;
+  return sendMessage(rootDir, msg);
+}
+
+/**
+ * Log a native SendMessage tool call to the JSONL bus.
+ * Used by agents to record native API calls for observability parity.
+ *
+ * @param {string} rootDir - Project root
+ * @param {string} from - Sending agent name
+ * @param {string} to - Receiving agent name
+ * @param {string} content - Message content
+ * @param {string} [traceId] - Trace ID for correlation
+ * @returns {{ ok: boolean }}
+ */
+function logNativeSend(rootDir, from, to, content, traceId) {
+  const msg = { from, to, type: 'native_send', content };
+  if (traceId) msg.trace_id = traceId;
+  const result = sendMessage(rootDir, msg);
+
+  try {
+    const teamEvents = getTeamEvents();
+    if (teamEvents) {
+      teamEvents.trackEvent(rootDir, 'team_message', {
+        from,
+        to,
+        trace_id: traceId,
+        native: true,
+      });
+    }
+  } catch (e) {
+    // Non-critical
+  }
+
+  return { ok: result.ok };
+}
+
+/**
+ * Log a native TeamCreate tool call to the JSONL bus.
+ *
+ * @param {string} rootDir - Project root
+ * @param {string} templateName - Team template name
+ * @param {string} [traceId] - Trace ID for correlation
+ * @param {number} [teammateCount] - Number of teammates created
+ * @returns {{ ok: boolean }}
+ */
+function logNativeTeamCreate(rootDir, templateName, traceId, teammateCount) {
+  const msg = {
+    from: 'team-manager',
+    to: 'system',
+    type: 'native_team_create',
+    template: templateName,
+  };
+  if (traceId) msg.trace_id = traceId;
+  if (typeof teammateCount === 'number') msg.teammate_count = teammateCount;
+  const result = sendMessage(rootDir, msg);
+
+  try {
+    const teamEvents = getTeamEvents();
+    if (teamEvents) {
+      teamEvents.trackEvent(rootDir, 'team_created', {
+        template: templateName,
+        trace_id: traceId,
+        teammate_count: teammateCount,
+        native: true,
+      });
+    }
+  } catch (e) {
+    // Non-critical
+  }
+
+  return { ok: result.ok };
+}
+
+/**
+ * Log a native team completion to the JSONL bus.
+ *
+ * @param {string} rootDir - Project root
+ * @param {string} templateName - Team template name
+ * @param {string} [traceId] - Trace ID for correlation
+ * @param {string} [summary] - Summary of completed work
+ * @returns {{ ok: boolean }}
+ */
+function logNativeTeamCompleted(rootDir, templateName, traceId, summary) {
+  const msg = {
+    from: 'team-manager',
+    to: 'system',
+    type: 'native_team_completed',
+    template: templateName,
+  };
+  if (traceId) msg.trace_id = traceId;
+  if (summary) msg.summary = summary;
+  const result = sendMessage(rootDir, msg);
+
+  try {
+    const teamEvents = getTeamEvents();
+    if (teamEvents) {
+      teamEvents.trackEvent(rootDir, 'team_completed', {
+        template: templateName,
+        trace_id: traceId,
+        summary,
+        native: true,
+      });
+    }
+  } catch (e) {
+    // Non-critical
+  }
+
+  return { ok: result.ok };
+}
+
 /**
  * Send a validation result message.
  */
@@ -324,10 +498,39 @@ function main() {
       break;
     }
 
+    case 'log-native-send': {
+      const [, from, to, ...contentParts] = args;
+      const content = contentParts.filter(p => !p.startsWith('--')).join(' ');
+      const traceArg = args.find(a => a.startsWith('--trace-id='));
+      const traceId = traceArg ? traceArg.slice(11) : undefined;
+      result = logNativeSend(rootDir, from, to, content, traceId);
+      break;
+    }
+
+    case 'log-native-create': {
+      const [, templateName] = args;
+      const traceArg = args.find(a => a.startsWith('--trace-id='));
+      const traceId = traceArg ? traceArg.slice(11) : undefined;
+      const countArg = args.find(a => a.startsWith('--count='));
+      const teammateCount = countArg ? parseInt(countArg.slice(8), 10) : undefined;
+      result = logNativeTeamCreate(rootDir, templateName, traceId, teammateCount);
+      break;
+    }
+
+    case 'log-native-completed': {
+      const [, templateName] = args;
+      const traceArg = args.find(a => a.startsWith('--trace-id='));
+      const traceId = traceArg ? traceArg.slice(11) : undefined;
+      const summaryArg = args.find(a => a.startsWith('--summary='));
+      const summary = summaryArg ? summaryArg.slice(10) : undefined;
+      result = logNativeTeamCompleted(rootDir, templateName, traceId, summary);
+      break;
+    }
+
     default:
       result = {
         ok: false,
-        error: `Unknown command: ${command}\nUsage: messaging-bridge.js <send|read|context>`,
+        error: `Unknown command: ${command}\nUsage: messaging-bridge.js <send|read|context|log-native-send|log-native-create|log-native-completed>`,
       };
   }
 
@@ -343,7 +546,12 @@ module.exports = {
   sendTaskAssignment,
   sendPlanProposal,
   sendPlanDecision,
+  sendTeamMessage,
+  sendTeamCompleted,
   sendValidationResult,
+  logNativeSend,
+  logNativeTeamCreate,
+  logNativeTeamCompleted,
   getBusLogPath,
   formatForNative,
 };