feat(#22): Implement brain query API endpoint #108

Merged
jason.woltje merged 2 commits from feature/22-brain-api into develop 2026-01-30 01:46:00 +00:00
Owner

Summary

Adds the Brain Query API for agent access to workspace data.

Endpoints

POST /api/brain/query

Structured query with filters:

  • Tasks: status, priority, assignee, due dates, overdue, unassigned
  • Events: date range, allDay, upcoming
  • Projects: status, date range
  • Text search across entities
  • Entity type selection

GET /api/brain/context

Agent context summary:

  • Workspace stats (active tasks, overdue, upcoming events)
  • Optional detailed entity lists
  • Configurable event lookahead

GET /api/brain/search

Cross-entity text search with limit

Security

  • AuthGuard, WorkspaceGuard, PermissionGuard
  • Requires WORKSPACE_ANY permission

Tests

  • 41 tests passing (27 service + 14 controller)

QA Checklist

  • Query filters work correctly
  • Context returns accurate summaries
  • Search finds matches across entities
  • Auth guards enforce permissions

Closes #22

## Summary Adds the Brain Query API for agent access to workspace data. ## Endpoints ### POST /api/brain/query Structured query with filters: - Tasks: status, priority, assignee, due dates, overdue, unassigned - Events: date range, allDay, upcoming - Projects: status, date range - Text search across entities - Entity type selection ### GET /api/brain/context Agent context summary: - Workspace stats (active tasks, overdue, upcoming events) - Optional detailed entity lists - Configurable event lookahead ### GET /api/brain/search Cross-entity text search with limit ## Security - AuthGuard, WorkspaceGuard, PermissionGuard - Requires WORKSPACE_ANY permission ## Tests - 41 tests passing (27 service + 14 controller) ## QA Checklist - [ ] Query filters work correctly - [ ] Context returns accurate summaries - [ ] Search finds matches across entities - [ ] Auth guards enforce permissions Closes #22
jason.woltje added 1 commit 2026-01-30 01:40:59 +00:00
- Create brain module with service, controller, and DTOs
- POST /api/brain/query - Structured queries for tasks, events, projects
- GET /api/brain/context - Get current workspace context for agents
- GET /api/brain/search - Search across all entities
- Support filters: status, priority, date ranges, assignee, etc.
- 41 tests covering service (27) and controller (14)
- Integrated with AuthGuard, WorkspaceGuard, PermissionGuard
jason.woltje added 1 commit 2026-01-30 01:45:32 +00:00
jason.woltje merged commit 9977d9bcf4 into develop 2026-01-30 01:46:00 +00:00
jason.woltje deleted branch feature/22-brain-api 2026-01-30 01:46:00 +00:00
Sign in to join this conversation.