proagents 1.6.12 → 1.6.15

package/.proagents/docs/command-details.md

@@ -4,6 +4,28 @@ Detailed execution instructions for all `pa:` commands.
 
 ---
 
+## ⚠️ MANDATORY: Auto-Sync on EVERY pa: Command
+
+**BEFORE executing ANY `pa:` command, AI MUST run these steps FIRST:**
+
+```bash
+cat .proagents/worklog/_context.md      # Current state
+cat .proagents/changelog/_recent.md     # Recent changes
+tail -10 .proagents/activity.log        # Recent activity
+```
+
+**AFTER executing ANY `pa:` command that changes files, AI MUST:**
+
+```bash
+# 1. Prepend to .proagents/changelog/_recent.md
+# 2. Update .proagents/worklog/_context.md
+# 3. Log to .proagents/activity.log
+```
+
+**This applies to ALL commands: pa:fix, pa:feature, pa:test, pa:doc, etc.**
+
+---
+
 ## CRITICAL: AI Must Execute All Commands
 
 **NEVER tell user to do something. AI must DO it.**
@@ -12,6 +34,7 @@ Detailed execution instructions for all `pa:` commands.
 
 | Command | AI Runs This |
 |---------|--------------|
+| `pa:help` | Display comprehensive help with examples and categories |
 | `pa:history` | `grep -v "^#" .proagents/activity.log \| tail -30` |
 | `pa:progress` | `cat .proagents/active-features/_index.json` |
 | `pa:activity` | `cat .proagents/activity.log \| tail -20` |
@@ -84,6 +107,72 @@ echo "[$(date '+%Y-%m-%d %H:%M')] [AI_NAME] [COMMAND] Result" >> .proagents/acti
 
 ---
 
+## Help Command
+
+### pa:help
+
+**Show comprehensive help with examples and categories.**
+
+**Command variations:**
+```
+pa:help                        # Full help with examples
+pa:help <command>              # Detailed help for specific command
+pa:help --quick                # Quick reference only
+```
+
+**Output format:**
+```
+ProAgents Help
+══════════════════════════════════════════════════════════
+
+🚀 Quick Start Examples
+───────────────────────
+  pa:feature "user authentication"    Start a new feature
+  pa:fix "login button not working"   Quick bug fix
+  pa:status                           Check current progress
+  pa:resume                           Continue where you left off
+
+📋 Common Workflows
+───────────────────
+  Feature:  pa:feature → pa:analyze → pa:design → pa:implement → pa:test
+  Bug Fix:  pa:fix "description" → auto-fix → auto-test → done
+  Resume:   pa:sync → pa:resume → continue working
+
+📂 Commands by Category
+───────────────────────
+  Core:      pa:feature, pa:fix, pa:status, pa:help
+  Workflow:  pa:analyze, pa:design, pa:implement, pa:test, pa:deploy
+  Progress:  pa:progress, pa:activity, pa:history
+  Collab:    pa:sync, pa:resume, pa:handoff
+
+💡 Tips
+───────
+  • Aliases: pa:f (feature), pa:s (status), pa:h (help)
+  • AI auto-syncs - no manual sync needed
+  • Changes auto-logged to changelog
+
+Type "pa:help <command>" for specific command help.
+```
+
+**For specific command (pa:help feature):**
+```
+pa:feature - Start New Feature
+══════════════════════════════════════════════════════════
+
+Usage:
+  pa:feature "feature name"
+
+What it does:
+  1. Creates feature folder
+  2. Analyzes codebase
+  3. Guides through workflow phases
+  4. Tracks progress
+
+Related: pa:feature-list, pa:feature-complete, pa:status
+```
+
+---
+
 ## Feature Commands
 
 ### pa:feature "name"
@@ -139,13 +228,80 @@ Completed (3):
 
 ### pa:fix "description"
 
+**Fix bugs with before/after diff and affected tests.**
+
 Quick bug fix mode (bypasses full workflow):
 
+**STEP 1: Auto-Sync (MANDATORY FIRST)**
+```bash
+cat .proagents/worklog/_context.md      # Current state
+cat .proagents/changelog/_recent.md     # Recent changes
+tail -10 .proagents/activity.log        # Recent activity
+```
+
+**STEP 2: Fix the bug**
 1. Analyze the bug description
 2. Search codebase for relevant code
 3. Implement fix directly
 4. Run relevant tests
