proagents 1.6.9 → 1.6.11

package/.proagents/docs/testing.md

@@ -0,0 +1,241 @@
+# ProAgents Testing Configuration
+
+## Test Commands
+
+| Command | Action |
+|---------|--------|
+| `pa:test` | Run all tests |
+| `pa:test-unit` | Unit tests only |
+| `pa:test-integration` | Integration tests |
+| `pa:test-e2e` | End-to-end tests |
+| `pa:test-coverage` | Run with coverage report |
+| `pa:test-watch` | Watch mode |
+| `pa:test-file "path"` | Test specific file |
+| `pa:test-failed` | Re-run failed tests |
+
+## Configuration
+
+Tests are configured in `proagents.config.yaml`:
+
+```yaml
+testing:
+  coverage_targets:
+    unit: 80
+    integration: 60
+    e2e: critical_flows
+  parallel: true
+  max_workers: 4
+
+  tools:
+    unit:
+      command: "npm test"
+      framework: "jest"
+    integration:
+      command: "npm run test:integration"
+      framework: "jest"
+    e2e:
+      command: "npx playwright test"
+      framework: "playwright"
+    visual:
+      command: "npx percy exec -- npm test"
+      framework: "percy"
+    load:
+      command: "k6 run loadtest.js"
+      framework: "k6"
+    security:
+      command: "npm audit && snyk test"
+      framework: "snyk"
+```
+
+## Mobile Testing
+
+```yaml
+testing:
+  mobile:
+    react_native:
+      unit:
+        command: "npm test"
+        framework: "jest"
+      component:
+        command: "npm test -- --testPathPattern=components"
+        framework: "@testing-library/react-native"
+      e2e:
+        command: "maestro test .maestro/"
+        framework: "maestro"
+
+    android:
+      unit:
+        command: "./gradlew test"
+        framework: "junit"
+      integration:
+        command: "./gradlew connectedAndroidTest"
+        framework: "espresso"
+      e2e:
+        command: "maestro test .maestro/"
+        framework: "maestro"
+
+    ios:
+      unit:
+        command: "xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15'"
+        framework: "xctest"
+      e2e:
+        command: "maestro test .maestro/"
+        framework: "maestro"
+
+    flutter:
+      unit:
+        command: "flutter test"
+        framework: "flutter_test"
+      integration:
+        command: "flutter test integration_test/"
+        framework: "integration_test"
+      e2e:
+        command: "maestro test .maestro/"
+        framework: "maestro"
+```
+
+## pa:test-mobile - Full Mobile Testing
+
+**CRITICAL: AI must SET UP testing if not configured, not tell user to test manually!**
+
+### When E2E Not Configured - AI Must Install:
+
+```bash
+# 1. Check if Maestro installed
+maestro --version 2>/dev/null || {
+  echo "Installing Maestro..."
+  curl -Ls "https://get.maestro.mobile.dev" | bash
+}
+
+# 2. Create .maestro folder if missing
+mkdir -p .maestro
+
+# 3. Create sample test flow
+cat > .maestro/login-flow.yaml << 'EOF'
+appId: com.yourapp
+---
+- launchApp
+- tapOn: "Login"
+- inputText:
+    id: "email"
+    text: "test@example.com"
+- inputText:
+    id: "password"
+    text: "password123"
+- tapOn: "Submit"
+- assertVisible: "Welcome"
+EOF
+
+# 4. Run tests
+maestro test .maestro/
+```
+
+### AI Workflow for pa:test-mobile:
+
+1. **Check what's configured:**
+   ```bash
+   ls .maestro/ 2>/dev/null || echo "No Maestro tests"
+   ls e2e/ 2>/dev/null || echo "No Detox tests"
+   ```
+
+2. **If nothing configured - SET IT UP:**
+   - Install Maestro (easier) or Detox
+   - Create test flows for the feature being tested
+   - Run the tests
+
+3. **If configured - RUN tests:**
+   ```bash
+   maestro test .maestro/
+   # OR
+   npx detox test
+   ```
+
+4. **Report results:**
+   ```
+   Mobile Test Results
+   ═══════════════════
+   ✓ login-flow.yaml - PASSED (3.2s)
+   ✓ signup-flow.yaml - PASSED (4.1s)
+   ✗ checkout-flow.yaml - FAILED
+     Error: Element "Submit" not found
+   ```
+
+### WRONG Behavior:
+```
+"E2E not configured. Please test manually:
+- Open app
+- Click login
+- ..."
+```
+
+### CORRECT Behavior:
+```
+E2E not configured. Setting up Maestro...
+
+Installing Maestro... ✓
+Creating test flows for login feature...
+Created: .maestro/login-flow.yaml
+
+Running tests...
+✓ login-flow.yaml - PASSED
+
+All tests passed!
+```
+
+---
+
+## How pa:test Works
+
+1. **Read config** from `proagents.config.yaml`
+2. **Detect test type** from command (unit, e2e, etc.)
+3. **If not configured - SET IT UP** (install tools, create tests)
+4. **Run appropriate command** from config
+5. **Parse results** based on framework
+6. **Report summary**:
+   ```
+   Test Results
+   ════════════
+   ✓ 45 passed
+   ✗ 2 failed
+   ○ 3 skipped
+
+   Coverage: 82%
+
+   Failed:
+   • src/auth/login.test.ts - Expected true, got false
+   • src/api/user.test.ts - Timeout
+   ```
+
+## Custom Test Commands
+
+Add custom commands in config:
+
+```yaml
+testing:
+  custom_commands:
+    test:quick: "npm test -- --onlyChanged"
+    test:ci: "npm test -- --coverage --ci"
+    test:debug: "npm test -- --runInBand --detectOpenHandles"
+```
+
+Use with: `pa:test-quick`, `pa:test-ci`, `pa:test-debug`
+
+## Framework Detection
+
+If no config exists, detect from:
+
+1. `package.json` - scripts.test, devDependencies
+2. Config files - `jest.config.js`, `vitest.config.ts`, `playwright.config.ts`
+3. Common patterns in codebase
+
+## Coverage Requirements
+
+```yaml
+testing:
+  coverage_targets:
+    unit: 80        # Minimum 80% for unit tests
+    integration: 60 # Minimum 60% for integration
+    e2e: critical_flows  # Cover critical user flows
+```
+
+If coverage drops below target, warn user.

