ework-web 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ework-web",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "ework-web — standalone multi-project issue tracker. Local SQLite-backed, no external API dependency. Bun + TypeScript + SSR HTML.",
   "license": "MIT",

package/src/coordination.ts

@@ -0,0 +1,32 @@
+import { getDB } from "./db";
+import { log } from "./logger";
+
+export interface DaemonInfo {
+  id: number;
+  displayName: string;
+  endpoint: string;
+}
+
+const HEARTBEAT_STALE_MS = 120_000;
+
+export async function getActiveDaemons(): Promise<DaemonInfo[]> {
+  const stale = new Date(Date.now() - HEARTBEAT_STALE_MS);
+  const staleStr = stale.toISOString().slice(0, 19).replace("T", " ");
+  try {
+    const rows = await getDB().all<{ id: number; display_name: string; internal_endpoint: string }>(
+      `SELECT id, display_name, internal_endpoint FROM {{d_daemons}} WHERE status = 'active' AND last_heartbeat > ?`,
+      [staleStr],
+    );
+    return rows
+      .filter((r): r is { id: number; display_name: string; internal_endpoint: string } =>
+        r.internal_endpoint !== null && r.internal_endpoint !== undefined && r.internal_endpoint !== "")
+      .map((r) => ({
+        id: r.id,
+        displayName: r.display_name ?? `daemon-${r.id}`,
+        endpoint: r.internal_endpoint,
+      }));
+  } catch (e) {
+    log.info(`coordination: query failed (${e instanceof Error ? e.message : String(e)}) — assuming single-machine`);
+    return [];
+  }
+}

package/src/index.ts

@@ -6,10 +6,11 @@ import { homedir } from "os";
 import { loadConfig, DB_OVERRIDABLE, parseOverride, resolveTtsBackend } from "./config";
 import type { Config } from "./config";
 import { setConfig, initDB } from "./db";
+import { getActiveDaemons } from "./coordination";
 import { testMysqlConnection, migrateSqliteToMysql, writeMysqlEnv, migrateMysqlToSqlite, writeSqliteEnv, migrateDaemonSqliteToMysql } from "./db-admin";
 import type { MysqlTargetOpts } from "./db-admin";
 import { checkAuth, makeAuthCookieHeader, clearAuthCookieHeader, loginHTML, sanitizeNext, ensureBootstrapAdmin, ensureBootstrapSystem, isReservedSystemLogin } from "./auth";
-import { OpencodeError, createOpencodeClient } from "./opencode";
+import { OpencodeError, createOpencodeClient, MultiDaemonOpencodeClient, RemoteOpencodeClient, isLocalhost, type OpencodeClientInterface } from "./opencode";
 import { renderMarkdown } from "./render/markdown";
 import { log, uptimeSeconds, version } from "./logger";
 import { buildIssueThread, fetchIssuePage, fetchIssueSince, errorPage } from "./views/issueThread";
@@ -81,10 +82,12 @@ import {
   setWebhookActive,
   getWebhook,
   listDeliveries,
+  listAllRecentDeliveries,
   type WebhookEventName,
 } from "./webhooks";
 import { classifyActor, type CommentView } from "./render/components";
 import { buildWebhooksPage } from "./views/webhooks";
+import { buildWebhookDeliveriesPage } from "./views/webhookDeliveries";
 import { buildProjectMembersPage } from "./views/projectMembers";
 import { buildProjectUpstreamsPage, trySetUpstreamUrls } from "./views/projectUpstreams";
 import { buildProjectModelPage } from "./views/projectModel";
@@ -95,7 +98,24 @@ const STATIC_DIR = join(__dirname, "static");
 
 await initDB();
 const cfg: Config = await loadConfig();
