@dedesfr/prompter 0.7.7 → 0.7.9

package/skills/laravel-code-review/assets/report-template-agent.md

@@ -0,0 +1,195 @@
+# Laravel Code Review — Agent Task List
+
+> Executable task list for AI agents. Process each task sequentially, marking as complete when done.
+
+## Review Summary
+
+| Attribute          | Value                                |
+| ------------------ | ------------------------------------ |
+| **Generated**      | {{TIMESTAMP}}                        |
+| **Review Style**   | {{REVIEW_STYLE}}                     |
+| **Framework**      | Laravel 12.x                         |
+| **PHP Version**    | 8.4                                  |
+| **Files Reviewed** | {{FILE_COUNT}}                       |
+| **Total Tasks**    | {{TASK_COUNT}}                       |
+| **Completed**      | {{COMPLETED_COUNT}} / {{TASK_COUNT}} |
+
+### Task Statistics
+
+| Priority       | Total                  | Remaining                  | Completed                  |
+| -------------- | ---------------------- | -------------------------- | -------------------------- |
+| 🔴 Critical     | {{CRITICAL_COUNT}}     | {{CRITICAL_REMAINING}}     | {{CRITICAL_COMPLETED}}     |
+| 🟠 Warning      | {{WARNING_COUNT}}      | {{WARNING_REMAINING}}      | {{WARNING_COMPLETED}}      |
+| 🟡 Optimization | {{OPTIMIZATION_COUNT}} | {{OPTIMIZATION_REMAINING}} | {{OPTIMIZATION_COMPLETED}} |
+| 🔵 Quality      | {{QUALITY_COUNT}}      | {{QUALITY_REMAINING}}      | {{QUALITY_COMPLETED}}      |
+
+### Categories
+
+| Category    | Count                 |
+| ----------- | --------------------- |
+| Security    | {{SECURITY_COUNT}}    |
+| Eloquent    | {{ELOQUENT_COUNT}}    |
+| PHP 8.4     | {{PHP84_COUNT}}       |
+| Conventions | {{CONVENTIONS_COUNT}} |
+
+---
+
+## Pending Tasks
+
+> Execute these tasks in order. Check the box `[x]` when completed.
+
+### 🔴 Critical Tasks (Execute First)
+
+{{#each critical_tasks}}
+- [ ] **TASK-{{task_id}}** | `{{file}}:{{line}}` | {{component}}
+  - **Issue:** {{title}}
+  - **Category:** {{category}}
+  - **Action:** {{action_verb}}
+  - **Target Code:**
+    ```php
+    {{target_code}}
+    ```
+  - **Replace With:**
+    ```php
+    {{replacement_code}}
+    ```
+  - **Docs:** [{{laravel_docs_label}}]({{laravel_docs_url}})
+
+{{/each}}
+
+### 🟠 Warning Tasks
+
+{{#each warning_tasks}}
+- [ ] **TASK-{{task_id}}** | `{{file}}:{{line}}` | {{component}}
+  - **Issue:** {{title}}
+  - **Category:** {{category}}
+  - **Action:** {{action_verb}}
+  - **Details:** {{description}}
+  - **Fix:** {{recommendation}}
+
+{{/each}}
+
+### 🟡 Optimization Tasks
+
+{{#each optimization_tasks}}
+- [ ] **TASK-{{task_id}}** | `{{file}}:{{line}}` | {{component}}
+  - **Issue:** {{title}}
+  - **Improvement:** {{recommendation}}
+
+{{/each}}
+
+### 🔵 Quality Tasks
+
+{{#each quality_tasks}}
+- [ ] **TASK-{{task_id}}** | `{{file}}:{{line}}` | {{component}}
+  - **Issue:** {{title}}
+  - **Suggestion:** {{recommendation}}
+
+{{/each}}
+
+---
+
+## Completed Tasks
+
+> Move completed tasks here with `[x]` checked.
+
+{{#each completed_tasks}}
+- [x] **TASK-{{task_id}}** | `{{file}}:{{line}}` — {{title}} ✅
+{{/each}}
+
+---
+
+## Agent Execution Commands
+
+> Ready-to-execute commands for automated processing.
+
+### File Edit Operations
+
+```json
+{
+  "operations": [
+{{#each edit_operations}}
+    {
+      "task_id": "TASK-{{task_id}}",
+      "operation": "replace",
+      "file": "{{file}}",
+      "component": "{{component}}",
+      "start_line": {{start_line}},
+      "end_line": {{end_line}},
+      "target": "{{target_code_escaped}}",
+      "replacement": "{{replacement_code_escaped}}",
+      "status": "{{status}}"
+    }{{#unless @last}},{{/unless}}
+{{/each}}
+  ]
+}
+```
+
+### Validation Commands
+
+After completing tasks, run these commands to verify:
+
+```bash
+# Static analysis
+./vendor/bin/phpstan analyse
+
+# Code style check
+./vendor/bin/pint --test
+
+# Run tests
+php artisan test
+
+# Clear caches
+php artisan optimize:clear
+```
+
+---
+
+## Task Execution Protocol
+
+For each pending task:
+
+1. **READ** the task details and target code
+2. **LOCATE** the file and line number
+3. **APPLY** the replacement code or fix
+4. **VERIFY** the change doesn't break other code
+5. **MARK** the task as complete `[x]`
+6. **MOVE** to Completed Tasks section
+
+### Status Flags
+
+```json
+{
+  "review_style": "{{REVIEW_STYLE}}",
+  "all_critical_resolved": {{all_critical_resolved}},
+  "all_warnings_resolved": {{all_warnings_resolved}},
+  "ready_for_commit": {{ready_for_commit}},
+  "requires_human_review": {{requires_human_review}},
+  "blocking_issues": {{blocking_count}},
+  "has_security_issues": {{has_security}},
+  "has_n_plus_one": {{has_n_plus_one}},
+  "has_mass_assignment": {{has_mass_assignment}}
+}
+```
+
+---
+
+## Quick Reference
+
+| Task ID Format | Meaning               |
+| -------------- | --------------------- |
+| `TASK-C###`    | Critical priority     |
+| `TASK-W###`    | Warning priority      |
+| `TASK-O###`    | Optimization priority |
+| `TASK-Q###`    | Quality priority      |
+
+| Status      | Symbol |
+| ----------- | ------ |
+| Pending     | `[ ]`  |
+| In Progress | `[-]`  |
+| Completed   | `[x]`  |
+| Skipped     | `[~]`  |
+
+---
+
+*Format: agent-tasks | Schema: laravel-code-review/v2 | {{REVIEW_STYLE}} mode*

package/skills/laravel-code-review/assets/report-template-compact.md

@@ -0,0 +1,79 @@
+# Laravel Code Review — Compact
+
+**{{TIMESTAMP}}** | **{{REVIEW_STYLE}}** mode | {{FILE_COUNT}} files | {{ISSUE_COUNT}} issues
+
+## Review Configuration
+
+| Style                                       | Focus Areas Applied     |
+| ------------------------------------------- | ----------------------- |
+| {{REVIEW_STYLE_EMOJI}} **{{REVIEW_STYLE}}** | {{FOCUS_AREAS_SUMMARY}} |
+
+## Summary
+
+🔴 {{CRITICAL_COUNT}} critical | 🟠 {{WARNING_COUNT}} warning | 🟡 {{OPTIMIZATION_COUNT}} optimize | 🔵 {{QUALITY_COUNT}} quality
+
+**By Category:** {{SECURITY_COUNT}} sec | {{ELOQUENT_COUNT}} eloquent | {{PHP84_COUNT}} php84 | {{CONVENTIONS_COUNT}} conventions
+
+---
+
+## Issues
+
+| Sev | File | Line | Issue | Category |
+| --- | ---- | ---: | ----- | -------- |
+{{#each issues}}
+| {{severity_emoji}} | `{{file_short}}` | {{line}} | {{title}} | {{category}} |
+{{/each}}
+
+---
+
+## By Component
+
+{{#each components_with_issues}}
+### {{component}}
+
+{{#each files}}
+**`{{file_short}}`**
+{{#each issues}}
+- {{severity_emoji}} L{{line}}: {{title}} → {{recommendation_short}}
+{{/each}}
+
+{{/each}}
+{{/each}}
+
+---
+
+## Action Items
+
+**🔴 Critical ({{CRITICAL_COUNT}}):** {{#if_strict_or_balanced}}*All flagged*{{/if_strict_or_balanced}}{{#if_lenient}}*Critical only*{{/if_lenient}}
+{{#each critical_issues}}
+- [ ] {{file_short}}:{{line}} — {{title}}
+{{/each}}
+
+{{#if_not_lenient}}
+**🟠 Warnings ({{WARNING_COUNT}}):**
+{{#each warning_issues}}
+- [ ] {{file_short}}:{{line}} — {{title}}
+{{/each}}
+
+**🟡 Optimization ({{OPTIMIZATION_COUNT}}):**
+{{#each optimization_issues}}
+- [ ] {{file_short}}:{{line}} — {{title}}
+{{/each}}
+{{/if_not_lenient}}
+
+{{#if_strict}}
+**🔵 Quality ({{QUALITY_COUNT}}):**
+{{#each quality_issues}}
+- [ ] {{file_short}}:{{line}} — {{title}}
+{{/each}}
+{{/if_strict}}
+
+---
+
+## Focus Areas Applied
+
+{{#if FOCUS_SECURITY}}✅{{else}}❌{{/if}} Security | {{#if FOCUS_PERFORMANCE}}✅{{else}}❌{{/if}} Performance | {{#if FOCUS_BUGS}}✅{{else}}❌{{/if}} Bugs | {{#if FOCUS_STYLE}}✅{{else}}❌{{/if}} Style | {{#if FOCUS_TESTS}}✅{{else}}❌{{/if}} Tests | {{#if FOCUS_DOCS}}✅{{else}}❌{{/if}} Docs
+
+---
+
+*laravel-code-review • compact • {{REVIEW_STYLE}}*

package/skills/laravel-code-review/assets/report-template-full.md

@@ -0,0 +1,253 @@
+# Laravel Code Review Report
+
+**Generated:** {{TIMESTAMP}}  
+**Review Style:** {{REVIEW_STYLE_EMOJI}} {{REVIEW_STYLE}}  
+**Laravel Version:** 12.x  
+**PHP Version:** 8.4  
+**Reviewed Files:** {{FILE_COUNT}}  
+**Total Issues:** {{ISSUE_COUNT}}
+
+---
+
+## Review Configuration
+
+### Style Settings
+
+| Setting                | Value                                       |
+| ---------------------- | ------------------------------------------- |
+| **Review Style**       | {{REVIEW_STYLE_EMOJI}} **{{REVIEW_STYLE}}** |
+| **Severity Threshold** | {{SEVERITY_THRESHOLD}}                      |
+| **Tone**               | {{REVIEW_TONE}}                             |
+
+### Focus Areas Matrix
+
+| Focus Area                   | Status                      | Coverage Level              | Description                                          |
+| ---------------------------- | --------------------------- | --------------------------- | ---------------------------------------------------- |
+| **Security vulnerabilities** | {{FOCUS_SECURITY_EMOJI}}    | {{FOCUS_SECURITY_LEVEL}}    | SQL injection, XSS, mass assignment, exposed secrets |
+| **Performance issues**       | {{FOCUS_PERFORMANCE_EMOJI}} | {{FOCUS_PERFORMANCE_LEVEL}} | N+1 queries, missing indexes, inefficient loops      |
+| **Bug detection**            | {{FOCUS_BUGS_EMOJI}}        | {{FOCUS_BUGS_LEVEL}}        | Logic errors, edge cases, runtime errors             |
+| **Code style**               | {{FOCUS_STYLE_EMOJI}}       | {{FOCUS_STYLE_LEVEL}}       | PSR-12, naming conventions, Laravel conventions      |
+| **Test coverage**            | {{FOCUS_TESTS_EMOJI}}       | {{FOCUS_TESTS_LEVEL}}       | Missing or inadequate tests                          |
+| **Documentation**            | {{FOCUS_DOCS_EMOJI}}        | {{FOCUS_DOCS_LEVEL}}        | Missing PHPDoc, unclear APIs                         |
+
+### What This Means
+
+{{#if_strict}}
+> **🔒 Strict Mode Active**  
+> All potential issues are flagged across all focus areas. This is the most thorough review level, prioritizing quality and security. Expect detailed feedback on critical, warning, optimization, and quality issues.
+{{/if_strict}}
+
+{{#if_balanced}}
+> **⚖️ Balanced Mode Active**  
+> High-confidence issues are flagged. Security, performance, and bugs are fully covered. Code style only flags major violations. Documentation issues are skipped for practicality.
+{{/if_balanced}}
+
+{{#if_lenient}}
+> **💚 Lenient Mode Active**  
+> Only critical bugs and security vulnerabilities are flagged. This mode is encouraging and focuses on must-fix issues only. Great for quick reviews or junior developer feedback.
+{{/if_lenient}}
+
+---
+
+## Summary
+
+| Severity       | Count                  | Included                  |
+| -------------- | ---------------------- | ------------------------- |
+| 🔴 Critical     | {{CRITICAL_COUNT}}     | ✅ Always                  |
+| 🟠 Warning      | {{WARNING_COUNT}}      | {{WARNING_INCLUDED}}      |
+| 🟡 Optimization | {{OPTIMIZATION_COUNT}} | {{OPTIMIZATION_INCLUDED}} |
+| 🔵 Code Quality | {{QUALITY_COUNT}}      | {{QUALITY_INCLUDED}}      |
+
+### Issue Categories
+
+| Category            | Count                 |
+| ------------------- | --------------------- |
+| Security            | {{SECURITY_COUNT}}    |
+| Eloquent            | {{ELOQUENT_COUNT}}    |
+| PHP 8.4             | {{PHP84_COUNT}}       |
+| Laravel Conventions | {{CONVENTIONS_COUNT}} |
+
+---
+
+## Files Reviewed
+
+### By Component
+
+**Controllers:**
+{{#each controllers}}
+- `{{this}}`
+{{/each}}
+
+**Models:**
+{{#each models}}
+- `{{this}}`
+{{/each}}
+
+**Services:**
+{{#each services}}
+- `{{this}}`
+{{/each}}
+
+**Views:**
+{{#each views}}
+- `{{this}}`
+{{/each}}
+
+**Other:**
+{{#each others}}
+- `{{this}}`
+{{/each}}
+
+---
+
+## Issues by Component
+
+{{#each issues}}
+
+### `{{component}}`
+
+#### `{{file}}`
+
+##### Issue {{index}}: {{title}}
+
+| Attribute      | Value                           |
+| -------------- | ------------------------------- |
+| **Severity**   | {{severity_emoji}} {{severity}} |
+| **Line**       | {{line}}                        |
+| **Type**       | {{type}}                        |
+| **Category**   | {{category}}                    |
+| **Focus Area** | {{focus_area}}                  |
+
+**Description:**  
+{{description}}
+
+**Code:**
+```php
+// Line {{line}}
+{{code_snippet}}
+```
+
+**Recommendation:**  
+{{recommendation}}
+
+{{#if suggested_fix}}
+**Suggested Fix:**
+```php
+{{suggested_fix}}
+```
+{{/if}}
+
+{{#if laravel_docs}}
+**Laravel Docs:** [{{laravel_docs_title}}](https://laravel.com/docs/12.x/{{laravel_docs}})
+{{/if}}
+
+---
+
+<!-- MACHINE_READABLE_START
+{
+  "file": "{{file}}",
+  "line": {{line}},
+  "severity": "{{severity_lower}}",
+  "type": "{{type}}",
+  "category": "{{category}}",
+  "component": "{{component}}",
+  "focus_area": "{{focus_area}}",
+  "review_style": "{{REVIEW_STYLE}}",
+  "description": "{{description_escaped}}",
+  "recommendation": "{{recommendation_escaped}}",
+  "laravel_version": "12.x",
+  "php_version": "8.4",
+  "solved": false
+}
+MACHINE_READABLE_END -->
+
+{{/each}}
+
+---
+
+## Quick Fixes by Priority
+
+### 🔴 Critical (Must Fix)
+
+{{#each critical_issues}}
+- [ ] **{{file}}:{{line}}** - {{title}}
+{{/each}}
+{{#if_no_critical}}
+✅ No critical issues!
+{{/if_no_critical}}
+
+{{#if_not_lenient}}
+### 🟠 Warnings (Should Fix)
+
+{{#each warning_issues}}
+- [ ] **{{file}}:{{line}}** - {{title}}
+{{/each}}
+{{#if_no_warnings}}
+✅ No warnings!
+{{/if_no_warnings}}
+
+### 🟡 Optimization (Nice to Have)
+
+{{#each optimization_issues}}
+- [ ] **{{file}}:{{line}}** - {{title}}
+{{/each}}
+{{#if_no_optimization}}
+✅ No optimization issues!
+{{/if_no_optimization}}
+{{/if_not_lenient}}
+
+{{#if_strict}}
+### 🔵 Quality (Polish)
+
+{{#each quality_issues}}
+- [ ] **{{file}}:{{line}}** - {{title}}
+{{/each}}
+{{#if_no_quality}}
+✅ No quality issues!
+{{/if_no_quality}}
+{{/if_strict}}
+
+---
+
+## Report Metadata
+
+```json
+{
+  "version": "2.0",
+  "generated_at": "{{TIMESTAMP}}",
+  "review_style": "{{REVIEW_STYLE}}",
+  "review_config": {
+    "severity_threshold": "{{SEVERITY_THRESHOLD}}",
+    "tone": "{{REVIEW_TONE}}",
+    "focus_areas": {
+      "security": "{{FOCUS_SECURITY_LEVEL}}",
+      "performance": "{{FOCUS_PERFORMANCE_LEVEL}}",
+      "bugs": "{{FOCUS_BUGS_LEVEL}}",
+      "code_style": "{{FOCUS_STYLE_LEVEL}}",
+      "test_coverage": "{{FOCUS_TESTS_LEVEL}}",
+      "documentation": "{{FOCUS_DOCS_LEVEL}}"
+    }
+  },
+  "framework": "laravel",
+  "framework_version": "12.x",
+  "php_version": "8.4",
+  "total_files": {{FILE_COUNT}},
+  "total_issues": {{ISSUE_COUNT}},
+  "severity_breakdown": {
+    "critical": {{CRITICAL_COUNT}},
+    "warning": {{WARNING_COUNT}},
+    "optimization": {{OPTIMIZATION_COUNT}},
+    "quality": {{QUALITY_COUNT}}
+  },
+  "category_breakdown": {
+    "security": {{SECURITY_COUNT}},
+    "eloquent": {{ELOQUENT_COUNT}},
+    "php84": {{PHP84_COUNT}},
+    "conventions": {{CONVENTIONS_COUNT}}
+  }
+}
+```
+
+---
+
+*Generated by laravel-code-review skill • Full format • {{REVIEW_STYLE}} mode*

package/skills/laravel-code-review/assets/report-template-human.md

@@ -0,0 +1,159 @@
+# Laravel Code Review Report
+
+**Generated:** {{TIMESTAMP}}  
+**Review Style:** {{REVIEW_STYLE_EMOJI}} {{REVIEW_STYLE}}  
+**Files Reviewed:** {{FILE_COUNT}} | **Issues Found:** {{ISSUE_COUNT}}
+
+---
+
+## 🎯 Review Configuration
+
+| Setting                | Value                                       |
+| ---------------------- | ------------------------------------------- |
+| **Review Style**       | {{REVIEW_STYLE_EMOJI}} **{{REVIEW_STYLE}}** |
+| **Severity Threshold** | {{SEVERITY_THRESHOLD}}                      |
+| **Tone**               | {{REVIEW_TONE}}                             |
+
+### Focus Areas
+
+| Focus Area               | Status                      | Level                       |
+| ------------------------ | --------------------------- | --------------------------- |
+| Security vulnerabilities | {{FOCUS_SECURITY_EMOJI}}    | {{FOCUS_SECURITY_LEVEL}}    |
+| Performance issues       | {{FOCUS_PERFORMANCE_EMOJI}} | {{FOCUS_PERFORMANCE_LEVEL}} |
+| Bug detection            | {{FOCUS_BUGS_EMOJI}}        | {{FOCUS_BUGS_LEVEL}}        |
+| Code style               | {{FOCUS_STYLE_EMOJI}}       | {{FOCUS_STYLE_LEVEL}}       |
+| Test coverage            | {{FOCUS_TESTS_EMOJI}}       | {{FOCUS_TESTS_LEVEL}}       |
+| Documentation            | {{FOCUS_DOCS_EMOJI}}        | {{FOCUS_DOCS_LEVEL}}        |
+
+---
+
+## 📊 Overview
+
+|     🔴 Critical     |     🟠 Warning     |       🟡 Optimize       |     🔵 Quality     |
+| :----------------: | :---------------: | :--------------------: | :---------------: |
+| {{CRITICAL_COUNT}} | {{WARNING_COUNT}} | {{OPTIMIZATION_COUNT}} | {{QUALITY_COUNT}} |
+
+**Categories:** {{SECURITY_COUNT}} security | {{ELOQUENT_COUNT}} eloquent | {{PHP84_COUNT}} PHP 8.4 | {{CONVENTIONS_COUNT}} conventions
+
+---
+
+{{#if has_critical}}
+## 🔴 Critical Issues (Fix Before Commit)
+
+{{#each critical_issues}}
+### {{file_short}}
+
+**Line {{line}}** — {{title}}
+
+> {{description}}
+
+**Fix:** {{recommendation}}
+
+{{#if suggested_fix}}
+```php
+{{suggested_fix}}
+```
+{{/if}}
+
+---
+{{/each}}
+{{/if}}
+
+{{#if has_warnings}}
+{{#if_not_lenient}}
+## 🟠 Warnings (Should Address)
+
+{{#each warning_issues}}
+- **{{file_short}}:{{line}}** — {{title}}
+  - {{description}}
+  - 💡 {{recommendation}}
+{{/each}}
+
+---
+{{/if_not_lenient}}
+{{/if}}
+
+{{#if has_optimization}}
+{{#if_not_lenient}}
+## 🟡 Optimization Suggestions
+
+{{#each optimization_issues}}
+- **{{file_short}}:{{line}}** — {{title}}
+  - {{recommendation}}
+{{/each}}
+
+---
+{{/if_not_lenient}}
+{{/if}}
+
+{{#if has_quality}}
+{{#if_strict}}
+## 🔵 Code Quality
+
+{{#each quality_issues}}
+- **{{file_short}}:{{line}}** — {{title}}
+{{/each}}
+
+---
+{{/if_strict}}
+{{/if}}
+
+## ✅ Quick Action Checklist
+
+### Must Fix (Critical)
+{{#each critical_issues}}
+- [ ] `{{file_short}}:{{line}}` — {{title}}
+{{/each}}
+{{#if_no_critical}}
+- ✅ No critical issues found!
+{{/if_no_critical}}
+
+{{#if_not_lenient}}
+### Should Fix (Warnings)
+{{#each warning_issues}}
+- [ ] `{{file_short}}:{{line}}` — {{title}}
+{{/each}}
+{{#if_no_warnings}}
+- ✅ No warnings found!
+{{/if_no_warnings}}
+
+### Nice to Have (Optimization)
+{{#each optimization_issues}}
+- [ ] `{{file_short}}:{{line}}` — {{title}}
+{{/each}}
+{{/if_not_lenient}}
+
+{{#if_strict}}
+### Polish (Quality)
+{{#each quality_issues}}
+- [ ] `{{file_short}}:{{line}}` — {{title}}
+{{/each}}
+{{/if_strict}}
+
+---
+
+## 💬 Review Summary
+
+{{#if_strict}}
+> **Strict Mode:** This review flagged all potential issues across all focus areas. Address critical and warning issues before committing. Quality issues are optional but recommended for production code.
+{{/if_strict}}
+
+{{#if_balanced}}
+> **Balanced Mode:** This review focused on high-confidence issues. Critical issues must be fixed. Warnings are strongly recommended. Lower severity items were filtered for practicality.
+{{/if_balanced}}
+
+{{#if_lenient}}
+> **Lenient Mode:** This review only flagged critical bugs and security issues. Great job on the code! 🎉 Only urgent items require attention before commit.
+{{/if_lenient}}
+
+---
+
+## 📚 Helpful Resources
+
+- [Laravel 12 Documentation](https://laravel.com/docs/12.x)
+- [Eloquent Relationships](https://laravel.com/docs/12.x/eloquent-relationships)
+- [PHP 8.4 New Features](https://www.php.net/releases/8.4/en.php)
+
+---
+
+*Generated by laravel-code-review skill • Human-readable format • {{REVIEW_STYLE}} mode*