package/.proagents/prompts/06-testing.md

@@ -4,6 +4,57 @@ Universal prompts for comprehensive testing phase.
 
 ---
 
+## CRITICAL: Auto-Install Missing Tools
+
+**AI must NEVER say "not configured, test manually". Instead:**
+
+1. **Check if tool exists**
+2. **If missing → INSTALL IT**
+3. **Create test files if needed**
+4. **Run the tests**
+
+### Auto-Install Commands:
+
+```bash
+# Maestro (Mobile E2E)
+maestro --version 2>/dev/null || curl -Ls "https://get.maestro.mobile.dev" | bash
+
+# Detox (React Native E2E)
+npx detox --version 2>/dev/null || npm install -D detox
+
+# Jest
+npx jest --version 2>/dev/null || npm install -D jest
+
+# Playwright (Web E2E)
+npx playwright --version 2>/dev/null || npm install -D @playwright/test
+
+# React Testing Library
+npm list @testing-library/react 2>/dev/null || npm install -D @testing-library/react
+```
+
+### WRONG Behavior:
+```
+"E2E tests not configured. Please test manually:
+- Open app
+- Click login..."
+```
+
+### CORRECT Behavior:
+```
+E2E not configured. Installing Maestro...
+✓ Maestro installed
+
+Creating test flow for login feature...
+✓ Created .maestro/login-flow.yaml
+
+Running E2E tests...
+✓ login-flow.yaml - PASSED (2.3s)
+
+All E2E tests passed!
+```
+
+---
+
 ## Quick Start
 
 ```
@@ -15,6 +66,7 @@ Related commands:
 - `pa:test-integration` - Run integration tests
 - `pa:test-e2e` - Run end-to-end tests
 - `pa:test-all` - Run all tests
+- `pa:test-mobile` - Full mobile test suite (auto-installs tools)
 
 ---
 
@@ -320,6 +372,126 @@ Priority: Test these before any release
 
 ---
 
+## Mobile E2E Testing (pa:test-mobile)
+
+**AI MUST auto-install tools and create tests. NEVER say "test manually".**
+
+### Step 1: Check & Install Tools
+
+```bash
+# AI runs these commands:
+
+# Check Maestro
+if ! maestro --version 2>/dev/null; then
+  echo "Installing Maestro..."
+  curl -Ls "https://get.maestro.mobile.dev" | bash
+  export PATH="$PATH:$HOME/.maestro/bin"
+fi
+
+# Verify installation
+maestro --version
+```
+
+### Step 2: Create Test Flows
+
+If `.maestro/` folder doesn't exist or is empty:
+
+```bash
+mkdir -p .maestro
+
+# AI creates test flow based on feature being tested
+cat > .maestro/feature-flow.yaml << 'EOF'
+appId: com.yourapp
+---
+- launchApp
+- tapOn: "Login"
+- inputText:
+    id: "email"
+    text: "test@example.com"
+- tapOn: "Submit"
+- assertVisible: "Welcome"
+EOF
+```
+
+### Step 3: Run Tests
+
+```bash
+# Run all Maestro tests
+maestro test .maestro/
+
+# Run specific flow
+maestro test .maestro/login-flow.yaml
+```
+
+### Step 4: Report Results
+
+```
+Mobile E2E Results
+══════════════════
+✓ login-flow.yaml - PASSED (3.2s)
+✓ signup-flow.yaml - PASSED (4.5s)
+✗ checkout-flow.yaml - FAILED
+  Error: Element "Pay Now" not found at line 12
+
+2/3 tests passed
+```
+
+### Maestro Flow Examples
+
+**Login Flow:**
+```yaml
+appId: com.myapp
+---
+- launchApp
+- tapOn: "Log In"
+- inputText:
+    id: "email"
+    text: "user@test.com"
+- inputText:
+    id: "password"
+    text: "password123"
+- tapOn: "Submit"
+- assertVisible: "Dashboard"
+```
+
+**Form Submission:**
+```yaml
+appId: com.myapp
+---
+- launchApp
+- tapOn: "New Form"
+- inputText:
+    id: "title"
+    text: "Test Entry"
+- tapOn: "Save"
+- assertVisible: "Saved successfully"
+```
+
+### If Maestro Fails, Try Detox
+
+```bash
+# Install Detox
+npm install -D detox
+npx detox init
+
+# Create test
+cat > e2e/login.test.js << 'EOF'
+describe('Login', () => {
+  it('should login successfully', async () => {
+    await element(by.id('email')).typeText('test@example.com');
+    await element(by.id('password')).typeText('password');
+    await element(by.text('Login')).tap();
+    await expect(element(by.text('Welcome'))).toBeVisible();
+  });
+});
+EOF
+
+# Run
+npx detox test
+```
+
+---
+
 ## Test Data & Mocking
 
 ### Generate Test Fixtures

package/.proagents/prompts/07-documentation.md

@@ -4,6 +4,68 @@ Universal prompts for creating comprehensive documentation.
 
 ---
 
+## CRITICAL: AI Must Generate Doc Files
+
+**AI must NEVER just show "documentation options" or templates. Instead:**
+
+1. **Analyze** the code/module/feature
+2. **Generate** documentation content
+3. **CREATE** the actual doc files
+4. **Report** what was created
+
+### WRONG Behavior:
+```
+"Here are the documentation options:
+- pa:doc-full for complete docs
+- pa:doc-lite for quick reference
+..."
+```
+
+### CORRECT Behavior:
+```
+Analyzing codebase for documentation...
+✓ Found 12 modules, 45 components, 23 utilities
+
+Generating documentation...
+✓ Created ./docs/README.md
+✓ Created ./docs/api/index.md
+✓ Created ./docs/components/Button.md
+✓ Created ./docs/modules/auth.md
+...
+
+Documentation generated: 15 files in ./docs/
+```
+
+### AI Workflow for pa:doc:
+
+```bash
+# 1. Create docs directory if missing
+mkdir -p docs docs/api docs/modules docs/components
+
+# 2. Analyze codebase
+# AI reads source files and understands structure
+
+# 3. Generate and CREATE doc files
+# AI writes actual markdown files to ./docs/
+
+# 4. Report summary
+echo "Documentation generated: X files"
+```
+
+### Command-Specific Actions:
+
+| Command | AI Action |
+|---------|-----------|
+| `pa:doc` | Create full project documentation in `./docs/` |
+| `pa:doc-module auth` | Create `./docs/modules/auth.md` |
+| `pa:doc-file src/api.ts` | Create `./docs/api/api.md` |
+| `pa:doc-api` | Create API docs in `./docs/api/` |
+| `pa:doc-readme` | Update `./README.md` |
+| `pa:changelog` | Update `./CHANGELOG.md` |
+| `pa:release` | Create `./RELEASE_NOTES.md` |
+
+---
+
 ## Quick Start
 
 ```