-5. Log fix in activity.log
+
+**STEP 3: Auto-Log (MANDATORY AFTER)**
+```bash
+# Prepend to _recent.md
+# Update _context.md
+# Log to activity.log
+```
+
+**Example: pa:fix "login button not working"**
+```
+1. READ _context.md, _recent.md, activity.log     ← SYNC FIRST
+2. Search for login-related code                  ← ANALYZE
+3. Find and fix the bug                           ← FIX
+4. Run tests                                      ← VERIFY
+5. Prepend fix to _recent.md                      ← LOG CHANGE
+6. Update _context.md Quick Summary               ← UPDATE CONTEXT
+7. Append to activity.log                         ← LOG ACTIVITY
+```
+
+**Output format (bug fix summary):**
+```
+Bug Fix Summary
+═══════════════════════════════════════════════════════════
+
+🐛 Issue: Login validation not checking email format
+
+📁 File: src/auth/login.ts
+
+📝 Changes
+──────────
+Line 45:
+  Before: if (email) {
+  After:  if (email && email.includes('@')) {
+
+Line 52:
+  Before: return { success: true }
+  After:  return { success: true, validated: true }
+
+Diff: +3 lines, -1 line
+
+🧪 Affected Tests
+─────────────────
+  → auth.test.ts (3 tests affected)
+  → validation.test.ts (2 tests affected)
+
+Running affected tests...
+  ✓ auth.test.ts                 5/5 passed
+  ✓ validation.test.ts           4/4 passed
+
+📋 Related
+──────────
+  Issue: #123 (if detected from description)
+
+═══════════════════════════════════════════════════════════
+✅ Fix applied and verified!
+
+Next: pa:test (full suite) or pa:commit
+```
 
 ---
 
@@ -234,7 +390,18 @@ Quick bug fix mode (bypasses full workflow):
 
 ### pa:test
 
-**AI runs tests and shows results:**
+**Run tests with enhanced coverage visualization.**
+
+**Command variations:**
+```
+pa:test                        # Run all tests with coverage
+pa:test-unit                   # Unit tests only
+pa:test-e2e                    # E2E tests only
+pa:test-watch                  # Watch mode
+pa:test "file"                 # Test specific file
+```
+
+**AI runs tests and shows enhanced results:**
 
 ```bash
 # AI executes (check config first):
@@ -242,31 +409,115 @@ npm test 2>&1
 # OR from proagents.config.yaml testing.tools.unit.command
 ```
 
-Then reports:
+**Output format (enhanced):**
 ```
 Test Results
-════════════
-✓ 45 passed
-✗ 2 failed
-○ 3 skipped
+═══════════════════════════════════════════════════════════
+
+Summary: 45 passed | 2 failed | 3 skipped            2.3s
+
+Coverage
+────────
+Overall:      ████████████████░░░░  78%  (target: 80%)
+
+By Module:
+  src/auth/       ████████████████████  95%  ✓
+  src/api/        ████████████████░░░░  80%  ✓
+  src/services/   ██████████████░░░░░░  72%  ⚠️
+  src/utils/      ██████████░░░░░░░░░░  52%  ✗ below target
+
+Failing Tests
+─────────────
+  ✗ auth.test.ts:45
+    └─ login validation: expected true, got false
 
-Failed:
-• src/auth/login.test.ts:23 - Expected true, got false
-• src/api/user.test.ts:45 - Timeout after 5000ms
+  ✗ api.test.ts:102
+    └─ user endpoint: timeout after 5000ms
+
+Slow Tests (>1s)
+────────────────
+  ⚠️ e2e/checkout.test.ts          3.2s
+  ⚠️ integration/api.test.ts       1.8s
+
+═══════════════════════════════════════════════════════════
+Next: Fix failing tests or run "pa:test --update-snapshots"
+```
+
+**If all tests pass:**
+```
+Test Results
+═══════════════════════════════════════════════════════════
+
+✅ All 47 tests passed!                              1.8s
+
+Coverage: ████████████████░░░░ 82% (target: 80%) ✓
+
+═══════════════════════════════════════════════════════════
+Ready for: pa:review or pa:deploy
 ```
 
 **NEVER say "run npm test" - actually run it!**
 
 ### pa:review
 
+**Show code review checklist for current changes.**
+
+**Command variations:**
+```
+pa:review                      # Review current changes
+pa:review --staged             # Review staged files only
+pa:review --pr                 # PR review mode
+```
+
+**Steps:**
 1. Read `./.proagents/prompts/06.5-code-review.md`
