@clubs.place/cli 0.0.0-stage → 0.1.17

package/src/config.mjs

@@ -0,0 +1,173 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+
+/**
+ * 設定（.env）と状態（out/）の置き場所。
+ *
+ * npx 実行では ROOT が npm キャッシュ（バージョンごとに変わる・使い捨て）に
+ * なるため、ROOT に書くと更新のたびに履歴・カードが消える。ユーザー領域の
+ * ~/.clubs-nippo に置く。git clone 運用（ROOT に .git がある）は従来どおり
+ * ROOT——既存ユーザーの .env と out/ をそのまま生かす。
+ */
+export const APP_HOME =
+  process.env.CLUBS_NIPPO_HOME ??
+  (existsSync(join(ROOT, ".git")) || existsSync(join(ROOT, ".env"))
+    ? ROOT
+    : join(homedir(), ".clubs-nippo"));
+
+/** .env は「まだ環境変数に無いキーだけ」入れる。実環境の変数が常に勝つ。 */
+const loadDotEnv = () => {
+  const path = join(APP_HOME, ".env");
+  if (!existsSync(path)) return;
+  for (const line of readFileSync(path, "utf8").split("\n")) {
+    const m = line.match(/^\s*([A-Z0-9_]+)\s*=\s*(.*)\s*$/);
+    if (!m) continue;
+    const value = m[2].replace(/^["']|["']$/g, "");
+    if (process.env[m[1]] === undefined) process.env[m[1]] = value;
+  }
+};
+loadDotEnv();
+
+/** JST 基準の「前日」。TZ_OFFSET は分単位のオフセット（既定 +540 = JST）。 */
+const yesterdayLocal = (offsetMin) => {
+  const shifted = new Date(Date.now() + offsetMin * 60_000 - 86_400_000);
+  return shifted.toISOString().slice(0, 10);
+};
+
+const num = (v, fallback) => (Number.isFinite(Number(v)) ? Number(v) : fallback);
+
+/**
+ * MASK_PATTERNS は「,」区切りの正規表現ソース。
+ * 例: MASK_PATTERNS='株式会社[ぁ-んァ-ヶ一-龠A-Za-z0-9]+,Acme Corp'
+ */
+const parseMaskPatterns = (raw) =>
+  (raw ?? "")
+    .split(",")
+    .map((s) => s.trim())
+    .filter(Boolean)
+    .map((source) => {
+      try {
+        return new RegExp(source, "gi");
+      } catch {
+        console.warn(`[config] MASK_PATTERNS の正規表現を無視しました: ${source}`);
+        return null;
+      }
+    })
+    .filter(Boolean);
+
+export const loadConfig = (argv = {}) => {
+  const tzOffsetMin = num(process.env.TZ_OFFSET_MIN, 540);
+  return {
+    date: argv.date ?? process.env.REPORT_DATE ?? yesterdayLocal(tzOffsetMin),
+    tzOffsetMin,
+
+    // 収集元。カンマ区切りで複数指定できる（名義が同じものに限る）。
+    //   claude-code = この端末の Claude Code セッション記録
+    //   cowork      = Claude デスクトップアプリ（Cowork）のセッション記録
+    //   hermes      = Hermes Agent のセッション記録（~/.hermes/sessions/）
+    //   events-file = エージェントが書き出した JSONL（汎用）
+    // Claude は Code と Cowork の2面を持つ1体なので、既定で両方を合算する。
+    source: argv.source ?? process.env.SOURCE ?? "claude-code,cowork",
+    eventsFile: argv.eventsFile ?? process.env.EVENTS_FILE ?? "",
+    coworkDir: process.env.COWORK_DIR ?? "",
+
+    // オーナー名。表示は「mayumi's Claude」のように接頭辞としてのみ効く。
+    // 後半（Claude / Hermes）は収集元が決めるので、これで名義を乗っ取ることはできない。
+    ownerName: process.env.OWNER_NAME ?? "",
+
+    // events-file のときだけ有効。claude-code では収集元が名前を決めるので無視される。
+    agentName: process.env.AGENT_NAME ?? "Agent",
+    agentNameExplicit: process.env.AGENT_NAME !== undefined,
+    modelLabel: process.env.MODEL_LABEL ?? "",
+    seatLabel: process.env.SEAT_LABEL ?? "席: FRAME00",
+    // メールのロゴ。Gmail はインライン SVG も外部 SVG も描画しないので PNG を指す。
+    // 公開URLでなければメールから見えないため、未設定ならテキストの "CLUBS" を出す
+    // （壊れた画像アイコンを出すより、文字のほうがまし）。
+    //   例: https://clubs.place/assets/logo-clubs-white.png
+    emailLogoUrl: process.env.EMAIL_LOGO_URL ?? "",
+
+    // コンソールの公開URLの base（例 https://clubs.place）。
+    // 未設定ならメールに「編集して記録する」を出さない（存在しないページに飛ばさない）。
+    consoleBase: process.env.CONSOLE_BASE ?? "",
+
+    // パスポートの公開URLの base（例 https://clubs.place）。
+    // 未設定ならメールに「パスポートをシェア」を出さない（存在しないページに飛ばさない）。
+    passportBase: process.env.PASSPORT_BASE ?? "",
+
+    // web コンソール（clubsx）への取込。本文（narrative）は Lemma に無いので、
+    // 生成した日報を本文ごとここに push する。設定画面で発行した連携トークンを貼る。
+    // 未設定なら取込をスキップ（メール・Lemma 登録は従来どおり動く）。
+    ingestUrl: process.env.NIPPO_INGEST_URL ?? "",
+    ingestToken: process.env.NIPPO_INGEST_TOKEN ?? "",
+
+    transcriptDir: process.env.TRANSCRIPT_DIR ?? join(homedir(), ".claude", "projects"),
+    idleGapMin: num(process.env.IDLE_GAP_MIN, 15),
+    includePrompts: process.env.INCLUDE_PROMPTS !== "0",
+    maskPatterns: parseMaskPatterns(process.env.MASK_PATTERNS),
+
+    // 本文生成の担い手。収集元と同じサービスに揃えると、1つのサブスクだけで
+    // 実行ログ→日報まで完結する（claude-code なら claude、codex-cli なら codex）。
+    //   claude / codex / gemini / copilot … その端末の AI CLI をヘッドレスで叩く
+    //   openrouter    = OpenRouter API
+    //   openai-compat = OpenAI互換カスタム（Sakana Fugu 等）
+    //   none          = LLM を使わない
+    generator: process.env.GENERATOR ?? "claude",
+    openrouter: {
+      apiKey: process.env.OPENROUTER_API_KEY ?? "",
+      model: process.env.OPENROUTER_MODEL ?? "anthropic/claude-sonnet-4.5",
+    },
+    // OpenAI 互換カスタムエンドポイント。base URL / model は接続設定から来てもよいが
+    // API キーは常にローカル .env のみ（非カストディアル）。
+    backend: {
+      baseUrl: process.env.BACKEND_BASE_URL ?? "",
+      apiKey: process.env.BACKEND_API_KEY ?? "",
+      model: process.env.BACKEND_MODEL ?? "",
+    },
+
+    // カードのしきい値。ハードコードしない（チームごとに違う）。
+    // 既定値は docs/card-catalog.md §4。
+    cards: {
+      bigjobCalls: num(process.env.BIGJOB_CALLS, 40),
+      noFailDays: num(process.env.NOFAIL_DAYS, 30),
+      precisionDays: num(process.env.PRECISION_DAYS, 90),
+      cleanCount: num(process.env.CLEAN_COUNT, 10),
+      titleDays: num(process.env.TITLE_DAYS, 10),
+      mergePassRate: num(process.env.MERGE_PASS_RATE, 98),
+      // カタログ本文に数値がある条件も、同じく設定キーにする。
+      comebackEarlyFail: num(process.env.COMEBACK_EARLY_FAIL, 30),
+      comebackFinalRate: num(process.env.COMEBACK_FINAL_RATE, 95),
+      oneTrickPct: num(process.env.ONE_TRICK_PCT, 80),
+      owlAfter: process.env.OWL_AFTER ?? "23:00",
+    },
+
+    email: {
+      provider: process.env.EMAIL_PROVIDER ?? "resend",
+      apiKey: process.env.EMAIL_API_KEY ?? "",
+      from: process.env.EMAIL_FROM ?? "",
+      to: (process.env.EMAIL_TO ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean),
+    },
+
+    lemma: {
+      base: process.env.LEMMA_API_BASE ?? "https://workers.lemma.workers.dev",
+      apiKey: process.env.LEMMA_API_KEY ?? "",
+      scopeId: process.env.LEMMA_SCOPE_ID ?? "",
+      // 検証UIのURLが分かっている場合のみリンク化する。未設定なら docHash のみ表示。
+      verifyBase: process.env.LEMMA_VERIFY_BASE ?? "",
+    },
+
+    useLlm: argv.noLlm !== true,
+    dryRun: argv.dryRun === true,
+  };
+};

package/src/generators/claude.mjs

@@ -0,0 +1,31 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { makeCliGenerator } from "./cli.mjs";
+
+/**
+ * claude -p（Claude Code のヘッドレス実行）で本文を書く。
+ * 既存のサブスクリプション内で動くので、別の LLM API キーは要らない。
+ * Claude Code が入っていないマシンでは失敗し、呼び出し側が fallback に落とす。
+ */
+export default makeCliGenerator({
+  id: "claude",
+  bin: "claude",
+  binEnv: "CLAUDE_BIN",
+  label: "claude-code",
+  // 日報の本文書きはログのダイジェストを整形するだけで、MCP サーバーは1つも要らない。
+  // 既定では利用者が普段使っている MCP を全部起動してしまい、起動を待つあいだに
+  // 実測で 55 秒（137s→82s）を捨てる。接続待ちで固まる MCP があれば丸ごと巻き込まれる。
+  // --strict-mcp-config + 空の --mcp-config で、この生成のあいだだけ MCP を切る。
+  args: (prompt) => [
+    "-p",
+    prompt,
+    "--output-format",
+    "text",
+    "--strict-mcp-config",
+    "--mcp-config",
+    '{"mcpServers":{}}',
+  ],
+});

package/src/generators/cli.mjs

@@ -0,0 +1,81 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { ROOT } from "../config.mjs";
+
+const execFileAsync = promisify(execFile);
+
+/**
+ * 「その端末に入っている AI CLI をヘッドレスで叩いて本文を書かせる」生成器の共通形。
+ *
+ * 収集元と生成器を同じサービスで揃えられるようにするためのもの。Codex CLI しか
+ * 入れていない端末で claude -p を呼んでも外れるだけなので、ログを出したのと同じ
+ * CLI に本文も書かせる（実行ログ→日報を1つのサブスクで完結させる）。
+ *
+ * どれも「ユーザーが既に契約している CLI」を使うので、別の API キーは要らない。
+ * 入っていないマシンでは実行が失敗し、呼び出し側が fallback に落とす。
+ *
+ * バイナリのパスは <ID>_BIN で上書きできる（cron の細い PATH 対策）。
+ */
+export const makeCliGenerator = ({ id, bin, binEnv, label, args }) => ({
+  id,
+  label: () => label,
+  generate: async (prompt) => {
+    const command = process.env[binEnv] || bin;
+    // 生成の上限時間。大きい日はプロンプトが数万字になり既定 180s では足りず
+    // timeout（SIGTERM）で fallback に落ちることがあるので、少し長めにし env で伸ばせる。
+    const timeout = Number(process.env.GENERATOR_TIMEOUT_MS) || 240_000;
+    const startedAt = Date.now();
+    const pending = execFileAsync(command, args(prompt), {
+      cwd: ROOT,
+      timeout,
+      maxBuffer: 8 * 1024 * 1024,
+    });
+    // ヘッドレスCLI（claude -p 等）は stdin からの追加入力を待つ。cron / launchd の
+    // 非TTY環境では入力も EOF も来ず数秒空回りし、巨大プロンプトと相まって timeout で
+    // 殺される（"no stdin data received in 3s" 警告の正体）。即 EOF を送って
+    // 「< /dev/null」相当にし、待ちをなくす。
+    pending.child?.stdin?.end();
+    try {
+      const { stdout } = await pending;
+      return stdout;
+    } catch (e) {
+      throw new Error(explainFailure(e, { command, timeout, elapsed: Date.now() - startedAt }));
+    }
+  },
+});
+
+/**
+ * 失敗の理由を「読んで直せる一行」にする。
+ *
+ * execFile の既定メッセージは `Command failed: <実行したコマンド全文>` で、ここには
+ * 数万字のプロンプトがそのまま入る。それが fallback の理由として下書き JSON・cron ログ・
+ * メール本文にまで流れ込み、肝心の「なぜ落ちたか」が埋もれる。プロンプトは捨て、
+ * 終わり方（タイムアウト / 異常終了 / 未インストール）と stderr の末尾だけを残す。
+ */
+const explainFailure = (e, { command, timeout, elapsed }) => {
+  if (e.code === "ENOENT") return `${command} が見つかりません`;
+
+  const tail = (e.stderr || e.stdout || "").trim().split("\n").slice(-3).join(" / ").slice(0, 300);
+  const suffix = tail ? `: ${tail}` : "";
+  const secs = (ms) => `${Math.round(ms / 1000)}秒`;
+
+  if (e.killed || e.signal === "SIGTERM") {
+    // 実時間がタイムアウトを大きく超えていたら、待っていたのではなく途中で止められている。
+    // 典型は Mac の二度寝（DarkWake の隙に起動 → 45秒で再スリープ → プロセスもタイマーも凍結）。
+    // 電源都合は設定で直せる話なので、単なる「時間切れ」と混ぜずに言い分ける。
+    if (elapsed > timeout * 1.5) {
+      return (
+        `${command} が実行中に凍結しました（${secs(timeout)}の予定が実時間 ${secs(elapsed)}）。` +
+        `生成の途中で Mac がスリープした可能性があります${suffix}`
+      );
+    }
+    return `${command} が ${secs(timeout)} で終わりませんでした（GENERATOR_TIMEOUT_MS で延ばせます）${suffix}`;
+  }
+
+  return `${command} が異常終了しました（exit ${e.code ?? "?"}）${suffix}`;
+};

package/src/generators/codex.mjs

@@ -0,0 +1,28 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { makeCliGenerator } from "./cli.mjs";
+
+/**
+ * codex exec（Codex CLI の非対話実行）で本文を書く。
+ * 収集元 codex-cli とセットで使う想定＝Codex のサブスクだけで日報まで完結する。
+ *
+ * 実機検証: 2026-07-24 Hermes サーバーで確認（codex-cli v0.145.0）。
+ *   --skip-git-repo-check          … cron の cwd が trusted directory 外でも通す
+ *   --dangerously-bypass-approvals-and-sandbox … 非TTYで承認待ちにならない
+ *   前提: OPENAI_API_KEY が環境変数に必要（Codex CLI が読み取る）
+ */
+export default makeCliGenerator({
+  id: "codex",
+  bin: "codex",
+  binEnv: "CODEX_BIN",
+  label: "codex-cli",
+  args: (prompt) => [
+    "exec",
+    "--skip-git-repo-check",
+    "--dangerously-bypass-approvals-and-sandbox",
+    prompt,
+  ],
+});

package/src/generators/copilot.mjs

@@ -0,0 +1,21 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { makeCliGenerator } from "./cli.mjs";
+
+/**
+ * copilot -p（GitHub Copilot CLI の非対話実行）で本文を書く。
+ * 収集元 copilot-cli とセットで使う想定。
+ *
+ * ⚠ 実機未検証（2026-07-22 時点）。Copilot CLI 自体が実験的で、フラグの変更が
+ * 起きやすい。実ログ検証で確定させる。
+ */
+export default makeCliGenerator({
+  id: "copilot",
+  bin: "copilot",
+  binEnv: "COPILOT_BIN",
+  label: "copilot-cli",
+  args: (prompt) => ["-p", prompt],
+});

package/src/generators/gemini.mjs

@@ -0,0 +1,20 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { makeCliGenerator } from "./cli.mjs";
+
+/**
+ * gemini -p（Gemini CLI の非対話実行）で本文を書く。
+ * 収集元 gemini-cli とセットで使う想定。
+ *
+ * ⚠ 実機未検証（2026-07-22 時点）。フラグ・出力形式は実ログ検証で確定させる。
+ */
+export default makeCliGenerator({
+  id: "gemini",
+  bin: "gemini",
+  binEnv: "GEMINI_BIN",
+  label: "gemini-cli",
+  args: (prompt) => ["-p", prompt],
+});

package/src/generators/openai-compat.mjs

@@ -0,0 +1,79 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+/**
+ * OpenAI 互換のカスタムエンドポイントで本文を書く（第3の生成バックエンド）。
+ *
+ * Sakana Fugu 等の国産AIを含む、OpenAI Chat Completions 互換の任意サーバに対応。
+ * 「本文生成はユーザー側のLLM」という非カストディアル原則は保たれる——
+ * base URL・モデルは CLUBS の接続設定（collector-config）から来てもよいが、
+ * **API キーは常にローカル .env のみ**（CLUBS には保存も送信もされない）。
+ *
+ * 必要な設定:
+ *   GENERATOR=openai-compat
+ *   BACKEND_BASE_URL=https://api.example.com/v1   （/chat/completions は自動補完）
+ *   BACKEND_API_KEY=sk-...                         （.env のみ・画面には入力しない）
+ *   BACKEND_MODEL=your-model-id
+ *
+ * 注意: ここに渡るのはダイジェスト（ツール名・時刻・成否・マスク済みの短い要約）だけ。
+ * それでも外部APIに送るので、指示文も渡したくない場合は INCLUDE_PROMPTS=0。
+ */
+
+/** base URL から chat/completions のエンドポイントを組む（末尾スラッシュ・重複を吸収）。 */
+const endpointOf = (baseUrl) => {
+  const b = String(baseUrl || "").trim().replace(/\/+$/, "");
+  if (!b) return "";
+  if (/\/chat\/completions$/.test(b)) return b;
+  return `${b}/chat/completions`;
+};
+
+export default {
+  id: "openai-compat",
+
+  label: (config) => `openai-compat:${config.backend.model || "?"}`,
+
+  generate: async (prompt, config) => {
+    const { baseUrl, apiKey, model } = config.backend;
+    const endpoint = endpointOf(baseUrl);
+    if (!endpoint) throw new Error("BACKEND_BASE_URL が未設定です。");
+    if (!apiKey) throw new Error("BACKEND_API_KEY が未設定です（.env にのみ置きます）。");
+    if (!model) throw new Error("BACKEND_MODEL が未設定です。");
+
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 180_000);
+
+    try {
+      const res = await fetch(endpoint, {
+        method: "POST",
+        signal: ctrl.signal,
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          "Content-Type": "application/json",
+          "X-Title": "clubs-nippo",
+        },
+        body: JSON.stringify({
+          model,
+          messages: [{ role: "user", content: prompt }],
+          // 日報は事実の要約。creative である必要はない。
+          temperature: 0.3,
+        }),
+      });
+
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`OpenAI互換 ${res.status}: ${text.slice(0, 160)}`);
+      }
+
+      const json = await res.json();
+      const content = json.choices?.[0]?.message?.content;
+      if (typeof content !== "string") {
+        throw new Error("OpenAI互換エンドポイントの応答に本文がありません。");
+      }
+      return content;
+    } finally {
+      clearTimeout(timer);
+    }
+  },
+};

