@itphx/synth-backend 0.10.1 → 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 (46) hide show
  1. package/dist/app/bootstrap.d.ts +2 -2
  2. package/dist/app/deps.d.ts +50 -32
  3. package/dist/app/deps.js +233 -99
  4. package/dist/app/listen.d.ts +7 -2
  5. package/dist/app/listen.js +12 -1
  6. package/dist/app/mount-routes.d.ts +16 -3
  7. package/dist/app/mount-routes.js +258 -28
  8. package/dist/app.d.ts +16 -7
  9. package/dist/app.js +104 -11
  10. package/dist/auth/guards.d.ts +2 -1
  11. package/dist/auth/guards.js +9 -1
  12. package/dist/auth/middleware.d.ts +2 -12
  13. package/dist/auth/middleware.js +20 -2
  14. package/dist/auth/oidc.d.ts +7 -0
  15. package/dist/auth/oidc.js +27 -6
  16. package/dist/auth/service-scope.d.ts +7 -3
  17. package/dist/auth/service-scope.js +8 -4
  18. package/dist/events/hub.js +3 -38
  19. package/dist/lib/app-config.d.ts +2 -0
  20. package/dist/lib/app-config.js +3 -2
  21. package/dist/lib/defaults-store.d.ts +2 -25
  22. package/dist/lib/defaults-store.js +5 -87
  23. package/dist/lib/i18n.js +48 -0
  24. package/dist/main.js +19 -3
  25. package/dist/routes/agents.d.ts +2 -2
  26. package/dist/routes/auth.d.ts +2 -2
  27. package/dist/routes/context.d.ts +2 -2
  28. package/dist/routes/gateway-patterns.d.ts +2 -2
  29. package/dist/routes/llm.d.ts +8 -2
  30. package/dist/routes/llm.js +4 -1
  31. package/dist/routes/mcp-registry.d.ts +3 -3
  32. package/dist/routes/mcp-registry.js +2 -2
  33. package/dist/routes/messages.d.ts +5 -4
  34. package/dist/routes/messages.js +30 -3
  35. package/dist/routes/models.d.ts +7 -2
  36. package/dist/routes/models.js +3 -1
  37. package/dist/routes/projects.d.ts +3 -3
  38. package/dist/routes/providers.d.ts +15 -3
  39. package/dist/routes/providers.js +33 -21
  40. package/dist/routes/queue.d.ts +5 -4
  41. package/dist/routes/queue.js +30 -3
  42. package/dist/routes/sessions.d.ts +13 -3
  43. package/dist/routes/sessions.js +197 -73
  44. package/dist/test-helpers/close-server.d.ts +33 -0
  45. package/dist/test-helpers/close-server.js +50 -0
  46. package/package.json +3 -3
@@ -6,9 +6,10 @@ import type { QueueProcessorManager } from '@itphx/synth-core';
6
6
  import type { ChatOrchestrator } from '@itphx/synth-core';
7
7
  import type { ContextOptimizer } from '@itphx/synth-core';
8
8
  import type { RequestSessionService } from '@itphx/synth-core';
9
+ import type { AnalyticsRecorder } from '@itphx/synth-core';
9
10
  import type { ProfileStore } from '@itphx/synth-shared';
10
11
  import type { EventHub } from '../events/hub.js';
11
- import type { ProjectStore } from '@itphx/synth-core';
12
+ import type { ProjectRepository } from '@itphx/synth-core';
12
13
  /**
13
14
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
14
15
  * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
@@ -19,8 +20,15 @@ import type { ProjectStore } from '@itphx/synth-core';
19
20
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
20
21
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
21
22
  * (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
23
+ *
24
+ * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
25
+ * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
26
+ * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
27
+ * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
28
+ * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
29
+ * доступа нет (инвариант 16).
22
30
  */
23
- export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?: ProjectStore,
31
+ export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?: ProjectRepository,
24
32
  /** Профили пользователей: display name для статистики (fallback — username). */
25
33
  profilesStore?: ProfileStore,
26
34
  /** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
@@ -29,4 +37,6 @@ resolveDefaultAgent?: () => string | Promise<string>,
29
37
  * ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
30
38
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
31
39
  */
