fraim-framework 2.0.146 → 2.0.147

package/public/ai-hub/script.js

@@ -36,11 +36,11 @@ function gatherElements() {
     'project-button', 'project-name',
     'new-conv-btn', 'conv-list',
     // Issue #385: team roster
-    'team-roster',
-    'empty', 'active-conv', 'active-title', 'active-job',
-    'progress', 'stage', 'latest', 'artifact-slot', 'messages',
-    'coach-text', 'send', 'micro-manage', 'micro-log',
-    'status-line',
+    'team-roster',
+    'empty', 'active-conv', 'active-title', 'active-job', 'active-identity', 'run-state-pill', 'summary-strip',
+    'progress', 'stage', 'latest', 'artifact-slot', 'messages',
+    'coach-text', 'send', 'micro-manage', 'micro-log',
+    'status-line', 'coach-note',
     'modal', 'step1', 'step2',
     'cancel1', 'next1', 'back2', 'start',
     'job-search', 'job-catalog', 'job-pick-status',
@@ -306,11 +306,49 @@ function renderRail() {
   }
 }
 
-function statusLabel(s) {
-  if (s === 'running') return 'Running';
-  if (s === 'failed') return 'Needs you';
-  return 'Done';
-}
+function statusLabel(s) {
+  if (s === 'running') return 'Running';
+  if (s === 'failed') return 'Needs you';
+  return 'Done';
+}
+
+function personaMap() {
+  const map = new Map();
+  for (const persona of state.bootstrap?.personas || []) {
+    map.set(persona.key, persona);
+  }
+  return map;
+}
+
+function getConversationPersona(conv) {
+  if (!conv || !conv.personaKey) return null;
+  return personaMap().get(conv.personaKey) || null;
+}
+
+function getEmployeeStatus(employeeId) {
+  return (state.bootstrap?.employees || []).find((employee) => employee.id === employeeId) || null;
+}
+
+function getEmployeeTitle(conv) {
+  const persona = getConversationPersona(conv);
+  if (persona) return persona.role;
+  const employee = getEmployeeStatus(conv?.employeeId);
+  return employee ? employee.label : 'AI Employee';
+}
+
+function roleLabel(role, conv) {
+  if (role === 'manager') return 'Manager';
+  if (role === 'employee') {
+    const persona = getConversationPersona(conv);
+    return persona ? persona.displayName : 'Employee';
+  }
+  return 'System';
+}
+
+function initialBadge(text) {
+  const cleaned = String(text || '').replace(/[^A-Za-z]/g, '').toUpperCase();
+  return (cleaned.slice(0, 2) || 'FH');
+}
 
 // ---------------------------------------------------------------------------
 // Issue #385 — Persona UI (R3 + R4)
