@clubs.place/cli 0.0.0-stage → 0.1.18

package/src/narrative.mjs

@@ -0,0 +1,191 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { buildPrompt } from "./prompt.mjs";
+import claudeGenerator from "./generators/claude.mjs";
+import codexGenerator from "./generators/codex.mjs";
+import geminiGenerator from "./generators/gemini.mjs";
+import copilotGenerator from "./generators/copilot.mjs";
+import openrouterGenerator from "./generators/openrouter.mjs";
+import openaiCompatGenerator from "./generators/openai-compat.mjs";
+
+const GENERATORS = {
+  [claudeGenerator.id]: claudeGenerator,
+  [codexGenerator.id]: codexGenerator,
+  [geminiGenerator.id]: geminiGenerator,
+  [copilotGenerator.id]: copilotGenerator,
+  [openrouterGenerator.id]: openrouterGenerator,
+  [openaiCompatGenerator.id]: openaiCompatGenerator,
+};
+
+/** ```json ... ``` や前置きが混ざっても、最初の { から最後の } までを取り出す。 */
+const extractJson = (raw) => {
+  const start = raw.indexOf("{");
+  const end = raw.lastIndexOf("}");
+  if (start === -1 || end === -1 || end <= start) return null;
+  try {
+    return JSON.parse(raw.slice(start, end + 1));
+  } catch {
+    return null;
+  }
+};
+
+
+const UNSET_PROJECT = "（案件未設定）";
+
+/** イベント列から「何に触れたか」を数件ひろう。要点推測の手がかりになる。 */
+const representativeTargets = (list, limit = 4) => {
+  const seen = new Set();
+  const out = [];
+  for (const e of list) {
+    const s = String(e.summary ?? "")
+      .replace(/\s+/g, " ")
+      .trim();
+    if (s && !seen.has(s)) {
+      seen.add(s);
+      // コードポイント単位で丸める（.slice は UTF-16 単位でサロゲートを割り、
+      // 絵文字・稀CJK が末尾で欠けると � になるため）。
+      const chars = [...s];
+      out.push(chars.length > 44 ? `${chars.slice(0, 44).join("")}…` : s);
+    }
+    if (out.length >= limit) break;
+  }
+  return out;
+};
+
+/**
+ * LLM を使わない/失敗した時の決定的な本文。ログの集計だけで組み立てる。
+ *
+ * reason を渡すと「本文生成が外れた」ことを日報本文（selfNote）と生成ラベルの
+ * 両方に出す。黙って集計値だけの本文を届けると、受け取った側は劣化に気づけない
+ * ——「日報は届いたが中身は空回り」を検知可能にするための警告。
+ * 意図的に LLM を使わない設定（GENERATOR=none 等）では reason を渡さない。
+ */
+/** 生成器の種類に応じた、ユーザー向けのセットアップ案内。 */
+const setupHelp = (generatorId) => {
+  switch (generatorId) {
+    case "claude":
+      return "【直し方】お使いの端末に Claude Code がインストールされているか確認してください。ターミナルで `claude -p \"hello\"` と打って応答があれば正常です。CLUBS の接続設定画面で Generator を「OpenRouter」に切り替えることもできます（別途 API キーが必要です）。";
+    case "codex":
+      return "【直し方】お使いの端末に Codex CLI がインストールされているか確認してください。CLUBS の接続設定画面で Generator を変更することもできます。";
+    case "gemini":
+      return "【直し方】お使いの端末に Gemini CLI がインストールされているか確認してください。CLUBS の接続設定画面で Generator を変更することもできます。";
+    case "copilot":
+      return "【直し方】お使いの端末に Copilot CLI がインストールされているか確認してください。CLUBS の接続設定画面で Generator を変更することもできます。";
+    case "openrouter":
+      return "【直し方】OpenRouter の API キーが .env に正しく設定されているか確認してください。キーは https://openrouter.ai/keys から取得できます。";
+    case "openai-compat":
+      return "【直し方】OpenAI 互換エンドポイントの URL と API キーが .env に正しく設定されているか確認してください。";
+    default:
+      return "【直し方】CLUBS の接続設定画面で Generator の設定を確認してください。";
+  }
+};
+
+export const fallbackNarrative = (activity, reason = "", generatorId = "") => {
+  const { aggregates: a, events } = activity;
+
+  // 案件（project）で束ねる。source によっては未設定のことがあるので、空は
+  // 明示のプレースホルダに寄せる（byProject のキーが "undefined"/"" になって
+  // タイトル空・「、で」の欠けた文になる不具合を防ぐ）。
+  const byProject = {};
+  for (const e of events) {
+    const key = String(e.project ?? "").trim() || UNSET_PROJECT;
+    byProject[key] ??= [];
+    byProject[key].push(e);
+  }
+
+  const workBlocks = Object.entries(byProject).map(([project, list]) => {
+    const counts = {};
+    for (const e of list) counts[e.name] = (counts[e.name] ?? 0) + 1;
+    const ranked = Object.entries(counts).sort((x, y) => y[1] - x[1]);
+    const tools = ranked.map(([k, v]) => `${k}×${v}`).join(" · ");
+    // タグは「最初に出たツール」ではなく代表ツール。ただし混在ブロックを1ツール名で
+    // 代表すると誤読を招くため、単一ツールのときだけ付ける。
+    const tool = ranked.length === 1 ? ranked[0][0] : undefined;
+
+    // 本文は「何に触れたか」を主役にする。ツール内訳は下の metric に出るので本文で
+    // 重複させない（本文は約160字で丸められるため、要点推測の手がかりになる触れた
+    // 対象を先に置いて、内訳の羅列に食われないようにする）。
+    const named = project === UNSET_PROJECT ? "" : `${project}で`;
+    const targets = representativeTargets(list);
+    const touched = targets.length
+      ? `主に触れたのは ${targets.join(" / ")} など。`
+      : `内訳は ${tools}。`;
+    return {
+      title: project,
+      ...(tool ? { tool } : {}),
+      text:
+        `${list.at(0)?.time ?? "-"} から ${list.at(-1)?.time ?? "-"} にかけて、` +
+        `${named}${list.length} 回の操作を実行。${touched}`,
+      metric: `実行 ${list.length}回 · ${tools}`,
+    };
+  });
+
+  const summary = `${a.totalCalls} 件の操作を実行し、失敗は ${a.failedCalls} 件でした。`;
+
+  return {
+    workBlocks,
+    handoff: { title: "明日にまわすもの", text: "特にありません。" },
+    insights: [],
+    selfNote: reason
+      ? // 末尾に件数サマリーは付けない。メールのエージェントカードに実行/失敗が
+        // 出るため重複する（受け手には二重に見える）。
+        `⚠ AIによる本文の自動生成ができませんでした。このメールの内容はログの集計値から機械的に組み立てています。\n\n${setupHelp(generatorId)}`
+      : summary,
+    generator: reason ? `fallback（${reason}）` : "fallback",
+  };
+};
+
+/**
+ * 本文生成。
+ *
+ * 生成器は差し替え可能:
+ *   claude/codex/gemini/copilot … その端末の AI CLI をヘッドレスで叩く。
+ *                                 収集元と揃えれば1つのサブスクで日報まで完結する
+ *   openrouter    … OpenRouter の API。モデルを切り替えるエージェント（Hermes など）向け
+ *   openai-compat … OpenAI 互換のカスタムエンドポイント（Sakana Fugu 等）
+ *   none          … LLM を使わず、集計値だけで決定的に組む
+ *
+ * どの生成器が落ちても throw しない。fallback（集計値だけの本文）に落として完走する。
+ * 日報が届かないより、機械的でも届くほうがよい。ただし黙って落ちない——
+ * 意図しない fallback は理由つきで本文と標準出力の両方に出す。
+ */
+export const generateNarrative = async (activity, config) => {
+  if (config.generator === "none" || !config.useLlm || activity.events.length === 0) {
+    return fallbackNarrative(activity);
+  }
+
+  const generator = GENERATORS[config.generator];
+  if (!generator) {
+    console.warn(
+      `[narrative] 未知の GENERATOR です: ${config.generator}` +
+        `（使えるのは ${Object.keys(GENERATORS).join(", ")}, none）。fallback を使います。`,
+    );
+    return fallbackNarrative(activity, `未知の GENERATOR: ${config.generator}`, config.generator);
+  }
+
+  const prompt = buildPrompt(activity, {
+    carryover: config.carryover,
+    terms: config.terms,
+  });
+
+  try {
+    const raw = await generator.generate(prompt, config);
+    const parsed = extractJson(raw);
+    if (!parsed?.workBlocks?.length) {
+      console.warn(`[narrative] ${generator.id} の応答を解釈できず fallback に切り替えます。`);
+      return fallbackNarrative(activity, `${generator.id} の応答を解釈できず`, generator.id);
+    }
+    return { ...parsed, generator: generator.label(config) };
+  } catch (e) {
+    // 未インストール（ENOENT）は「その CLI がこの端末に無い」＝設定ミスの典型なので明示する。
+    const why =
+      e.code === "ENOENT"
+        ? `${generator.id} がこの端末に見つからず`
+        : `${generator.id} での生成に失敗（${e.message}）`;
+    console.warn(`[narrative] ${why}。fallback を使用します。`);
+    return fallbackNarrative(activity, why, generator.id);
+  }
+};

