@itphx/synth-backend 0.10.1 → 0.12.4

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 (53) hide show
  1. package/dist/app/bootstrap.d.ts +2 -2
  2. package/dist/app/deps.d.ts +77 -33
  3. package/dist/app/deps.js +969 -102
  4. package/dist/app/listen.d.ts +13 -2
  5. package/dist/app/listen.js +138 -10
  6. package/dist/app/mount-routes.d.ts +16 -3
  7. package/dist/app/mount-routes.js +625 -32
  8. package/dist/app.d.ts +42 -7
  9. package/dist/app.js +149 -12
  10. package/dist/auth/guards.d.ts +17 -1
  11. package/dist/auth/guards.js +46 -2
  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/plugin-scope.d.ts +10 -0
  17. package/dist/auth/plugin-scope.js +69 -0
  18. package/dist/auth/service-scope.d.ts +7 -3
  19. package/dist/auth/service-scope.js +8 -4
  20. package/dist/events/hub.js +3 -38
  21. package/dist/lib/app-config.d.ts +2 -0
  22. package/dist/lib/app-config.js +3 -2
  23. package/dist/lib/defaults-store.d.ts +2 -25
  24. package/dist/lib/defaults-store.js +5 -87
  25. package/dist/lib/i18n.js +153 -0
  26. package/dist/main.js +67 -4
  27. package/dist/routes/agents.d.ts +12 -3
  28. package/dist/routes/agents.js +14 -2
  29. package/dist/routes/auth.d.ts +12 -2
  30. package/dist/routes/auth.js +16 -2
  31. package/dist/routes/context.d.ts +2 -2
  32. package/dist/routes/gateway-patterns.d.ts +2 -2
  33. package/dist/routes/llm.d.ts +8 -2
  34. package/dist/routes/llm.js +6 -3
  35. package/dist/routes/mcp-registry.d.ts +15 -3
  36. package/dist/routes/mcp-registry.js +122 -21
  37. package/dist/routes/messages.d.ts +7 -4
  38. package/dist/routes/messages.js +34 -3
  39. package/dist/routes/models.d.ts +7 -2
  40. package/dist/routes/models.js +3 -1
  41. package/dist/routes/processes.d.ts +34 -0
  42. package/dist/routes/processes.js +26 -0
  43. package/dist/routes/projects.d.ts +9 -3
  44. package/dist/routes/projects.js +8 -1
  45. package/dist/routes/providers.d.ts +15 -3
  46. package/dist/routes/providers.js +33 -21
  47. package/dist/routes/queue.d.ts +5 -4
  48. package/dist/routes/queue.js +30 -3
  49. package/dist/routes/sessions.d.ts +50 -3
  50. package/dist/routes/sessions.js +221 -74
  51. package/dist/test-helpers/close-server.d.ts +33 -0
  52. package/dist/test-helpers/close-server.js +50 -0
  53. package/package.json +4 -4
@@ -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, resolveUserPrincipal, } 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,127 @@ resolveDefaultAgent,
24
32
  * ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
25
33
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
26
34
  */
