proagents 1.3.0 → 1.5.0

package/README.md

@@ -357,6 +357,53 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 | `pa:tag` | Create git tag |
 | `pa:publish` | Publish package to registry |
 
+### Code Review & PR
+| Command | Description |
+|---------|-------------|
+| `pa:review-request` | Request code review from team |
+| `pa:review-comments` | Show PR review comments |
+| `pa:review-approve` | Approve current PR |
+
+### Architecture
+| Command | Description |
+|---------|-------------|
+| `pa:architecture` | Show architecture overview |
+| `pa:architecture-diagram` | Generate diagram (Mermaid) |
+| `pa:architecture-export` | Export diagram (SVG/PNG) |
+
+### API Testing
+| Command | Description |
+|---------|-------------|
+| `pa:api-test` | Test API endpoints |
+| `pa:curl` | Generate curl commands |
+| `pa:postman` | Generate Postman collection |
+
+### Health & Monitoring
+| Command | Description |
+|---------|-------------|
+| `pa:health` | Project health check |
+| `pa:monitor` | Show monitoring status |
+| `pa:uptime` | Service uptime check |
+
+### Quick Actions
+| Command | Description |
+|---------|-------------|
+| `pa:quick` | Show quick actions menu |
+| `pa:alias` | Manage command aliases |
+| `pa:alias-add` | Add custom alias |
+| `pa:alias-remove` | Remove custom alias |
+
+### Mobile Test Suite (React Native)
+| Command | Description |
+|---------|-------------|
+| `pa:test-mobile` | Run full mobile test suite |
+| `pa:test-visual` | Visual/design comparison testing |
+| `pa:test-auto-fix` | Auto-fix failing tests |
+| `pa:test-loop` | Test → Fix → Retest until all pass |
+| `pa:compare-figma` | Compare UI against Figma design |
+| `pa:compare-image` | Compare UI against image/sketch |
+| `pa:screenshot` | Capture app screenshots |
+
 ### Custom Commands
 | Command | Description |
 |---------|-------------|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proagents",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",

package/proagents/AI_INSTRUCTIONS.md

