proagents 1.6.19 → 1.6.21

package/.proagents/cache/schemas/metadata-schema.json

@@ -1,83 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "cache-metadata-schema.json",
-  "title": "Cache Metadata Schema",
-  "description": "Schema for cache metadata in the ProAgents analysis cache",
-  "type": "object",
-  "required": ["version", "cache_version", "project", "timestamps"],
-  "properties": {
-    "$schema": {
-      "type": "string"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$"
-    },
-    "cache_version": {
-      "type": "string"
-    },
-    "project": {
-      "type": "object",
-      "required": ["path", "name"],
-      "properties": {
-        "path": { "type": "string" },
-        "name": { "type": "string" },
-        "type": {
-          "type": "string",
-          "enum": ["web-frontend", "fullstack", "backend", "mobile", "library"]
-        }
-      }
-    },
-    "timestamps": {
-      "type": "object",
-      "properties": {
-        "created_at": { "type": "string", "format": "date-time" },
-        "updated_at": { "type": "string", "format": "date-time" },
-        "last_full_analysis": { "type": "string", "format": "date-time" },
-        "last_incremental_update": { "type": "string", "format": "date-time" }
-      }
-    },
-    "cache_status": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "valid": { "type": "boolean" },
-          "age_hours": { "type": "number", "minimum": 0 },
-          "ttl_hours": { "type": "number", "minimum": 0 },
-          "size_bytes": { "type": "integer", "minimum": 0 },
-          "last_updated": { "type": "string", "format": "date-time" }
-        }
-      }
-    },
-    "file_tracking": {
-      "type": "object",
-      "properties": {
-        "total_files": { "type": "integer", "minimum": 0 },
-        "tracked_files": { "type": "integer", "minimum": 0 },
-        "excluded_files": { "type": "integer", "minimum": 0 },
-        "last_file_check": { "type": "string", "format": "date-time" },
-        "files_changed_since_analysis": { "type": "integer", "minimum": 0 }
-      }
-    },
-    "integrity": {
-      "type": "object",
-      "properties": {
-        "checksum": { "type": "string" },
-        "verified_at": { "type": "string", "format": "date-time" },
-        "status": {
-          "type": "string",
-          "enum": ["valid", "invalid", "unknown"]
-        }
-      }
-    },
-    "storage": {
-      "type": "object",
-      "properties": {
-        "total_size_bytes": { "type": "integer", "minimum": 0 },
-        "max_size_bytes": { "type": "integer", "minimum": 0 },
-        "usage_percent": { "type": "number", "minimum": 0, "maximum": 100 }
-      }
-    }
-  }
-}

package/.proagents/cache/schemas/patterns-schema.json

@@ -1,136 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "cache-patterns-schema.json",
-  "title": "Cache Patterns Schema",
-  "description": "Schema for cached code patterns in the ProAgents analysis cache",
-  "type": "object",
-  "required": ["version", "cached_at", "patterns"],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "Reference to this schema file"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Semantic version of the cache format"
-    },
-    "cached_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of when cache was created"
-    },
-    "expires_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of cache expiration"
-    },
-    "patterns": {
-      "type": "object",
-      "properties": {
-        "component_patterns": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/cached_pattern" }
-        },
-        "hook_patterns": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/cached_pattern" }
-        },
-        "api_patterns": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/cached_pattern" }
-        },
-        "state_patterns": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/cached_pattern" }
-        },
-        "error_patterns": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/cached_pattern" }
-        },
-        "testing_patterns": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/cached_pattern" }
-        }
-      }
-    },
-    "naming_conventions": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "pattern": { "type": "string" },
-          "examples": {
-            "type": "array",
-            "items": { "type": "string" }
-          },
-          "confidence": { "type": "number", "minimum": 0, "maximum": 1 }
-        }
-      }
-    },
-    "file_structure": {
-      "type": "object",
-      "additionalProperties": { "type": "string" }
-    },
-    "metadata": {
-      "type": "object",
-      "properties": {
-        "files_analyzed": { "type": "integer", "minimum": 0 },
-        "analysis_duration_ms": { "type": "integer", "minimum": 0 },
-        "cache_hits": { "type": "integer", "minimum": 0 },
-        "cache_misses": { "type": "integer", "minimum": 0 }
-      }
-    }
-  },
-  "definitions": {
-    "cached_pattern": {
-      "type": "object",
-      "required": ["id", "name"],
-      "properties": {
-        "id": {
-          "type": "string",
-          "description": "Unique identifier for the pattern"
-        },
-        "name": {
-          "type": "string",
-          "description": "Human-readable name for the pattern"
-        },
-        "description": {
-          "type": "string",
-          "description": "Detailed description of the pattern"
-        },
-        "template": {
-          "type": "string",
-          "description": "Code template for the pattern"
-        },
-        "examples": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Example usages found in codebase"
-        },
-        "frequency": {
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 100,
-          "description": "How often this pattern appears (percentage)"
-        },
-        "confidence": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Confidence score for pattern detection"
-        },
-        "files": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Files where this pattern was detected"
-        },
-        "last_seen": {
-          "type": "string",
-          "format": "date-time",
-          "description": "When this pattern was last detected"
-        }
-      }
-    }
-  }
-}

