proagents 1.6.20 → 1.6.22

package/.proagents/checklists/code-quality.md

@@ -1,137 +0,0 @@
-# Code Quality Checklist
-
-Use this checklist during development and before code review.
-
----
-
-## Code Correctness
-
-- [ ] Logic is correct and handles all cases
-- [ ] Edge cases are handled properly
-- [ ] No obvious bugs or errors
-- [ ] Code meets all requirements
-- [ ] No hardcoded values (use constants/config)
-
----
-
-## Code Style
-
-- [ ] Follows project naming conventions
-- [ ] Consistent formatting (linter passes)
-- [ ] No unnecessary comments
-- [ ] No commented-out code
-- [ ] No console.log or debug statements
-- [ ] No TODO comments (or tracked in issues)
-- [ ] Imports organized properly
-
----
-
-## TypeScript/Types
-
-- [ ] Proper types used (no `any`)
-- [ ] Interfaces/types well-defined
-- [ ] Generic types where appropriate
-- [ ] Strict null checks handled
-- [ ] Function signatures are typed
-- [ ] Return types are explicit
-
----
-
-## Functions & Methods
-
-- [ ] Functions have single responsibility
-- [ ] Functions are not too long (< 50 lines)
-- [ ] Parameter count is reasonable (< 4)
-- [ ] No deeply nested logic (< 3 levels)
-- [ ] Pure functions where possible
-- [ ] Side effects are clear and documented
-
----
-
-## Error Handling
-
-- [ ] Errors are caught and handled
-- [ ] Error messages are helpful
-- [ ] Errors don't expose sensitive info
-- [ ] Async errors handled (try/catch)
-- [ ] Error boundaries for UI components
-- [ ] Graceful degradation where appropriate
-
----
-
-## Security
-
-- [ ] Input is validated/sanitized
-- [ ] No SQL/command injection risks
-- [ ] No XSS vulnerabilities
-- [ ] Authentication checked where needed
-- [ ] Authorization enforced
-- [ ] No hardcoded secrets
-- [ ] Sensitive data not logged
-
----
-
-## Performance
-
-- [ ] No unnecessary re-renders (React)
-- [ ] Expensive operations memoized
-- [ ] No memory leaks
-- [ ] Large lists are virtualized
-- [ ] Images optimized
-- [ ] Lazy loading where appropriate
-- [ ] No N+1 queries
-
----
-
-## Testing
-
-- [ ] Unit tests written
-- [ ] Tests cover happy path
-- [ ] Tests cover edge cases
-- [ ] Tests cover error cases
-- [ ] Tests are meaningful (not just coverage)
-- [ ] Tests are not flaky
-- [ ] Test coverage meets threshold
-
----
-
-## Documentation
-
-- [ ] Public APIs documented
-- [ ] Complex logic has comments
-- [ ] README updated if needed
-- [ ] API docs updated if needed
-- [ ] Types serve as documentation
-
----
-
-## Accessibility (UI)
-
-- [ ] Semantic HTML used
-- [ ] ARIA attributes where needed
-- [ ] Keyboard navigation works
-- [ ] Focus states visible
-- [ ] Color contrast sufficient
-- [ ] Form labels associated
-- [ ] Error messages accessible
-
----
-
-## Git & PR
-
-- [ ] Commit messages are clear
-- [ ] Commits are atomic
-- [ ] Branch is up to date with base
-- [ ] No merge conflicts
-- [ ] PR description is complete
-- [ ] Linked to issue/ticket
-
----
-
-## Final Check
-
-- [ ] Code compiles without errors
-- [ ] All tests pass
-- [ ] No linting errors/warnings
-- [ ] Self-review completed
-- [ ] Ready for peer review

package/.proagents/checklists/code-review.md

