@clubs.place/cli 0.0.0-stage → 0.1.17

package/src/aggregate.mjs

@@ -0,0 +1,105 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+/**
+ * 収集元が集めた生イベントから、日報に載せる数字を出す。
+ *
+ * 収集元ごとに同じ計算を書くと、Claude Code と Cowork を合算したときに
+ * 「実働の合計」が二重に足されるなどのズレが出る。集計はここ1か所に集める。
+ *
+ * events: [{ id, name, summary, time, ms, project, ok, model }]
+ *   ok    … true=成功 / false=失敗 / null=成否不明（成功率の分母から外す）
+ *   model … その実行に使ったモデル。記録していなければ null
+ */
+
+/** 隣接イベントの間隔を idleGapMin で打ち切って足し込む＝実働の推定値。 */
+const estimateActiveMinutes = (timestampsMs, idleGapMin) => {
+  if (timestampsMs.length < 2) return timestampsMs.length === 1 ? 1 : 0;
+  const sorted = [...timestampsMs].sort((a, b) => a - b);
+  const capMs = idleGapMin * 60_000;
+  let total = 0;
+  for (let i = 1; i < sorted.length; i += 1) {
+    total += Math.min(sorted[i] - sorted[i - 1], capMs);
+  }
+  return Math.round(total / 60_000);
+};
+
+export const computeAggregates = ({ events, sessions, idleGapMin }) => {
+  // 複数の収集元を合算する場合、イベントは時系列で混ざる。
+  // 実働はマージ後の全イベント列から出す（収集元ごとに出して足すと、
+  // 同じ時間帯に両方動いていた分が二重に計上される）。
+  const sorted = [...events].sort((a, b) => a.ms - b.ms);
+
+  const withResult = sorted.filter((e) => e.ok !== null && e.ok !== undefined);
+  const failed = withResult.filter((e) => e.ok === false);
+  const successRate =
+    withResult.length === 0
+      ? null
+      : Math.round(((withResult.length - failed.length) / withResult.length) * 100);
+
+  const toolCounts = {};
+  for (const e of sorted) toolCounts[e.name] = (toolCounts[e.name] ?? 0) + 1;
+
+  const projects = [...new Set(sorted.map((e) => e.project).filter(Boolean))];
+
+  // モデルの内訳。OpenRouter 等で切り替えるエージェントは1日に複数のモデルを使う。
+  // 静的なモデル名を1つ掲げると、半分の作業を別モデルがやったのに嘘になる。
+  // 記録が無ければ空のまま（無いものを在ることにしない）。
+  const modelCounts = {};
+  for (const e of sorted) {
+    if (e.model) modelCounts[e.model] = (modelCounts[e.model] ?? 0) + 1;
+  }
+
+  // ── カード判定に要る軸 ────────────────────────────────
+  // いずれもイベント列から機械的に出る。無い情報は作らない。
+
+  // 時間帯別の実行数（night3・owl の判定に使う）
+  const eventsByHour = new Array(24).fill(0);
+  for (const e of sorted) {
+    const h = Number(String(e.time).slice(0, 2));
+    if (Number.isInteger(h) && h >= 0 && h < 24) eventsByHour[h] += 1;
+  }
+
+  // 午前／午後のツール内訳（two_face の判定に使う）
+  const toolCountsAm = {};
+  const toolCountsPm = {};
+  for (const e of sorted) {
+    const h = Number(String(e.time).slice(0, 2));
+    const bucket = h < 12 ? toolCountsAm : toolCountsPm;
+    bucket[e.name] = (bucket[e.name] ?? 0) + 1;
+  }
+
+  // 序盤（最初の1/3）の失敗率（comeback の判定に使う）。
+  // 「序盤は失敗していたが、最終的に立て直した」を言うには、日内の推移が要る。
+  const early = withResult.slice(0, Math.max(1, Math.ceil(withResult.length / 3)));
+  const earlyFailRate =
+    early.length === 0
+      ? null
+      : Math.round((early.filter((e) => e.ok === false).length / early.length) * 100);
+
+  const activeMinutes = estimateActiveMinutes(
+    sorted.map((e) => e.ms),
+    idleGapMin,
+  );
+
+  return {
+    totalCalls: sorted.length,
+    resolvedCalls: withResult.length,
+    failedCalls: failed.length,
+    successRate,
+    activeMinutes,
+    activeHours: Math.round((activeMinutes / 60) * 10) / 10,
+    toolCounts,
+    toolCountsAm,
+    toolCountsPm,
+    eventsByHour,
+    earlyFailRate,
+    modelCounts,
+    sessions: sessions.size,
+    projects,
+    firstAt: sorted.at(0)?.time ?? null,
+    lastAt: sorted.at(-1)?.time ?? null,
+  };
+};