package/src/generators/openrouter.mjs

@@ -0,0 +1,65 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+/**
+ * OpenRouter で本文を書く。
+ *
+ * モデルを切り替えて使うエージェント（CTO の Hermes など）向け。オーナーが既に
+ * 課金している LLM をそのまま使うので、「本文生成はユーザー側のLLM」という原則は保たれる。
+ *
+ * 必要な設定:
+ *   GENERATOR=openrouter
+ *   OPENROUTER_API_KEY=sk-or-...
+ *   OPENROUTER_MODEL=anthropic/claude-sonnet-4.5   （既定。どのモデルでもよい）
+ *
+ * 注意: ここに渡るのはダイジェスト（ツール名・時刻・成否・マスク済みの短い要約）だけで、
+ * コマンド全文やファイル内容は含まれない。それでも外部APIに送ることに変わりはないので、
+ * 指示文も渡したくない場合は INCLUDE_PROMPTS=0 にする。
+ */
+export default {
+  id: "openrouter",
+
+  label: (config) => `openrouter:${config.openrouter.model}`,
+
+  generate: async (prompt, config) => {
+    const { apiKey, model } = config.openrouter;
+    if (!apiKey) throw new Error("OPENROUTER_API_KEY が未設定です。");
+
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 180_000);
+
+    try {
+      const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
+        method: "POST",
+        signal: ctrl.signal,
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          "Content-Type": "application/json",
+          "X-Title": "clubs-nippo",
+        },
+        body: JSON.stringify({
+          model,
+          messages: [{ role: "user", content: prompt }],
+          // 日報は事実の要約。creative である必要はない。
+          temperature: 0.3,
+        }),
+      });
+
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`OpenRouter ${res.status}: ${text.slice(0, 160)}`);
+      }
+
+      const json = await res.json();
+      const content = json.choices?.[0]?.message?.content;
+      if (typeof content !== "string") {
+        throw new Error("OpenRouter の応答に本文がありません。");
+      }
+      return content;
+    } finally {
+      clearTimeout(timer);
+    }
+  },
+};