@@ -1,148 +0,0 @@
-# Code Review Checklist
-
-Use this checklist before marking a feature as review-complete.
-
----
-
-## 1. Code Quality
-
-### General
-- [ ] Code follows project conventions
-- [ ] No commented-out code
-- [ ] No console.log/debug statements
-- [ ] No TODO comments without tickets
-- [ ] Functions are reasonably sized (< 50 lines)
-- [ ] No duplicate code
-
-### Naming
-- [ ] Variables have meaningful names
-- [ ] Functions describe what they do
-- [ ] Constants are UPPER_SNAKE_CASE
-- [ ] No abbreviations without context
-
-### Structure
-- [ ] Single responsibility principle followed
-- [ ] Proper separation of concerns
-- [ ] No deep nesting (max 3-4 levels)
-- [ ] Consistent code organization
-
----
-
-## 2. Security
-
-### Critical
-- [ ] No hardcoded secrets or credentials
-- [ ] No sensitive data in logs
-- [ ] Input validation present
-- [ ] SQL injection prevention (parameterized queries)
-- [ ] XSS prevention (proper escaping)
-
-### Authentication & Authorization
-- [ ] Auth checks in place
-- [ ] Role-based access enforced
-- [ ] Session handling is secure
-
-### Data
-- [ ] Sensitive data encrypted
-- [ ] PII handled properly
-- [ ] GDPR compliance (if applicable)
-
----
-
-## 3. Performance
-
-### General
-- [ ] No N+1 query problems
-- [ ] Expensive operations are cached
-- [ ] No unnecessary re-renders (React)
-- [ ] Large lists are virtualized
-
-### Database
-- [ ] Indexes used appropriately
-- [ ] Queries are optimized
-- [ ] Batch operations where possible
-
-### Frontend
-- [ ] Images are optimized
-- [ ] Lazy loading implemented
-- [ ] Bundle size checked
-
----
-
-## 4. Error Handling
-
-- [ ] Errors are caught and handled
-- [ ] User-friendly error messages
-- [ ] Errors are logged appropriately
-- [ ] Edge cases are handled
-- [ ] Graceful degradation implemented
-
----
-
-## 5. Testing
-
-- [ ] Unit tests cover new code
-- [ ] Integration tests for API changes
-- [ ] Edge cases have tests
-- [ ] Tests are meaningful (not just coverage)
-- [ ] All tests pass
-
----
-
-## 6. Documentation
-
-- [ ] Code is self-documenting
-- [ ] Complex logic has comments
-- [ ] Public APIs are documented
-- [ ] README updated (if needed)
-- [ ] Changelog updated
-
----
-
-## 7. Accessibility (Frontend)
-
-- [ ] Semantic HTML used
-- [ ] ARIA labels present
-- [ ] Keyboard navigation works
-- [ ] Color contrast is sufficient
-- [ ] Screen reader tested
-
----
-
-## 8. Type Safety (TypeScript)
-
-- [ ] No `any` types
-- [ ] Interfaces/types are defined
-- [ ] Null/undefined handled
-- [ ] Generics used appropriately
-
----
-
-## 9. Git
-
-- [ ] Commits are atomic
-- [ ] Commit messages are clear
-- [ ] No merge conflicts
-- [ ] Branch is up to date with base
-
----
-
-## 10. Final Checks
-
-- [ ] Build succeeds
-- [ ] Linter passes
-- [ ] No new warnings
-- [ ] Works in all environments
-- [ ] Feature flag implemented (if needed)
-
----
-
-## Review Decision
-
-- [ ] **Approved** - Ready to merge
-- [ ] **Approved with suggestions** - Minor changes recommended
-- [ ] **Request changes** - Must fix before merge
-- [ ] **Needs discussion** - Architectural concerns
-
-**Reviewer Notes:**
-[Add any notes or concerns here]

package/.proagents/checklists/pr-checklist.md

@@ -1,78 +0,0 @@
-# Pull Request Checklist
-
-Complete before requesting review.
-
----
-
-## Code Changes
-
-- [ ] Code compiles without errors
-- [ ] All tests pass locally
-- [ ] No linting errors or warnings
-- [ ] No TypeScript errors
-- [ ] Follows project conventions
-- [ ] No debug code (console.log, etc.)
-
----
-
-## Testing
-
-- [ ] New code has unit tests
-- [ ] Tests cover edge cases
-- [ ] Integration tests added if needed
-- [ ] Manual testing completed
-- [ ] Test coverage meets threshold
-
----
-
-## Documentation
-
-- [ ] Code is self-documenting
-- [ ] Complex logic has comments
-- [ ] Public APIs documented
-- [ ] README updated if needed
-- [ ] Changelog updated
-
----
-
-## Security
-
-- [ ] No hardcoded secrets
-- [ ] Input validation in place
-- [ ] No security vulnerabilities introduced
-- [ ] Dependencies scanned
-
----
-
-## Performance
-
-- [ ] No obvious performance issues
-- [ ] Bundle size impact checked
-- [ ] Database queries optimized
-
----
-
-## PR Quality
-
-- [ ] PR has descriptive title
-- [ ] PR description explains changes
-- [ ] Related issue/ticket linked
-- [ ] Breaking changes noted
-- [ ] Screenshots included (if UI)
-
----
-
-## Branch
-
-- [ ] Branch is up to date with base
-- [ ] No merge conflicts
-- [ ] Commits are clean and atomic
-- [ ] Commit messages are clear
-
----
-
-## Ready for Review
-
-- [ ] Self-review completed
-- [ ] All checklist items addressed
-- [ ] Appropriate reviewers assigned

