積読・動画リストのカテゴリ表記ゆれを集計前に発見｜GASでdry-run監査

const CATEGORY_AUDIT_CONFIG = Object.freeze({
  DRY_RUN: true,
  SOURCE_SHEET: 'Watchlist',
  AUDIT_SHEET: 'CategoryAudit',
  MAX_ROWS: 500,
  ALLOWED_CATEGORIES: ['BOOK', 'VIDEO', 'ARTICLE', 'COURSE'],
  ALIASES: Object.freeze({
    '本': 'BOOK',
    '書籍': 'BOOK',
    'book': 'BOOK',
    '動画': 'VIDEO',
    'video': 'VIDEO',
    '記事': 'ARTICLE',
    'article': 'ARTICLE',
    '講座': 'COURSE',
    'course': 'COURSE'
  })
});

function auditWatchlistCategoriesFree() {
  validateCategoryAuditConfig_();

  const lock = LockService.getDocumentLock();
  if (!lock.tryLock(5000)) {
    throw new Error('別の監査が実行中です。少し待ってから再実行してください。');
  }

  try {
    const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
    const source = spreadsheet.getSheetByName(
      CATEGORY_AUDIT_CONFIG.SOURCE_SHEET
    );
    if (!source) {
      throw new Error('Watchlistシートが見つかりません。');
    }

    const values = source.getDataRange().getDisplayValues();
    if (values.length < 2) {
      throw new Error('見出し行の下にテストデータを1行以上入れてください。');
    }
    if (values.length - 1 > CATEGORY_AUDIT_CONFIG.MAX_ROWS) {
      throw new Error('最初は500行以内に絞って確認してください。');
    }

    const headers = values[0].map(value => value.trim());
    const titleIndex = headers.indexOf('タイトル');
    const categoryIndex = headers.indexOf('カテゴリ');
    if (titleIndex < 0 || categoryIndex < 0) {
      throw new Error('1行目に「タイトル」と「カテゴリ」が必要です。');
    }

    const runId = Utilities.getUuid().slice(0, 8);
    const checkedAt = new Date();
    const auditRows = [];
    const counts = { OK: 0, REVIEW: 0, INPUT_HOLD: 0 };

    values.slice(1).forEach((row, offset) => {
      const sourceRow = offset + 2;
      const title = String(row[titleIndex] || '').trim();
      const rawCategory = String(row[categoryIndex] || '');

      if (!title && !rawCategory.trim()) return;
      if (!title) {
        counts.INPUT_HOLD += 1;
        auditRows.push([
          checkedAt, runId, sourceRow, 'INPUT_HOLD', '',
          'タイトルが空です'
        ]);
        return;
      }

      const normalized = normalizeCategoryKey_(rawCategory);
      if (!normalized) {
        counts.INPUT_HOLD += 1;
        auditRows.push([
          checkedAt, runId, sourceRow, 'INPUT_HOLD', '',
          'カテゴリが空です'
        ]);
        return;
      }

      const suggested = CATEGORY_AUDIT_CONFIG.ALIASES[normalized] || '';
      if (!suggested) {
        counts.REVIEW += 1;
        auditRows.push([
          checkedAt, runId, sourceRow, 'REVIEW', '',
          '対応表にないカテゴリです'
        ]);
        return;
      }

      const alreadyCanonical = rawCategory.trim() === suggested;
      const status = alreadyCanonical ? 'OK' : 'REVIEW';
      counts[status] += 1;
      auditRows.push([
        checkedAt, runId, sourceRow, status, suggested,
        alreadyCanonical ? '変更候補なし' : '表記候補を確認してください'
      ]);
    });

    if (!auditRows.length) {
      throw new Error('確認対象の行がありません。');
    }

    const auditSheet = spreadsheet.getSheetByName(
      CATEGORY_AUDIT_CONFIG.AUDIT_SHEET
    ) || spreadsheet.insertSheet(CATEGORY_AUDIT_CONFIG.AUDIT_SHEET);

    if (auditSheet.getLastRow() === 0) {
      auditSheet.appendRow([
        '実行日時', 'run_id', '元の行', '判定', 'カテゴリ候補', '確認メモ'
      ]);
    }
    auditSheet.getRange(
      auditSheet.getLastRow() + 1,
      1,
      auditRows.length,
      auditRows[0].length
    ).setValues(auditRows);

    console.log(JSON.stringify({
      dryRun: CATEGORY_AUDIT_CONFIG.DRY_RUN,
      checkedRows: values.length - 1,
      auditRows: auditRows.length,
      counts,
      sourceUpdated: false
    }));
  } finally {
    lock.releaseLock();
  }
}

function normalizeCategoryKey_(value) {
  return String(value || '')
    .normalize('NFKC')
    .trim()
    .replace(/\s+/g, ' ')
    .toLowerCase();
}

function validateCategoryAuditConfig_() {
  if (CATEGORY_AUDIT_CONFIG.DRY_RUN !== true) {
    throw new Error('安全のためDRY_RUNはtrue固定です。');
  }
  if (!Number.isInteger(CATEGORY_AUDIT_CONFIG.MAX_ROWS) ||
      CATEGORY_AUDIT_CONFIG.MAX_ROWS < 1 ||
      CATEGORY_AUDIT_CONFIG.MAX_ROWS > 500) {
    throw new Error('MAX_ROWSは1〜500で指定してください。');
  }

  const allowed = new Set(CATEGORY_AUDIT_CONFIG.ALLOWED_CATEGORIES);
  Object.values(CATEGORY_AUDIT_CONFIG.ALIASES).forEach(category => {
    if (!allowed.has(category)) {
      throw new Error('ALIASESに許可外のカテゴリがあります: ' + category);
    }
  });
}