@@ -1535,6 +1535,875 @@ For `pa:publish`:
    https://www.npmjs.com/package/mypackage
    ```
 
+### Code Review & PR
+| Command | Action |
+|---------|--------|
+| `pa:review-request` | Request code review from team |
+| `pa:review-request "user"` | Request review from specific user |
+| `pa:review-comments` | Show PR review comments |
+| `pa:review-comments "pr"` | Comments for specific PR |
+| `pa:review-approve` | Approve current PR |
+| `pa:review-approve "pr"` | Approve specific PR |
+
+**How to execute Code Review commands:**
+
+For `pa:review-request`:
+1. Detect current branch and PR status
+2. If no PR exists, suggest creating one first
+3. Get team members from config or git history
+4. Request review:
+   ```
+   Review Request
+   ══════════════
+
+   PR: #123 - Add user authentication
+   Branch: feature/user-auth
+
+   Requesting review from:
+   • @tech-lead (suggested - code owner)
+   • @senior-dev (suggested - recent contributor)
+
+   Select reviewers or type username:
+   > @tech-lead, @qa-engineer
+
+   ✓ Review requested from 2 reviewers
+   ```
+
+For `pa:review-comments`:
+1. Get PR comments from GitHub/GitLab
+2. Group by file and status:
+   ```
+   PR Review Comments
+   ══════════════════
+
+   PR #123: Add user authentication
+   Status: Changes requested (2 pending)
+
+   src/auth/login.ts:
+   ├─ Line 45 [PENDING] @tech-lead:
+   │  "Consider using bcrypt instead of md5 for hashing"
+   │
+   └─ Line 78 [RESOLVED] @qa-engineer:
+      "Add error handling for network failures"
+
+   src/api/users.ts:
+   └─ Line 12 [PENDING] @tech-lead:
+      "Missing input validation"
+
+   Actions:
+   • Reply to comment: pa:review-reply "comment-id" "response"
+   • Resolve comment: pa:review-resolve "comment-id"
+   ```
+
+For `pa:review-approve`:
+1. Check all required checks pass
+2. Verify no pending comments
+3. Approve PR:
+   ```
+   PR Approval
+   ═══════════
+
+   PR #123: Add user authentication
+
+   Checks:
+   ✓ Tests passing
+   ✓ Build successful
+   ✓ No conflicts
+   ⚠ 1 pending comment (optional)
+
+   Approve anyway? [y/N]
+
+   ✓ PR approved!
+   Ready to merge.
+   ```
+
+### Architecture
+| Command | Action |
+|---------|--------|
+| `pa:architecture` | Show architecture overview |
+| `pa:architecture "module"` | Architecture for specific module |
+| `pa:architecture-diagram` | Generate architecture diagram |
+| `pa:architecture-export` | Export architecture docs |
+
+**How to execute Architecture commands:**
+
+For `pa:architecture`:
+1. Analyze project structure
+2. Identify architectural patterns
+3. Generate overview:
+   ```
+   Architecture Overview
+   ═════════════════════
+
+   Project: my-app
+   Type: Full-stack Next.js
+   Pattern: Clean Architecture + Feature-based
+
+   Layers:
+   ┌─────────────────────────────────────────┐
+   │  Presentation (app/, components/)       │
+   │  ┌───────────────────────────────────┐  │
+   │  │  Application (services/, hooks/)  │  │
+   │  │  ┌─────────────────────────────┐  │  │
+   │  │  │  Domain (types/, entities/) │  │  │
+   │  │  └─────────────────────────────┘  │  │
+   │  └───────────────────────────────────┘  │
+   └─────────────────────────────────────────┘
+
+   Key Components:
+   • API Routes: /app/api/* (15 endpoints)
+   • Pages: /app/* (12 pages)
+   • Components: /components/* (45 components)
+   • Services: /services/* (8 services)
+
+   Dependencies:
+   • Database: PostgreSQL via Prisma
+   • Auth: NextAuth.js with JWT
+   • State: Zustand + React Query
+   • Styling: Tailwind CSS
+
+   Patterns Detected:
+   • Repository Pattern (services/)
+   • Factory Pattern (components/forms/)
+   • Singleton (lib/prisma.ts)
+   ```
+
+For `pa:architecture-diagram`:
+1. Generate Mermaid diagram from codebase
+2. Show component relationships:
+   ```mermaid
+   graph TB
+     subgraph Presentation
+       Pages[Pages]
+       Components[Components]
+     end
+
+     subgraph Application
+       Services[Services]
+       Hooks[Hooks]
+     end
+
+     subgraph Infrastructure
+       API[API Routes]
+       DB[(Database)]
+     end
+
+     Pages --> Components
+     Pages --> Hooks
+     Hooks --> Services
+     Services --> API
+     API --> DB
+   ```
+3. Save to `./docs/architecture.md`
+
+### API Testing
+| Command | Action |
+|---------|--------|
+| `pa:api-test` | Test API endpoints |
+| `pa:api-test "endpoint"` | Test specific endpoint |
+| `pa:curl` | Generate curl commands |
+| `pa:curl "endpoint"` | Curl for specific endpoint |
+| `pa:postman` | Generate Postman collection |
+| `pa:postman-export` | Export to Postman file |
+
+**How to execute API Testing commands:**
+
+For `pa:api-test`:
+1. Discover API endpoints from routes
+2. Generate and run tests:
+   ```
+   API Test Results
+   ════════════════
+
+   Testing: /api/*
+   Environment: development (localhost:3000)
+
+   GET /api/users
+   ├─ Status: 200 OK ✓
+   ├─ Time: 45ms
+   └─ Response: Array[10 items]
+
+   POST /api/users
+   ├─ Status: 201 Created ✓
+   ├─ Time: 120ms
+   └─ Response: { id: "123", name: "Test" }
+
+   GET /api/users/:id
+   ├─ Status: 200 OK ✓
+   ├─ Time: 32ms
+   └─ Response: { id: "1", name: "John" }
+
+   DELETE /api/users/:id
+   ├─ Status: 401 Unauthorized ✗
+   ├─ Time: 15ms
+   └─ Error: Missing auth token
+
+   Summary: 3/4 passed (75%)
+   ```
+
+For `pa:curl`:
+1. Analyze API routes and generate curl commands:
+   ```
+   Generated Curl Commands
+   ═══════════════════════
+
+   # List users
+   curl -X GET http://localhost:3000/api/users \
+     -H "Content-Type: application/json" \
+     -H "Authorization: Bearer $TOKEN"
+
+   # Create user
+   curl -X POST http://localhost:3000/api/users \
+     -H "Content-Type: application/json" \
+     -H "Authorization: Bearer $TOKEN" \
+     -d '{"name": "John", "email": "john@example.com"}'
+
+   # Get user by ID
+   curl -X GET http://localhost:3000/api/users/123 \
+     -H "Authorization: Bearer $TOKEN"
+
+   Saved to: ./docs/curl-commands.sh
+   ```
+
+For `pa:postman`:
+1. Scan API routes and extract endpoints
+2. Generate Postman collection:
+   ```
+   Postman Collection Generated
+   ════════════════════════════
+
+   Collection: my-app API
+   Endpoints: 15
+
+   Folders:
+   ├─ Auth (3 endpoints)
+   │  ├─ POST /api/auth/login
+   │  ├─ POST /api/auth/register
+   │  └─ POST /api/auth/logout
+   ├─ Users (5 endpoints)
+   │  ├─ GET /api/users
+   │  ├─ POST /api/users
+   │  ├─ GET /api/users/:id
+   │  ├─ PUT /api/users/:id
+   │  └─ DELETE /api/users/:id
+   └─ Posts (7 endpoints)
+      └─ ...
+
+   Saved to: ./docs/postman-collection.json
+
+   Import: File > Import in Postman
+   ```
+
+### Health & Monitoring
+| Command | Action |
+|---------|--------|
+| `pa:health` | Project health check |
+| `pa:health-full` | Comprehensive health report |
+| `pa:monitor` | Show monitoring status |
+| `pa:monitor "service"` | Monitor specific service |
+| `pa:uptime` | Service uptime check |
+
+**How to execute Health & Monitoring commands:**
+
+For `pa:health`:
+1. Check various project health indicators:
+   ```
+   Project Health Check
+   ════════════════════
+
+   Overall: 85% Healthy ████████░░
+
+   Code Quality:
+   ✓ Linting: No errors
+   ✓ Type checking: No errors
+   ⚠ Test coverage: 72% (target: 80%)
+   ✓ No security vulnerabilities
+
+   Dependencies:
+   ✓ All dependencies installed
+   ⚠ 3 outdated packages
+   ✓ No security advisories
+
+   Configuration:
+   ✓ Environment variables set
+   ✓ Config files valid
+   ⚠ Missing .env.example
+
+   Git Status:
+   ✓ Clean working directory
+   ✓ Up to date with remote
+   ✓ No merge conflicts
+
+   Performance:
+   ✓ Bundle size: 245KB (limit: 500KB)
+   ✓ Build time: 12s
+   ⚠ Lighthouse score: 78 (target: 90)
+
+   Issues Found: 4
+   • Test coverage below 80%
+   • 3 outdated packages
+   • Missing .env.example
+   • Lighthouse score below target
+   ```
+
+For `pa:monitor`:
+1. Check running services and status:
+   ```
+   Service Monitor
+   ═══════════════
+
+   Services:
+   ┌────────────────┬──────────┬─────────┬────────────┐
+   │ Service        │ Status   │ Uptime  │ Health     │
+   ├────────────────┼──────────┼─────────┼────────────┤
+   │ App (Next.js)  │ Running  │ 2h 15m  │ Healthy    │
+   │ Database       │ Running  │ 5d 3h   │ Healthy    │
+   │ Redis Cache    │ Running  │ 5d 3h   │ Healthy    │
+   │ Worker         │ Stopped  │ -       │ ⚠ Down     │
+   └────────────────┴──────────┴─────────┴────────────┘
+
+   Recent Events:
+   • 10:30 - App restarted (deployment)
+   • 09:15 - Worker stopped (manual)
+   • Yesterday - Database backup completed
+
+   Alerts:
+   ⚠ Worker service is not running
+   ```
+
+For `pa:uptime`:
+1. Check endpoint availability:
+   ```
+   Uptime Check
+   ════════════
+
+   Checking endpoints...
+
+   Production (https://myapp.com):
+   ├─ / (homepage): 200 OK (125ms) ✓
+   ├─ /api/health: 200 OK (45ms) ✓
+   ├─ /api/users: 200 OK (89ms) ✓
+   └─ /dashboard: 200 OK (156ms) ✓
+
+   Staging (https://staging.myapp.com):
+   ├─ / (homepage): 200 OK (145ms) ✓
+   └─ /api/health: 200 OK (52ms) ✓
+
+   All endpoints responding ✓
+   Average response time: 102ms
+   ```
+
+### Quick Actions
+| Command | Action |
+|---------|--------|
+| `pa:quick` | Show quick actions menu |
+| `pa:quick "action"` | Execute quick action |
+| `pa:alias` | Manage command aliases |
+| `pa:alias-add "name" "command"` | Add new alias |
+| `pa:alias-remove "name"` | Remove alias |
+
+**How to execute Quick Actions commands:**
+
+For `pa:quick`:
+1. Show context-aware quick actions:
+   ```
+   Quick Actions
+   ═════════════
+
+   Based on current context (feature/user-auth):
+
+   Development:
+   [1] Run tests for current feature
+   [2] Check code coverage
+   [3] Lint and fix
+
+   Git:
+   [4] Commit all changes
+   [5] Push to remote
+   [6] Create PR
+
+   Quality:
+   [7] Run full QA check
+   [8] Security scan
+   [9] Performance audit
+
+   Documentation:
+   [10] Update docs for changes
+
+   Select action (1-10) or type command:
+   > 6
+
+   Creating PR...
+   ```
+
+For `pa:alias`:
+1. List and manage command aliases:
+   ```
+   Command Aliases
+   ═══════════════
+
+   Current Aliases:
+   ┌──────────┬───────────────────────────┐
+   │ Alias    │ Command                   │
+   ├──────────┼───────────────────────────┤
+   │ pa:c     │ pa:commit                 │
+   │ pa:pr    │ pa:github-pr              │
+   │ pa:cov   │ pa:coverage               │
+   │ pa:sec   │ pa:security-scan          │
+   │ pa:up    │ pa:deps-outdated          │
+   └──────────┴───────────────────────────┘
+
+   Add alias: pa:alias-add "name" "command"
+   Remove: pa:alias-remove "name"
+
+   Built-in aliases cannot be modified:
+   pa:f, pa:s, pa:h, pa:d, pa:t, pa:q, pa:a, pa:r, pa:p, pa:i
+   ```
+
+For `pa:alias-add`:
+1. Add custom alias:
+   ```
+   Adding Alias
+   ════════════
+
+   Alias: pa:ship
+   Command: pa:test && pa:build && pa:deploy
+
+   ✓ Alias created!
+
+   Usage: pa:ship
+   Runs: pa:test && pa:build && pa:deploy
+   ```
+
+### Mobile Test Suite (React Native / Mobile Apps)
+| Command | Action |
+|---------|--------|
+| `pa:test-mobile` | Run full mobile test suite |
+| `pa:test-mobile "feature"` | Test specific feature |
+| `pa:test-visual` | Visual/design comparison testing |
+| `pa:test-auto-fix` | Auto-fix failing tests |
+| `pa:test-loop` | Test → Fix → Retest loop until success |
+| `pa:compare-figma` | Compare UI against Figma design |
+| `pa:compare-image "path"` | Compare UI against image/sketch |
+| `pa:screenshot` | Take app screenshots for comparison |
+
+**How to execute Mobile Test Suite commands:**
+
+For `pa:test-mobile`:
+1. Run comprehensive mobile test suite:
+   ```
+   Mobile Test Suite
+   ═════════════════
+
+   Running full test suite for: feature/user-auth
+
+   Phase 1: Unit Tests
+   ───────────────────
+   ✓ AuthService.login() - 5 tests passed
+   ✓ AuthService.logout() - 3 tests passed
+   ✓ TokenManager - 8 tests passed
+   ✓ UserStore - 12 tests passed
+
+   Phase 2: Component Tests
+   ────────────────────────
+   ✓ LoginScreen - renders correctly
+   ✓ LoginScreen - validates email format
+   ✓ LoginScreen - shows error on invalid credentials
+   ✓ SignupScreen - all fields required
+   ✓ ProfileScreen - displays user data
+
+   Phase 3: Integration Tests
+   ──────────────────────────
+   ✓ Login flow end-to-end
+   ✓ Token refresh on expiry
+   ✓ Logout clears all data
+   ✗ FAILED: Password reset flow
+     → Error: Reset email not sent
+
+   Phase 4: E2E Tests (Maestro/Detox)
+   ──────────────────────────────────
+   ✓ User can login with valid credentials
+   ✓ User sees error with invalid password
+   ✗ FAILED: User can reset password
+     → Button not found: "Send Reset Email"
+
+   Phase 5: Visual Tests
+   ─────────────────────
+   ✓ LoginScreen matches design
+   ✗ FAILED: SignupScreen has visual differences
+     → Button color: expected #007AFF, got #0066CC
+     → Font size: expected 16px, got 14px
+
+   ══════════════════════════════════════════
+   RESULTS: 35/38 tests passed (3 failed)
+   ══════════════════════════════════════════
+
+   Failed Tests:
+   1. Integration: Password reset flow
+   2. E2E: User can reset password
+   3. Visual: SignupScreen design mismatch
+
+   Run `pa:test-auto-fix` to automatically fix these issues.
+   ```
+
+2. Generate detailed test report at `./proagents/test-reports/mobile-{timestamp}.md`
+
+For `pa:test-visual`:
+1. Take screenshots of all screens/components
+2. Compare against design references:
+   ```
+   Visual Design Testing
+   ═════════════════════
+
+   Comparing app UI against design references...
+
+   Design Source: ./designs/ (Figma exports)
+
+   Screen: LoginScreen
+   ───────────────────
+   ✓ Layout matches design
+   ✓ Colors match design tokens
+   ✓ Typography correct
+   ✓ Spacing/padding correct
+   ✓ Button styles match
+
+   Screen: SignupScreen
+   ────────────────────
+   ✗ MISMATCH DETECTED
+
+   Differences found:
+   ┌─────────────────┬──────────────┬──────────────┐
+   │ Element         │ Expected     │ Actual       │
+   ├─────────────────┼──────────────┼──────────────┤
+   │ Submit Button   │ #007AFF      │ #0066CC      │
+   │ Title Font      │ 24px Bold    │ 22px Regular │
+   │ Input Height    │ 48px         │ 44px         │
+   │ Bottom Margin   │ 16px         │ 12px         │
+   └─────────────────┴──────────────┴──────────────┘
+
+   Screenshot saved: ./proagents/test-reports/visual/signup-diff.png
+
+   Screen: ProfileScreen
+   ─────────────────────
+   ✓ All elements match design
+
+   ══════════════════════════════════════════
+   VISUAL TEST RESULTS: 2/3 screens passed
+   ══════════════════════════════════════════
+
+   Run `pa:test-auto-fix` to fix visual issues automatically.
+   ```
+
+For `pa:test-auto-fix`:
+1. Analyze failing tests
+2. Identify root cause
+3. Generate and apply fixes:
+   ```
+   Auto-Fix Mode
+   ═════════════
+
+   Analyzing 3 failing tests...
+
+   Fix 1: Password reset flow
+   ──────────────────────────
+   Root Cause: API endpoint missing in AuthService
+
+   Applying fix to: src/services/AuthService.ts
+   + async resetPassword(email: string): Promise<void> {
+   +   const response = await api.post('/auth/reset-password', { email });
+   +   if (!response.ok) throw new Error('Reset failed');
+   + }
+
+   ✓ Fix applied
+
+   Fix 2: Reset button not found
+   ─────────────────────────────
+   Root Cause: Button testID missing
+
+   Applying fix to: src/screens/ResetPasswordScreen.tsx
+   - <Button title="Send Reset Email" onPress={handleReset} />
+   + <Button
+   +   testID="send-reset-email-button"
+   +   title="Send Reset Email"
+   +   onPress={handleReset}
+   + />
+
+   ✓ Fix applied
+
+   Fix 3: SignupScreen visual mismatch
+   ────────────────────────────────────
+   Root Cause: Style values don't match design tokens
+
+   Applying fix to: src/screens/SignupScreen.styles.ts
+   - submitButton: { backgroundColor: '#0066CC' }
+   + submitButton: { backgroundColor: '#007AFF' }
+
+   - title: { fontSize: 22, fontWeight: 'normal' }
+   + title: { fontSize: 24, fontWeight: 'bold' }
+
+   - input: { height: 44, marginBottom: 12 }
+   + input: { height: 48, marginBottom: 16 }
+
+   ✓ Fix applied
+
+   ══════════════════════════════════════════
+   AUTO-FIX COMPLETE: 3/3 issues fixed
+   ══════════════════════════════════════════
+
+   Running verification tests...
+   ```
+
+For `pa:test-loop`:
+1. Run complete Test → Fix → Retest cycle:
+   ```
+   Test Loop Mode
+   ══════════════
+
+   Starting automated test-fix-retest cycle...
+   Max iterations: 5
+
+   ┌─────────────────────────────────────────────────────┐
+   │ ITERATION 1                                         │
+   ├─────────────────────────────────────────────────────┤
+   │ Running tests...                                    │
+   │ Results: 35/38 passed (3 failed)                   │
+   │                                                     │
+   │ Analyzing failures...                               │
+   │ Applying auto-fixes...                              │
+   │ Fixes applied: 3                                    │
+   └─────────────────────────────────────────────────────┘
+
+   ┌─────────────────────────────────────────────────────┐
+   │ ITERATION 2                                         │
+   ├─────────────────────────────────────────────────────┤
+   │ Running tests...                                    │
+   │ Results: 37/38 passed (1 failed)                   │
+   │                                                     │
+   │ Analyzing failures...                               │
+   │ New issue: TypeScript type error after fix         │
+   │ Applying auto-fixes...                              │
+   │ Fixes applied: 1                                    │
+   └─────────────────────────────────────────────────────┘
+
+   ┌─────────────────────────────────────────────────────┐
+   │ ITERATION 3                                         │
+   ├─────────────────────────────────────────────────────┤
+   │ Running tests...                                    │
+   │ Results: 38/38 passed (0 failed)                   │
+   │                                                     │
+   │ ✓ ALL TESTS PASSING!                               │
+   └─────────────────────────────────────────────────────┘
+
+   ══════════════════════════════════════════════════════
+   TEST LOOP COMPLETE
+   ══════════════════════════════════════════════════════
+
+   Summary:
+   ────────
+   Iterations: 3
+   Initial failures: 3
+   Fixes applied: 4
+   Final status: ALL PASSING ✓
+
+   Files modified:
+   • src/services/AuthService.ts
+   • src/screens/ResetPasswordScreen.tsx
+   • src/screens/SignupScreen.styles.ts
+   • src/types/auth.ts
+
+   Test report: ./proagents/test-reports/test-loop-{timestamp}.md
+
+   Ready for commit? (y/n)
+   ```
+
+For `pa:compare-figma`:
+1. Connect to Figma API or use exported frames
+2. Extract design specifications
+3. Compare with actual app:
+   ```
+   Figma Design Comparison
+   ═══════════════════════
+
+   Design Source: [Figma Link or ./designs/figma-export/]
+
+   Extracting design tokens from Figma...
+   ✓ Colors extracted
+   ✓ Typography extracted
+   ✓ Spacing system extracted
+   ✓ Component specs extracted
+
+   Comparing: LoginScreen
+   ──────────────────────
+
+   Layout Comparison:
+   ┌────────────────────┬────────────────────┐
+   │   Figma Design     │   App Screenshot   │
+   │   ┌──────────┐     │   ┌──────────┐     │
+   │   │  Logo    │     │   │  Logo    │ ✓   │
+   │   ├──────────┤     │   ├──────────┤     │
+   │   │  Email   │     │   │  Email   │ ✓   │
+   │   │  Input   │     │   │  Input   │     │
+   │   ├──────────┤     │   ├──────────┤     │
+   │   │ Password │     │   │ Password │ ✓   │
+   │   │  Input   │     │   │  Input   │     │
+   │   ├──────────┤     │   ├──────────┤     │
+   │   │  Login   │     │   │  Login   │ ✗   │
+   │   │  Button  │     │   │  Button  │     │
+   │   └──────────┘     │   └──────────┘     │
+   └────────────────────┴────────────────────┘
+
+   Detailed Comparison:
+   ┌───────────────┬─────────────┬─────────────┬────────┐
+   │ Element       │ Figma       │ App         │ Status │
+   ├───────────────┼─────────────┼─────────────┼────────┤
+   │ Logo Size     │ 120x40      │ 120x40      │ ✓      │
+   │ Input Height  │ 48px        │ 48px        │ ✓      │
+   │ Input Border  │ 1px #E0E0E0 │ 1px #E0E0E0 │ ✓      │
+   │ Button Color  │ #007AFF     │ #0056B3     │ ✗      │
+   │ Button Radius │ 8px         │ 4px         │ ✗      │
+   │ Button Height │ 52px        │ 48px        │ ✗      │
+   │ Vertical Gap  │ 16px        │ 12px        │ ✗      │
+   └───────────────┴─────────────┴─────────────┴────────┘
+
+   Issues Found: 4
+
+   Auto-fix available? Yes
+   Run `pa:test-auto-fix` to apply design corrections.
+   ```
+
+For `pa:compare-image "path"`:
+1. Load reference image (sketch, screenshot, mockup)
+2. Use visual comparison:
+   ```
+   Image Comparison
+   ════════════════
+
+   Reference: ./designs/sketch-login.png
+   App Screen: LoginScreen
+
+   Analyzing reference image...
+   ✓ Detected UI elements
+   ✓ Extracted layout structure
+   ✓ Identified colors and typography
+
+   Taking app screenshot...
+   ✓ Screenshot captured
+
+   Visual Diff Analysis:
+   ─────────────────────
+
+   Overall Match: 87%
+
+   Differences Detected:
+
+   1. Header Section (Region: 0,0 to 375,100)
+      • Logo position: slightly lower than reference
+      • Background: matches ✓
+
+   2. Form Section (Region: 0,100 to 375,350)
+      • Input fields: match ✓
+      • Labels: font slightly smaller
+      • Spacing: compressed by ~4px
+
+   3. Button Section (Region: 0,350 to 375,450)
+      • Color: differs by 15% (darker in app)
+      • Corner radius: sharper in app
+      • Shadow: missing in app
+
+   Diff image saved: ./proagents/test-reports/visual/login-diff-overlay.png
+
+   ┌─────────────────────────────────────────────┐
+   │ [Reference]        │ [App]        │ [Diff] │
+   │ Expected design    │ Actual app   │ Δ      │
+   └─────────────────────────────────────────────┘
+
+   Suggested fixes generated.
+   Run `pa:test-auto-fix` to apply.
+   ```
+
+For `pa:screenshot`:
+1. Capture screenshots of all app screens:
+   ```
+   Screenshot Capture
+   ══════════════════
+
+   Detecting available screens...
+
+   Found 12 screens in navigation:
+
+   Capturing screenshots...
+
+   ✓ LoginScreen → ./proagents/screenshots/LoginScreen.png
+   ✓ SignupScreen → ./proagents/screenshots/SignupScreen.png
+   ✓ HomeScreen → ./proagents/screenshots/HomeScreen.png
+   ✓ ProfileScreen → ./proagents/screenshots/ProfileScreen.png
+   ✓ SettingsScreen → ./proagents/screenshots/SettingsScreen.png
+   ✓ NotificationsScreen → ./proagents/screenshots/NotificationsScreen.png
+   ... (6 more)
+
+   Component screenshots:
+   ✓ Button variants → ./proagents/screenshots/components/Button.png
+   ✓ Input variants → ./proagents/screenshots/components/Input.png
+   ✓ Card variants → ./proagents/screenshots/components/Card.png
+
+   ══════════════════════════════════════════
+   Screenshots saved: 15 images
+   Location: ./proagents/screenshots/
+   ══════════════════════════════════════════
+
+   Use these for:
+   • Visual regression testing
+   • Design comparison with `pa:compare-image`
+   • Documentation
+   ```
+
+**Mobile Test Configuration:**
+Add to `proagents.config.yaml`:
+```yaml
+mobile_testing:
+  platform: react-native  # or flutter, native
+
+  test_frameworks:
+    unit: jest
+    component: "@testing-library/react-native"
+    e2e: maestro  # or detox, appium
+
+  visual_testing:
+    enabled: true
+    design_source: figma  # or ./designs/
+    figma_file_id: "your-figma-file-id"  # if using Figma
+    threshold: 0.95  # 95% match required
+
+  auto_fix:
+    enabled: true
+    max_iterations: 5
+    require_approval: false  # true = ask before applying fixes
+
+  screenshot:
+    output_dir: ./proagents/screenshots
+    devices:
+      - iPhone 14 Pro
+      - Pixel 7
+
+  test_on:
+    feature_complete: true  # auto-run tests when feature done
+    bug_fix: true  # auto-run tests after bug fix
+    pre_commit: false  # run before git commit
+```
+
+**Test Report Structure:**
+```
+./proagents/test-reports/
+├── mobile-2024-03-06-1500.md      # Full test report
+├── visual/
+│   ├── LoginScreen-diff.png       # Visual diff images
+│   ├── SignupScreen-diff.png
+│   └── comparison-report.md
+├── coverage/
+│   └── coverage-report.html       # Test coverage
+└── auto-fix-log.md                # Log of all auto-fixes
+```
+
 ### AI Platform Management
 | Command | Action |
 |---------|--------|

package/proagents/PROAGENTS.md

@@ -216,6 +216,60 @@ Execute these commands when user types them (prefix: `pa:`):
 | `pa:tag` | Create git tag for release |
 | `pa:publish` | Publish package to registry |
 
+## Code Review & PR
+
+| Command | What to Do |
+|---------|------------|
+| `pa:review-request` | Request code review from team |
+| `pa:review-comments` | Show PR review comments |
+| `pa:review-approve` | Approve current PR |
+
+## Architecture
+
+| Command | What to Do |
+|---------|------------|
+| `pa:architecture` | Show architecture overview |
+| `pa:architecture-diagram` | Generate architecture diagram (Mermaid) |
+| `pa:architecture-export` | Export diagram (SVG/PNG) |
+
+## API Testing
+
+| Command | What to Do |
+|---------|------------|
+| `pa:api-test` | Test API endpoints |
+| `pa:curl` | Generate curl commands for endpoints |
+| `pa:postman` | Generate Postman collection |
+
+## Health & Monitoring
+
+| Command | What to Do |
+|---------|------------|
+| `pa:health` | Project health check |
+| `pa:monitor` | Show monitoring status |
+| `pa:uptime` | Service uptime check |
+
+## Quick Actions
+
+| Command | What to Do |
+|---------|------------|
+| `pa:quick` | Show quick actions menu |
+| `pa:alias` | Manage command aliases |
+| `pa:alias-add` | Add custom alias |
+| `pa:alias-remove` | Remove custom alias |
+
+## Mobile Test Suite (React Native)
+
+| Command | What to Do |
+|---------|------------|
+| `pa:test-mobile` | Run full mobile test suite (unit, component, E2E, visual) |
+| `pa:test-mobile "feature"` | Test specific feature only |
+| `pa:test-visual` | Visual/design comparison testing |
+| `pa:test-auto-fix` | Auto-fix failing tests |
+| `pa:test-loop` | Test → Fix → Retest loop until all pass |
+| `pa:compare-figma` | Compare UI against Figma design |
+| `pa:compare-image "path"` | Compare UI against image/sketch |
+| `pa:screenshot` | Take app screenshots for comparison |
+
 ## Key Files to Read
 
 | File | Purpose |