proagents 1.0.0

package/proagents/changelog/README.md

@@ -0,0 +1,327 @@
+# Changelog System
+
+Automated change documentation for all modifications.
+
+---
+
+## Overview
+
+The changelog system ensures every change is documented, regardless of workflow mode:
+- Full features get comprehensive documentation
+- Bug fixes get standard documentation
+- Quick changes get minimal documentation
+
+---
+
+## Directory Structure
+
+```
+/proagents/changelog/
+├── README.md                 # This file
+├── CHANGELOG.md              # Aggregated changelog
+├── entry-template.md         # Template for entries
+└── 2024/                     # Year-based organization
+    ├── 01/                   # Month
+    │   ├── 2024-01-15-user-auth.md
+    │   ├── 2024-01-16-login-bugfix.md
+    │   └── 2024-01-16-config-update.md
+    └── 02/
+        └── ...
+```
+
+---
+
+## Documentation Levels
+
+### Full Workflow (Comprehensive)
+
+```yaml
+level: comprehensive
+includes:
+  - Feature summary
+  - Requirements link
+  - Design decisions
+  - Implementation details
+  - Test coverage
+  - Security review
+  - Performance impact
+  - Deployment notes
+  - Rollback plan
+```
+
+### Bug Fix (Standard)
+
+```yaml
+level: standard
+includes:
+  - Issue description
+  - Root cause
+  - Fix description
+  - Files modified
+  - Testing performed
+  - Verification steps
+```
+
+### Quick Change (Minimal)
+
+```yaml
+level: minimal
+includes:
+  - What changed
+  - Why
+  - Files modified
+  - Verification
+```
+
+---
+
+## Auto-Generated Entries
+
+Changes are automatically captured:
+
+```yaml
+auto_capture:
+  git_integration:
+    - commit_hash
+    - commit_message
+    - branch_name
+    - author
+    - files_changed
+    - diff_summary
+
+  context_capture:
+    - feature_id (if applicable)
+    - issue_id (if applicable)
+    - workflow_mode
+    - phase_completed
+    - test_results
+
+  timestamps:
+    - started_at
+    - completed_at
+    - duration
+```
+
+---
+
+## Changelog Entry Format
+
+### Header
+
+```markdown
+# Change: [Title]
+
+**Date:** 2024-01-15 14:30 UTC
+**Mode:** Full Workflow | Bug Fix | Quick Change
+**Author:** developer@example.com
+**Branch:** feature/user-authentication
+**Commit:** abc123def456
+**Feature ID:** FEAT-123 (if applicable)
+**Issue ID:** BUG-456 (if applicable)
+```
+
+### Body (varies by level)
+
+See `entry-template.md` for detailed templates.
+
+---
+
+## Aggregated CHANGELOG.md
+
+Auto-generated summary:
+
+```markdown
+# Changelog
+
+All notable changes to this project.
+
+## [Unreleased]
+
+### Added
+- User authentication system (#123)
+- Dashboard widgets (#125)
+
+### Fixed
+- Login redirect loop (#456)
+- Session timeout handling (#458)
+
+### Changed
+- Updated API response format (#127)
+
+---
+
+## [1.2.0] - 2024-01-15
+
+### Added
+- New feature X
+- New feature Y
+
+### Fixed
+- Bug fix A
+- Bug fix B
+
+...
+```
+
+---
+
+## Search & Query
+
+### Search by Keyword
+
+```bash
+# Search all changelogs
+/changelog search "authentication"
+
+# Results:
+- 2024-01-15: User authentication system
+- 2024-01-10: Auth token refresh fix
+- 2024-01-05: Authentication provider update
+```
+
+### Filter by Date
+
+```bash
+# Last 7 days
+/changelog --since "7 days ago"
+
+# Specific date range
+/changelog --from "2024-01-01" --to "2024-01-15"
+```
+
+### Filter by Type
+
+```bash
+# Only features
+/changelog --type feature
+
+# Only bug fixes
+/changelog --type bugfix
+
+# Only quick changes
+/changelog --type quick
+```
+
+### Filter by Author
+
+```bash
+/changelog --author "developer@example.com"
+```
+
+---
+
+## Git Integration
+
+### Automatic Entry on Commit
+
+```yaml
+# proagents.config.yaml
+changelog:
+  auto_create:
+    on_commit: true
+    on_merge: true
+    on_release: true
+
+  git_hooks:
+    post_commit: true
+    post_merge: true
+```
+
+### Commit Message Extraction
+
+```
+Commit: feat(auth): add login functionality
+
+Extracted:
+- Type: feature
+- Scope: auth
+- Description: add login functionality
+```
+
+---
+
+## Release Notes Generation
+
+```bash
+# Generate release notes
+/changelog release 1.2.0
+
+# Output:
+# Release Notes - v1.2.0
+
+## Highlights
+- User authentication system
+- Dashboard redesign
+
+## Features
+- [#123] User login/logout
+- [#125] Dashboard widgets
+- [#127] API improvements
+
+## Bug Fixes
+- [#456] Fixed login redirect
+- [#458] Fixed session timeout
+
+## Breaking Changes
+- API response format changed (see migration guide)
+
+## Contributors
+- @developer1 (5 commits)
+- @developer2 (3 commits)
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+
+changelog:
+  enabled: true
+
+  auto_generate:
+    on_feature_complete: true
+    on_bug_fix: true
+    on_quick_change: true
+
+  levels:
+    full_workflow: "comprehensive"
+    bug_fix: "standard"
+    quick_change: "minimal"
+
+  aggregation:
+    generate_changelog_md: true
+    format: "keep-a-changelog"
+    include_unreleased: true
+
+  git_integration:
+    link_commits: true
+    link_issues: true
+    link_prs: true
+
+  search:
+    indexed: true
+    full_text: true
+
+  notifications:
+    on_release: ["slack", "email"]
+
+  output:
+    directory: "proagents/changelog"
+    year_month_structure: true
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/changelog` | View recent changes |
+| `/changelog --today` | Today's changes |
+| `/changelog --week` | This week's changes |
+| `/changelog search [query]` | Search changelogs |
+| `/changelog create` | Create new entry |
+| `/changelog release [version]` | Generate release notes |
+| `/changelog export` | Export changelog |