package/src/autorun.mjs

@@ -0,0 +1,25 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { platform as osPlatform } from "node:os";
+
+/**
+ * 毎時のティックを実行するコマンド。launchd（macOS）と crontab で同じ形を使う。
+ *
+ * macOS では `caffeinate` で包む。Mac が寝ていると launchd はジョブを保守用の
+ * 短い目覚め（DarkWake・既定45秒）の隙に起こすが、本文生成（最大240秒）も
+ * clubsx 取込（15秒）もその窓に収まらない。途中で二度寝されるとプロセスも
+ * タイマーも凍結し、本文は fallback に落ち、取込は `This operation was aborted`
+ * で死ぬ（docs/troubleshooting-narrative.md 項5）。実行中だけスリープを止める。
+ *
+ * `caffeinate` は macOS にしか無いので、他のプラットフォームでは包まない。
+ */
+export const tickCommand = (npx, plat = osPlatform()) => [
+  ...(plat === "darwin" ? ["/usr/bin/caffeinate", "-s", "-i", "--"] : []),
+  npx,
+  "-y",
+  "clubs-nippo@latest",
+  "tick",
+];

package/src/autorun.test.mjs

@@ -0,0 +1,43 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { tickCommand } from "./autorun.mjs";
+
+/* この形は一度、直したはずが実装に入らないまま消えている（PR #32 は docs だけ
+   直っていた）。plist を書き出す側が素の npx に戻ると、朝の日報が DarkWake の
+   45秒で凍結して届かなくなるので、コマンドの形をここで固定する。 */
+
+const NPX = "/opt/homebrew/bin/npx";
+
+test("macOS では caffeinate で包む（実行中のスリープを止める）", () => {
+  assert.deepEqual(tickCommand(NPX, "darwin"), [
+    "/usr/bin/caffeinate",
+    "-s",
+    "-i",
+    "--",
+    NPX,
+    "-y",
+    "clubs-nippo@latest",
+    "tick",
+  ]);
+});
+
+test("macOS 以外では包まない（caffeinate が無い）", () => {
+  for (const plat of ["linux", "freebsd", "win32"]) {
+    assert.deepEqual(tickCommand(NPX, plat), [NPX, "-y", "clubs-nippo@latest", "tick"]);
+  }
+});
+
+test("npx はフルパスのまま渡す（cron の細い PATH で見つからないため）", () => {
+  assert.ok(tickCommand(NPX, "darwin").includes(NPX));
+  assert.ok(tickCommand(NPX, "linux").includes(NPX));
+});
+
+test("caffeinate の引数の後に `--` があり、npx がユーティリティとして渡る", () => {
+  const cmd = tickCommand(NPX, "darwin");
+  assert.equal(cmd[cmd.indexOf("--") + 1], NPX, "`--` の直後は実行するコマンド");
+});

package/src/cards.mjs