package/.proagents/checklists/pre-deployment.md

@@ -1,132 +0,0 @@
-# Pre-Deployment Checklist
-
-Complete this checklist before deploying to any environment.
-
----
-
-## 1. Code Readiness
-
-- [ ] All code reviewed and approved
-- [ ] All tests passing
-- [ ] No linting errors
-- [ ] Build succeeds
-
----
-
-## 2. Testing
-
-- [ ] Unit tests pass
-- [ ] Integration tests pass
-- [ ] E2E tests pass (if applicable)
-- [ ] Manual testing completed
-- [ ] Edge cases tested
-- [ ] Cross-browser testing (frontend)
-- [ ] Mobile responsive testing (frontend)
-
----
-
-## 3. Security
-
-- [ ] Security scan completed
-- [ ] No vulnerabilities in dependencies
-- [ ] No hardcoded secrets
-- [ ] Authentication working
-- [ ] Authorization working
-- [ ] HTTPS enforced
-
----
-
-## 4. Performance
-
-- [ ] Bundle size acceptable
-- [ ] No performance regressions
-- [ ] Database queries optimized
-- [ ] Caching implemented (if needed)
-
----
-
-## 5. Documentation
-
-- [ ] Code documentation complete
-- [ ] API documentation updated
-- [ ] README updated
-- [ ] Changelog updated
-- [ ] Migration guide (if breaking changes)
-
----
-
-## 6. Configuration
-
-- [ ] Environment variables documented
-- [ ] Secrets stored in vault
-- [ ] Config files reviewed
-- [ ] Feature flags configured
-
----
-
-## 7. Database
-
-- [ ] Migrations tested on copy of production
-- [ ] Rollback scripts ready
-- [ ] Database backup taken
-- [ ] Data integrity verified
-
----
-
-## 8. Infrastructure
-
-- [ ] Infrastructure changes reviewed
-- [ ] Scaling configured
-- [ ] Monitoring setup
-- [ ] Alerts configured
-- [ ] Logging configured
-
----
-
-## 9. Rollback Plan
-
-- [ ] Rollback procedure documented
-- [ ] Rollback tested
-- [ ] Previous version tagged
-- [ ] Team knows rollback procedure
-
----
-
-## 10. Communication
-
-- [ ] Stakeholders notified
-- [ ] Release notes prepared
-- [ ] Support team briefed
-- [ ] Downtime communicated (if any)
-
----
-
-## 11. Final Checks
-
-### Staging Deployment
-- [ ] Deployed to staging
-- [ ] Smoke tests pass
-- [ ] Stakeholder approval
-
-### Production Deployment
-- [ ] Staging verified
-- [ ] Production approval received
-- [ ] Deployment window confirmed
-- [ ] On-call team ready
-
----
-
-## Approval
-
-| Role | Name | Date | Approved |
-|------|------|------|----------|
-| Developer | | | [ ] |
-| Tech Lead | | | [ ] |
-| QA | | | [ ] |
-| DevOps | | | [ ] |
-
----
-
-## Deployment Notes
-
-[Add any deployment-specific notes here]

package/.proagents/checklists/pre-implementation.md

