proagents 1.0.0

package/proagents/checklists/README.md

@@ -0,0 +1,261 @@
+# Checklists
+
+Quality checklists for each phase of the development workflow.
+
+---
+
+## Overview
+
+Structured checklists ensure consistency and completeness at each stage of development. ProAgents automatically presents relevant checklists during the workflow and tracks completion.
+
+---
+
+## Available Checklists
+
+| Checklist | Phase | Description |
+|-----------|-------|-------------|
+| [Pre-Implementation](./pre-implementation.md) | Before coding | Requirements verified, design approved |
+| [Code Quality](./code-quality.md) | During coding | Style, patterns, best practices |
+| [Testing](./testing.md) | Testing phase | Coverage, test types, edge cases |
+| [Code Review](./code-review.md) | Review phase | Review criteria, security checks |
+| [PR Checklist](./pr-checklist.md) | Pull request | PR requirements, documentation |
+| [Pre-Deployment](./pre-deployment.md) | Before deploy | Final verification, rollback ready |
+
+---
+
+## When Checklists Are Used
+
+```
+Feature Start
+     │
+     ▼
+┌─────────────────┐
+│ Pre-Implementation │ ← Checklist: requirements, design, dependencies
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ Implementation  │ ← Checklist: code quality (continuous)
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│    Testing      │ ← Checklist: test coverage, edge cases
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│   Code Review   │ ← Checklist: review criteria, security
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  Pull Request   │ ← Checklist: PR requirements
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│   Deployment    │ ← Checklist: pre-deployment verification
+└─────────────────┘
+```
+
+---
+
+## Commands
+
+```bash
+# Run specific checklist
+proagents checklist pre-deployment
+
+# Run all checklists for current phase
+proagents checklist current
+
+# Show checklist status for feature
+proagents checklist status
+
+# Mark item as complete
+proagents checklist complete pre-deployment.tests-pass
+
+# Generate checklist report
+proagents checklist report
+```
+
+---
+
+## Checklist Structure
+
+Each checklist item includes:
+
+```yaml
+- id: "unique-identifier"
+  title: "Human-readable title"
+  description: "Detailed description of what to check"
+  category: "security | quality | testing | documentation"
+  severity: "blocker | warning | info"
+  automated: true  # Can be automatically verified
+  manual: true     # Requires manual verification
+```
+
+---
+
+## Customization
+
+### Add Custom Items
+
+```yaml
+# proagents.config.yaml
+checklists:
+  pre_deployment:
+    custom_items:
+      - id: "security-scan"
+        title: "Security scan completed"
+        description: "Run SAST and dependency scan"
+        severity: "blocker"
+
+      - id: "performance-check"
+        title: "Performance benchmarks met"
+        description: "Response times within SLA"
+        severity: "warning"
+```
+
+### Disable Items
+
+```yaml
+checklists:
+  code_review:
+    disabled_items:
+      - "documentation-updated"  # Skip for hotfixes
+```
+
+### Environment-Specific
+
+```yaml
+checklists:
+  pre_deployment:
+    environments:
+      production:
+        required_items:
+          - "security-audit"
+          - "load-test-passed"
+      staging:
+        required_items:
+          - "basic-smoke-test"
+```
+
+---
+
+## Checklist Summaries
+
+### Pre-Implementation
+
+- [ ] Requirements documented and approved
+- [ ] Design reviewed and approved
+- [ ] Dependencies identified
+- [ ] Test strategy defined
+- [ ] No blockers from other features
+
+### Code Quality
+
+- [ ] Follows project coding standards
+- [ ] No linting errors
+- [ ] No TypeScript errors
+- [ ] Functions are small and focused
+- [ ] No hardcoded values
+- [ ] Error handling in place
+
+### Testing
+
+- [ ] Unit tests written (>80% coverage)
+- [ ] Integration tests written
+- [ ] Edge cases covered
+- [ ] Error scenarios tested
+- [ ] Tests are passing
+
+### Code Review
+
+- [ ] Code is readable and maintainable
+- [ ] No security vulnerabilities
+- [ ] No performance issues
+- [ ] Documentation updated
+- [ ] Follows team patterns
+
+### Pre-Deployment
+
+- [ ] All tests passing
+- [ ] No critical bugs
+- [ ] Rollback plan ready
+- [ ] Monitoring configured
+- [ ] Stakeholders notified
+
+---
+
+## Automated Verification
+
+Many checklist items can be automatically verified:
+
+| Item | Verification Method |
+|------|---------------------|
+| Tests passing | CI pipeline |
+| Coverage > 80% | Coverage report |
+| No lint errors | ESLint output |
+| No type errors | TypeScript compilation |
+| Dependencies secure | npm audit |
+| No secrets in code | Secret scanner |
+
+---
+
+## Blocking vs Non-Blocking
+
+### Blocker Items
+Must be completed before proceeding:
+- Tests passing
+- No security vulnerabilities
+- Required approvals
+
+### Warning Items
+Should be completed, but can proceed with justification:
+- Documentation updated
+- Performance benchmarks
+
+### Info Items
+Nice to have, for tracking:
+- Code comments added
+- README updated
+
+---
+
+## Reporting
+
+```bash
+# Generate markdown report
+proagents checklist report --format markdown
+
+# Generate JSON for integration
+proagents checklist report --format json
+
+# Show completion percentage
+proagents checklist progress
+```
+
+### Sample Report
+
+```
+Feature: user-authentication
+Phase: Pre-Deployment
+
+Checklist Progress: 8/10 (80%)
+
+✅ Completed:
+  - Requirements documented
+  - Design approved
+  - Unit tests passing (92% coverage)
+  - Integration tests passing
+  - No lint errors
+  - No security vulnerabilities
+  - Rollback plan documented
+  - Monitoring configured
+
+⚠️ Pending:
+  - Performance benchmarks (in progress)
+  - Final stakeholder sign-off (waiting)
+```

package/proagents/checklists/code-quality.md

@@ -0,0 +1,137 @@
+# 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

@@ -0,0 +1,148 @@
+# 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

@@ -0,0 +1,78 @@
+# 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