agentxchain 2.71.0 → 2.73.0

package/dashboard/app.js

@@ -20,8 +20,8 @@ import { render as renderCoordinatorTimeouts } from './components/coordinator-ti
 
 const VIEWS = {
   timeline: { fetch: ['state', 'continuity', 'history', 'audit', 'annotations', 'connectors'], render: renderTimeline },
-  ledger: { fetch: ['ledger'], render: renderLedger },
-  hooks: { fetch: ['audit', 'annotations'], render: renderHooks },
+  ledger: { fetch: ['state', 'ledger', 'coordinatorState', 'coordinatorLedger'], render: renderLedger },
+  hooks: { fetch: ['audit', 'annotations', 'coordinatorAudit', 'coordinatorAnnotations'], render: renderHooks },
   blocked: { fetch: ['state', 'audit', 'coordinatorState', 'coordinatorAudit'], render: renderBlocked },
   gate: { fetch: ['state', 'history', 'coordinatorState', 'coordinatorHistory', 'coordinatorBarriers'], render: renderGate },
   initiative: { fetch: ['coordinatorState', 'coordinatorBarriers', 'barrierLedger', 'coordinatorBlockers'], render: renderInitiative },
@@ -38,6 +38,7 @@ const API_MAP = {
   continuity: '/api/continuity',
   history: '/api/history',
   ledger: '/api/ledger',
+  coordinatorLedger: '/api/coordinator/ledger',
   audit: '/api/hooks/audit',
   annotations: '/api/hooks/annotations',
   coordinatorState: '/api/coordinator/state',
@@ -45,6 +46,7 @@ const API_MAP = {
   coordinatorBarriers: '/api/coordinator/barriers',
   barrierLedger: '/api/coordinator/barrier-ledger',
   coordinatorAudit: '/api/coordinator/hooks/audit',
+  coordinatorAnnotations: '/api/coordinator/hooks/annotations',
   coordinatorBlockers: '/api/coordinator/blockers',
   workflowKitArtifacts: '/api/workflow-kit-artifacts',
   connectors: '/api/connectors',

package/dashboard/components/hooks.js

@@ -2,6 +2,7 @@
  * Hook Audit view — renders hook-audit.jsonl entries.
  *
  * Pure render function: takes data, returns HTML string. Testable in Node.js.
+ * Supports both repo-local and coordinator hook audit/annotation data.
  */
 
 function esc(str) {
@@ -90,26 +91,82 @@ function collectHookNames(audit) {
   return Array.from(unique).sort();
 }
 
-export function render({ audit, annotations, filter = {} }) {
+function renderAuditTable(entries, filter) {
+  const filtered = filterAudit(entries, filter);
+  let html = `<p class="section-subtitle">${filtered.length} of ${entries.length} hook execution${entries.length !== 1 ? 's' : ''}</p>
+    <table class="data-table">
+      <thead><tr><th>Time</th><th>Phase</th><th>Hook</th><th>Verdict</th><th>Action</th><th>Duration</th></tr></thead>
+      <tbody>`;
+
+  for (const entry of filtered) {
+    const duration = entry.duration_ms != null ? `${entry.duration_ms}ms` : '-';
+    const action = entry.orchestrator_action || entry.action || 'continued';
+    html += `<tr>
+      <td class="mono">${esc(entry.timestamp || '-')}</td>
+      <td class="mono">${esc(getHookPhase(entry))}</td>
+      <td>${esc(getHookName(entry))}</td>
+      <td>${verdictBadge(entry.verdict)}</td>
+      <td class="mono">${esc(action)}</td>
+      <td class="mono">${esc(duration)}</td>
+    </tr>`;
+  }
+
+  html += `</tbody></table>`;
+  return html;
+}
+
+function renderAnnotationList(entries) {
+  let html = `<p class="section-subtitle">${entries.length} annotation${entries.length !== 1 ? 's' : ''}</p>
+    <div class="annotation-list">`;
+
+  for (const entry of entries) {
+    const annotationText = formatAnnotations(entry);
+    html += `<div class="annotation-card">
+      <span class="mono">${esc(entry.turn_id || '-')}</span>
+      <span class="mono">${esc(getHookName(entry))}</span>
+      <span>${esc(annotationText || JSON.stringify(entry))}</span>
+    </div>`;
+  }
+
+  html += `</div>`;
+  return html;
+}
+
+export function render({
+  audit,
+  annotations,
+  coordinatorAudit = null,
+  coordinatorAnnotations = null,
+  filter = {},
+}) {
   const hasAudit = Array.isArray(audit) && audit.length > 0;
   const hasAnnotations = Array.isArray(annotations) && annotations.length > 0;
+  const hasCoordinatorAudit = Array.isArray(coordinatorAudit) && coordinatorAudit.length > 0;
+  const hasCoordinatorAnnotations = Array.isArray(coordinatorAnnotations) && coordinatorAnnotations.length > 0;
+  const hasAnyData = hasAudit || hasAnnotations || hasCoordinatorAudit || hasCoordinatorAnnotations;
+  const hasCoordinatorData = hasCoordinatorAudit || hasCoordinatorAnnotations;
 
-  if (!hasAudit && !hasAnnotations) {
+  if (!hasAnyData) {
     return `<div class="placeholder"><h2>Hook Audit</h2><p>No hook activity recorded.</p></div>`;
   }
 
+  // Build combined audit for shared filter bar
+  const combinedAudit = [
+    ...(Array.isArray(audit) ? audit : []),
+    ...(Array.isArray(coordinatorAudit) ? coordinatorAudit : []),
+  ];
+  const phases = collectHookPhases(combinedAudit);
+  const hookNames = collectHookNames(combinedAudit);
+  const selectedPhase = filter.phase || 'all';
+  const selectedVerdict = filter.verdict || 'all';
+  const selectedHookName = filter.hookName || 'all';
+
   let html = `<div class="hooks-view">`;
 
-  if (hasAudit) {
-    const filtered = filterAudit(audit, filter);
-    const phases = collectHookPhases(audit);
-    const hookNames = collectHookNames(audit);
-    const selectedPhase = filter.phase || 'all';
-    const selectedVerdict = filter.verdict || 'all';
-    const selectedHookName = filter.hookName || 'all';
-
-    html += `<div class="section"><h3>Hook Audit Log</h3>
-      <p class="section-subtitle">${filtered.length} of ${audit.length} hook execution${audit.length !== 1 ? 's' : ''}</p>
+  // Shared filter bar (covers both repo-local and coordinator data)
+  if (hasAudit || hasCoordinatorAudit) {
+    html += `<div class="section"><h3>Hook Audit</h3>
+      <p class="section-subtitle">${hasCoordinatorData ? 'Repo-local and coordinator hook audit surfaces' : 'Hook audit surface'}</p>
       <div class="filter-bar">
         <label class="filter-control">
           <span>Phase</span>
@@ -135,41 +192,37 @@ export function render({ audit, annotations, filter = {} }) {
           </select>
         </label>
       </div>
-      <table class="data-table">
-        <thead><tr><th>Time</th><th>Phase</th><th>Hook</th><th>Verdict</th><th>Action</th><th>Duration</th></tr></thead>
-        <tbody>`;
-
-    for (const entry of filtered) {
-      const duration = entry.duration_ms != null ? `${entry.duration_ms}ms` : '-';
-      const action = entry.orchestrator_action || entry.action || 'continued';
-      html += `<tr>
-        <td class="mono">${esc(entry.timestamp || '-')}</td>
-        <td class="mono">${esc(getHookPhase(entry))}</td>
-        <td>${esc(getHookName(entry))}</td>
-        <td>${verdictBadge(entry.verdict)}</td>
-        <td class="mono">${esc(action)}</td>
-        <td class="mono">${esc(duration)}</td>
-      </tr>`;
-    }
+    </div>`;
+  }
 
-    html += `</tbody></table></div>`;
+  // Repo-local audit section
+  if (hasAudit) {
+    const sectionTitle = hasCoordinatorData ? 'Repo Hook Audit Log' : 'Hook Audit Log';
+    html += `<div class="section"><h3>${sectionTitle}</h3>`;
+    html += renderAuditTable(audit, filter);
+    html += `</div>`;
+  }
+
+  // Coordinator audit section
+  if (hasCoordinatorAudit) {
+    html += `<div class="section"><h3>Coordinator Hook Audit Log</h3>`;
+    html += renderAuditTable(coordinatorAudit, filter);
+    html += `</div>`;
   }
 
+  // Repo-local annotations section
   if (hasAnnotations) {
-    html += `<div class="section"><h3>Hook Annotations</h3>
-      <p class="section-subtitle">${annotations.length} annotation${annotations.length !== 1 ? 's' : ''}</p>
-      <div class="annotation-list">`;
-
-    for (const entry of annotations) {
-      const annotationText = formatAnnotations(entry);
-      html += `<div class="annotation-card">
-        <span class="mono">${esc(entry.turn_id || '-')}</span>
-        <span class="mono">${esc(getHookName(entry))}</span>
-        <span>${esc(annotationText || JSON.stringify(entry))}</span>
-      </div>`;
-    }
+    const sectionTitle = hasCoordinatorData ? 'Repo Hook Annotations' : 'Hook Annotations';
+    html += `<div class="section"><h3>${sectionTitle}</h3>`;
+    html += renderAnnotationList(annotations);
+    html += `</div>`;
+  }
 
-    html += `</div></div>`;
+  // Coordinator annotations section
+  if (hasCoordinatorAnnotations) {
+    html += `<div class="section"><h3>Coordinator Hook Annotations</h3>`;
+    html += renderAnnotationList(coordinatorAnnotations);
+    html += `</div>`;
   }
 
   html += `</div>`;

package/dashboard/components/ledger.js

@@ -79,12 +79,7 @@ function hasObjections(entry) {
   return Array.isArray(entry.objections) && entry.objections.length > 0;
 }
 
-export function render({ ledger, filter = {} }) {
-  if (!ledger || ledger.length === 0) {
-    return `<div class="placeholder"><h2>Decision Ledger</h2><p>No decisions recorded yet.</p></div>`;
-  }
-
-  const filtered = filterEntries(ledger, filter);
+function renderFilterBar(ledger, filter) {
   const selectedAgent = filter.agent || 'all';
   const selectedPhase = filter.phase || 'all';
   const dateFrom = filter.dateFrom || '';
@@ -93,56 +88,57 @@ export function render({ ledger, filter = {} }) {
   const agents = collectAgents(ledger);
   const phases = collectPhases(ledger);
 
-  let html = `<div class="ledger-view">
-    <div class="section"><h3>Decision Ledger</h3>
-    <p class="section-subtitle">${filtered.length} of ${ledger.length} decision${ledger.length !== 1 ? 's' : ''} shown</p>
-    <div class="filter-bar">
-      <label class="filter-control">
-        <span>Agent</span>
-        <select data-view-control="ledger-agent">
-          <option value="all"${selectedAgent === 'all' ? ' selected' : ''}>All roles</option>
-          ${agents.map((agent) => `<option value="${esc(agent)}"${selectedAgent === agent ? ' selected' : ''}>${esc(agent)}</option>`).join('')}
-        </select>
-      </label>
-      <label class="filter-control">
-        <span>Phase</span>
-        <select data-view-control="ledger-phase">
-          <option value="all"${selectedPhase === 'all' ? ' selected' : ''}>All phases</option>
-          ${phases.map((p) => `<option value="${esc(p)}"${selectedPhase === p ? ' selected' : ''}>${esc(p)}</option>`).join('')}
-        </select>
-      </label>
-      <label class="filter-control">
-        <span>Search</span>
-        <input
-          type="search"
-          data-view-control="ledger-query"
-          value="${esc(query)}"
-          placeholder="Filter by role or decision"
-          autocomplete="off"
-        >
-      </label>
-      <label class="filter-control">
-        <span>From</span>
-        <input
-          type="date"
-          data-view-control="ledger-date-from"
-          value="${esc(dateFrom)}"
-          autocomplete="off"
-        >
-      </label>
-      <label class="filter-control">
-        <span>To</span>
-        <input
-          type="date"
-          data-view-control="ledger-date-to"
-          value="${esc(dateTo)}"
-          autocomplete="off"
-        >
-      </label>
-    </div>
-    <table class="data-table">
-      <thead><tr><th>Turn</th><th>Agent</th><th>Decision</th><th>Timestamp</th></tr></thead>
-      <tbody>`;
+  return `<div class="filter-bar">
+    <label class="filter-control">
+      <span>Agent</span>
+      <select data-view-control="ledger-agent">
+        <option value="all"${selectedAgent === 'all' ? ' selected' : ''}>All roles</option>
+        ${agents.map((agent) => `<option value="${esc(agent)}"${selectedAgent === agent ? ' selected' : ''}>${esc(agent)}</option>`).join('')}
+      </select>
+    </label>
+    <label class="filter-control">
+      <span>Phase</span>
+      <select data-view-control="ledger-phase">
+        <option value="all"${selectedPhase === 'all' ? ' selected' : ''}>All phases</option>
+        ${phases.map((p) => `<option value="${esc(p)}"${selectedPhase === p ? ' selected' : ''}>${esc(p)}</option>`).join('')}
+      </select>
+    </label>
+    <label class="filter-control">
+      <span>Search</span>
+      <input
+        type="search"
+        data-view-control="ledger-query"
+        value="${esc(query)}"
+        placeholder="Filter by role or decision"
+        autocomplete="off"
+      >
+    </label>
+    <label class="filter-control">
+      <span>From</span>
+      <input
+        type="date"
+        data-view-control="ledger-date-from"
+        value="${esc(dateFrom)}"
+        autocomplete="off"
+      >
+    </label>
+    <label class="filter-control">
+      <span>To</span>
+      <input
+        type="date"
+        data-view-control="ledger-date-to"
+        value="${esc(dateTo)}"
+        autocomplete="off"
+      >
+    </label>
+  </div>`;
+}
+
+function renderLedgerTable(entries, filter) {
+  const filtered = filterEntries(entries, filter);
+  let html = `<table class="data-table">
+    <thead><tr><th>Turn</th><th>Agent</th><th>Decision</th><th>Timestamp</th></tr></thead>
+    <tbody>`;
 
   if (filtered.length === 0) {
     html += `<tr><td colspan="4">No decisions match the current filters.</td></tr>`;
@@ -160,6 +156,65 @@ export function render({ ledger, filter = {} }) {
     }
   }
 
-  html += `</tbody></table></div></div>`;
+  html += `</tbody></table>`;
+  return { html, filteredCount: filtered.length };
+}
+
+function buildSections({ ledger, coordinatorLedger, state, coordinatorState }) {
+  const sections = [];
+  const hasRepoContext = Boolean(state) || (Array.isArray(ledger) && ledger.length > 0);
+  const hasCoordinatorContext = Boolean(coordinatorState) || (Array.isArray(coordinatorLedger) && coordinatorLedger.length > 0);
+
+  if (hasRepoContext) {
+    sections.push({
+      title: hasCoordinatorContext ? 'Repo Decision Ledger' : 'Decision Ledger',
+      entries: Array.isArray(ledger) ? ledger : [],
+      emptyMessage: 'No repo-local decisions recorded yet.',
+    });
+  }
+
+  if (hasCoordinatorContext) {
+    sections.push({
+      title: hasRepoContext ? 'Coordinator Decision Ledger' : 'Coordinator Decision Ledger',
+      entries: Array.isArray(coordinatorLedger) ? coordinatorLedger : [],
+      emptyMessage: 'No coordinator decisions recorded yet.',
+    });
+  }
+
+  return sections;
+}
+
+export function render({
+  ledger,
+  coordinatorLedger = null,
+  state = null,
+  coordinatorState = null,
+  filter = {},
+}) {
+  const sections = buildSections({ ledger, coordinatorLedger, state, coordinatorState });
+  if (sections.length === 0) {
+    return `<div class="placeholder"><h2>Decision Ledger</h2><p>No decisions recorded yet.</p></div>`;
+  }
+
+  const combinedLedger = sections.flatMap((section) => section.entries);
+  let html = `<div class="ledger-view">
+    <div class="section"><h3>Decisions</h3>
+    <p class="section-subtitle">${sections.length === 1 ? 'Decision ledger surface' : 'Repo-local and coordinator decision ledgers'}</p>
+    ${renderFilterBar(combinedLedger, filter)}
+    </div>`;
+
+  for (const section of sections) {
+    const { html: tableHtml, filteredCount } = renderLedgerTable(section.entries, filter);
+    html += `<div class="section"><h3>${section.title}</h3>
+      <p class="section-subtitle">${filteredCount} of ${section.entries.length} decision${section.entries.length !== 1 ? 's' : ''} shown</p>`;
+    if (section.entries.length === 0) {
+      html += `<div class="placeholder compact"><p>${section.emptyMessage}</p></div>`;
+    } else {
+      html += tableHtml;
+    }
+    html += `</div>`;
+  }
+
+  html += `</div>`;
   return html;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "2.71.0",
+  "version": "2.73.0",
   "description": "CLI for AgentXchain — governed multi-agent software delivery",
   "type": "module",
   "bin": {