Function lintFile

scripts/lint-error-codes.cjs:81–111

(filePath, { canonical, aliases })

}

function lintFile(filePath, { canonical, aliases }) {
  const violations = [];
  let doc;
  try {
    doc = yaml.load(fs.readFileSync(filePath, 'utf8'));
  } catch (err) {
    return [{ filePath, trail: [], code: null, reason: `skipped (YAML parse failed: ${err.message}) — fix via upstream YAML lint`, severity: 'warn' }];
  }
  if (!doc) return violations;
  for (const hit of findErrorCodeAssertions(doc, [])) {
    if (canonical.has(hit.code)) continue;
    if (aliases.has(hit.code)) {
      violations.push({
        filePath,
        trail: hit.trail,
        code: hit.code,
        reason: `deprecated alias — remove or migrate before the alias sunsets`,
        severity: 'warn',
      });
      continue;
    }
    violations.push({
      filePath,
      trail: hit.trail,
      code: hit.code,
      reason: `not in canonical error-code enum (static/schemas/source/enums/error-code.json)`,
      severity: 'error',
    });
  }
  return violations;
}

function formatTrail(trail) {
  return trail.map(seg => (typeof seg === 'number' ? `[${seg}]` : `.${seg}`)).join('').replace(/^\./, '');