Hiddenden/openrabbit

Fork 0

Milestone 1: Core Features (Quick Wins)

New Issue

Milestone 1: Core Features (Quick Wins)

Status: 🚧 IN PROGRESS
Target: Q1 2025
Duration: 2 weeks
Total Effort: 5-8 hours

Overview

Implement essential functionality that makes OpenRabbit fully usable for daily use.

Goals

Features that:

✅ Significantly improve user experience
✅ Reduce setup friction
✅ Increase discoverability
✅ Deliver immediate value to developers

Impact

Transforms OpenRabbit from "works but complex" to "works and is easy to use" 🚀

Features

1. @codebot help Command ⭐ CRITICAL

Priority: CRITICAL
Effort: 1-2 hours
Value: HIGH

Description:
Show all available commands with examples - users can discover what the bot can do without reading documentation.

Files to Modify:

tools/ai-review/config.yml
tools/ai-review/agents/issue_agent.py

Why Critical:
Users can't discover what the bot can do without reading external docs. This is the #1 discoverability issue.

Implementation:

Add help to commands list in config
Implement _command_help() method
Format response with categories and examples
Update @codebot help output itself

Output Example:

**Available @codebot Commands:**

**Issue Triage & Analysis:**
- `@codebot triage` - Full issue triage with auto-labeling
- `@codebot summarize` - Generate 2-3 sentence summary
- `@codebot explain` - Detailed explanation

**Interactive Chat:**
- `@codebot [question]` - Ask questions about codebase

**Examples:**
@codebot triage
@codebot how does authentication work?

2. Automatic Label Creator ⭐ HIGH

Priority: HIGH
Effort: 3-4 hours (includes mapping logic)
Value: VERY HIGH

Description:
@codebot setup-labels auto-creates or maps existing labels, eliminating #1 setup frustration.

Files to Modify:

tools/ai-review/config.yml
tools/ai-review/agents/issue_agent.py
tools/ai-review/clients/gitea_client.py

Why High:
Manual label creation is the biggest setup pain point. Takes 15-20 minutes manually, will take 30 seconds with this command.

Key Features:

🔍 Smart Detection - Detects existing label schemas (Kind/, Priority -, type:)
🗺️ Intelligent Mapping - Maps existing labels instead of creating duplicates
✨ Zero Duplicates - Won't create type: bug if you already have Kind/Bug
🎯 Respects Conventions - Follows your existing naming patterns
📝 Auto Config - Generates .ai-review.yml with mappings

Two Modes:

Map Mode (Default for repos with existing labels):
- Detects: Kind/Bug, Priority - High, etc.
- Creates .ai-review.yml mapping
- No duplicate labels
Create Mode (For fresh repositories):
- Creates standard OpenRabbit labels
- type:, priority:, ai-* labels

Implementation:

Add label pattern detection (regex)
Implement fuzzy matching with aliases
Generate .ai-review.yml config
Create missing labels in user's style
API methods: create_label(), get_repo_labels()

Output Example:

**🔍 Label Schema Detected:**

Found 18 existing labels with pattern: `Kind/` and `Priority -`

**📋 Proposed Mapping:**
| OpenRabbit Expected | Your Existing Label | Status |
|---------------------|---------------------|--------|
| `type: bug` | `Kind/Bug` | ✅ Map |
| `priority: high` | `Priority - High` | ✅ Map |

**✅ Setup Complete!**
Created `.ai-review.yml` with label mappings.

3. @codebot review-again Command

Priority: MEDIUM
Effort: 1-2 hours
Value: HIGH

Description:
Re-run PR review without new commits - smoother workflow, no unnecessary commits.

Files to Modify:

tools/ai-review/config.yml
tools/ai-review/agents/pr_agent.py

Why Important:
Currently developers must create empty commits to trigger re-review. This clutters git history and wastes CI time.

Key Features:

🔄 Re-run Review - On current HEAD commit
📊 Show Diff - Compares to previous review
🏷️ Auto Update Labels - Changes ai-changes-required to ai-approved
⚡ Fast Iteration - No waiting for CI
🔧 Config Aware - Uses latest .ai-review.yml

Use Cases:

False Positive - "This is a public URL, not a secret" → re-review
Config Change - Updated .ai-review.yml → test new rules
Comment Clarification - Explained design in comments → re-evaluate

Implementation:

Detect review-again in PR comments
Reuse existing _run_pr_review() logic
Add _compare_reviews() for diff
Add _parse_review_comment() to extract previous findings
Format with resolved/new/still present sections