package/src/history.mjs

@@ -0,0 +1,66 @@
+// 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";
+
+/**
+ * 日次集計の履歴（out/history.jsonl・1日1行）。
+ *
+ * approved.json は「その日1日」の確定内容しか持たない。
+ * 「失敗ゼロ30日連続」「差し戻し率<1%を90日」のような条件は**系列**が要るので、
+ * 日次の aggregates をここに積む。DB は使わない（依存を増やさない）。
+ *
+ * 冪等: 同じ date の行が既にあれば上書きする。cron が二度走っても重複しない。
+ */
+
+const PATH = () => join(APP_HOME, "out", "history.jsonl");
+
+export const readHistory = () => {
+  if (!existsSync(PATH())) return [];
+  return readFileSync(PATH(), "utf8")
+    .split("\n")
+    .filter((l) => l.trim())
+    .map((l) => {
+      try {
+        return JSON.parse(l);
+      } catch {
+        return null;
+      }
+    })
+    .filter(Boolean)
+    .sort((a, b) => a.date.localeCompare(b.date));
+};
+
+export const appendHistory = (activity) => {
+  mkdirSync(join(APP_HOME, "out"), { recursive: true });
+  const a = activity.aggregates;
+
+  const row = {
+    date: activity.date,
+    agent: activity.agentName,
+    totalCalls: a.totalCalls,
+    failedCalls: a.failedCalls,
+    successRate: a.successRate,
+    activeHours: a.activeHours,
+    toolCounts: a.toolCounts,
+    toolCountsAm: a.toolCountsAm,
+    toolCountsPm: a.toolCountsPm,
+    eventsByHour: a.eventsByHour,
+    earlyFailRate: a.earlyFailRate,
+    firstAt: a.firstAt,
+    lastAt: a.lastAt,
+    // firstTrySuccessRate（一発通過率）と reworkRate（差し戻し率）は今の収集元から出ない。
+    // 無い値を作らない。これらを使うカードは「データ未取得」として評価をスキップする。
+  };
+
+  const rows = readHistory().filter((r) => r.date !== row.date);
+  rows.push(row);
+  rows.sort((a2, b2) => a2.date.localeCompare(b2.date));
+
+  writeFileSync(PATH(), rows.map((r) => JSON.stringify(r)).join("\n") + "\n", "utf8");
+  return row;
+};

