@itphx/synth-backend 0.10.0 → 0.11.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/dist/app/bootstrap.d.ts +11 -0
  2. package/dist/app/bootstrap.js +19 -0
  3. package/dist/app/deps.d.ts +124 -0
  4. package/dist/app/deps.js +751 -0
  5. package/dist/app/listen.d.ts +34 -0
  6. package/dist/app/listen.js +309 -0
  7. package/dist/app/mount-routes.d.ts +31 -0
  8. package/dist/app/mount-routes.js +696 -0
  9. package/dist/app/sse-events.d.ts +15 -0
  10. package/dist/app/sse-events.js +83 -0
  11. package/dist/app.d.ts +30 -17
  12. package/dist/app.js +164 -1337
  13. package/dist/auth/guards.d.ts +2 -1
  14. package/dist/auth/guards.js +10 -2
  15. package/dist/auth/middleware.d.ts +9 -14
  16. package/dist/auth/middleware.js +38 -6
  17. package/dist/auth/oidc.d.ts +22 -0
  18. package/dist/auth/oidc.js +68 -9
  19. package/dist/auth/service-scope.d.ts +8 -4
  20. package/dist/auth/service-scope.js +9 -5
  21. package/dist/events/hub.d.ts +2 -2
  22. package/dist/events/hub.js +3 -38
  23. package/dist/lib/app-config.d.ts +2 -0
  24. package/dist/lib/app-config.js +3 -2
  25. package/dist/lib/cors.d.ts +23 -0
  26. package/dist/lib/cors.js +24 -0
  27. package/dist/lib/defaults-store.d.ts +2 -25
  28. package/dist/lib/defaults-store.js +5 -87
  29. package/dist/lib/i18n.js +58 -6
  30. package/dist/main.js +23 -7
  31. package/dist/middleware/rate-limiter.d.ts +4 -1
  32. package/dist/middleware/rate-limiter.js +4 -2
  33. package/dist/routes/agents.d.ts +2 -2
  34. package/dist/routes/audit.d.ts +1 -1
  35. package/dist/routes/audit.js +2 -2
  36. package/dist/routes/auth.d.ts +2 -2
  37. package/dist/routes/auth.js +28 -4
  38. package/dist/routes/context.d.ts +2 -2
  39. package/dist/routes/gateway-patterns.d.ts +3 -3
  40. package/dist/routes/gateway-patterns.js +1 -1
  41. package/dist/routes/llm.d.ts +8 -2
  42. package/dist/routes/llm.js +9 -5
  43. package/dist/routes/mcp-registry.d.ts +6 -6
  44. package/dist/routes/mcp-registry.js +10 -10
  45. package/dist/routes/mcp.d.ts +1 -1
  46. package/dist/routes/mcp.js +1 -1
  47. package/dist/routes/messages.d.ts +5 -4
  48. package/dist/routes/messages.js +30 -3
  49. package/dist/routes/models.d.ts +7 -2
  50. package/dist/routes/models.js +3 -1
  51. package/dist/routes/projects.d.ts +7 -7
  52. package/dist/routes/projects.js +7 -7
  53. package/dist/routes/providers.d.ts +15 -3
  54. package/dist/routes/providers.js +34 -21
  55. package/dist/routes/queue.d.ts +5 -4
  56. package/dist/routes/queue.js +30 -3
  57. package/dist/routes/sessions.d.ts +14 -4
  58. package/dist/routes/sessions.js +234 -34
  59. package/dist/routes/users.js +1 -1
  60. package/dist/test-helpers/close-server.d.ts +33 -0
  61. package/dist/test-helpers/close-server.js +50 -0
  62. package/package.json +3 -3