Output Example:

**🔄 Re-review Requested**

**Previous Review:** 3 issues (1 HIGH, 2 MEDIUM)
**Current Review:** 2 issues (0 HIGH, 2 MEDIUM)

### Changes from Previous Review

**✅ Resolved (1):**
- [HIGH] Hardcoded API key (confirmed as public URL)

**Still Present (2):**
- [MEDIUM] Error handling could be more specific

**Overall Severity:** MEDIUM (was HIGH)
**AI Recommendation:** Approved ✅

Success Metrics

Week 1

@codebot help command deployed
80%+ users discover help within first use
Zero "what can the bot do?" support questions

Week 2

Automatic Label Creator deployed
Setup time < 5 minutes (from 20+ minutes)
Zero manual label creation required

Week 3

@codebot review-again deployed
90% reduction in empty "trigger review" commits
PR review workflow smooth and intuitive

Overall

New users can use bot within 5 minutes
All three features working in production
Positive user feedback
Ready to move to Milestone 2

Implementation Timeline

Week 1: @codebot help

Days 1-2:

Add help to config.yml
Implement _command_help() method
Format help text
Testing

Days 3-4:

Documentation
Deploy to production
Monitor usage

Week 2: Automatic Label Creator

Days 1-2:

Label schema detection logic
Pattern matching (Kind/, Priority -, type:)
Fuzzy matching with aliases

Days 3-4:

Map mode implementation
Create mode implementation
Generate .ai-review.yml

Day 5:

API methods (create_label, get_repo_labels)
Testing with different label schemas
Documentation

Week 3: @codebot review-again

Days 1-2:

Command detection in PR comments
Review comparison logic
Parse previous review

Days 3-4:

Format diff output
Label updates
Testing

Day 5:

Documentation
Deploy to production

Week 4: Polish & Deploy

Final testing across all features
Update README and docs
Monitor production usage
Gather user feedback
Prepare for Milestone 2

Dependencies

Required:

v1.0 Foundation (already complete)
Bot token with repo:write permissions
Access to Gitea/GitHub API

Blocks:

Milestone 2 (PR Workflow Enhancement)
All future milestones depend on good UX foundation

Risk Assessment

Low Risk Features

✅ @codebot help - Very simple, pure text output
✅ @codebot review-again - Reuses existing code

Medium Risk Features

⚠️ Automatic Label Creator - Pattern detection might not catch all schemas
Mitigation: Dry-run mode, manual mode selection, fallback to create mode

Overall Risk: LOW

All features are additive and don't break existing functionality.

Testing Strategy

Unit Tests

Help command formatting
Label pattern detection (Kind/, Priority -, type:)
Label mapping fuzzy matching
Review comparison logic
Previous review parsing

Integration Tests

Help command in real repository
Label creator with fresh repository
Label creator with existing labels (Kind/ pattern)
Label creator with existing labels (Priority - pattern)
Review-again on PR with previous review
Review-again on PR without previous review

User Acceptance Testing

Test setup flow end-to-end
Verify all commands work
Check documentation accuracy
Gather feedback from beta users

Documentation Updates

README.md

Add @codebot help to commands table
Add @codebot setup-labels to Quick Start
Add @codebot review-again to PR workflow section
Update feature list

Getting Started Guide

Setup now includes @codebot setup-labels
Remove manual label creation instructions
Add "First Steps" section with help command

API Reference

Document new GiteaClient methods
Document new IssueAgent methods
Document new PRAgent methods

Troubleshooting

Add section on label mapping issues
Add section on pattern detection
Add FAQ for common questions

Next Steps After Completion

Gather Metrics:
- Track command usage (help, setup-labels, review-again)
- Measure setup time reduction
- Monitor support ticket reduction
User Feedback:
- Survey users on ease of setup
- Identify remaining pain points
- Collect feature requests
Prepare Milestone 2:
- Review PR Workflow Enhancement features
- Prioritize based on user feedback
- Update implementation plan
Celebrate! 🎉
- OpenRabbit is now truly easy to use
- Major UX improvements delivered
- Foundation set for future features

Issue #XXX: @codebot help Command
Issue #XXX: Automatic Label Creator
Issue #XXX: @codebot review-again Command

Last Updated: December 28, 2024
Status: 🚧 IN PROGRESS
Next Review: End of Week 1

No due date

100% Completed