@clubs.place/cli 0.0.0-stage → 0.1.18

package/src/lemma.docHash.test.mjs

@@ -0,0 +1,37 @@
+// 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 { documentHash } from "./lemma.mjs";
+
+// ── docHash 契約テスト（clubs-nippo 収集器 ↔ clubsx ingest 検証）─────────
+// この docHash は clubsx の /api/nippo/ingest が受信ボディから再計算して照合する。
+// 両実装がバイト一致でないと ingest が 422 で全件リジェクトされ、日報がサーバに
+// 入らなくなる（無言で壊れる）。clubsx 側（src/lib/nippo/lemma.docHash.test.ts）に
+// 同じ固定フィクスチャ・同じ golden のテストを置いてあり、どちらかがずれたら
+// 各リポの test で検知できる。
+//
+// 正準形: sha256(JSON.stringify({date, aggregates, workBlocks, handoff, selfNote}))
+// ＊キー順・対象フィールドは両リポで固定。変更時は両方＋golden を同時更新する。
+const FIXTURE = {
+  activity: {
+    date: "2026-07-16",
+    aggregates: { totalCalls: 1414, failedCalls: 43, successRate: 97, activeHours: 14.2 },
+  },
+  narrative: {
+    workBlocks: [
+      { title: "案件A", text: "本文" },
+      { title: "案件B", text: "本文2" },
+    ],
+    handoff: "明日にまわすもの",
+    selfNote: "ひとこと",
+  },
+};
+const GOLDEN = "0xee3944ce3e384f69513b6d9109d7a0062a5341101aa43b6c57505da0325bdc79";
+
+test("documentHash 契約: 固定フィクスチャで golden と一致（clubsx と同値）", () => {
+  assert.equal(documentHash(FIXTURE.activity, FIXTURE.narrative), GOLDEN);
+});

package/src/lemma.mjs