-const opencode = createOpencodeClient(cfg, cfg.daemonWebhookUrl);
+let opencode: OpencodeClientInterface = createOpencodeClient(cfg, cfg.daemonWebhookUrl);
+
+async function refreshOpencodeClient(): Promise<void> {
+  const daemons = await getActiveDaemons();
+  const remote = daemons.filter((d) => !isLocalhost(d.endpoint));
+  if (remote.length > 1) {
+    opencode = new MultiDaemonOpencodeClient(remote.map((d) => d.endpoint));
+    log.info(`opencode client: multi-daemon (${remote.length} remotes)`);
+  } else if (remote.length === 1) {
+    opencode = new RemoteOpencodeClient(remote[0]!.endpoint);
+    log.info(`opencode client: single remote (${remote[0]!.endpoint})`);
+  } else {
+    opencode = createOpencodeClient(cfg, cfg.daemonWebhookUrl);
+  }
+}
+
+await refreshOpencodeClient();
+setInterval(refreshOpencodeClient, 10_000);
 
 async function autoWireDaemon(projectId: number, origin: string): Promise<void> {
   if (!cfg.autowireActive) {
@@ -921,6 +941,11 @@ async function handle(req: Request, url: URL, ip: string, ctx: { authed: boolean
     return html(buildAdminTokensPage(ctx.user!, await listAllPatsWithUsers(), flash));
   }
 
+  if (url.pathname === "/admin/deliveries") {
+    const deliveries = await listAllRecentDeliveries(100);
+    return html(buildWebhookDeliveriesPage(ctx.user!, deliveries));
+  }
+
   const adminPatRevoke = url.pathname.match(/^\/admin\/tokens\/(\d+)\/revoke$/);
   if (adminPatRevoke && req.method === "POST") {
     const id = Number(adminPatRevoke[1]);

package/src/opencode.ts

@@ -293,11 +293,68 @@ export class RemoteOpencodeClient implements OpencodeClientInterface {
   }
 }
 
-function isLocalhost(endpoint: string): boolean {
+export function isLocalhost(endpoint: string): boolean {
   const host = endpoint.replace(/^https?:\/\//, "").split(":")[0] ?? "";
   return /^(127\.|localhost$|0\.0\.0\.0$|::1$|\[::1\]$)/.test(host);
 }
 
+export class MultiDaemonOpencodeClient implements OpencodeClientInterface {
+  private readonly clients: RemoteOpencodeClient[];
+
+  constructor(endpoints: string[]) {
+    this.clients = endpoints.map((ep) => new RemoteOpencodeClient(ep));
+  }
+
+  async listSessions(limit: number): Promise<SessionListItem[]> {
+    const results = await Promise.allSettled(
+      this.clients.map((c) => c.listSessions(limit)),
+    );
+    const all: SessionListItem[] = [];
+    const seen = new Set<string>();
+    for (const r of results) {
+      if (r.status === "fulfilled") {
+        for (const s of r.value) {
+          if (s.id && !seen.has(s.id)) {
+            seen.add(s.id);
+            all.push(s);
+          }
+        }
+      }
+    }
+    all.sort((a, b) => b.updated - a.updated);
+    return all.slice(0, limit);
+  }
+
+  async exportSession(id: string): Promise<SessionExport> {
+    try {
+      return await Promise.any(this.clients.map((c) => c.exportSession(id)));
+    } catch {
+      throw new OpencodeError(`session ${id} not found on any daemon`, 404);
+    }
+  }
+
+  async exportSessionRaw(id: string): Promise<string> {
+    try {
+      return await Promise.any(this.clients.map((c) => c.exportSessionRaw(id)));
+    } catch {
+      throw new OpencodeError(`session ${id} not found on any daemon`, 404);
+    }
+  }
+
+  async listModels(): Promise<string[]> {
+    const results = await Promise.allSettled(
+      this.clients.map((c) => c.listModels()),
+    );
+    const models = new Set<string>();
+    for (const r of results) {
+      if (r.status === "fulfilled") {
+        for (const m of r.value) models.add(m);
+      }
+    }
+    return [...models];
+  }
+}
+
 export function createOpencodeClient(cfg: Config, daemonEndpoint?: string): OpencodeClientInterface {
   if (daemonEndpoint && !isLocalhost(daemonEndpoint)) {
     return new RemoteOpencodeClient(daemonEndpoint);

package/src/views/users.ts

@@ -138,6 +138,7 @@ ${flashHtml}
 <div class="admin-nav">
   <a href="/admin/users">用户</a>
   <a href="/admin/tokens">所有 Token</a>
+  <a href="/admin/deliveries">Webhook 投递</a>
 </div>
 
 <form class="card" method="POST" action="/admin/users/create">

package/src/views/webhookDeliveries.ts

@@ -0,0 +1,92 @@
+import { type DeliveryWithWebhookRow } from "../webhooks";
+import { type UserRow } from "../store";
+import { THEME_CSS, escapeHtml, escapeAttr, tabNavHTML } from "../render/layout";
+
+function statusClass(status: number | null): string {
+  if (status === null) return "err";
+  if (status >= 200 && status < 300) return "ok";
+  if (status >= 400 && status < 500) return "warn";
+  return "err";
+}
+
+function deliveryRowHtml(d: DeliveryWithWebhookRow): string {
+  const status = d.response_status === null ? "—" : String(d.response_status);
+  const cls = statusClass(d.response_status);
+  const project = d.project_owner
+    ? `<a href="/${escapeAttr(d.project_owner)}/${escapeAttr(d.project_name ?? "")}">${escapeHtml(d.project_owner + "/" + (d.project_name ?? ""))}</a>`
+    : "<em>(deleted)</em>";
+  const url = d.webhook_url ? `<code class="url">${escapeHtml(d.webhook_url)}</code>` : "<em>(deleted)</em>";
+  const err = d.error ? `<div class="derr">${escapeHtml(d.error)}</div>` : "";
+  const body = d.response_body
+    ? `<details class="dbody"><summary>响应</summary><pre>${escapeHtml(d.response_body)}</pre></details>`
+    : "";
+  const payload = `<details class="dpl"><summary>payload</summary><pre>${escapeHtml(d.payload)}</pre></details>`;
+  return `<tr>
+    <td class="ts">${escapeHtml(d.created_at)}</td>
+    <td class="proj">${project}</td>
+    <td class="ev">${escapeHtml(d.event)}</td>
+    <td class="url">${url}</td>
+    <td class="st ${cls}">${status}</td>
+    <td class="ms">${d.duration_ms === null ? "—" : d.duration_ms + "ms"}</td>
+    <td class="act">${payload}${body}${err}</td>
+  </tr>`;
+}
+
+export function buildWebhookDeliveriesPage(viewer: UserRow, deliveries: DeliveryWithWebhookRow[]): string {
+  const rows = deliveries.length > 0
+    ? deliveries.map(deliveryRowHtml).join("")
+    : `<tr><td colspan="7" class="empty">暂无投递记录</td></tr>`;
+
+  const ok = deliveries.filter((d) => d.response_status !== null && d.response_status >= 200 && d.response_status < 300).length;
+  const fail = deliveries.filter((d) => d.response_status === null || d.response_status >= 400).length;
+  const summary = deliveries.length > 0
+    ? `<div class="summary"><span class="badge ok">${ok} 成功</span> <span class="badge ${fail > 0 ? "err" : ""}">${fail} 失败</span> <span class="muted">最近 ${deliveries.length} 条</span></div>`
+    : "";
+
+  return `<!doctype html>
+<html lang="zh"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<link rel="icon" type="image/svg+xml" href="/favicon.svg">
+<title>ework-web · Webhook 投递记录</title>
+<style>${THEME_CSS}
+.nav{display:flex;align-items:center;gap:.5rem;padding:.55rem 1rem;background:var(--header-bg);color:var(--header-text);font-size:13px}
+.nav a{color:var(--header-text);opacity:.95}
+.wrap{max-width:1100px;margin:0 auto;padding:1rem}
+h1{font-size:18px;margin:0 0 .3rem}
+.hint{color:var(--text-muted);font-size:13px;margin:0 0 1rem}
+.summary{margin-bottom:.8rem;display:flex;gap:.5rem;align-items:center}
+.badge{padding:2px 8px;border-radius:10px;font-size:12px;font-weight:600}
+.badge.ok{background:#3fb95033;color:#3fb950}
+.badge.err{background:#f8514933;color:#f85149}
+.muted{color:var(--text-muted);font-size:12px}
+.dtable{width:100%;border-collapse:collapse;font-size:12px}
+.dtable th,.dtable td{border:1px solid var(--border);padding:.3rem .4rem;text-align:left;vertical-align:top}
+.dtable th{background:var(--bg);color:var(--text-muted);font-weight:600;position:sticky;top:0}
+.dtable .ts{white-space:nowrap;font-family:ui-monospace,monospace}
+.dtable .proj{white-space:nowrap}
+.dtable .proj a{color:var(--accent)}
+.dtable .ev{white-space:nowrap;font-family:ui-monospace,monospace}
+.dtable .url{max-width:200px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.dtable .url code{font-family:ui-monospace,monospace;font-size:11px;color:var(--text-muted)}
+.dtable .st.ok{color:#3fb950;font-weight:600}
+.dtable .st.warn{color:#d29922;font-weight:600}
+.dtable .st.err{color:#f85149;font-weight:600}
+.dtable .ms{color:var(--text-muted);white-space:nowrap}
+.dbody pre,.dpl pre{font-size:11px;max-height:240px;overflow:auto;background:var(--bg);padding:.4rem;border-radius:5px;border:1px solid var(--border);white-space:pre-wrap;word-break:break-all}
+.derr{color:#f85149;font-size:11px;margin-top:.2rem}
+.empty{color:var(--text-muted);text-align:center;padding:.6rem}
+.tabs{display:flex;gap:.3rem;padding:.5rem 1rem;border-bottom:1px solid var(--border);font-size:13px}
+.tab{padding:.3rem .7rem;border-radius:6px 6px 0 0;text-decoration:none;color:var(--text-muted)}
+.tab.active{background:var(--accent);color:#fff}
+</style></head><body>
+<header class="nav"><a href="/" style="color:var(--header-text)">🏠 ework-web</a></header>
+${tabNavHTML("projects", viewer)}
+<main class="wrap">
+<h1>Webhook 投递记录</h1>
+<p class="hint">所有项目的 webhook 投递历史。用于排查 "AI 没回应" 类问题 — 如果投递失败（红色状态码），daemon 根本没收到事件。</p>
+${summary}
+<table class="dtable"><thead><tr>
+  <th>时间</th><th>项目</th><th>事件</th><th>目标 URL</th><th>状态</th><th>耗时</th><th>详情</th>
+</tr></thead><tbody>${rows}</tbody></table>
+</main></body></html>`;
+}

package/src/webhooks.ts

@@ -177,6 +177,23 @@ export async function listDeliveries(webhookId: number, limit = 50): Promise<Web
   );
 }
 
+export interface DeliveryWithWebhookRow extends WebhookDeliveryRow {
+  webhook_url: string;
+  project_owner: string;
+  project_name: string;
+}
+
+export async function listAllRecentDeliveries(limit = 100): Promise<DeliveryWithWebhookRow[]> {
+  return await getDB().all<DeliveryWithWebhookRow>(
+    `SELECT d.*, w.url AS webhook_url, p.owner AS project_owner, p.name AS project_name
+     FROM {{webhook_deliveries}} d
+     LEFT JOIN {{webhooks}} w ON w.id = d.webhook_id
+     LEFT JOIN {{projects}} p ON p.id = w.project_id
+     ORDER BY d.id DESC LIMIT ?`,
+    [limit]
+  );
+}
+
 // ─── Payload builders (Gitea-compatible shape) ───────────────
 //
 // We populate the fields downstream consumers actually read (see Gitea's