-2. Review all changes in current feature
-3. Check:
-   - Code quality
-   - Test coverage
-   - Security issues
-   - Performance concerns
-4. Generate review report
+2. Get list of changed files (git diff)
+3. Analyze code for common issues
+4. Display interactive checklist
+
+**Output format (review checklist):**
+```
+Code Review Checklist
+═══════════════════════════════════════════════════════════
+
+Files Changed: 8 (+342, -89)
+──────────────────────────────
+
+📋 Code Quality
+───────────────
+  ✓ No console.log statements           cleaned
+  ✓ No debugger statements              cleaned
+  ✓ No commented-out code               cleaned
+  ✓ No TODO without issue number        checked
+  ⚠️ Complex function detected           see below
+
+🔒 Security
+───────────
+  ✓ No hardcoded credentials            scanned
+  ✓ Input validation present            checked
+  ✓ No SQL injection risks              analyzed
+  ○ Auth checks on new endpoints        needs review
+
+🧪 Testing
+──────────
+  ✓ Tests added for new functions       4 new tests
+  ⚠️ Test coverage decreased            -3% (78% → 75%)
+  ○ Edge cases covered                  needs review
+
+📝 Documentation
+────────────────
+  ✓ JSDoc on public functions           present
+  ○ README update needed                new feature
+  ○ API docs update needed              new endpoint
+
+⚠️ Attention Required
+─────────────────────
+  src/services/payment.ts:45
+    └─ Cyclomatic complexity: 18 (max: 15)
+
+═══════════════════════════════════════════════════════════
+Status: 12/16 checks passed | 2 warnings | 2 need review
+```
 
 ### pa:doc
 
@@ -307,10 +558,109 @@ Total: 12 files created
 
 ### pa:deploy
 
+**Show interactive deployment checklist with real-time status.**
+
+**Command variations:**
+```
+pa:deploy                      # Full deployment workflow
+pa:deploy-check                # Pre-deployment checklist only
+pa:deploy-staging              # Deploy to staging
+pa:deploy-prod                 # Deploy to production
+```
+
+**Steps:**
 1. Read `./.proagents/prompts/08-deployment.md`
-2. Run pre-deployment checks
-3. Create deployment checklist
-4. Generate release notes if needed
+2. Run pre-deployment checks (tests, lint, build)
+3. Display interactive checklist with real-time status
+4. Guide through deployment steps
+5. Show post-deployment verification
+
+**Output format (enhanced checklist):**
+```
+Deployment Checklist
+═══════════════════════════════════════════════════════════
+
+📋 Pre-Deployment
+─────────────────
+  ✓ All tests passing                    12/12 tests
+  ✓ No linting errors                    0 errors
+  ✓ Build successful                     2.3s
+  ✓ No console.log statements            cleaned
+  ○ Version bumped                       pending
+  ○ Changelog updated                    pending
+
+🔒 Security
+───────────
+  ✓ No hardcoded secrets                 scanned
+  ✓ Dependencies audited                 0 vulnerabilities
+  ○ Security review approved             awaiting
+
+📦 Build & Assets
+─────────────────
+  ✓ Bundle size acceptable               245kb (limit: 300kb)
+  ✓ Assets optimized                     images compressed
+  ○ Source maps generated                pending
+
+📝 Documentation
+────────────────
+  ✓ README updated                       current
+  ○ API docs updated                     pending
+  ○ Release notes prepared               pending
+
+🚀 Ready to Deploy?
+───────────────────
+Status: 8/14 checks passed
+
+Blockers:
+  ⚠️ Version not bumped - run: npm version patch
+  ⚠️ Changelog needs update - run: pa:changelog
+  ⚠️ Security review pending
+
+Run "pa:deploy --fix" to auto-fix resolvable issues.
+```
+
+**During deployment:**
+```
+Deploying to Staging
+═══════════════════════════════════════════════════════════
+
+[1/5] Building application...        ✓ Complete (2.3s)
+[2/5] Running migrations...          ✓ Complete (0.5s)
+[3/5] Deploying to staging...        ● In progress...
+[4/5] Running smoke tests...         ○ Pending
+[5/5] Verifying health checks...     ○ Pending
+
+Progress: ██████████░░░░░░░░░░ 50%
+```
+
+**Post-deployment verification:**
+```
+Post-Deployment Verification
+═══════════════════════════════════════════════════════════
+
+🏥 Health Checks
+────────────────
+  ✓ API responding                       200 OK (45ms)
+  ✓ Database connected                   healthy
+  ✓ Cache working                        redis OK
+  ✓ External services                    all reachable
+
+📊 Metrics (last 5 min)
+───────────────────────
+  Error rate:     0.1%  (baseline: 0.2%)   ✓ OK
+  Response time:  120ms (baseline: 150ms)  ✓ OK
+  Requests/sec:   450   (baseline: 400)    ✓ OK
+
+══════════════════════════════════════════════════════════
+✅ Deployment Successful!
+```
+
+**Legend:**
+- `✓` = Check passed
+- `●` = In progress
+- `○` = Pending
+- `✗` = Failed
+- `⚠️` = Warning/Blocker
 
 ---
 
@@ -374,36 +724,66 @@ cat .proagents/changelog/modules/[name].md
 
 **Run FIRST when starting work on any AI platform.**
 