package/src/prompt.mjs

@@ -0,0 +1,184 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+/**
+ * LLM に渡すプロンプト。生成器（claude / openrouter）に依存しない。
+ */
+
+/**
+ * LLM に渡すダイジェスト。
+ * 生ログそのもの（コマンド全文・ファイル内容・ツール出力）は入れない。
+ * 入るのは「ツール名・時刻・成否・マスク済みの短い要約・指示文の先頭」だけ。
+ */
+const buildDigest = (activity) => {
+  const { aggregates: a, events, prompts } = activity;
+
+  // 案件名がすべて「（案件未設定）」なら、LLM に分類させるためフラットに渡す。
+  // そうでなければ既存の案件名でグループ化する。
+  const allUnlabeled = events.every(
+    (e) => !e.project || e.project === "（案件未設定）",
+  );
+
+  let eventSection;
+  if (allUnlabeled) {
+    // フラット: 全イベントを時系列で渡す。LLM が案件を推測する。
+    const lines = events.map((e) => `  ${e.time} ${e.name}: ${e.summary}`);
+    const counts = {};
+    for (const e of events) counts[e.name] = (counts[e.name] ?? 0) + 1;
+    eventSection = [
+      `ツール実行（案件未分類・全 ${events.length} 回。内容から案件名を推測してください）:`,
+      `  内訳: ${Object.entries(counts)
+        .map(([k, v]) => `${k}×${v}`)
+        .join(", ")}`,
+      ...lines.slice(0, 60), // サンプル最大60件
+      lines.length > 60 ? `  ... 他 ${lines.length - 60} 件` : "",
+    ].join("\n");
+  } else {
+    const byProject = {};
+    for (const e of events) {
+      byProject[e.project] ??= [];
+      byProject[e.project].push(e);
+    }
+    const projectLines = Object.entries(byProject).map(([project, list]) => {
+      const counts = {};
+      for (const e of list) counts[e.name] = (counts[e.name] ?? 0) + 1;
+      const samples = list
+        .slice(0, 12)
+        .map((e) => `    ${e.time} ${e.name}: ${e.summary}`);
+      return [
+        `  [${project}] ${list.length}回 (${Object.entries(counts)
+          .map(([k, v]) => `${k}×${v}`)
+          .join(", ")})`,
+        ...samples,
+      ].join("\n");
+    });
+    eventSection = [
+      "ツール実行（プロジェクト別・マスク済みの要約のみ）:",
+      ...projectLines,
+    ].join("\n");
+  }
+
+  return [
+    `対象日: ${activity.date}`,
+    `実働推定: ${a.activeHours}時間 / 実行 ${a.totalCalls}回 / 成功率 ${a.successRate ?? "-"}% / 失敗 ${a.failedCalls}回`,
+    `稼働時間帯: ${a.firstAt ?? "-"} 〜 ${a.lastAt ?? "-"}`,
+    `関与プロジェクト: ${a.projects.join(", ") || "なし"}`,
+    "",
+    "オーナーからの指示（先頭のみ・マスク済み）:",
+    ...prompts.map((p) => `  ${p.time} ${p.text}`),
+    "",
+    eventSection,
+  ].join("\n");
+};
+
+const PROMPT_HEADER = `あなたはオーナーの AI アシスタント「{{AGENT}}」です。
+下の「実行ログのダイジェスト」だけを根拠に、オーナー宛の業務日報の本文を書いてください。
+
+厳守事項:
+- ダイジェストに無い事実を足さない。推測で数字を作らない。金額・件数はダイジェストにあるものだけ。
+- 「[[REDACTED]]」はオーナーがマスクした箇所。そのまま [[REDACTED]] と書くこと（勝手に復元・推測しない）。
+- 各ブロックは「何をして・どこまで進めたか」が伝わる 2〜4文のナラティブで、要点だけに絞る。代表的な成果・判断・結果を1つずつ書き、細かな下位項目を列挙・網羅しない（読むのに疲れさせない）。専門用語は開いて書く。冗長な前置き・同義の言い換え・水増しはしない。目安は3〜5行。
+- 申し送りは箇条書きで書いてください。1行につき用件はひとつだけです。複数の用件を1行にまとめないでください。（例: 「PR #32のマージ判断」と「接続ページの実装着手」は別の行にする）
+- 継続中の用件は、前日と同じ表現をそのまま使ってください。{{CARRYOVER}}{{TERMS}}
+- terms は**拾うだけ**です。プロジェクト名・システム名・略語・機能名など固有名詞的な語を、本文（workBlocks / handoff / insights / selfNote）に書いたとおり**原文の一部をそのまま**入れてください。一般名詞・動詞は拾わない——**ただし、その組織が機能名・概念名として使っている日本語の語は拾う**（例:「申し送り」「用語集」「繰越」「本物証明」のように、辞書では一般名詞でも、そのチームでは決まったものを指して繰り返し使われている語）。日本語の語も英字の語と同じだけ拾ってください。**人名も拾わない**（オーナー・同僚・AI の体名）——用語集は「何をなんと呼ぶか」を揃える場所で、人の名前はそこに要らない。ただしアカウント名・サービス名として使われている場合（例:「◯◯名義の投稿」）は、人ではなく対象なので拾ってよい。言い換え・要約・定義文は書かない（本文と1文字でも違う語は捨てられます）。**語であって文ではない**——文・箇条書きの一行・ファイル名・日付や見積りの入った見出し・図のラベル列は拾わない。無ければ空配列。
+- decisions も**拾うだけ**です。本文（workBlocks / handoff / insights / selfNote）の中から、**決まったことを述べている一文**を原文のまま抜き出してください。拾うのは「〜することにした」「〜で確定」「〜を採用」「〜に決めた」「〜で進める」のように決定を述べた文だけです。「〜したい」「〜を検討」「〜が良さそう」「〜すべき」「〜を提案」のような**まだ決まっていない文は入れないでください**。1件につき1文（複数の決定を1文にまとめない）、120字まで、1日あたり最大5件。迷ったら入れない。無ければ空配列。
+- insights（気づき・提案）は提案どまり。実行したとは書かない。無理に作らず、根拠が無ければ空配列。
+- selfNote は敬体の一言（2文以内）。誇張しない。
+- 文体は必ずですます調（AI がオーナーに宛てて書く日報です）。text・handoff・selfNote すべて、文末を「〜しました／〜しています／〜です」にする。である調（〜した／〜である）や体言止めの多用は避ける。title は名詞句のままでよい。例: ×「週次レポートに反映した。」→ ○「週次レポートに反映しました。」
+
+出力は次の JSON のみ。前後に説明文やコードフェンスを付けない。
+
+{
+  "workBlocks": [
+    { "icon": "案件に合う絵文字1つ（例: 実装📦 / 連携🔀 / データ🗄️ / 為替💱 / メール📧 / 修正🐛 / 文書📄 / デプロイ🚀 / 調査🔎 / 会議🤝）", "title": "案件名（短く）", "tool": "使ったツール名", "text": "2〜4文の要点ナラティブ（代表的な成果と結果。列挙・網羅しない・3〜5行目安）", "metric": "集計の一行（例: 実行 11回 · 成功 11 / 失敗 0）" }
+  ],
+  "handoff": { "title": "明日にまわすもの", "text": "申し送り。1行につき用件ひとつの箇条書き（行頭は - ）。無ければ『特にありません。』" },
+  "insights": [
+    { "icon": "🔁", "title": "気づきの見出し", "desc": "根拠と提案", "save": "見込み効果（不明なら空文字）" }
+  ],
+  "selfNote": "ひとこと",
+  "terms": ["本文に出てきた固有名詞的な語（原文のまま）", "…"],
+  "decisions": ["決まったことを述べた一文（本文からそのまま・最大5件）", "…"]
+}
+
+--- 実行ログのダイジェスト ---
+`;
+
+/**
+ * 前日から継続している用件を、**原文のまま**プロンプトに載せる。
+ *
+ * 繰越が同定されない主因は粒度である。1アイテムが「その日の申し送り全文」
+ * （3〜5の別用件を含む1段落）になっていると、日ごとに必ず内容が変わるため
+ * fingerprint は原理的に一致しない。上の「1行1用件」がそれを潰し、ここは
+ * その次の問題＝言い回しの揺れを潰す。**1行目が効かないとここは無意味**なので、
+ * 優先度は箇条書きの指示が上。
+ *
+ * 生成側への指示でしかなく、サーバー側の判定にも ✓ の発行にも影響しない
+ * （カノン「規則の適用と ✓ の鋳造はコア専権」に抵触しない）。
+ */
+const carryoverSection = (carryover) => {
+  const items = (Array.isArray(carryover) ? carryover : [])
+    .map((s) => String(s ?? "").trim())
+    .filter(Boolean);
+  if (!items.length) return "";
+  return [
+    "",
+    "  前日から継続している用件:",
+    ...items.map((s) => `  - ${s}`),
+  ].join("\n");
+};
+
+/**
+ * 確定した代表表記を、翌日の生成プロンプトへ戻す。
+ *
+ * これが用語集の**出口**にあたる。書き戻し（日報本文の自動置換）ではなく、
+ * 次に書く AI 自身に「この形で書いて」と伝えるだけ——本文は書き換えないし、
+ * 定義文も作らせない。表記が安定すると繰越の fingerprint 同定精度も上がるので、
+ * 用語集は繰越ボードの遠回りではなく同じ問題の上流にある。
+ *
+ * 渡すのは**確定済みのものだけ**（候補は渡さない）。件数と並び順の上限は
+ * サーバー側（collector-config）で決まっている。
+ */
+const termsSection = (terms) => {
+  const items = (Array.isArray(terms) ? terms : [])
+    .map((t) =>
+      typeof t === "string"
+        ? { canonical: t.trim(), variants: [] }
+        : {
+            canonical: String(t?.canonical ?? "").trim(),
+            variants: (Array.isArray(t?.variants) ? t.variants : [])
+              .map((v) => String(v ?? "").trim())
+              .filter(Boolean),
+          },
+    )
+    .filter((t) => t.canonical);
+  if (!items.length) return "";
+  return [
+    "",
+    "  以下の表記は、この形で書いてください:",
+    ...items.map((t) =>
+      t.variants.length
+        ? `  - ${t.canonical}（「${t.variants.join("」「")}」とは書かない）`
+        : `  - ${t.canonical}`,
+    ),
+  ].join("\n");
+};
+
+/*
+ * decisions には `carryoverSection` / `termsSection` にあたる差し込みが無い。
+ * Phase 1 は**検出だけ**で、確定操作も出口（生成側への還流）も持たないため——
+ * 還流できるのは人が確定したものだけで、確定する画面がまだ無い。
+ * 出力 JSON に列が増えるだけなので、プロンプトは片方向で閉じている。
+ */
+
+/**
+ * ダイジェスト付きの完成プロンプト。
+ * `carryover` は未完了の申し送り、`terms` は確定した代表表記
+ * （どちらも CLUBS の collector-config が返す）。どちらも空なら見出しごと消える。
+ */
+export const buildPrompt = (activity, { carryover, terms } = {}) =>
+  PROMPT_HEADER.replace("{{AGENT}}", activity.agentName)
+    .replace("{{CARRYOVER}}", carryoverSection(carryover))
+    .replace("{{TERMS}}", termsSection(terms)) + buildDigest(activity);