32
- requestSessionService?: RequestSessionService): Hono;
40
+ requestSessionService?: RequestSessionService,
41
+ /** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
42
+ analytics?: AnalyticsRecorder): Hono;
@@ -1,9 +1,10 @@
1
1
  import { Hono } from 'hono';
2
2
  import { MessageRole, generateStreamId, nowISO, sessionMcpUpdateSchema, normalizeIconKey, normalizeColorKey, } from '@itphx/synth-shared';
3
3
  import { createRateLimiter } from '../middleware/rate-limiter.js';
4
- import { scopeGuard, projectGuard } from '../auth/service-scope.js';
5
- import { enqueueUserMessage, serializeSession, isSessionVisible, createSessionRoutes as createCoreSessionRoutes, } from '@itphx/synth-core';
4
+ import { scopeGuard, serviceProjectProjection } from '../auth/service-scope.js';
5
+ import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, } from '@itphx/synth-core';
6
6
  import { t } from '../lib/i18n.js';
7
+ import { createProjectAccess } from './projects.js';
7
8
  /**
8
9
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
9
10
  * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
@@ -14,6 +15,13 @@ import { t } from '../lib/i18n.js';
14
15
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
15
16
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
16
17
  * (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
18
+ *
19
+ * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
20
+ * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
21
+ * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
22
+ * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
23
+ * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
24
+ * доступа нет (инвариант 16).
17
25
  */
