@m8i-51/shoal 0.1.20 → 0.1.21

package/framework/__tests__/coverage.test.ts

@@ -426,4 +426,23 @@ describe("getFindingHotspots", () => {
     const hotspots = getFindingHotspots();
     expect(hotspots.some((h) => h.pathPrefix === "/")).toBe(true);
   });
+
+  it("triage_result.json（timestamp/category を持たない集計ファイル）は無視する", () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readdirSync)
+      .mockReturnValueOnce(["run_1"] as unknown as ReturnType<typeof fs.readdirSync>)
+      .mockReturnValueOnce(["f1.json", "triage_result.json"] as unknown as ReturnType<typeof fs.readdirSync>);
+
+    const finding = { id: "f1", runId: "run_1", agentId: "a", agentName: "A", role: "r", title: "Bug on /settings", body: "broken at /settings", category: "bug", timestamp: new Date().toISOString() };
+    const triageResult = { runId: "run_1", completedAt: "x", issued: [], skipped: [], unprocessed: [] };
+    vi.mocked(fs.readFileSync)
+      .mockReturnValueOnce(JSON.stringify(finding) as unknown as ReturnType<typeof fs.readFileSync>)
+      .mockReturnValueOnce(JSON.stringify(triageResult) as unknown as ReturnType<typeof fs.readFileSync>);
+
+    const hotspots = getFindingHotspots();
+    const settings = hotspots.find((h) => h.pathPrefix === "/settings");
+    expect(settings?.totalFindings).toBe(1);
+    expect(settings?.categories).toEqual({ bug: 1 });
+    expect(Object.keys(settings?.categories ?? {})).not.toContain("undefined");
+  });
 });

package/framework/__tests__/cross-run-dedup.test.ts

@@ -0,0 +1,83 @@
+import { describe, it, expect } from "vitest";
+import { groupSimilarFindings, findCrossRunDuplicates } from "../cross-run-dedup";
+import type { Finding } from "../types";
+
+function mockFinding(overrides: Partial<Finding> = {}): Finding {
+  return {
+    id: "f1",
+    runId: "run_1",
+    agentId: "a1",
+    agentName: "Alice",
+    role: "tester",
+    title: "Untitled",
+    body: "",
+    category: "bug",
+    timestamp: new Date().toISOString(),
+    ...overrides,
+  };
+}
+
+describe("groupSimilarFindings", () => {
+  it("空配列 → 空配列", () => {
+    expect(groupSimilarFindings([])).toEqual([]);
+  });
+
+  it("似ていない finding は別クラスタになる", () => {
+    const a = mockFinding({ id: "a", title: "Login button broken", body: "clicking login does nothing" });
+    const b = mockFinding({ id: "b", title: "Dark mode toggle missing", body: "no way to switch themes" });
+    const clusters = groupSimilarFindings([a, b]);
+    expect(clusters).toHaveLength(2);
+  });
+
+  it("似ている finding は同じクラスタになる（run をまたいでも）", () => {
+    const a = mockFinding({
+      id: "a", runId: "run_1",
+      title: "Dashboard metric not accessible via API",
+      body: "The dashboard shows a metric card but there is no API endpoint to retrieve it.",
+    });
+    const b = mockFinding({
+      id: "b", runId: "run_2",
+      title: "Dashboard metrics not accessible via API",
+      body: "The dashboard metric card has no corresponding API endpoint to retrieve it.",
+    });
+    const clusters = groupSimilarFindings([a, b]);
+    expect(clusters).toHaveLength(1);
+    expect(clusters[0]).toHaveLength(2);
+  });
+
+  it("3件中2件が似ている → 2クラスタ（似ているペア + 単独1件）", () => {
+    const a = mockFinding({ id: "a", title: "Profile update API missing", body: "no endpoint to update profile" });
+    const b = mockFinding({ id: "b", title: "Profile update API is missing", body: "no endpoint exists to update the profile" });
+    const c = mockFinding({ id: "c", title: "Dark mode toggle missing", body: "no way to switch themes at all" });
+    const clusters = groupSimilarFindings([a, b, c]);
+    expect(clusters).toHaveLength(2);
+    const sizes = clusters.map((cl) => cl.length).sort();
+    expect(sizes).toEqual([1, 2]);
+  });
+
+  it("threshold を下げるとより緩く同一クラスタになる", () => {
+    const a = mockFinding({ id: "a", title: "Cannot export dashboard data", body: "no CSV export button" });
+    const b = mockFinding({ id: "b", title: "Missing budgeting dashboard", body: "no way to adjust project budget" });
+    const clustersStrict = groupSimilarFindings([a, b], 0.9);
+    const clustersLoose = groupSimilarFindings([a, b], 0.01);
+    expect(clustersStrict).toHaveLength(2);
+    expect(clustersLoose).toHaveLength(1);
+  });
+});
+
+describe("findCrossRunDuplicates", () => {
+  it("単独 finding しかない場合は空配列", () => {
+    const a = mockFinding({ id: "a", title: "Login button broken", body: "clicking login does nothing" });
+    const b = mockFinding({ id: "b", title: "Dark mode toggle missing", body: "no way to switch themes" });
+    expect(findCrossRunDuplicates([a, b])).toEqual([]);
+  });
+
+  it("2件以上のクラスタのみ返す", () => {
+    const a = mockFinding({ id: "a", runId: "run_1", title: "Dashboard metric not accessible via API", body: "no endpoint for the metric card" });
+    const b = mockFinding({ id: "b", runId: "run_2", title: "Dashboard metrics not accessible via API", body: "no endpoint for the metric card" });
+    const c = mockFinding({ id: "c", runId: "run_3", title: "Dark mode toggle missing", body: "no way to switch themes" });
+    const result = findCrossRunDuplicates([a, b, c]);
+    expect(result).toHaveLength(1);
+    expect(result[0].map((f) => f.runId).sort()).toEqual(["run_1", "run_2"]);
+  });
+});