package/src/prompt.test.mjs

@@ -0,0 +1,146 @@
+// 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 { buildPrompt } from "./prompt.mjs";
+
+const activity = {
+  date: "2026-08-07",
+  agentName: "マメ",
+  aggregates: {
+    activeHours: 3,
+    totalCalls: 12,
+    successRate: 100,
+    failedCalls: 0,
+    firstAt: "09:12",
+    lastAt: "17:40",
+    projects: ["日報"],
+  },
+  events: [
+    { time: "09:12", name: "Bash", summary: "テスト実行", project: "日報" },
+  ],
+  prompts: [{ time: "09:10", text: "テストを流して" }],
+};
+
+test("粒度の指示（1行1用件）が必ず入る", () => {
+  const p = buildPrompt(activity);
+  assert.match(p, /申し送りは箇条書きで書いてください/);
+  assert.match(p, /1行につき用件はひとつだけです/);
+});
+
+test("継続中の用件が無いときは、その見出しごと出ない（プレースホルダも残らない）", () => {
+  const p = buildPrompt(activity);
+  assert.doesNotMatch(p, /\{\{CARRYOVER\}\}/);
+  assert.doesNotMatch(p, /前日から継続している用件/);
+});
+
+test("継続中の用件は原文のまま列挙される（言い回しを変えさせない）", () => {
+  const carryover = ["PR #32のマージ判断", "接続ページの実装着手"];
+  const p = buildPrompt(activity, { carryover });
+  assert.match(p, /前日から継続している用件:/);
+  for (const item of carryover) assert.ok(p.includes(`- ${item}`), item);
+});
+
+test("空文字・空白だけの項目は落とす", () => {
+  const p = buildPrompt(activity, { carryover: ["", "   ", null] });
+  assert.doesNotMatch(p, /前日から継続している用件/);
+});
+
+test("carryover の指定が無くても壊れない（tick 以外の手動実行）", () => {
+  assert.doesNotThrow(() => buildPrompt(activity));
+  assert.doesNotThrow(() => buildPrompt(activity, {}));
+});
+
+// ── 用語集（検出層と出口）─────────────────────────────────
+
+test("terms を出力 JSON に足し、検出だけをさせる指示が入る", () => {
+  const p = buildPrompt(activity);
+  assert.match(p, /"terms"/);
+  assert.match(p, /原文の一部をそのまま/);
+  // 定義文を書かせない・言い換えさせない（用語集 §6.1 / §7）。
+  assert.match(p, /言い換え・要約・定義文は書かない/);
+  // 人名は拾わせない。用語集は「何をなんと呼ぶか」を揃える場所で、
+  // 同僚の名前が並ぶ面ではない（サーバ側で機械的に弾く手が無いのでここで止める）。
+  assert.match(p, /人名も拾わない/);
+  // 日本語の業務語を拾わせる。「一般名詞は拾わない」だけだと、辞書では一般名詞の
+  // 機能名（申し送り・用語集）が落ち、英字の語ばかり残る（実データで確認）。
+  assert.match(p, /機能名・概念名として使っている日本語の語は拾う/);
+  // 語であって文ではない。文・ファイル名・図のラベルまで拾っていた。
+  assert.match(p, /語であって文ではない/);
+});
+
+test("確定した表記が無いときは、その見出しごと出ない", () => {
+  const p = buildPrompt(activity);
+  assert.doesNotMatch(p, /\{\{TERMS\}\}/);
+  assert.doesNotMatch(p, /この形で書いてください/);
+});
+
+test("確定した表記は代表と別表記の対で載る（用語集 §5）", () => {
+  const p = buildPrompt(activity, {
+    terms: [
+      { canonical: "MCP認証", variants: ["MCPの認証", "MCP auth"] },
+      { canonical: "繰越ボード", variants: [] },
+    ],
+  });
+  assert.match(p, /以下の表記は、この形で書いてください:/);
+  assert.ok(p.includes("- MCP認証（「MCPの認証」「MCP auth」とは書かない）"));
+  assert.ok(p.includes("- 繰越ボード"));
+});
+
+test("文字列だけの terms でも壊れない（サーバ応答の形が痩せても落ちない）", () => {
+  const p = buildPrompt(activity, { terms: ["繰越ボード", "", null] });
+  assert.ok(p.includes("- 繰越ボード"));
+  assert.doesNotMatch(p, /\{\{TERMS\}\}/);
+});
+
+test("carryover と terms は同時に載る", () => {
+  const p = buildPrompt(activity, {
+    carryover: ["PR #32のマージ判断"],
+    terms: [{ canonical: "MCP認証", variants: [] }],
+  });
+  assert.match(p, /前日から継続している用件:/);
+  assert.match(p, /以下の表記は、この形で書いてください:/);
+});
+
+// ── 決定ログ（検出のみ・Phase 1）───────────────────────────
+
+test("decisions を出力 JSON に足し、検出だけをさせる指示が入る", () => {
+  const p = buildPrompt(activity);
+  assert.match(p, /"decisions"/);
+  assert.match(p, /決まったことを述べている一文/);
+  assert.match(p, /原文のまま抜き出して/);
+});
+
+test("決定でないもの（意向・検討・提案）を拾わせない指示が入る（§3 過検出の防止）", () => {
+  const p = buildPrompt(activity);
+  // 最大のリスクは過検出。除外語がプロンプトから消えたら気づけるようにする。
+  for (const ng of [
+    "〜したい",
+    "〜を検討",
+    "〜が良さそう",
+    "〜すべき",
+    "〜を提案",
+  ]) {
+    assert.ok(p.includes(ng), ng);
+  }
+  assert.match(p, /まだ決まっていない文は入れないでください/);
+  assert.match(p, /迷ったら入れない/);
+});
+
+test("件数と長さの上限がプロンプトにも書かれる（サーバ側と二重に切る）", () => {
+  const p = buildPrompt(activity);
+  assert.match(p, /120字まで/);
+  assert.match(p, /1日あたり最大5件/);
+});
+
+test("decisions には還流の差し込みが無い（Phase 1 は片方向）", () => {
+  // 確定操作が無いので、生成側へ戻せる「確定した決定」は原理的に存在しない。
+  const p = buildPrompt(activity, {
+    carryover: ["継続の用件"],
+    terms: ["用語"],
+  });
+  assert.doesNotMatch(p, /\{\{DECISIONS\}\}/);
+});

