feat(F): F-TEST + F-DOC + F-UI-TRIG — Phase F complete!

- F-TEST: tests/test_phase_f_agents.py (1425 lines, 45 tests, all pass) — ReAct Loop, Permissions, Approvals, Skills, Context Builder, Data Policy, Transparency, Workstream, Budget
- F-DOC: docs/api-documentation.md (Phase F endpoints), docs/plugin-development-guide.md (Agent chapter 32), docs/test-strategy.md (Phase F test conventions)
- F-UI-TRIG: trigger_dispatcher dispatches agents on ui.*/context.* events (already implemented in F-PROACTIVE)
- Bug fix: approval.py metadata reserved attribute renamed to request_metadata
- PROGRESS.md: Phase F marked done, ~155/223 tasks done (70%)

docs/api-documentation.md

@@ -273,9 +273,55 @@ Agent Builder, Automation Builder, Cron-Scheduler, Agent Runner.
 
 ### agents (AI Agents)
 
+Phase F — Agent system: CRUD, execution, streaming, runs, tools, skills, approvals, monitoring, AI use-case, unified tasks.
+
 | Method | Path | Description |
 |--------|------|-------------|
-| GET/POST/PUT/DELETE | `/api/v1/agents/*` | AI agent CRUD and runner endpoints. |
+| GET | `/api/v1/agents` | List agent definitions. |
+| POST | `/api/v1/agents` | Create an agent definition. |
+| GET | `/api/v1/agents/{id}` | Get an agent definition. |
+| PATCH | `/api/v1/agents/{id}` | Update an agent definition (optimistic lock via `version`). |
+| DELETE | `/api/v1/agents/{id}` | Delete an agent definition. |
+| POST | `/api/v1/agents/{id}/execute` | Execute an agent (manual trigger). |
+| GET | `/api/v1/agents/{id}/stream` | Stream agent run steps (SSE). |
+| GET | `/api/v1/agents/{id}/runs` | List runs for an agent. |
+| GET | `/api/v1/agents/{id}/runs/{run_id}/steps` | List steps for a run. |
+| GET | `/api/v1/agents/tools` | List available agent tools. |
+| GET | `/api/v1/agents/monitor/stats` | Agent monitor statistics. |
+| GET | `/api/v1/agents/{id}/ai-use-case` | Get AI use-case metadata. |
+| PATCH | `/api/v1/agents/{id}/ai-use-case` | Update AI use-case metadata. |
+
+### skills (AI Skills)
+
+Phase F — Skill registry for agent capabilities.
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/api/v1/skills` | List skills. |
+| POST | `/api/v1/skills` | Register a skill. |
+| PATCH | `/api/v1/skills/{id}` | Update a skill. |
+| DELETE | `/api/v1/skills/{id}` | Delete a skill. |
+
+### approvals (Approval Requests)
+
+Phase F — Human approval workflow for agent actions.
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/api/v1/approvals` | List approval requests (filters: status, entity_type, entity_id, requested_by). |
+| POST | `/api/v1/approvals` | Create an approval request. |
+| POST | `/api/v1/approvals/{id}/approve` | Approve a pending request. |
+| POST | `/api/v1/approvals/{id}/reject` | Reject a pending request. |
+
+### unified-tasks (Unified Tasks)
+
+Phase F — Polymorphic task assignment, subtasks, and goals.
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET/POST | `/api/v1/unified-tasks/*` | Unified task CRUD with polymorphic assignment. |
+| GET/POST | `/api/v1/unified-tasks/*/subtasks` | Subtask management. |
+| GET/POST | `/api/v1/unified-tasks/*/goals` | Goal management. |
 
 ### dms (Document Management System)