feat: make build failure optional with new fail-on-human input (#15)

## Summary
- Changed default behavior to not fail builds when human code is
detected
- Added `fail-on-human` input option (default: false) to control build
failure behavior
- Changed `post-comment` default to true for better visibility

## Changes
This PR makes the action more flexible by not failing builds by default
when human code is detected. Instead:
- The action will post a comment (now default behavior)
- The action will log a warning instead of failing
- Users can opt-in to the stricter behavior with `fail-on-human: true`

This allows teams to gradually adopt AI-first development practices
without immediately blocking all human contributions.

Author: dcramer

README.md

@@ -35,7 +35,8 @@ 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
+          post-comment: true  # Optional: post a fun comment when humans are detected (default: true)
+          fail-on-human: false  # Optional: fail the build when humans are detected (default: false)
 ```
 
 ## Configuration
@@ -47,7 +48,8 @@ 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` |
+| `post-comment` | Post a comment on PR when human code is detected | No | `true` |
+| `fail-on-human` | Fail the build when human code is detected | No | `false` |
 
 ### Outputs
 
@@ -93,7 +95,8 @@ 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
+          post-comment: true  # Optional: post a fun comment when humans are detected (default: true)
+          fail-on-human: false  # Optional: fail the build when humans are detected (default: false)
 ```
 
 ### 3. Required Permissions

action.yml

@@ -20,6 +20,10 @@ inputs:
   post-comment:
     description: 'Post a comment on PR when human code is detected'
     required: false
+    default: 'true'
+  fail-on-human:
+    description: 'Fail the build when human code is detected'
+    required: false
     default: 'false'
 
 outputs:

dist/index.js

@@ -29971,6 +29971,7 @@ async function run() {
         const openaiApiKey = core.getInput('openai-api-key', { required: true });
         const prNumber = parseInt(core.getInput('pr-number') || '0');
         const postComment = core.getInput('post-comment') === 'true';
+        const failOnHuman = core.getInput('fail-on-human') === 'true';
         if (!prNumber) {
             core.setFailed('No pull request number provided');
             return;
@@ -30043,7 +30044,13 @@ async function run() {
         }
         // Output results
         if (overallResult.isHumanLike) {
-            core.setFailed(`Code appears to be human-written (${overallResult.confidence.toFixed(1)}% confidence)`);
+            const message = `Code appears to be human-written (${overallResult.confidence.toFixed(1)}% confidence)`;
+            if (failOnHuman) {
+                core.setFailed(message);
+            }
+            else {
+                core.warning(message);
+            }
         }
         else {
             core.info(`✅ Code appears to be AI-generated (${overallResult.confidence.toFixed(1)}% confidence)`);

src/index.ts

@@ -9,6 +9,7 @@ async function run(): Promise<void> {
     const openaiApiKey = core.getInput('openai-api-key', { required: true });
     const prNumber = parseInt(core.getInput('pr-number') || '0');
     const postComment = core.getInput('post-comment') === 'true';
+    const failOnHuman = core.getInput('fail-on-human') === 'true';
 
     if (!prNumber) {
       core.setFailed('No pull request number provided');
@@ -95,9 +96,12 @@ async function run(): Promise<void> {
 
     // Output results
     if (overallResult.isHumanLike) {
-      core.setFailed(
-        `Code appears to be human-written (${overallResult.confidence.toFixed(1)}% confidence)`
-      );
+      const message = `Code appears to be human-written (${overallResult.confidence.toFixed(1)}% confidence)`;
+      if (failOnHuman) {
+        core.setFailed(message);
+      } else {
+        core.warning(message);
+      }
     } else {
       core.info(
         `✅ Code appears to be AI-generated (${overallResult.confidence.toFixed(1)}% confidence)`