-AI reads context files to understand current state:
+AI reads context files and shows visual diff of what changed:
 
 ```bash
 # AI executes:
 cat .proagents/worklog/_context.md
 cat .proagents/changelog/_recent.md
-ls -t .proagents/worklog/*.md | head -3 | xargs cat
+tail -30 .proagents/activity.log
 cat .proagents/active-features/_index.json
-tail -20 .proagents/activity.log
+git log --oneline -5 2>/dev/null
+git diff --stat HEAD~3 2>/dev/null
 ```
 
-Then reports:
+**Enhanced output with visual diff:**
 ```
-Project Context Loaded!
-
-Active Work:
-- Feature: user-auth (70% complete)
-- Last: JWT validation added by Claude
-
-Recent Changes:
-1. Added login validation (Claude, Mar 11)
-2. Fixed API endpoint (Gemini, Mar 10)
-
-Pending:
-- [ ] Complete email verification
-- [ ] Add unit tests
+Project Context Loaded
+══════════════════════════════════════════════════════════
+
+📊 Changes Since Your Last Session
+───────────────────────────────────
+  ├─ 5 files modified by Cursor (2h ago)
+  │   └─ src/auth/auth.service.ts (+45, -12)
+  │   └─ src/auth/auth.controller.ts (+23, -5)
+  │   └─ src/auth/auth.module.ts (+8, -2)
+  │   └─ src/users/user.service.ts (+15, -3)
+  │   └─ tests/auth.spec.ts (+30, -0)
+  │
+  ├─ 2 new commits
+  │   └─ "Add JWT validation" (Cursor)
+  │   └─ "Fix login endpoint" (Cursor)
+  │
+  └─ 1 feature updated: user-auth (60% → 75%)
+
+🎯 Current State
+────────────────
+  Feature: user-auth (75% complete)
+  Phase: Implementation (4/6)
+  Branch: feature/user-auth
+
+📝 Last Actions (by other AIs)
+──────────────────────────────
+  [14:30] [Cursor] 🔨 pa:implement - Added JWT validation
+  [14:00] [Cursor] 🐛 pa:fix - Fixed login endpoint
+  [12:00] [Claude] 🎨 pa:design - Created auth flow diagram
+
+⏭️ Next Steps
+─────────────
+  → Complete email verification
+  → Add password reset endpoint
+  → Write unit tests
 
 Ready to continue. What would you like to work on?
 ```
 
+**Key features:**
+- Shows files changed since last session with line counts
+- Shows commits made by other AIs
+- Shows feature progress delta (was → now)
+- Lists recent actions by ALL AI platforms
+- Shows clear next steps
+
 ### pa:session-start
 
 Begin a new work session:
@@ -446,42 +826,60 @@ Next AI can continue from: [next steps listed]
 
 ### pa:resume
 
-**Quick resume for returning AI - loads context and shows next action.**
+**Quick resume for returning AI - compact context + clear next action.**
 
 ```bash
 # AI executes:
 cat .proagents/worklog/_context.md
-cat .proagents/changelog/_recent.md
-ls -t .proagents/worklog/*.md 2>/dev/null | head -2 | tail -1 | xargs cat
+tail -5 .proagents/changelog/_recent.md
 tail -10 .proagents/activity.log
+cat .proagents/active-features/*/status.json 2>/dev/null | head -20
 ```
 
-Output:
+**Enhanced compact output:**
 ```
-Resume Context
-══════════════
-Last Session: 2024-03-11 by Claude (opus-4)
-Duration: 45 min
-
-What Was Done:
-- Added JWT validation
-- Fixed login bug
-- Updated API docs
-
-Pending Tasks:
-1. [ ] Complete email verification
-2. [ ] Add unit tests for auth
-
-Files Recently Modified:
-- src/auth/login.ts (2 hours ago)
-- src/auth/validate.ts (2 hours ago)
-
-Suggested Next Action:
-→ Continue with "Complete email verification"
-
-Ready to proceed?
+Quick Resume
+══════════════════════════════════════════════════════════
+
+🕐 Last Session
+───────────────
+  AI: Claude (opus-4)          When: 2 hours ago
+  Duration: 45 min             Actions: 8
+
+📋 What Was Done
+────────────────
+  ✓ Added JWT token validation
+  ✓ Fixed login endpoint bug
+  ✓ Updated API documentation
+  └─ 5 files changed (+120, -23)
+
+🎯 Current Feature
+──────────────────
+  user-auth ████████████████░░░░ 75%
+  Phase: Implementation → Testing next
+
+⚡ Next Action
+──────────────
+  → Complete email verification
+    File: src/auth/email.service.ts
+    Est: ~30 min
+
+📁 Hot Files (recently modified)
+────────────────────────────────
+  src/auth/auth.service.ts      2h ago (Claude)
+  src/auth/auth.controller.ts   2h ago (Claude)
+  tests/auth.spec.ts            2h ago (Claude)
+
+Ready to continue?
 ```
 