package/framework/__tests__/diary.test.ts

@@ -90,6 +90,22 @@ describe("generateDiary", () => {
     expect(params.messages[0].content).toContain("Login is broken");
   });
 
+  it("triage_result.json（timestamp を持たない集計ファイル）はプロンプトに混ぜない", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readdirSync).mockReturnValue(["f1.json", "triage_result.json"] as unknown as ReturnType<typeof fs.readdirSync>);
+    const finding = { id: "f1", runId: "run_123", agentId: "a", agentName: "A", role: "r", title: "Login is broken", body: "", category: "bug", timestamp: new Date().toISOString() };
+    const triageResult = { runId: "run_123", completedAt: "x", issued: [], skipped: [], unprocessed: [] };
+    vi.mocked(fs.readFileSync).mockImplementation((p: unknown) => {
+      const path = String(p);
+      if (path.endsWith("triage_result.json")) return JSON.stringify(triageResult) as unknown as ReturnType<typeof fs.readFileSync>;
+      return JSON.stringify(finding) as unknown as ReturnType<typeof fs.readFileSync>;
+    });
+
+    await generateDiary("run_123", []);
+    const [params] = mockCreateMessage.mock.calls[0];
+    expect(params.messages[0].content).not.toContain("undefined");
+  });
+
   it("ログが空の場合はプロンプトに「イベントログなし」を含める", async () => {
     await generateDiary("run_123", []);
     const [params] = mockCreateMessage.mock.calls[0];

package/framework/coverage.ts

@@ -231,9 +231,10 @@ export function getFindingHotspots(topN = 12): FindingHotspot[] {
     const dir = path.join(base, runDir);
     try {
       for (const file of fs.readdirSync(dir)) {
-        if (!file.endsWith(".json")) continue;
+        if (!file.endsWith(".json") || file === "triage_result.json") continue;
         try {
           const f: Finding = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
+          if (typeof f.category !== "string") continue;
           const p = extractPath(f);
           const entry = counts.get(p) ?? { total: 0, categories: {} };
           entry.total++;

package/framework/cross-run-dedup.ts

@@ -0,0 +1,43 @@
+import type { Finding } from "./types";
+
+function tokenize(text: string): Set<string> {
+  return new Set(text.toLowerCase().match(/[a-z0-9]+/g) ?? []);
+}
+
+function jaccard(a: Set<string>, b: Set<string>): number {
+  const intersection = [...a].filter((x) => b.has(x)).length;
+  const union = new Set([...a, ...b]).size;
+  return union === 0 ? 0 : intersection / union;
+}
+
+/**
+ * タイトル+本文の単語集合の Jaccard 係数で finding をクラスタリングする。
+ * triage は同一 run 内の重複しか除去しないため、run をまたいで
+ * 繰り返し報告されている問題を見つけるための補助。
+ */
+export function groupSimilarFindings(findings: Finding[], threshold = 0.3): Finding[][] {
+  const tokensByIndex = findings.map((f) => tokenize(`${f.title} ${f.body}`));
+  const seen = new Set<number>();
+  const clusters: Finding[][] = [];
+
+  for (let i = 0; i < findings.length; i++) {
+    if (seen.has(i)) continue;
+    const clusterIndices = [i];
+    for (let j = i + 1; j < findings.length; j++) {
+      if (seen.has(j)) continue;
+      if (jaccard(tokensByIndex[i], tokensByIndex[j]) >= threshold) {
+        clusterIndices.push(j);
+        seen.add(j);
+      }
+    }
+    seen.add(i);
+    clusters.push(clusterIndices.map((idx) => findings[idx]));
+  }
+
+  return clusters;
+}
+
+/** 2件以上で構成されるクラスタ（= run をまたいだ重複候補）のみ返す */
+export function findCrossRunDuplicates(findings: Finding[], threshold = 0.3): Finding[][] {
+  return groupSimilarFindings(findings, threshold).filter((cluster) => cluster.length > 1);
+}

package/framework/diary.ts

@@ -8,9 +8,11 @@ function loadFindings(runId: string): Finding[] {
   if (!fs.existsSync(dir)) return [];
   const out: Finding[] = [];
   for (const file of fs.readdirSync(dir)) {
-    if (!file.endsWith(".json")) continue;
+    if (!file.endsWith(".json") || file === "triage_result.json") continue;
     try {
-      out.push(JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8")));
+      const f: Finding = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
+      if (typeof f.timestamp !== "string") continue;
+      out.push(f);
     } catch { /* skip */ }
   }
   return out;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m8i-51/shoal",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "type": "module",
   "description": "Multi-agent web exploration framework — finds bugs, UX issues, and missing features by running AI agents against your app",
   "repository": {
@@ -42,7 +42,7 @@
     "express-rate-limit": "^8.5.0",
     "openai": "^6.33.0",
     "playwright": "^1.59.1",
-    "tsx": "^4.21.0",
+    "tsx": "^4.22.4",
     "yaml": "^2.9.0"
   },
   "devDependencies": {

package/server/__tests__/api.test.ts

@@ -15,7 +15,9 @@ vi.mock("express-rate-limit", () => ({ rateLimit: () => (_req: unknown, _res: un
 
 import * as fs from "fs";
 import { generateDiary, getDiaryPath } from "../../framework/diary.js";
-import { activeSessions } from "../runner.js";
+import { activeSessions, spawnRun, cancelSession } from "../runner.js";
+import { listRuns, getReportPath } from "../runs.js";
+import { loadSchedule } from "../scheduler.js";
 
 // NODE_ENV=test なので app.listen は呼ばれない
 const { app } = await import("../index.js");
@@ -66,6 +68,7 @@ function setupFindingsDir(runDirs: Record<string, object[]>) {
 }
 
 beforeEach(() => {
+  process.env.BASE_URL = "http://localhost:3000";
   vi.mocked(fs.existsSync).mockReturnValue(false);
   vi.mocked(fs.readdirSync).mockReturnValue([] as unknown as ReturnType<typeof fs.readdirSync>);
   vi.mocked(fs.readFileSync).mockReturnValue("{}" as unknown as ReturnType<typeof fs.readFileSync>);
@@ -169,6 +172,66 @@ describe("GET /api/findings", () => {
     const res = await request(app).get("/api/findings");
     expect(res.body).toEqual([]);
   });
+
+  it("triage_result.json（timestamp を持たない集計ファイル）は無視する", async () => {
+    const finding = mockFinding({ id: "f1", runId: "run_1", timestamp: "2026-01-01T00:00:00.000Z" });
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readdirSync).mockImplementation((p: unknown) => {
+      const path = String(p);
+      if (path.endsWith("run_1")) return ["f0.json", "triage_result.json"] as unknown as ReturnType<typeof fs.readdirSync>;
+      return ["run_1"] as unknown as ReturnType<typeof fs.readdirSync>;
+    });
+    vi.mocked(fs.readFileSync).mockImplementation((p: unknown) => {
+      const path = String(p);
+      if (path.endsWith("f0.json")) return JSON.stringify(finding) as unknown as ReturnType<typeof fs.readFileSync>;
+      if (path.endsWith("triage_result.json")) {
+        return JSON.stringify({ runId: "run_1", completedAt: "x", issued: [], skipped: [], unprocessed: [] }) as unknown as ReturnType<typeof fs.readFileSync>;
+      }
+      return "{}" as unknown as ReturnType<typeof fs.readFileSync>;
+    });
+    const res = await request(app).get("/api/findings");
+    expect(res.status).toBe(200);
+    expect(res.body).toHaveLength(1);
+    expect(res.body[0].id).toBe("f1");
+  });
+});
+
+// ================================================================
+// GET /api/findings/cross-run-duplicates
+// ================================================================
+describe("GET /api/findings/cross-run-duplicates", () => {
+  it("findings がない → 空配列", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(false);
+    const res = await request(app).get("/api/findings/cross-run-duplicates");
+    expect(res.status).toBe(200);
+    expect(res.body).toEqual([]);
+  });
+
+  it("run をまたいで似た finding をクラスタとして返す", async () => {
+    const a = mockFinding({
+      id: "f0", runId: "run_1",
+      title: "Dashboard metric not accessible via API",
+      body: "no API endpoint for the metric card",
+    });
+    const b = mockFinding({
+      id: "f0", runId: "run_2",
+      title: "Dashboard metrics not accessible via API",
+      body: "no API endpoint for the metric card",
+    });
+    setupFindingsDir({ run_1: [a], run_2: [b] });
+    const res = await request(app).get("/api/findings/cross-run-duplicates");
+    expect(res.status).toBe(200);
+    expect(res.body).toHaveLength(1);
+    expect(res.body[0]).toHaveLength(2);
+  });
+
+  it("似ていない finding しかない → 空配列", async () => {
+    const a = mockFinding({ id: "f0", runId: "run_1", title: "Login button broken", body: "click does nothing" });
+    const b = mockFinding({ id: "f0", runId: "run_2", title: "Dark mode missing", body: "no theme switch" });
+    setupFindingsDir({ run_1: [a], run_2: [b] });
+    const res = await request(app).get("/api/findings/cross-run-duplicates");
+    expect(res.body).toEqual([]);
+  });
 });
 
 // ================================================================
@@ -305,3 +368,215 @@ describe("PATCH /api/schedule", () => {
     expect(res.body.enabled).toBe(true);
   });
 });
+
+// ================================================================
+// GET /api/schedule
+// ================================================================
+describe("GET /api/schedule", () => {
+  it("loadSchedule の結果を返す", async () => {
+    vi.mocked(loadSchedule).mockReturnValue({ enabled: true, dayOfWeek: 3, hour: 10, minute: 30, lastRunDate: null });
+    const res = await request(app).get("/api/schedule");
+    expect(res.status).toBe(200);
+    expect(res.body).toEqual({ enabled: true, dayOfWeek: 3, hour: 10, minute: 30, lastRunDate: null });
+  });
+});
+
+// ================================================================
+// GET /api/spec
+// ================================================================
+describe("GET /api/spec", () => {
+  it("spec ファイルが存在しない → 404", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(false);
+    const res = await request(app).get("/api/spec");
+    expect(res.status).toBe(404);
+  });
+
+  it("spec ファイルが存在する → 200 + JSON", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readFileSync).mockReturnValue(JSON.stringify({ appGoals: ["goal1"] }) as unknown as ReturnType<typeof fs.readFileSync>);
+    const res = await request(app).get("/api/spec");
+    expect(res.status).toBe(200);
+    expect(res.body.appGoals).toEqual(["goal1"]);
+  });
+
+  it("spec ファイルの JSON が壊れている → 500", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readFileSync).mockReturnValue("not json" as unknown as ReturnType<typeof fs.readFileSync>);
+    const res = await request(app).get("/api/spec");
+    expect(res.status).toBe(500);
+  });
+});
+
+// ================================================================
+// PATCH /api/spec/goals
+// ================================================================
+describe("PATCH /api/spec/goals", () => {
+  it("spec ファイルが存在しない → 404", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(false);
+    const res = await request(app).patch("/api/spec/goals").send({ goals: ["a"] });
+    expect(res.status).toBe(404);
+  });
+
+  it("goals が配列でない → 400", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    const res = await request(app).patch("/api/spec/goals").send({ goals: "not-an-array" });
+    expect(res.status).toBe(400);
+  });
+
+  it("goals に文字列以外が含まれる → 400", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    const res = await request(app).patch("/api/spec/goals").send({ goals: ["a", 1] });
+    expect(res.status).toBe(400);
+  });
+
+  it("正常な goals → 200 + ok:true、ファイルに書き込む", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readFileSync).mockReturnValue(JSON.stringify({ appGoals: [] }) as unknown as ReturnType<typeof fs.readFileSync>);
+    const res = await request(app).patch("/api/spec/goals").send({ goals: ["new goal"] });
+    expect(res.status).toBe(200);
+    expect(res.body.ok).toBe(true);
+    expect(fs.writeFileSync).toHaveBeenCalled();
+  });
+
+  it("spec ファイルの読み込みに失敗 → 500", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readFileSync).mockReturnValue("not json" as unknown as ReturnType<typeof fs.readFileSync>);
+    const res = await request(app).patch("/api/spec/goals").send({ goals: ["a"] });
+    expect(res.status).toBe(500);
+  });
+});
+
+// ================================================================
+// GET /api/runs
+// ================================================================
+describe("GET /api/runs", () => {
+  it("listRuns の結果をそのまま返す（アクティブセッションなし）", async () => {
+    vi.mocked(listRuns).mockReturnValue([{ runId: "run_1", isLive: false } as never]);
+    const res = await request(app).get("/api/runs");
+    expect(res.status).toBe(200);
+    expect(res.body).toEqual([{ runId: "run_1", isLive: false }]);
+  });
+
+  it("アクティブセッションがある run は isLive で補完される", async () => {
+    vi.mocked(listRuns).mockReturnValue([{ runId: "run_2", isLive: false } as never]);
+    (activeSessions as Map<string, unknown>).set("run_2", { done: false });
+    const res = await request(app).get("/api/runs");
+    expect(res.status).toBe(200);
+    expect(res.body[0].isLive).toBe(true);
+  });
+});
+
+// ================================================================
+// GET /api/runs/:runId/report
+// ================================================================
+describe("GET /api/runs/:runId/report", () => {
+  it("不正な runId → 400", async () => {
+    const res = await request(app).get("/api/runs/bad-id/report");
+    expect(res.status).toBe(400);
+  });
+
+  it("report が見つからない → 404", async () => {
+    vi.mocked(getReportPath).mockReturnValue(null);
+    const res = await request(app).get("/api/runs/run_123/report");
+    expect(res.status).toBe(404);
+  });
+});
+
+// ================================================================
+// POST /api/runs/start
+// ================================================================
+describe("POST /api/runs/start", () => {
+  it("spawnRun を呼んで sessionId を返す", async () => {
+    vi.mocked(spawnRun).mockReturnValue("run_999");
+    const res = await request(app).post("/api/runs/start").send({ baseUrl: "https://example.com" });
+    expect(res.status).toBe(200);
+    expect(res.body.sessionId).toBe("run_999");
+    expect(spawnRun).toHaveBeenCalledWith(expect.objectContaining({ baseUrl: "https://example.com" }));
+  });
+});
+
+// ================================================================
+// POST /api/runs/:runId/cancel
+// ================================================================
+describe("POST /api/runs/:runId/cancel", () => {
+  it("cancelSession の結果を ok として返す（成功）", async () => {
+    vi.mocked(cancelSession).mockReturnValue(true);
+    const res = await request(app).post("/api/runs/run_123/cancel");
+    expect(res.status).toBe(200);
+    expect(res.body.ok).toBe(true);
+  });
+
+  it("cancelSession の結果を ok として返す（失敗）", async () => {
+    vi.mocked(cancelSession).mockReturnValue(false);
+    const res = await request(app).post("/api/runs/run_123/cancel");
+    expect(res.status).toBe(200);
+    expect(res.body.ok).toBe(false);
+  });
+});
+
+// ================================================================
+// GET /api/runs/:runId/log
+// ================================================================
+describe("GET /api/runs/:runId/log", () => {
+  it("不正な runId → 400", async () => {
+    const res = await request(app).get("/api/runs/bad-id/log");
+    expect(res.status).toBe(400);
+  });
+
+  it("アクティブセッションがある → session 情報を返す", async () => {
+    (activeSessions as Map<string, unknown>).set("run_123", { lines: ["a", "b"], done: false, exitCode: null });
+    const res = await request(app).get("/api/runs/run_123/log");
+    expect(res.status).toBe(200);
+    expect(res.body.lines).toEqual(["a", "b"]);
+    expect(res.body.done).toBe(false);
+  });
+
+  it("アクティブセッションなし + ログファイルあり → ファイルから読む", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    vi.mocked(fs.readFileSync).mockReturnValue("line1\nline2\n" as unknown as ReturnType<typeof fs.readFileSync>);
+    const res = await request(app).get("/api/runs/run_123/log");
+    expect(res.status).toBe(200);
+    expect(res.body.lines).toEqual(["line1", "line2"]);
+    expect(res.body.done).toBe(true);
+  });
+
+  it("アクティブセッションもログファイルもない → 404", async () => {
+    vi.mocked(fs.existsSync).mockReturnValue(false);
+    const res = await request(app).get("/api/runs/run_123/log");
+    expect(res.status).toBe(404);
+  });
+});
+
+// ================================================================
+// SSE: /api/sessions/:sessionId/events, /api/runs/:runId/events
+// ================================================================
+describe("SSE events", () => {
+  it("/api/sessions/:sessionId/events 不正な sessionId → 400", async () => {
+    const res = await request(app).get("/api/sessions/bad-id/events");
+    expect(res.status).toBe(400);
+  });
+
+  it("/api/runs/:runId/events 不正な runId → 400", async () => {
+    const res = await request(app).get("/api/runs/bad-id/events");
+    expect(res.status).toBe(400);
+  });
+
+  it("/api/sessions/:sessionId/events セッションが存在しない → 404", async () => {
+    const res = await request(app).get("/api/sessions/run_404/events");
+    expect(res.status).toBe(404);
+  });
+
+  it("/api/runs/:runId/events 完了済みセッション → イベントを送信して終了", async () => {
+    (activeSessions as Map<string, unknown>).set("run_555", {
+      lines: ["log line"],
+      done: true,
+      exitCode: 0,
+      listeners: [],
+      doneListeners: [],
+    });
+    const res = await request(app).get("/api/runs/run_555/events");
+    expect(res.status).toBe(200);
+    expect(res.text).toContain("log line");
+    expect(res.text).toContain("event: done");
+  });
+});

