proagents 1.0.0

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

@@ -0,0 +1,83 @@
+{
+  "$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

@@ -0,0 +1,136 @@
+{
+  "$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

@@ -0,0 +1,72 @@
+{
+  "$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

@@ -0,0 +1,109 @@
+{
+  "$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/changelog/2024/01/2024-01-10-api-url-config.md

@@ -0,0 +1,41 @@
+# Change: API URL Configuration Update
+
+**Date:** 2024-01-10 09:30 UTC
+**Mode:** Quick Change
+**Author:** devops-1
+**Branch:** chore/api-url-update
+**Commit:** 123abc456def
+
+---
+
+## Summary
+
+Updated API base URL to use new production endpoint.
+
+---
+
+## Details
+
+### What Changed
+- Updated `NEXT_PUBLIC_API_URL` default value
+- Updated `.env.example` documentation
+
+### Reason
+Migration to new API infrastructure with improved latency.
+
+### Files Modified
+- `.env.example` (1 line)
+- `src/config/api.ts` (1 line)
+
+---
+
+## Verification
+
+- [x] Tested: API calls work with new URL
+- [x] Verified: No breaking changes
+
+---
+
+## Search Tags
+
+`config` `api` `infrastructure` `quick-change`

package/proagents/changelog/2024/01/2024-01-12-login-bug-fix.md

@@ -0,0 +1,69 @@
+# Change: Login Button Bug Fix
+
+**Date:** 2024-01-12 14:15 UTC
+**Mode:** Bug Fix
+**Author:** developer-2 (AI-assisted)
+**Branch:** fix/login-button-state
+**Commit:** def789abc123
+
+---
+
+## Summary
+
+Fixed issue where login button remained in loading state after failed OAuth callback.
+
+---
+
+## Details
+
+### Issue
+- **What was broken:** Login button showed infinite spinner after OAuth rejection
+- **Root Cause:** Promise rejection not caught in OAuth callback handler
+- **First Reported:** 2024-01-12 by user via support ticket
+
+### Fix
+Added proper error handling to OAuth callback:
+
+```typescript
+// Before
+const handleLogin = async () => {
+  setLoading(true);
+  await signIn('google');
+};
+
+// After
+const handleLogin = async () => {
+  setLoading(true);
+  try {
+    await signIn('google');
+  } catch (error) {
+    setLoading(false);
+    toast.error('Login failed. Please try again.');
+  }
+};
+```
+
+### Files Modified
+- `src/components/auth/LoginButton.tsx` (12 lines changed)
+
+---
+
+## Verification
+
+- [x] Tested: Login success flow
+- [x] Tested: Login cancel flow
+- [x] Tested: Login error flow
+- [x] Reviewed: No regression in existing functionality
+
+---
+
+## Related
+
+- **Related Issues:** PROJ-156 (Support ticket)
+- **Related Changes:** 2024-01-15-user-auth-feature.md
+
+---
+
+## Search Tags
+
+`bug-fix` `login` `oauth` `loading-state` `error-handling`

package/proagents/changelog/2024/01/2024-01-15-user-auth-feature.md

@@ -0,0 +1,99 @@
+# Change: User Authentication Feature
+
+**Date:** 2024-01-15 10:30 UTC
+**Mode:** Full Workflow
+**Author:** developer-1 (AI-assisted)
+**Branch:** feature/user-auth
+**Commit:** abc123def456
+
+---
+
+## Summary
+
+Added comprehensive user authentication with OAuth support for Google and GitHub providers, using NextAuth.js for session management.
+
+---
+
+## Details
+
+### Requirements
+- [Link to requirements document](../../../active-features/feature-user-auth/requirements.md)
+- User authentication via OAuth (Google, GitHub)
+- Session persistence with JWT tokens
+- Protected route middleware
+- User profile management
+
+### Design
+- [Link to design document](../../../active-features/feature-user-auth/design.md)
+- Login/logout button components
+- User menu dropdown
+- Session provider wrapper
+
+### Implementation
+
+**New Files Created:**
+- `src/lib/auth.ts` - Core authentication utilities
+- `src/app/api/auth/[...nextauth]/route.ts` - NextAuth API handler
+- `src/components/auth/LoginButton.tsx` - OAuth login button
+- `src/components/auth/LogoutButton.tsx` - Logout button
+- `src/components/auth/UserMenu.tsx` - User dropdown menu
+- `src/hooks/useAuth.ts` - Authentication hook
+- `src/types/auth.ts` - TypeScript definitions
+
+**Files Modified:**
+- `src/middleware.ts` - Added auth middleware
+- `src/app/layout.tsx` - Added SessionProvider
+- `prisma/schema.prisma` - Added User/Session models
+- `.env.example` - Added auth environment variables
+
+### Tests Added
+- Unit tests for auth utilities (15 tests)
+- Component tests for auth components (8 tests)
+- Integration tests for auth flow (5 tests)
+- **Coverage:** 85%
+
+### Dependencies Added
+- `next-auth@4.24.5`
+- `@auth/prisma-adapter@1.0.0`
+
+---
+
+## Verification
+
+- [x] All tests passing
+- [x] OAuth flow tested with Google
+- [x] OAuth flow tested with GitHub
+- [x] Session persistence verified
+- [x] Protected routes working
+- [x] Logout clears session
+- [x] Database migrations applied
+- [x] Security review completed
+
+---
+
+## Related
+
+- **Related Issues:** PROJ-123, PROJ-124
+- **Related Changes:** None
+- **Blocked Features:** Notifications (now unblocked)
+- **Future Considerations:**
+  - Add more OAuth providers (Apple, Microsoft)
+  - Implement magic link authentication
+  - Add two-factor authentication
+
+---
+
+## Decisions Made
+
+| Decision | Rationale |
+|----------|-----------|
+| Use NextAuth.js | Industry standard, excellent Next.js integration |
+| JWT tokens in httpOnly cookies | Security best practice |
+| Prisma adapter | Consistent with existing database setup |
+| Refresh token rotation | Enhanced security |
+
+---
+
+## Search Tags
+
+`authentication` `oauth` `nextauth` `google-login` `github-login` `session` `jwt` `security` `user-management`

package/proagents/changelog/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+All notable changes to this project are documented here and in the dated entries.
+
+---
+
+## [Unreleased]
+
+### In Progress
+- Push Notifications feature (paused, waiting on auth)
+
+---
+
+## January 2024
+
+### 2024-01-15
+
+#### Added
+- **User Authentication** - Full OAuth support with Google and GitHub
+  - [Full details](./2024/01/2024-01-15-user-auth-feature.md)
+  - NextAuth.js integration
+  - Session management with JWT
+  - Protected route middleware
+
+### 2024-01-12
+
+#### Fixed
+- **Login Button State** - Fixed infinite loading on OAuth rejection
+  - [Full details](./2024/01/2024-01-12-login-bug-fix.md)
+
+### 2024-01-10
+
+#### Changed
+- **API URL** - Updated to new production endpoint
+  - [Full details](./2024/01/2024-01-10-api-url-config.md)
+
+### 2024-01-09
+
+#### Added
+- **Dark Mode** - Theme switching support
+  - CSS variables for theming
+  - System preference detection
+  - Persistent user preference
+
+---
+
+## Summary Statistics
+
+| Month | Features | Bug Fixes | Config Changes |
+|-------|----------|-----------|----------------|
+| Jan 2024 | 2 | 1 | 1 |
+
+---
+
+## Quick Links
+
+- [All January 2024 changes](./2024/01/)
+- [Entry Template](./entry-template.md)
+- [Changelog Guidelines](./README.md)
+
+---
+
+## Changelog Format
+
+Each entry follows the template in [entry-template.md](./entry-template.md) and includes:
+
+- **Summary**: Brief description of the change
+- **Details**: Implementation specifics
+- **Verification**: Testing performed
+- **Related**: Links to issues and related changes
+- **Search Tags**: Keywords for searchability
+
+---
+
+## Auto-Generation
+
+This changelog is automatically updated when:
+- Features are completed
+- Bug fixes are merged
+- Configuration changes are deployed
+
+Manual entries can be added for non-automated changes.