proagents 1.0.0

package/proagents/git/README.md

@@ -0,0 +1,68 @@
+# Git Integration
+
+Branch strategy, commit conventions, and PR workflows.
+
+---
+
+## Overview
+
+Integrated Git workflows for consistent version control practices.
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Branch Strategy](./branch-strategy.md) | Branch naming and flow |
+| [Commit Conventions](./commit-conventions.md) | Conventional commits, message format |
+| [PR Workflow](./pr-workflow.md) | Pull request process |
+| [Rollback Procedures](./rollback-procedures.md) | Git-based rollback |
+
+## Quick Start
+
+```bash
+# Create feature branch
+proagents git branch "user-auth"
+
+# Commit with convention
+proagents git commit "feat(auth): add login form"
+
+# Create pull request
+proagents git pr create
+```
+
+## Branch Strategy
+
+```
+main
+  └── develop
+       ├── feature/user-auth
+       ├── feature/dashboard
+       └── bugfix/login-error
+```
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+git:
+  enabled: true
+  branch_prefix: "feature/"
+  commit_convention: "conventional"
+  require_pr: true
+
+  branch_protection:
+    main:
+      require_review: true
+      require_tests: true
+```
+
+## Commit Types
+
+| Type | Description |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation |
+| `refactor` | Code refactoring |
+| `test` | Adding tests |
+| `chore` | Maintenance |

package/proagents/git/branch-strategy.md

@@ -0,0 +1,164 @@
+# Git Branch Strategy
+
+ProAgents follows a structured branching strategy for organized development.
+
+---
+
+## Branch Structure
+
+```
+main
+  └── develop
+       ├── feature/user-auth
+       ├── feature/dashboard
+       ├── feature/notifications
+       ├── hotfix/login-fix
+       └── release/v1.2.0
+```
+
+---
+
+## Branch Types
+
+### Main Branches
+
+| Branch | Purpose |
+|--------|---------|
+| `main` | Production-ready code |
+| `develop` | Integration branch for features |
+
+### Supporting Branches
+
+| Type | Prefix | Base | Merge To |
+|------|--------|------|----------|
+| Feature | `feature/` | develop | develop |
+| Hotfix | `hotfix/` | main | main + develop |
+| Release | `release/` | develop | main + develop |
+
+---
+
+## Branch Naming
+
+### Features
+```
+feature/[feature-name]
+feature/add-user-auth
+feature/update-dashboard
+```
+
+### Bug Fixes
+```
+fix/[issue-description]
+fix/login-validation
+fix/api-timeout
+```
+
+### Hotfixes
+```
+hotfix/[critical-issue]
+hotfix/security-patch
+hotfix/payment-bug
+```
+
+### Releases
+```
+release/v[version]
+release/v1.2.0
+```
+
+---
+
+## Workflow
+
+### Starting a Feature
+
+```bash
+# Create feature branch from develop
+git checkout develop
+git pull origin develop
+git checkout -b feature/my-feature
+```
+
+Or use slash command:
+```
+/branch-feature "my-feature"
+```
+
+### Working on Feature
+
+```bash
+# Regular commits
+git add .
+git commit -m "feat(scope): description"
+
+# Keep branch updated
+git fetch origin
+git rebase origin/develop
+```
+
+### Completing Feature
+
+```bash
+# Push branch
+git push origin feature/my-feature
+
+# Create PR to develop
+# (Or use /pr-create)
+```
+
+### Hotfix
+
+```bash
+# Create hotfix from main
+git checkout main
+git pull origin main
+git checkout -b hotfix/critical-fix
+
+# Fix the issue
+git commit -m "fix: critical issue"
+
+# Merge to main AND develop
+git checkout main
+git merge hotfix/critical-fix
+git checkout develop
+git merge hotfix/critical-fix
+```
+
+---
+
+## Slash Commands for Git
+
+| Command | Action |
+|---------|--------|
+| `/branch-feature "name"` | Create feature branch |
+| `/branch-hotfix "name"` | Create hotfix branch |
+| `/branch-release "v1.0.0"` | Create release branch |
+| `/commit-feat` | Feature commit |
+| `/commit-fix` | Fix commit |
+| `/pr-create` | Create pull request |
+
+---
+
+## Branch Protection Rules
+
+### Main Branch
+- Require pull request reviews (1+)
+- Require status checks to pass
+- No direct pushes
+
+### Develop Branch
+- Require pull request reviews
+- Require status checks to pass
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+git:
+  enabled: true
+  branch_prefix: "feature/"
+  default_base: "develop"
+  require_pr: true
+```

package/proagents/git/commit-conventions.md