@@ -0,0 +1,696 @@
1
+ // Монтирование HTTP-роутов API v2 backend (Hono API Hub).
2
+ // Порядок `app.route`/`app.get` сохраняется 1:1 с прежним `app.ts` — он
3
+ // определяет приоритеты маршрутов (статические сегменты раньше параметрических,
4
+ // SSE-хаб `/api/v2/events` после роутов событий, но до admin-роутов).
5
+ // Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
6
+ import { isAbsolute, normalize, resolve } from 'node:path';
7
+ import { DEFAULT_LLM_GATEWAY_RATE_LIMIT, ProjectRole, SYNTH_VERSION, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword } from '@itphx/synth-shared';
8
+ import { DEFAULT_AGENT_ID, RateLimiter, getPublicOpenApiDocument, createFsRoutes, createGitRoutes, createSshKeyRoutes, createAgentSshKeyRoutes, createEventRoutes, createSchedulerRoutes, createServiceKeyRoutes, createWebhookRoutes, mergeLlmGatewayConfig, mergeSecurityConfig, createSkillRoutes, createCommandRoutes, createSkillBundleRoutes, createSessionSkillScopeRoutes, createProjectSkillScopeRoutes, createSkillSettingsRoutes, createIdentityRoutes, createMaintenanceRoutes, createAnalyticsRoutes, AnalyticsService, createProjectPortableRoutes, createStorageContextAsync, ProjectInstructionsResolver, createInstructionsInfoResolver, createSettingsRoutes, createDictionaryRoutes, createAuditRoutes as createSecurityAuditRoutes, currentEgressLog, createContextRoutes as createCoreContextRoutes, createMetricsSettingsRoutes, resolveProjectWorkspace, } from '@itphx/synth-core';
9
+ import { createProjectRoutes, createProjectAccess } from '../routes/projects.js';
10
+ import { createSessionRoutes } from '../routes/sessions.js';
11
+ import { createMessageRoutes } from '../routes/messages.js';
12
+ import { createQueueRoutes } from '../routes/queue.js';
13
+ import { createProviderRoutes } from '../routes/providers.js';
14
+ import { createModelRoutes } from '../routes/models.js';
15
+ import { createAgentRoutes } from '../routes/agents.js';
16
+ import { createMcpRoutes } from '../routes/mcp.js';
17
+ import { createContextRoutes as createContextFileRoutes } from '../routes/context.js';
18
+ import { createDebugRoutes } from '../routes/debug.js';
19
+ import { createUserRoutes } from '../routes/users.js';
20
+ import { createAuditRoutes } from '../routes/audit.js';
21
+ import { createLogsRoutes, resolveLogDir } from '../routes/logs.js';
22
+ import { createGatewayPatternsRoutes } from '../routes/gateway-patterns.js';
23
+ import { createLlmRoutes } from '../routes/llm.js';
24
+ import { createRateLimiter } from '../middleware/rate-limiter.js';
25
+ import { scopeGuard, serviceProjectProjection } from '../auth/service-scope.js';
26
+ import { requireAdminOrScope } from '../auth/guards.js';
27
+ import { t, getTranslations } from '../lib/i18n.js';
28
+ import { registerEventsSse } from './sse-events.js';
29
+ /**
30
+ * Смонтировать все `/api/v2/*`-роуты и служебные заглушки (`/api/config/themes`,
31
+ * i18n-эндпоинты) в порядке, идентичном прежнему `createBackendApp`.
32
+ */
33
+ export function mountBackendRoutes(app, auth, ctx) {
34
+ const { config, deps } = ctx;
35
+ const { dataDir, projectStore, sessionManager, eventBus, queueManager, processMessage, orchestrator, profilesStore, getDefaultAgentId, requestSessionService, contextOptimizer, protectedPathsStore, providerStore, providerCache, modelStore, modelCache, agentStore, agentRegistry, contextConfig, sshKeyStore, commandService, bundleStore, dictionaries, serviceApiKeyStore, eventIngress, eventBindingStore, eventJournal, routeRuleStore, eventApiKeyStore, schedulerService, scheduleStore, jobStore, webhookStore, webhookDeliveryStore, webhookService, webhooksConfig, eventHub, mcpManager, mcpRegistryStore, skillService, settingsStore, egressResolver, securityAudit, egressRequests, defaultWorkingDir, patternStore, toolRegistry, gatewayAuditLogger, gatewayPayloadLogPath, gatewayConfig, providerLoader, modelLoader, modelWindowLoader, resolveAgentTemplate, identityClaimStore, live, maintenanceAudit, analyticsRollups, analytics, metrics, } = deps;
36
+ /**
37
+ * Fallback-пара «модель по умолчанию» из config (`llm.defaultProvider` +
38
+ * `llm.defaultModel`) — только если заданы оба.
39
+ */
40
+ const backendConfigDefaultModel = () => config.synth.llm.defaultProvider && config.synth.llm.defaultModel
41
+ ? { provider: config.synth.llm.defaultProvider, model: config.synth.llm.defaultModel }
42
+ : null;
43
+ // API-заглушки для UI
44
+ app.get('/api/config/themes', (c) => c.json({ themes: [] }));
45
+ // i18n endpoints
46
+ app.get('/api/v2/i18n/current', (c) => {
47
+ const header = c.req.header('Accept-Language');
48
+ const lang = header?.split(',')[0]?.trim()?.slice(0, 2) === 'en' ? 'en' : 'ru';
49
+ return c.json({ language: lang, locale: lang });
50
+ });
51
+ app.get('/api/v2/i18n/translations/ru', (c) => c.json(getTranslations('ru')));
52
+ app.get('/api/v2/i18n/translations/en', (c) => c.json(getTranslations('en')));
53
+ // ADR-052 (этап I): публичный OpenAPI-документ (spike) за requireAuth;
54
+ // публичную выдачу без auth согласуем отдельно.
55
+ app.get('/api/v2/openapi.json', auth.requireAuth, (c) => c.json(getPublicOpenApiDocument()));
56
+ // Projects routes
57
+ app.route('/api/v2/projects', createProjectRoutes(auth, projectStore, sessionManager, config.workspacesRoot, mcpManager, skillService, settingsStore, mcpRegistryStore));
58
+ // ADR-091 (этап 2): портативный экспорт/импорт проекта (скачать/загрузить архив).
59
+ // Managed RBAC: скачивание — право чтения проекта (owner/участник/LEAD/ADMIN),
60
+ // импорт в существующий проект (`mergeInto`) — право редактирования; создание
61
+ // нового проекта — любая аутентифицированная роль. Владелец новых сущностей —
62
+ // текущий пользователь; хаб подписывается на импортированные сессии
63
+ // (ADR-089, инвариант 18).
64
+ app.route('/api/v2/projects', createProjectPortableRoutes({ requireAuth: auth.requireAuth }, {
65
+ dataDir,
66
+ // PROP-032: экспорт/импорт проекта работают через контекст хранения
67
+ // инстанса (иначе — свой файловый контекст, а на `backend=postgres`
68
+ // проект не найден бы).
69
+ storage: deps.storageContext,
70
+ getProject: (id) => projectStore.load(id),
71
+ canRead: async (c, projectId) => {
72
+ const user = await auth.getCurrentUser(c);
73
+ if (!user)
74
+ return false;
75
+ const project = await projectStore.load(projectId);
76
+ return project ? projectAccess.canReadProject(c, project, user.id) : false;
77
+ },
78
+ canEdit: async (c, projectId) => {
79
+ const user = await auth.getCurrentUser(c);
80
+ if (!user)
81
+ return false;
82
+ const project = await projectStore.load(projectId);
83
+ return project ? projectAccess.canEditProjectContent(c, project, user.id) : false;
84
+ },
85
+ // security-фикс 0.11.3: экспорт проекта по умолчанию БЕЗ секретов сессий
86
+ // (карта обфускации LLM Gateway + `metadata.secrets`). Явный opt-in
87
+ // `?withSecrets=true` — только elevated (ADMIN/LEAD): архив проекта
88
+ // содержит сессии других участников, а карта обфускации — это секрет.
89
+ canExportSecrets: (c) => auth.isAdmin(c) || auth.hasRole(c, 'LEAD'),
90
+ audit: maintenanceAudit,
91
+ maxUploadBytes: config.maxUploadBytes,
92
+ resolveOwnerId: (c) => {
93
+ const user = c.get('user');
94
+ return user?.id;
95
+ },
96
+ onSessionCreated: (sessionId, ownerId) => {
97
+ void eventHub.subscribeToSession(ownerId, sessionId);
98
+ },
99
+ messages: {
100
+ forbidden: (c) => t('auth.forbidden', undefined, c),
101
+ notFound: (c) => t('errors.notFound.project', undefined, c),
102
+ invalidBody: (c) => t('errors.validation.projectImportBody', undefined, c),
103
+ invalidArchive: (c) => t('errors.validation.invalidProjectArchive', undefined, c),
104
+ checksumMismatch: (c) => t('errors.validation.projectArchiveChecksum', undefined, c),
105
+ nameConflict: (c) => t('errors.conflict.projectNameInUse', undefined, c),
106
+ confirmRequired: (c) => t('errors.validation.maintenanceConfirmRequired', undefined, c),
107
+ workspaceError: (c) => t('errors.validation.projectWorkspaceRestore', undefined, c),
108
+ payloadTooLarge: (c) => t('errors.payloadTooLarge', undefined, c),
109
+ },
110
+ }));
111
+ // Sessions routes
112
+ app.route('/api/v2/sessions', createSessionRoutes(auth, sessionManager, eventBus, queueManager, processMessage, orchestrator, eventHub, contextOptimizer, projectStore, profilesStore, getDefaultAgentId, requestSessionService, analytics));
113
+ // Messages routes
114
+ app.route('/api/v2/messages', createMessageRoutes(auth, sessionManager, contextOptimizer, eventBus, projectStore));
115
+ // Queue routes
116
+ app.route('/api/v2/queue', createQueueRoutes(auth, sessionManager, queueManager, eventBus, processMessage, projectStore));
117
+ // FS routes (ADR-075): core-фабрика, managed поверх workspace проекта.
118
+ // ADR-089 (P0): доступ к проекту обязателен — иначе любой USER читал/писал бы
119
+ // файлы чужого проекта по id (IDOR). Чтение — canRead, мутации — canEditContent.
120
+ const projectAccess = createProjectAccess(auth);
121
+ app.route('/api/v2/fs', createFsRoutes(auth, config.workspacesRoot, undefined, {
122
+ requireProjectId: true,
123
+ getOutsideRootPolicy: () => 'deny',
124
+ getProtectedPathsPolicy: () => protectedPathsStore.getPolicy(),
125
+ // Лимит загрузки: config/env (resolveMaxUploadBytes), иначе дефолт фабрики.
126
+ maxUploadBytes: config.maxUploadBytes,
127
+ authorizeProject: async (c, projectId) => {
128
+ const user = await auth.getCurrentUser(c);
129
+ if (!user)
130
+ return false;
131
+ const project = await projectStore.load(projectId);
132
+ if (!project)
133
+ return false;
134
+ return c.req.method === 'GET'
135
+ ? projectAccess.canReadProject(c, project, user.id)
136
+ : projectAccess.canEditProjectContent(c, project, user.id);
137
+ },
138
+ getProjectWorkspace: (projectId) => resolveProjectWorkspace(projectId, {
139
+ workspacesRoot: config.workspacesRoot,
140
+ getProject: (id) => projectStore.load(id),
141
+ outsideRootPolicy: () => 'deny',
142
+ strict: true,
143
+ }),
144
+ }));
145
+ // Providers routes
146
+ app.route('/api/v2/providers', createProviderRoutes(auth, providerStore, providerCache, {
147
+ resolvePolicy: () => egressResolver.resolveTools(),
148
+ log: currentEgressLog(),
149
+ }, async () => (await settingsStore.getDefaultModel()) ?? backendConfigDefaultModel()));
150
+ // Models routes
151
+ app.route('/api/v2/models', createModelRoutes(auth, modelStore, providerStore, modelCache, providerCache, {
152
+ getDefaultModel: async () => (await settingsStore.getDefaultModel()) ?? backendConfigDefaultModel(),
153
+ setDefaultModel: (pair) => settingsStore.setDefaultModel(pair),
154
+ }));
155
+ // Agents routes
156
+ app.route('/api/v2/agents', createAgentRoutes(auth, agentStore, agentRegistry, getDefaultAgentId));
157
+ // Context routes (глобальные identity-файлы; админ-мутации)
158
+ app.route('/api/v2/context', createContextFileRoutes(auth, contextConfig));
159
+ // User admin routes
160
+ app.route('/api/v2/users', createUserRoutes(auth, profilesStore));
161
+ // Git routes (ADR-076 §T4): core-фабрика + managed RBAC. Write-эндпоинты
162
+ // (init/clone/register/remove/fetch) требуют прав на изменение контента
163
+ // проекта (owner/EDITOR/LEAD/ADMIN); read-only (scan/log/commit) — права
164
+ // чтения проекта (owner/участник/LEAD/ADMIN). Проверка — граничный guard
165
+ // core-фабрики (ADR-089, инвариант 16): без неё любой аутентифицированный
166
+ // читал бы git-данные чужого проекта по его id.
167
+ app.route('/api/v2/git', createGitRoutes(auth, projectStore, config.workspacesRoot, {
168
+ sshKeyStore,
169
+ authorizeProject: async (c, projectId) => {
170
+ const user = await auth.getCurrentUser(c);
171
+ if (!user)
172
+ return false;
173
+ const project = await projectStore.load(projectId);
174
+ if (!project)
175
+ return false;
176
+ return projectAccess.canEditProjectContent(c, project, user.id);
177
+ },
178
+ authorizeRead: async (c, projectId) => {
179
+ const user = await auth.getCurrentUser(c);
180
+ if (!user)
181
+ return false;
182
+ const project = await projectStore.load(projectId);
183
+ if (!project)
184
+ return false;
185
+ return projectAccess.canReadProject(c, project, user.id);
186
+ },
187
+ }));
188
+ // SSH-ключи агентов (ADR-076 §T5): core-фабрика + managed RBAC.
189
+ // Ключи — секреты: чтение — requireAuth (глобально), запись — только ADMIN.
190
+ app.route('/api/v2/ssh-keys', createSshKeyRoutes(auth, sshKeyStore, {
191
+ writeGuard: auth.requireAdmin,
192
+ }));
193
+ app.route('/api/v2/agents/:agentId/ssh-keys', createAgentSshKeyRoutes(auth, sshKeyStore, {
194
+ writeGuard: auth.requireAdmin,
195
+ }));
196
+ // ADR-089: приём внешних событий (ingress), биндинги и журнал. Ingress —
197
+ // requireAuth + rate limit (внешние сервисы до ADR-052 используют общий ключ);
198
+ // чтение биндингов/журнала — requireAuth; мутации биндингов — ADMIN.
199
+ // `GET /` не переопределяем — на этом пути SSE-хаб ниже.
200
+ app.route('/api/v2/events', createEventRoutes({ requireAuth: auth.requireAuth }, { ingress: eventIngress, bindingStore: eventBindingStore, journal: eventJournal, routeRuleStore, apiKeyStore: eventApiKeyStore }, {
201
+ // Rate limit — до решения о способе аутентификации; fallback-креды —
202
+ // requireAuth (приём по API-ключу привязки креды пользователя не требует).
203
+ ingestPreGuard: createRateLimiter(120, 60_000),
204
+ ingestGuard: auth.requireAuth,
205
+ // ADR-089/ADR-052: мутации bindings/routes/keys — LEAD и ADMIN; чтение
206
+ // ключей привязки — тоже LEAD и ADMIN (чувствительные метаданные).
207
+ writeGuard: auth.requirePermission('ADMIN', 'LEAD'),
208
+ keyReadGuard: auth.requirePermission('ADMIN', 'LEAD'),
209
+ // ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
210
+ scopeGuard,
211
+ serviceProjectProjection,
212
+ // ADR-089/ADR-052: per-key rate limit и мастер-выключатель приёма (live).
213
+ getKeyRateLimitPerMinute: () => live.getEvents().keyRateLimitPerMinute,
214
+ isEnabled: () => live.getEvents().enabled,
215
+ resolveAgentTemplate,
216
+ sessionExists: async (id) => (await sessionManager.getSession(id)) !== null,
217
+ resolveApiKeySecret: async (raw) => {
218
+ const resolved = await eventApiKeyStore.resolveBySecret(raw);
219
+ if (!resolved)
220
+ return null;
221
+ const binding = await eventBindingStore.get(resolved.credential.bindingId);
222
+ if (!binding)
223
+ return null;
224
+ return { binding, credential: resolved.credential };
225
+ },
226
+ touchApiKey: (id) => eventApiKeyStore.touch(id),
227
+ messages: {
228
+ invalidEvent: (c) => t('errors.validation.invalidEvent', undefined, c),
229
+ invalidBinding: (c) => t('errors.validation.invalidBinding', undefined, c),
230
+ bindingNotFound: (c) => t('errors.notFound.binding', undefined, c),
231
+ invalidRule: (c) => t('errors.validation.invalidRule', undefined, c),
232
+ ruleNotFound: (c) => t('errors.notFound.rule', undefined, c),
233
+ unknownAgent: (c) => t('errors.validation.unknownAgent', undefined, c),
234
+ invalidKey: (c) => t('errors.validation.invalidEventKey', undefined, c),
235
+ keyNotFound: (c) => t('errors.notFound.eventKey', undefined, c),
236
+ invalidKeyUpdate: (c) => t('errors.validation.invalidEventKeyUpdate', undefined, c),
237
+ keyLabelConflict: (c) => t('errors.conflict.eventKeyLabel', undefined, c),
238
+ rateLimitedKey: (c) => t('errors.rateLimited.eventKey', undefined, c),
239
+ eventsDisabled: (c) => t('errors.unavailable.eventsDisabled', undefined, c),
240
+ },
241
+ }));
242
+ // ADR-051 / ADR-089: CRUD расписаний, принудительный запуск и Job-история.
243
+ // Чтение — requireAuth (дефолт core-фабрики), мутации — ADMIN. `run` —
244
+ // ADMIN + rate limit (образец — ingest внешних событий): 10 запусков / 60 c
245
+ // на ключ, т.к. каждый запуск ингестит событие в Router.
246
+ app.route('/api/v2/schedules', createSchedulerRoutes(auth, { scheduleStore, scheduler: schedulerService, jobStore }, {
247
+ writeGuard: auth.requireAdmin,
248
+ runGuard: auth.requireAdmin,
249
+ runMiddleware: [createRateLimiter(10, 60_000)],
250
+ // ADR-052 (этап I): scope-гейт, проектная проекция и резолвинг
251
+ // projectId `bound`/`queue`-целей расписания.
252
+ scopeGuard,
253
+ serviceProjectProjection,
254
+ resolveSessionProject: async (id) => (await sessionManager.getSession(id))?.projectId,
255
+ }));
256
+ // ADR-052 (этап I): CRUD service-key инстанса (`synth_svc_…`). Managed RBAC:
257
+ // только ADMIN (ключи дают машинный доступ — управление админское), i18n.
258
+ app.route('/api/v2/service-keys', createServiceKeyRoutes({ requireAuth: auth.requireAuth }, { store: serviceApiKeyStore }, {
259
+ writeGuard: auth.requirePermission('ADMIN'),
260
+ readGuard: auth.requirePermission('ADMIN'),
261
+ // createdBy: `attachUser` уже положил пользователя в контекст — берём его id.
262
+ resolveUserId: (c) => {
263
+ const user = c.get('user');
264
+ return user?.id ?? '';
265
+ },
266
+ messages: {
267
+ invalidKey: (c) => t('errors.validation.invalidServiceKey', undefined, c),
268
+ keyNotFound: (c) => t('errors.notFound.serviceKey', undefined, c),
269
+ keyLabelConflict: (c) => t('errors.conflict.serviceKeyLabel', undefined, c),
270
+ },
271
+ }));
272
+ // ADR-052 (этап II): подписки на исходящие webhooks (CRUD + журнал + тест).
273
+ // Managed RBAC: только ADMIN (webhook может утекать данные на произвольный
274
+ // URL), i18n. Мастер-выключатель `webhooks.enabled` → 503 на мутации/тест.
275
+ app.route('/api/v2/webhooks', createWebhookRoutes({ requireAuth: auth.requireAuth }, { store: webhookStore, deliveryStore: webhookDeliveryStore, service: webhookService }, {
276
+ writeGuard: auth.requirePermission('ADMIN'),
277
+ readGuard: auth.requirePermission('ADMIN'),
278
+ resolveUserId: (c) => {
279
+ const user = c.get('user');
280
+ return user?.id ?? 'unknown';
281
+ },
282
+ isEnabled: () => webhooksConfig.enabled,
283
+ // Отдельный экземпляр политики (live; граница доверия не смешивается с tools).
284
+ resolvePolicy: () => egressResolver.resolveWebhooks(),
285
+ messages: {
286
+ invalid: (c) => t('errors.validation.invalidWebhook', undefined, c),
287
+ notFound: (c) => t('errors.notFound.webhook', undefined, c),
288
+ labelConflict: (c) => t('errors.conflict.webhookLabel', undefined, c),
289
+ targetForbidden: (c) => t('errors.validation.webhookTargetForbidden', undefined, c),
290
+ disabled: (c) => t('errors.unavailable.webhooksDisabled', undefined, c),
291
+ },
292
+ }));
293
+ // ADR-091/ADR-092: обслуживание инстанса (backup/restore/doctor/migrate).
294
+ // Managed RBAC: только ADMIN — операции меняют/отдают данные всего инстанса
295
+ // (архивы могут содержать секреты), i18n.
296
+ // PROP-032: при backend=postgres doctor/migrations ходят в БД через read-only
297
+ // пробу (контекст в режиме `skip` — миграции не применяются).
298
+ const maintenanceBackend = resolveStorageBackend(config.synth, process.env);
299
+ const withPostgresContext = maintenanceBackend === 'postgres'
300
+ ? async (fn) => {
301
+ const ctx = await createStorageContextAsync('postgres', {
302
+ dataDir,
303
+ secretKey: resolveSecretKey(config.synth),
304
+ env: process.env,
305
+ postgres: resolvePostgresConfig(config.synth, process.env),
306
+ postgresPassword: resolvePostgresPassword({ dataDir }, process.env),
307
+ postgresSchemaMode: 'skip',
308
+ });
309
+ try {
310
+ return await fn(ctx);
311
+ }
312
+ finally {
313
+ await ctx.close?.();
314
+ }
315
+ }
316
+ : undefined;
317
+ app.route('/api/v2/maintenance', createMaintenanceRoutes({ requireAuth: auth.requireAuth }, {
318
+ dataDir,
319
+ secretKey: resolveSecretKey(config.synth),
320
+ env: process.env,
321
+ audit: maintenanceAudit,
322
+ storageBackend: maintenanceBackend,
323
+ ...(withPostgresContext
324
+ ? {
325
+ dbHealth: () => withPostgresContext((ctx) => (ctx.health ? ctx.health() : Promise.resolve({ ok: false, error: 'нет health()' }))),
326
+ schemaMigrations: (o) => withPostgresContext((ctx) => ctx.schemaMigrations ? ctx.schemaMigrations(o) : Promise.reject(new Error('нет schemaMigrations()'))),
327
+ }
328
+ : {}),
329
+ }, {
330
+ writeGuard: auth.requirePermission('ADMIN'),
331
+ readGuard: auth.requirePermission('ADMIN'),
332
+ maxUploadBytes: config.maxUploadBytes,
333
+ resolveUserId: (c) => {
334
+ const user = c.get('user');
335
+ return user?.id ?? 'unknown';
336
+ },
337
+ messages: {
338
+ invalidBody: (c) => t('errors.validation.invalidMaintenanceBody', undefined, c),
339
+ confirmRequired: (c) => t('errors.validation.maintenanceConfirmRequired', undefined, c),
340
+ backupNotFound: (c) => t('errors.notFound.backup', undefined, c),
341
+ invalidBackupName: (c) => t('errors.validation.invalidBackupName', undefined, c),
342
+ payloadTooLarge: (c) => t('errors.payloadTooLarge', undefined, c),
343
+ invalidArchive: (c) => t('errors.validation.invalidRestoreArchive', undefined, c),
344
+ schemaTooNew: (c) => t('errors.conflict.schemaTooNew', undefined, c),
345
+ invalidAuditLimit: (c) => t('errors.validation.invalidAuditLimit', undefined, c),
346
+ invalidAuditOp: (c) => t('errors.validation.invalidAuditOp', undefined, c),
347
+ encryptedRestore: (c) => t('errors.validation.encryptedRestoreUnsupported', undefined, c),
348
+ restartUnsupported: (c) => t('errors.unavailable.restartUnsupported', undefined, c),
349
+ },
350
+ }));
351
+ // MCP routes (единый реестр; legacy /servers — адаптеры над ним)
352
+ app.route('/api/v2/mcp', createMcpRoutes(auth, mcpManager, sessionManager, {
353
+ registry: mcpRegistryStore,
354
+ // Политика резолвится на каждый запрос (live; исключения/режим — из стора).
355
+ getNetworkPolicy: () => egressResolver.resolveMcp(),
356
+ }));
357
+ // Скиллы (ADR-046 §9.1/§9.2): core-фабрика + RBAC ADMIN на запись.
358
+ app.route('/api/v2/skills', createSkillRoutes(auth, {
359
+ skillService,
360
+ resolveProjectWorkspace: async (projectId) => {
361
+ const project = await projectStore.load(projectId);
362
+ if (!project?.workspace)
363
+ return undefined;
364
+ return isAbsolute(project.workspace)
365
+ ? normalize(project.workspace)
366
+ : resolve(config.workspacesRoot, project.workspace);
367
+ },
368
+ }, { writeGuard: requireAdminOrScope('addons:install') }));
369
+ // ADR-046 §7/§9.1: команды и bundles (mirror core, мутации — ADMIN).
370
+ app.route('/api/v2/commands', createCommandRoutes(auth, {
371
+ commandService,
372
+ resolveProjectWorkspace: async (projectId) => {
373
+ const project = await projectStore.load(projectId);
374
+ if (!project?.workspace)
375
+ return undefined;
376
+ return isAbsolute(project.workspace)
377
+ ? normalize(project.workspace)
378
+ : resolve(config.workspacesRoot, project.workspace);
379
+ },
380
+ }));
381
+ app.route('/api/v2/skill-bundles', createSkillBundleRoutes(auth, {
382
+ bundleStore,
383
+ validateSkills: async (names) => {
384
+ const missing = [];
385
+ for (const name of names) {
386
+ if (!(await skillService.get(name)))
387
+ missing.push(name);
388
+ }
389
+ return missing;
390
+ },
391
+ }, { writeGuard: auth.requireAdmin }));
392
+ // ADR-046 §4.5: scope-API скиллов. Доступ к сессии — та же семантика, что у
393
+ // `createSessionRoutes` (единая точка истины на ресурс сессии): владелец|ADMIN
394
+ // (`canAccess`), участник проекта (`resolveCanAccessExtra`), сквозной обзор
395
+ // ADMIN/LEAD (`resolveElevated`); проект — owner/LEAD/ADMIN.
396
+ const resolveSkillWorkspace = async (projectId) => {
397
+ const project = await projectStore.load(projectId);
398
+ if (!project?.workspace)
399
+ return undefined;
400
+ return isAbsolute(project.workspace)
401
+ ? normalize(project.workspace)
402
+ : resolve(config.workspacesRoot, project.workspace);
403
+ };
404
+ app.route('/api/v2/sessions', createSessionSkillScopeRoutes(auth, {
405
+ sessionManager, skillService, settingsStore, projectStore,
406
+ permissionConfig: config.synth.permission,
407
+ resolveProjectWorkspace: resolveSkillWorkspace,
408
+ }, {
409
+ writeGuard: auth.requireAuth,
410
+ resolveUserId: async (c) => (await auth.getCurrentUser(c))?.id ?? '',
411
+ canAccess: (session, c, userId) => (session.ownerId ?? session.userId) === userId
412
+ || auth.isAdmin(c),
413
+ resolveElevated: (c) => auth.isAdmin(c) || auth.hasRole(c, 'LEAD'),
414
+ // read/write по роли в проекте (та же модель `createProjectAccess`, что и в
415
+ // session/message/queue-фабриках): GET — owner/любой участник, PUT — owner/EDITOR.
416
+ resolveCanAccessExtra: (() => {
417
+ const { canReadProject, canEditProjectContent } = createProjectAccess(auth);
418
+ return async (session, c, userId, access) => {
419
+ if (!session.projectId)
420
+ return false;
421
+ const project = await projectStore.load(session.projectId);
422
+ if (!project)
423
+ return false;
424
+ const ctx = c;
425
+ return access === 'read'
426
+ ? canReadProject(ctx, project, userId)
427
+ : canEditProjectContent(ctx, project, userId);
428
+ };
429
+ })(),
430
+ }));
431
+ app.route('/api/v2/projects', createProjectSkillScopeRoutes(auth, {
432
+ sessionManager, skillService, settingsStore, projectStore,
433
+ permissionConfig: config.synth.permission,
434
+ resolveProjectWorkspace: resolveSkillWorkspace,
435
+ }, {
436
+ // ADR-046 §4.5: проектным уровнем управляют owner/LEAD/ADMIN — как в
437
+ // project-MCP (`canManageProjectMcp`), поэтому writeGuard не requireAdmin;
438
+ // владение проверяет canAccessProject (403 не-членам, 404 — нет проекта).
439
+ writeGuard: auth.requireAuth,
440
+ resolveUserId: async (c) => (await auth.getCurrentUser(c))?.id ?? '',
441
+ canAccessProject: (project, c, userId) => auth.isAdmin(c)
442
+ || auth.hasRole(c, 'LEAD')
443
+ || project.ownerId === userId
444
+ || project.members?.[userId] === ProjectRole.OWNER,
445
+ }));
446
+ app.route('/api/v2/settings', createSkillSettingsRoutes(auth, { settingsStore }, {
447
+ writeGuard: auth.requireAdmin,
448
+ onSkillsDisabledChange: (disabled) => orchestrator.setSkillsDisabled(disabled),
449
+ }));
450
+ // ADR-089: идентичности текущего пользователя (`GET/DELETE /api/v2/me/identities`).
451
+ // RBAC: аутентифицированный пользователь (только свои); линковка — claim-flow
452
+ // (`POST /api/v2/me/identities/claim`).
453
+ // Резолвим **id профиля** по `username` аутентифицированного пользователя
454
+ // (OIDC `sub` — не id профиля: профили хранятся под сгенерированным id).
455
+ // Не передаём `roles` — чтобы не перезаписывать роли существующего профиля.
456
+ app.route('/api/v2/me', createIdentityRoutes(auth, profilesStore, {
457
+ resolveProfileId: async (c) => {
458
+ const u = await auth.getCurrentUser(c);
459
+ if (!u)
460
+ return '';
461
+ const profile = (await profilesStore.getProfileByUsername(u.username))
462
+ ?? (await profilesStore.getOrCreateProfile({ username: u.username, email: u.email }));
463
+ return profile.id;
464
+ },
465
+ claimStore: identityClaimStore,
466
+ // ADR-089 (claim-flow): анти-брутфорс одноразового кода (6 символов, TTL 10 мин) —
467
+ // per-user fixed window 60 c (ключ — Authorization-токен, не IP).
468
+ rateLimitGuard: createRateLimiter(10, 60_000, (c) => t('errors.rateLimited.identityClaim', undefined, c)),
469
+ messages: {
470
+ identityNotFound: (c) => t('errors.notFound.identity', undefined, c),
471
+ claimNotFound: (c) => t('errors.notFound.identityClaim', undefined, c),
472
+ claimConflict: (c) => t('errors.conflict.identityClaim', undefined, c),
473
+ claimCodeRequired: (c) => t('errors.validation.claimCodeRequired', undefined, c),
474
+ unauthorized: (c) => t('auth.unauthorized', undefined, c),
475
+ },
476
+ }));
477
+ // LLM Gateway audit routes (ADR-036) — GET только ADMIN/AUDITOR, POST /revealed — все авторизованные
478
+ app.route('/api/v2/audit', createAuditRoutes(auth, {
479
+ auditLogPath: gatewayAuditLogger.logPath,
480
+ sessionExists: async (sessionId) => {
481
+ const session = await sessionManager.getSession(sessionId);
482
+ return session !== null;
483
+ },
484
+ logger: gatewayAuditLogger,
485
+ }));
486
+ // Логи сервисов (core/ui/backend) + полный лог запросов/ответов LLM — чтение, только ADMIN/AUDITOR
487
+ app.route('/api/v2/logs', createLogsRoutes(auth, {
488
+ logDir: resolveLogDir(),
489
+ payloadLogPath: gatewayPayloadLogPath,
490
+ }));
491
+ // LLM Gateway patterns routes (ADR-036) — управление regex-паттернами детекции секретов, только ADMIN
492
+ app.route('/api/v2/gateway', createGatewayPatternsRoutes(auth, patternStore));
493
+ // LLM Proxy (гибридный режим, Часть 5) — OpenAI-совместимый POST /api/v2/llm/chat/completions.
494
+ // Локальный core гоняет LLM-запросы централизованно через LLM Gateway (ADR-036):
495
+ // обфускация/блокировка секретов, rate limit, аудит, полный payload-лог.
496
+ app.route('/api/v2/llm', createLlmRoutes(auth, {
497
+ providerLoader,
498
+ modelLoader,
499
+ // mergeLlmGatewayConfig может вернуть undefined, если ни base, ни runtime не заданы —
500
+ // но schema с default({}) гарантирует base, поэтому подставляем его.
501
+ gatewayConfig: gatewayConfig ?? config.synth.llmGateway,
502
+ gatewayAuditLogger,
503
+ gatewayRateLimiter: new RateLimiter((gatewayConfig ?? config.synth.llmGateway).rateLimit.userPerMinute, (gatewayConfig ?? config.synth.llmGateway).rateLimit.providerPerMinute),
504
+ gatewayPayloadLogPath,
505
+ patternStore,
506
+ rateLimiter: createRateLimiter(120, 60_000),
507
+ // ADR-094: LLM-прокси учитывается в метриках (undefined — выключено).
508
+ metrics,
509
+ }));
510
+ // Settings routes (runtime-настройки для UI: workspace + mcp; переиспользуем core-реализацию)
511
+ app.route('/api/v2/settings', createSettingsRoutes(auth, {
512
+ settingsStore,
513
+ fallbackWorkspace: defaultWorkingDir,
514
+ // ADR-075: managed-развёртывание — политика вне `workspacesRoot` всегда `deny`
515
+ // (enforcement — в `routes/projects.ts`); строго read-only: GET отдаёт
516
+ // fallback + readOnly, PUT/DELETE → 403 WORKSPACE_POLICY_READ_ONLY.
517
+ fallbackWorkspaceOutsideRootPolicy: 'deny',
518
+ workspacePolicyReadOnly: true,
519
+ // Агент по умолчанию при первом развёртывании (config.yaml не задаёт — DEFAULT_AGENT_ID).
520
+ fallbackDefaultAgent: DEFAULT_AGENT_ID,
521
+ // Модель по умолчанию: fallback из config (только если заданы оба поля);
522
+ // runtime-пара приоритетнее. Валидация — провайдер в каталоге + модель `provider/model`.
523
+ fallbackDefaultModel: backendConfigDefaultModel(),
524
+ validateDefaultModel: async (pair) => {
525
+ const provider = await providerStore.load(pair.provider);
526
+ if (!provider)
527
+ return `провайдер "${pair.provider}" не найден`;
528
+ const model = await modelStore.load(`${pair.provider}/${pair.model}`);
529
+ if (!model)
530
+ return `модель "${pair.provider}/${pair.model}" не найдена`;
531
+ return true;
532
+ },
533
+ // ADR-072 Ф2: дефолты из config.yaml (без runtime) — для GET/DELETE-сброса к умолчанию.
534
+ fallbackLlmGateway: {
535
+ enabled: config.synth.llmGateway.enabled,
536
+ inputMode: config.synth.llmGateway.inputMode,
537
+ logPayloads: config.synth.llmGateway.logPayloads,
538
+ rateLimit: {
539
+ userPerMinute: config.synth.llmGateway.rateLimit?.userPerMinute ?? DEFAULT_LLM_GATEWAY_RATE_LIMIT.userPerMinute,
540
+ providerPerMinute: config.synth.llmGateway.rateLimit?.providerPerMinute ?? DEFAULT_LLM_GATEWAY_RATE_LIMIT.providerPerMinute,
541
+ },
542
+ },
543
+ fallbackSecurity: {
544
+ protectedPaths: { enabled: config.synth.security.protectedPaths?.enabled ?? true },
545
+ // ADR-029: askTimeoutMs живёт в permission-секции конфига (не в security).
546
+ askTimeoutMs: config.synth.permission?.askTimeoutMs,
547
+ },
548
+ // ADR-036: live-применение тумблера LLM Gateway из UI — без рестарта сервера.
549
+ onLlmGatewayChange: async (runtime) => {
550
+ const merged = mergeLlmGatewayConfig(config.synth.llmGateway, runtime);
551
+ orchestrator.setGatewayConfig(merged);
552
+ },
553
+ // live-применение тумблера защищённых путей из UI — без рестарта сервера.
554
+ onSecurityChange: async (runtime) => {
555
+ const merged = mergeSecurityConfig(config.synth.security, runtime);
556
+ orchestrator.setSecurityConfig(merged);
557
+ },
558
+ // ADR-071 §2.3: live-применение политики встроенных инструментов из админки.
559
+ fallbackToolsPolicy: config.synth.tools.policy,
560
+ onToolsPolicyChange: async (policy) => {
561
+ orchestrator.setToolsPolicy(policy);
562
+ },
563
+ // ADR-071 §2.3: live-применение политики MCP-инструментов из админки.
564
+ fallbackMcpPolicy: config.synth.mcp.policy,
565
+ onMcpPolicyChange: async (policy) => {
566
+ orchestrator.setMcpPolicy(policy);
567
+ },
568
+ // ADR-071 §2.6: live-применение instance-wide отключения инструментов.
569
+ fallbackToolsDisabled: config.synth.tools.disabled,
570
+ onToolsDisabledChange: async (disabled) => {
571
+ orchestrator.setToolsDisabled(disabled);
572
+ },
573
+ knownTools: () => toolRegistry.list().map((tool) => ({
574
+ name: tool.name,
575
+ capabilities: [...tool.capabilities],
576
+ })),
577
+ // ADR-071 §2.3.1: live-применение политики сетевого доступа MCP из админки.
578
+ fallbackMcpNetworkPolicy: config.synth.mcp.networkPolicy,
579
+ // ADR-071 §2.3.1: колбэк не нужен — `McpManager` резолвит политику из стора
580
+ // при каждом connect/probe (live, без стартового снимка).
581
+ // Egress: дефолты config.yaml для GET/DELETE-сброса + аудит изменений.
582
+ fallbackEgressTools: config.synth.egress.tools,
583
+ fallbackEgressWebhooks: config.synth.egress.webhooks,
584
+ // ADR-099: прокси — config-уровень, runtime-override и файл пароля.
585
+ fallbackProxy: config.synth.proxy,
586
+ // ADR-099: TLS/CA — config-уровень (read-only в UI; runtime — bootstrap).
587
+ fallbackTls: config.synth.security?.tls,
588
+ dataDir,
589
+ env: process.env,
590
+ securityAudit,
591
+ resolveActor: (c) => {
592
+ const user = c.get('user');
593
+ return typeof user?.id === 'string' && user.id ? user.id : 'unknown';
594
+ },
595
+ // ADR-089: дефолт config.yaml для GET/DELETE-сброса раздела «События».
596
+ fallbackEvents: config.synth.events,
597
+ // ADR-089: live-применение runtime-настроек «События» — Router/funnel/pruner.
598
+ onEventsChange: (effective) => {
599
+ live.setEvents(effective);
600
+ },
601
+ // ADR-084: дефолт config.yaml для GET/DELETE-сброса decision-слоя.
602
+ fallbackDecision: config.synth.decision,
603
+ // ADR-084: live-применение runtime-настроек decision-слоя — микро-каскад и
604
+ // роутер читают конфиг геттером оркестратора; события — через `live.setEvents`.
605
+ onDecisionChange: (effective) => {
606
+ live.setDecision(effective);
607
+ },
608
+ protectedPathsStore,
609
+ }, {
610
+ // Instance-wide настройки (ADR-072): все мутации `/api/v2/settings/*`
611
+ // (workspace, mcp, llm-gateway, security, tools-policy, mcp-policy,
612
+ // mcp-network-policy, default-agent, workspace-policy, tools-disabled,
613
+ // protected-paths, events, decision) — только ADMIN (managed RBAC).
614
+ // События/decision наследуют тот же guard (если не заданы отдельно).
615
+ settingsWriteGuard: auth.requirePermission('ADMIN'),
616
+ }));
617
+ // ADR-094: админ-раздел «Наблюдаемость» — runtime `metrics.enabled` (рестарт),
618
+ // live-статус и bearer-токен `/metrics` (write-only, применяется сразу).
619
+ // Managed RBAC: чтение и мутации — только ADMIN.
620
+ app.route('/api/v2/settings', createMetricsSettingsRoutes({ requireAuth: auth.requireAuth }, {
621
+ settingsStore,
622
+ dataDir,
623
+ configEnabled: config.synth.metrics.enabled,
624
+ runningEnabled: ctx.metrics.runningEnabled,
625
+ getRegistry: ctx.metrics.getRegistry,
626
+ getReadiness: ctx.metrics.getReadiness,
627
+ getStorageBackend: () => ctx.metrics.storageBackend,
628
+ getUptimeSec: ctx.metrics.getUptimeSec,
629
+ version: SYNTH_VERSION,
630
+ }, {
631
+ readGuard: auth.requirePermission('ADMIN'),
632
+ writeGuard: auth.requirePermission('ADMIN'),
633
+ }));
634
+ // Журналы безопасности: аудит изменений политик + внешние запросы (egress).
635
+ // Managed RBAC: чтение только ADMIN/AUDITOR.
636
+ app.route('/api/v2/audit', createSecurityAuditRoutes(auth, {
637
+ securityAudit,
638
+ egressRequests,
639
+ }, {
640
+ readGuard: auth.requirePermission('ADMIN', 'AUDITOR'),
641
+ }));
642
+ // PROP-102 (волна 1): отчёты аналитики — только чтение, данных без локализации.
643
+ // Managed RBAC (§7): ADMIN/LEAD — сквозной обзор; AUDITOR — чтение всех отчётов;
644
+ // обычный USER — принудительный фильтр оси `user` по себе (+ 403 на `decision`/`summary`).
645
+ app.route('/api/v2/analytics', createAnalyticsRoutes({ requireAuth: auth.requireAuth }, { service: new AnalyticsService({ repo: analyticsRollups }) }, {
646
+ resolveElevated: (c) => auth.isAdmin(c) || auth.hasRole(c, 'LEAD'),
647
+ resolveAuditor: (c) => auth.hasRole(c, 'AUDITOR'),
648
+ // `attachUser` уже положил пользователя в контекст — берём его id.
649
+ resolveUserId: (c) => {
650
+ const user = c.get('user');
651
+ return user?.id ?? '';
652
+ },
653
+ messages: {
654
+ invalidPeriod: (c) => t('errors.validation.invalidAnalyticsPeriod', undefined, c),
655
+ invalidRange: (c) => t('errors.validation.invalidAnalyticsRange', undefined, c),
656
+ invalidGroupBy: (c) => t('errors.validation.invalidAnalyticsGroupBy', undefined, c),
657
+ invalidOption: (c) => t('errors.validation.invalidAnalyticsOption', undefined, c),
658
+ forbidden: (c) => t('errors.forbidden.analytics', undefined, c),
659
+ },
660
+ }));
661
+ // Словари классификации: чтение — все авторизованные, запись/сброс — ADMIN
662
+ // (тот же guard, что у users.ts). Реализация общая с core; порт — из контекста хранения.
663
+ app.route('/api/v2/dictionaries', createDictionaryRoutes(auth, dictionaries, { writeGuard: auth.requireAdmin }));
664
+ // ADR-069 §9.3: прозрачность проектных инструкций — core-фабрика (резолвер не
665
+ // дублируется). RBAC: сессия — владелец|ADMIN (canAccess, как в session-роутах);
666
+ // проект — owner/LEAD/ADMIN (canAccessProject, как в project-скиллах).
667
+ const instructionsInfoResolver = createInstructionsInfoResolver(new ProjectInstructionsResolver({
668
+ config: config.synth.instructions,
669
+ dictionaryStore: dictionaries,
670
+ dataDir,
671
+ trustedProjectDirs: config.synth.skills.trustedProjectDirs,
672
+ // ADR-069 R3: авто-trust workspace внутри workspacesRoot (managed-каталоги).
673
+ workspacesRoot: config.workspacesRoot,
674
+ }), config.synth.instructions);
675
+ app.route('/api/v2/context', createCoreContextRoutes(auth, {
676
+ resolveInstructions: instructionsInfoResolver,
677
+ sessionManager,
678
+ projectStore,
679
+ resolveProjectWorkspace: resolveSkillWorkspace,
680
+ resolveContextWindow: (session) => {
681
+ const model = session?.settings.model;
682
+ return model ? modelWindowLoader(model) || undefined : undefined;
683
+ },
684
+ resolveUserId: async (c) => (await auth.getCurrentUser(c))?.id ?? '',
685
+ canAccess: (session, c, userId) => (session.ownerId ?? session.userId) === userId
686
+ || auth.isAdmin(c),
687
+ canAccessProject: (project, c, userId) => auth.isAdmin(c)
688
+ || auth.hasRole(c, 'LEAD')
689
+ || project.ownerId === userId
690
+ || project.members?.[userId] === ProjectRole.OWNER,
691
+ }));
692
+ // Глобальный SSE-хаб для всех сессий пользователя (ADR-052: `events:watch`).
693
+ registerEventsSse(app, { auth, eventHub, scopeGuard });
694
+ // Admin routes (кроме graceful shutdown — он живёт в main.ts, т.к. требует server)
695
+ app.route('/api/v2/admin/debug', createDebugRoutes(auth));
696
+ }