@@ -0,0 +1,303 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+import { createHash } from "node:crypto";
+
+// SDK の動的インポート。無い/読めないときは null → commitDeep/proofs.submit をスキップ。
+let _sdk = null;
+try {
+  _sdk = await import("@lemmaoracle/sdk");
+} catch {
+  // ゼロ依存のままでも動く（Phase 1 互換）。proofs.submit だけが無効になる。
+}
+
+/**
+ * 日報の docHash。Phase 1 互換の SHA-256（commitDeep 非導入時）。
+ * 集計値と本文（マスク後）だけを対象にする。
+ * 生ログは入力に含めない ＝ ハッシュを再計算するのに生ログは要らない。
+ */
+export const documentHash = (activity, narrative) =>
+  `0x${createHash("sha256")
+    .update(
+      JSON.stringify({
+        date: activity.date,
+        aggregates: activity.aggregates,
+        workBlocks: narrative.workBlocks,
+        handoff: narrative.handoff,
+        selfNote: narrative.selfNote,
+      }),
+    )
+    .digest("hex")}`;
+
+const withTimeout = async (fn, ms) => {
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), ms);
+  try {
+    return await fn(ctrl.signal);
+  } finally {
+    clearTimeout(timer);
+  }
+};
+
+const reachable = async (base) => {
+  try {
+    const res = await withTimeout(
+      (signal) => fetch(`${base}/v1/health`, { signal }),
+      6000,
+    );
+    return res.ok;
+  } catch {
+    return false;
+  }
+};
+
+const SCHEMA_ID = "clubs.nippo.v1";
+const CIRCUIT_ID = "data-commitment-v1.1";
+const MAX_DEPTH = 16;
+
+/**
+ * 日報のスキーマが Lemma に登録されていなければ登録する。
+ *
+ * lemmaoracle/workers#106 で2つ変わった:
+ *   - POST /v1/schemas の normalize が任意になった（正規化器を持たない日報でも登録できる）
+ *   - POST /v1/documents は未登録スキーマを 400 で弾くようになった
+ *
+ * 後者があるので、スキーマ登録は「あると良い」ではなく「無いと落ちる」。
+ * GET は認証不要なので、まず存在を見てから、無いときだけ登録する。
+ */
+const ensureSchema = async (base, apiKey) => {
+  try {
+    const existing = await withTimeout(
+      (signal) => fetch(`${base}/v1/schemas/${SCHEMA_ID}`, { signal }),
+      8000,
+    );
+    if (existing.ok) return true;
+
+    const created = await withTimeout(
+      (signal) =>
+        fetch(`${base}/v1/schemas`, {
+          method: "POST",
+          signal,
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+          },
+          body: JSON.stringify({
+            id: SCHEMA_ID,
+            description: "CLUBS AI業務日報（実行ログの集計＋マスク済み本文のハッシュ）",
+          }),
+        }),
+      10_000,
+    );
+    return created.ok;
+  } catch {
+    return false;
+  }
+};
+
+const STUB = (docHash, reason) => ({
+  status: "pending",
+  label: "照合予定",
+  docHash,
+  reason,
+  verifyUrl: null,
+});
+
+/**
+ * 配列を depth に満たないぶん pad で埋める（pipeline.ts 同型）。
+ */
+const padToDepth = (arr, depth, pad) => {
+  const out = [...arr];
+  while (out.length < depth) out.push(pad);
+  return out;
+};
+
+/**
+ * commitDeep 用に日報データをフラットな path-value オブジェクトに変換する。
+ * 集計値は文字列化（toScalar の type tag が s: で統一されるように）。
+ */
+const buildCommitData = (activity, narrative) => ({
+  date: activity.date,
+  agentName: activity.agentName ?? "",
+  totalCalls: String(activity.aggregates?.totalCalls ?? 0),
+  failedCalls: String(activity.aggregates?.failedCalls ?? 0),
+  successRate: String(activity.aggregates?.successRate ?? 0),
+  activeHours: String(activity.aggregates?.activeHours ?? 0),
+  ...Object.fromEntries(
+    (narrative.workBlocks ?? []).flatMap((wb, i) => [
+      [`workBlock${i}title`, wb.title ?? ""],
+      [`workBlock${i}text`, wb.text ?? ""],
+    ]),
+  ),
+});
+
+/**
+ * Phase 2→3: 集計値＋本文を Poseidon Merkle コミット → docHash 登録 → key leaf を証明・提出。
+ *
+ * SDK が無い/失敗したときは Phase 1 互換（SHA-256 placeholder）に落ちる。
+ * proofs.submit の失敗は証明カウンタを回せないだけで日報の登録は阻害しない。
+ */
+export const registerProof = async (activity, narrative, config) => {
+  const { base, apiKey, verifyBase } = config.lemma;
+
+  // scope ID は送らない。Lemma 側の router が API キーから scope を解決して
+  // X-Scope-Id を自分で差し込む（router.ts の withMiddleware）。
+  if (!apiKey) {
+    return STUB(
+      documentHash(activity, narrative),
+      "LEMMA_API_KEY が未設定",
+    );
+  }
+  if (!(await reachable(base))) {
+    return STUB(
+      documentHash(activity, narrative),
+      `Lemma API に到達できません (${base})`,
+    );
+  }
+
+  // 未登録スキーマは 400 で弾かれる（#106）。先に確保しておく。
+  if (!(await ensureSchema(base, apiKey))) {
+    return STUB(
+      documentHash(activity, narrative),
+      `スキーマ ${SCHEMA_ID} を登録できませんでした`,
+    );
+  }
+
+  // ── 1. Poseidon Merkle コミット（SDK ありの場合） ──
+  let docHash;
+  let commitment;
+  let commitResult = null;
+
+  if (_sdk) {
+    try {
+      const data = buildCommitData(activity, narrative);
+      commitResult = _sdk.commitDeep(data, { maxDepth: MAX_DEPTH });
+      docHash = `0x${createHash("sha256")
+        .update(`${commitResult.root}|${activity.date}`)
+        .digest("hex")}`;
+      commitment = {
+        scheme: "poseidon",
+        root: commitResult.root,
+        leaves: commitResult.leaves,
+        randomness: commitResult.randomness,
+      };
+    } catch (e) {
+      // commitDeep 失敗 → SHA-256 placeholder にフォールバック
+      console.error("commitDeep failed:", e?.message ?? e);
+    }
+  }
+
+  if (!commitment) {
+    // SDK 無し or commitDeep 失敗 → Phase 1 互換
+    docHash = documentHash(activity, narrative);
+    commitment = { scheme: "sha256-placeholder", root: docHash };
+  }
+
+  // ── 2. documents.register ──
+  const body = {
+    docHash,
+    schema: SCHEMA_ID,
+    cid: `local:${activity.date}`,
+    issuerId: activity.agentName,
+    subjectId: config.email.to[0] ?? activity.agentName,
+    commitments: commitment,
+    revocation: { scheme: "none", root: "" },
+    attributes: {
+      date: activity.date,
+      agent: activity.agentName,
+      totalCalls: activity.aggregates.totalCalls,
+      failedCalls: activity.aggregates.failedCalls,
+      successRate: activity.aggregates.successRate,
+      activeHours: activity.aggregates.activeHours,
+    },
+  };
+
+  let docResult;
+  try {
+    const res = await withTimeout(
+      (signal) =>
+        fetch(`${base}/v1/documents`, {
+          method: "POST",
+          signal,
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+          },
+          body: JSON.stringify(body),
+        }),
+      15_000,
+    );
+
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      return STUB(docHash, `Lemma API ${res.status}: ${text.slice(0, 160)}`);
+    }
+
+    docResult = await res.json();
+  } catch (e) {
+    return STUB(docHash, `Lemma 登録に失敗: ${e.message}`);
+  }
+
+  // ── 3. proofs.submit（key leaf = failedCalls） ──
+  let verificationId = null;
+  if (_sdk && commitResult) {
+    try {
+      const client = _sdk.create({ apiBase: base, apiKey });
+
+      // failedCalls の葉を探す
+      const failedIdx = commitResult.leafPreimages.findIndex(
+        (p) => p.name === '$["failedCalls"]',
+      );
+      if (failedIdx >= 0) {
+        const pre = commitResult.leafPreimages[failedIdx];
+        const inc = commitResult.inclusionProofs[failedIdx];
+
+        const witness = {
+          root: BigInt(commitResult.root),
+          randomness: BigInt(commitResult.randomness),
+          pathHash: BigInt(pre.nameHash),
+          valueHash: BigInt(pre.valueHash),
+          siblings: padToDepth(inc.siblings, MAX_DEPTH, "0x0").map((s) =>
+            BigInt(s),
+          ),
+          indices: padToDepth(inc.indices, MAX_DEPTH, 0),
+        };
+
+        const { proof, inputs } = await _sdk.prover.prove(client, {
+          circuitId: CIRCUIT_ID,
+          witness,
+        });
+
+        const sr = await _sdk.proofs.submit(client, {
+          docHash,
+          circuitId: CIRCUIT_ID,
+          proof,
+          inputs,
+        });
+
+        verificationId = sr.verificationId;
+        console.error(
+          `proofs.submit OK: ${verificationId} (failedCalls=${pre.value})`,
+        );
+      }
+    } catch (e) {
+      // proofs.submit 失敗は非ブロッキング。日報の登録は成功している。
+      console.error("proofs.submit failed:", e?.message ?? e);
+    }
+  }
+
+  return {
+    status: "verified",
+    label: "ログ照合済み",
+    docHash,
+    txHash: docResult.onchainTxHash ?? null,
+    verifyUrl: verifyBase
+      ? `${verifyBase.replace(/\/$/, "")}/${docHash}`
+      : null,
+    verificationId,
+    commitmentScheme: commitment.scheme,
+    reason: null,
+  };
+};