package/src/remote-config.mjs

@@ -0,0 +1,72 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+/**
+ * CLUBS（clubsx）の collector-config を読む。
+ *
+ * 配信ルールの正はアプリ側（/nippo/settings・/nippo/connections）。収集器は
+ * 毎ティックでこれを読み、「時刻到達 ∧ 本日未配信（サーバ側 draft の有無）」の
+ * ときだけ発火する。冪等の判定をローカル状態に持たないので、マシンを replace
+ * しても二重配信しない。
+ *
+ * 認証は ingest と同じ連携トークン（NIPPO_INGEST_TOKEN）。エンドポイントは
+ * NIPPO_INGEST_URL から導出する（…/api/nippo/ingest → …/api/nippo/collector-config）。
+ */
+
+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 collectorConfigUrl = (ingestUrl) => {
+  if (!ingestUrl) return null;
+  try {
+    const u = new URL(ingestUrl);
+    u.pathname = u.pathname.replace(/\/ingest\/?$/, '/collector-config');
+    if (!u.pathname.endsWith('/collector-config')) return null;
+    return u.toString();
+  } catch {
+    return null;
+  }
+};
+
+/**
+ * 設定を取得する。失敗（オフライン・未設定・トークン失効）は null を返す
+ * ＝そのティックは何もしない（次のティックで取り戻す）。
+ */
+export const fetchCollectorConfig = async ({
+  ingestUrl = process.env.NIPPO_INGEST_URL,
+  ingestToken = process.env.NIPPO_INGEST_TOKEN,
+} = {}) => {
+  const url = collectorConfigUrl(ingestUrl);
+  if (!url || !ingestToken) {
+    return { ok: false, reason: 'NIPPO_INGEST_URL / NIPPO_INGEST_TOKEN が未設定' };
+  }
+  try {
+    const res = await withTimeout(
+      (signal) =>
+        fetch(url, {
+          signal,
+          headers: { Authorization: `Bearer ${ingestToken}` },
+        }),
+      10_000,
+    );
+    if (!res.ok) {
+      return { ok: false, reason: `collector-config が ${res.status} を返しました` };
+    }
+    const body = await res.json();
+    if (!body || typeof body !== 'object' || !body.schedule) {
+      return { ok: false, reason: 'collector-config の形式が不正' };
+    }
+    return { ok: true, config: body };
+  } catch (e) {
+    return { ok: false, reason: e?.message ?? '取得に失敗' };
+  }
+};