package/server/__tests__/runs.test.ts

@@ -0,0 +1,186 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+vi.mock("fs");
+
+import * as fs from "fs";
+import { listRuns, getReportPath } from "../runs";
+import type { RunLog, Finding } from "../../framework/types";
+
+function mockRunLog(overrides: Partial<RunLog> = {}): RunLog {
+  return {
+    runId: "run_1",
+    startedAt: "2026-01-01T00:00:00.000Z",
+    completedAt: "2026-01-01T00:05:00.000Z",
+    repo: "test",
+    agents: [],
+    summary: {
+      totalAgents: 0,
+      completed: 0,
+      errors: 0,
+      iterationLimitReached: 0,
+      totalActions: 0,
+      totalIssuesPosted: 0,
+      regressionChecked: 0,
+      regressionFailed: 0,
+      rateLimitRetries: 0,
+      cost: { inputTokens: 0, outputTokens: 0, estimatedUSD: null },
+    },
+    ...overrides,
+  };
+}
+
+function mockFinding(overrides: Partial<Finding> = {}): Finding {
+  return {
+    id: "f1",
+    runId: "run_1",
+    agentId: "a1",
+    agentName: "Alice",
+    role: "tester",
+    title: "title",
+    body: "body",
+    category: "bug",
+    timestamp: "2026-01-01T00:00:00.000Z",
+    ...overrides,
+  };
+}
+
+beforeEach(() => {
+  vi.mocked(fs.existsSync).mockReturnValue(false);
+  vi.mocked(fs.readdirSync).mockReturnValue([] as unknown as ReturnType<typeof fs.readdirSync>);
+  vi.mocked(fs.readFileSync).mockReturnValue("{}" as unknown as ReturnType<typeof fs.readFileSync>);
+});
+
+describe("listRuns", () => {
+  it("logs ディレクトリがない → 空配列", () => {
+    vi.mocked(fs.existsSync).mockReturnValue(false);
+    expect(listRuns()).toEqual([]);
+  });
+
+  it("running_*.json から実行中の run を isLive:true で返す", () => {
+    vi.mocked(fs.existsSync).mockImplementation((p: unknown) => String(p).endsWith("logs"));
+    vi.mocked(fs.readdirSync).mockReturnValue(["running_run_live.json"] as unknown as ReturnType<typeof fs.readdirSync>);
+    vi.mocked(fs.readFileSync).mockReturnValue(
+      JSON.stringify({ runId: "run_live", startedAt: "2026-06-01T00:00:00.000Z" }) as unknown as ReturnType<typeof fs.readFileSync>
+    );
+    const result = listRuns();
+    expect(result).toHaveLength(1);
+    expect(result[0]).toMatchObject({ runId: "run_live", status: "running", isLive: true });
+  });
+
+  it("report_ プレフィックスのファイルは run ログとして扱わない", () => {
+    vi.mocked(fs.existsSync).mockImplementation((p: unknown) => String(p).endsWith("logs"));
+    vi.mocked(fs.readdirSync).mockReturnValue(["report_run_1.html"] as unknown as ReturnType<typeof fs.readdirSync>);
+    expect(listRuns()).toEqual([]);
+  });
+
+  it("通常の run ログを完了状態のサマリーに変換する", () => {
+    const log = mockRunLog({
+      runId: "run_done",
+      agents: [
+        { agentType: "explorer", agentId: "a1", agentName: "A", role: "r", startedAt: "", completedAt: null, status: "completed", iterations: 1, actions: [], visitedPaths: [], issuesPosted: [], regressionChecks: [], error: null },
+        { agentType: "explorer", agentId: "a2", agentName: "B", role: "r", startedAt: "", completedAt: null, status: "error", iterations: 1, actions: [], visitedPaths: [], issuesPosted: [], regressionChecks: [], error: "x" },
+      ],
+    });
+    vi.mocked(fs.existsSync).mockImplementation((p: unknown) => String(p).endsWith("logs"));
+    vi.mocked(fs.readdirSync).mockReturnValue(["2026-01-01T00-00-00_run_done.json"] as unknown as ReturnType<typeof fs.readdirSync>);
+    vi.mocked(fs.readFileSync).mockReturnValue(JSON.stringify(log) as unknown as ReturnType<typeof fs.readFileSync>);
+
+    const result = listRuns();
+    expect(result).toHaveLength(1);
+    expect(result[0]).toMatchObject({
+      runId: "run_done",
+      status: "completed",
+      agentCount: 2,
+      completedAgents: 1,
+      errorAgents: 1,
+      hasReport: false,
+    });
+  });
+
+  it("findings/run_id/ 内の finding を category 別に集計する（triage_result.json は除外）", () => {
+    const log = mockRunLog({ runId: "run_with_findings" });
+    vi.mocked(fs.existsSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      return s.endsWith("logs") || s.endsWith("findings/run_with_findings") || s.includes("findings") && s.endsWith("run_with_findings");
+    });
+    vi.mocked(fs.readdirSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.endsWith("logs")) return ["2026-01-01T00-00-00_run_with_findings.json"] as unknown as ReturnType<typeof fs.readdirSync>;
+      return ["f0.json", "f1.json", "triage_result.json"] as unknown as ReturnType<typeof fs.readdirSync>;
+    });
+    vi.mocked(fs.readFileSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.endsWith("f0.json")) return JSON.stringify(mockFinding({ id: "f0", category: "bug" })) as unknown as ReturnType<typeof fs.readFileSync>;
+      if (s.endsWith("f1.json")) return JSON.stringify(mockFinding({ id: "f1", category: "ux" })) as unknown as ReturnType<typeof fs.readFileSync>;
+      if (s.endsWith("triage_result.json")) {
+        return JSON.stringify({ runId: "run_with_findings", completedAt: "x", issued: [], skipped: [], unprocessed: [] }) as unknown as ReturnType<typeof fs.readFileSync>;
+      }
+      return JSON.stringify(log) as unknown as ReturnType<typeof fs.readFileSync>;
+    });
+
+    const result = listRuns();
+    expect(result).toHaveLength(1);
+    expect(result[0].findingCount).toBe(2);
+    expect(result[0].findingsByCategory).toEqual({ bug: 1, ux: 1 });
+  });
+
+  it("同じ runId が複数ファイルに登場しても重複しない", () => {
+    vi.mocked(fs.existsSync).mockImplementation((p: unknown) => String(p).endsWith("logs"));
+    vi.mocked(fs.readdirSync).mockReturnValue([
+      "running_run_dup.json",
+      "2026-01-01T00-00-00_run_dup.json",
+    ] as unknown as ReturnType<typeof fs.readdirSync>);
+    vi.mocked(fs.readFileSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes("running_run_dup")) {
+        return JSON.stringify({ runId: "run_dup", startedAt: "2026-01-01T00:00:00.000Z" }) as unknown as ReturnType<typeof fs.readFileSync>;
+      }
+      return JSON.stringify(mockRunLog({ runId: "run_dup" })) as unknown as ReturnType<typeof fs.readFileSync>;
+    });
+
+    const result = listRuns();
+    expect(result).toHaveLength(1);
+    expect(result[0].isLive).toBe(true);
+  });
+
+  it("startedAt の降順でソートされる", () => {
+    const older = mockRunLog({ runId: "run_old", startedAt: "2026-01-01T00:00:00.000Z" });
+    const newer = mockRunLog({ runId: "run_new", startedAt: "2026-06-01T00:00:00.000Z" });
+    vi.mocked(fs.existsSync).mockImplementation((p: unknown) => String(p).endsWith("logs"));
+    vi.mocked(fs.readdirSync).mockReturnValue([
+      "2026-01-01T00-00-00_run_old.json",
+      "2026-06-01T00-00-00_run_new.json",
+    ] as unknown as ReturnType<typeof fs.readdirSync>);
+    vi.mocked(fs.readFileSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes("run_old")) return JSON.stringify(older) as unknown as ReturnType<typeof fs.readFileSync>;
+      return JSON.stringify(newer) as unknown as ReturnType<typeof fs.readFileSync>;
+    });
+
+    const result = listRuns();
+    expect(result.map((r) => r.runId)).toEqual(["run_new", "run_old"]);
+  });
+
+  it("壊れた JSON の run ログはスキップする", () => {
+    vi.mocked(fs.existsSync).mockImplementation((p: unknown) => String(p).endsWith("logs"));
+    vi.mocked(fs.readdirSync).mockReturnValue(["2026-01-01T00-00-00_run_broken.json"] as unknown as ReturnType<typeof fs.readdirSync>);
+    vi.mocked(fs.readFileSync).mockReturnValue("not json" as unknown as ReturnType<typeof fs.readFileSync>);
+    expect(listRuns()).toEqual([]);
+  });
+});
+
+describe("getReportPath", () => {
+  it("不正な runId → null", () => {
+    expect(getReportPath("bad-id")).toBeNull();
+  });
+
+  it("report ファイルが存在しない → null", () => {
+    vi.mocked(fs.existsSync).mockReturnValue(false);
+    expect(getReportPath("run_123")).toBeNull();
+  });
+
+  it("report ファイルが存在する → パスを返す", () => {
+    vi.mocked(fs.existsSync).mockReturnValue(true);
+    expect(getReportPath("run_123")).toMatch(/report_run_123\.html$/);
+  });
+});

