feat: Implement LLM Triage & Smart Routing System (#24)

* feat: Complete previous development session with details on the implemented transfer rules engine and start a new development session.

* feat(config): add LLM routing configuration and pipeline result extensions

- Add Description field to RepositoryConfig for LLM routing
- Add LLMRoutingEnabled, HighConfidence, MediumConfidence to TransferConfig
- Extend pipeline Result struct with quality, transfer, and duplicate fields
- Set default confidence thresholds (0.9 high, 0.6 medium)

* feat(gemini): add LLM methods for routing, quality, and duplicate detection

- Add RouteIssue() method for repository routing with confidence scores
- Add AssessQuality() method for issue quality assessment (0.0-1.0 scale)
- Add DetectDuplicate() method for semantic duplicate detection
- Add corresponding prompt builders with JSON-structured outputs
- Define data structures: RouterResult, QualityResult, DuplicateResult

* feat(steps): add three new pipeline steps for intelligent triage

- Add llm_router step for LLM-based repository routing
  - Confidence-based actions: auto-transfer (≥0.9), suggest (0.6-0.9), silent (<0.6)
  - Graceful degradation when LLM unavailable
- Add quality_checker step for issue quality assessment
  - Evaluates completeness and clarity
  - Provides actionable suggestions
- Add duplicate_detector step for semantic duplicate detection
  - Analyzes top 3 similar issues
  - High-confidence threshold (≥0.8)

* feat(steps): rewrite response builder for comprehensive triage summaries

BREAKING CHANGE: Response builder now ALWAYS posts triage summaries

- Remove early return logic - post summary on every issue
- Add quality assessment section with score and suggestions
- Add labels applied section
- Add transfer suggestion section with confidence display
- Add similar issues section with similarity percentages
- Add duplicate warning section with reasoning
- Format as structured markdown with visual indicators (✅, ⚠️, 🔄)

* refactor(steps): simplify triage step to focus on label suggestion

- Remove quality assessment logic (moved to quality_checker step)
- Focus solely on label suggestion using LLM
- Update error handling for graceful degradation

* feat(pipeline): integrate new steps into issue-triage workflow

- Register llm_router, quality_checker, duplicate_detector steps
- Update issue-triage preset workflow order:
  gatekeeper → vectordb_prep → llm_router → transfer_check →
  similarity_search → duplicate_detector → quality_checker →
  triage → response_builder → action_executor →
  pending_action_scheduler → indexer

* fix: address Copilot code review feedback

- Replace deprecated strings.Title with custom capitalizeFirst function
- Make duplicate confidence threshold configurable via TransferConfig
- Change 'Labels Applied' to 'Suggested Labels' for accuracy
- Add DuplicateConfidenceThreshold field with 0.8 default

Author: Kavirubc

.claude/sessions/.current-session

@@ -1 +1 @@
-2026-02-04-0000.md
+2026-02-04-1204.md

.claude/sessions/2026-02-04-0000.md

@@ -2,19 +2,352 @@
 
 ## Session Overview
 - **Start Time**: 2026-02-04 00:00
-- **Status**: Active
+- **End Time**: 2026-02-04 (session completed)
+- **Status**: Completed
+- **Duration**: ~2-3 hours
 
 ## Goals
-- Develop and implement new features for simili-bot
+- Implement Transfer Rules Engine for cross-repository issue routing (Issue #15)
 
-## Progress
+---
 
-### Tasks Completed
-- Session started
+## Git Summary
 
-### Current Work
-- Ready to begin feature development
+### Statistics
+- **Total Files Changed**: 12 files
+- **Lines Added**: +829
+- **Lines Deleted**: -29
+- **Commits Made**: 2 commits
 
-### Notes
--
+### Changed Files
+```
+Modified (9 files):
+  - internal/core/config/config.go
+  - internal/core/pipeline/registry.go
+  - internal/integrations/github/auth.go
+  - internal/integrations/github/client.go
+  - internal/integrations/github/client_test.go
+  - internal/steps/action_executor.go
+  - internal/steps/similarity.go
+  - internal/steps/transfer_check.go
+
+New Files (4 files):
+  - internal/integrations/github/graphql.go
+  - internal/transfer/matcher.go
+  - internal/transfer/matcher_test.go
+  - internal/transfer/types.go
+```
+
+### Commits
+1. `269757b` - fix: address code review feedback
+2. `53abf8b` - feat: Implement Transfer Rules Engine for Cross-Repository Issue Routing (#22)
+
+### Final Git Status
+- Branch: `feature/repo-tranfer-010`
+- Status: Clean (all changes committed and pushed)
+- PR: #22 (ready for review)
+
+---
+
+## Key Accomplishments
+
+### 1. Complete Transfer Rules Engine Implementation
+Implemented a comprehensive rule-based transfer routing system that enables automated cross-repository issue transfers based on configurable conditions.
+
+### 2. Configuration System
+- Added `TransferRule` struct with support for:
+  - `labels` (ALL must match - AND logic)
+  - `labels_any` (ANY must match - OR logic)
+  - `title_contains` (case-insensitive substring matching)
+  - `body_contains` (case-insensitive substring matching)
+  - `author` (exact match, case-insensitive)
+  - `priority` (for rule ordering)
+  - `enabled` (per-rule toggle)
+- Added `TransferConfig` struct with global enable/disable
+- Implemented proper config merging to allow child configs to override parent settings
+
+### 3. Rule Matching Engine (`internal/transfer/`)
+- Created `RuleMatcher` with priority-based evaluation (higher priority rules evaluated first)
+- All condition matching is case-insensitive
+- AND logic between different condition types
+- OR logic within condition arrays (labels_any, title_contains, body_contains, author)
+- Comprehensive test coverage: 12 unit tests covering all scenarios
+
+### 4. GitHub GraphQL Integration
+- Implemented full GraphQL client (`internal/integrations/github/graphql.go`)
+- Added `GetIssueNodeID()` - fetches GraphQL node ID for issues
+- Added `GetRepositoryNodeID()` - fetches GraphQL node ID for repositories
+- Added `TransferIssue()` mutation - performs actual issue transfer
+- Returns new issue URL after successful transfer
+- Proper error handling with truncated error messages (security fix)
+
+### 5. Pipeline Integration
+- Moved `transfer_check` step BEFORE `similarity_search` (critical for performance)
+- Added `skip_duplicate_detection` metadata flag to prevent unnecessary VDB searches
+- Updated `similarity_search` to respect skip flag
+- Updated `action_executor` to handle new TransferIssue signature
+
+### 6. Code Review Fixes
+Addressed all GitHub Copilot code review feedback:
+- Added whitespace trimming for targetRepo validation
+- Truncated error response bodies to prevent sensitive data leaks (200 char limit)
+- Added empty URL validation after transfer completion
+- Fixed Transfer config merge logic to allow child configs to disable parent's enabled transfer
+
+---
+
+## Features Implemented
+
+### Core Features
+1. **Rule-Based Transfer Routing**
+   - Priority-ordered rule evaluation
+   - Multiple condition types with flexible matching
+   - Enable/disable per rule or globally
+
+2. **GitHub GraphQL API Integration**
+   - Issue transfer mutation
+   - Node ID resolution for issues and repositories
+   - Authenticated operations
+
+3. **Pipeline Optimization**
+   - Transfer detection before duplicate search
+   - Metadata-based step coordination
+   - Logging for transparency
+
+### Configuration Example
+```yaml
+transfer:
+  enabled: true
+  rules:
+    - name: "critical-security-bugs"
+      priority: 100
+      target: "org/security-repo"
+      labels: ["security", "critical"]
+
+    - name: "documentation-issues"
+      priority: 50
+      target: "org/docs-repo"
+      labels_any: ["docs", "documentation"]
+```
+
+---
+
+## Problems Encountered & Solutions
+
+### Problem 1: Go Not Installed
+**Issue**: New laptop didn't have Go installed, build failed.
+**Solution**: Installed Go 1.25.6 via Homebrew: `brew install go`
+
+### Problem 2: TransferIssue Signature Mismatch
+**Issue**: Changed TransferIssue to return `(string, error)` but callers expected `error` only.
+**Solution**: Updated `action_executor.go` to capture new URL return value and log it.
+
+### Problem 3: Test Failures After Signature Change
+**Issue**: `client_test.go` expected old signature.
+**Solution**: Updated test to use `_, err :=` pattern and adjusted expected error messages.
+
+### Problem 4: GitHub Copilot Review Findings
+**Issue**: Four code quality issues identified:
+1. No whitespace trimming on input
+2. Potential sensitive data leak in error messages
+3. Missing empty URL validation
+4. Config merge logic prevented disabling parent's enabled transfer
+
+**Solution**: Fixed all issues in separate commit with proper validation and truncation.
+
+---
+
+## Dependencies
+
+### Added
+- None (used existing dependencies)
+
+### Existing Dependencies Used
+- `github.com/google/go-github/v60/github` - REST API
+- Native `net/http` - GraphQL client
+- `encoding/json` - GraphQL request/response handling
+- `gopkg.in/yaml.v3` - Config parsing
+
+---
+
+## Configuration Changes
+
+### New Config Fields
+```go
+type Config struct {
+    // ... existing fields
+    Transfer TransferConfig `yaml:"transfer,omitempty"`
+}
+
+type TransferConfig struct {
+    Enabled bool           `yaml:"enabled"`
+    Rules   []TransferRule `yaml:"rules,omitempty"`
+}
+
+type TransferRule struct {
+    Name          string   `yaml:"name"`
+    Priority      int      `yaml:"priority,omitempty"`
+    Target        string   `yaml:"target"`
+    Labels        []string `yaml:"labels,omitempty"`
+    LabelsAny     []string `yaml:"labels_any,omitempty"`
+    TitleContains []string `yaml:"title_contains,omitempty"`
+    BodyContains  []string `yaml:"body_contains,omitempty"`
+    Author        []string `yaml:"author,omitempty"`
+    Enabled       *bool    `yaml:"enabled,omitempty"`
+}
+```
+
+### Pipeline Changes
+```go
+// Old order:
+"similarity_search", "transfer_check"
+
+// New order (critical change):
+"transfer_check", "similarity_search"
+```
+
+---
+
+## Testing
+
+### Test Coverage
+- **Transfer Package**: 12/12 tests passing
+  - Rule filtering (enabled/disabled)
+  - Priority sorting
+  - Label matching (ALL and ANY)
+  - Title/body substring matching
+  - Author matching
+  - Multiple condition combinations
+  - Empty conditions (catch-all rules)
+
+- **Integration Tests**: All passing
+- **Build**: Successful with no errors
+
+### Test Commands Used
+```bash
+go test ./internal/transfer/... -v
+go test ./...
+go build ./...
+```
+
+---
+
+## Deployment/Release
+
+### PR Created
+- **PR #22**: "feat: Implement Transfer Rules Engine for Cross-Repository Issue Routing"
+- **Status**: Ready for review (marked as ready, not draft)
+- **Commits**: 2 (main implementation + code review fixes)
+- **Checks**: CI/CD running (Build & Test, Lint, Vet)
+
+### Issue Created
+- **Issue #23**: "Hybrid Transfer Routing: Combine Rule-Based + VDB Semantic Matching"
+- **Milestone**: 0.2.0v
+- **Type**: Future enhancement proposal
+- **Details**: Comprehensive design for hybrid approach combining rules + VDB semantic search
+
+---
+
+## Lessons Learned
+
+### Technical Insights
+1. **GraphQL vs REST**: GitHub's REST API doesn't support issue transfers; GraphQL is required
+2. **Node IDs**: GraphQL operations require node IDs, not numeric IDs (requires 2 queries before mutation)
+3. **Config Merging**: Boolean fields need special handling to allow explicit false values
+4. **Error Truncation**: Full API error responses can leak sensitive data in logs
+
+### Design Decisions
+1. **Rule-First Approach**: Start with deterministic rules, add VDB later (hybrid approach for v0.2.0)
+2. **Pipeline Ordering**: Transfer check MUST run before similarity search for performance
+3. **Metadata Communication**: Use `ctx.Metadata` for step coordination (skip flags, reasoning)
+4. **Case-Insensitive Matching**: All rule matching uses `strings.ToLower()` for UX
+
+### Best Practices
+1. Always trim whitespace on user input
+2. Truncate error messages to prevent data leaks
+3. Validate output (e.g., empty URL check)
+4. Write comprehensive tests before implementation
+5. Address code review feedback in separate, focused commits
+
+---
+
+## What Wasn't Completed
+
+### Deferred to Future Versions
+1. **VDB Semantic Router** (Issue #23, v0.2.0)
+   - Search similar issues across repos
+   - Analyze distribution for confidence scoring
+   - LLM-based transfer justification for transparency
+
+2. **Manual Approval Flow**
+   - Optional approval step before transfer execution
+   - Useful for high-risk transfers
+
+3. **Transfer History/Analytics**
+   - Track transfer success rates
+   - Identify misconfigured rules
+
+4. **Rule Testing CLI**
+   - Test rules against historical issues
+   - Validate rule effectiveness before deployment
+
+---
+
+## Tips for Future Developers
+
+### Understanding the Architecture
+```
+Config → RuleMatcher → Context.TransferTarget → ActionExecutor → GraphQL Transfer
+```
+
+### Key Files to Review
+1. `internal/transfer/matcher.go` - Core rule evaluation logic
+2. `internal/integrations/github/graphql.go` - GitHub API integration
+3. `internal/steps/transfer_check.go` - Pipeline integration
+4. `internal/core/config/config.go` - Configuration schema
+
+### Testing Transfer Rules
+```yaml
+# Test config for local development
+transfer:
+  enabled: true
+  rules:
+    - name: "test-rule"
+      priority: 100
+      target: "your-org/test-repo"
+      labels: ["test"]
+      enabled: true
+```
+
+### Debugging Tips
+1. Check logs for `[transfer_check]` entries
+2. Verify `ctx.Metadata["skip_duplicate_detection"]` is set when transfer detected
+3. Use dry-run mode to test without actual transfers
+4. GraphQL errors often require checking GitHub permissions
+
+### Common Pitfalls
+1. **Forgetting to trim whitespace**: Always `strings.TrimSpace()` on config values
+2. **Wrong pipeline order**: `transfer_check` MUST be before `similarity_search`
+3. **Missing GraphQL client**: Requires authentication token in environment
+4. **Node ID confusion**: GitHub has both numeric IDs and GraphQL node IDs
+
+### Future Enhancement Ideas
+- Add regex support for title/body matching
+- Support negative conditions ("NOT contains")
+- Add dry-run flag per rule for testing
+- Implement transfer webhooks/notifications
+- Add transfer rollback capability
+
+---
+
+## Related Issues & PRs
+- Issue #15: Initial transfer logic requirements
+- PR #22: This implementation (merged)
+- Issue #23: Future hybrid approach with VDB routing
+
+## Notes
+- All code follows existing project style and patterns
+- Comprehensive documentation in code comments
+- Test coverage ensures reliability
+- Security considerations addressed (input validation, data leak prevention)
 

.claude/sessions/2026-02-04-1204.md

@@ -0,0 +1,19 @@
+# Development Session - 2026-02-04 12:04
+
+## Session Overview
+**Start Time:** 2026-02-04 12:04
+**Status:** Active
+
+## Goals
+- New feature development
+
+## Progress
+
+### Current Work
+
+
+### Completed
+
+
+### Notes
+