最低サポート iOS をいつ上げるか — 利用率ではなく、コードに残った分岐の数で決める

#!/usr/bin/env node
// scripts/os-sweep.mjs
// OS 分岐の棚卸し。最低サポート OS を引き上げたときに
// 「消せる分岐が何箇所あるか」を数えて、判断材料にします。
import { readFileSync } from 'node:fs';
import { readdir } from 'node:fs/promises';
import { join, extname, relative } from 'node:path';
 
const ROOT = process.argv[2] ?? 'src';
const MATRIX = process.argv[3] ?? 'src/config/supportMatrix.ts';
const EXT = new Set(['.ts', '.tsx', '.js', '.jsx']);
const SKIP = new Set(['node_modules', '.git', 'ios', 'android', 'dist', '.expo']);
const TAG = /@drop-when\s+ios>=\s*([0-9]+(?:\.[0-9]+){0,2})(?:\s*--\s*(.*))?/;
const CALL = /atLeastIOS\(\s*['"]([0-9]+(?:\.[0-9]+){0,2})['"]\s*\)/;
 
/** "16.4" を 160400 のような比較可能な整数へ。壊れた入力は null。 */
function toNum(v) {
  const parts = String(v).split('.').map((n) => Number.parseInt(n, 10));
  if (parts.some((n) => !Number.isInteger(n) || n < 0)) return null;
  const [a = 0, b = 0, c = 0] = parts;
  return a * 10000 + b * 100 + c;
}
 
function readMinIOS(path) {
  let src;
  try {
    src = readFileSync(path, 'utf8');
  } catch (e) {
    throw new Error(`最低OS定義が読めません: ${path} (${e.code ?? e.message})`);
  }
  const m = src.match(/ios\s*:\s*['"]([0-9][0-9.]*)['"]/);
  if (!m) throw new Error(`${path} に ios: "x.y" の定義が見つかりません`);
  const n = toNum(m[1]);
  if (n === null) throw new Error(`${path} の ios 値が不正です: ${m[1]}`);
  return { raw: m[1], num: n };
}
 
async function* walk(dir) {
  let entries;
  try {
    entries = await readdir(dir, { withFileTypes: true });
  } catch (e) {
    if (e.code === 'ENOENT') return;
    throw e;
  }
  for (const e of entries) {
    if (e.name.startsWith('.')) continue;
    const p = join(dir, e.name);
    if (e.isDirectory()) {
      if (SKIP.has(e.name)) continue;
      yield* walk(p);
    } else if (EXT.has(extname(e.name))) {
      yield p;
    }
  }
}
 
let min;
try {
  min = readMinIOS(MATRIX);
} catch (e) {
  console.error(`os-sweep: ${e.message}`);
  process.exit(2);
}
 
const tagged = [];   // 注記あり・下限より上
const untagged = []; // 注記のない OS 分岐
const stale = [];    // 下限を下回っていて今すぐ消せるもの
 
for await (const file of walk(ROOT)) {
  const lines = readFileSync(file, 'utf8').split('\n');
  const annotated = new Set();
  lines.forEach((line, i) => {
    const t = line.match(TAG);
    if (t) {
      const num = toNum(t[1]);
      if (num === null) {
        console.error(`  ! 不正なバージョン表記: ${relative('.', file)}:${i + 1} -> ${t[1]}`);
        return;
      }
      const rec = {
        file: relative('.', file), line: i + 1,
        version: t[1], num, reason: (t[2] ?? '').trim(),
      };
      // 注記の直後3行までを「この注記が守っている分岐」とみなす
      for (let k = i; k < Math.min(i + 4, lines.length); k++) annotated.add(k);
      (num <= min.num ? stale : tagged).push(rec);
    }
    if (CALL.test(line) && !annotated.has(i)) {
      untagged.push({ file: relative('.', file), line: i + 1, version: line.match(CALL)[1] });
    }
  });
}
 
const byVersion = new Map();
for (const t of tagged) byVersion.set(t.version, (byVersion.get(t.version) ?? 0) + 1);
const sorted = [...byVersion.entries()].sort((a, b) => toNum(a[0]) - toNum(b[0]));
 
console.log(`現在の最低サポート iOS: ${min.raw}`);
console.log(`注記つきの OS 分岐: ${tagged.length} 箇所 / 注記なし: ${untagged.length} 箇所`);
console.log('');
console.log('引き上げ先ごとに消せる分岐の数（累計）:');
let acc = 0;
for (const [v, n] of sorted) {
  acc += n;
  console.log(`  iOS ${v.padEnd(6)} まで上げる -> ${String(acc).padStart(3)} 箇所が消せる`);
}
if (stale.length) {
  console.log('');
  console.log(`⚠ すでに下限（${min.raw}）を下回っていて、今すぐ消せる分岐が ${stale.length} 箇所あります:`);
  for (const s of stale) console.log(`  ${s.file}:${s.line}  ios>=${s.version}  ${s.reason}`);
}
if (untagged.length) {
  console.log('');
  console.log(`⚠ 注記のない OS 分岐が ${untagged.length} 箇所あります（棚卸しの対象外です）:`);
  for (const u of untagged) console.log(`  ${u.file}:${u.line}  atLeastIOS('${u.version}')`);
}
process.exitCode = stale.length > 0 ? 1 : 0;

$ node scripts/os-sweep.mjs src src/config/supportMatrix.ts
現在の最低サポート iOS: 16.0
注記つきの OS 分岐: 3 箇所 / 注記なし: 1 箇所
 
引き上げ先ごとに消せる分岐の数（累計）:
  iOS 16.4   まで上げる ->   1 箇所が消せる
  iOS 17.0   まで上げる ->   2 箇所が消せる
  iOS 18.0   まで上げる ->   3 箇所が消せる
 
⚠ すでに下限（16.0）を下回っていて、今すぐ消せる分岐が 1 箇所あります:
  src/screens/Settings.tsx:2  ios>=15.0  すでに下限を超えている（消し忘れ）
 
⚠ 注記のない OS 分岐が 1 箇所あります（棚卸しの対象外です）:
  src/lib/os.ts:3  atLeastIOS('17.2')

# .github/workflows/quality.yml（該当部分のみ）
      - name: OS 分岐の棚卸し
        run: node scripts/os-sweep.mjs src src/config/supportMatrix.ts

// app.config.ts
import { MIN_OS } from './src/config/supportMatrix';
 
export default {
  expo: {
    // ...
    plugins: [
      [
        'expo-build-properties',
        {
          ios: { deploymentTarget: MIN_OS.ios },
        },
      ],
    ],
  },
};

// eslint.config.js（該当ルールのみ）
{
  rules: {
    'no-restricted-syntax': [
      'error',
      {
        selector: "MemberExpression[object.name='Platform'][property.name='Version']",
        message: "Platform.Version は直接読まず、src/lib/os.ts の atLeastIOS を使ってください",
      },
    ],
  },
}