package/src/mask.mjs

@@ -0,0 +1,45 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+export const REDACT_TOKEN = "[[REDACTED]]";
+
+/**
+ * MASK_PATTERNS にマッチした箇所を REDACT_TOKEN に置換する。
+ * 返り値の count は「伏せた箇所の数」で、日報の "マスク済み N箇所" 表示に使う。
+ */
+export const maskText = (text, patterns) => {
+  if (typeof text !== "string" || text.length === 0 || patterns.length === 0) {
+    return { text: text ?? "", count: 0 };
+  }
+  let out = text;
+  let count = 0;
+  for (const re of patterns) {
+    re.lastIndex = 0;
+    out = out.replace(re, () => {
+      count += 1;
+      return REDACT_TOKEN;
+    });
+  }
+  return { text: out, count };
+};
+
+/** オブジェクト/配列の文字列値を再帰的にマスクする。 */
+export const maskDeep = (value, patterns) => {
+  let count = 0;
+  const walk = (v) => {
+    if (typeof v === "string") {
+      const r = maskText(v, patterns);
+      count += r.count;
+      return r.text;
+    }
+    if (Array.isArray(v)) return v.map(walk);
+    if (v && typeof v === "object") {
+      return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, walk(x)]));
+    }
+    return v;
+  };
+  const masked = walk(value);
+  return { value: masked, count };
+};

package/src/mcp.mjs

