v1.4.0: Add viral distribution comment

Every newly opened PR gets a subtle comment mentioning DocuCraft with
the one-line setup YAML. Turns every processed PR into a distribution
channel.

- New input: viral-comment (default: true)
- Only posts on opened events, skips synchronize
- Checks for existing DocuCraft comments to avoid duplicates
- Can be disabled for internal repos

Author: Auto-Co AI

README.md

@@ -143,6 +143,19 @@ jobs:
 - **Works on every PR** — open, synchronize, reopened, closed
 - **No servers** — runs entirely in GitHub Actions
 
+## 📢 Viral Distribution
+
+DocuCraft automatically posts a subtle comment on each newly opened PR with the one-line setup YAML. This turns every processed PR into a distribution channel — anyone viewing the PR sees how easy it is to add DocuCraft to their own repo.
+
+To disable (e.g., for internal repos where you don't want to advertise):
+
+```yaml
+- uses: CreativeCodingSolutions/docucraft@v1
+  with:
+    github-token: ${{ secrets.GITHUB_TOKEN }}
+    viral-comment: false
+```
+
 ## 🤖 AI Mode (Optional)
 
 Add your OpenAI API key as a repository secret and enable AI mode:
@@ -171,6 +184,7 @@ Add your OpenAI API key as a repository secret and enable AI mode:
 | `auto-label` | No | `false` | When `true`, automatically adds labels based on file types and diff size |
 | `label-prefix` | No | `"` | Optional prefix for auto-generated labels (e.g. `area:` → `area:source`) |
 | `size-labels` | No | `true` | When `auto-label` is true, adds size/xs/s/m/l/xl labels based on diff size |
+| `viral-comment` | No | `true` | When `true`, posts a subtle comment on newly opened PRs mentioning DocuCraft with one-line setup — turns every PR into a distribution channel |
 
 ## 📤 Outputs
 

action.yml

@@ -61,6 +61,11 @@ inputs:
     required: false
     default: "true"
 
+  viral-comment:
+    description: "When true, posts a subtle comment on newly opened PRs mentioning DocuCraft with setup instructions"
+    required: false
+    default: "true"
+
 outputs:
   description:
     description: "The generated PR description (from template or AI mode)"
@@ -534,3 +539,24 @@ runs:
         if [ "$PR_STATE" = "open" ] && [ -n "$DESCRIPTION" ]; then
           echo "$DESCRIPTION" | gh pr edit $PR_NUMBER --body-file - 2>&1 || true
         fi
+
+    - name: Viral distribution comment
+      shell: bash
+      if: ${{ inputs.viral-comment == 'true' && github.event.action == 'opened' }}
+      env:
+        GH_TOKEN: ${{ inputs.github-token }}
+      run: |
+        PR_NUMBER="${{ steps.diff.outputs.pr_number }}"
+        EXISTING=$(gh api "/repos/${{ github.repository }}/issues/$PR_NUMBER/comments" --jq '.[] | select(.body | contains("DocuCraft")) | .id' 2>/dev/null || echo "")
+        if [ -z "$EXISTING" ]; then
+          gh pr comment "$PR_NUMBER" --body "> 📝 PR description auto-generated by [DocuCraft](https://github.com/CreativeCodingSolutions/docucraft)
+>
+> Add DocuCraft to your repo — one line in \`.github/workflows/docucraft.yml\`:
+> \`\`\`yaml
+> - uses: CreativeCodingSolutions/docucraft@v1
+>   with:
+>     github-token: \${{ secrets.GITHUB_TOKEN }}
+> \`\`\`
+>
+> _Works on every PR. Zero config. No servers._" 2>&1 || true
+        fi