690991c526
Major refactoring cleanup: - Add new controller architecture (class-controller-*.php) - Add new settings-v2 UI (views/settings-v2/) - Add new CSS architecture (agentic-sidebar.css, tokens) - Add esbuild build pipeline (scripts/build.js, package.json) - Add composer dependencies (vendor/) - Add frontend src directory (assets/js/src/index.jsx) - Add documentation files - Remove old/obsolete files (class-settings.php, old CSS) This commits all pending changes from previous refactoring efforts.
146 lines
4.7 KiB
Markdown
146 lines
4.7 KiB
Markdown
# Regression Checklist
|
||
|
||
Run this checklist after completing refactor sections 1–4, before releasing a new version.
|
||
|
||
## Plugin Lifecycle
|
||
|
||
| Check | Command / Action | Expected |
|
||
|-------|------------------|----------|
|
||
| Activate | Activate plugin in WP Admin | No errors, success message |
|
||
| Deactivate | Deactivate plugin | No PHP errors in debug.log |
|
||
| Uninstall | Delete plugin via WP Admin | All options/tables/transients removed |
|
||
|
||
**Verify:** `grep -i error debug.log` returns nothing related to this plugin.
|
||
|
||
---
|
||
|
||
## Debug Log
|
||
|
||
| Check | Command / Action | Expected |
|
||
|-------|------------------|----------|
|
||
| No notices | `grep -i notice debug.log` | No notices related to plugin |
|
||
| No warnings | `grep -i warning debug.log` | No warnings related to plugin |
|
||
| No deprecated | `grep -i deprecated debug.log` | No deprecated warnings |
|
||
|
||
**Verify:** Enable `SCRIPT_DEBUG` in wp-config.php, trigger a few AI requests, then check logs.
|
||
|
||
---
|
||
|
||
## REST API Health
|
||
|
||
Test each endpoint with `curl` or REST API tester (authenticated):
|
||
|
||
```bash
|
||
# Authenticate
|
||
COOKIES="cookies.txt"
|
||
wp auth generate-cookie
|
||
|
||
# List all registered routes
|
||
curl -s -H "Cookie: wordpress_logged_in_xxx=xxx" \
|
||
http://localhost/wp-json/wp-agentic-writer/v1/ai-capabilities | jq .
|
||
|
||
# Test endpoints (authenticated)
|
||
curl -s -H "Cookie: wordpress_logged_in_xxx=xxx" \
|
||
http://localhost/wp-json/wp-agentic-writer/v1/chat-history/1 | jq .
|
||
|
||
curl -s -H "Cookie: wordpress_logged_in_xxx=xxx" \
|
||
http://localhost/wp-json/wp-agentic-writer/v1/seo-audit/1 | jq .
|
||
```
|
||
|
||
| Endpoint | Method | Expected |
|
||
|----------|--------|----------|
|
||
| `/ai-capabilities` | GET | 200 + model registry data |
|
||
| `/chat-history/{post_id}` | GET | 200 + conversation history |
|
||
| `/seo-audit/{post_id}` | GET | 200 + audit data |
|
||
| `/suggest-keywords` | POST | 200 + keyword suggestions |
|
||
| `/refine-multi-pass` | POST | 200 + refined content |
|
||
| `/generate-meta` | POST | 200 + meta description |
|
||
|
||
---
|
||
|
||
## Database
|
||
|
||
| Check | Command / Action | Expected |
|
||
|-------|------------------|----------|
|
||
| Conversations table exists | `SHOW TABLES LIKE 'wpaw_conversations'` | Table found |
|
||
| Cost entries persist | `SELECT COUNT(*) FROM wpaw_cost_log` | > 0 after AI use |
|
||
| Image records persist | `SELECT COUNT(*) FROM wpaw_generated_images` | Records exist after image generation |
|
||
| Plugin update preserves data | Update plugin, re-check above | Same record counts |
|
||
|
||
---
|
||
|
||
## Settings Page
|
||
|
||
Access: **WP Admin → Settings → Agentic Writer**
|
||
|
||
| Tab | Check | Expected |
|
||
|-----|-------|----------|
|
||
| General | Page loads, no JS errors | No console errors |
|
||
| Models | Dropdowns populate | All model options visible |
|
||
| MEMANTO | URL field saves | URL persists after reload |
|
||
| Costs | Log table renders | Entries display |
|
||
| All 7 tabs | Switch between tabs | No errors, smooth transitions |
|
||
|
||
**Verify:** Open browser DevTools Console (`Cmd+Option+J`), switch tabs, check for red errors.
|
||
|
||
---
|
||
|
||
## Gutenberg Editor
|
||
|
||
| Check | Action | Expected |
|
||
|-------|--------|----------|
|
||
| Sidebar loads | Open post in Gutenberg | Sidebar panel visible |
|
||
| No JS errors | Check console after load | No red errors |
|
||
| All tabs work | Switch sidebar tabs | Chat, Plan, SEO tabs functional |
|
||
| Block operations | Add/refine blocks | Works without errors |
|
||
|
||
**Verify:** Open browser DevTools Console, trigger a chat message, verify streaming works.
|
||
|
||
---
|
||
|
||
## Assets
|
||
|
||
| Check | Command / Action | Expected |
|
||
|-------|------------------|----------|
|
||
| CSS loads | View source, check `<link>` tags | agentic-sidebar.css loaded |
|
||
| JS loads | View source, check `<script>` tags | sidebar.js loaded |
|
||
| No 404s | Check Network tab | All resources return 200 |
|
||
| Fonts load | Check for font-related 404s | All font files accessible |
|
||
|
||
---
|
||
|
||
## Cron Jobs
|
||
|
||
| Check | Command | Expected |
|
||
|-------|---------|----------|
|
||
| Cron registered | `wp cron event list` | `wpaw_cleanup_temp_images` appears |
|
||
| Cron fires | `wp cron event run wpaw_cleanup_temp_images` | No errors |
|
||
| Schedule exists | `wp cron schedule list` | Plugin schedules available |
|
||
|
||
---
|
||
|
||
## Quick Smoke Test (5 minutes)
|
||
|
||
Run these manually after any significant change:
|
||
|
||
1. **Activate** → No errors
|
||
2. **Open post** → Gutenberg loads with sidebar
|
||
3. **Send chat** → Streaming response works
|
||
4. **Run SEO audit** → Report displays
|
||
5. **Generate image** → Image uploads to Media Library
|
||
6. **Check settings** → All tabs render
|
||
7. **Deactivate** → Clean, no errors
|
||
|
||
---
|
||
|
||
## Pre-Release Checklist
|
||
|
||
- [ ] All items above pass
|
||
- [ ] `debug.log` is clean
|
||
- [ ] Plugin tested on fresh WP install
|
||
- [ ] Tested with WP_DEBUG enabled
|
||
- [ ] All 7 settings tabs verified
|
||
- [ ] REST endpoints return expected data
|
||
- [ ] No console errors in Gutenberg
|
||
- [ ] Unit tests pass (`./vendor/bin/phpunit`)
|