@@ -0,0 +1,241 @@
+# Git Commit Conventions
+
+Standard commit message format for ProAgents projects.
+
+---
+
+## Conventional Commits
+
+Format:
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+---
+
+## Commit Types
+
+| Type | Description | Example |
+|------|-------------|---------|
+| `feat` | New feature | `feat(auth): add login form` |
+| `fix` | Bug fix | `fix(api): handle null response` |
+| `docs` | Documentation | `docs(readme): update install steps` |
+| `style` | Formatting (no code change) | `style: format with prettier` |
+| `refactor` | Code change (no new feature/fix) | `refactor(user): simplify validation` |
+| `perf` | Performance improvement | `perf(list): virtualize long lists` |
+| `test` | Adding tests | `test(auth): add login tests` |
+| `build` | Build system changes | `build: update webpack config` |
+| `ci` | CI configuration | `ci: add github actions` |
+| `chore` | Maintenance tasks | `chore: update dependencies` |
+| `revert` | Revert previous commit | `revert: revert "feat(auth)..."` |
+
+---
+
+## Scope
+
+Scope indicates the affected area:
+- Feature name: `auth`, `users`, `payments`
+- Component: `button`, `modal`, `form`
+- Module: `api`, `store`, `utils`
+
+```
+feat(auth): add password reset
+fix(button): fix hover state
+refactor(api): extract common headers
+```
+
+---
+
+## Description
+
+- Use imperative mood: "add" not "added"
+- Don't capitalize first letter
+- No period at the end
+- Keep under 50 characters
+
+```
+✅ Good:
+feat(auth): add login form validation
+fix(api): handle timeout errors
+docs: update contributing guide
+
+❌ Bad:
+feat(auth): Added login form validation.  (past tense, period)
+fix: Fix bug                              (not descriptive)
+FEAT: Add feature                         (caps)
+```
+
+---
+
+## Body
+
+Use for additional context:
+- What changes were made
+- Why the change was necessary
+- Any implications
+
+```
+feat(cart): add quantity limit
+
+Add maximum quantity limit of 99 items per product
+to prevent inventory issues and improve UX.
+
+Previously users could add unlimited quantities
+which caused checkout failures.
+```
+
+---
+
+## Footer
+
+### Breaking Changes
+
+```
+feat(api): change response format
+
+BREAKING CHANGE: API now returns data wrapped in `data` field.
+Previously: { id, name }
+Now: { data: { id, name } }
+```
+
+### Issue References
+
+```
+fix(login): prevent double submission
+
+Fixes #123
+Closes #456
+Related to #789
+```
+
+### Co-authors
+
+```
+feat(dashboard): add analytics widget
+
+Co-authored-by: Name <email@example.com>
+Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
+```
+
+---
+
+## Examples
+
+### Simple Commit
+```
+feat(auth): add password strength indicator
+```
+
+### Commit with Body
+```
+fix(api): handle network timeout gracefully
+
+Previously, network timeouts would cause the app to crash.
+Now we catch timeout errors and show a user-friendly message
+with a retry option.
+```
+
+### Breaking Change
+```
+refactor(api)!: update authentication endpoint
+
+BREAKING CHANGE: Auth endpoint moved from /auth to /api/v2/auth.
+Update all client configurations to use new endpoint.
+
+Migration guide: docs/migration/auth-v2.md
+```
+
+### Full Commit
+```
+feat(payments): add stripe integration
+
+Implement Stripe payment processing for checkout flow:
+- Add Stripe SDK integration
+- Create payment intent on server
+- Handle payment confirmation
+- Add webhook for payment events
+
+Requires STRIPE_SECRET_KEY environment variable.
+
+Closes #234
+Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
+```
+
+---
+
+## Commit Size
+
+### Good Commits
+- Single logical change
+- Can be reverted independently
+- Tests pass at each commit
+- Clear purpose
+
+### Avoid
+- Multiple unrelated changes
+- "WIP" commits in main branch
+- Broken intermediate states
+- Huge commits (> 500 lines)
+
+---
+
+## Commit Message Template
+
+Create `.gitmessage`:
+```
+# <type>(<scope>): <description>
+#
+# Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore
+#
+# Body: Explain what and why (not how)
+#
+# Footer: Breaking changes, issue references, co-authors
+```
+
+Configure git:
+```bash
+git config --global commit.template ~/.gitmessage
+```
+
+---
+
+## Automation
+
+### commitlint
+
+```javascript
+// commitlint.config.js
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [2, 'always', [
+      'feat', 'fix', 'docs', 'style', 'refactor',
+      'perf', 'test', 'build', 'ci', 'chore', 'revert'
+    ]],
+    'scope-case': [2, 'always', 'kebab-case'],
+    'subject-case': [2, 'always', 'lower-case'],
+    'subject-max-length': [2, 'always', 72],
+  },
+};
+```
+
+### Husky Pre-commit
+
+```bash
+npx husky add .husky/commit-msg 'npx commitlint --edit $1'
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/commit-feat` | Create feature commit |
+| `/commit-fix` | Create fix commit |
+| `/commit-docs` | Create docs commit |
+| `/commit-refactor` | Create refactor commit |