@@ -1,80 +0,0 @@
-# Pre-Implementation Checklist
-
-Complete before starting implementation.
-
----
-
-## Requirements
-
-- [ ] Requirements document reviewed
-- [ ] User stories understood
-- [ ] Acceptance criteria clear
-- [ ] Edge cases identified
-- [ ] Questions clarified with stakeholders
-
----
-
-## Design
-
-- [ ] UI/UX designs available
-- [ ] Design specifications understood
-- [ ] Design tokens documented
-- [ ] Component specifications ready
-- [ ] Responsive requirements clear
-- [ ] Accessibility requirements noted
-
----
-
-## Technical Planning
-
-- [ ] Implementation plan reviewed
-- [ ] Architecture decisions documented
-- [ ] File structure planned
-- [ ] Data models defined
-- [ ] API contracts agreed
-- [ ] State management approach decided
-
----
-
-## Codebase Understanding
-
-- [ ] Related existing code reviewed
-- [ ] Existing patterns identified
-- [ ] Conventions documented
-- [ ] Dependencies understood
-- [ ] Integration points mapped
-
----
-
-## Risk Assessment
-
-- [ ] Technical risks identified
-- [ ] Mitigation strategies planned
-- [ ] Blockers identified
-- [ ] Dependencies confirmed available
-
----
-
-## Environment
-
-- [ ] Development environment ready
-- [ ] Access to required services
-- [ ] Test data available
-- [ ] Feature branch created
-
----
-
-## Testing Strategy
-
-- [ ] Test approach defined
-- [ ] Test cases identified
-- [ ] Test data planned
-- [ ] Coverage targets set
-
----
-
-## Approval
-
-- [ ] Plan approved by tech lead
-- [ ] Design approved by stakeholders
-- [ ] Ready to begin implementation

package/.proagents/checklists/testing.md

@@ -1,120 +0,0 @@
-# Testing Checklist
-
-Comprehensive testing checklist for features.
-
----
-
-## Unit Tests
-
-### Components
-
-- [ ] Renders without crashing
-- [ ] Renders with required props
-- [ ] Renders with all props
-- [ ] Handles missing optional props
-- [ ] Click handlers work
-- [ ] Input changes handled
-- [ ] Displays loading state
-- [ ] Displays error state
-- [ ] Displays empty state
-
-### Functions
-
-- [ ] Returns expected output for valid input
-- [ ] Handles empty input
-- [ ] Handles null/undefined
-- [ ] Handles edge cases
-- [ ] Throws for invalid input
-- [ ] Performance is acceptable
-
-### Hooks
-
-- [ ] Returns expected initial values
-- [ ] Updates on dependency changes
-- [ ] Side effects work correctly
-- [ ] Cleanup on unmount
-- [ ] Handles errors gracefully
-
----
-
-## Integration Tests
-
-- [ ] Component interactions work
-- [ ] Data flows correctly
-- [ ] State updates propagate
-- [ ] API calls succeed
-- [ ] Error handling works
-- [ ] Navigation works
-
----
-
-## API Tests
-
-- [ ] Successful request returns correct data
-- [ ] Invalid input returns 400
-- [ ] Unauthorized returns 401
-- [ ] Forbidden returns 403
-- [ ] Not found returns 404
-- [ ] Server errors return 500
-- [ ] Request validation works
-- [ ] Response format correct
-
----
-
-## E2E Tests
-
-- [ ] Happy path works
-- [ ] User can complete primary flow
-- [ ] Error scenarios handled
-- [ ] Form validation works
-- [ ] Navigation works
-- [ ] Data persists correctly
-
----
-
-## Cross-Browser
-
-- [ ] Chrome (latest)
-- [ ] Firefox (latest)
-- [ ] Safari (latest)
-- [ ] Edge (latest)
-- [ ] Mobile browsers
-
----
-
-## Responsive
-
-- [ ] Mobile (375px)
-- [ ] Tablet (768px)
-- [ ] Desktop (1024px)
-- [ ] Large (1440px)
-
----
-
-## Accessibility
-
-- [ ] Keyboard navigation
-- [ ] Screen reader testing
-- [ ] Color contrast
-- [ ] Focus indicators
-- [ ] Form labels
-- [ ] Error announcements
-
----
-
-## Performance
-
-- [ ] Load time acceptable
-- [ ] No memory leaks
-- [ ] No excessive re-renders
-- [ ] Large data sets handled
-
----
-
-## Coverage
-
-- [ ] Statements: ____%
-- [ ] Branches: ____%
-- [ ] Functions: ____%
-- [ ] Lines: ____%
-- [ ] Meets threshold: [ ]

package/.proagents/checkpoints.json

@@ -1,13 +0,0 @@
-{
-  "checkpoints": [],
-  "_comment": "Checkpoints are created with pa:checkpoint command",
-  "_format": {
-    "id": "cp-001",
-    "timestamp": "2024-03-06T15:00:00Z",
-    "commit": "abc123def",
-    "description": "Before major refactor",
-    "feature": "feature-name",
-    "phase": "implementation",
-    "created_by": "Claude:opus-4"
-  }
-}