git:20260507.1149ed6 to git:20260609.6d2f761

- # AgentRQ Codebase Notes

-

- ## Project layout

- - `backend/` — Go backend (Fiber HTTP, GORM, MCP server)

- - `frontend/` — React frontend

-

- ## Running tests

- ```

- cd backend && go test ./internal/...

- ```

-

- Mock packages are **generated** (gitignored). Run `make mocks` before testing if they are missing. `mockgen` lives at `~/go/bin/mockgen`.

-

- ## MCP server (`backend/internal/controller/mcp/`)

- - `server.go` — all tool handlers (`handleCreateTask`, `handleReply`, etc.) and the `WorkspaceServer` struct

- - Cron validation: `validateCronGranularity` enforces hourly-minimum granularity. Minute field must be a single fixed integer (0-59); wildcards/steps/ranges/comma-lists are rejected.

- - Creating a task with `cron_schedule` sets `status="cron"` on the model.

-

- ## CRUD task controller (`backend/internal/controller/crud/task.go`)

- - Cron validation also lives here for the REST API path (same rules).

- - `isValidTaskStatus` — valid statuses: `notstarted`, `ongoing`, `completed`, `rejected`, `cron`, `blocked`.

-

- ## Commit convention

- Include `Task: <taskID>` in the commit body for traceability.

- ## Coding Standards

- - **API Naming**: All JSON fields in API requests and responses MUST use `camelCase` (e.g., `workspaceId`, `createdAt`). Never use `snake_case` in the API surface.

- - **Backend Layers**: Follow view-entity-model separation; only `view` structs define the API schema. Avoid using repository directly from handlers; use controller methods instead.