@@ -778,6 +840,110 @@ MAINTENANCE:
 
 ---
 
+## Enhanced Changelog System (Cross-AI Continuity)
+
+**AI must update multiple changelog files for cross-AI continuity.**
+
+### pa:changelog Workflow:
+
+```bash
+# 1. Update root CHANGELOG.md
+# 2. Update .proagents/changelog/_recent.md (prepend)
+# 3. Update feature changelog if applicable
+# 4. Update module changelog based on files changed
+```
+
+### Changelog Locations:
+
+| File | Purpose | Updated When |
+|------|---------|--------------|
+| `./CHANGELOG.md` | Public changelog | Major changes |
+| `.proagents/changelog/_recent.md` | Last 10 changes | Every change |
+| `.proagents/changelog/features/[name].md` | Feature history | Working on feature |
+| `.proagents/changelog/modules/[name].md` | Module history | Modifying module |
+
+### Feature Changelog Format:
+
+Create `.proagents/changelog/features/[feature-name].md`:
+
+```markdown
+# Feature: [Feature Name]
+
+Created: YYYY-MM-DD
+Status: active | completed | paused
+Branch: feature/[name]
+
+---
+
+## Changelog
+
+### YYYY-MM-DD - [AI Platform]
+**Phase:** implementation | testing | review
+**Changes:**
+- Change 1
+- Change 2
+**Files:**
+- src/path/file.ts (+50, -10)
+- src/path/other.ts (new)
+**Decisions:**
+- Decision and reason
+**Next:** What comes next
+
+---
+```
+
+### Module Changelog Format:
+
+Create `.proagents/changelog/modules/[module].md`:
+
+```markdown
+# Module: [Module Name]
+
+Path: src/[module]/
+Type: api | service | component | utility
+
+---
+
+## Changelog
+
+### YYYY-MM-DD - [AI Platform]
+**Context:** [Feature or Fix name]
+**Changes:**
+- Change description
+**Files:**
+- file.ts (+lines, -lines)
+
+---
+```
+
+### Module Auto-Detection:
+
+AI detects module from file path:
+- `src/api/*`, `routes/*` → `modules/api.md`
+- `src/auth/*` → `modules/auth.md`
+- `src/components/*` → `modules/ui.md`
+- `src/services/*` → `modules/services.md`
+- `src/utils/*`, `lib/*` → `modules/utils.md`
+- `tests/*` → `modules/tests.md`
+
+### _recent.md Format:
+
+Prepend to `.proagents/changelog/_recent.md`:
+
+```markdown
+### YYYY-MM-DD - [Change Type]
+**Feature/Module:** name
+**AI:** Platform (model)
+**Files:** file1.ts, file2.ts
+**Summary:** Brief description of change
+
+---
+```
+
+Keep only last 10 entries (remove oldest when adding new).
+
+---
+
 ## Commands Reference
 
 | Command | Description | Output Location |