refactor: improve PR comment to be more professional and informative (#6)

## Summary
- Replace bare metrics table with contextual pass/total ratio and config
path reference
- Each violation category rendered as its own collapsible `<details>`
section instead of one monolithic block
- Truncated examples now show "…and N more" count
- Clean single-line success message (no table with zeros)
- Subtle footer linking to the full workflow run and StructLint repo

### Before
```
## ✅ StructLint Validation

| Metric | Count |
|--------|-------|
| Checks passed | 12 |
| Violations | 3 |

<details>
<summary>Violation Details</summary>

### ⚠️ Files not matching any allowed naming pattern (3)
- `Disallowed file naming pattern found: ...`
- `Disallowed file naming pattern found: ...`
- `Disallowed file naming pattern found: ...`
</details>
```

### After (pass)
```
## StructLint — All checks passed

**12** rules validated against `.structlint.yaml`. No violations found.

---
View full run · Powered by StructLint
```

### After (fail)
```
## StructLint — 3 violation(s) found

**9**/12 rules passed · **3** violation(s) detected against `.structlint.yaml`.

▸ Files not matching any allowed naming pattern (3)
  - `Disallowed file naming pattern found: ...`
  - `Disallowed file naming pattern found: ...`
  - …and 1 more

---
View full run · Powered by StructLint
```

## Test plan
- [ ] Trigger workflow on a clean repo — verify success comment renders
correctly
- [ ] Trigger workflow with intentional violations — verify collapsible
categories and truncation
- [ ] Verify "View full run" link points to the correct workflow run

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: machado144

action.yml

@@ -92,6 +92,9 @@ runs:
     - name: Generate Summary
       if: always()
       shell: bash
+      env:
+        CONFIG_PATH: ${{ inputs.config }}
+        RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
       run: |
         REPORT="/tmp/structlint-report.json"
         if [ ! -f "$REPORT" ]; then
@@ -101,40 +104,47 @@ runs:
 
         SUCCESSES=$(jq -r '.successes' "$REPORT")
         FAILURES=$(jq -r '.failures' "$REPORT")
+        TOTAL=$((SUCCESSES + FAILURES))
 
-        if [ "$FAILURES" -eq 0 ]; then
-          STATUS_ICON="✅"
-          STATUS_TEXT="All checks passed"
-        else
-          STATUS_ICON="❌"
-          STATUS_TEXT="${FAILURES} violation(s) found"
-        fi
-
-        # Build markdown
         {
-          echo "## ${STATUS_ICON} StructLint Validation"
-          echo ""
-          echo "| Metric | Count |"
-          echo "|--------|-------|"
-          echo "| Checks passed | ${SUCCESSES} |"
-          echo "| Violations | ${FAILURES} |"
-        } > /tmp/structlint-md.tmp
-        MD=$(cat /tmp/structlint-md.tmp)
-
-        # Add violations detail if any
-        if [ "$FAILURES" -gt 0 ]; then
-          VIOLATIONS=$(jq -r '.summary.violations[]? | "### ⚠️ \(.description) (\(.count))\n" + ([.examples[]? | "- `\(.)`"] | join("\n")) + "\n"' "$REPORT")
-          {
+          if [ "$FAILURES" -eq 0 ]; then
+            echo "## StructLint — All checks passed"
             echo ""
-            echo "<details>"
-            echo "<summary><strong>Violation Details</strong></summary>"
+            echo "**${SUCCESSES}** rules validated against \`${CONFIG_PATH}\`. No violations found."
+          else
+            echo "## StructLint — ${FAILURES} violation(s) found"
             echo ""
-            echo "$VIOLATIONS"
+            echo "**${SUCCESSES}**/${TOTAL} rules passed · **${FAILURES}** violation(s) detected against \`${CONFIG_PATH}\`."
             echo ""
-            echo "</details>"
-          } >> /tmp/structlint-md.tmp
-          MD=$(cat /tmp/structlint-md.tmp)
-        fi
+
+            # Render each violation category
+            jq -r '.summary.violations[]? | @json' "$REPORT" | while IFS= read -r v; do
+              DESC=$(echo "$v" | jq -r '.description')
+              COUNT=$(echo "$v" | jq -r '.count')
+              EXAMPLES=$(echo "$v" | jq -r '.examples[]?')
+              EXAMPLE_COUNT=$(echo "$v" | jq -r '.examples | length')
+
+              echo "<details>"
+              echo "<summary><strong>${DESC}</strong> (${COUNT})</summary>"
+              echo ""
+              echo "$EXAMPLES" | while IFS= read -r ex; do
+                echo "- \`${ex}\`"
+              done
+              if [ "$COUNT" -gt "$EXAMPLE_COUNT" ]; then
+                REMAINING=$((COUNT - EXAMPLE_COUNT))
+                echo "- _…and ${REMAINING} more_"
+              fi
+              echo ""
+              echo "</details>"
+              echo ""
+            done
+          fi
+
+          echo "---"
+          echo "<sub><a href=\"${RUN_URL}\">View full run</a> · Powered by <a href=\"https://github.com/AxeForging/structlint\">StructLint</a></sub>"
+        } > /tmp/structlint-md.tmp
+
+        MD=$(cat /tmp/structlint-md.tmp)
 
         # Write to job summary
         echo "$MD" >> "$GITHUB_STEP_SUMMARY"