@@ -0,0 +1,406 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { APP_HOME } from "./config.mjs";
+
+/**
+ * 達成カードの評価エンジン。
+ *
+ * カタログは docs/card-catalog.md が正。ここはそのプリセットを機械的に判定するだけで、
+ * LLM は使わない。判定材料は日報の検証済み集計（docHash を Lemma に登録済み）だけ。
+ *
+ * 規律:
+ * - 達成カードは剥奪しない（過去の記録なので消えない）。cards.json は追記のみ。
+ * - 称号は一度だけ（earnedAt が既にあれば再発行しない）。
+ * - 権限は「解放可能」フラグを立てるだけ。**付与はしない**（人間の承認が要る）。
+ * - しきい値はハードコードしない（config 経由）。チームごとに違うため。
+ * - 材料が無い条件は評価しない（unavailable）。無いものを在ることにしない。
+ */
+
+const CARDS_PATH = () => join(APP_HOME, "out", "cards.json");
+
+const RARITY = { COMMON: 0, RARE: 1, EPIC: 2, LEGENDARY: 3 };
+
+/** EPIC 以上だけ AI の引用を出す。それ未満は副題だけ。 */
+export const hasQuote = (rarity) => RARITY[rarity] >= RARITY.EPIC;
+
+const topTool = (counts) => {
+  const entries = Object.entries(counts ?? {});
+  if (entries.length === 0) return null;
+  return entries.sort((a, b) => b[1] - a[1])[0][0];
+};
+
+const sum = (counts) => Object.values(counts ?? {}).reduce((a, b) => a + b, 0);
+
+/** 直近から遡って条件を満たし続けた日数。 */
+const streakOf = (history, pred) => {
+  let n = 0;
+  for (let i = history.length - 1; i >= 0; i -= 1) {
+    if (!pred(history[i])) break;
+    n += 1;
+  }
+  return n;
+};
+
+/** 条件を満たした日の累計。 */
+const countOf = (history, pred) => history.filter(pred).length;
+
+// ─────────────────────────────────────────────────────────
+// カタログ（docs/card-catalog.md §2 が正）
+//
+// test(ctx) は次のいずれかを返す:
+//   { ok: true }                      … 発行する
+//   { ok: false, progress: 0..100 }   … まだ。進捗だけ出す
+//   { unavailable: "理由" }           … 判定材料が無い。評価しない
+// ─────────────────────────────────────────────────────────
+
+export const CATALOG = [
+  // ── 効く実績（権限に効く・質ゲート）────────────────────
+  {
+    id: "first_shot",
+    domain: "dev",
+    name: "早撃ち名人",
+    subtitle: "一発で通した率が高い日",
+    rarity: "COMMON",
+    kind: "effect",
+    tw: "first_shot",
+    effectPermission: "review_trust",
+    // 一発通過率は今の収集元から出ない。捏造せず、評価しない。
+    test: () => ({ unavailable: "firstTrySuccessRate が収集されていません" }),
+  },
+  {
+    id: "grit",
+    domain: "dev",
+    name: "粘り腰",
+    subtitle: "リトライから成功にこぎ着けた",
+    rarity: "COMMON",
+    kind: "effect",
+    tw: "grit",
+    effectPermission: null,
+    test: ({ today }) =>
+      today.failedCalls >= 3 && (today.successRate ?? 0) >= 90
+        ? { ok: true }
+        : { ok: false },
+  },
+  {
+    id: "comeback",
+    domain: "dev",
+    name: "闘魂の逆走",
+    subtitle: "失敗続きから成功率95%へ立て直し",
+    rarity: "RARE",
+    kind: "effect",
+    tw: "comeback",
+    effectPermission: "review_trust",
+    test: ({ today, cfg }) => {
+      if (today.earlyFailRate === null || today.earlyFailRate === undefined) {
+        return { unavailable: "序盤の失敗率が出せません（実行数が足りない）" };
+      }
+      return today.earlyFailRate >= cfg.comebackEarlyFail &&
+        (today.successRate ?? 0) >= cfg.comebackFinalRate
+        ? { ok: true }
+        : { ok: false };
+    },
+  },
+  {
+    id: "zero_dt",
+    domain: "dev",
+    name: "ゼロダウンタイムの守護者",
+    subtitle: "大仕事を失敗ゼロで完走",
+    rarity: "EPIC",
+    kind: "effect",
+    tw: "zero_dt",
+    effectPermission: "deploy_prod",
+    quote: "落とさないことが仕事です。派手ではありませんが、そこは譲れません。",
+    test: ({ today, cfg }) => {
+      if (today.totalCalls >= cfg.bigjobCalls && today.failedCalls === 0) return { ok: true };
+
+      // 失敗が出た時点でその日はもう取れない。実行回数だけで進捗を出すと
+      // 「あと1%」のように見えてしまい、事実と違う。
+      if (today.failedCalls > 0) return { ok: false };
+
+      return {
+        ok: false,
+        progress: Math.min(100, Math.round((today.totalCalls / cfg.bigjobCalls) * 100)),
+      };
+    },
+  },
+  {
+    id: "iron_streak",
+    domain: "dev",
+    name: "不屈の連勤",
+    subtitle: "失敗ゼロの日を継続",
+    rarity: "RARE",
+    kind: "effect",
+    tw: "iron",
+    effectPermission: "secrets_read",
+    test: ({ history, cfg }) => {
+      const days = streakOf(history, (h) => h.failedCalls === 0 && h.totalCalls > 0);
+      return days >= cfg.noFailDays
+        ? { ok: true }
+        : { ok: false, progress: Math.round((days / cfg.noFailDays) * 100) };
+    },
+  },
+
+  // ── 効く実績（税理士）─────────────────────────────────
+  {
+    id: "clean_submit",
+    domain: "tax",
+    name: "一筆入魂",
+    subtitle: "差し戻しゼロで提出",
+    rarity: "RARE",
+    kind: "effect",
+    tw: "clean",
+    effectPermission: "deleg_l3",
+    test: () => ({ unavailable: "差し戻し（reworkRate）が収集されていません" }),
+  },
+  {
+    id: "precision",
+    domain: "tax",
+    name: "不敗の検算王",
+    subtitle: "差し戻し率1%未満を継続",
+    rarity: "EPIC",
+    kind: "effect",
+    tw: "precision",
+    effectPermission: "deleg_l3",
+    quote: "見直しの一手間が、あとの全部を助けます。",
+    test: () => ({ unavailable: "差し戻し（reworkRate）が収集されていません" }),
+  },
+
+  // ── 称号（型・一度だけ・剥奪なし）──────────────────────
+  {
+    id: "owl",
+    name: "夜フクロウ",
+    subtitle: "稼働が夜に寄る型",
+    rarity: "COMMON",
+    kind: "title",
+    tw: "owl",
+    test: ({ history, cfg }) => {
+      const days = countOf(history, (h) => (h.lastAt ?? "") >= cfg.owlAfter);
+      return days >= cfg.titleDays
+        ? { ok: true }
+        : { ok: false, progress: Math.round((days / cfg.titleDays) * 100) };
+    },
+  },
+  {
+    id: "cleaner",
+    name: "整理整頓の鬼",
+    subtitle: "Edit 中心の働き方",
+    rarity: "COMMON",
+    kind: "title",
+    tw: "cleaner",
+    test: ({ history, cfg }) => {
+      const days = countOf(history, (h) => topTool(h.toolCounts) === "Edit");
+      return days >= cfg.titleDays
+        ? { ok: true }
+        : { ok: false, progress: Math.round((days / cfg.titleDays) * 100) };
+    },
+  },
+  {
+    id: "scout",
+    name: "影の立役者",
+    subtitle: "Read・Grep 中心・土台を支える",
+    rarity: "RARE",
+    kind: "title",
+    tw: "scout",
+    test: ({ history, cfg }) => {
+      const days = countOf(history, (h) => {
+        const total = sum(h.toolCounts);
+        if (total === 0) return false;
+        const scoutish = (h.toolCounts.Read ?? 0) + (h.toolCounts.Grep ?? 0);
+        return scoutish / total > 0.5;
+      });
+      return days >= cfg.titleDays
+        ? { ok: true }
+        : { ok: false, progress: Math.round((days / cfg.titleDays) * 100) };
+    },
+  },
+  {
+    id: "builder",
+    name: "建築家",
+    subtitle: "Write 中心・新規を書く",
+    rarity: "RARE",
+    kind: "title",
+    tw: "builder",
+    test: ({ history, cfg }) => {
+      const days = countOf(history, (h) => topTool(h.toolCounts) === "Write");
+      return days >= cfg.titleDays
+        ? { ok: true }
+        : { ok: false, progress: Math.round((days / cfg.titleDays) * 100) };
+    },
+  },
+
+  // ── ネタ（狙って取れない・剥奪なし）────────────────────
+  {
+    id: "night3",
+    name: "深夜3時の戦士",
+    subtitle: "午前2〜4時に稼働",
+    rarity: "LEGENDARY",
+    kind: "neta",
+    tw: "night3",
+    quote: "静かな時間のほうが、はかどることもあります。",
+    test: ({ today }) => {
+      const h = today.eventsByHour ?? [];
+      const deep = (h[2] ?? 0) + (h[3] ?? 0);
+      return deep > 0 ? { ok: true } : { ok: false };
+    },
+  },
+  {
+    id: "one_trick",
+    name: "一芸デー",
+    subtitle: "1ツールが全体の8割超",
+    rarity: "RARE",
+    kind: "neta",
+    tw: "onetrick",
+    test: ({ today, cfg }) => {
+      const total = sum(today.toolCounts);
+      if (total === 0) return { ok: false };
+      const max = Math.max(...Object.values(today.toolCounts));
+      return (max / total) * 100 >= cfg.oneTrickPct ? { ok: true } : { ok: false };
+    },
+  },
+  {
+    id: "two_face",
+    name: "二面性",
+    subtitle: "午前と午後で最多ツールが逆転",
+    rarity: "RARE",
+    kind: "neta",
+    tw: "twoface",
+    test: ({ today }) => {
+      const am = topTool(today.toolCountsAm);
+      const pm = topTool(today.toolCountsPm);
+      if (!am || !pm) return { ok: false }; // 片方しか動いていない日は対象外
+      return am !== pm ? { ok: true } : { ok: false };
+    },
+  },
+];
+
+// ─────────────────────────────────────────────────────────
+// 権限カタログ（docs/card-catalog.md §3）
+//
+// 解放条件を満たしても「解放可能」フラグを立てるだけ。付与は人間が押す。
+// tax:file:submit（申告署名）はカタログに存在させない（法定の天井）。
+// ─────────────────────────────────────────────────────────
+
+export const PERMISSIONS = [
+  {
+    id: "deploy_prod",
+    name: "本番デプロイ権",
+    subtitle: "production への反映",
+    scope: "deploy:production",
+    unlockedBy: (issued) => issued.some((c) => c.id === "zero_dt"),
+  },
+  {
+    id: "secrets_read",
+    name: "Secrets 参照権限",
+    subtitle: "機密値の読み取り",
+    scope: "secrets:read",
+    unlockedBy: (issued) => issued.some((c) => c.id === "iron_streak"),
+  },
+  {
+    id: "main_merge",
+    name: "main 直接 merge 権",
+    subtitle: "レビュー省略での merge",
+    scope: "main:merge",
+    /**
+     * レビュー通過率は今の収集元から出ないので、解放条件を満たしたことにはしない。
+     *
+     * 収集できるようになったら、しきい値は cfg.mergePassRate（既定 98・MERGE_PASS_RATE）を使う。
+     * 新しい定数を足す必要はない。有効化はこの1行を差し替えるだけ:
+     *   (issued, cfg, ctx) => ctx.reviewPassRate >= cfg.mergePassRate
+     */
+    // eslint-disable-next-line no-unused-vars
+    unlockedBy: (issued, cfg) => false,
+  },
+  {
+    id: "deleg_l3",
+    name: "委任階位 L3",
+    subtitle: "広めの委任（要・資格者承認）",
+    scope: "tax:propose:wide",
+    unlockedBy: (issued) => issued.some((c) => c.id === "precision"),
+  },
+];
+
+// ─────────────────────────────────────────────────────────
+
+const load = () => {
+  if (!existsSync(CARDS_PATH())) {
+    return { achievements: [], titles: [], permissionsUnlockable: [] };
+  }
+  try {
+    return JSON.parse(readFileSync(CARDS_PATH(), "utf8"));
+  } catch {
+    return { achievements: [], titles: [], permissionsUnlockable: [] };
+  }
+};
+
+const save = (data) => {
+  mkdirSync(join(APP_HOME, "out"), { recursive: true });
+  writeFileSync(CARDS_PATH(), JSON.stringify(data, null, 2), "utf8");
+  return data;
+};
+
+/**
+ * その日の履歴からカードを評価し、発行ぶんを cards.json に積む。
+ * 既に持っているカードは剥奪しない（追記のみ）。
+ *
+ * dryRun: 判定するが保存しない。
+ *   しきい値を変えて評価すると本当にカードが発行され、達成カードは剥奪できないので、
+ *   実験がそのまま永久に残る（実際にやらかした）。しきい値を試すときは必ず dryRun にする。
+ */
+export const evaluateCards = ({ history, date, config, dryRun = false }) => {
+  const today = history.find((h) => h.date === date);
+  if (!today) return { issued: [], progress: [], unavailable: [], data: load() };
+
+  const cfg = config.cards;
+  const data = load();
+  const ctx = { history, today, cfg };
+
+  const issued = [];
+  const progress = [];
+  const unavailable = [];
+
+  for (const card of CATALOG) {
+    const r = card.test(ctx);
+
+    if (r.unavailable) {
+      unavailable.push({ id: card.id, reason: r.unavailable });
+      continue;
+    }
+
+    if (!r.ok) {
+      if (typeof r.progress === "number") {
+        progress.push({ id: card.id, name: card.name, progress: Math.min(99, r.progress) });
+      }
+      continue;
+    }
+
+    if (card.kind === "title") {
+      // 称号は一度だけ。既に得ていれば再発行しない。
+      if (data.titles.some((t) => t.id === card.id)) continue;
+      data.titles.push({ id: card.id, earnedAt: date });
+      issued.push({ ...card, kind: "title" });
+      continue;
+    }
+
+    // 達成カードは日付つきで積む。同じ日の同じカードは1枚だけ。
+    if (data.achievements.some((a) => a.id === card.id && a.date === date)) continue;
+    data.achievements.push({ id: card.id, date, rarity: card.rarity });
+    issued.push(card);
+  }
+
+  // 権限は「解放可能」フラグのみ。付与はしない。
+  for (const perm of PERMISSIONS) {
+    if (data.permissionsUnlockable.some((p) => p.id === perm.id)) continue;
+    if (!perm.unlockedBy(data.achievements, cfg)) continue;
+    data.permissionsUnlockable.push({ id: perm.id, since: date });
+  }
+
+  if (!dryRun) save(data);
+  return { issued, progress, unavailable, data, dryRun };
+};
+
+export const loadCards = load;