+**Key features:**
+- Shows last session info (AI, time, duration)
+- Compact summary of what was done
+- Current feature with visual progress
+- Single clear next action with file and estimate
+- Hot files that were recently modified
+
 ### pa:conflict-check
 
 **Check if files you're about to modify were changed by another AI.**
@@ -641,7 +1039,17 @@ Example auto-generated entry:
 
 ### pa:qa
 
-**AI runs ALL checks and reports:**
+**Show quality dashboard with all metrics.**
+
+**Command variations:**
+```
+pa:qa                          # Full quality dashboard
+pa:qa-security                 # Security audit only
+pa:qa-performance              # Performance check only
+pa:qa-lint                     # Lint check only
+```
+
+**AI runs ALL checks:**
 
 ```bash
 # AI executes each:
@@ -651,10 +1059,54 @@ npm run test:coverage 2>&1
 npm audit 2>&1
 ```
 
-Then reports:
+**Output format (quality dashboard):**
 ```
-QA Report
-═════════
+Code Quality Dashboard
+═══════════════════════════════════════════════════════════
+
+Overall Score: ████████████████░░░░ 85% (Good)
+
+🔒 Security
+───────────
+  Status:         ✓ No vulnerabilities
+  Dependencies:   142 packages scanned
+  Secrets:        ✓ No hardcoded secrets found
+  Last audit:     2 hours ago
+
+📏 Linting
+──────────
+  Errors:         0 ✓
+  Warnings:       3 ⚠️
+    └─ unused variable (2), missing return type (1)
+  Auto-fixable:   2
+
+🧪 Test Coverage
+────────────────
+  Coverage:       ████████████████░░░░ 78%
+  Target:         80%
+  Status:         ⚠️ 2% below target
+  Untested:       src/utils/helpers.ts, src/api/legacy.ts
+
+📦 Bundle Size
+──────────────
+  Current:        245kb
+  Limit:          300kb
+  Status:         ✓ Within limit
+  Largest:        react-dom (42kb), lodash (24kb)
+
+📝 Documentation
+────────────────
+  Documented:     ████████████░░░░░░░░ 60%
+  Missing:        15 functions, 3 components
+  README:         ✓ Up to date
+
+🔄 Code Complexity
+──────────────────
+  Average:        8.2 (Good)
+  High (>15):     2 functions
+
+═══════════════════════════════════════════════════════════
+Issues: 3 warnings | Run "pa:qa --fix" for auto-fixes
 Lint: ✓ No issues
 Tests: ✓ 45/45 passed
 Coverage: 82% (target: 80%) ✓
@@ -801,19 +1253,164 @@ Log architectural decision:
 
 ### pa:activity
 
+**CRITICAL: Show ALL AI platforms, not just your own!**
+
+The purpose of this command is cross-AI visibility. Users need to see what Claude, Cursor, ChatGPT, Gemini, and ALL other AIs have done.
+
+**Command variations:**
+```
+pa:activity                    # All recent activity (default)
+pa:activity --today            # Today's activity only
+pa:activity --ai Claude        # Filter by AI platform
+pa:activity --command pa:fix   # Filter by command type
+pa:activity --files            # Show files changed per action
+```
+
 **AI runs and displays:**
 
 ```bash
-# AI executes:
-cat .proagents/activity.log | grep -v "^#" | tail -20
+# AI executes - DO NOT filter by platform:
+cat .proagents/activity.log | grep -v "^#" | tail -50
 ```
 
-Then formats output:
+**Action icons:**
+| Command | Icon |
+|---------|------|
+| `pa:feature` | ✨ |
+| `pa:fix` | 🐛 |
+| `pa:test` | ✅ |
+| `pa:doc` | 📝 |
+| `pa:implement` | 🔨 |
+| `pa:analyze` | 🔍 |
+| `pa:design` | 🎨 |
+| `pa:review` | 👀 |
+| `pa:deploy` | 🚀 |
+
+**Output format (enhanced with time grouping and icons):**
 ```
