feat(api, web): enhance agent management and linting capabilities

- Added a new linting command for OpenAPI specifications in the package.json, improving code quality checks.
- Updated frontend documentation to clarify component usage and structure, including detailed descriptions for `SettingsShell` and `Auth callback`.
- Refactored agent-related API routes to streamline control-plane functionalities, consolidating multiple routes for better organization.
- Improved error handling in the API to provide more informative responses for validation errors, enhancing user feedback during interactions.

These changes enhance the overall development experience and improve the management of agents within the application.

.cursor/rules/frontend-shadcn.mdc

@@ -36,9 +36,8 @@ Monorepo — [`frontend-monorepo.mdc`](frontend-monorepo.mdc). ReUI — [`reui-m
 | `PageShell` | `page-shell.tsx` |
 | `ResourcePage` | `reui-kit/resource-page.tsx` |
 | `OpsDashboard` / `KpiStatGrid` / `QuickActionGrid` | `reui-kit/ops-dashboard.tsx`, `kpi-stat-grid.tsx`, `quick-action-grid.tsx` |
-| `KanbanBoard` | `reui-kit/kanban-board.tsx` |
 | `DetailPanel` | `reui-kit/detail-panel.tsx` |
-| `SettingsShell` | `reui-kit/settings-shell.tsx` |
+| `SettingsShell` | `reui-kit/settings-shell.tsx` (multi-tab; single-page settings — PageShell + Frame) |
 | `EmptyState` | `empty-state.tsx` |
 | `QueryState` | `query-state.tsx` |
 | `ConfirmDialog` | `confirm-dialog.tsx` |
@@ -85,10 +84,10 @@ pnpm dlx shadcn@latest apply b2fA --only theme -y
 | Зона | Файл | Preview |
 |------|------|---------|
 | Shell | `layout/app-shell.tsx` | [app-shell-12](https://reui.io/preview/base/app-shell-12) |
-| Login | `routes/login.tsx` | [auth-13](https://reui.io/preview/base/auth-13) |
+| Auth callback | `routes/auth.callback.tsx` (SSO portal) | [auth-13](https://reui.io/preview/base/auth-13) · [empty-state-12](https://reui.io/preview/base/empty-state-12) |
 | Dashboard | `routes/_auth/index.tsx` | [stats-12](https://reui.io/preview/base/stats-12) / dashboard-1 |
 | Lists | `ResourcePage` | [data-grid-filtering-2](https://reui.io/preview/base/data-grid-filtering-2) |
-| Settings | `settings/integrations.tsx` | [settings-16](https://reui.io/preview/base/settings-16) |
+| Settings | `routes/_auth/settings.tsx` | [settings-16](https://reui.io/preview/base/settings-16) |
 
 ## Чеклист
 

.cursor/rules/frontend-ui-patterns.mdc

@@ -48,11 +48,9 @@ apps/web/src/components/  ← shared + domain + layout
   page-shell.tsx
   reui-kit/
     resource-page.tsx     ← list: Frame + line Tabs + Filters + DataGrid
-    kanban-board.tsx      ← kanban + KanbanBoardSkeleton
     detail-panel.tsx      ← detail: Frame header/metrics
-    settings-shell.tsx
+    settings-shell.tsx    ← multi-tab settings (tabs required; no phantom routes)
     ops-dashboard.tsx     ← KPI stats-12 + charts
-  catalog-board-toggle.tsx
   empty-state.tsx
   query-state.tsx
   confirm-dialog.tsx
@@ -70,12 +68,10 @@ apps/web/src/components/  ← shared + domain + layout
 |---------|--------|-----------|
 | Page wrapper | `PageShell` | — |
 | List page | `ResourcePage` | ReUI `Frame` + `data-grid` + `filters` + shadcn `Tabs` `variant="line"` |
-| Catalog / Board | `CatalogBoardToggle` + `ResourcePage` / `KanbanBoard` | `?view=board` на `/groups`, `/services` |
-| Kanban | `KanbanBoard` / `KanbanBoardSkeleton` | ReUI `kanban` + `Frame` |
 | Detail | `DetailPanel` | ReUI `Frame` |
-| Settings | `SettingsShell` | — |
+| Settings | PageShell + Frame + `SettingRow` (или `SettingsShell` при 2+ секциях) | — |
 | Dashboard KPI | `OpsDashboard` / `KpiStatGrid` | ReUI Frame [stats-12](https://reui.io/preview/base/stats-12) hybrid |
-| Quick Actions | `QuickActionGrid` | Frame tiles + Badge «Перейти» |
+| Quick Actions | `QuickActionGrid` (gated `show_quick_actions`) | Frame tiles + Badge «Перейти» |
 | Empty | `EmptyState` | `Empty` |
 | Loading / Error | `QueryState` / kit skeletons | `Skeleton`, `Alert` |
 | Status | `StatusBadge` | ReUI `Badge` (`success`/`info`/`warning`) |
@@ -95,8 +91,6 @@ apps/web/src/components/  ← shared + domain + layout
 
 Max 1 primary (`default`) на экран; остальные `outline` / `ghost`.
 
-Toggle «Доска» / «К каталогу» — всегда `outline` в `primaryAction` / `KanbanBoard.toolbarActions` (не отдельный Frame-shell).
-
 ## Line tabs (project standard)
 
 Эталон: [c-tabs-2](https://reui.io/preview/base/components/c-tabs-2) + counted [filtering-2](https://reui.io/preview/base/data-grid-filtering-2).
@@ -116,16 +110,9 @@ Toggle «Доска» / «К каталогу» — всегда `outline` в `p
 - Active state — Base UI `data-active`, не Radix `data-[state=active]`
 - Не трогать internals `reui/date-selector`
 
-## Catalog / Board (`/groups`, `/services`)
+## Agents list view
 
-| Режим | UI | Search |
-|-------|-----|--------|
-| Catalog (default) | `ResourcePage` + primary create | omit / `view=catalog` |
-| Board | `KanbanBoard` DnD | `?view=board` |
-
-- Groups tabs: Все / С доменами / Пустые
-- Services tabs: Все / Включены / Выключены / Без группы
-- DnD только на board; kanban hooks/cards не удалять
+`?view=cards|table` на `/agents` — `AgentsFleetChrome` (cards) / `ResourcePage` (table). Board/kanban в EvoFirewall нет.
 
 ## Dashboard KPI
 
@@ -178,7 +165,7 @@ Shared chrome (vps-tracker / CFDM / EvoBGP): см. [`docs/ui-design-contract.md`
 
 Каждый блок: **default, hover, focus, disabled, empty, loading, error**.
 
-- **Loading** — `Skeleton` / `ResourcePage` skeleton / `KanbanBoardSkeleton` / `OpsDashboard` skeleton, не Spinner на странице
+- **Loading** — `Skeleton` / `ResourcePage` skeleton / `OpsDashboard` skeleton, не Spinner на странице
 - **Empty** — `EmptyState` с CTA
 - **Zero-results** — message внутри DataGrid (+ «Сбросить»)
 - **Error** — `QueryState` / `Alert` + `onRetry`

.cursor/rules/reui-mcp.mdc

@@ -61,14 +61,14 @@ alwaysApply: true
 |------|------|--------|
 | shadcn | `packages/ui/src/components/` | `@evofw/ui/components/*` |
 | ReUI CLI | `apps/web/src/components/reui/` | `@/components/reui/*` |
-| PRO blocks (reference) | `apps/web/src/components/blocks/` | adapt into kit, не копипаст в routes |
+| PRO blocks (reference) | — | install via CLI → adapt into kit; do not keep demo trees in `src/components/blocks/` |
 | Kit | `apps/web/src/components/reui-kit/` | `@/components/reui-kit/*` |
 
 ## Установленные ReUI (apps/web)
 
 **Components:** `frame`, `data-grid/*`, `filters`, `kanban`, `badge`, `alert`, `autocomplete`, `number-field`, `date-selector`, `color-picker`, `timeline`, `rating`, `phone-input`, `icon-stack`
 
-**Kit:** `ResourcePage`, `KpiStatGrid`, `QuickActionGrid`, `OpsDashboard`, `KanbanBoard`, `DetailPanel`, `SettingsShell`
+**Kit:** `ResourcePage`, `KpiStatGrid`, `QuickActionGrid`, `OpsDashboard`, `DetailPanel`, `SettingsShell`
 
 **Blocks (reference):** `stats-12`, `card-35`, `auth-13`, `app-shell-12`, `settings-16`, `settings-8`, `empty-state-12`, `form-7`, `data-grid-filtering-2`, `dashboard-1`, …