package/.proagents/cache/schemas/structure-schema.json

@@ -1,72 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "cache-structure-schema.json",
-  "title": "Cache Structure Schema",
-  "description": "Schema for cached project structure in the ProAgents analysis cache",
-  "type": "object",
-  "required": ["version", "generated_at", "root", "tree"],
-  "properties": {
-    "$schema": {
-      "type": "string"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$"
-    },
-    "generated_at": {
-      "type": "string",
-      "format": "date-time"
-    },
-    "root": {
-      "type": "string",
-      "description": "Root path of the project"
-    },
-    "tree": {
-      "type": "object",
-      "additionalProperties": { "$ref": "#/definitions/tree_node" }
-    },
-    "statistics": {
-      "type": "object",
-      "properties": {
-        "total_directories": { "type": "integer", "minimum": 0 },
-        "total_files": { "type": "integer", "minimum": 0 },
-        "by_extension": {
-          "type": "object",
-          "additionalProperties": { "type": "integer", "minimum": 0 }
-        }
-      }
-    },
-    "framework_detection": {
-      "type": "object",
-      "properties": {
-        "primary": { "type": "string" },
-        "version": { "type": "string" },
-        "router": { "type": "string" },
-        "additional": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      }
-    }
-  },
-  "definitions": {
-    "tree_node": {
-      "type": "object",
-      "required": ["type"],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["directory", "file"]
-        },
-        "purpose": { "type": "string" },
-        "framework": { "type": "string" },
-        "pattern": { "type": "string" },
-        "file_count": { "type": "integer", "minimum": 0 },
-        "children": {
-          "type": "object",
-          "additionalProperties": { "$ref": "#/definitions/tree_node" }
-        }
-      }
-    }
-  }
-}

package/.proagents/cache/structure.json

@@ -1,109 +0,0 @@
-{
-  "$schema": "./schemas/structure-schema.json",
-  "version": "1.0.0",
-  "generated_at": "2024-01-15T10:30:00Z",
-
-  "root": "/path/to/project",
-
-  "tree": {
-    "src": {
-      "type": "directory",
-      "purpose": "Main source code",
-      "children": {
-        "app": {
-          "type": "directory",
-          "purpose": "Next.js App Router pages",
-          "framework": "nextjs",
-          "children": {
-            "api": {
-              "type": "directory",
-              "purpose": "API routes",
-              "pattern": "api-routes"
-            },
-            "layout.tsx": {
-              "type": "file",
-              "purpose": "Root layout"
-            },
-            "page.tsx": {
-              "type": "file",
-              "purpose": "Home page"
-            }
-          }
-        },
-        "components": {
-          "type": "directory",
-          "purpose": "Shared React components",
-          "pattern": "component-library",
-          "file_count": 24
-        },
-        "hooks": {
-          "type": "directory",
-          "purpose": "Custom React hooks",
-          "pattern": "custom-hooks",
-          "file_count": 8
-        },
-        "services": {
-          "type": "directory",
-          "purpose": "API and business logic",
-          "pattern": "service-layer",
-          "file_count": 6
-        },
-        "stores": {
-          "type": "directory",
-          "purpose": "Zustand state stores",
-          "pattern": "state-management",
-          "file_count": 4
-        },
-        "types": {
-          "type": "directory",
-          "purpose": "TypeScript type definitions",
-          "file_count": 12
-        },
-        "utils": {
-          "type": "directory",
-          "purpose": "Utility functions",
-          "file_count": 10
-        }
-      }
-    },
-    "tests": {
-      "type": "directory",
-      "purpose": "Test files",
-      "pattern": "colocated-tests",
-      "children": {
-        "unit": { "type": "directory", "file_count": 45 },
-        "integration": { "type": "directory", "file_count": 12 },
-        "e2e": { "type": "directory", "file_count": 8 }
-      }
-    },
-    "public": {
-      "type": "directory",
-      "purpose": "Static assets"
-    },
-    "prisma": {
-      "type": "directory",
-      "purpose": "Database schema and migrations",
-      "pattern": "prisma-orm"
-    }
-  },
-
-  "statistics": {
-    "total_directories": 32,
-    "total_files": 189,
-    "by_extension": {
-      ".tsx": 78,
-      ".ts": 65,
-      ".json": 12,
-      ".css": 8,
-      ".md": 15,
-      "other": 11
-    }
-  },
-
-  "framework_detection": {
-    "primary": "nextjs",
-    "version": "14",
-    "router": "app",
-    "additional": ["react", "typescript", "tailwind", "prisma"]
-  }
-}

package/.proagents/checklists/README.md

@@ -1,261 +0,0 @@
-# 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)
-```