agentxchain 2.74.0 → 2.76.0

package/dashboard/app.js

@@ -19,7 +19,7 @@ import { render as renderTimeouts } from './components/timeouts.js';
 import { render as renderCoordinatorTimeouts } from './components/coordinator-timeouts.js';
 
 const VIEWS = {
-  timeline: { fetch: ['state', 'continuity', 'history', 'audit', 'annotations', 'connectors'], render: renderTimeline },
+  timeline: { fetch: ['state', 'continuity', 'history', 'audit', 'annotations', 'connectors', 'coordinatorAudit', 'coordinatorAnnotations'], render: renderTimeline },
   ledger: { fetch: ['state', 'ledger', 'coordinatorState', 'coordinatorLedger'], render: renderLedger },
   hooks: { fetch: ['audit', 'annotations', 'coordinatorAudit', 'coordinatorAnnotations'], render: renderHooks },
   blocked: { fetch: ['state', 'audit', 'coordinatorState', 'coordinatorAudit'], render: renderBlocked },

package/dashboard/components/timeline.js

@@ -114,52 +114,74 @@ function roleBadge(role) {
   return `<span class="badge" style="color:${color};border-color:${color}">${esc(role)}</span>`;
 }
 
-function renderTurnDetailPanel(turnId, annotations, audit) {
+function renderAuditSection(title, auditEntries) {
+  if (auditEntries.length === 0) return '';
+  let html = `<div class="turn-detail"><span class="detail-label">${esc(title)} (${auditEntries.length}):</span>
+    <table class="data-table">
+      <thead><tr><th>Phase</th><th>Hook</th><th>Verdict</th></tr></thead>
+      <tbody>`;
+  for (const entry of auditEntries) {
+    const phase = entry.hook_phase || entry.phase || '';
+    const hook = entry.hook_name || entry.hook || entry.name || '';
+    html += `<tr>
+      <td class="mono">${esc(phase)}</td>
+      <td>${esc(hook)}</td>
+      <td>${esc(entry.verdict || '')}</td>
+    </tr>`;
+  }
+  html += `</tbody></table></div>`;
+  return html;
+}
+
+function renderAnnotationSection(title, annotationEntries) {
+  if (annotationEntries.length === 0) return '';
+  let html = `<div class="turn-detail"><span class="detail-label">${esc(title)} (${annotationEntries.length}):</span><ul>`;
+  for (const ann of annotationEntries) {
+    const hookName = ann.hook_name || ann.hook || ann.name || '';
+    if (Array.isArray(ann.annotations)) {
+      for (const a of ann.annotations) {
+        html += `<li>${esc(hookName)}: ${esc(a.key || '')} = ${esc(a.value || '')}</li>`;
+      }
+    } else {
+      const text = ann.annotation || ann.message || '';
+      html += `<li>${esc(hookName)}: ${esc(text)}</li>`;
+    }
+  }
+  html += `</ul></div>`;
+  return html;
+}
+
+function renderTurnDetailPanel(turnId, annotations, audit, coordinatorAnnotations, coordinatorAudit) {
   const turnAnnotations = Array.isArray(annotations)
     ? annotations.filter((a) => a.turn_id === turnId)
     : [];
   const turnAudit = Array.isArray(audit)
     ? audit.filter((a) => a.turn_id === turnId)
     : [];
+  const turnCoordAnnotations = Array.isArray(coordinatorAnnotations)
+    ? coordinatorAnnotations.filter((a) => a.turn_id === turnId)
+    : [];
+  const turnCoordAudit = Array.isArray(coordinatorAudit)
+    ? coordinatorAudit.filter((a) => a.turn_id === turnId)
+    : [];
+
+  const hasRepo = turnAnnotations.length > 0 || turnAudit.length > 0;
+  const hasCoord = turnCoordAnnotations.length > 0 || turnCoordAudit.length > 0;
 
-  if (turnAnnotations.length === 0 && turnAudit.length === 0) {
+  if (!hasRepo && !hasCoord) {
     return `<div class="turn-detail-panel"><p class="turn-detail">No hook evidence for this turn.</p></div>`;
   }
 
+  const dual = hasRepo && hasCoord;
   let html = `<div class="turn-detail-panel">`;
 
-  if (turnAudit.length > 0) {
-    html += `<div class="turn-detail"><span class="detail-label">Hook Audit (${turnAudit.length}):</span>
-      <table class="data-table">
-        <thead><tr><th>Phase</th><th>Hook</th><th>Verdict</th></tr></thead>
-        <tbody>`;
-    for (const entry of turnAudit) {
-      const phase = entry.hook_phase || entry.phase || '';
-      const hook = entry.hook_name || entry.hook || entry.name || '';
-      html += `<tr>
-        <td class="mono">${esc(phase)}</td>
-        <td>${esc(hook)}</td>
-        <td>${esc(entry.verdict || '')}</td>
-      </tr>`;
-    }
-    html += `</tbody></table></div>`;
-  }
+  // Repo-local hook evidence
+  html += renderAuditSection(dual ? 'Repo Hook Audit Log' : 'Hook Audit Log', turnAudit);
+  html += renderAnnotationSection(dual ? 'Repo Hook Annotations' : 'Hook Annotations', turnAnnotations);
 
-  if (turnAnnotations.length > 0) {
-    html += `<div class="turn-detail"><span class="detail-label">Annotations (${turnAnnotations.length}):</span><ul>`;
-    for (const ann of turnAnnotations) {
-      const hookName = ann.hook_name || ann.hook || ann.name || '';
-      if (Array.isArray(ann.annotations)) {
-        for (const a of ann.annotations) {
-          html += `<li>${esc(hookName)}: ${esc(a.key || '')} = ${esc(a.value || '')}</li>`;
-        }
-      } else {
-        const text = ann.annotation || ann.message || '';
-        html += `<li>${esc(hookName)}: ${esc(text)}</li>`;
-      }
-    }
-    html += `</ul></div>`;
-  }
+  // Coordinator hook evidence
+  html += renderAuditSection(dual ? 'Coordinator Hook Audit Log' : 'Hook Audit Log', turnCoordAudit);
+  html += renderAnnotationSection(dual ? 'Coordinator Hook Annotations' : 'Hook Annotations', turnCoordAnnotations);
 
   html += `</div>`;
   return html;
@@ -265,7 +287,7 @@ function renderConnectorHealthPanel(connectorsPayload) {
 
 export { formatDuration, computeElapsed, formatTimestamp };
 
-export function render({ state, continuity, history, annotations, audit, connectors }) {
+export function render({ state, continuity, history, annotations, audit, connectors, coordinatorAudit = null, coordinatorAnnotations = null }) {
   if (!state) {
     return `<div class="placeholder"><h2>No Run</h2><p>No governed run found. Start one with <code class="mono">agentxchain init --governed</code></p></div>`;
   }
@@ -353,7 +375,7 @@ export function render({ state, continuity, history, annotations, audit, connect
         html += `<div class="turn-detail"><span class="detail-label">Verification:</span> ${esc(verificationSummary)}</div>`;
       }
 
-      html += renderTurnDetailPanel(entry.turn_id, annotations, audit);
+      html += renderTurnDetailPanel(entry.turn_id, annotations, audit, coordinatorAnnotations, coordinatorAudit);
 
       html += `</div>`;
     }

package/package.json

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

package/scripts/render-github-release-body.mjs

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { execFileSync } from 'node:child_process';
+
+function usage() {
+  console.error('Usage: node scripts/render-github-release-body.mjs --target-version <semver> [--repo <owner/name>]');
+}
+
+function parseArgs(argv) {
+  let targetVersion = '';
+  let repo = process.env.GITHUB_REPOSITORY || 'shivamtiwari93/agentXchain.dev';
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--target-version') {
+      targetVersion = argv[i + 1] || '';
+      i += 1;
+      continue;
+    }
+    if (arg === '--repo') {
+      repo = argv[i + 1] || '';
+      i += 1;
+      continue;
+    }
+    usage();
+    process.exit(1);
+  }
+
+  if (!/^\d+\.\d+\.\d+$/.test(targetVersion)) {
+    usage();
+    process.exit(1);
+  }
+
+  return { targetVersion, repo };
+}
+
+function stripFrontmatter(text) {
+  return text.replace(/^---\n[\s\S]*?\n---\n*/, '').trim();
+}
+
+function extractSummaryParagraph(text, version) {
+  const heading = `# AgentXchain v${version}`;
+  const headingIndex = text.indexOf(heading);
+  if (headingIndex === -1) {
+    throw new Error(`Release heading missing from governed release page for ${version}`);
+  }
+
+  const afterHeading = text.slice(headingIndex + heading.length).trimStart();
+  const summaryMatch = afterHeading.match(/^([^\n#][\s\S]*?)\n\s*\n/);
+  if (!summaryMatch) {
+    throw new Error(`Release summary paragraph missing from governed release page for ${version}`);
+  }
+
+  return summaryMatch[1].replace(/\s+/g, ' ').trim();
+}
+
+function extractAggregateEvidenceLine(text) {
+  const matches = [...text.matchAll(/^-\s+.*\b(\d+)\s+tests\b.*\b0 failures\b.*$/gm)];
+  if (matches.length === 0) {
+    throw new Error('Concrete aggregate evidence line missing from governed release page');
+  }
+
+  const aggregate = matches.reduce((best, match) => {
+    const count = Number(match[1]);
+    if (!best || count > best.count) {
+      return { count, line: match[0] };
+    }
+    return best;
+  }, null);
+
+  return aggregate.line.replace(/\*\*/g, '').replace(/`/g, '').trim();
+}
+
+function getPreviousVersionTag(repoRoot, version) {
+  const currentTag = `v${version}`;
+  const output = execFileSync(
+    'git',
+    ['tag', '--list', 'v*.*.*', '--sort=-v:refname'],
+    { cwd: repoRoot, encoding: 'utf8' },
+  );
+
+  const tags = output.split('\n').map((line) => line.trim()).filter(Boolean);
+  const currentIndex = tags.indexOf(currentTag);
+  if (currentIndex === -1 || currentIndex === tags.length - 1) {
+    return null;
+  }
+  return tags[currentIndex + 1];
+}
+
+function renderBody({ version, repo, summary, evidence, previousTag }) {
+  const docsUrl = `https://agentxchain.dev/docs/releases/v${version.replace(/\./g, '-')}`;
+  const npmUrl = `https://www.npmjs.com/package/agentxchain/v/${version}`;
+  const lines = [
+    `Public release notes: ${docsUrl}`,
+    `npm package: ${npmUrl}`,
+    '',
+    summary,
+    '',
+    '## Evidence',
+    evidence,
+  ];
+
+  if (previousTag) {
+    lines.push('', `Full Changelog: https://github.com/${repo}/compare/${previousTag}...v${version}`);
+  }
+
+  return `${lines.join('\n')}\n`;
+}
+
+function main() {
+  const { targetVersion, repo } = parseArgs(process.argv.slice(2));
+  const repoRoot = resolve(import.meta.dirname, '..', '..');
+  const releaseDocPath = resolve(
+    repoRoot,
+    'website-v2',
+    'docs',
+    'releases',
+    `v${targetVersion.replace(/\./g, '-')}.mdx`,
+  );
+
+  if (!existsSync(releaseDocPath)) {
+    throw new Error(`Governed release page missing: ${releaseDocPath}`);
+  }
+
+  const rawDoc = readFileSync(releaseDocPath, 'utf8');
+  const doc = stripFrontmatter(rawDoc);
+  const summary = extractSummaryParagraph(doc, targetVersion);
+  const evidence = extractAggregateEvidenceLine(doc);
+  const previousTag = getPreviousVersionTag(repoRoot, targetVersion);
+  process.stdout.write(
+    renderBody({
+      version: targetVersion,
+      repo,
+      summary,
+      evidence,
+      previousTag,
+    }),
+  );
+}
+
+main();