@@ -0,0 +1,269 @@
+// clubs-nippo — AI業務日報 (CLUBS)
+// Copyright (c) 2026 FRAME00 Inc.
+// SPDX-License-Identifier: MIT
+// https://github.com/frame00/clubs-nippo
+
+/**
+ * CLUBS MCP サーバー（stdio・同一バイナリ同梱＝全体設計 §6 / P0 §9）。
+ *
+ * `clubs-nippo mcp` で起動し、Claude Code / Cursor / Gemini CLI 等の
+ * MCP クライアントから CLUBS への登録・疎通確認を対話の中で完結させる。
+ *
+ * CTO裁定（clubsx#53 D-4）に従う:
+ * - ツールは clubs_register / clubs_link_status の2本のみ。
+ *   発行系・日報の書き込み系は載せない（B-1: 自己申告の発行経路を作らない。
+ *   日報の取り込みは従来どおり収集器の pull 経路のみ）。
+ * - 出力はサーバ確定値・ローカル設定の定型フィールドのみ（自由文・他ユーザー
+ *   由来のテキストを返さない＝注入面の最小化）。
+ *
+ * 依存ゼロ方針（このリポの流儀）のため SDK は使わず、MCP の stdio
+ * トランスポート（JSON-RPC 2.0・1行1メッセージ）を最小実装する。
+ * stdout はプロトコル専用。ログは必ず stderr へ。
+ */
+
+import { createInterface } from "node:readline";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { APP_HOME, ROOT } from "./config.mjs";
+import { collectorConfigUrl } from "./remote-config.mjs";
+import { readHistory } from "./history.mjs";
+
+const PROTOCOL_FALLBACK = "2025-06-18";
+
+const pkgVersion = () => {
+  try {
+    return JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8")).version;
+  } catch {
+    return "0.0.0";
+  }
+};
+
+// ── 登録先 URL のガード（注入面対策） ─────────────────────
+// MCP 経由の register は AI の文脈から呼ばれるため、細工された取込URLで
+// トークンや日報の送り先を挿げ替えられないよう、既定で CLUBS のホストに限る。
+// 自前ホストの開発者は CLUBS_NIPPO_ALLOW_HOST=<host> で1件だけ追加できる。
+const urlAllowed = (raw) => {
+  try {
+    const u = new URL(raw);
+    const local = u.hostname === "localhost" || u.hostname === "127.0.0.1";
+    if (local) return true; // ローカル開発
+    if (u.protocol !== "https:") return false;
+    if (u.hostname === "clubs.place" || u.hostname.endsWith(".clubs.place"))
+      return true;
+    return u.hostname === process.env.CLUBS_NIPPO_ALLOW_HOST;
+  } catch {
+    return false;
+  }
+};
+
+/** init コマンドと同じ書式で .env を更新（既存キーは生かす）。 */
+const writeEnvUpdates = (updates) => {
+  mkdirSync(join(APP_HOME, "out"), { recursive: true });
+  const envPath = join(APP_HOME, ".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");
+  return envPath;
+};
+
+const withTimeout = async (fn, ms) => {
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), ms);
+  try {
+    return await fn(ctrl.signal);
+  } finally {
+    clearTimeout(timer);
+  }
+};
+
+/** 連携トークンの実在確認＝collector-config にサーバ照会する。 */
+const serverCheck = async (ingestUrl, ingestToken) => {
+  const url = collectorConfigUrl(ingestUrl);
+  if (!url || !ingestToken) return { reachable: false, token_valid: false };
+  try {
+    const res = await withTimeout(
+      (signal) =>
+        fetch(url, {
+          signal,
+          headers: { Authorization: `Bearer ${ingestToken}` },
+        }),
+      10_000,
+    );
+    return { reachable: true, token_valid: res.ok };
+  } catch {
+    return { reachable: false, token_valid: false };
+  }
+};
+
+// ── ツール定義 ────────────────────────────────────────────
+
+const TOOLS = [
+  {
+    name: "clubs_register",
+    description:
+      "この端末を CLUBS に登録する（clubs-nippo init と同じ設定を書く）。url と token は CLUBS の接続画面（/nippo/connections）が発行した値をそのまま渡すこと。登録後にサーバへ疎通確認する。",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: {
+          type: "string",
+          description: "取込URL（接続画面が発行。…/api/nippo/ingest）",
+        },
+        token: { type: "string", description: "連携トークン（接続画面が発行）" },
+        source: {
+          type: "string",
+          description: "収集元（例: claude-code / cowork。省略可）",
+        },
+        agent_name: { type: "string", description: "体の表示名（省略可）" },
+        owner_name: { type: "string", description: "オーナー名（省略可）" },
+      },
+      required: ["url", "token"],
+    },
+  },
+  {
+    name: "clubs_link_status",
+    description:
+      "CLUBS との連携状態を返す（設定の有無・サーバ疎通・トークン有効性・ローカル最終記録日）。",
+    inputSchema: { type: "object", properties: {} },
+  },
+];
+
+const callTool = async (name, args = {}) => {
+  if (name === "clubs_register") {
+    const url = String(args.url ?? "");
+    const token = String(args.token ?? "");
+    if (!url || !token) {
+      return { ok: false, error: "url と token は必須です" };
+    }
+    let parsed;
+    try {
+      parsed = new URL(url);
+    } catch {
+      return { ok: false, error: "url が不正です" };
+    }
+    if (!/\/api\/nippo\/ingest\/?$/.test(parsed.pathname)) {
+      return {
+        ok: false,
+        error: "url は接続画面が発行した取込URL（…/api/nippo/ingest）を渡してください",
+      };
+    }
+    if (!urlAllowed(url)) {
+      return {
+        ok: false,
+        error:
+          "この url のホストには登録できません（clubs.place / localhost のみ。自前ホストは CLUBS_NIPPO_ALLOW_HOST で許可）",
+      };
+    }
+    const updates = Object.fromEntries(
+      Object.entries({
+        NIPPO_INGEST_URL: url,
+        NIPPO_INGEST_TOKEN: token,
+        SOURCE: args.source,
+        AGENT_NAME: args.agent_name,
+        OWNER_NAME: args.owner_name,
+      }).filter(([, v]) => v),
+    );
+    const envPath = writeEnvUpdates(updates);
+    // 同一セッション内の link_status が新しい値を見られるように反映する
+    // （config.mjs の loadDotEnv は起動時に未設定キーしか埋めない）
+    for (const [key, value] of Object.entries(updates)) process.env[key] = value;
+    const server = await serverCheck(url, token);
+    return {
+      ok: server.token_valid,
+      wrote: Object.keys(updates),
+      env_path: envPath,
+      ingest_url_host: parsed.host,
+      server,
+      next: server.token_valid
+        ? "毎朝の自動配信は crontab に `npx -y clubs-nippo@latest tick` を登録（clubs-nippo init のヘルプ参照）"
+        : "トークンがサーバで確認できませんでした。接続画面で再発行して register し直してください",
+    };
+  }
+
+  if (name === "clubs_link_status") {
+    const ingestUrl = process.env.NIPPO_INGEST_URL ?? "";
+    const ingestToken = process.env.NIPPO_INGEST_TOKEN ?? "";
+    const configured = Boolean(ingestUrl && ingestToken);
+    const server = configured
+      ? await serverCheck(ingestUrl, ingestToken)
+      : { reachable: false, token_valid: false };
+    const history = readHistory();
+    return {
+      ok: configured && server.token_valid,
+      configured,
+      ingest_url_host: ingestUrl ? new URL(ingestUrl).host : null,
+      agent_name: process.env.AGENT_NAME ?? null,
+      server,
+      last_local_report_date: history.at(-1)?.date ?? null,
+      env_path: join(APP_HOME, ".env"),
+    };
+  }
+
+  return { ok: false, error: `unknown tool: ${name}` };
+};
+
+// ── JSON-RPC 2.0 / stdio ─────────────────────────────────
+
+const reply = (id, result) => {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n");
+};
+
+const replyError = (id, code, message) => {
+  process.stdout.write(
+    JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }) + "\n",
+  );
+};
+
+export const runMcpServer = async () => {
+  const rl = createInterface({ input: process.stdin, terminal: false });
+  console.error(
+    `[clubs-nippo mcp] stdio server ready (tools: ${TOOLS.map((t) => t.name).join(", ")})`,
+  );
+
+  for await (const line of rl) {
+    if (!line.trim()) continue;
+    let msg;
+    try {
+      msg = JSON.parse(line);
+    } catch {
+      continue; // 不正な行は無視（プロトコル外のノイズ）
+    }
+    const { id, method, params } = msg;
+
+    // 通知（id なし）は initialized 含め応答しない
+    if (id === undefined || id === null) continue;
+
+    try {
+      if (method === "initialize") {
+        reply(id, {
+          protocolVersion: params?.protocolVersion ?? PROTOCOL_FALLBACK,
+          capabilities: { tools: { listChanged: false } },
+          serverInfo: { name: "clubs-nippo", version: pkgVersion() },
+        });
+      } else if (method === "ping") {
+        reply(id, {});
+      } else if (method === "tools/list") {
+        reply(id, { tools: TOOLS });
+      } else if (method === "tools/call") {
+        const result = await callTool(params?.name, params?.arguments ?? {});
+        reply(id, {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          isError: result.ok === false,
+        });
+      } else {
+        replyError(id, -32601, `method not found: ${method}`);
+      }
+    } catch (e) {
+      replyError(id, -32603, e?.message ?? "internal error");
+    }
+  }
+};