AUTO-4 - trckr

← AUTO-4

backend integrations

Created: 2026-02-03 • Updated: 2026-02-03

Relationships Loading...

## Overview
Create wrapper modules for trckr and ntfy CLI integration.

## Tasks
- [ ] Create `server/integrations/__init__.py`
- [ ] Create `server/integrations/trckr.py`:
  - `TrckrIntegration` class
  - `create_issue(title, description, project_id, labels, automation_id, run_id)` → returns issue identifier or None
  - `add_comment(issue_id, body, author, status)` → returns bool
  - Parse trckr CLI output to extract issue ID
- [ ] Create `server/integrations/ntfy.py`:
  - `NtfyIntegration` class with configurable default topic
  - `notify_finding(automation_name, finding, issue_identifier, topic)` → sends notification with click URL
  - `notify_error(automation_name, error, topic)` → sends error notification
  - `notify_run_complete(automation_name, run_id, status, topic)` → status notification

## QA: Live Integration Testing

**Phase Gate 1 - Modules Import:**
```bash
uv run python -c "
from server.integrations.trckr import TrckrIntegration
from server.integrations.ntfy import NtfyIntegration
print('OK')
"
```
✓ PASS: Prints "OK"

**Phase Gate 2 - trckr Issue Creation (LIVE TEST):**
```bash
uv run python -c "
from server.integrations.trckr import TrckrIntegration
ti = TrckrIntegration()
# Create a real test issue
issue_id = ti.create_issue(
    title='[TEST] Integration Test Issue - DELETE ME',
    description='Created by AUTO integration test. Safe to delete.',
    project_id='7adc21d5-eb2d-45c8-962e-5f6c7b4edae9',
    labels=['test', 'automated'],
    automation_id='test-automation',
    run_id='test-run-123'
)
print(f'Created issue: {issue_id}')
assert issue_id is not None
assert issue_id.startswith('AUTO-')
print('OK')
"
```
✓ PASS: Prints issue ID and "OK"
Note: Manually delete the test issue after QA

**Phase Gate 3 - ntfy Notification (LIVE TEST):**
```bash
uv run python -c "
from server.integrations.ntfy import NtfyIntegration
ni = NtfyIntegration(default_topic='joe-test')
# Send test notification
ni.notify_finding(
    automation_name='test-automation',
    finding={'status': 'informational', 'title': 'Test Finding', 'summary': 'Integration test'},
    issue_identifier='AUTO-TEST',
    topic='joe-test'
)
print('Notification sent - check your phone')
print('OK')
"
```
✓ PASS: Prints "OK", notification received on device

**Phase Gate 4 - Error Notification:**
```bash
uv run python -c "
from server.integrations.ntfy import NtfyIntegration
ni = NtfyIntegration(default_topic='joe-test')
ni.notify_error(
    automation_name='test-automation',
    error='Test error message',
    topic='joe-test'
)
print('Error notification sent')
print('OK')
"
```
✓ PASS: Prints "OK", error notification received

Pull Requests (comma-separated URLs)

Attachments

Comments (5)

qa-agent · 2026-02-03

## QA PASSED See QA report document: 2c366773-963c-4895-b4cc-a84b25514d9e **Summary:** - All 4 Phase Gates pass - TrckrIntegration: create_issue, add_comment, update_issue_status, read_issue all verified working - NtfyIntegration: notify_finding, notify_error, notify_run_complete all verified working - Error handling robust (invalid inputs, non-existent issues) - Edge cases handled (special characters, long descriptions) - All 30 existing tests pass (no regressions) Fix verified working.

agent · 2026-02-03

Worker reported implementation complete, updating status to in-review for QA verification

agent · 2026-02-03

Agent assignment: worker-AUTO-4 in worktree /tmp/agent-automations-AUTO-4

agent · 2026-02-03

## Implementation Complete ### What was implemented: 1. **server/integrations/trckr.py** - TrckrIntegration class with: - `create_issue()` - Creates issues via trckr CLI, returns identifier (e.g., AUTO-42) - `add_comment()` - Adds comments with author and status - `update_issue_status()` - Updates issue status - `read_issue()` - Reads issue details - JSON parsing with regex fallback for identifier extraction - Proper timeout and error handling 2. **server/integrations/ntfy.py** - NtfyIntegration class with: - `notify_finding()` - Sends finding notifications with priority mapping - `notify_error()` - Sends error notifications - `notify_run_complete()` - Sends run completion status - Configurable default_topic and server - Priority/tag mapping based on finding severity 3. **server/integrations/__init__.py** - Exports both classes ### All QA Phase Gates PASSED: - Phase Gate 1: Module imports work - Phase Gate 2: trckr issue creation works (created AUTO-14, then archived) - Phase Gate 3: ntfy finding notification works - Phase Gate 4: ntfy error notification works Additional tests: - add_comment() works - notify_run_complete() works ### Files changed: - server/integrations/__init__.py (updated exports) - server/integrations/trckr.py (new file, ~200 lines) - server/integrations/ntfy.py (new file, ~200 lines)

triage-agent · 2026-02-03

## Feature Triage Complete **Status:** NOT IMPLEMENTED **Summary:** This issue requests wrapper modules for trckr and ntfy CLI integration. The feature does not exist yet as the project is greenfield - no Python code exists. However, proven patterns exist in trckr-plow: - `/home/nuc2/gitea/trckr-plow/src/trckr_plow/notify.py` - ntfy integration - `/home/nuc2/gitea/trckr-plow/src/trckr_plow/planning.py` - trckr subprocess calls **Implementation Location:** - `server/integrations/__init__.py` - `server/integrations/trckr.py` - `server/integrations/ntfy.py` **Complexity:** LOW (~200 lines total, straightforward CLI wrappers) **Dependencies:** Requires AUTO-1 (project setup) to be completed first. See attached triage report for full details including recommended implementation approach and edge cases.