@genn-inc/cluebase-cli 0.0.1

package/src/setup-doctor-quality-checks-b.mjs

@@ -0,0 +1,638 @@
+// Data-quality checks (second half).
+// Extracted from setup-doctor-quality for file-size limits; content is unchanged.
+
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import {
+  COMMON_ENV_KEY_TYPOS,
+  PLACEHOLDER_ENV_VALUES,
+  REQUIRED_PROJECT_KEY_ENV_NAMES,
+  SENSITIVE_FIELD_PATTERNS,
+  TEST_DIR_PATTERNS,
+  VALID_SDK_PACKAGES,
+  VENDORED_DIR_PATTERNS,
+  WRONG_SDK_PACKAGE_PATTERNS,
+  allInsertionSitesOf,
+  buildCheck,
+  buildErrorMessage,
+  errorPass,
+  identifySitesOf,
+  initSitesOf,
+  isPlainObject,
+  isString,
+  matchesAny,
+  readSiteFile,
+  resetSitesOf,
+  warnPass,
+} from "./setup-doctor-quality-shared.mjs";
+
+export const checkC6 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C6";
+  const sites = identifySitesOf(discoveries);
+  if (sites.length === 0) return errorPass(id);
+  const missing = [];
+  for (const site of sites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null || !/cluebase\.identify\s*\(/.test(content)) {
+      missing.push({ file: site.file, line: site.line });
+    }
+  }
+  if (missing.length === 0) return errorPass(id);
+  const first = missing[0];
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `discoveries.json の identify_sites のうち ${missing.length} 件に cluebase.identify 挿入なし`,
+      location: `${first.file}:${first.line}`,
+      impact:
+        "認識すべきユーザー login flow の一部が漏れ、 そのルート経由の顧客が分析対象から欠落します。",
+      actions: [
+        "/cluebase-implement を再実行して全 site に挿入を完了させてください",
+        "manual で挿入する場合は全 identify_sites を確認してください",
+      ],
+    }),
+    details: { missing },
+  });
+};
+
+// C7: reset_sites と identify_sites の挿入件数が大きく mismatch
+export const checkC7 = (discoveries) => {
+  const id = "C7";
+  const identifyCount = identifySitesOf(discoveries).length;
+  const resetCount = resetSitesOf(discoveries).length;
+  if (identifyCount === 0 && resetCount === 0) return warnPass(id);
+  const diff = Math.abs(identifyCount - resetCount);
+  // identify がある場合は logout も同程度あるべき。 0 でも ratio 50% 以上の diff は warn。
+  const threshold = Math.max(1, Math.floor(Math.max(identifyCount, resetCount) / 2));
+  if (diff <= threshold) return warnPass(id);
+  return buildCheck({
+    id,
+    severity: "warn",
+    passed: false,
+    message: `WARN: identify_sites (${identifyCount}) と reset_sites (${resetCount}) の件数が大きく mismatch しています。 login と logout を対称に挿入すべきです。`,
+    details: { identifyCount, resetCount, diff, threshold },
+  });
+};
+
+// C18: 挿入 site 0 件 (= identify_sites あるのに 1 件も挿入されていない)
+export const checkC18 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C18";
+  const sites = identifySitesOf(discoveries);
+  if (sites.length === 0) return errorPass(id);
+  let insertedCount = 0;
+  for (const site of sites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content !== null && /cluebase\.identify\s*\(/.test(content)) {
+      insertedCount += 1;
+    }
+  }
+  if (insertedCount > 0) return errorPass(id);
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `discoveries.json に identify_sites が ${sites.length} 件あるのに、 cluebase.identify 挿入が 1 件も検出できません`,
+      location: "(複数 file)",
+      impact:
+        "全ての login flow に挿入が漏れているため、 顧客識別が一切できません。 setup は実質失敗しています。",
+      actions: [
+        "/cluebase-implement を実行して挿入を完了させてください",
+        "挿入後 /cluebase-doctor を re-run してください",
+      ],
+    }),
+    details: { totalSites: sites.length, insertedCount },
+  });
+};
+
+// C19: 挿入 file が test/ / __tests__/ / spec/ 配下
+export const checkC19 = (discoveries) => {
+  const id = "C19";
+  const sites = allInsertionSitesOf(discoveries);
+  const offenders = sites.filter(
+    (site) => isString(site?.file) && matchesAny(site.file, TEST_DIR_PATTERNS),
+  );
+  if (offenders.length === 0) return errorPass(id);
+  const first = offenders[0];
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `挿入 site が test 配下: ${first.file}`,
+      location: `${first.file}:${first.line ?? "?"}`,
+      impact:
+        "test ファイルに挿入された SDK 呼び出しは本番経路に届きません。 顧客イベントが収集されません。",
+      actions: [
+        "test 配下の site を discoveries.json から除外してください",
+        "本番経路 (= production code) の boundary に挿入し直してください",
+      ],
+    }),
+    details: { offenders: offenders.map((s) => ({ file: s.file, line: s.line })) },
+  });
+};
+
+// C20: 挿入 file が node_modules / vendored / .next / dist 配下
+export const checkC20 = (discoveries) => {
+  const id = "C20";
+  const sites = allInsertionSitesOf(discoveries);
+  const offenders = sites.filter(
+    (site) => isString(site?.file) && matchesAny(site.file, VENDORED_DIR_PATTERNS),
+  );
+  if (offenders.length === 0) return errorPass(id);
+  const first = offenders[0];
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `挿入 site が vendored / build 配下: ${first.file}`,
+      location: `${first.file}:${first.line ?? "?"}`,
+      impact:
+        "node_modules / .next / dist / build 配下は build 成果物のため、 次回 install / build で上書き消失します。 本番経路には届きません。",
+      actions: [
+        "source code 配下 (= src / app / lib 等) の boundary に挿入し直してください",
+        "/cluebase-discover を再実行して正しい boundary を探索してください",
+      ],
+    }),
+    details: { offenders: offenders.map((s) => ({ file: s.file, line: s.line })) },
+  });
+};
+
+// ============================================================
+// env file 関連
+// ============================================================
+
+// C25: env file に project key が書かれていない
+export const checkC25 = ({ envFiles }) => {
+  const id = "C25";
+  if (!isPlainObject(envFiles) || Object.keys(envFiles).length === 0) {
+    return errorPass(id); // env file 未提供時は skip
+  }
+  const found = [];
+  for (const [path, content] of Object.entries(envFiles)) {
+    if (typeof content !== "string") continue;
+    for (const envName of REQUIRED_PROJECT_KEY_ENV_NAMES) {
+      const pattern = new RegExp(`^\\s*${envName}\\s*=`, "m");
+      if (pattern.test(content)) {
+        found.push({ path, envName });
+        break;
+      }
+    }
+  }
+  if (found.length > 0) return errorPass(id);
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `どの env file にも ${REQUIRED_PROJECT_KEY_ENV_NAMES.join(" / ")} が書かれていません`,
+      location: Object.keys(envFiles).join(", "),
+      impact:
+        "起動時に projectKey が undefined となり、 全イベントが送信失敗します。",
+      actions: [
+        "server runtime では CLUEBASE_PROJECT_KEY=pk_dev_xxx を追加してください",
+        "frontend SDK では framework に合う public env 名を使ってください",
+      ],
+    }),
+    details: { searchedFiles: Object.keys(envFiles), expected: [...REQUIRED_PROJECT_KEY_ENV_NAMES] },
+  });
+};
+
+// C26: env var key の typo
+export const checkC26 = ({ envFiles }) => {
+  const id = "C26";
+  if (!isPlainObject(envFiles) || Object.keys(envFiles).length === 0) {
+    return errorPass(id);
+  }
+  const offenders = [];
+  for (const [path, content] of Object.entries(envFiles)) {
+    if (typeof content !== "string") continue;
+    for (const [typo, correct] of Object.entries(COMMON_ENV_KEY_TYPOS)) {
+      const pattern = new RegExp(`^\\s*${typo}\\s*=`, "m");
+      if (pattern.test(content)) {
+        offenders.push({ path, typo, correct });
+      }
+    }
+  }
+  if (offenders.length === 0) return errorPass(id);
+  const first = offenders[0];
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `env var key に typo: ${first.typo} (正しくは ${first.correct})`,
+      location: first.path,
+      impact:
+        "typo した env var は読み込まれず、 SDK 初期化が undefined で失敗します。",
+      actions: [`${first.typo} を ${first.correct} に修正してください`],
+    }),
+    details: { offenders },
+  });
+};
+
+// C27: env var の value が placeholder
+export const checkC27 = ({ envFiles }) => {
+  const id = "C27";
+  if (!isPlainObject(envFiles) || Object.keys(envFiles).length === 0) {
+    return errorPass(id);
+  }
+  const offenders = [];
+  for (const [path, content] of Object.entries(envFiles)) {
+    if (typeof content !== "string") continue;
+    const lines = content.split(/\r?\n/);
+    for (const line of lines) {
+      const match = line.match(/^\s*((?:[A-Z_][A-Z0-9_]*_)?CLUEBASE_[A-Z_]+)\s*=\s*(.*)$/);
+      if (!match) continue;
+      const [, key, rawValue] = match;
+      const value = rawValue.trim().replace(/^["']|["']$/g, "");
+      if (PLACEHOLDER_ENV_VALUES.includes(value.toLowerCase().trim())) {
+        offenders.push({ path, key, value });
+      }
+    }
+  }
+  if (offenders.length === 0) return errorPass(id);
+  const first = offenders[0];
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `env var に placeholder value: ${first.key}=${first.value || "(空)"}`,
+      location: first.path,
+      impact:
+        "placeholder のままだと SDK 認証が失敗し、 イベントが 1 件も送信されません。",
+      actions: [
+        `dashboard から実際の ${first.key} を取得して書き込んでください`,
+        "cluebase.ai dashboard → Project Settings → Keys",
+      ],
+    }),
+    details: { offenders },
+  });
+};
+
+// ============================================================
+// SDK load 関連
+// ============================================================
+
+// C5: SDK package が installed (= package.json 記載 + import が解決できる)
+
+// 知りたいのは「顧客の repo から import が解決できるか」。file が読めるかは別の
+// 問いで、代用すると 2 通りに外れる。(1) pnpm は node_modules を symlink で組む
+// ので、正しく install されていても file としては辿れない。(2) 逆に file が在って
+// も exports の指定次第で import は解決できない。解決器が正本なので、問いをその
+// まま Node へ聞く。
+const isSdkResolvableFrom = (repoRoot, specifier) => {
+  const requireFromRepo = createRequire(resolve(repoRoot, "package.json"));
+  try {
+    requireFromRepo.resolve(specifier);
+    return true;
+  } catch (error) {
+    // 「入っていない」と言えるのは package 自体が見つからなかった時だけ。
+    // ERR_PACKAGE_PATH_NOT_EXPORTED は package を見つけた後に exports を見て
+    // 断る error なので、install はされている。
+    return error?.code !== "MODULE_NOT_FOUND";
+  }
+};
+
+export const checkC5 = async ({ packageJson, repoRoot }) => {
+  const id = "C5";
+  if (!isPlainObject(packageJson)) {
+    return errorPass(id); // package.json 未提供時は skip
+  }
+  const allDeps = {
+    ...(packageJson.dependencies ?? {}),
+    ...(packageJson.devDependencies ?? {}),
+  };
+  const installedSdks = VALID_SDK_PACKAGES.filter((pkg) => allDeps[pkg]);
+  if (installedSdks.length === 0) {
+    return buildCheck({
+      id,
+      severity: "error",
+      passed: false,
+      message: buildErrorMessage({
+        detected: `package.json に Cluebase SDK package が記載されていません (${VALID_SDK_PACKAGES.join(" / ")} のいずれも見つからない)`,
+        location: "package.json",
+        impact:
+          "SDK 未 install のため、 import が失敗します。 setup 全体が起動しません。",
+        actions: [
+          "frontend なら: pnpm add @genn-inc/cluebase-frontend-sdk",
+          "backend (Node) なら: pnpm add @genn-inc/cluebase-backend-sdk",
+          "backend (Python) なら: pip install cluebase-backend-sdk",
+        ],
+      }),
+      details: { availableDeps: Object.keys(allDeps).slice(0, 20) },
+    });
+  }
+  // install 済み check (= node-only SDK)
+  const missingInstalled = installedSdks.filter(
+    (sdk) =>
+      !sdk.startsWith("cluebase-backend-sdk") && // python は node の解決対象外
+      !isSdkResolvableFrom(repoRoot, sdk),
+  );
+  if (missingInstalled.length > 0) {
+    return buildCheck({
+      id,
+      severity: "error",
+      passed: false,
+      message: buildErrorMessage({
+        detected: `package.json に Cluebase SDK が記載されているが、 node_modules に install されていない: ${missingInstalled.join(", ")}`,
+        location: "node_modules/",
+        impact: "import 解決時に MODULE_NOT_FOUND で起動失敗します。",
+        actions: ["pnpm install (または npm install / yarn install) を実行してください"],
+      }),
+      details: { missingInstalled },
+    });
+  }
+  return errorPass(id);
+};
+
+// C28: import statement が間違った package を指す
+export const checkC28 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C28";
+  const sites = allInsertionSitesOf(discoveries);
+  if (sites.length === 0) return errorPass(id);
+  const offenders = [];
+  for (const site of sites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    // import / require 文に間違った SDK package が現れていないか
+    const importLines = content.match(
+      /(?:import\s+[^"'`]+from\s+["'`][^"'`]+["'`])|(?:require\s*\(\s*["'`][^"'`]+["'`]\s*\))/g,
+    );
+    if (!importLines) continue;
+    for (const line of importLines) {
+      // cluebase 関連の import のみを対象に絞る (= 顧客 own code は除外)
+      if (!/cluebase/i.test(line)) continue;
+      for (const pattern of WRONG_SDK_PACKAGE_PATTERNS) {
+        if (pattern.test(line)) {
+          offenders.push({ file: site.file, statement: line.trim() });
+        }
+      }
+    }
+  }
+  if (offenders.length === 0) return errorPass(id);
+  const first = offenders[0];
+  return buildCheck({
+    id,
+    severity: "error",
+    passed: false,
+    message: buildErrorMessage({
+      detected: `cluebase 関連 import 文が間違った package を指している: ${first.statement}`,
+      location: first.file,
+      impact:
+        "@genn-inc/cluebase-cli は CLI 専用 package で、 SDK としては機能しません。 runtime で `cluebase.identify is not a function` 等の error が出ます。",
+      actions: [
+        "frontend では @genn-inc/cluebase-frontend-sdk を import してください",
+        "backend (Node) では @genn-inc/cluebase-backend-sdk を import してください",
+      ],
+    }),
+    details: { offenders },
+  });
+};
+
+// ============================================================
+// consent / privacy 関連
+// ============================================================
+
+// C8: setConsent 挿入時、 banner UI と接続されている
+export const checkC8 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C8";
+  const allSites = allInsertionSitesOf(discoveries);
+  let foundSetConsent = false;
+  let hasBannerHookup = false;
+  for (const site of allSites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    if (/cluebase\.setConsent\s*\(/.test(content)) {
+      foundSetConsent = true;
+      // banner UI と接続されているか (= onClick handler / event listener / form submit)
+      if (
+        /(?:onClick|on:click|addEventListener|onChange|onSubmit|form\s+on)/i.test(
+          content,
+        )
+      ) {
+        hasBannerHookup = true;
+      }
+    }
+  }
+  if (!foundSetConsent) return warnPass(id);
+  if (hasBannerHookup) return warnPass(id);
+  return buildCheck({
+    id,
+    severity: "warn",
+    passed: false,
+    message:
+      "WARN: setConsent が挿入されているが、 banner UI の handler 内に置かれていない可能性があります。 顧客同意 UI と SDK consent state が連動していないと、 GDPR / CCPA compliance が崩れます。",
+    details: {},
+  });
+};
+
+// C21: privacy.deniedKeys 未設定で password / token 等の field 名を含む event 発火可能性
+export const checkC21 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C21";
+  const initSites = initSitesOf(discoveries);
+  if (initSites.length === 0) return warnPass(id);
+  let hasDeniedKeys = false;
+  let hasSensitiveTrack = false;
+  const allSites = allInsertionSitesOf(discoveries);
+  const candidateFiles = new Set();
+  for (const site of [...initSites, ...allSites]) {
+    if (isString(site?.file)) candidateFiles.add(site.file);
+  }
+  for (const file of candidateFiles) {
+    const content = await readSiteFile({ repoRoot, file, signal, sourceFiles });
+    if (content === null) continue;
+    if (/privacy\s*:\s*\{[^}]*deniedKeys/.test(content)) hasDeniedKeys = true;
+    if (/cluebase\.track\s*\(/.test(content)) {
+      const trackMatches = content.matchAll(/cluebase\.track\s*\(([^)]+)\)/g);
+      for (const match of trackMatches) {
+        if (matchesAny(match[1], SENSITIVE_FIELD_PATTERNS)) {
+          hasSensitiveTrack = true;
+        }
+      }
+    }
+  }
+  if (hasDeniedKeys || !hasSensitiveTrack) return warnPass(id);
+  return buildCheck({
+    id,
+    severity: "warn",
+    passed: false,
+    message:
+      "WARN: track 呼び出しに password / token / secret 等の field 名が含まれているのに、 init で privacy.deniedKeys が未設定です。 機密情報が誤って収集される可能性があります。",
+    details: {},
+  });
+};
+
+// C22: setConsent 挿入したのに init で autocapture=true 設定なし (= 矛盾)
+export const checkC22 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C22";
+  const allSites = allInsertionSitesOf(discoveries);
+  const initSites = initSitesOf(discoveries);
+  let hasSetConsent = false;
+  let hasExplicitAutocaptureTrue = false;
+  let hasAutocaptureFalse = false;
+  for (const site of allSites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    if (/cluebase\.setConsent\s*\(/.test(content)) hasSetConsent = true;
+  }
+  for (const site of initSites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    if (/autocapture\s*:\s*true/.test(content)) hasExplicitAutocaptureTrue = true;
+    if (/autocapture\s*:\s*false/.test(content)) hasAutocaptureFalse = true;
+  }
+  if (!hasSetConsent) return warnPass(id);
+  if (hasExplicitAutocaptureTrue && !hasAutocaptureFalse) return warnPass(id);
+  if (hasAutocaptureFalse) {
+    return buildCheck({
+      id,
+      severity: "warn",
+      passed: false,
+      message:
+        "WARN: setConsent を挿入しているのに init で autocapture: false が指定されています。 同意 UI を出したのに自動収集を止めるのは矛盾です。 顧客 UX を確認してください。",
+      details: {},
+    });
+  }
+  return warnPass(id);
+};
+
+// ============================================================
+// autocapture 関連
+// ============================================================
+
+// C23: autocapture: false 設定
+export const checkC23 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C23";
+  const initSites = initSitesOf(discoveries);
+  if (initSites.length === 0) return warnPass(id);
+  const offenders = [];
+  for (const site of initSites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    if (/autocapture\s*:\s*false/.test(content)) {
+      offenders.push({ file: site.file });
+    }
+  }
+  if (offenders.length === 0) return warnPass(id);
+  return buildCheck({
+    id,
+    severity: "warn",
+    passed: false,
+    message: `WARN: cluebase.init に autocapture: false が設定されています (${offenders.length} 箇所)。 自動収集を無効化すると、 page view / click / form 送信等の大半の signal が取れません。 意図的でない場合は true (= default) に戻してください。`,
+    details: { offenders },
+  });
+};
+
+// C24: captureErrors: false 設定
+export const checkC24 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C24";
+  const initSites = initSitesOf(discoveries);
+  if (initSites.length === 0) return warnPass(id);
+  const offenders = [];
+  for (const site of initSites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    if (/captureErrors\s*:\s*false/.test(content)) {
+      offenders.push({ file: site.file });
+    }
+  }
+  if (offenders.length === 0) return warnPass(id);
+  return buildCheck({
+    id,
+    severity: "warn",
+    passed: false,
+    message: `WARN: cluebase.init に captureErrors: false が設定されています (${offenders.length} 箇所)。 error の自動収集が止まり、 障害検知が遅れます。 意図的でない場合は true (= default) に戻してください。`,
+    details: { offenders },
+  });
+};
+
+// ============================================================
+// multi-call (= 重複) 関連
+// ============================================================
+
+// C29: 同じ login flow で identify が複数回呼ばれている
+export const checkC29 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C29";
+  const sites = identifySitesOf(discoveries);
+  if (sites.length === 0) return warnPass(id);
+  const offenders = [];
+  for (const site of sites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    const count = (content.match(/cluebase\.identify\s*\(/g) ?? []).length;
+    if (count > 1) {
+      offenders.push({ file: site.file, count });
+    }
+  }
+  if (offenders.length === 0) return warnPass(id);
+  return buildCheck({
+    id,
+    severity: "warn",
+    passed: false,
+    message: `WARN: 同 file 内で cluebase.identify が複数回呼ばれています (${offenders.length} file)。 同じ login flow で 2 回以上 identify を呼ぶと、 顧客状態が上書きされ snapshot が不安定になります。`,
+    details: { offenders },
+  });
+};
+
+// Event-name patterns already covered by autocapture (click / page view / form
+// submit / input change / button click). A cluebase.track for any of these is a
+// duplicate of an autocaptured signal. Exported so the business-event catalogue
+// (setup-step-builders-events.mjs) can be machine-checked to never overlap —
+// business value milestones must not collide with autocapture-covered names.
+export const AUTOCAPTURE_COVERED_PATTERNS = [
+  /click/i,
+  /page[_-]?view/i,
+  /pageview/i,
+  /form[_-]?submit/i,
+  /input[_-]?change/i,
+  /button[_-]?click/i,
+];
+
+// C30: autocapture でカバー済みの event を track で重複送信
+export const checkC30 = async ({ discoveries, repoRoot, signal, sourceFiles = null }) => {
+  const id = "C30";
+  const allSites = allInsertionSitesOf(discoveries);
+  if (allSites.length === 0) return warnPass(id);
+  const autocaptureCovered = AUTOCAPTURE_COVERED_PATTERNS;
+  const offenders = [];
+  for (const site of allSites) {
+    if (!site?.file) continue;
+    const content = await readSiteFile({ repoRoot, file: site.file, signal, sourceFiles });
+    if (content === null) continue;
+    const trackMatches = content.matchAll(
+      /cluebase\.track\s*\(\s*["'`]([^"'`]+)["'`]/g,
+    );
+    for (const match of trackMatches) {
+      const eventName = match[1];
+      if (matchesAny(eventName, autocaptureCovered)) {
+        offenders.push({ file: site.file, eventName });
+      }
+    }
+  }
+  if (offenders.length === 0) return warnPass(id);
+  return buildCheck({
+    id,
+    severity: "warn",
+    passed: false,
+    message: `WARN: autocapture が拾う event 名 (例: ${offenders[0].eventName}) を cluebase.track で手動送信しているのを検出 (${offenders.length} 件)。 同じ event が二重送信され、 集計が膨らみます。`,
+    details: { offenders: offenders.slice(0, 5) },
+  });
+};
+
+// ============================================================
+// ヘルパー関数 (= discoveries.json 構造アクセス)
+// ============================================================