18
26
  export function createSessionRoutes(kit, sessionManager, eventBus, queueManager, processMessage, orchestrator, eventHub, contextOptimizer, projectStore,
19
27
  /** Профили пользователей: display name для статистики (fallback — username). */
@@ -24,31 +32,107 @@ resolveDefaultAgent,
24
32
  * ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
25
33
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
26
34
  */
27
- requestSessionService) {
35
+ requestSessionService,
36
+ /** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
37
+ analytics) {
28
38
  const app = new Hono();
29
39
  const agentRegistry = orchestrator.agentRegistry;
40
+ const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
30
41
  // ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
31
42
  const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
32
43
  /**
33
- * ADR-089 / безопасность: доступ к сессии по id для backend-only роутов
34
- * (export/notes/optimization/debug-system-message). Единое правило —
35
- * `isSessionVisible` из core: elevated (ADMIN/LEAD) → всё; владелец → да;
36
- * сессия без владельца → да; иначе сессия проекта видна её owner/участникам
37
- * (`projectStore`). Нет доступа → 404 NOT_FOUND: не раскрываем существование
38
- * чужой сессии (защита от перебора id; ранее здесь была IDOR-уязвимость).
44
+ * Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/export/
45
+ * fork/merge): 10 запросов / 60 с на креду — тот же in-memory `createRateLimiter`,
46
+ * что у `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Значение ниже
47
+ * prompt: операции не частые в живом UI, но дорогие (полный объект сессии,
48
+ * создание форка, копирование сообщений) — защита от всплесков/выкачивания.
39
49
  */
40
- const sessionAccessDenied = async (c, session, currentUser) => {
41
- const user = currentUser ?? (await kit.getCurrentUser(c));
42
- // Вызовы `kit.isAdmin`/`hasRole` защищены `typeof` — у мок-AuthKit в тестах
43
- // они могут отсутствовать (паритет с resolveElevated ниже).
44
- const elevated = (typeof kit.isAdmin === 'function'
45
- && kit.isAdmin(c))
46
- || (typeof kit.hasRole === 'function'
47
- && kit.hasRole(c, 'LEAD'));
48
- if (await isSessionVisible(session, projectStore, { userId: user.id, elevated }))
49
- return null;
50
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
51
- };
50
+ const importRateLimit = createRateLimiter(10, 60_000);
51
+ const exportRateLimit = createRateLimiter(10, 60_000);
52
+ const forkRateLimit = createRateLimiter(10, 60_000);
53
+ const mergeRateLimit = createRateLimiter(10, 60_000);
54
+ /**
55
+ * Единое правило доступа к сессии (читать/писать) — ОДНА точка на весь ресурс
56
+ * `/api/v2/sessions`, включая backend-only маршруты (export/debug/optimization/
57
+ * notes) и core-маршруты. Правило:
58
+ * - elevated (ADMIN/LEAD) → всё (осознанное решение: мутации чужих сессий
59
+ * у LEAD/ADMIN сохранены как есть);
60
+ * - владелец сессии или сессия без владельца → всё;
61
+ * - иначе — роль в проекте: чтение (`GET`/`HEAD`) — проектное чтение
62
+ * (`canReadProject`: owner проекта или любой участник), мутация — проектное
63
+ * редактирование (`canEditProjectContent`: owner/EDITOR).
64
+ * Разделение read/write делает prefix-guard по HTTP-методу (единая точка).
65
+ */
66
+ const sessionAccessPredicate = createSessionAccessPredicate({
67
+ canAccess: (session, c, userId) => {
68
+ const owner = session.ownerId ?? session.userId;
69
+ return !owner || owner === userId
70
+ || (typeof kit.isAdmin === 'function' && kit.isAdmin(c));
71
+ },
72
+ resolveCanAccessExtra: async (session, c, userId, access) => {
73
+ if (!projectStore || !session.projectId)
74
+ return false;
75
+ const project = await projectStore.load(session.projectId);
76
+ if (!project)
77
+ return false;
78
+ const ctx = c;
79
+ return access === 'read'
80
+ ? canReadProject(ctx, project, userId)
81
+ : canEditProjectContent(ctx, project, userId);
82
+ },
83
+ localUserId: 'local',
84
+ });
85
+ /**
86
+ * `GET /:id/export` — единственный `:id`-маршрут, где роль аудита инстанса
87
+ * (`AUDITOR`) является **читателем** сессии: карта обфускации ЛЮБОЙ сессии ему
88
+ * и так доступна (`GET /:id/secrets` — `ADMIN`/`AUDITOR`), поэтому экспорт
89
+ * сессии для него не привилегия сверх того, что у него уже есть. На остальных
90
+ * `:id`-маршрутах правило доступа не меняется (см. матрицу
91
+ * `session-idor-matrix.test.ts`).
92
+ */
93
+ const isSessionExportRequest = (c) => c.req.method === 'GET' && isSessionExportPath(c.req.path);
94
+ const sessionAccessGuard = createSessionAccessGuard({
95
+ param: 'id',
96
+ resolveSession: (id) => sessionManager.getSession(id),
97
+ resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
98
+ isAllowed: async (session, c, userId, access) => {
99
+ // Мок-AuthKit в тестах может не иметь isAdmin/hasRole — защищаем typeof.
100
+ const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
101
+ const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
102
+ if (isAdmin || isLead)
103
+ return true;
104
+ // Роль аудита инстанса — читатель сессии на маршруте экспорта (см. выше).
105
+ if (access === 'read' && isSessionExportRequest(c)) {
106
+ const isAuditor = typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR');
107
+ if (isAuditor)
108
+ return true;
109
+ }
110
+ return sessionAccessPredicate(session, c, userId, access);
111
+ },
112
+ messages: {
113
+ sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
114
+ forbidden: (c) => t('auth.forbidden', undefined, c),
115
+ },
116
+ // `/import` — статический сегмент (не id сессии).
117
+ skipForId: (id) => id === 'import',
118
+ });
119
+ /**
120
+ * Привилегия карты обфускации при экспорте сессии (ADR-036, security-фикс
121
+ * 0.11.3) — отдельный route-level guard: он резолвит сессию, решает «полный
122
+ * экспорт или очищенный» и кладёт решение в контекст Hono. Обработчик
123
+ * `/export` только форматирует ответ по этому решению — копии правила доступа
124
+ * в обработчике нет (инвариант 16).
125
+ */
126
+ const sessionExportGuard = createSessionExportGuard({
127
+ param: 'id',
128
+ resolveSession: (id) => sessionManager.getSession(id),
129
+ resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
130
+ isAdmin: (c) => typeof kit.isAdmin === 'function' && kit.isAdmin(c),
131
+ isAuditor: (c) => typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR'),
132
+ messages: {
133
+ sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
134
+ },
135
+ });
52
136
  /** ADR-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
53
137
  const buildSessionMcpPayload = async (session) => {
54
138
  const servers = await orchestrator.resolveMcpServers(session);
@@ -135,27 +219,58 @@ requestSessionService) {
135
219
  }
136
220
  return c.json({ sessionId: session.id, secrets: session.obfuscationMap ?? {} });
137
221
  });
222
+ // Единый prefix-guard ресурса сессий: вешается ПОСЛЕ `/:id/mcp` и `/:id/secrets`
223
+ // (у них собственные задокументированные правила) и покрывает отладку,
224
+ // оптимизацию, заметки, ЭКСПОРТ и все core-маршруты (core-фабрика
225
+ // регистрируется с registerAccessGuard:false — иначе был бы второй источник
226
+ // правил). `/import` пропускается через guard.skipForId (статический сегмент,
227
+ // не сессия).
228
+ app.use('/:id', kit.requireAuth, sessionAccessGuard);
229
+ app.use('/:id/*', kit.requireAuth, sessionAccessGuard);
138
230
  // GET /api/v2/sessions/:id/export — полный экспорт сессии для переноса между
139
231
  // мирами (publish/fork). Внутренний формат: объект Session (camelCase) из
140
232
  // SessionManager — история сообщений, todos, настройки, заметки, ссылки,
141
233
  // чекпоинты, план-флаг и карта обфускации. Не публичный DTO.
142
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
143
- app.get('/:id/export', kit.requireAuth, async (c) => {
144
- const session = await sessionManager.getSession(c.req.param('id'));
145
- if (!session) {
146
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
234
+ //
235
+ // ВАЖНО (инвариант 16): маршрут зарегистрирован ПОСЛЕ prefix-guard'а —
236
+ // доступ к сессии (404/403) решает ЕДИНЫЙ guard (`sessionAccessGuard`), и
237
+ // второй копии правила в обработчике быть не должно: иначе правила
238
+ // расходятся (было: ложный 403 у `LEAD`, «правило в двух местах»).
239
+ //
240
+ // ПРАВИЛО ОТВЕТА (security-фикс 0.11.3): экспорт переносит СЕКРЕТЫ — карту
241
+ // обфускации LLM Gateway (`obfuscationMap`: плейсхолдер → РЕАЛЬНЫЙ секрет) и
242
+ // реальные значения плейсхолдеров в `metadata.secrets` (ADR-036). Ответ
243
+ // зависит от отдельной привилегии, которую решает route-level guard
244
+ // (`sessionExportGuard`), а не обработчик:
245
+ //
246
+ // - **владелец сессии** (`ownerId ?? userId` === текущий пользователь),
247
+ // **ADMIN**, **AUDITOR** → полный экспорт с картой: это его собственные
248
+ // секреты (ADMIN/AUDITOR — тот же набор привилегий, что у `GET /:id/secrets`);
249
+ // - **прочие читатели сессии** (участник проекта VIEWER/EDITOR, владелец
250
+ // проекта, который не владеет сессией, LEAD) → 200, но ответ **очищен**:
251
+ // без `obfuscationMap` и без `metadata.secrets`. Переносится разговор,
252
+ // который этот пользователь и так видит в UI, — но не чужие секреты (смысл
253
+ // «выгрузки секретов» не теряется, а publish/fork не ломается: форк чужой
254
+ // сессии в проекте остаётся рабочим);
255
+ // - **нет доступа на чтение** (посторонний) → 403 FORBIDDEN (prefix-guard).
256
+ //
257
+ // Очистка — на КОПИИ: сохранённая сессия не мутируется. Формат ответа не
258
+ // меняется (тот же объект Session), очищенный экспорт остаётся валидным
259
+ // payload'ом переноса — импорт его принимает.
260
+ app.get('/:id/export', kit.requireAuth, exportRateLimit, sessionExportGuard, async (c) => {
261
+ const decision = getSessionExportDecision(c);
262
+ if (!decision) {
263
+ // Fail-closed: guard не отработал — отдаём полный экспорт нельзя.
264
+ return c.json({ error: { code: 'INTERNAL_ERROR', message: 'Не удалось подготовить экспорт сессии' } }, 500);
147
265
  }
148
- const denied = await sessionAccessDenied(c, session);
149
- if (denied)
150
- return denied;
151
- return c.json(session);
266
+ return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
152
267
  });
153
268
  // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
154
269
  // (перенос истории между мирами). Тело: объект экспорта + import.project_id
155
270
  // (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
156
271
  // ADR-089: это materialization-операция (создание-как-факт переноса истории),
157
272
  // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
158
- app.post('/import', kit.requireAuth, async (c) => {
273
+ app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
159
274
  const user = (await kit.getCurrentUser(c));
160
275
  const body = await c.req.json().catch(() => ({}));
161
276
  const targetProjectId = body.import?.project_id
@@ -171,12 +286,24 @@ requestSessionService) {
171
286
  if (!existing) {
172
287
  return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
173
288
  }
289
+ // Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
290
+ // workspace — без проверки доступа к проекту получается IDOR (чтение/запись
291
+ // файлов чужого проекта).
292
+ //
293
+ // Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
294
+ // доступа не расширяет права на изменение), поэтому нужен уровень
295
+ // «редактирование контента проекта» (`canEditProjectContent`: owner /
296
+ // EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
297
+ // (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
298
+ // ролью VIEWER получает 403.
299
+ if (!canEditProjectContent(c, existing, user.id)) {
300
+ return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
301
+ }
174
302
  }
175
303
  // ADR-089: materialization (перенос истории), не request — прямой createSession.
176
304
  const session = await sessionManager.createSession({
177
305
  title: typeof body.title === 'string' ? body.title : undefined,
178
306
  projectId: targetProjectId,
179
- engine: typeof body.engine === 'string' ? body.engine : undefined,
180
307
  sessionOrigin: (body.session_origin ?? body.sessionOrigin),
181
308
  settings: (body.settings ?? {}),
182
309
  userId: user.id,
@@ -237,9 +364,7 @@ requestSessionService) {
237
364
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
238
365
  }
239
366
  const user = (await kit.getCurrentUser(c));
240
- const denied = await sessionAccessDenied(c, session, user);
241
- if (denied)
242
- return denied;
367
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
243
368
  const streamId = generateStreamId();
244
369
  const sysMsg = {
245
370
  id: streamId,
@@ -268,9 +393,7 @@ requestSessionService) {
268
393
  if (!session) {
269
394
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
270
395
  }
271
- const denied = await sessionAccessDenied(c, session);
272
- if (denied)
273
- return denied;
396
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
274
397
  return c.json({
275
398
  context_optimization: session.settings.contextOptimization,
276
399
  sliding_window_mode: session.settings.slidingWindowMode,
@@ -291,9 +414,7 @@ requestSessionService) {
291
414
  if (!session) {
292
415
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
293
416
  }
294
- const denied = await sessionAccessDenied(c, session);
295
- if (denied)
296
- return denied;
417
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
297
418
  const body = await c.req.json().catch(() => ({}));
298
419
  await sessionManager.withLock(c.req.param('id'), async (s) => {
299
420
  if (body.context_optimization !== undefined)
@@ -328,9 +449,7 @@ requestSessionService) {
328
449
  if (!session) {
329
450
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
330
451
  }
331
- const denied = await sessionAccessDenied(c, session);
332
- if (denied)
333
- return denied;
452
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
334
453
  if (!contextOptimizer) {
335
454
  return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
336
455
  }
@@ -349,9 +468,7 @@ requestSessionService) {
349
468
  if (!session) {
350
469
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
351
470
  }
352
- const denied = await sessionAccessDenied(c, session);
353
- if (denied)
354
- return denied;
471
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
355
472
  await sessionManager.withLock(session.id, async (s) => {
356
473
  s.summarizationPending = false;
357
474
  await sessionManager.saveSession(s);
@@ -375,9 +492,7 @@ requestSessionService) {
375
492
  if (!session) {
376
493
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
377
494
  }
378
- const denied = await sessionAccessDenied(c, session);
379
- if (denied)
380
- return denied;
495
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
381
496
  return c.json({ notes: session.stickyNotes });
382
497
  });
383
498
  // POST /api/v2/sessions/:id/notes — создать заметку
@@ -387,9 +502,7 @@ requestSessionService) {
387
502
  if (!session) {
388
503
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
389
504
  }
390
- const denied = await sessionAccessDenied(c, session);
391
- if (denied)
392
- return denied;
505
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
393
506
  const body = await c.req.json().catch(() => ({}));
394
507
  if (!body.content?.trim()) {
395
508
  return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
@@ -417,9 +530,7 @@ requestSessionService) {
417
530
  if (!session) {
418
531
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
419
532
  }
420
- const denied = await sessionAccessDenied(c, session);
421
- if (denied)
422
- return denied;
533
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
423
534
  const body = await c.req.json().catch(() => ({}));
424
535
  const noteId = c.req.param('noteId');
425
536
  await sessionManager.withLock(c.req.param('id'), async (s) => {
@@ -444,9 +555,7 @@ requestSessionService) {
444
555
  if (!session) {
445
556
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
446
557
  }
447
- const denied = await sessionAccessDenied(c, session);
448
- if (denied)
449
- return denied;
558
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
450
559
  const noteId = c.req.param('noteId');
451
560
  await sessionManager.withLock(c.req.param('id'), async (s) => {
452
561
  s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
@@ -458,13 +567,17 @@ requestSessionService) {
458
567
  });
459
568
  // Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
460
569
  // последней: статические/backend-only сегменты должны матчиться раньше.
461
- app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService }, {
570
+ app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics }, {
462
571
  resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
463
572
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
464
573
  forkWithOwner: true,
465
- canAccess: (session, c, userId) => isSessionOwner(session, userId) || kit.isAdmin(c),
466
- // ADR-089: сквозной обзор сессий для ADMIN/LEAD. Вызовы `kit.isAdmin`/`hasRole`
467
- // защищены `typeof` — у мок-AuthKit в тестах они могут отсутствовать.
574
+ // Доступ к сессии обеспечивает единый prefix-guard ресурса (см. выше):
575
+ // `registerAccessGuard: false` отключает собственный guard core-фабрики,
576
+ // чтобы не появился второй источник правил.
577
+ registerAccessGuard: false,
578
+ // ADR-089: сквозной обзор сессий для ADMIN/LEAD (`GET /` — список всех).
579
+ // Вызовы `kit.isAdmin`/`hasRole` защищены `typeof` — у мок-AuthKit в тестах
580
+ // они могут отсутствовать.
468
581
  resolveElevated: (c) => {
469
582
  const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
470
583
  const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
@@ -477,15 +590,6 @@ requestSessionService) {
477
590
  const projects = await projectStore.list(userId);
478
591
  return projects.map((p) => p.id);
479
592
  },
480
- // ADR-089: доступ по id — участник проекта сессии (owner/член), не только владелец.
481
- resolveCanAccessExtra: async (session, _c, userId) => {
482
- if (!projectStore || !session.projectId)
483
- return false;
484
- const project = await projectStore.load(session.projectId);
485
- if (!project)
486
- return false;
487
- return project.ownerId === userId || userId in (project.members ?? {});
488
- },
489
593
  resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
490
594
  promptMessageId: 'stream',
491
595
  publishRenamed: false,
@@ -494,11 +598,31 @@ requestSessionService) {
494
598
  onSessionDeleted: (userId, sessionId) => { eventHub.unsubscribeFromSession(userId, sessionId); },
495
599
  onSessionForked: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
496
600
  promptMiddleware: [createRateLimiter(30, 60_000)],
601
+ forkMiddleware: [forkRateLimit],
602
+ mergeMiddleware: [mergeRateLimit],
497
603
  enableSessionEvents: false,
498
604
  resolveDefaultAgent,
605
+ // ADR-036: право видеть РЕАЛЬНЫЕ значения секретов (плейсхолдер → значение)
606
+ // в обычном чтении сессии (`GET /sessions/:id`, `GET /sessions/:id/messages`,
607
+ // список сессий): владелец сессии + `ADMIN`/`AUDITOR` — тот же набор
608
+ // привилегий, что у `GET /:id/secrets` и у полного экспорта сессии
609
+ // (`createSessionExportGuard`). Остальным читателям (участник проекта
610
+ // VIEWER/EDITOR, владелец проекта, LEAD без владения) значения
611
+ // вычищаются из ответа — ключи-плейсхолдеры остаются.
612
+ canRevealSecrets: async (c, session) => {
613
+ const user = await kit.getCurrentUser(c);
614
+ if (!user)
615
+ return false;
616
+ const ctx = c;
617
+ if (typeof kit.isAdmin === 'function' && kit.isAdmin(ctx))
618
+ return true;
619
+ if (typeof kit.hasRole === 'function' && kit.hasRole(ctx, 'AUDITOR'))
620
+ return true;
621
+ return (session.ownerId ?? session.userId) === user.id;
622
+ },
499
623
  // ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
500
624
  scopeGuard,
501
- projectGuard,
625
+ serviceProjectProjection,
502
626
  messages: {
503
627
  sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
504
628
  forbidden: (c) => t('auth.forbidden', undefined, c),
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Надёжное закрытие локального HTTP(S)-сервера в тестах.
3
+ *
4
+ * `server.close()` ждёт, пока завершатся все живые соединения. Keep-alive-сокет
5
+ * (его держит, например, undici-агент) сам по себе не заканчивается — `close()`
6
+ * не вызывает callback, и хук `afterAll` виснет до таймаута vitest
7
+ * («Hook timed out in 10000ms»). Поэтому закрытие идёт в три шага:
8
+ *
9
+ * 1. `closeAllConnections()` — все живые соединения сервера;
10
+ * 2. `server.close()` — с ограничением по времени: зависший сокет не должен
11
+ * блокировать suite (таймер всегда снимается).
12
+ *
13
+ * Дубль хелпера из `@itphx/synth-core` (`src/test-helpers/close-server.ts`):
14
+ * пакеты не зависят друг от друга на уровне внутренних модулей, а
15
+ * `@itphx/synth-core` не экспортирует тестовые хелперы в публичный API.
16
+ */
17
+ /** Минимальный контракт сервера, который умеет закрыться. */
18
+ export interface CloseableServer {
19
+ close(callback: () => void): unknown;
20
+ }
21
+ export interface CloseServerOptions {
22
+ /** Максимальное ожидание закрытия, мс (по умолчанию 1000). */
23
+ timeoutMs?: number;
24
+ }
25
+ /** Таймаут ожидания закрытия по умолчанию, мс. */
26
+ export declare const DEFAULT_CLOSE_TIMEOUT_MS = 1000;
27
+ /**
28
+ * Закрывает сервер так, чтобы `close()` не мог зависнуть.
29
+ *
30
+ * Ошибка закрытия игнорируется: сервер уже не слушает — это не повод ронять
31
+ * тест. Единственный важный инвариант — функция **всегда** завершается.
32
+ */
33
+ export declare function closeTestServer(server: CloseableServer, options?: CloseServerOptions): Promise<void>;
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Надёжное закрытие локального HTTP(S)-сервера в тестах.
3
+ *
4
+ * `server.close()` ждёт, пока завершатся все живые соединения. Keep-alive-сокет
5
+ * (его держит, например, undici-агент) сам по себе не заканчивается — `close()`
6
+ * не вызывает callback, и хук `afterAll` виснет до таймаута vitest
7
+ * («Hook timed out in 10000ms»). Поэтому закрытие идёт в три шага:
8
+ *
9
+ * 1. `closeAllConnections()` — все живые соединения сервера;
10
+ * 2. `server.close()` — с ограничением по времени: зависший сокет не должен
11
+ * блокировать suite (таймер всегда снимается).
12
+ *
13
+ * Дубль хелпера из `@itphx/synth-core` (`src/test-helpers/close-server.ts`):
14
+ * пакеты не зависят друг от друга на уровне внутренних модулей, а
15
+ * `@itphx/synth-core` не экспортирует тестовые хелперы в публичный API.
16
+ */
17
+ /** Таймаут ожидания закрытия по умолчанию, мс. */
18
+ export const DEFAULT_CLOSE_TIMEOUT_MS = 1_000;
19
+ /**
20
+ * Закрывает сервер так, чтобы `close()` не мог зависнуть.
21
+ *
22
+ * Ошибка закрытия игнорируется: сервер уже не слушает — это не повод ронять
23
+ * тест. Единственный важный инвариант — функция **всегда** завершается.
24
+ */
25
+ export async function closeTestServer(server, options = {}) {
26
+ const timeoutMs = options.timeoutMs ?? DEFAULT_CLOSE_TIMEOUT_MS;
27
+ // Тот же приём, что в остальных тестах репозитория: метод есть не во всех
28
+ // версиях Node и не во всех типах — вызываем опционально через каст.
29
+ server.closeAllConnections?.();
30
+ let timer;
31
+ try {
32
+ await Promise.race([
33
+ new Promise((resolve) => {
34
+ try {
35
+ server.close(() => resolve());
36
+ }
37
+ catch {
38
+ resolve();
39
+ }
40
+ }),
41
+ new Promise((resolve) => {
42
+ timer = setTimeout(resolve, timeoutMs);
43
+ }),
44
+ ]);
45
+ }
46
+ finally {
47
+ if (timer !== undefined)
48
+ clearTimeout(timer);
49
+ }
50
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-backend",
3
- "version": "0.10.1",
3
+ "version": "0.11.3",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "files": [
@@ -8,8 +8,8 @@
8
8
  ],
9
9
  "dependencies": {
10
10
  "@hono/node-server": "^1.18.0",
11
- "@itphx/synth-core": "0.10.1",
12
- "@itphx/synth-shared": "0.10.1",
11
+ "@itphx/synth-core": "0.11.3",
12
+ "@itphx/synth-shared": "0.11.3",
13
13
  "hono": "^4.9.0",
14
14
  "hono-rate-limiter": "^0.5.3",
15
15
  "jose": "^6.2.3",