checkGitignore function

String? checkGitignore(
  1. Directory projectRoot
)

Warns, at startup, if projectRoot's .gitignore doesn't mention .ref — these are throwaway dev-tool scratch files, not something meant to land in commits (PLAN.md §5.3). Returns null if all's well.

Implementation

String? checkGitignore(Directory projectRoot) {
  final File gitignore = File('${projectRoot.path}/.gitignore');
  if (!gitignore.existsSync()) {
    return 'No .gitignore found in ${projectRoot.path} — add ".ref/" to it so selections don\'t get committed.';
  }
  final bool mentioned = gitignore
      .readAsStringSync()
      .split('\n')
      .map((String line) => line.trim())
      .any((String line) => line == '.ref' || line == '.ref/' || line == '/.ref' || line == '/.ref/');
  if (!mentioned) {
    return '.gitignore doesn\'t mention .ref/ — add it so selections don\'t get committed.';
  }
  return null;
}