package/proagents/changelog/entry-template.md

@@ -0,0 +1,283 @@
+# Changelog Entry Template
+
+Every change should be documented. Use this template.
+
+---
+
+## Entry Format
+
+```markdown
+# Change: [Title]
+
+**Date:** [YYYY-MM-DD HH:MM]
+**Mode:** [Full Workflow | Bug Fix | Quick Change]
+**Author:** [name]
+**Branch:** [branch-name]
+**Commit:** [commit-hash]
+
+## Summary
+[1-2 sentence description of what changed]
+
+## Details
+[Based on mode - see below]
+
+## Verification
+- [ ] Tested: [Yes/No + details]
+- [ ] Reviewed: [Yes/No + by whom]
+
+## Related
+- Issues: [links]
+- PRs: [links]
+
+## Tags
+[keywords for search]
+```
+
+---
+
+## Mode-Specific Details
+
+### Full Workflow Mode
+
+```markdown
+## Details
+
+### Requirements
+[Link to requirements document or summary]
+
+### Design
+[Link to design spec or summary]
+
+### Implementation
+- Files created: [list]
+- Files modified: [list]
+- Key changes: [summary]
+
+### Tests
+- Unit tests: [count] added
+- Integration tests: [count] added
+- Coverage: [percentage]
+
+### Breaking Changes
+[List any breaking changes]
+
+### Migration
+[Steps to migrate if needed]
+```
+
+### Bug Fix Mode
+
+```markdown
+## Details
+
+### Issue
+[What was broken - symptoms]
+
+### Root Cause
+[Why it happened]
+
+### Fix
+[What was changed to fix it]
+
+### Files Modified
+- [file1]: [change description]
+- [file2]: [change description]
+
+### Regression Risk
+[Low/Medium/High] - [explanation]
+```
+
+### Quick Change Mode
+
+```markdown
+## Details
+
+### What Changed
+[Brief description]
+
+### Reason
+[Why this change was needed]
+
+### Files Modified
+- [file]: [change]
+
+### Impact
+[None/Minimal]
+```
+
+---
+
+## Examples
+
+### Feature Entry
+
+```markdown
+# Change: Add User Profile Page
+
+**Date:** 2024-01-15 14:30
+**Mode:** Full Workflow
+**Author:** @developer
+**Branch:** feature/user-profile
+**Commit:** abc123
+
+## Summary
+Added user profile page with view and edit functionality.
+
+## Details
+
+### Requirements
+See: docs/requirements/user-profile.md
+
+### Implementation
+- Created ProfilePage component
+- Added edit modal with form validation
+- Integrated with user API
+- Added React Query hooks
+
+### Tests
+- Unit tests: 15 added
+- Integration tests: 5 added
+- Coverage: 85%
+
+## Verification
+- [x] Tested: Manual + automated tests
+- [x] Reviewed: @tech-lead
+
+## Related
+- Issue: #123
+- PR: #456
+
+## Tags
+user, profile, feature, react
+```
+
+### Bug Fix Entry
+
+```markdown
+# Change: Fix Login Button Double Submit
+
+**Date:** 2024-01-16 10:15
+**Mode:** Bug Fix
+**Author:** @developer
+**Branch:** fix/login-double-submit
+**Commit:** def456
+
+## Summary
+Fixed issue where login button could be clicked multiple times.
+
+## Details
+
+### Issue
+Users could click login button rapidly, causing multiple API calls
+and sometimes creating duplicate sessions.
+
+### Root Cause
+Missing loading state and button disable during API call.
+
+### Fix
+- Added isLoading state to track submission
+- Disabled button while loading
+- Added loading spinner feedback
+
+### Files Modified
+- src/components/LoginForm.tsx: Added loading state and disable logic
+
+### Regression Risk
+Low - isolated to login form
+
+## Verification
+- [x] Tested: Manual testing, cannot reproduce
+- [x] Reviewed: @frontend-lead
+
+## Related
+- Issue: #789
+
+## Tags
+login, bug, ui, auth
+```
+
+### Quick Change Entry
+
+```markdown
+# Change: Update API Base URL
+
+**Date:** 2024-01-16 16:00
+**Mode:** Quick Change
+**Author:** @devops
+**Branch:** config/api-url
+**Commit:** ghi789
+
+## Summary
+Updated API base URL to new production endpoint.
+
+## Details
+
+### What Changed
+Changed API_BASE_URL from api.old.com to api.new.com
+
+### Reason
+Infrastructure migration to new domain
+
+### Files Modified
+- .env.production: Updated API_BASE_URL
+
+### Impact
+None - same API, new domain
+
+## Verification
+- [x] Tested: Health check passes
+- [x] Reviewed: @devops-lead
+
+## Tags
+config, api, infrastructure
+```
+
+---
+
+## File Structure
+
+```
+/proagents/changelog/
+├── 2024/
+│   ├── 01/
+│   │   ├── 2024-01-15-user-profile.md
+│   │   ├── 2024-01-16-login-fix.md
+│   │   └── 2024-01-16-api-url.md
+│   └── 02/
+├── CHANGELOG.md          # Aggregated summary
+└── entry-template.md     # This template
+```
+
+---
+
+## Aggregated CHANGELOG.md
+
+```markdown
+# Changelog
+
+All notable changes to this project.
+
+## [1.2.0] - 2024-01-16
+
+### Added
+- User profile page with edit functionality (#456)
+
+### Fixed
+- Login button double submit issue (#789)
+
+### Changed
+- API base URL for production migration
+
+## [1.1.0] - 2024-01-10
+...
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/changelog-add` | Add changelog entry |
+| `/changelog-view` | View recent changes |
+| `/changelog-search` | Search changelog |