package/src/collect.mjs

@@ -0,0 +1,111 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import claudeCode from "./sources/claude-code.mjs";
+import cowork from "./sources/cowork.mjs";
+import eventsFile from "./sources/events-file.mjs";
+import codexCli from "./sources/codex-cli.mjs";
+import geminiCli from "./sources/gemini-cli.mjs";
+import copilotCli from "./sources/copilot-cli.mjs";
+import hermes from "./sources/hermes.mjs";
+import { computeAggregates } from "./aggregate.mjs";
+
+const SOURCES = {
+  [claudeCode.id]: claudeCode,
+  [cowork.id]: cowork,
+  [eventsFile.id]: eventsFile,
+  [codexCli.id]: codexCli,
+  [geminiCli.id]: geminiCli,
+  [copilotCli.id]: copilotCli,
+  [hermes.id]: hermes,
+};
+
+export const listSources = () => Object.keys(SOURCES);
+
+/**
+ * 収集元を選び、共通の activity 形に揃えて返す。
+ *
+ * SOURCE はカンマ区切りで複数指定できる（例: claude-code,cowork）。
+ * Claude は Code と Cowork の2面を持つ1体なので、両方を合算して日報1通にまとめる。
+ *
+ * 帰属の規律:
+ * - エージェント名は「収集元」に縛る。claude-code / cowork から作った日報は必ず
+ *   Claude 名義になり、AGENT_NAME で Hermes などに書き換えることはできない。
+ *   他のAI（他人）の作業を自分の実績にできてしまうと ✓ の意味が崩れるため。
+ * - 名義の異なる収集元どうしは合算できない。Claude の作業と Hermes の作業を
+ *   1通の日報に混ぜると、どちらが何をしたのか言えなくなる。
+ */
+export const collect = async (config) => {
+  const ids = String(config.source)
+    .split(",")
+    .map((s) => s.trim())
+    .filter(Boolean);
+
+  const sources = ids.map((id) => {
+    const source = SOURCES[id];
+    if (!source) {
+      throw new Error(
+        `未知の SOURCE です: ${id}（使えるのは ${listSources().join(", ")}）`,
+      );
+    }
+    return source;
+  });
+
+  if (sources.length === 0) {
+    throw new Error("SOURCE が空です。");
+  }
+
+  const names = [...new Set(sources.map((s) => s.agentName ?? config.agentName))];
+  if (names.length > 1) {
+    throw new Error(
+      `名義の違う収集元は合算できません（${names.join(" / ")}）。` +
+        `別々の日報として出してください。`,
+    );
+  }
+  const agentName = names[0];
+
+  for (const source of sources) {
+    if (source.agentName && config.agentNameExplicit && config.agentName !== source.agentName) {
+      console.warn(
+        `[collect] AGENT_NAME=${config.agentName} は無視します。` +
+          `収集元 ${source.id} の日報は ${source.agentName} 名義でしか出せません。`,
+      );
+    }
+  }
+
+  // 各収集元は生イベントだけを返す。集計は合算後に1回だけ行う
+  // （収集元ごとに実働を出して足すと、同じ時間帯に両方動いていた分が二重に乗る）。
+  const collected = await Promise.all(
+    sources.map(async (source) => ({ source, ...await source.collect(config) })),
+  );
+
+  const events = collected.flatMap((c) =>
+    c.events.map((e) => ({ ...e, source: c.source.id })),
+  );
+  const prompts = collected
+    .flatMap((c) => c.prompts)
+    .sort((a, b) => a.time.localeCompare(b.time));
+  const sessions = new Set(collected.flatMap((c) => [...c.sessions]));
+  const maskedCount = collected.reduce((sum, c) => sum + c.maskedCount, 0);
+
+  return {
+    date: config.date,
+    events: events.sort((a, b) => a.ms - b.ms),
+    prompts,
+    maskedCount,
+    source: sources.map((s) => s.id).join("+"),
+    origin: sources.map((s) => s.origin).join(" ／ "),
+    agentName,
+    // 体名の表記は「◯◯のClaude」（§G）。英語所有格は使わない。
+    // なおサーバ（clubsx）は取込時に接続の呼び名から体名を組み直すので、ここは
+    // ローカル描画（--dry-run のプレビュー等）の見え方のためのフォールバック。
+    displayName: config.ownerName ? `${config.ownerName}の${agentName}` : agentName,
+    slug: (config.ownerName ? `${config.ownerName}-${agentName}` : agentName)
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-|-$/g, ""),
+    aggregates: computeAggregates({ events, sessions, idleGapMin: config.idleGapMin }),
+  };
+};