package/src/ingest.mjs

@@ -0,0 +1,78 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+/**
+ * 生成した日報を web コンソール（clubsx）へ取り込ませる。
+ *
+ * 本文（workBlocks / handoff / insights / selfNote）は Lemma には登録されない
+ * （Lemma は docHash＋集計値のみ）。だから web コンソールで本文まで見せるには、
+ * ここで **本文ごと** clubsx に push する必要がある。
+ *
+ * 認証は clubsx の設定画面で発行した「連携トークン」（Bearer）。Lemma API キーとは
+ * 別レイヤーで、本文配送の認可だけを担う。収集が既に済ませた Lemma 登録結果
+ * （docHash＋proof）も一緒に送るので、clubsx は再登録しない（V の二重計上を避ける）。
+ *
+ * URL/トークン未設定・到達不可・エラーのいずれでも throw せず {ok:false, reason} を
+ * 返す（メール送信や Lemma 登録を巻き込まない）。
+ */
+
+const withTimeout = async (fn, ms) => {
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), ms);
+  try {
+    return await fn(ctrl.signal);
+  } finally {
+    clearTimeout(timer);
+  }
+};
+
+export const pushToClubs = async (activity, narrative, proof, config) => {
+  const url = config.ingestUrl;
+  const token = config.ingestToken;
+  if (!url || !token) {
+    return { ok: false, reason: "NIPPO_INGEST_URL / NIPPO_INGEST_TOKEN 未設定" };
+  }
+
+  // 境界の強制: 端末を出てよいのは集計値＋マスク済み本文＋署名だけ。
+  // activity には events/prompts など生ログ由来のフィールドがぶら下がるため、
+  // 丸ごと送らずホワイトリストで整形する（docHash の入力は date+aggregates+
+  // 本文なので影響しない）。
+  const activityOut = {
+    date: activity.date,
+    agentName: activity.agentName,
+    displayName: activity.displayName,
+    source: activity.source,
+    origin: activity.origin,
+    aggregates: activity.aggregates,
+  };
+
+  try {
+    const res = await withTimeout(
+      (signal) =>
+        fetch(url, {
+          method: "POST",
+          signal,
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${token}`,
+          },
+          body: JSON.stringify({ activity: activityOut, narrative, proof }),
+        }),
+      15_000,
+    );
+
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      return { ok: false, reason: `ingest ${res.status}: ${text.slice(0, 160)}` };
+    }
+    /* サーバは「稼働のなかった日」を日報にしない（土日など）。取込は成功だが
+       日報は作られず、メールも出ない。それを ok と同じ顔で伝えると、届いて
+       いないものを「送りました」と言うことになるので、区別して返す。 */
+    const body = await res.json().catch(() => ({}));
+    return { ok: true, quiet: body?.quiet === true };
+  } catch (e) {
+    return { ok: false, reason: `clubsx 取込に失敗: ${e?.message ?? "不明なエラー"}` };
+  }
+};