-Recent Activity
-═══════════════
-[2024-03-06 16:00] [Gemini] pa:test - 12 tests passed
-[2024-03-06 15:45] [Claude] pa:implement - Created UserService
+Recent Activity (All AI Platforms)
+══════════════════════════════════════════════════════════
+
+Today (5 actions)
+─────────────────
+[16:00] [Claude]  ✨ pa:feature - Started user-auth
+        └─ 2 files: feature.json, status.json
+[15:30] [Cursor]  🐛 pa:fix - Fixed login validation bug
+        └─ 1 file: auth.service.ts (+12, -3)
+[15:00] [Gemini]  ✅ pa:test - 12 tests passed, 2 failing
+[14:30] [Claude]  🔨 pa:implement - Created UserService
+        └─ 3 files: user.service.ts, user.controller.ts, user.module.ts
+[14:00] [ChatGPT] 🔍 pa:analyze - Analyzed auth module
+
+Yesterday (8 actions)
+─────────────────────
+[18:00] [Claude]  🎨 pa:design - Created component diagram
+[16:30] [Cursor]  📝 pa:doc - Updated API documentation
+...
+
+──────────────────────────────────────────────────────────
+Summary: 13 actions | 4 AIs active | Last 48h
+  Claude: 5 | Cursor: 4 | Gemini: 2 | ChatGPT: 2
+```
+
+**IMPORTANT:**
+- Show activity from ALL AI platforms in the log
+- Do NOT filter to only show your own platform's activity
+- Group entries by time period (Today, Yesterday, Earlier)
+- Add action icons based on command type
+- Show files changed when available (read from changelog)
+- Show summary of actions per platform
+
+---
+
+### pa:standup
+
+**Generate daily standup summary automatically.**
+
+**Command variations:**
+```
+pa:standup                     # Today's standup
+pa:standup --yesterday         # What was done yesterday
+pa:standup --week              # Weekly summary
+pa:standup --team              # All AI activity (team view)
+```
+
+**Steps:**
+1. Read `.proagents/activity.log` for recent activity
+2. Read `.proagents/changelog/_recent.md` for changes
+3. Read current feature status from `active-features/`
+4. Identify blockers from context
+5. Generate formatted standup
+
+**Output format:**
+```
+Daily Standup - March 13, 2026
+═══════════════════════════════════════════════════════════
+
+👤 Your Session (Claude)
+────────────────────────
+
+✅ Yesterday / Last Session:
+  • Completed JWT token implementation
+  • Fixed 2 login validation bugs (#123, #124)
+  • Added 8 unit tests for auth module
+  • Updated API documentation
+
+📋 Today / Current:
+  • Password reset feature (in progress - 40%)
+    └─ Next: Email template integration
+  • API rate limiting implementation
+  • Review PR #45 (user dashboard)
+
+🚧 Blockers:
+  • None currently
+
+📊 Stats:
+  Files changed: 12 | Tests: +8 | Coverage: 78% → 82%
+
+──────────────────────────────────────────────────────────
+
+👥 Team Activity (All AIs) - Last 24h
+─────────────────────────────────────
+  Claude:   5 tasks  │ auth module, API docs
+  Cursor:   3 tasks  │ UI components, styling
+  Gemini:   2 tasks  │ database optimization
+
+═══════════════════════════════════════════════════════════
+Active Features: user-auth (80%), dashboard (40%)
+```
+
+**Weekly summary (pa:standup --week):**
+```
+Weekly Summary - Week of March 10, 2026
+═══════════════════════════════════════════════════════════
+
+📈 Progress
+───────────
+  Features completed:    2
+  Features in progress:  3
+  Bugs fixed:           8
+  Tests added:          24
+
+📊 By AI Platform
+─────────────────
+  Claude    ████████████████░░░░  45%  (18 tasks)
+  Cursor    ████████████░░░░░░░░  32%  (13 tasks)
+  Gemini    ████████░░░░░░░░░░░░  23%  (9 tasks)
+
+✅ Completed
+────────────
+  • User authentication feature
+  • Dashboard redesign
+  • 8 bug fixes
+
+📋 Next Week
+────────────
+  • Password reset feature
+  • Payment integration
+
+═══════════════════════════════════════════════════════════
+Total: 40 tasks | 156 files changed | Coverage: 75% → 82%
 ```
 
 ---
@@ -889,20 +1486,90 @@ Command History
 
 ### pa:progress
 
-**AI MUST read feature status files and calculate progress.**
+**AI MUST read feature status files and calculate enhanced progress.**
 
+**Steps:**
 1. Run: `cat .proagents/active-features/_index.json`
-2. Read each feature's status.json
-3. Calculate progress percentage
-4. Show visual progress bar
+2. Read each feature's `status.json`
+3. Run: `cat .proagents/activity.log | tail -50`
+4. Calculate progress percentage
+5. Show enhanced visual progress bar with:
+   - Task count (completed/total)
+   - Duration (days since started)
+   - Last AI that worked on it
+   - Phase timeline with status indicators
+
+**Output format:**
+```
+Feature Progress
+════════════════════════════════════════════════════════════
+
+user-auth       ████████████████░░░░  80%  (8/10 tasks)  3d  Claude
+                └─ Analysis ✓ → Requirements ✓ → Design ✓ → Implementation ✓ → Testing ● → Review ○
+
+dashboard       ████████░░░░░░░░░░░░  40%  (4/10 tasks)  5d  Cursor
+                └─ Analysis ✓ → Requirements ✓ → Design ● → Implementation ○ → Testing ○ → Review ○
+
+────────────────────────────────────────────────────────────
+Summary: 2 active | 5 completed | Avg: 4.2 days/feature
+```
+
+**Legend:**
+- `✓` = Phase completed
+- `●` = Current phase (in progress)
+- `○` = Phase not started
+- `(8/10 tasks)` = Completed/Total tasks
+- `3d` = Days since feature started
+- `Claude` = Last AI that worked on feature
 
 ### pa:activity
 
-**AI MUST read and display activity.log:**
+**CRITICAL: Show ALL AI platforms activity, not just your own!**
+
+1. Run: `cat .proagents/activity.log | tail -30`
+2. Show ALL AI activity (Claude, Cursor, ChatGPT, Gemini, etc.)
+3. Do NOT filter to only your platform
+4. Show summary with action count per platform
+
+### pa:status
+
+**AI MUST show enhanced project status with real data.**
+
+**Steps:**
+1. Run: `cat .proagents/active-features/_index.json`
+2. Read current feature's `status.json`
+3. Run: `git status` and `git log --oneline -5`
+4. Run: `cat .proagents/activity.log | tail -20`
+5. Display enhanced status
+
+**Output format:**
+```
+Project Status
+══════════════════════════════════════════════════════════
+
+Feature: user-auth                          Branch: feature/user-auth
+Phase: Implementation (4/6)                 Started: 3d ago
+Progress: ████████████░░░░░░░░ 60%          Time: ~4.5h
+
+Tasks: 3/5 completed
+  ✓ Create auth service
+  ✓ Add login endpoint
+  ✓ Add register endpoint
+  → Implement JWT tokens (in progress)
+  ○ Add password reset
 
-1. Run: `cat .proagents/activity.log | tail -20`
-2. Show recent AI activity
-3. Highlight actions by different AI platforms
+Files: 8 modified (+245, -32)    Tests: 12 ✓ | 2 ✗ | 80% cov
+Contributors: Claude (60%), Cursor (40%)
+
+──────────────────────────────────────────────────────────
+Next: Complete JWT token implementation
+```
+
+**Status indicators:**
+- `✓` = Task completed
+- `→` = In progress
+- `○` = Not started
+- `⚠️ BLOCKED:` = Show if blockers exist
 
 ---
 
@@ -1113,3 +1780,239 @@ Remove debug statements before production:
 2. List found statements with file:line
 3. Offer to remove or comment out
 4. Verify no production-breaking changes
+
+---
+
+## Undo Commands
+
+### pa:undo-last
+
+**Quick undo of last AI's changes - revert to before last AI session.**
+
+AI workflow:
+
+```bash
+# 1. Read AI stats to find last AI
+cat .proagents/worklog/ai-stats.json
+
+# 2. Find last session log
+ls -t .proagents/worklog/*.md | head -2 | tail -1
+
+# 3. Read session to find files changed
+# Extract "Files Changed" section
+
+# 4. Check git for those files
+git log --oneline -5 -- [files]
+
+# 5. Show user what will be reverted
+```
+
+Output:
+```
+Undo Last AI's Changes
+══════════════════════
+Last AI: Gemini (1.5-pro)
+Session: 2024-03-11 14:30
+Duration: 45 min
+
+Files Modified:
+- src/auth/login.ts (+23, -5)
+- src/auth/validate.ts (+15, -2)
+- tests/auth.test.ts (new file)
+
+Commits to revert:
+- abc123: Add login validation
+- def456: Add auth tests
+
+Options:
+1. Revert all changes (git revert)
+2. Revert specific files only
+3. View changes first (git diff)
+4. Cancel
+
+Your choice?
+```
+
+After user confirms:
+```bash
+# Revert commits
+git revert --no-commit abc123 def456
+git commit -m "Revert: Undo Gemini session 2024-03-11
+
+Reverted changes from session 2024-03-11-gemini-001.md
+
+Co-Authored-By: [Current AI]"
+
+# Update stats
+# Increment "reverts" counter in ai-stats.json
+```
+
+**Safety checks:**
+- Never revert if uncommitted changes exist
+- Warn if files modified by multiple AIs
+- Always show diff before revert
+- Update ai-stats.json with revert count
+
+### pa:undo-file "path"
+
+**Undo changes to a specific file.**
+
+```bash
+# Find last commit that modified this file
+git log --oneline -1 -- [path]
+
+# Show the change
+git diff HEAD~1 -- [path]
+
+# Offer revert options
+```
+
+### pa:undo-commit "hash"
+
+**Undo a specific commit.**
+
+```bash
+git revert [hash] --no-commit
+git commit -m "Revert: [original message]"
+```
+
+---
+
+## Learning Commands
+
+### pa:learn "pattern"
+
+**Teach AI a pattern or preference.**
+
+When user says `pa:learn "description"`, add to `.proagents/.learning/`:
+
+```json
+// .proagents/.learning/global/patterns.json
+{
+  "patterns": [
+    {
+      "id": "pattern-001",
+      "description": "[user's description]",
+      "learned_at": "2024-01-15T10:30:00Z",
+      "source": "explicit",
+      "examples": [],
+      "apply_to": "all"
+    }
+  ]
+}
+```
+
+**Example usage:**
+```
+User: pa:learn "Always use TypeScript strict mode"
+AI: ✓ Learned: Always use TypeScript strict mode
+    Saved to: .proagents/.learning/global/patterns.json
+    Will apply to: All future code generation
+```
+
+### pa:forget "pattern"
+
+**Remove a learned pattern or preference.**
+
+When user says `pa:forget "pattern"`, search and remove from learning files:
+
+```
+User: pa:forget "TypeScript strict mode"
+AI: Found matching patterns:
+    1. [pattern-001] Always use TypeScript strict mode
+
+    Remove this pattern? [Y/n]
+
+User: Y
+AI: ✓ Removed pattern: Always use TypeScript strict mode
+```
+
+**Search locations:**
+- `.proagents/.learning/global/patterns.json`
+- `.proagents/.learning/global/user-preferences.json`
+- `.proagents/.learning/projects/*/patterns.json`
+
+### pa:learning
+
+**Show learning report with all learned data.**
+
+Display comprehensive learning status:
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ 🧠 ProAgents Learning Report                            │
+├─────────────────────────────────────────────────────────┤
+│ Patterns Learned: 12                                    │
+│ Corrections Applied: 8                                  │
+│ User Preferences: 5                                     │
+│ Auto-Apply Rules: 3                                     │
+├─────────────────────────────────────────────────────────┤
+│ Recent Patterns:                                        │
+│ • Use Zustand for state management                      │
+│ • Prefer functional components                          │
+│ • Always add JSDoc to public functions                  │
+├─────────────────────────────────────────────────────────┤
+│ Active Corrections (auto-applying):                     │
+│ • "use axios" → "use fetch" (7 corrections)            │
+│ • "class component" → "functional" (5 corrections)     │
+├─────────────────────────────────────────────────────────┤
+│ Preferences:                                            │
+│ • checkpoints.after_design: always review              │
+│ • output_verbosity: detailed                           │
+│ • test_framework: vitest                               │
+└─────────────────────────────────────────────────────────┘
+```
+
+**Data sources:**
+- `.proagents/.learning/global/patterns.json`
+- `.proagents/.learning/global/user-preferences.json`
+- `.proagents/.learning/global/corrections.json`
+- `.proagents/.learning/projects/[hash]/patterns.json`
+
+### pa:suggestions
+
+**Show AI suggestions based on learned patterns.**
+
+Analyze current context and suggest improvements:
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ 💡 AI Suggestions                                       │
+├─────────────────────────────────────────────────────────┤
+│ Based on your patterns:                                 │
+│                                                         │
+│ 1. [Code Style]                                        │
+│    You prefer Zustand. Consider migrating Redux        │
+│    in src/stores/legacy-store.ts                       │
+│                                                         │
+│ 2. [Testing]                                           │
+│    You use Vitest. Found Jest config in package.json   │
+│    Consider unifying test frameworks                   │
+│                                                         │
+│ 3. [Documentation]                                     │
+│    12 public functions missing JSDoc comments          │
+│    Run pa:doc to generate                              │
+├─────────────────────────────────────────────────────────┤
+│ Based on corrections:                                   │
+│                                                         │
+│ • Found 3 instances of axios in new code               │
+│   (You've corrected this to use fetch 7 times)         │
+└─────────────────────────────────────────────────────────┘
+```
+
+### Learning System Auto-Apply Rules
+
+The learning system automatically applies corrections after a threshold:
+
+| Correction Count | Behavior |
+|-----------------|----------|
+| 1-2 occurrences | Tracked, AI remembers |
+| 3-4 occurrences | AI mentions learned preference |
+| 5+ occurrences | Auto-applied without asking |
+
+**Example auto-apply:**
+```
+AI working on code...
+ℹ️ Auto-applying learned preference: "Use fetch instead of axios"
+   (Corrected 7 times previously)
+```