27
- requestSessionService) {
35
+ requestSessionService,
36
+ /** ADR-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
37
+ analytics,
38
+ /** ADR-107: агрегаты памяти сессии для `GET /:id/memory` (вкладка «Память»). */
39
+ memory,
40
+ /**
41
+ * Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
42
+ *
43
+ * Не задан — маршруты вопросов отвечают 503 (подсистема не подключена).
44
+ */
45
+ questionService,
46
+ /**
47
+ * ADR-114: сервис worktree'ов — привязка сессии к worktree
48
+ * (`PATCH /api/v2/sessions/:id { worktreeId }`).
49
+ *
50
+ * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
51
+ */
52
+ worktreeService,
53
+ /**
54
+ * ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
55
+ * (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
56
+ */
57
+ attachments) {
28
58
  const app = new Hono();
29
59
  const agentRegistry = orchestrator.agentRegistry;
60
+ const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
30
61
  // ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
31
62
  const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
32
63
  /**
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-уязвимость).
64
+ * Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/export/
65
+ * fork/merge): 10 запросов / 60 с на креду — тот же in-memory `createRateLimiter`,
66
+ * что у `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Значение ниже
67
+ * prompt: операции не частые в живом UI, но дорогие (полный объект сессии,
68
+ * создание форка, копирование сообщений) — защита от всплесков/выкачивания.
39
69
  */
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
- };
70
+ const importRateLimit = createRateLimiter(10, 60_000);
71
+ const exportRateLimit = createRateLimiter(10, 60_000);
72
+ const forkRateLimit = createRateLimiter(10, 60_000);
73
+ const mergeRateLimit = createRateLimiter(10, 60_000);
74
+ /**
75
+ * Единое правило доступа к сессии (читать/писать) — ОДНА точка на весь ресурс
76
+ * `/api/v2/sessions`, включая backend-only маршруты (export/debug/optimization/
77
+ * notes) и core-маршруты. Правило:
78
+ * - elevated (ADMIN/LEAD) → всё (осознанное решение: мутации чужих сессий
79
+ * у LEAD/ADMIN сохранены как есть);
80
+ * - владелец сессии или сессия без владельца → всё;
81
+ * - иначе — роль в проекте: чтение (`GET`/`HEAD`) — проектное чтение
82
+ * (`canReadProject`: owner проекта или любой участник), мутация — проектное
83
+ * редактирование (`canEditProjectContent`: owner/EDITOR).
84
+ * Разделение read/write делает prefix-guard по HTTP-методу (единая точка).
85
+ */
86
+ const sessionAccessPredicate = createSessionAccessPredicate({
87
+ canAccess: (session, c, userId) => {
88
+ const owner = session.ownerId ?? session.userId;
89
+ return !owner || owner === userId
90
+ || (typeof kit.isAdmin === 'function' && kit.isAdmin(c));
91
+ },
92
+ resolveCanAccessExtra: async (session, c, userId, access) => {
93
+ if (!projectStore || !session.projectId)
94
+ return false;
95
+ const project = await projectStore.load(session.projectId);
96
+ if (!project)
97
+ return false;
98
+ const ctx = c;
99
+ return access === 'read'
100
+ ? canReadProject(ctx, project, userId)
101
+ : canEditProjectContent(ctx, project, userId);
102
+ },
103
+ localUserId: 'local',
104
+ });
105
+ /**
106
+ * `GET /:id/export` — единственный `:id`-маршрут, где роль аудита инстанса
107
+ * (`AUDITOR`) является **читателем** сессии: карта обфускации ЛЮБОЙ сессии ему
108
+ * и так доступна (`GET /:id/secrets` — `ADMIN`/`AUDITOR`), поэтому экспорт
109
+ * сессии для него не привилегия сверх того, что у него уже есть. На остальных
110
+ * `:id`-маршрутах правило доступа не меняется (см. матрицу
111
+ * `session-idor-matrix.test.ts`).
112
+ */
113
+ const isSessionExportRequest = (c) => c.req.method === 'GET' && isSessionExportPath(c.req.path);
114
+ const sessionAccessGuard = createSessionAccessGuard({
115
+ param: 'id',
116
+ resolveSession: (id) => sessionManager.getSession(id),
117
+ resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
118
+ isAllowed: async (session, c, userId, access) => {
119
+ // Мок-AuthKit в тестах может не иметь isAdmin/hasRole — защищаем typeof.
120
+ const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
121
+ const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
122
+ if (isAdmin || isLead)
123
+ return true;
124
+ // Роль аудита инстанса — читатель сессии на маршруте экспорта (см. выше).
125
+ if (access === 'read' && isSessionExportRequest(c)) {
126
+ const isAuditor = typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR');
127
+ if (isAuditor)
128
+ return true;
129
+ }
130
+ return sessionAccessPredicate(session, c, userId, access);
131
+ },
132
+ messages: {
133
+ sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
134
+ forbidden: (c) => t('auth.forbidden', undefined, c),
135
+ },
136
+ // `/import` — статический сегмент (не id сессии).
137
+ skipForId: (id) => id === 'import',
138
+ });
139
+ /**
140
+ * Привилегия карты обфускации при экспорте сессии (ADR-036, security-фикс
141
+ * 0.11.3) — отдельный route-level guard: он резолвит сессию, решает «полный
142
+ * экспорт или очищенный» и кладёт решение в контекст Hono. Обработчик
143
+ * `/export` только форматирует ответ по этому решению — копии правила доступа
144
+ * в обработчике нет (инвариант 16).
145
+ */
146
+ const sessionExportGuard = createSessionExportGuard({
147
+ param: 'id',
148
+ resolveSession: (id) => sessionManager.getSession(id),
149
+ resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
150
+ isAdmin: (c) => typeof kit.isAdmin === 'function' && kit.isAdmin(c),
151
+ isAuditor: (c) => typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR'),
152
+ messages: {
153
+ sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
154
+ },
155
+ });
52
156
  /** ADR-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
53
157
  const buildSessionMcpPayload = async (session) => {
54
158
  const servers = await orchestrator.resolveMcpServers(session);
@@ -135,27 +239,58 @@ requestSessionService) {
135
239
  }
136
240
  return c.json({ sessionId: session.id, secrets: session.obfuscationMap ?? {} });
137
241
  });
242
+ // Единый prefix-guard ресурса сессий: вешается ПОСЛЕ `/:id/mcp` и `/:id/secrets`
243
+ // (у них собственные задокументированные правила) и покрывает отладку,
244
+ // оптимизацию, заметки, ЭКСПОРТ и все core-маршруты (core-фабрика
245
+ // регистрируется с registerAccessGuard:false — иначе был бы второй источник
246
+ // правил). `/import` пропускается через guard.skipForId (статический сегмент,
247
+ // не сессия).
248
+ app.use('/:id', kit.requireAuth, sessionAccessGuard);
249
+ app.use('/:id/*', kit.requireAuth, sessionAccessGuard);
138
250
  // GET /api/v2/sessions/:id/export — полный экспорт сессии для переноса между
139
251
  // мирами (publish/fork). Внутренний формат: объект Session (camelCase) из
140
252
  // SessionManager — история сообщений, todos, настройки, заметки, ссылки,
141
253
  // чекпоинты, план-флаг и карта обфускации. Не публичный 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);
254
+ //
255
+ // ВАЖНО (инвариант 16): маршрут зарегистрирован ПОСЛЕ prefix-guard'а —
256
+ // доступ к сессии (404/403) решает ЕДИНЫЙ guard (`sessionAccessGuard`), и
257
+ // второй копии правила в обработчике быть не должно: иначе правила
258
+ // расходятся (было: ложный 403 у `LEAD`, «правило в двух местах»).
259
+ //
260
+ // ПРАВИЛО ОТВЕТА (security-фикс 0.11.3): экспорт переносит СЕКРЕТЫ — карту
261
+ // обфускации LLM Gateway (`obfuscationMap`: плейсхолдер → РЕАЛЬНЫЙ секрет) и
262
+ // реальные значения плейсхолдеров в `metadata.secrets` (ADR-036). Ответ
263
+ // зависит от отдельной привилегии, которую решает route-level guard
264
+ // (`sessionExportGuard`), а не обработчик:
265
+ //
266
+ // - **владелец сессии** (`ownerId ?? userId` === текущий пользователь),
267
+ // **ADMIN**, **AUDITOR** → полный экспорт с картой: это его собственные
268
+ // секреты (ADMIN/AUDITOR — тот же набор привилегий, что у `GET /:id/secrets`);
269
+ // - **прочие читатели сессии** (участник проекта VIEWER/EDITOR, владелец
270
+ // проекта, который не владеет сессией, LEAD) → 200, но ответ **очищен**:
271
+ // без `obfuscationMap` и без `metadata.secrets`. Переносится разговор,
272
+ // который этот пользователь и так видит в UI, — но не чужие секреты (смысл
273
+ // «выгрузки секретов» не теряется, а publish/fork не ломается: форк чужой
274
+ // сессии в проекте остаётся рабочим);
275
+ // - **нет доступа на чтение** (посторонний) → 403 FORBIDDEN (prefix-guard).
276
+ //
277
+ // Очистка — на КОПИИ: сохранённая сессия не мутируется. Формат ответа не
278
+ // меняется (тот же объект Session), очищенный экспорт остаётся валидным
279
+ // payload'ом переноса — импорт его принимает.
280
+ app.get('/:id/export', kit.requireAuth, exportRateLimit, sessionExportGuard, async (c) => {
281
+ const decision = getSessionExportDecision(c);
282
+ if (!decision) {
283
+ // Fail-closed: guard не отработал — отдаём полный экспорт нельзя.
284
+ return c.json({ error: { code: 'INTERNAL_ERROR', message: 'Не удалось подготовить экспорт сессии' } }, 500);
147
285
  }
148
- const denied = await sessionAccessDenied(c, session);
149
- if (denied)
150
- return denied;
151
- return c.json(session);
286
+ return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
152
287
  });
153
288
  // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
154
289
  // (перенос истории между мирами). Тело: объект экспорта + import.project_id
155
290
  // (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
156
291
  // ADR-089: это materialization-операция (создание-как-факт переноса истории),
157
292
  // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
158
- app.post('/import', kit.requireAuth, async (c) => {
293
+ app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
159
294
  const user = (await kit.getCurrentUser(c));
160
295
  const body = await c.req.json().catch(() => ({}));
161
296
  const targetProjectId = body.import?.project_id
@@ -171,12 +306,24 @@ requestSessionService) {
171
306
  if (!existing) {
172
307
  return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
173
308
  }
309
+ // Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
310
+ // workspace — без проверки доступа к проекту получается IDOR (чтение/запись
311
+ // файлов чужого проекта).
312
+ //
313
+ // Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
314
+ // доступа не расширяет права на изменение), поэтому нужен уровень
315
+ // «редактирование контента проекта» (`canEditProjectContent`: owner /
316
+ // EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
317
+ // (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
318
+ // ролью VIEWER получает 403.
319
+ if (!canEditProjectContent(c, existing, user.id)) {
320
+ return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
321
+ }
174
322
  }
175
323
  // ADR-089: materialization (перенос истории), не request — прямой createSession.
176
324
  const session = await sessionManager.createSession({
177
325
  title: typeof body.title === 'string' ? body.title : undefined,
178
326
  projectId: targetProjectId,
179
- engine: typeof body.engine === 'string' ? body.engine : undefined,
180
327
  sessionOrigin: (body.session_origin ?? body.sessionOrigin),
181
328
  settings: (body.settings ?? {}),
182
329
  userId: user.id,
@@ -237,9 +384,7 @@ requestSessionService) {
237
384
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
238
385
  }
239
386
  const user = (await kit.getCurrentUser(c));
240
- const denied = await sessionAccessDenied(c, session, user);
241
- if (denied)
242
- return denied;
387
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
243
388
  const streamId = generateStreamId();
244
389
  const sysMsg = {
245
390
  id: streamId,
@@ -255,7 +400,9 @@ requestSessionService) {
255
400
  author: user.username,
256
401
  metadata: { type: 'debug_system_message', reason: 'manual', stream_id: streamId },
257
402
  };
258
- const result = await enqueueUserMessage(sessionManager, eventBus, session.id, sysMsg, queueManager, processMessage);
403
+ // ADR-106 Ф4: принципал инициатора (ввод от пользователя, не системный ход).
404
+ const turnPrincipal = resolveUserPrincipal(user.id);
405
+ const result = await enqueueUserMessage(sessionManager, eventBus, session.id, sysMsg, queueManager, processMessage, undefined, turnPrincipal ? { principal: turnPrincipal } : undefined);
259
406
  if (!result) {
260
407
  return c.json({ error: { code: 'QUEUE_FULL', message: 'Queue is full' } }, 429);
261
408
  }
@@ -268,9 +415,7 @@ requestSessionService) {
268
415
  if (!session) {
269
416
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
270
417
  }
271
- const denied = await sessionAccessDenied(c, session);
272
- if (denied)
273
- return denied;
418
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
274
419
  return c.json({
275
420
  context_optimization: session.settings.contextOptimization,
276
421
  sliding_window_mode: session.settings.slidingWindowMode,
@@ -291,9 +436,7 @@ requestSessionService) {
291
436
  if (!session) {
292
437
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
293
438
  }
294
- const denied = await sessionAccessDenied(c, session);
295
- if (denied)
296
- return denied;
439
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
297
440
  const body = await c.req.json().catch(() => ({}));
298
441
  await sessionManager.withLock(c.req.param('id'), async (s) => {
299
442
  if (body.context_optimization !== undefined)
@@ -328,9 +471,7 @@ requestSessionService) {
328
471
  if (!session) {
329
472
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
330
473
  }
331
- const denied = await sessionAccessDenied(c, session);
332
- if (denied)
333
- return denied;
474
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
334
475
  if (!contextOptimizer) {
335
476
  return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
336
477
  }
@@ -349,9 +490,7 @@ requestSessionService) {
349
490
  if (!session) {
350
491
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
351
492
  }
352
- const denied = await sessionAccessDenied(c, session);
353
- if (denied)
354
- return denied;
493
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
355
494
  await sessionManager.withLock(session.id, async (s) => {
356
495
  s.summarizationPending = false;
357
496
  await sessionManager.saveSession(s);
@@ -375,9 +514,7 @@ requestSessionService) {
375
514
  if (!session) {
376
515
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
377
516
  }
378
- const denied = await sessionAccessDenied(c, session);
379
- if (denied)
380
- return denied;
517
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
381
518
  return c.json({ notes: session.stickyNotes });
382
519
  });
383
520
  // POST /api/v2/sessions/:id/notes — создать заметку
@@ -387,9 +524,7 @@ requestSessionService) {
387
524
  if (!session) {
388
525
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
389
526
  }
390
- const denied = await sessionAccessDenied(c, session);
391
- if (denied)
392
- return denied;
527
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
393
528
  const body = await c.req.json().catch(() => ({}));
394
529
  if (!body.content?.trim()) {
395
530
  return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
@@ -417,9 +552,7 @@ requestSessionService) {
417
552
  if (!session) {
418
553
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
419
554
  }
420
- const denied = await sessionAccessDenied(c, session);
421
- if (denied)
422
- return denied;
555
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
423
556
  const body = await c.req.json().catch(() => ({}));
424
557
  const noteId = c.req.param('noteId');
425
558
  await sessionManager.withLock(c.req.param('id'), async (s) => {
@@ -444,9 +577,7 @@ requestSessionService) {
444
577
  if (!session) {
445
578
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
446
579
  }
447
- const denied = await sessionAccessDenied(c, session);
448
- if (denied)
449
- return denied;
580
+ // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
450
581
  const noteId = c.req.param('noteId');
451
582
  await sessionManager.withLock(c.req.param('id'), async (s) => {
452
583
  s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
@@ -458,13 +589,17 @@ requestSessionService) {
458
589
  });
459
590
  // Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
460
591
  // последней: статические/backend-only сегменты должны матчиться раньше.
461
- app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService }, {
592
+ app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics, ...(memory ? { memory } : {}), ...(questionService ? { questionService } : {}), ...(worktreeService ? { worktreeService } : {}), ...(attachments ? { attachments } : {}) }, {
462
593
  resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
463
594
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
464
595
  forkWithOwner: true,
465
- canAccess: (session, c, userId) => isSessionOwner(session, userId) || kit.isAdmin(c),
466
- // ADR-089: сквозной обзор сессий для ADMIN/LEAD. Вызовы `kit.isAdmin`/`hasRole`
467
- // защищены `typeof` — у мок-AuthKit в тестах они могут отсутствовать.
596
+ // Доступ к сессии обеспечивает единый prefix-guard ресурса (см. выше):
597
+ // `registerAccessGuard: false` отключает собственный guard core-фабрики,
598
+ // чтобы не появился второй источник правил.
599
+ registerAccessGuard: false,
600
+ // ADR-089: сквозной обзор сессий для ADMIN/LEAD (`GET /` — список всех).
601
+ // Вызовы `kit.isAdmin`/`hasRole` защищены `typeof` — у мок-AuthKit в тестах
602
+ // они могут отсутствовать.
468
603
  resolveElevated: (c) => {
469
604
  const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
470
605
  const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
@@ -477,15 +612,6 @@ requestSessionService) {
477
612
  const projects = await projectStore.list(userId);
478
613
  return projects.map((p) => p.id);
479
614
  },
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
615
  resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
490
616
  promptMessageId: 'stream',
491
617
  publishRenamed: false,
@@ -494,16 +620,37 @@ requestSessionService) {
494
620
  onSessionDeleted: (userId, sessionId) => { eventHub.unsubscribeFromSession(userId, sessionId); },
495
621
  onSessionForked: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
496
622
  promptMiddleware: [createRateLimiter(30, 60_000)],
623
+ forkMiddleware: [forkRateLimit],
624
+ mergeMiddleware: [mergeRateLimit],
497
625
  enableSessionEvents: false,
498
626
  resolveDefaultAgent,
627
+ // ADR-036: право видеть РЕАЛЬНЫЕ значения секретов (плейсхолдер → значение)
628
+ // в обычном чтении сессии (`GET /sessions/:id`, `GET /sessions/:id/messages`,
629
+ // список сессий): владелец сессии + `ADMIN`/`AUDITOR` — тот же набор
630
+ // привилегий, что у `GET /:id/secrets` и у полного экспорта сессии
631
+ // (`createSessionExportGuard`). Остальным читателям (участник проекта
632
+ // VIEWER/EDITOR, владелец проекта, LEAD без владения) значения
633
+ // вычищаются из ответа — ключи-плейсхолдеры остаются.
634
+ canRevealSecrets: async (c, session) => {
635
+ const user = await kit.getCurrentUser(c);
636
+ if (!user)
637
+ return false;
638
+ const ctx = c;
639
+ if (typeof kit.isAdmin === 'function' && kit.isAdmin(ctx))
640
+ return true;
641
+ if (typeof kit.hasRole === 'function' && kit.hasRole(ctx, 'AUDITOR'))
642
+ return true;
643
+ return (session.ownerId ?? session.userId) === user.id;
644
+ },
499
645
  // ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
500
646
  scopeGuard,
501
- projectGuard,
647
+ serviceProjectProjection,
502
648
  messages: {
503
649
  sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
504
650
  forbidden: (c) => t('auth.forbidden', undefined, c),
505
651
  contentRequired: (c) => t('errors.validation.contentRequired', undefined, c),
506
652
  queueFull: (c, max) => t('errors.chat.queueFull', { max }, c),
653
+ steerLimitExceeded: (c, max) => t('errors.chat.steerLimitExceeded', { max }, c),
507
654
  },
508
655
  }));
509
656
  return app;
@@ -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.12.4",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "files": [
@@ -8,14 +8,14 @@
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.12.4",
12
+ "@itphx/synth-shared": "0.12.4",
13
13
  "hono": "^4.9.0",
14
14
  "hono-rate-limiter": "^0.5.3",
15
15
  "jose": "^6.2.3",
16
16
  "js-yaml": "^4.1.1",
17
17
  "ws": "^8.20.1",
18
- "zod": "^3.24.0"
18
+ "zod": "^4.6.7"
19
19
  },
20
20
  "devDependencies": {
21
21
  "@types/js-yaml": "^4.0.9",