@clubs.place/cli 0.0.0-stage → 0.1.18

package/bin/clubs-nippo.mjs

@@ -0,0 +1,527 @@
+#!/usr/bin/env node
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { writeFileSync, mkdirSync, readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { platform, homedir } from "node:os";
+import { execSync } from "node:child_process";
+import { createInterface } from "node:readline";
+import { loadConfig, APP_HOME } from "../src/config.mjs";
+import { collect } from "../src/collect.mjs";
+import { generateNarrative } from "../src/narrative.mjs";
+import { registerProof, documentHash } from "../src/lemma.mjs";
+import { pushToClubs } from "../src/ingest.mjs";
+import { renderHtml, buildSubject } from "../src/render.mjs";
+import { sendMail } from "../src/send.mjs";
+import { saveDraft } from "../src/store.mjs";
+import { appendHistory, readHistory } from "../src/history.mjs";
+import { evaluateCards } from "../src/cards.mjs";
+import { fetchCollectorConfig } from "../src/remote-config.mjs";
+import { tickCommand } from "../src/autorun.mjs";
+
+/** [Y/n] を聞く。非対話（パイプ）では既定 Yes（自動化を止めない）。 */
+const promptYesNo = (question) =>
+  new Promise((resolve) => {
+    if (!process.stdin.isTTY) return resolve(true);
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(`${question} `, (a) => {
+      rl.close();
+      resolve(!/^n/i.test(a.trim()));
+    });
+  });
+
+/**
+ * 毎朝の自動実行を登録する。macOS=launchd / Windows=schtasks / それ以外=crontab。
+ * cron は PATH が細いので npx はフルパスで渡す。既存の clubs-nippo 登録は入れ替える（冪等）。
+ */
+const registerAutorun = (hourlyLine, npx) => {
+  if (platform() === "darwin") {
+    const plistPath = join(homedir(), "Library", "LaunchAgents", "com.frame00.clubs-nippo.plist");
+    const path = `${dirname(process.execPath)}:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:${join(homedir(), ".local", "bin")}`;
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<plist version="1.0"><dict>
+  <key>Label</key><string>com.frame00.clubs-nippo</string>
+  <key>ProgramArguments</key><array>${tickCommand(npx).map((a) => `<string>${a}</string>`).join("")}</array>
+  <key>EnvironmentVariables</key><dict><key>PATH</key><string>${path}</string></dict>
+  <key>StartCalendarInterval</key><dict><key>Minute</key><integer>0</integer></dict>
+  <key>StandardOutPath</key><string>${join(APP_HOME, "out", "cron.log")}</string>
+  <key>StandardErrorPath</key><string>${join(APP_HOME, "out", "cron.err.log")}</string>
+</dict></plist>
+`;
+    mkdirSync(dirname(plistPath), { recursive: true });
+    writeFileSync(plistPath, plist, "utf8");
+    try {
+      execSync(`launchctl unload ${JSON.stringify(plistPath)} 2>/dev/null`);
+    } catch {
+      /* 初回は未ロードで失敗する＝無視 */
+    }
+    execSync(`launchctl load ${JSON.stringify(plistPath)}`);
+    return `launchd に登録しました（${plistPath}）`;
+  }
+  if (platform() === "win32") {
+    return "Windows では自動実行を登録できません。WSL（Windows Subsystem for Linux）をお使いください。\n" +
+      "  WSL 内で `clubs-nippo init` を実行すると crontab に登録されます。";
+  }
+  let current = "";
+  try {
+    current = execSync("crontab -l 2>/dev/null").toString();
+  } catch {
+    /* crontab 未設定 */
+  }
+  const kept = current.split("\n").filter((l) => l && !l.includes("clubs-nippo"));
+  execSync("crontab -", { input: [...kept, hourlyLine].join("\n") + "\n" });
+  return "crontab に登録しました";
+};
+
+const parseArgs = (argv) => {
+  const out = { _: [] };
+  for (const arg of argv) {
+    if (arg === "--dry-run") out.dryRun = true;
+    else if (arg === "--draft") out.draft = true;
+    else if (arg === "--no-llm") out.noLlm = true;
+    else if (arg.startsWith("--date=")) out.date = arg.slice(7);
+    else if (arg.startsWith("--out=")) out.out = arg.slice(6);
+    else if (arg.startsWith("--source=")) out.source = arg.slice(9);
+    else if (arg.startsWith("--events=")) out.eventsFile = arg.slice(9);
+    else if (arg.startsWith("--url=")) out.url = arg.slice(6);
+    else if (arg.startsWith("--token=")) out.token = arg.slice(8);
+    else if (arg.startsWith("--code=")) out.code = arg.slice(7);
+    else if (arg.startsWith("--agent-name=")) out.agentName = arg.slice(13);
+    else if (arg.startsWith("--owner-name=")) out.ownerName = arg.slice(13);
+    else if (arg === "--help" || arg === "-h") out.help = true;
+    else out._.push(arg);
+  }
+  return out;
+};
+
+const HELP = `clubs-nippo — Claude Code の実行ログから前日ぶんの AI業務日報メールを作って送る
+
+使い方:
+  clubs-nippo init --url=… --code=…
+                                 接続設定を書く（CLUBS の接続画面が発行する
+                                 接続コードをトークンに引き換える・10分/1回限り）。
+                                 設定と履歴は ~/.clubs-nippo に置かれる。
+                                 --token=（再発行モーダルの直接指定）
+                                 --source= --agent-name= --owner-name= --events= も受ける
+  clubs-nippo                    前日ぶんを生成して EMAIL_TO に送信
+  clubs-nippo --dry-run          送信せず HTML をローカルに書き出すだけ
+  clubs-nippo --draft           生成して下書き保存だけ（登録も送信もしない）
+                                承認フローを使う場合はこれ。Web画面から承認すると
+                                そこで初めて Lemma に登録される
+  clubs-nippo --date=2026-07-13  対象日を指定（既定＝前日・JST）
+  clubs-nippo --no-llm           LLM を使わず集計だけで本文を組む
+  clubs-nippo --out=path.html    HTML の出力先
+  clubs-nippo tick               cron の毎時起動用。CLUBS の設定（配信時刻・
+                                 収集元・生成器）を読み、時刻到達＆本日未配信の
+                                 ときだけ配信する。設定はアプリ側が正——
+                                 crontab 行は init が表示する（npx のフルパス入り）
+  clubs-nippo collect            集計結果を JSON で表示（送信しない）
+  clubs-nippo backfill [日数]    実ログから過去ぶんの履歴を作る（既定14日）
+  clubs-nippo cards              カードを評価して発行（送信はしない）
+  clubs-nippo cards --dry-run    評価するが発行しない。しきい値を試すときは必ずこちら
+                                 （達成カードは剥奪できないので、誤発行は取り消せない）
+  clubs-nippo mcp                MCP サーバー（stdio）として起動。AIクライアント
+                                 （Claude Code / Cursor 等）に登録すると、対話の中で
+                                 CLUBS への登録（clubs_register）と疎通確認
+                                 （clubs_link_status）ができる。例:
+                                   claude mcp add clubs -- npx -y clubs-nippo@latest mcp
+
+収集元:
+  --source=claude-code           この端末の Claude Code セッション記録（既定）
+  --source=cowork                Cowork（Claude のもう1つの面。claude-code と合算可）
+  --source=codex-cli             Codex CLI（~/.codex/sessions）
+  --source=gemini-cli            Gemini CLI（指示は logs.json、ツール実行は telemetry
+                                 有効時のみ＝GEMINI_TELEMETRY_FILE）
+  --source=copilot-cli           GitHub Copilot CLI（~/.copilot・実験的対応）
+  --source=events-file --events=path.jsonl
+                                 エージェントが書き出した実行記録（Hermes など）
+                                 形式は docs/events-schema.md を参照
+
+環境変数は .env か通常の環境変数で渡す。README.md を参照。`;
+
+const main = async () => {
+  const argv = parseArgs(process.argv.slice(2));
+  if (argv.help) {
+    console.log(HELP);
+    return;
+  }
+
+  // ── mcp: MCP サーバー（stdio）。stdout はプロトコル専用になる ──────
+  if (argv._[0] === "mcp") {
+    const { runMcpServer } = await import("../src/mcp.mjs");
+    await runMcpServer();
+    return;
+  }
+
+  // ── init: 接続画面が発行するコマンド1行で .env を書く（npx 導入の入口）──
+  // 対話にしない。値は CLUBS の接続画面が持っているので、コピペ1発で終わるべき。
+  if (argv._[0] === "init") {
+    // 接続コード方式（v1.4 §3.2）: 画面はトークンを見せず、10分・1回限りの
+    // コードだけを出す。ここで redeem してトークンに引き換える。
+    // --token 直接指定（従来・再発行モーダル）とは排他で、コードを優先する。
+    if (argv.code) {
+      if (!argv.url) {
+        console.log("使い方: clubs-nippo init --url=<取込URL> --code=<接続コード>");
+        process.exit(1);
+      }
+      const redeemUrl = new URL("/api/nippo/agents/redeem", argv.url).toString();
+      let res;
+      try {
+        res = await fetch(redeemUrl, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ code: argv.code }),
+        });
+      } catch (e) {
+        console.log(`接続先に届きませんでした（${e?.message ?? e}）。URL を確認してください: ${redeemUrl}`);
+        process.exit(1);
+      }
+      const body = await res.json().catch(() => ({}));
+      if (!res.ok || !body.token) {
+        // コードは 1 回限り・TTL 10 分。失効はエラーではなく「やり直す」導線。
+        console.log(
+          body.error ??
+            "接続コードが無効か期限切れです。CLUBS の接続画面（体の詳細）で再発行してください。",
+        );
+        process.exit(1);
+      }
+      argv.token = body.token;
+      console.log("✓ 接続コードをトークンに引き換えました。");
+    }
+    const updates = Object.fromEntries(
+      Object.entries({
+        NIPPO_INGEST_URL: argv.url,
+        NIPPO_INGEST_TOKEN: argv.token,
+        SOURCE: argv.source,
+        EVENTS_FILE: argv.eventsFile,
+        AGENT_NAME: argv.agentName,
+        OWNER_NAME: argv.ownerName,
+      }).filter(([, v]) => v),
+    );
+    if (Object.keys(updates).length === 0) {
+      console.log(
+        "使い方: clubs-nippo init --url=<取込URL> --code=<接続コード> [--source=…]\n" +
+          "コマンドは CLUBS の接続画面からコピーできます。",
+      );
+      process.exit(1);
+    }
+    mkdirSync(join(APP_HOME, "out"), { recursive: true });
+    const envPath = join(APP_HOME, ".env");
+    // 既存の .env は生かし、渡されたキーだけ書き換える。
+    // トークン再発行や収集元変更で再実行しても、メール設定などが消えない。
+    const lines = existsSync(envPath)
+      ? readFileSync(envPath, "utf8").replace(/\n$/, "").split("\n")
+      : ["# clubs-nippo の設定。キーの一覧は https://www.npmjs.com/package/clubs-nippo を参照。"];
+    for (const [key, value] of Object.entries(updates)) {
+      const row = `${key}=${value}`;
+      const idx = lines.findIndex((l) => l.match(new RegExp(`^\\s*${key}\\s*=`)));
+      if (idx >= 0) lines[idx] = row;
+      else lines.push(row);
+    }
+    writeFileSync(envPath, lines.join("\n") + "\n", "utf8");
+    console.log(`設定を書きました: ${envPath}`);
+    console.log(`  ${Object.keys(updates).join(", ")}`);
+    // cron は PATH が細く npx が見つからないことが多い。実際に動いている node の
+    // 隣の npx をフルパスで使う（この行をそのまま登録すれば動く）。
+    const npx = join(dirname(process.execPath), "npx");
+    const hourlyLine = `0 * * * * ${tickCommand(npx).join(" ")} >> ${join(APP_HOME, "out", "cron.log")} 2>&1`;
+    console.log("");
+    const yes = await promptYesNo("毎朝の自動実行を登録しますか？ [Y/n]");
+    if (yes) {
+      try {
+        const msg = registerAutorun(hourlyLine, npx);
+        console.log(`✓ ${msg}。明日の朝、最初の日報が届きます。`);
+      } catch (e) {
+        console.log(`自動登録に失敗しました（${e?.message ?? e}）。うまくいかない場合は、この行を crontab -e に手で追記してください:`);
+        console.log(`  ${hourlyLine}`);
+      }
+    } else {
+      console.log("自動登録はスキップしました。あとで登録するには、この行を crontab -e に追記:");
+      console.log(`  ${hourlyLine}`);
+    }
+    console.log("");
+    console.log("今すぐ試す（前日分を発行）: npx clubs-nippo@latest");
+    return;
+  }
+
+  /* 前日から継続している用件（未完了の申し送り・原文）と、確定した代表表記。
+     どちらも CLUBS 側が持っているので collector-config から受け取り、生成
+     プロンプトに載せる。取れなくても生成は続ける（言い回しの揺れが残るだけで、
+     日報が出ないよりよい）。 */
+  let carryover = [];
+  let terms = [];
+
+  // ── tick: cron の毎時起動から呼ばれる（自動化レイヤ §3.3）─────────
+  // 配信ルールの正は CLUBS 設定。毎ティックで collector-config を読み、
+  // 「有効 ∧ 時刻到達 ∧ 本日未配信（サーバ側 draft の有無）」のときだけ発火する。
+  // 8時→9時に変えたら翌8時ティックはスキップ・9時ティックで発火。
+  // 取得できないティックは何もしない（次のティックで取り戻す）。
+  if (argv._[0] === "tick") {
+    const r = await fetchCollectorConfig();
+    if (!r.ok) {
+      console.log(`[tick] 設定を取得できませんでした（${r.reason}）。次のティックで再試行します。`);
+      return;
+    }
+    const c = r.config;
+    if (!c.due) {
+      const why = !c.schedule?.enabled
+        ? "配信は停止中"
+        : c.delivered
+          ? `本日分（${c.reportDate}）は配信済み`
+          : `配信時刻 ${c.schedule.time}（${c.schedule.tz}）前`;
+      console.log(`[tick] 発火しません — ${why}（現在 ${c.now?.time}）`);
+      return;
+    }
+
+    // アプリの設定で実行内容を上書きする（アプリ＝設定の正・秘密はローカルのまま）。
+    argv.date = c.reportDate;
+    if (Array.isArray(c.carryover)) carryover = c.carryover;
+    if (Array.isArray(c.terms)) terms = c.terms;
+    const ADAPTERS = new Set([
+      "claude-code",
+      "cowork",
+      "events-file",
+      "codex-cli",
+      "gemini-cli",
+      "copilot-cli",
+    ]);
+    const mapped = [
+      ...new Set(
+        (c.sources ?? []).map((s) => (ADAPTERS.has(s) ? s : "events-file")),
+      ),
+    ];
+    if (mapped.length > 0) argv.source = mapped.join(",");
+    if (
+      mapped.includes("events-file") &&
+      !process.env.EVENTS_FILE &&
+      !argv.eventsFile
+    ) {
+      // 収集できないまま毎時 exit 1 を繰り返さない（cron ノイズ防止）。
+      console.log(
+        `[tick] この接続（${c.sources?.join(",") ?? ""}）はローカルの実行記録 ` +
+          `EVENTS_FILE の設定が必要です。.env に EVENTS_FILE=path.jsonl を設定して ` +
+          `ください（docs/events-schema.md）。今回は何もしません。`,
+      );
+      return;
+    }
+    if (mapped.includes("events-file") && c.agentName) {
+      // events-file 系（Hermes/OpenClaw/その他）は名義を外から与える。
+      // claude-code 等のブランド収集元は帰属の規律で名義固定（上書きしない）。
+      process.env.AGENT_NAME = c.agentName;
+    }
+    if (c.generator?.backend === "openrouter") {
+      process.env.GENERATOR = "openrouter";
+      if (c.generator.model) process.env.OPENROUTER_MODEL = c.generator.model;
+    } else if (c.generator?.backend === "openai-compat") {
+      // base URL / model は接続設定（control plane）から。API キーはローカル .env のまま。
+      process.env.GENERATOR = "openai-compat";
+      if (c.generator.baseUrl) process.env.BACKEND_BASE_URL = c.generator.baseUrl;
+      if (c.generator.model) process.env.BACKEND_MODEL = c.generator.model;
+    } else if (c.generator?.backend === "claude-cli") {
+      process.env.GENERATOR = "claude";
+    }
+    console.log(
+      `[tick] 発火: 対象日 ${c.reportDate} / source=${argv.source ?? "(ローカル設定)"} / generator=${process.env.GENERATOR ?? "claude"}`,
+    );
+    argv.tick = true; // 取込失敗時の早期打ち切り・メール未設定スキップに使う
+    argv._ = []; // 以降は通常パイプライン（収集→生成→登録→取込→送信→カード）
+  }
+
+  const config = loadConfig(argv);
+  const activity = await collect(config);
+
+  // 実ログから過去ぶんの履歴を作り直す。カードの「連続」「累計」条件は系列が要る。
+  if (argv._[0] === "backfill") {
+    const days = Number(argv._[1] ?? 14);
+    const rows = [];
+    for (let i = days; i >= 0; i -= 1) {
+      const d = new Date(Date.now() + config.tzOffsetMin * 60_000 - i * 86_400_000)
+        .toISOString()
+        .slice(0, 10);
+      const a = await collect({ ...config, date: d });
+      if ((a.aggregates?.totalCalls ?? 0) === 0) continue; // 稼働していない日は積まない
+      appendHistory(a);
+      rows.push(`${d}: 実行 ${a.aggregates?.totalCalls ?? 0} / 失敗 ${a.aggregates?.failedCalls ?? 0} / ${a.aggregates?.activeHours ?? 0}h`);
+    }
+    console.log(`履歴に ${rows.length} 日ぶんを積みました（out/history.jsonl）`);
+    for (const r of rows) console.log("  " + r);
+    return;
+  }
+
+  if (argv._[0] === "collect") {
+    console.log(JSON.stringify({ date: activity.date, ...activity.aggregates }, null, 2));
+    return;
+  }
+
+  if (argv._[0] === "cards") {
+    appendHistory(activity);
+    // --dry-run なら保存しない。しきい値を変えて試すときは必ずこちら。
+    // 発行してしまうと、達成カードは剥奪できないので取り消せない。
+    const r = evaluateCards({
+      history: readHistory(),
+      date: activity.date,
+      config,
+      dryRun: config.dryRun,
+    });
+    if (r.dryRun) console.log("（--dry-run: 保存していません）");
+    console.log(`発行: ${r.issued.map((c) => `${c.name}(${c.rarity})`).join(", ") || "なし"}`);
+    console.log(`進行中: ${r.progress.map((p) => `${p.name} ${p.progress}%`).join(", ") || "なし"}`);
+    console.log(`判定不可: ${r.unavailable.map((u) => `${u.id}（${u.reason}）`).join(", ") || "なし"}`);
+    console.log(`保有: 達成 ${r.data.achievements.length} / 称号 ${r.data.titles.length} / 解放可能な権限 ${r.data.permissionsUnlockable.length}`);
+    return;
+  }
+
+  console.log(
+    `[1/5] 収集: ${activity.date} / ${activity.agentName}（${activity.source}） — 実行 ${activity.aggregates?.totalCalls ?? 0}回 / 成功率 ${activity.aggregates?.successRate ?? "-"}% / 実働 ${activity.aggregates?.activeHours ?? 0}h`,
+  );
+
+  /* 手動実行（tick 以外）でも継続中の用件・確定した表記を拾う。tick で既に
+     取れていれば引き直さない。取れなくても生成は続ける。 */
+  if (
+    carryover.length === 0 &&
+    terms.length === 0 &&
+    config.ingestUrl &&
+    config.ingestToken
+  ) {
+    const r = await fetchCollectorConfig();
+    if (r.ok && Array.isArray(r.config?.carryover)) carryover = r.config.carryover;
+    if (r.ok && Array.isArray(r.config?.terms)) terms = r.config.terms;
+  }
+  if (carryover.length > 0) {
+    console.log(`[1/5] 継続中の用件 ${carryover.length}件 を生成に渡します`);
+  }
+  if (terms.length > 0) {
+    console.log(`[1/5] 確定した表記 ${terms.length}件 を生成に渡します`);
+  }
+
+  const narrative = await generateNarrative(activity, {
+    ...config,
+    carryover,
+    terms,
+  });
+  console.log(`[2/5] 本文生成: ${narrative.generator} — ${narrative.workBlocks.length} ブロック`);
+
+  // 承認フロー: 生成した時点でいったん下書きとして保存する。
+  // 登録も送信もここではしない。承認して初めて記録され、確定する。
+  const draft = saveDraft({ activity, narrative });
+  if (argv.draft) {
+    console.log(`[3/3] 下書き保存: out/${draft.date}.draft.json`);
+    console.log(`      承認は Web 画面から: node bin/clubs-nippo-web.mjs`);
+    return;
+  }
+
+  // ingest モード（CLUBS 接続済み）では証明もメールもサーバ側の仕事
+  // （接続画面デバッグリスト §-1）。ユーザーがローカルに置く鍵は OpenRouter だけで、
+  // LEMMA_API_KEY / EMAIL_API_KEY が無くてもエラーにならず正常終了する。
+  const ingestMode = Boolean(config.ingestUrl && config.ingestToken);
+
+  const proof = ingestMode
+    ? {
+        status: "pending",
+        label: "照合予定",
+        docHash: documentHash(activity, narrative),
+        reason: "サーバ側で照合（取込時に CLUBS が登録）",
+        verifyUrl: null,
+      }
+    : await registerProof(activity, narrative, config);
+  console.log(
+    ingestMode
+      ? `[3/5] 証明: サーバ側で照合します (${proof.docHash.slice(0, 12)}…)`
+      : proof.status === "verified"
+        ? `[3/5] 証明: ✓ ログ照合済み (${proof.docHash.slice(0, 12)}…)`
+        : `[3/5] 証明: 照合予定 — ${proof.reason}`,
+  );
+
+  // web コンソール（clubsx）へ本文ごと取り込ませる。未設定・失敗でもここで止めない。
+  // --dry-run はサーバにも送らない: ingest 受信でサーバ側の Lemma 実登録・
+  // 日報メール実送信（当日分の送信権の消費）が走るため、dry のつもりが実行為になる。
+  const ingest = config.dryRun
+    ? { ok: false, reason: "--dry-run のため取込しません" }
+    : await pushToClubs(activity, narrative, proof, config);
+  console.log(
+    ingest.quiet
+      ? `[web] コンソール取込: ✓ 受け取られました（稼働なしの日として畳まれます）`
+      : ingest.ok
+        ? `[web] コンソール取込: ✓ 送信しました`
+        : `[web] コンソール取込: スキップ — ${ingest.reason}`,
+  );
+
+  /* 稼働のなかった日（土日など）はサーバが日報にしない。ここで止める——
+     この先は描画・メール・カードで、どれも「日報が在ること」が前提になる。
+     履歴だけは積む（月次のグラフと連続日数の判定は、動かなかった日も系列として
+     要る）。tick の冪等はサーバ側の印が持つので、次のティックでは発火しない。 */
+  if (ingest.quiet) {
+    console.log(
+      `[4/5] 稼働なし: ${activity.date} は日報にしません（メールも送りません）。`,
+    );
+    appendHistory(activity);
+    return;
+  }
+
+  // tick モードの冪等はサーバ側 draft（＝取込の成功）が門。取込に失敗したまま
+  // 先へ進むと、メールだけ送られて delivered が立たず、次のティックで丸ごと
+  // 再実行（二重メール・生成し直しで docHash が変わり Lemma 二重登録）になる。
+  // ここで止めて、次のティックに任せる。
+  if (argv.tick && !ingest.ok) {
+    console.log(`[tick] 取込に失敗したため、ここで止めます（次のティックで再試行）。`);
+    return;
+  }
+
+  const html = renderHtml({ activity, narrative, proof, config });
+  const subject = buildSubject({ activity, config, proof });
+
+  const outDir = join(APP_HOME, "out");
+  mkdirSync(outDir, { recursive: true });
+  const outPath = argv.out ?? join(outDir, `nippo-${activity.date}.html`);
+  writeFileSync(outPath, html, "utf8");
+  console.log(`[4/5] 描画: ${outPath}`);
+
+  if (config.dryRun) {
+    console.log(`[5/5] --dry-run のため送信しません。件名: ${subject}`);
+    return;
+  }
+
+  if (ingestMode) {
+    // ローカル送信はしない（EMAIL_API_KEY 不要）。メールは CLUBS がサーバ側で
+    // 送る（取込時・本人確認済みアドレス宛）。履歴・シール評価は続ける。
+    // 取込に失敗していたら証明もメールもどこにも届いていない——成功に見せない
+    //（tick は上で早期 return 済み＝ここに来る失敗は手動実行）。
+    if (ingest.ok) {
+      console.log(`[5/6] 送信: メールは CLUBS からお届けします（ローカル送信なし）`);
+    } else {
+      console.log(
+        `[5/6] 送信: なし — 取込に失敗したため、証明もメールも届いていません。時間をおいて再実行してください。`,
+      );
+      process.exitCode = 1;
+    }
+  } else {
+    const sent = await sendMail({ subject, html, config });
+    console.log(`[5/6] 送信: ${sent.to.join(", ")} (id: ${sent.id})`);
+  }
+
+  // 集計を履歴に積み、カードを評価する。
+  // 履歴が要るのは「30日連続」のような条件が系列でしか判定できないため。
+  appendHistory(activity);
+  const cards = evaluateCards({ history: readHistory(), date: activity.date, config });
+  console.log(
+    cards.issued.length > 0
+      ? `[6/6] カード: ${cards.issued.map((c) => `${c.name}(${c.rarity})`).join(", ")} を発行`
+      : `[6/6] カード: 発行なし` +
+          (cards.progress.length
+            ? `（進行中: ${cards.progress.map((p) => `${p.name} ${p.progress}%`).join(", ")}）`
+            : ""),
+  );
+  if (cards.unavailable.length > 0) {
+    console.log(
+      `      判定できないカード ${cards.unavailable.length} 枚: ${cards.unavailable.map((u) => u.id).join(", ")}`,
+    );
+  }
+};
+
+main().catch((e) => {
+  console.error(`エラー: ${e.message}`);
+  process.exit(1);
+});

package/docs/events-schema.md

@@ -0,0 +1,76 @@
+# 実行記録スキーマ（events-file）
+
+Claude Code 以外のエージェント — CTO のサーバで動き Telegram に常駐する Hermes など — は、
+自分の実行記録を**この形の JSONL に吐き出すだけ**で日報を作れる。clubs-nippo 側に
+エージェント専用のコードを足す必要はない。
+
+## 形
+
+1行1イベント。必須は `ts` `tool` `ok` の3つだけ。
+
+```jsonl
+{"ts":"2026-07-13T09:12:04+09:00","tool":"telegram.reply","ok":true,"summary":"問い合わせに一次回答","project":"サポート"}
+{"ts":"2026-07-13T09:31:20+09:00","tool":"github.create_issue","ok":true,"summary":"バグ報告を issue 化","project":"clubsx"}
+{"ts":"2026-07-13T10:02:11+09:00","tool":"deploy.staging","ok":false,"summary":"lint で失敗","project":"clubsx"}
+{"ts":"2026-07-13T09:10:00+09:00","kind":"instruction","summary":"今日の問い合わせをさばいておいて"}
+```
+
+| フィールド | 必須 | 意味 |
+|---|---|---|
+| `ts` | ✅ | ISO8601。**タイムゾーン付きで書くこと**（無い場合は UTC と解釈される） |
+| `tool` | ✅ | 実行したものの名前。日報では「ツール」として集計・表示される |
+| `ok` | ✅ | 成否。`true` / `false`。**成功率はこれだけから出す** |
+| `summary` | | 1行の要約。日報の本文を書く材料になる |
+| `project` | | 案件名。日報のブロック分けに使う |
+| `model` | | その実行に使ったモデル（例 `anthropic/claude-sonnet-4.5`）。OpenRouter 等で切り替えるエージェント向け |
+| `kind` | | `"instruction"` ならオーナーからの指示文として扱う（`tool` / `ok` は不要） |
+
+## model について（OpenRouter 等でモデルを切り替える場合）
+
+**エージェント＝身元、モデル＝取り替え可能な部品。** Hermes が OpenRouter で5つのモデルを
+行き来しても、パスポートを持つのは Hermes 1体で、日報も1通。**モデルは名義に一切影響しない**
+（課金軸もエージェントであってモデルではない）。
+
+`model` を記録すると、日報のプロフィール行が実際の内訳になる。
+
+```
+anthropic/claude-sonnet-4.5 ×3 · deepseek/deepseek-v3 ×3 · openai/gpt-5 ×1
+```
+
+**静的なモデル名を1つ掲げるのは嘘になる。** 1日の半分を別のモデルがやったのに
+「このモデルがやりました」と書くのは、ログと一致しないことを主張することであり、
+✓ の規律に反する。`model` を記録しないエージェントは、モデル行に何も出ない
+（無いものを在ることにしない）。
+
+## ok を記録していない場合
+
+`ok` の無いイベントは成功率の分母から外れ、成功率は `-` になる。数字を作らないための挙動で、
+エラーではない。ただし成功率が出ない日報は「何回動いたか」しか言えないので、
+成否を記録できるなら記録したほうがよい。
+
+## 使い方
+
+```bash
+node bin/clubs-nippo.mjs \
+  --source=events-file \
+  --events=/path/to/hermes-events.jsonl \
+  --date=2026-07-13 \
+  --dry-run
+```
+
+`.env` に書くなら:
+
+```
+SOURCE=events-file
+EVENTS_FILE=/path/to/hermes-events.jsonl
+AGENT_NAME=Hermes
+```
+
+## 帰属について
+
+`AGENT_NAME` が効くのは **`events-file` のときだけ**。`claude-code` を収集元にした日報は
+必ず `Claude` 名義で出る（`AGENT_NAME=Hermes` を設定しても無視され、警告が出る）。
+
+Claude Code のログから作った日報に Hermes の名前を付けられてしまうと、他のAIの作業を
+自分の実績にできることになり、✓ の意味が崩れるため。日報のフッタには必ず
+「収集元」が印字されるので、どこから作られたものかは後からでも分かる。

package/examples/hermes-events.sample.jsonl

@@ -0,0 +1,8 @@
+{"ts":"2026-07-13T09:10:00+09:00","kind":"instruction","summary":"今日届いた問い合わせをさばいて、バグっぽいものは issue にしておいて"}
+{"ts":"2026-07-13T09:12:04+09:00","tool":"telegram.reply","ok":true,"model":"anthropic/claude-sonnet-4.5","summary":"導入の相談に一次回答","project":"サポート"}
+{"ts":"2026-07-13T09:18:41+09:00","tool":"telegram.reply","ok":true,"model":"anthropic/claude-sonnet-4.5","summary":"料金体系の質問に回答","project":"サポート"}
+{"ts":"2026-07-13T09:31:20+09:00","tool":"github.create_issue","ok":true,"model":"deepseek/deepseek-v3","summary":"ログイン後にリダイレクトされない不具合を issue 化","project":"clubsx"}
+{"ts":"2026-07-13T09:44:02+09:00","tool":"github.comment","ok":true,"model":"deepseek/deepseek-v3","summary":"再現手順を追記","project":"clubsx"}
+{"ts":"2026-07-13T10:02:11+09:00","tool":"deploy.staging","ok":false,"model":"deepseek/deepseek-v3","summary":"lint に引っかかり中断","project":"clubsx"}
+{"ts":"2026-07-13T10:09:55+09:00","tool":"deploy.staging","ok":true,"model":"openai/gpt-5","summary":"lint を直して再実行、成功","project":"clubsx"}
+{"ts":"2026-07-13T14:20:30+09:00","tool":"telegram.reply","ok":true,"model":"anthropic/claude-sonnet-4.5","summary":"進捗を報告","project":"サポート"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@clubs.place/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.18",
+  "description": "AI\u696d\u52d9\u65e5\u5831 \u2014 Claude Code \u306e\u5b9f\u884c\u30ed\u30b0\u304b\u3089\u524d\u65e5\u3076\u3093\u306e\u65e5\u5831\u30e1\u30fc\u30eb\u3092\u751f\u6210\u3057\u3066\u9001\u308b\uff08pull\u578b\u30fb\u672c\u6587\u751f\u6210\u306f\u30e6\u30fc\u30b6\u30fc\u5074LLM\u30fb\u751f\u30ed\u30b0\u306f\u7aef\u672b\u3092\u51fa\u306a\u3044\uff09",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "clubs-place": "bin/clubs-nippo",
+    "clubs-nippo": "bin/clubs-nippo",
+    "clubs-place-cli": "bin/clubs-nippo"
+  },
+  "files": [
+    "bin",
+    "src",
+    "web",
+    "templates",
+    "examples",
+    "docs/events-schema.md",
+    ".env.example",
+    "PROVENANCE.json"
+  ],
+  "keywords": [
+    "clubs",
+    "nippo",
+    "ai-agent",
+    "daily-report",
+    "claude-code"
+  ],
+  "homepage": "https://clubs.place",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "nippo": "node ./bin/clubs-nippo.mjs",
+    "dry": "node ./bin/clubs-nippo.mjs --dry-run",
+    "demo": "node scripts/gen-preview.mjs && node scripts/bundle-demo.mjs",
+    "test": "node --test",
+    "prepublishOnly": "node scripts/gen-provenance.mjs"
+  },
+  "dependencies": {
+    "@lemmaoracle/spec": "^0.0.37"
+  },
+  "optionalDependencies": {
+    "@lemmaoracle/sdk": "file:../../lemmaoracle/lemma/packages/sdk"
+  }
+}