@@ -329,43 +367,62 @@ function conversationTitle(conv) {
 
 // R4.2 — team roster: one avatar chip per hired persona above the conv list.
 // Only rendered when at least one persona is hired (subscription active).
-function renderTeamRoster() {
-  const roster = els['team-roster'];
-  if (!roster) return;
-  const personas = (state.bootstrap?.personas || []).filter((p) => p.status === 'hired');
-  if (personas.length === 0) {
+function renderTeamRoster() {
+  const roster = els['team-roster'];
+  if (!roster) return;
+  const personas = (state.bootstrap?.personas || []).filter((p) => p.status === 'hired');
+  if (personas.length === 0) {
     roster.hidden = true;
     // Reset persona selection when there's no active subscription.
     if (state.selectedPersonaKey) state.selectedPersonaKey = null;
     return;
-  }
-  roster.hidden = false;
-  roster.innerHTML = '';
-  const allChip = document.createElement('button');
-  allChip.type = 'button';
-  allChip.className = 'roster-chip' + (!state.selectedPersonaKey ? ' active' : '');
-  allChip.title = 'All employees';
-  allChip.textContent = 'All';
-  allChip.addEventListener('click', () => setSelectedPersona(null));
-  roster.appendChild(allChip);
-  for (const persona of personas) {
-    const chip = document.createElement('button');
-    chip.type = 'button';
-    chip.className = 'roster-chip' + (state.selectedPersonaKey === persona.key ? ' active' : '');
-    chip.title = persona.displayName;
-    chip.setAttribute('aria-label', persona.displayName);
-    if (persona.avatarUrl) {
-      const img = document.createElement('img');
-      img.src = persona.avatarUrl;
-      img.alt = persona.displayName;
-      chip.appendChild(img);
-    } else {
-      chip.textContent = persona.displayName.slice(0, 2).toUpperCase();
-    }
-    chip.addEventListener('click', () => setSelectedPersona(persona.key));
-    roster.appendChild(chip);
-  }
-}
+  }
+  roster.hidden = false;
+  roster.innerHTML = '';
+  const allChip = document.createElement('button');
+  allChip.type = 'button';
+  allChip.className = 'roster-chip roster-chip--all' + (!state.selectedPersonaKey ? ' active' : '');
+  allChip.title = 'All employees';
+  allChip.setAttribute('aria-label', 'All employees');
+  allChip.innerHTML = `
+    <span class="roster-avatar">All</span>
+    <span class="roster-copy">
+      <strong>All employees</strong>
+      <small>Show every hired employee</small>
+    </span>
+  `;
+  allChip.addEventListener('click', () => setSelectedPersona(null));
+  roster.appendChild(allChip);
+  for (const persona of personas) {
+    const chip = document.createElement('button');
+    chip.type = 'button';
+    chip.className = 'roster-chip' + (state.selectedPersonaKey === persona.key ? ' active' : '');
+    chip.title = persona.displayName;
+    chip.setAttribute('aria-label', persona.displayName);
+    const avatar = document.createElement('span');
+    avatar.className = 'roster-avatar';
+    if (persona.avatarUrl) {
+      const img = document.createElement('img');
+      img.src = persona.avatarUrl;
+      img.alt = persona.displayName;
+      avatar.appendChild(img);
+    } else {
+      avatar.textContent = persona.displayName.slice(0, 2).toUpperCase();
+    }
+    const copy = document.createElement('span');
+    copy.className = 'roster-copy';
+    const name = document.createElement('strong');
+    name.textContent = persona.displayName;
+    const role = document.createElement('small');
+    role.textContent = persona.role || 'AI Employee';
+    copy.appendChild(name);
+    copy.appendChild(role);
+    chip.appendChild(avatar);
+    chip.appendChild(copy);
+    chip.addEventListener('click', () => setSelectedPersona(persona.key));
+    roster.appendChild(chip);
+  }
+}
 
 // R4.3 — employee selector: compact dropdown above conv list (shown when ≥1 hired persona).
 function buildAvatarChip(persona, size) {
@@ -483,30 +540,39 @@ function renderModalPersonaFilter() {
 // event rows are already in the DOM. Polling fires every second; without
 // this, every tick wiped the messages list and re-played the slidein
 // animation (= the screen flash the user reported as 'distracting').
-let renderedConvId = null;
-let renderedMessageCount = 0;
-let renderedEventCount = 0;
-let renderedArtifactKey = null;
-
-function renderActive() {
-  const conv = activeConversation();
-  if (!conv) {
-    els['empty'].hidden = false;
-    els['active-conv'].hidden = true;
-    renderedConvId = null;
-    renderedMessageCount = 0;
-    renderedEventCount = 0;
-    renderedArtifactKey = null;
-    return;
-  }
-  els['empty'].hidden = true;
-  els['active-conv'].hidden = false;
-  els['active-title'].textContent = conversationTitle(conv);
-  els['active-job'].textContent = `Job: ${conv.jobTitle}`;
-
-  // Progress section. Plain text updates are cheap and don't animate.
-  const stage = derivedStage(conv);
-  els['stage'].textContent = stage.text;
+let renderedConvId = null;
+let renderedMessageCount = 0;
+let renderedEventCount = 0;
+let renderedArtifactKey = null;
+let renderedStatus = null;
+
+function renderActive() {
+  const conv = activeConversation();
+  if (!conv) {
+    els['empty'].hidden = false;
+    els['active-conv'].hidden = true;
+    renderedConvId = null;
+    renderedMessageCount = 0;
+    renderedEventCount = 0;
+    renderedArtifactKey = null;
+    renderedStatus = null;
+    return;
+  }
+  els['empty'].hidden = true;
+  els['active-conv'].hidden = false;
+  els['active-title'].textContent = conversationTitle(conv);
+  els['active-job'].textContent = `${conv.jobTitle} · ${friendlyProjectName(conv.projectPath || state.projectPath)} · ${getEmployeeStatus(conv.employeeId)?.label || conv.employeeId}`;
+  renderConversationIdentity(conv);
+  els['active-job'].textContent = `${conv.jobTitle} · ${friendlyProjectName(conv.projectPath || state.projectPath)}`;
+  renderRunStatePill(conv);
+  els['summary-strip'].textContent = buildConversationSummary(conv);
+  els['coach-note'].textContent = conv.status === 'running'
+    ? 'The employee is still working. Add coaching here to tighten the next step without losing context.'
+    : 'The employee is waiting on you. Send the next instruction to continue this run.';
+
+  // Progress section. Plain text updates are cheap and don't animate.
+  const stage = derivedStage(conv);
+  els['stage'].textContent = stage.text;
   els['progress'].classList.remove('done', 'attention', 'failed');
   if (stage.kind) els['progress'].classList.add(stage.kind);
   els['latest'].textContent = derivedLatest(conv);
@@ -514,15 +580,16 @@ function renderActive() {
   // If we switched conversations (or this is the first render), wipe and
   // start fresh. Otherwise we're going to do an incremental update below.
   const switchedConv = renderedConvId !== conv.id;
-  if (switchedConv) {
+  if (switchedConv) {
     els['artifact-slot'].innerHTML = '';
     els['messages'].innerHTML = '';
     els['micro-log'].textContent = '';
     renderedConvId = conv.id;
     renderedMessageCount = 0;
-    renderedEventCount = 0;
-    renderedArtifactKey = null;
-  }
+    renderedEventCount = 0;
+    renderedArtifactKey = null;
+  }
+  const statusChanged = renderedStatus !== conv.status;
 
   // Artifact callout — only re-render when the latest artifact actually
   // changed. Avoids the 'pulse' animation re-firing on every poll tick.
@@ -550,19 +617,24 @@ function renderActive() {
   // existing rows don't re-animate. If for some reason the data shrunk
   // (server revoked a message), fall back to a full re-render.
   const messages = conv.messages || [];
-  if (messages.length < renderedMessageCount) {
-    els['messages'].innerHTML = '';
-    renderedMessageCount = 0;
-  }
-  for (let i = renderedMessageCount; i < messages.length; i += 1) {
-    appendMessageDom(messages[i].role, messages[i].text);
-  }
-  renderedMessageCount = messages.length;
-  // Keep the scroll pinned to the latest unless the user scrolled up.
-  const m = els['messages'];
-  if (m.scrollHeight - m.scrollTop - m.clientHeight < 80) {
-    m.scrollTop = m.scrollHeight;
-  }
+  if (messages.length < renderedMessageCount) {
+    els['messages'].innerHTML = '';
+    renderedMessageCount = 0;
+  }
+  for (let i = renderedMessageCount; i < messages.length; i += 1) {
+    appendMessageDom(messages[i].role, messages[i].text, conv);
+  }
+  const appendedMessages = messages.length - renderedMessageCount;
+  renderedMessageCount = messages.length;
+  // Running threads stay pinned near the newest work. Once the employee
+  // is done, snap to the review point instead of leaving the manager at
+  // a stale scroll offset.
+  const m = els['messages'];
+  if (conv.status === 'running' && m.scrollHeight - m.scrollTop - m.clientHeight < 80) {
+    m.scrollTop = m.scrollHeight;
+  } else if (switchedConv || statusChanged || appendedMessages > 0) {
+    scrollThreadForReview(conv);
+  }
 
   // Micro-manage — only append new events. textContent assignment on the
   // <pre> wipes the entire log every tick which is wasteful.
@@ -588,11 +660,58 @@ function renderActive() {
   // foldRunIntoConversation); for runs that have not yet polled we
   // simply hide the surfaces.
   renderTracker(conv);
-  renderTotals(conv);
-  syncTemplatePickerVisibility();
-  // Browser-tab title mirrors the active conversation (R3).
-  document.title = conv.title ? conv.title : 'AI Hub';
-}
+  renderTotals(conv);
+  syncTemplatePickerVisibility();
+  // Browser-tab title mirrors the active conversation (R3).
+  document.title = conv.title ? conv.title : 'AI Hub';
+  renderedStatus = conv.status;
+}
+
+function renderConversationIdentity(conv) {
+  const host = els['active-identity'];
+  if (!host) return;
+  const persona = getConversationPersona(conv);
+  const employee = getEmployeeStatus(conv.employeeId);
+  host.innerHTML = '';
+
+  const avatar = document.createElement(persona && persona.avatarUrl ? 'img' : 'span');
+  avatar.className = 'identity-avatar';
+  if (persona && persona.avatarUrl) {
+    avatar.src = persona.avatarUrl;
+    avatar.alt = persona.displayName;
+  } else {
+    avatar.textContent = initialBadge(employee?.label || 'Hub');
+  }
+
+  const text = document.createElement('span');
+  text.className = 'identity-copy';
+
+  const name = document.createElement('strong');
+  name.textContent = persona ? persona.displayName : (employee ? employee.label : 'AI Employee');
+
+  const title = document.createElement('small');
+  title.textContent = getEmployeeTitle(conv);
+
+  text.appendChild(name);
+  text.appendChild(title);
+  host.appendChild(avatar);
+  host.appendChild(text);
+}
+
+function renderRunStatePill(conv) {
+  const pill = els['run-state-pill'];
+  if (!pill) return;
+  pill.textContent = statusLabel(conv.status).toUpperCase();
+  pill.className = `run-state-pill ${conv.status}`;
+}
+
+function buildConversationSummary(conv) {
+  const employeeReply = latestEmployeeSurfaceText(conv);
+  if (employeeReply) return employeeReply;
+  if (conv.status === 'running') return 'The employee is working through your request.';
+  if (conv.status === 'failed') return 'This run needs your attention before it can continue.';
+  return 'The latest work is ready for review.';
+}
 
 // Render the inline employee selector shown in the coach section of an
 // active conversation. Allows switching agents without reopening the modal.
@@ -928,27 +1047,145 @@ function derivedStage(conv) {
   return { text: 'Done — please review', kind: 'done' };
 }
 
-function derivedLatest(conv) {
-  const messages = conv.messages || [];
-  for (let i = messages.length - 1; i >= 0; i -= 1) {
-    if (messages[i].role === 'employee') return messages[i].text;
-  }
-  if (conv.status === 'running') return 'Loading the work and getting started.';
-  return '';
-}
-
-function appendMessageDom(role, text) {
-  const div = document.createElement('div');
-  div.className = 'message ' + role;
-  const who = document.createElement('span');
-  who.className = 'who';
-  who.textContent = role === 'manager' ? 'You' : (role === 'employee' ? 'Employee' : 'System');
-  div.appendChild(who);
-  div.appendChild(document.createTextNode(text));
-  els['messages'].appendChild(div);
-}
-
-function syncSendButton() {
+function derivedLatest(conv) {
+  if (conv.status !== 'running') return '';
+  const employeeReply = latestEmployeeSurfaceText(conv);
+  if (employeeReply) return employeeReply;
+  if (conv.status === 'running') return 'Working on it…';
+  return '';
+}
+
+function humanizeSlug(slug) {
+  return String(slug || '')
+    .split('-')
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(' ');
+}
+
+function stripStubReference(text) {
+  return String(text || '')
+    .replace(/\n?\[Job stub:[^\]]+\]/gi, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function surfaceText(role, text, conv) {
+  const raw = stripStubReference(text);
+  if (!raw) return '';
+
+  if (role === 'manager') {
+    const invocationOnly = raw.match(/^(?:[$/]fraim)\s+([a-z0-9-]+)\s*$/i);
+    if (invocationOnly) return `Run ${humanizeSlug(invocationOnly[1])}.`;
+    const slugPattern = '[a-z0-9]+(?:-[a-z0-9]+)+';
+    const invocationWithSlug = new RegExp(`^(?:[$/]fraim)\\s+(${slugPattern})\\s*`, 'i');
+    return raw
+      .replace(invocationWithSlug, '')
+      .replace(/^(?:[$/]fraim)\s*/i, '')
+      .trim();
+  }
+
+  if (role === 'employee') {
+    const startedMatch = raw.match(/^Started\s+\w+:\s*(.*)$/i);
+    if (startedMatch) {
+      const cleaned = surfaceText('manager', startedMatch[1], conv);
+      if (conv.status === 'completed') return 'Done — please review.';
+      return cleaned ? `Working on: ${cleaned}` : 'Working on it…';
+    }
+  }
+
+  return raw;
+}
+
+function latestEmployeeSurfaceText(conv) {
+  const messages = conv.messages || [];
+  for (let i = messages.length - 1; i >= 0; i -= 1) {
+    if (messages[i].role !== 'employee') continue;
+    const cleaned = surfaceText('employee', messages[i].text, conv);
+    if (cleaned) return cleaned;
+  }
+  return '';
+}
+
+function appendMessageDom(role, text, conv) {
+  const article = document.createElement('article');
+  article.className = 'message ' + role;
+
+  const meta = document.createElement('div');
+  meta.className = 'message-meta';
+
+  const avatar = document.createElement('span');
+  avatar.className = `message-avatar ${role}`;
+
+  if (role === 'employee') {
+    const persona = getConversationPersona(conv);
+    if (persona && persona.avatarUrl) {
+      const img = document.createElement('img');
+      img.src = persona.avatarUrl;
+      img.alt = persona.displayName;
+      avatar.appendChild(img);
+    } else {
+      avatar.textContent = initialBadge(roleLabel(role, conv));
+    }
+  } else if (role === 'manager') {
+    avatar.textContent = 'M';
+  } else {
+    avatar.textContent = '•';
+  }
+
+  const who = document.createElement('span');
+  who.className = 'who';
+  who.textContent = roleLabel(role, conv);
+
+  const lane = document.createElement('span');
+  lane.className = 'lane-label';
+  lane.textContent = role === 'manager'
+    ? 'Manager direction'
+    : role === 'employee'
+      ? 'Employee response'
+      : 'System update';
+
+  meta.appendChild(avatar);
+  meta.appendChild(who);
+  meta.appendChild(lane);
+  article.appendChild(meta);
+
+  const bubble = document.createElement('div');
+  bubble.className = 'bubble';
+  bubble.textContent = surfaceText(role, text, conv) || (
+    role === 'employee'
+      ? (conv.status === 'completed' ? 'Done — please review.' : 'Working on it…')
+      : text
+  );
+  if (role === 'manager') {
+    const raw = document.createElement('span');
+    raw.className = 'transport-raw';
+    raw.textContent = text;
+    article.appendChild(raw);
+  }
+  article.appendChild(bubble);
+  els['messages'].appendChild(article);
+}
+
+function scrollThreadForReview(conv) {
+  const host = els['messages'];
+  if (!host) return;
+  const nodes = [...host.querySelectorAll('.message')];
+  if (nodes.length === 0) return;
+
+  if (conv.status === 'running') {
+    host.scrollTop = host.scrollHeight;
+    return;
+  }
+
+  const target = [...nodes].reverse().find((node) =>
+    node.classList.contains('employee') || node.classList.contains('system')
+  ) || nodes[nodes.length - 1];
+
+  target.scrollIntoView({ block: 'center', behavior: 'smooth' });
+}
+
+function syncSendButton() {
   const conv = activeConversation();
   const hasText = els['coach-text'].value.trim().length > 0;
   // Send is enabled as soon as the host session exists. We deliberately