Function hasGeneratedHeader

src/extraction/generated-detection.ts:207–245

(content: string)

 * per query: the verdict is persisted on the file record.
 */
export function hasGeneratedHeader(content: string): boolean {
  if (!content) return false;

  const head = content.length > HEADER_SCAN_CHARS ? content.slice(0, HEADER_SCAN_CHARS) : content;
  // Fast reject for ~every hand-written file: no line splitting, no allocation
  // (V8 keeps `head` as a sliced view of `content`).
  if (!GENERATED_STEM.test(head)) return false;

  const lines = head.split('\n');
  const limit = Math.min(lines.length, HEADER_SCAN_LINES);
  let openBlock: (typeof BLOCK_DELIMS)[number] | null = null;

  for (let i = 0; i < limit; i++) {
    const line = lines[i]!;
    const inBlock = openBlock !== null;

    if (inBlock || COMMENT_LEADER.test(line)) {
      for (const pattern of GENERATED_CONTENT_PATTERNS) {
        if (pattern.test(line)) return true;
      }
    }

    // Advance the block-comment state AFTER testing, so the opening line of a
    // `/* Code generated … */` block is itself matched by the leader rule.
    if (openBlock) {
      if (line.includes(openBlock.close)) openBlock = null;
      continue;
    }
    for (const delim of BLOCK_DELIMS) {
      const at = line.indexOf(delim.open);
      if (at < 0) continue;
      // Same-line close (`/* … */`, a one-line docstring) leaves no open block.
      if (line.indexOf(delim.close, at + delim.open.length) < 0) openBlock = delim;
      break;
    }
  }

  return false;
}

/**
 * The union signal: path convention OR content banner. This is what the