package/server/index.ts

@@ -8,6 +8,7 @@ import { listRuns, getReportPath } from "./runs.js";
 import { activeSessions, spawnRun, cancelSession } from "./runner.js";
 import { loadSchedule, saveSchedule, startScheduler, type ScheduleConfig } from "./scheduler.js";
 import { generateDiary, getDiaryPath } from "../framework/diary.js";
+import { findCrossRunDuplicates } from "../framework/cross-run-dedup.js";
 import type { Finding } from "../framework/types.js";
 
 function specFilePath(baseUrl: string): string {
@@ -141,9 +142,10 @@ function loadAllFindings(): (Finding & { runId: string })[] {
     const dir = join(base, runDir);
     try {
       for (const file of readdirSync(dir)) {
-        if (!file.endsWith(".json")) continue;
+        if (!file.endsWith(".json") || file === "triage_result.json") continue;
         try {
           const f: Finding = JSON.parse(readFileSync(join(dir, file), "utf-8"));
+          if (typeof f.timestamp !== "string") continue;
           all.push({ ...f, runId: runDir });
         } catch { /* skip */ }
       }
@@ -156,6 +158,10 @@ app.get("/api/findings", (_req, res) => {
   res.json(loadAllFindings());
 });
 
+app.get("/api/findings/cross-run-duplicates", (_req, res) => {
+  res.json(findCrossRunDuplicates(loadAllFindings()));
+});
+
 app.get("/api/findings/export", (_req, res) => {
   const findings = loadAllFindings().map(({ id, title, body, category, agentName, role, timestamp, runId }) => ({
     id, title, body, category, agentName, role, timestamp, runId,
@@ -321,6 +327,27 @@ app.get("/api/runs/:runId/log", (req, res) => {
   res.status(404).json({ error: "no log found" });
 });
 
+// ----------------------------------------------------------------
+// API: schedule config
+// ----------------------------------------------------------------
+app.get("/api/schedule", (_req, res) => {
+  res.json(loadSchedule());
+});
+
+app.patch("/api/schedule", (req, res) => {
+  const current = loadSchedule();
+  const { enabled, dayOfWeek, hour, minute } = req.body as Partial<ScheduleConfig>;
+  const updated: ScheduleConfig = {
+    ...current,
+    ...(enabled != null ? { enabled: Boolean(enabled) } : {}),
+    ...(dayOfWeek != null && Number.isInteger(dayOfWeek) && dayOfWeek >= 0 && dayOfWeek <= 6 ? { dayOfWeek } : {}),
+    ...(hour != null && Number.isInteger(hour) && hour >= 0 && hour <= 23 ? { hour } : {}),
+    ...(minute != null && Number.isInteger(minute) && minute >= 0 && minute <= 59 ? { minute } : {}),
+  };
+  saveSchedule(updated);
+  res.json(updated);
+});
+
 // ----------------------------------------------------------------
 // Static: serve built React app
 // ----------------------------------------------------------------
@@ -352,27 +379,6 @@ process.on("unhandledRejection", (reason) => {
   console.error("[server] unhandledRejection:", reason);
 });
 
-// ----------------------------------------------------------------
-// API: schedule config
-// ----------------------------------------------------------------
-app.get("/api/schedule", (_req, res) => {
-  res.json(loadSchedule());
-});
-
-app.patch("/api/schedule", (req, res) => {
-  const current = loadSchedule();
-  const { enabled, dayOfWeek, hour, minute } = req.body as Partial<ScheduleConfig>;
-  const updated: ScheduleConfig = {
-    ...current,
-    ...(enabled != null ? { enabled: Boolean(enabled) } : {}),
-    ...(dayOfWeek != null && Number.isInteger(dayOfWeek) && dayOfWeek >= 0 && dayOfWeek <= 6 ? { dayOfWeek } : {}),
-    ...(hour != null && Number.isInteger(hour) && hour >= 0 && hour <= 23 ? { hour } : {}),
-    ...(minute != null && Number.isInteger(minute) && minute >= 0 && minute <= 59 ? { minute } : {}),
-  };
-  saveSchedule(updated);
-  res.json(updated);
-});
-
 export { app };
 
 if (process.env.NODE_ENV !== "test") {

package/server/runs.ts

@@ -25,9 +25,10 @@ function countFindings(runId: string): { total: number; byCategory: Record<strin
   const byCategory: Record<string, number> = {};
   let total = 0;
   for (const file of fs.readdirSync(dir)) {
-    if (!file.endsWith(".json")) continue;
+    if (!file.endsWith(".json") || file === "triage_result.json") continue;
     try {
       const f: Finding = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
+      if (typeof f.category !== "string") continue;
       byCategory[f.category] = (byCategory[f.category] ?? 0) + 1;
       total++;
     } catch {