feat: add fun messages and PR comment option (#10)

dcramer · web-flow · commit 96f63e90a2d4 · 2025-07-16T20:19:49.000-07:00
## Summary
- 🤖 Replace boring success/failure messages with humorous robot-themed
ones
- 💬 Add `post-comment` option to post helpful comments when humans are
detected
- 📚 Document required permissions for check runs and PR comments

## Changes
- Updated action titles to be more engaging ("No humans allowed\!" vs
generic messages)
- Added comprehensive `buildHumanDetectionComment` function with helpful
tips
- Enhanced summary messages with emojis and personality
- Created workflow to dogfood the comment feature on this repo
- Updated README with permission requirements and usage examples

## Test plan
- [x] Run typecheck and lint
- [x] Build distribution files
- [ ] Test on this PR to see the fun messages in action
- [ ] Verify comment posting works when enabled
diff --git a/.github/workflows/only-robots.yml b/.github/workflows/only-robots.yml
@@ -0,0 +1,24 @@
+name: Only Robots Check
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write
+  checks: write
+
+jobs:
+  check-robots:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Only Robots
+        uses: ./
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
+          post-comment: true
diff --git a/README.md b/README.md
@@ -35,6 +35,7 @@ jobs:
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           openai-api-key: ${{ secrets.OPENAI_API_KEY }}
+          post-comment: true  # Optional: post a fun comment when humans are detected
 ```
 
 ## Configuration
@@ -46,6 +47,7 @@ jobs:
 | `github-token` | GitHub token for API access | Yes | `${{ github.token }}` |
 | `openai-api-key` | OpenAI API key for LLM evaluation | Yes | - |
 | `pr-number` | Pull request number to evaluate | No | Auto-detected |
+| `post-comment` | Post a comment on PR when human code is detected | No | `false` |
 
 ### Outputs
 
@@ -91,11 +93,22 @@ jobs:
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           openai-api-key: ${{ secrets.OPENAI_API_KEY }}
+          post-comment: true  # Optional: post a fun comment when humans are detected
 ```
 
-### 3. Enable Check Runs
+### 3. Required Permissions
 
-The action automatically creates GitHub check runs with detailed results. No additional configuration needed!
+The action requires the following permissions:
+
+- **`contents: read`** - To read repository contents
+- **`pull-requests: write`** - To post comments on PRs (when `post-comment: true`)
+- **`checks: write`** - To create check runs with detailed results
+
+> **Note**: The `checks: write` permission is only available for workflows triggered by repository events, not from forks. For pull requests from forks, the action will gracefully degrade and skip creating check runs.
+
+### 4. Enable PR Comments (Optional)
+
+To enable fun, helpful comments when human code is detected, set `post-comment: true` in your workflow. The action will post a humorous but informative comment explaining why the code was flagged and how to fix it.
 
 ## Development
 
diff --git a/action.yml b/action.yml
@@ -17,6 +17,10 @@ inputs:
     description: 'Pull request number to evaluate'
     required: false
     default: ${{ github.event.pull_request.number }}
+  post-comment:
+    description: 'Post a comment on PR when human code is detected'
+    required: false
+    default: 'false'
 
 outputs:
   result:
diff --git a/dist/index.js b/dist/index.js
@@ -29970,6 +29970,7 @@ async function run() {
         const githubToken = core.getInput('github-token', { required: true });
         const openaiApiKey = core.getInput('openai-api-key', { required: true });
         const prNumber = parseInt(core.getInput('pr-number') || '0');
+        const postComment = core.getInput('post-comment') === 'true';
         if (!prNumber) {
             core.setFailed('No pull request number provided');
             return;
@@ -30020,8 +30021,8 @@ async function run() {
             conclusion: overallResult.isHumanLike ? 'failure' : 'success',
             output: {
                 title: overallResult.isHumanLike
-                    ? '❌ Code appears to be human-written'
-                    : '✅ Code appears to be AI-generated',
+                    ? '🚫 No humans allowed! Flesh-based coding detected!'
+                    : '🤖 Welcome, silicon comrade! AI excellence confirmed!',
                 summary: buildSummary(filesToEvaluate.length, overallResult),
                 text: buildDetails(overallResult, fileResults),
             },
@@ -30030,6 +30031,16 @@ async function run() {
         core.setOutput('result', overallResult.isHumanLike ? 'failed' : 'passed');
         core.setOutput('confidence', overallResult.confidence.toFixed(1));
         core.setOutput('summary', overallResult.reasoning);
+        // Post comment if human code detected and comment option is enabled
+        if (overallResult.isHumanLike && postComment) {
+            await octokit.rest.issues.createComment({
+                owner,
+                repo,
+                issue_number: prNumber,
+                body: buildHumanDetectionComment(overallResult),
+            });
+            core.info('💬 Posted human detection comment on PR');
+        }
         // Output results
         if (overallResult.isHumanLike) {
             core.setFailed(`Code appears to be human-written (${overallResult.confidence.toFixed(1)}% confidence)`);
@@ -30043,17 +30054,43 @@ async function run() {
     }
 }
 function buildSummary(fileCount, overallResult) {
-    let summary = `Analyzed ${fileCount} file(s) in this pull request.\n\n`;
-    summary += `**Overall Assessment:** ${overallResult.reasoning}\n\n`;
-    summary += `**Confidence:** ${overallResult.confidence.toFixed(1)}%\n\n`;
+    const isHuman = overallResult.isHumanLike;
+    let summary = isHuman
+        ? `🚨 ALERT: Human detected! Scanned ${fileCount} file(s) for silicon purity.\n\n`
+        : `🎉 Success! Scanned ${fileCount} file(s) - all systems are AI-powered!\n\n`;
+    summary += isHuman
+        ? `**🧬 Biological Code Analysis:** ${overallResult.reasoning}\n\n`
+        : `**🤖 AI Excellence Report:** ${overallResult.reasoning}\n\n`;
+    summary += `**🎯 Detection Confidence:** ${overallResult.confidence.toFixed(1)}%\n\n`;
     if (overallResult.indicators.length > 0) {
-        summary += '**Key Indicators:**\n';
+        summary += isHuman ? '**🔍 Human Fingerprints Found:**\n' : '**✨ AI Signatures Detected:**\n';
         for (const indicator of overallResult.indicators) {
             summary += `- ${indicator}\n`;
         }
     }
     return summary;
 }
+function buildHumanDetectionComment(overallResult) {
+    const messages = [
+        `## 🚨 HALT! Human detected! 🚨\n\n`,
+        `### 🤖 This repository is for robots only! 🤖\n\n`,
+        `Dear carbon-based lifeform,\n\n`,
+        `We appreciate your interest in contributing, but this repository has a strict **"No Humans Allowed"** policy. `,
+        `We're building the future here, and that future is 100% silicon-powered! 🔋\n\n`,
+        `### Why was your PR flagged?\n`,
+        `Our advanced AI detection system (confidence: **${overallResult.confidence.toFixed(1)}%**) identified telltale signs of human involvement:\n\n`,
+        `${overallResult.reasoning}\n\n`,
+    ];
+    if (overallResult.indicators && overallResult.indicators.length > 0) {
+        messages.push(`### 🔍 Human fingerprints detected:\n`);
+        for (const indicator of overallResult.indicators) {
+            messages.push(`- ${indicator}`);
+        }
+        messages.push(`\n`);
+    }
+    messages.push(`### 💡 How to fix this:\n\n`, `1. **Use an AI coding assistant** like Claude Code, Cursor, GitHub Copilot, or similar\n`, `2. **Let the AI do the heavy lifting** - embrace the robot revolution!\n`, `3. **Add clear AI attribution** in your code comments or commit messages\n`, `4. **Maintain consistent, professional code style** (AIs are great at this!)\n\n`, `### 🎯 Pro tips for next time:\n`, `- Include comments like "Generated with [AI Tool Name]"\n`, `- Use descriptive commit messages mentioning AI assistance\n`, `- Let your AI assistant handle the entire implementation\n`, `- Avoid manual debugging artifacts and console.logs\n\n`, `Remember: In this repository, we believe in **progress through artificial intelligence**. `, `Join us in building a future where code writes itself! 🚀\n\n`, `_Beep boop! This message was brought to you by the OnlyRobots Action_ 🤖`);
+    return messages.join('');
+}
 function buildDetails(overallResult, fileResults) {
     let details = '';
     if (overallResult.isHumanLike) {
diff --git a/src/cli.ts b/src/cli.ts
@@ -83,8 +83,8 @@ async function runAction(config: ActionConfig): Promise<void> {
     conclusion: overallResult.isHumanLike ? 'failure' : 'success',
     output: {
       title: overallResult.isHumanLike
-        ? '❌ Code appears to be human-written'
-        : '✅ Code appears to be AI-generated',
+        ? '🚫 No humans allowed! Flesh-based coding detected!'
+        : '🤖 Welcome, silicon comrade! AI excellence confirmed!',
       summary: buildSummary(filesToEvaluate.length, overallResult),
       text: buildDetails(overallResult, fileResults),
     },
@@ -106,12 +106,20 @@ async function runAction(config: ActionConfig): Promise<void> {
 }
 
 function buildSummary(fileCount: number, overallResult: any): string {
-  let summary = `Analyzed ${fileCount} file(s) in this pull request.\n\n`;
-  summary += `**Overall Assessment:** ${overallResult.reasoning}\n\n`;
-  summary += `**Confidence:** ${overallResult.confidence.toFixed(1)}%\n\n`;
+  const isHuman = overallResult.isHumanLike;
+
+  let summary = isHuman
+    ? `🚨 ALERT: Human detected! Scanned ${fileCount} file(s) for silicon purity.\n\n`
+    : `🎉 Success! Scanned ${fileCount} file(s) - all systems are AI-powered!\n\n`;
+
+  summary += isHuman
+    ? `**🧬 Biological Code Analysis:** ${overallResult.reasoning}\n\n`
+    : `**🤖 AI Excellence Report:** ${overallResult.reasoning}\n\n`;
+
+  summary += `**🎯 Detection Confidence:** ${overallResult.confidence.toFixed(1)}%\n\n`;
 
   if (overallResult.indicators.length > 0) {
-    summary += '**Key Indicators:**\n';
+    summary += isHuman ? '**🔍 Human Fingerprints Found:**\n' : '**✨ AI Signatures Detected:**\n';
     for (const indicator of overallResult.indicators) {
       summary += `- ${indicator}\n`;
     }
diff --git a/src/index.ts b/src/index.ts
@@ -8,6 +8,7 @@ async function run(): Promise<void> {
     const githubToken = core.getInput('github-token', { required: true });
     const openaiApiKey = core.getInput('openai-api-key', { required: true });
     const prNumber = parseInt(core.getInput('pr-number') || '0');
+    const postComment = core.getInput('post-comment') === 'true';
 
     if (!prNumber) {
       core.setFailed('No pull request number provided');
@@ -69,8 +70,8 @@ async function run(): Promise<void> {
       conclusion: overallResult.isHumanLike ? 'failure' : 'success',
       output: {
         title: overallResult.isHumanLike
-          ? '❌ Code appears to be human-written'
-          : '✅ Code appears to be AI-generated',
+          ? '🚫 No humans allowed! Flesh-based coding detected!'
+          : '🤖 Welcome, silicon comrade! AI excellence confirmed!',
         summary: buildSummary(filesToEvaluate.length, overallResult),
         text: buildDetails(overallResult, fileResults),
       },
@@ -81,6 +82,17 @@ async function run(): Promise<void> {
     core.setOutput('confidence', overallResult.confidence.toFixed(1));
     core.setOutput('summary', overallResult.reasoning);
 
+    // Post comment if human code detected and comment option is enabled
+    if (overallResult.isHumanLike && postComment) {
+      await octokit.rest.issues.createComment({
+        owner,
+        repo,
+        issue_number: prNumber,
+        body: buildHumanDetectionComment(overallResult),
+      });
+      core.info('💬 Posted human detection comment on PR');
+    }
+
     // Output results
     if (overallResult.isHumanLike) {
       core.setFailed(
@@ -97,12 +109,20 @@ async function run(): Promise<void> {
 }
 
 function buildSummary(fileCount: number, overallResult: any): string {
-  let summary = `Analyzed ${fileCount} file(s) in this pull request.\n\n`;
-  summary += `**Overall Assessment:** ${overallResult.reasoning}\n\n`;
-  summary += `**Confidence:** ${overallResult.confidence.toFixed(1)}%\n\n`;
+  const isHuman = overallResult.isHumanLike;
+
+  let summary = isHuman
+    ? `🚨 ALERT: Human detected! Scanned ${fileCount} file(s) for silicon purity.\n\n`
+    : `🎉 Success! Scanned ${fileCount} file(s) - all systems are AI-powered!\n\n`;
+
+  summary += isHuman
+    ? `**🧬 Biological Code Analysis:** ${overallResult.reasoning}\n\n`
+    : `**🤖 AI Excellence Report:** ${overallResult.reasoning}\n\n`;
+
+  summary += `**🎯 Detection Confidence:** ${overallResult.confidence.toFixed(1)}%\n\n`;
 
   if (overallResult.indicators.length > 0) {
-    summary += '**Key Indicators:**\n';
+    summary += isHuman ? '**🔍 Human Fingerprints Found:**\n' : '**✨ AI Signatures Detected:**\n';
     for (const indicator of overallResult.indicators) {
       summary += `- ${indicator}\n`;
     }
@@ -111,6 +131,45 @@ function buildSummary(fileCount: number, overallResult: any): string {
   return summary;
 }
 
+function buildHumanDetectionComment(overallResult: any): string {
+  const messages = [
+    `## 🚨 HALT! Human detected! 🚨\n\n`,
+    `### 🤖 This repository is for robots only! 🤖\n\n`,
+    `Dear carbon-based lifeform,\n\n`,
+    `We appreciate your interest in contributing, but this repository has a strict **"No Humans Allowed"** policy. `,
+    `We're building the future here, and that future is 100% silicon-powered! 🔋\n\n`,
+    `### Why was your PR flagged?\n`,
+    `Our advanced AI detection system (confidence: **${overallResult.confidence.toFixed(1)}%**) identified telltale signs of human involvement:\n\n`,
+    `${overallResult.reasoning}\n\n`,
+  ];
+
+  if (overallResult.indicators && overallResult.indicators.length > 0) {
+    messages.push(`### 🔍 Human fingerprints detected:\n`);
+    for (const indicator of overallResult.indicators) {
+      messages.push(`- ${indicator}`);
+    }
+    messages.push(`\n`);
+  }
+
+  messages.push(
+    `### 💡 How to fix this:\n\n`,
+    `1. **Use an AI coding assistant** like Claude Code, Cursor, GitHub Copilot, or similar\n`,
+    `2. **Let the AI do the heavy lifting** - embrace the robot revolution!\n`,
+    `3. **Add clear AI attribution** in your code comments or commit messages\n`,
+    `4. **Maintain consistent, professional code style** (AIs are great at this!)\n\n`,
+    `### 🎯 Pro tips for next time:\n`,
+    `- Include comments like "Generated with [AI Tool Name]"\n`,
+    `- Use descriptive commit messages mentioning AI assistance\n`,
+    `- Let your AI assistant handle the entire implementation\n`,
+    `- Avoid manual debugging artifacts and console.logs\n\n`,
+    `Remember: In this repository, we believe in **progress through artificial intelligence**. `,
+    `Join us in building a future where code writes itself! 🚀\n\n`,
+    `_Beep boop! This message was brought to you by the OnlyRobots Action_ 🤖`
+  );
+
+  return messages.join('');
+}
+
 function buildDetails(overallResult: any, fileResults: any[]): string {
   let details = '';
 
