Add check for org level community health files

Author: BekahHW

README.md

@@ -123,26 +123,37 @@ node dist/index.js create --token your_github_token --name my-awesome-project --
 
 ## What Gets Evaluated
 
-The CLI evaluates repositories based on these criteria:
+The CLI evaluates repositories based on these criteria. When community health files are missing from a repository, the tool automatically checks the organization's `.github` repository for default community health files:
 
 ### Essential Elements (High Weight)
 - **README File** (20 points): Comprehensive documentation
 - **Contributing Guidelines** (15 points): Clear contribution instructions
 - **Open Source License** (15 points): Valid open source license
 
 ### Community Building (Medium Weight)  
-- **Code of Conduct** (12 points): Welcoming environment guidelines
+- **Code of Conduct** (12 points): Welcoming environment guidelines (checks repository and organization's `.github` repo)
 - **Description** (10 points): Clear project description
 - **Good First Issues** (10 points): Issues labeled for beginners
 
 ### Discoverability & Organization (Lower Weight)
 - **Topics/Tags** (8 points): Relevant repository topics
-- **Issue Templates** (8 points): Standardized issue reporting
+- **Issue Templates** (8 points): Standardized issue reporting (checks repository and organization's `.github` repo)
 - **Help Wanted Issues** (8 points): Issues seeking community help
-- **Pull Request Template** (7 points): PR submission guidelines
+- **Pull Request Template** (7 points): PR submission guidelines (checks repository and organization's `.github` repo)
 - **Repository Name** (5 points): Descriptive and relevant name
 - **Active Repository** (5 points): Not archived
 
+### Organization-Level Community Health Files
+
+RepoReady automatically checks for community health files in the organization's `.github` repository when they're missing from the individual repository. This follows [GitHub's community health file standards](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file) where organizations can provide default files for all their repositories.
+
+Files checked at the organization level include:
+- `CODE_OF_CONDUCT.md`
+- `CONTRIBUTING.md` 
+- `LICENSE` (and variants)
+- Issue templates in `.github/ISSUE_TEMPLATE/`
+- `PULL_REQUEST_TEMPLATE.md`
+
 ## Scoring & Ratings
 
 - **Excellent** (90-100%): Ready for contributors with outstanding setup

src/evaluator/criteria.ts

@@ -129,19 +129,19 @@ export function generateRecommendations(results: Array<{ criteria: string; passe
         recommendations.push('Create a comprehensive README.md with project description, installation, and usage instructions');
         break;
       case 'Contributing Guidelines':
-        recommendations.push('Add a CONTRIBUTING.md file explaining how others can contribute to your project');
+        recommendations.push('Add a CONTRIBUTING.md file explaining how others can contribute to your project (can be added to the repository or organization\'s .github repository)');
         break;
       case 'Code of Conduct':
-        recommendations.push('Add a CODE_OF_CONDUCT.md file to create a welcoming environment for contributors');
+        recommendations.push('Add a CODE_OF_CONDUCT.md file to create a welcoming environment for contributors (can be added to the repository or organization\'s .github repository)');
         break;
       case 'Open Source License':
-        recommendations.push('Add an open source license (MIT, Apache 2.0, GPL, etc.) to make your project truly open source');
+        recommendations.push('Add an open source license (MIT, Apache 2.0, GPL, etc.) to make your project truly open source (can be added to the repository or organization\'s .github repository)');
         break;
       case 'Issue Templates':
-        recommendations.push('Create issue templates in .github/ISSUE_TEMPLATE/ to help contributors report bugs and request features');
+        recommendations.push('Create issue templates in .github/ISSUE_TEMPLATE/ to help contributors report bugs and request features (can be added to the repository or organization\'s .github repository)');
         break;
       case 'Pull Request Template':
-        recommendations.push('Add a pull request template to standardize contribution submissions');
+        recommendations.push('Add a pull request template to standardize contribution submissions (can be added to the repository or organization\'s .github repository)');
         break;
       case 'Good First Issues':
         recommendations.push('Create and label some issues as "good first issue" to welcome new contributors');

src/utils/github.ts

@@ -89,7 +89,9 @@ export class GitHubService {
         return true;
       }
     }
-    return false;
+
+    // Check organization's .github repository for community health files
+    return await this.checkOrgCommunityFile(owner, 'CONTRIBUTING.md');
   }
 
   private async checkCodeOfConductFile(owner: string, repo: string): Promise<boolean> {
@@ -105,7 +107,9 @@ export class GitHubService {
         return true;
       }
     }
-    return false;
+
+    // Check organization's .github repository for community health files
+    return await this.checkOrgCommunityFile(owner, 'CODE_OF_CONDUCT.md');
   }
 
   private async checkLicenseFile(owner: string, repo: string): Promise<boolean> {
@@ -124,6 +128,15 @@ export class GitHubService {
         return true;
       }
     }
+
+    // Check organization's .github repository for license file
+    const licenseFiles = ['LICENSE', 'LICENSE.md', 'LICENSE.txt'];
+    for (const filename of licenseFiles) {
+      if (await this.checkOrgCommunityFile(owner, filename)) {
+        return true;
+      }
+    }
+    
     return false;
   }
 
@@ -149,7 +162,9 @@ export class GitHubService {
           return true;
         }
       }
-      return false;
+
+      // Check organization's .github repository for issue templates
+      return await this.checkOrgIssueTemplates(owner);
     }
   }
 
