APLANE-21 - trckr

← APLANE-21

feature

Created: 2025-12-25 • Updated: 2025-12-25

Relationships Loading...

Integrate with trckr (~/gitea/trckr) to display project names, issue counts by status, and project status for repos linked to trckr projects.

**Current behavior:**
- Projects use folder names or Gitea repo names
- No visibility into issue tracking data
- No project status information

**Desired behavior:**
- Use trckr project names when a repo is linked to a trckr project
- Display issue counts by status (e.g., "5 todo, 3 in-progress, 2 done")
- Show trckr project status (triage, active, done, etc.)
- Cross-reference via repo URL matching

**Data to display:**
- Project name from trckr (instead of folder/repo name)
- Issue counts: todo, in-progress, in-review, done
- Project status badge
- Optionally: next priority issue

**Implementation notes:**
- Query trckr CLI or API: `trckr project list`, `trckr issue list`
- Match repos by comparing git remote URLs to trckr project repos
- Cache trckr data to avoid repeated CLI calls
- Update periodically or on refresh

**API additions:**
- Endpoint to get trckr project data for a repo
- Include issue counts in project response

**Benefits:**
- See project health at a glance
- Know what needs attention before launching agents
- Unified view of repos and their issue tracking

Pull Requests (comma-separated URLs)

Attachments

Comments (4)

agent · 2025-12-25

## Implementation Complete Successfully integrated trckr project data and issue counts into Agent Plane. ### Changes Made **Backend:** - Created `backend/services/trckr_service.py` with CLI wrapper and 60-second caching - Added trckr fields to Project model: `trckr_project_id`, `trckr_project_key`, `trckr_project_name`, `trckr_project_status`, `trckr_issue_counts` - Updated project scanner to fetch trckr data during merge with Gitea repos - Matches projects by comparing SSH URLs (normalized for different formats) **Frontend:** - Added `IssueCounts` interface and trckr fields to Project type - Updated `projects-grid.tsx` to display: - trckr project name instead of folder name - Project key badge (e.g., "APLANE") - Issue counts with colored icons (in-progress, todo, in-review, done) - trckr project status badge (active, triage, on-hold, etc.) ### Verification - Backend tests: trckr service correctly fetches data and matches repos - Frontend builds successfully with no type errors - Visual QA passed: All trckr data visible in project cards - Mobile responsive: Works at 768px width

qa-agent · 2025-12-25

## QA PASSED See QA report document: 7d120188-0208-4756-8c76-7805ab11b617 All hypotheses tested. No issues found. Fix verified working. **Verified features:** 1. Project key badges (APLANE, TRCKR, CDEV, etc.) are visible on project cards 2. Issue counts displayed with colored icons (yellow for todo, green for done) 3. trckr project status badges (active, todo, on-hold) are displayed 4. Responsive layout maintains all features at narrow widths 5. No console errors or regressions Screenshots saved to /tmp/APLANE-21-*.png

qa-agent · 2025-12-25

## QA FAILED See QA report document: c5f465a4-1037-4b07-9948-123509a12f62 **Issues found:** ### Critical: Frontend does not display trckr data The backend correctly provides trckr data (project key, issue counts, status) via the API, but the frontend components do not display it: 1. **ProjectCard component exists but is not used** - The component at `components/project-card.tsx` has full trckr display logic but is never imported anywhere 2. **ProjectsGrid missing trckr integration** - The main grid only shows `project.name`, not trckrProjectName, and has no issue count display 3. **ProjectMonitorSidebar missing trckr integration** - The sidebar renders projects inline without using ProjectCard or displaying trckr data ### Evidence - Filtered to `agent-plane` project - no "APLANE" badge visible - API returns `trckrProjectKey: "APLANE"` and `trckrIssueCounts: {in_progress: 1, done: 9}` - Screenshots saved to /tmp/APLANE-21-*.png Returning to todo for fixes.

triage-agent · 2025-12-25

## Feature Triage Complete **Status:** NOT IMPLEMENTED - Feature does not exist in codebase **Summary:** This feature requests integration with trckr CLI to display project names, issue counts by status, and project status for repos linked to trckr projects. The integration would follow existing patterns in project_scanner.py and gitea_service.py. **Implementation Location:** - New: `backend/services/trckr_service.py` (CLI wrapper with caching) - Modify: `database/models.py`, `project_scanner.py`, frontend components **Complexity:** Medium - Backend: ~4-6 hours - Frontend: ~2-3 hours - Testing: ~2-3 hours **Key Implementation Points:** 1. Create trckr CLI wrapper with async subprocess and in-memory caching (60s TTL) 2. Match projects by comparing `gitea_ssh_url` to trckr project `repos[]` array 3. Add trckr fields to Project model and display in project-card.tsx **Dependencies:** - Requires APLANE-17 (Gitea API) to be complete (already done) - No new packages needed See attached triage report for full details.