agentxchain 2.35.0 → 2.36.0

package/dashboard/app.js

@@ -16,7 +16,7 @@ import { render as renderBlockers } from './components/blockers.js';
 import { render as renderArtifacts } from './components/artifacts.js';
 
 const VIEWS = {
-  timeline: { fetch: ['state', 'history', 'audit', 'annotations'], render: renderTimeline },
+  timeline: { fetch: ['state', 'continuity', 'history', 'audit', 'annotations'], render: renderTimeline },
   ledger: { fetch: ['ledger'], render: renderLedger },
   hooks: { fetch: ['audit', 'annotations'], render: renderHooks },
   blocked: { fetch: ['state', 'audit', 'coordinatorState', 'coordinatorAudit'], render: renderBlocked },
@@ -29,6 +29,7 @@ const VIEWS = {
 
 const API_MAP = {
   state: '/api/state',
+  continuity: '/api/continuity',
   history: '/api/history',
   ledger: '/api/ledger',
   audit: '/api/hooks/audit',

package/dashboard/components/timeline.js

@@ -132,7 +132,41 @@ function renderTurnDetailPanel(turnId, annotations, audit) {
   return html;
 }
 
-export function render({ state, history, annotations, audit }) {
+function renderContinuityPanel(continuity) {
+  if (!continuity) return '';
+
+  const checkpoint = continuity.checkpoint;
+  const checkpointSummary = checkpoint?.last_checkpoint_at
+    ? `${checkpoint.checkpoint_reason || 'unknown'} at ${checkpoint.last_checkpoint_at}`
+    : (checkpoint?.checkpoint_reason || 'No session checkpoint recorded');
+
+  let html = `<div class="section continuity-section"><h3>Continuity</h3><div class="turn-card">`;
+
+  if (checkpoint) {
+    html += `<div class="turn-detail"><span class="detail-label">Session:</span> <span class="mono">${esc(checkpoint.session_id || 'unknown')}</span></div>`;
+    html += `<div class="turn-detail"><span class="detail-label">Checkpoint:</span> ${esc(checkpointSummary)}</div>`;
+    html += `<div class="turn-detail"><span class="detail-label">Last turn:</span> <span class="mono">${esc(checkpoint.last_turn_id || 'none')}</span></div>`;
+    html += `<div class="turn-detail"><span class="detail-label">Last role:</span> ${esc(checkpoint.last_role || 'unknown')}</div>`;
+    if (continuity.stale_checkpoint) {
+      html += `<div class="turn-detail risks"><span class="detail-label">Warning:</span> checkpoint tracks <span class="mono">${esc(checkpoint.run_id || 'unknown')}</span>, but state.json remains source of truth.</div>`;
+    }
+  } else {
+    html += `<div class="turn-detail"><span class="detail-label">Checkpoint:</span> No session checkpoint recorded</div>`;
+  }
+
+  if (continuity.restart_recommended) {
+    html += `<div class="turn-detail"><span class="detail-label">Restart:</span> <span class="mono">agentxchain restart</span></div>`;
+  }
+
+  if (continuity.recovery_report_path) {
+    html += `<div class="turn-detail"><span class="detail-label">Report:</span> <span class="mono">${esc(continuity.recovery_report_path)}</span></div>`;
+  }
+
+  html += `</div></div>`;
+  return html;
+}
+
+export function render({ state, continuity, history, annotations, audit }) {
   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>`;
   }
@@ -152,6 +186,8 @@ export function render({ state, history, annotations, audit }) {
     </div>
   </div>`;
 
+  html += renderContinuityPanel(continuity);
+
   // Active turns
   if (activeTurns.length > 0) {
     html += `<div class="section"><h3>Active Turns</h3><div class="turn-list">`;

package/package.json

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

package/scripts/release-bump.sh

@@ -56,6 +56,8 @@ ALLOWED_RELEASE_PATHS=(
   ".agentxchain-conformance/capabilities.json"
   "website-v2/docs/protocol-implementor-guide.mdx"
   ".planning/LAUNCH_EVIDENCE_REPORT.md"
+  "cli/homebrew/agentxchain.rb"
+  "cli/homebrew/README.md"
 )
 
 is_allowed_release_path() {
@@ -162,6 +164,25 @@ if ! grep -qE "^# Launch Evidence Report — AgentXchain v${ESCAPED_VERSION}" "$
   SURFACE_ERRORS+=("LAUNCH_EVIDENCE_REPORT.md title does not carry v${TARGET_VERSION}")
 fi
 
+# 4h. Homebrew mirror formula version
+HOMEBREW_MIRROR="${REPO_ROOT}/cli/homebrew/agentxchain.rb"
+if [[ -f "$HOMEBREW_MIRROR" ]]; then
+  if ! grep -q "agentxchain-${TARGET_VERSION}\.tgz" "$HOMEBREW_MIRROR" 2>/dev/null; then
+    SURFACE_ERRORS+=("homebrew mirror formula does not reference agentxchain-${TARGET_VERSION}.tgz")
+  fi
+fi
+
+# 4i. Homebrew mirror maintainer README version
+HOMEBREW_MIRROR_README="${REPO_ROOT}/cli/homebrew/README.md"
+if [[ -f "$HOMEBREW_MIRROR_README" ]]; then
+  if ! grep -q -- "- version: \`${TARGET_VERSION}\`" "$HOMEBREW_MIRROR_README" 2>/dev/null; then
+    SURFACE_ERRORS+=("homebrew mirror README does not declare version ${TARGET_VERSION}")
+  fi
+  if ! grep -q "agentxchain-${TARGET_VERSION}\.tgz" "$HOMEBREW_MIRROR_README" 2>/dev/null; then
+    SURFACE_ERRORS+=("homebrew mirror README does not reference agentxchain-${TARGET_VERSION}.tgz")
+  fi
+fi
+
 if [[ "${#SURFACE_ERRORS[@]}" -gt 0 ]]; then
   echo "FAIL: ${#SURFACE_ERRORS[@]} version-surface(s) not aligned to ${TARGET_VERSION}:" >&2
   printf '  - %s\n' "${SURFACE_ERRORS[@]}" >&2
@@ -170,7 +191,7 @@ if [[ "${#SURFACE_ERRORS[@]}" -gt 0 ]]; then
   echo "create release identity when governed surfaces are stale." >&2
   exit 1
 fi
-echo "  OK: all 7 governed version surfaces reference ${TARGET_VERSION}"
+echo "  OK: all 10 governed version surfaces reference ${TARGET_VERSION}"
 
 # 5. Update version files (no git operations)
 echo "[5/8] Updating version files..."

package/src/commands/status.js

@@ -1,12 +1,8 @@
-import { existsSync } from 'fs';
-import { join } from 'path';
 import chalk from 'chalk';
 import { loadConfig, loadLock, loadProjectContext, loadProjectState, loadState } from '../lib/config.js';
 import { deriveRecoveryDescriptor } from '../lib/blocked-state.js';
 import { getActiveTurn, getActiveTurnCount, getActiveTurns } from '../lib/governed-state.js';
-import { readSessionCheckpoint } from '../lib/session-checkpoint.js';
-
-const SESSION_RECOVERY_PATH = '.agentxchain/SESSION_RECOVERY.md';
+import { getContinuityStatus } from '../lib/continuity-status.js';
 
 export async function statusCommand(opts) {
   const context = loadProjectContext();
@@ -247,28 +243,6 @@ function renderGovernedStatus(context, opts) {
   console.log('');
 }
 
-function getContinuityStatus(root, state) {
-  const checkpoint = readSessionCheckpoint(root);
-  const recoveryReportPath = existsSync(join(root, SESSION_RECOVERY_PATH))
-    ? SESSION_RECOVERY_PATH
-    : null;
-
-  if (!checkpoint && !recoveryReportPath) return null;
-
-  const staleCheckpoint = !!(
-    checkpoint?.run_id
-    && state?.run_id
-    && checkpoint.run_id !== state.run_id
-  );
-
-  return {
-    checkpoint,
-    stale_checkpoint: staleCheckpoint,
-    recovery_report_path: recoveryReportPath,
-    restart_recommended: !!state && !['blocked', 'completed', 'failed'].includes(state.status),
-  };
-}
-
 function renderContinuityStatus(continuity, state) {
   if (!continuity) return;
 

package/src/lib/continuity-status.js

@@ -0,0 +1,27 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { readSessionCheckpoint } from './session-checkpoint.js';
+
+export const SESSION_RECOVERY_PATH = '.agentxchain/SESSION_RECOVERY.md';
+
+export function getContinuityStatus(root, state) {
+  const checkpoint = readSessionCheckpoint(root);
+  const recoveryReportPath = existsSync(join(root, SESSION_RECOVERY_PATH))
+    ? SESSION_RECOVERY_PATH
+    : null;
+
+  if (!checkpoint && !recoveryReportPath) return null;
+
+  const staleCheckpoint = !!(
+    checkpoint?.run_id
+    && state?.run_id
+    && checkpoint.run_id !== state.run_id
+  );
+
+  return {
+    checkpoint,
+    stale_checkpoint: staleCheckpoint,
+    recovery_report_path: recoveryReportPath,
+    restart_recommended: !!state && !['blocked', 'completed', 'failed'].includes(state.status),
+  };
+}

package/src/lib/dashboard/state-reader.js

@@ -7,10 +7,12 @@
  */
 
 import { readFileSync, existsSync } from 'fs';
-import { join, normalize } from 'path';
+import { join, normalize, resolve } from 'path';
+import { getContinuityStatus } from '../continuity-status.js';
 
 const STATE_FILE = 'state.json';
 const SESSION_FILE = 'session.json';
+const SESSION_RECOVERY_FILE = 'SESSION_RECOVERY.md';
 const HISTORY_FILE = 'history.jsonl';
 const LEDGER_FILE = 'decision-ledger.jsonl';
 const HOOK_AUDIT_FILE = 'hook-audit.jsonl';
@@ -44,6 +46,7 @@ export const RESOURCE_MAP = {
 export const FILE_TO_RESOURCE = Object.fromEntries(
   Object.entries(RESOURCE_MAP).map(([resource, file]) => [normalizeRelativePath(file), resource])
 );
+FILE_TO_RESOURCE[normalizeRelativePath(SESSION_RECOVERY_FILE)] = '/api/continuity';
 
 export const WATCH_DIRECTORIES = [
   '',
@@ -86,6 +89,13 @@ export function readJsonlFile(agentxchainDir, filename) {
  * Read a resource by its API path. Returns { data, format } or null.
  */
 export function readResource(agentxchainDir, resourcePath) {
+  if (resourcePath === '/api/continuity') {
+    const root = resolve(agentxchainDir, '..');
+    const state = readJsonFile(agentxchainDir, STATE_FILE);
+    const data = getContinuityStatus(root, state);
+    return { data, format: 'json' };
+  }
+
   const filename = RESOURCE_MAP[resourcePath];
   if (!filename) return null;