@@ -166,7 +181,9 @@ export class GitHubService {
         return true;
       }
     }
-    return false;
+
+    // Check organization's .github repository for PR template
+    return await this.checkOrgCommunityFile(owner, 'PULL_REQUEST_TEMPLATE.md');
   }
 
   private async checkLabeledIssues(owner: string, repo: string): Promise<{ hasGoodFirst: boolean; hasHelpWanted: boolean }> {
@@ -215,4 +232,87 @@ export class GitHubService {
       throw new Error(`Failed to create repository: ${error}`);
     }
   }
+
+  /**
+   * Check if a community health file exists in the organization's .github repository
+   * @param owner The organization name
+   * @param filename The community health file to check for (e.g., 'CODE_OF_CONDUCT.md')
+   * @returns Promise<boolean> indicating if the file exists
+   */
+  private async checkOrgCommunityFile(owner: string, filename: string): Promise<boolean> {
+    try {
+      // First check if the .github repository exists for this organization
+      await this.octokit.repos.get({
+        owner,
+        repo: '.github',
+      });
+
+      // Check for the file in various possible locations within the org's .github repo
+      const possiblePaths = [
+        `profile/${filename}`,
+        filename,
+        `.github/${filename}`
+      ];
+
+      for (const path of possiblePaths) {
+        if (await this.checkFileExists(owner, '.github', path)) {
+          return true;
+        }
+      }
+      
+      return false;
+    } catch {
+      // If .github repository doesn't exist or isn't accessible, return false
+      return false;
+    }
+  }
+
+  /**
+   * Check if issue templates exist in the organization's .github repository
+   * @param owner The organization name
+   * @returns Promise<boolean> indicating if issue templates exist
+   */
+  private async checkOrgIssueTemplates(owner: string): Promise<boolean> {
+    try {
+      // First check if the .github repository exists for this organization
+      await this.octokit.repos.get({
+        owner,
+        repo: '.github',
+      });
+
+      // Check for issue templates in the org's .github repo
+      const possiblePaths = [
+        '.github/ISSUE_TEMPLATE',
+        'ISSUE_TEMPLATE',
+        '.github/ISSUE_TEMPLATE.md',
+        'ISSUE_TEMPLATE.md'
+      ];
+
+      for (const path of possiblePaths) {
+        try {
+          const { data } = await this.octokit.repos.getContent({
+            owner,
+            repo: '.github',
+            path,
+          });
+
+          // If it's a directory with templates, check if it has content
+          if (Array.isArray(data) && data.length > 0) {
+            return true;
+          }
+          // If it's a single template file
+          if (!Array.isArray(data)) {
+            return true;
+          }
+        } catch {
+          // Continue checking other paths
+        }
+      }
+      
+      return false;
+    } catch {
+      // If .github repository doesn't exist or isn't accessible, return false
+      return false;
+    }
+  }
 }