@itphx/synth-backend 0.10.0 → 0.10.1

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 (43) 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 +106 -0
  4. package/dist/app/deps.js +617 -0
  5. package/dist/app/listen.d.ts +29 -0
  6. package/dist/app/listen.js +298 -0
  7. package/dist/app/mount-routes.d.ts +18 -0
  8. package/dist/app/mount-routes.js +466 -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 +15 -11
  12. package/dist/app.js +71 -1337
  13. package/dist/auth/guards.js +1 -1
  14. package/dist/auth/middleware.d.ts +7 -2
  15. package/dist/auth/middleware.js +18 -4
  16. package/dist/auth/oidc.d.ts +15 -0
  17. package/dist/auth/oidc.js +41 -3
  18. package/dist/auth/service-scope.d.ts +1 -1
  19. package/dist/auth/service-scope.js +1 -1
  20. package/dist/events/hub.d.ts +2 -2
  21. package/dist/lib/cors.d.ts +23 -0
  22. package/dist/lib/cors.js +24 -0
  23. package/dist/lib/i18n.js +10 -6
  24. package/dist/main.js +4 -4
  25. package/dist/middleware/rate-limiter.d.ts +4 -1
  26. package/dist/middleware/rate-limiter.js +4 -2
  27. package/dist/routes/audit.d.ts +1 -1
  28. package/dist/routes/audit.js +2 -2
  29. package/dist/routes/auth.js +28 -4
  30. package/dist/routes/gateway-patterns.d.ts +1 -1
  31. package/dist/routes/gateway-patterns.js +1 -1
  32. package/dist/routes/llm.js +5 -4
  33. package/dist/routes/mcp-registry.d.ts +3 -3
  34. package/dist/routes/mcp-registry.js +8 -8
  35. package/dist/routes/mcp.d.ts +1 -1
  36. package/dist/routes/mcp.js +1 -1
  37. package/dist/routes/projects.d.ts +4 -4
  38. package/dist/routes/projects.js +7 -7
  39. package/dist/routes/providers.js +1 -0
  40. package/dist/routes/sessions.d.ts +1 -1
  41. package/dist/routes/sessions.js +89 -13
  42. package/dist/routes/users.js +1 -1
  43. package/package.json +3 -3
@@ -4,7 +4,7 @@ import { evaluateMcpNetworkAccess, getServiceCredential } from '@itphx/synth-cor
4
4
  import { sessionMcpScopeSchema, hasServiceScope } from '@itphx/synth-shared';
5
5
  import { mcpServerConfigSchema } from '@itphx/synth-shared/config';
6
6
  import { requireAdminOrScope, requireScopeForServiceKey } from '../auth/guards.js';
7
- // Backend-only MCP-роуты (AD-071 §2.5): legacy `/servers*`, `/session/:id` и
7
+ // Backend-only MCP-роуты (ADR-071 §2.5): legacy `/servers*`, `/session/:id` и
8
8
  // единый реестр `/registry*`. Probe (`POST /probe`) — общая логика core,
9
9
  // монтируется в `routes/mcp.ts` ПЕРЕД этим роутером.
10
10
  const addServerSchema = z.object({
@@ -12,7 +12,7 @@ const addServerSchema = z.object({
12
12
  config: mcpServerConfigSchema,
13
13
  });
14
14
  const updateServerSchema = mcpServerConfigSchema;
15
- // AD-071 §2.5: единый реестр MCP-серверов.
15
+ // ADR-071 §2.5: единый реестр MCP-серверов.
16
16
  const registryAddSchema = z.object({
17
17
  name: z.string().min(1).max(200),
18
18
  config: mcpServerConfigSchema,
@@ -48,7 +48,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
48
48
  const isConnected = (name) => mcpManager?.getConfiguredServers().find((s) => s.name === name)?.connected ?? false;
49
49
  const currentUser = (c) => c.get('user') ?? null;
50
50
  /**
51
- * AD-052/O1: запрос от installer-service-key (scope `addons:install`).
51
+ * ADR-052/O1: запрос от installer-service-key (scope `addons:install`).
52
52
  * Даёт scoped-ключу без роли ADMIN создавать **instance**-записи реестра
53
53
  * (общие для инстанса, а не персональные) и обновлять созданные им записи.
54
54
  */
@@ -57,7 +57,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
57
57
  return !!cred && hasServiceScope(cred.scopes, 'addons:install');
58
58
  };
59
59
  const checkNetwork = async (config, origin) => {
60
- // AD-071 §2.3.1: политика — для пользовательских HTTP-серверов; instance
60
+ // ADR-071 §2.3.1: политика — для пользовательских HTTP-серверов; instance
61
61
  // (в т.ч. приватные сети инстанса) доверенные.
62
62
  if (origin !== 'user' || config.type === 'stdio' || !config.url)
63
63
  return null;
@@ -70,7 +70,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
70
70
  return { code: 'NETWORK_POLICY_VIOLATION', message: result.reason ?? 'Адрес запрещён сетевой политикой' };
71
71
  };
72
72
  // ---------------------------------------------------------------------------
73
- // Legacy `/servers*` — тонкие адаптеры над единым реестром (AD-071 §2.5).
73
+ // Legacy `/servers*` — тонкие адаптеры над единым реестром (ADR-071 §2.5).
74
74
  // Второго хранилища (config.yaml) больше нет: источник истины — McpRegistryStore.
75
75
  // ---------------------------------------------------------------------------
76
76
  // --- Список настроенных серверов ---
@@ -260,14 +260,14 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
260
260
  });
261
261
  });
262
262
  }
263
- // --- Единый реестр MCP-серверов (AD-071 §2.5) ---
263
+ // --- Единый реестр MCP-серверов (ADR-071 §2.5) ---
264
264
  // Список записей реестра (auth).
265
265
  app.get('/registry', kit.requireAuth, async (c) => {
266
266
  const entries = await registry.list();
267
267
  return c.json({ entries });
268
268
  });
269
269
  // Добавить запись (auth): HTTP — любой пользователь, stdio — только ADMIN.
270
- // AD-052/O1: service-key должен нести scope `addons:install` (интерактив без
270
+ // ADR-052/O1: service-key должен нести scope `addons:install` (интерактив без
271
271
  // изменений — HTTP добавляет любой, stdio-проверка ниже). Installer-ключ со
272
272
  // scope создаёт instance-записи (общие для инстанса) без роли ADMIN.
273
273
  app.post('/registry', kit.requireAuth, requireScopeForServiceKey('addons:install'), async (c) => {
@@ -278,7 +278,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
278
278
  }
279
279
  const { name, config, enabled, enabledByDefault, origin } = parsed.data;
280
280
  const admin = kit.isAdmin(c);
281
- // AD-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
281
+ // ADR-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
282
282
  // даже без роли ADMIN — это общие записи инстанса (а не персональные).
283
283
  const isInstaller = isInstallerKey(c);
284
284
  let entryOrigin;
@@ -5,7 +5,7 @@ import type { McpRoutesOptions } from './mcp-registry.js';
5
5
  export type { McpRoutesOptions } from './mcp-registry.js';
6
6
  /**
7
7
  * Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
8
- * `/servers*`, `/session/:id` и единый реестр `/registry*` (AD-071) —
8
+ * `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
9
9
  * backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
10
10
  * первым, затем backend-only.
11
11
  */
@@ -3,7 +3,7 @@ import { createMcpRoutes as createCoreMcpRoutes } from '@itphx/synth-core';
3
3
  import { createMcpRegistryRoutes } from './mcp-registry.js';
4
4
  /**
5
5
  * Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
6
- * `/servers*`, `/session/:id` и единый реестр `/registry*` (AD-071) —
6
+ * `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
7
7
  * backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
8
8
  * первым, затем backend-only.
9
9
  */
@@ -3,7 +3,7 @@ import type { AuthKit } from '../auth/middleware.js';
3
3
  import type { ProjectStore, SessionManager, McpManager, SkillService, RuntimeSettingsStore, McpRegistryStore } from '@itphx/synth-core';
4
4
  import type { Project } from '@itphx/synth-shared';
5
5
  /**
6
- * AD-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
6
+ * ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
7
7
  * чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
8
8
  * ролей не дублировалась.
9
9
  */
@@ -21,11 +21,11 @@ export declare function createProjectAccess(kit: AuthKit): {
21
21
  /**
22
22
  * Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только
23
23
  * managed-специфика — RBAC (`createProjectAccess`), i18n-сообщения, авто-имя
24
- * workspace (AD-075, политика `deny` вне root), проектный MCP-скоуп (AD-071 §2.4)
24
+ * workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
25
25
  * и статистика сессий. Полная реализация — `@itphx/synth-core`.
26
26
  */
27
27
  export declare function createProjectRoutes(kit: AuthKit, store: ProjectStore, sessionManager: SessionManager, workspacesRoot: string,
28
- /** AD-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
28
+ /** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
29
29
  mcpManager?: McpManager,
30
- /** AD-046 §4.5: сид скиллов нового проекта (системные дефолты). */
30
+ /** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
31
31
  skillService?: SkillService, settingsStore?: RuntimeSettingsStore, mcpRegistryStore?: McpRegistryStore): Hono;
@@ -2,12 +2,12 @@ import { createProjectRoutes as createCoreProjectRoutes, resolveProjectSkillSeed
2
2
  import { ProjectRole } from '@itphx/synth-shared';
3
3
  import { t } from '../lib/i18n.js';
4
4
  /**
5
- * AD-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
5
+ * ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
6
6
  * чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
7
7
  * ролей не дублировалась.
8
8
  */
9
9
  export function createProjectAccess(kit) {
10
- /** AD-071 §2.4: owner проекта или глобальные LEAD/ADMIN (через AuthKit). */
10
+ /** ADR-071 §2.4: owner проекта или глобальные LEAD/ADMIN (через AuthKit). */
11
11
  const canManageProject = (c, project, userId) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
12
12
  || (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD'))
13
13
  || project.ownerId === userId
@@ -16,7 +16,7 @@ export function createProjectAccess(kit) {
16
16
  const canEditProjectContent = (c, project, userId) => canManageProject(c, project, userId)
17
17
  || project.members?.[userId] === ProjectRole.EDITOR;
18
18
  /**
19
- * AD-089: чтение проекта по id — owner / любой участник (любая роль, в т.ч.
19
+ * ADR-089: чтение проекта по id — owner / любой участник (любая роль, в т.ч.
20
20
  * VIEWER) / глобальные LEAD/ADMIN. Не расширяет права на редактирование.
21
21
  */
22
22
  const canReadProject = (c, project, userId) => canManageProject(c, project, userId)
@@ -26,20 +26,20 @@ export function createProjectAccess(kit) {
26
26
  /**
27
27
  * Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только
28
28
  * managed-специфика — RBAC (`createProjectAccess`), i18n-сообщения, авто-имя
29
- * workspace (AD-075, политика `deny` вне root), проектный MCP-скоуп (AD-071 §2.4)
29
+ * workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
30
30
  * и статистика сессий. Полная реализация — `@itphx/synth-core`.
31
31
  */
32
32
  export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
33
- /** AD-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
33
+ /** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
34
34
  mcpManager,
35
- /** AD-046 §4.5: сид скиллов нового проекта (системные дефолты). */
35
+ /** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
36
36
  skillService, settingsStore, mcpRegistryStore) {
37
37
  const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
38
38
  return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
39
39
  canManage: canManageProject,
40
40
  canEditContent: canEditProjectContent,
41
41
  canRead: canReadProject,
42
- // AD-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
42
+ // ADR-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
43
43
  resolveElevated: (c) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
44
44
  || (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD')),
45
45
  getCurrentUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
@@ -108,6 +108,7 @@ export function createProviderRoutes(kit, store, providerCache) {
108
108
  providerNotFound: (c) => t('errors.notFound.provider', undefined, c),
109
109
  providerDisabled: (c) => t('errors.providerDisabled', undefined, c),
110
110
  urlRequired: (c) => t('errors.validation.urlRequired', undefined, c),
111
+ urlInvalid: (c) => t('errors.validation.invalidUrl', undefined, c),
111
112
  connectionError: (c) => t('errors.connectionError', undefined, c),
112
113
  },
113
114
  }));
@@ -26,7 +26,7 @@ profilesStore?: ProfileStore,
26
26
  /** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
27
27
  resolveDefaultAgent?: () => string | Promise<string>,
28
28
  /**
29
- * AD-089: единый funnel создания сессий (прокидывается в core-фабрику).
29
+ * ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
30
30
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
31
31
  */
32
32
  requestSessionService?: RequestSessionService): Hono;
@@ -2,7 +2,7 @@ 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
4
  import { scopeGuard, projectGuard } from '../auth/service-scope.js';
5
- import { enqueueUserMessage, serializeSession, createSessionRoutes as createCoreSessionRoutes, } from '@itphx/synth-core';
5
+ import { enqueueUserMessage, serializeSession, isSessionVisible, createSessionRoutes as createCoreSessionRoutes, } from '@itphx/synth-core';
6
6
  import { t } from '../lib/i18n.js';
7
7
  /**
8
8
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
@@ -21,15 +21,35 @@ profilesStore,
21
21
  /** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
22
22
  resolveDefaultAgent,
23
23
  /**
24
- * AD-089: единый funnel создания сессий (прокидывается в core-фабрику).
24
+ * ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
25
25
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
26
26
  */
27
27
  requestSessionService) {
28
28
  const app = new Hono();
29
29
  const agentRegistry = orchestrator.agentRegistry;
30
- // AD-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
30
+ // ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
31
31
  const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
32
- /** AD-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
32
+ /**
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-уязвимость).
39
+ */
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
+ };
52
+ /** ADR-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
33
53
  const buildSessionMcpPayload = async (session) => {
34
54
  const servers = await orchestrator.resolveMcpServers(session);
35
55
  return {
@@ -40,7 +60,7 @@ requestSessionService) {
40
60
  mcpDisabledServers: session.settings.mcpDisabledServers ?? [],
41
61
  };
42
62
  };
43
- // GET /api/v2/sessions/:id/mcp — эффективный MCP-скоуп (AD-071 §2.4).
63
+ // GET /api/v2/sessions/:id/mcp — эффективный MCP-скоуп (ADR-071 §2.4).
44
64
  // Показывает все серверы, включая отключённые (reason). RBAC: владелец сессии/ADMIN.
45
65
  app.get('/:id/mcp', kit.requireAuth, async (c) => {
46
66
  const session = await sessionManager.getSession(c.req.param('id'));
@@ -53,7 +73,7 @@ requestSessionService) {
53
73
  }
54
74
  return c.json(await buildSessionMcpPayload(session));
55
75
  });
56
- // PUT /api/v2/sessions/:id/mcp — переключение MCP пользователем (AD-071 §2.4),
76
+ // PUT /api/v2/sessions/:id/mcp — переключение MCP пользователем (ADR-071 §2.4),
57
77
  // включая opt-out системных серверов. RBAC: владелец сессии/ADMIN.
58
78
  app.put('/:id/mcp', kit.requireAuth, async (c) => {
59
79
  const session = await sessionManager.getSession(c.req.param('id'));
@@ -106,7 +126,7 @@ requestSessionService) {
106
126
  eventBus.publish(session.id, 'session.updated', serializeSession(session, { agentRegistry }));
107
127
  return c.json(await buildSessionMcpPayload(session));
108
128
  });
109
- // GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (AD-036).
129
+ // GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (ADR-036).
110
130
  // RBAC: только ADMIN/AUDITOR — сама карта является секретом.
111
131
  app.get('/:id/secrets', kit.requirePermission('ADMIN', 'AUDITOR'), async (c) => {
112
132
  const session = await sessionManager.getSession(c.req.param('id'));
@@ -119,17 +139,21 @@ requestSessionService) {
119
139
  // мирами (publish/fork). Внутренний формат: объект Session (camelCase) из
120
140
  // SessionManager — история сообщений, todos, настройки, заметки, ссылки,
121
141
  // чекпоинты, план-флаг и карта обфускации. Не публичный DTO.
142
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
122
143
  app.get('/:id/export', kit.requireAuth, async (c) => {
123
144
  const session = await sessionManager.getSession(c.req.param('id'));
124
145
  if (!session) {
125
146
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
126
147
  }
148
+ const denied = await sessionAccessDenied(c, session);
149
+ if (denied)
150
+ return denied;
127
151
  return c.json(session);
128
152
  });
129
153
  // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
130
154
  // (перенос истории между мирами). Тело: объект экспорта + import.project_id
131
155
  // (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
132
- // AD-089: это materialization-операция (создание-как-факт переноса истории),
156
+ // ADR-089: это materialization-операция (создание-как-факт переноса истории),
133
157
  // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
134
158
  app.post('/import', kit.requireAuth, async (c) => {
135
159
  const user = (await kit.getCurrentUser(c));
@@ -148,7 +172,7 @@ requestSessionService) {
148
172
  return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
149
173
  }
150
174
  }
151
- // AD-089: materialization (перенос истории), не request — прямой createSession.
175
+ // ADR-089: materialization (перенос истории), не request — прямой createSession.
152
176
  const session = await sessionManager.createSession({
153
177
  title: typeof body.title === 'string' ? body.title : undefined,
154
178
  projectId: targetProjectId,
@@ -206,12 +230,16 @@ requestSessionService) {
206
230
  return c.json(serializeSession(session, { agentRegistry }), 201);
207
231
  });
208
232
  // POST /api/v2/sessions/:id/debug-system-message — отправить отладочное системное сообщение
233
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
209
234
  app.post('/:id/debug-system-message', kit.requireAuth, async (c) => {
210
235
  const session = await sessionManager.getSession(c.req.param('id'));
211
236
  if (!session) {
212
237
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
213
238
  }
214
239
  const user = (await kit.getCurrentUser(c));
240
+ const denied = await sessionAccessDenied(c, session, user);
241
+ if (denied)
242
+ return denied;
215
243
  const streamId = generateStreamId();
216
244
  const sysMsg = {
217
245
  id: streamId,
@@ -234,11 +262,15 @@ requestSessionService) {
234
262
  return c.json({ status: 'enqueued', stream_id: streamId });
235
263
  });
236
264
  // GET /api/v2/sessions/:id/optimization — настройки оптимизации
265
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
237
266
  app.get('/:id/optimization', kit.requireAuth, async (c) => {
238
267
  const session = await sessionManager.getSession(c.req.param('id'));
239
268
  if (!session) {
240
269
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
241
270
  }
271
+ const denied = await sessionAccessDenied(c, session);
272
+ if (denied)
273
+ return denied;
242
274
  return c.json({
243
275
  context_optimization: session.settings.contextOptimization,
244
276
  sliding_window_mode: session.settings.slidingWindowMode,
@@ -253,7 +285,15 @@ requestSessionService) {
253
285
  });
254
286
  });
255
287
  // PATCH /api/v2/sessions/:id/optimization — обновить настройки
288
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
256
289
  app.patch('/:id/optimization', kit.requireAuth, async (c) => {
290
+ const session = await sessionManager.getSession(c.req.param('id'));
291
+ if (!session) {
292
+ return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
293
+ }
294
+ const denied = await sessionAccessDenied(c, session);
295
+ if (denied)
296
+ return denied;
257
297
  const body = await c.req.json().catch(() => ({}));
258
298
  await sessionManager.withLock(c.req.param('id'), async (s) => {
259
299
  if (body.context_optimization !== undefined)
@@ -282,11 +322,15 @@ requestSessionService) {
282
322
  return c.json(serializeSession(updated, { agentRegistry }));
283
323
  });
284
324
  // POST /api/v2/sessions/:id/optimization/check — проверить триггеры
325
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
285
326
  app.post('/:id/optimization/check', kit.requireAuth, async (c) => {
286
327
  const session = await sessionManager.getSession(c.req.param('id'));
287
328
  if (!session) {
288
329
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
289
330
  }
331
+ const denied = await sessionAccessDenied(c, session);
332
+ if (denied)
333
+ return denied;
290
334
  if (!contextOptimizer) {
291
335
  return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
292
336
  }
@@ -299,11 +343,15 @@ requestSessionService) {
299
343
  });
300
344
  });
301
345
  // POST /api/v2/sessions/:id/optimization/cancel-summarization — отменить ожидающую суммаризацию
346
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
302
347
  app.post('/:id/optimization/cancel-summarization', kit.requireAuth, async (c) => {
303
348
  const session = await sessionManager.getSession(c.req.param('id'));
304
349
  if (!session) {
305
350
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
306
351
  }
352
+ const denied = await sessionAccessDenied(c, session);
353
+ if (denied)
354
+ return denied;
307
355
  await sessionManager.withLock(session.id, async (s) => {
308
356
  s.summarizationPending = false;
309
357
  await sessionManager.saveSession(s);
@@ -321,15 +369,27 @@ requestSessionService) {
321
369
  });
322
370
  // ===== Sticky Notes =====
323
371
  // GET /api/v2/sessions/:id/notes — список заметок
372
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
324
373
  app.get('/:id/notes', kit.requireAuth, async (c) => {
325
374
  const session = await sessionManager.getSession(c.req.param('id'));
326
375
  if (!session) {
327
376
  return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
328
377
  }
378
+ const denied = await sessionAccessDenied(c, session);
379
+ if (denied)
380
+ return denied;
329
381
  return c.json({ notes: session.stickyNotes });
330
382
  });
331
383
  // POST /api/v2/sessions/:id/notes — создать заметку
384
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
332
385
  app.post('/:id/notes', kit.requireAuth, async (c) => {
386
+ const session = await sessionManager.getSession(c.req.param('id'));
387
+ if (!session) {
388
+ return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
389
+ }
390
+ const denied = await sessionAccessDenied(c, session);
391
+ if (denied)
392
+ return denied;
333
393
  const body = await c.req.json().catch(() => ({}));
334
394
  if (!body.content?.trim()) {
335
395
  return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
@@ -351,7 +411,15 @@ requestSessionService) {
351
411
  return c.json({ note, notes: updated.stickyNotes }, 201);
352
412
  });
353
413
  // PATCH /api/v2/sessions/:id/notes/:noteId — обновить заметку
414
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
354
415
  app.patch('/:id/notes/:noteId', kit.requireAuth, async (c) => {
416
+ const session = await sessionManager.getSession(c.req.param('id'));
417
+ if (!session) {
418
+ return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
419
+ }
420
+ const denied = await sessionAccessDenied(c, session);
421
+ if (denied)
422
+ return denied;
355
423
  const body = await c.req.json().catch(() => ({}));
356
424
  const noteId = c.req.param('noteId');
357
425
  await sessionManager.withLock(c.req.param('id'), async (s) => {
@@ -370,7 +438,15 @@ requestSessionService) {
370
438
  return c.json({ notes: updated.stickyNotes });
371
439
  });
372
440
  // DELETE /api/v2/sessions/:id/notes/:noteId — удалить заметку
441
+ // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
373
442
  app.delete('/:id/notes/:noteId', kit.requireAuth, async (c) => {
443
+ const session = await sessionManager.getSession(c.req.param('id'));
444
+ if (!session) {
445
+ return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
446
+ }
447
+ const denied = await sessionAccessDenied(c, session);
448
+ if (denied)
449
+ return denied;
374
450
  const noteId = c.req.param('noteId');
375
451
  await sessionManager.withLock(c.req.param('id'), async (s) => {
376
452
  s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
@@ -387,21 +463,21 @@ requestSessionService) {
387
463
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
388
464
  forkWithOwner: true,
389
465
  canAccess: (session, c, userId) => isSessionOwner(session, userId) || kit.isAdmin(c),
390
- // AD-089: сквозной обзор сессий для ADMIN/LEAD. Вызовы `kit.isAdmin`/`hasRole`
466
+ // ADR-089: сквозной обзор сессий для ADMIN/LEAD. Вызовы `kit.isAdmin`/`hasRole`
391
467
  // защищены `typeof` — у мок-AuthKit в тестах они могут отсутствовать.
392
468
  resolveElevated: (c) => {
393
469
  const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
394
470
  const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
395
471
  return isAdmin || isLead;
396
472
  },
397
- // AD-089: проекты-участия пользователя — проектные сессии видны участникам.
473
+ // ADR-089: проекты-участия пользователя — проектные сессии видны участникам.
398
474
  resolveMemberProjectIds: async (_c, userId) => {
399
475
  if (!projectStore)
400
476
  return [];
401
477
  const projects = await projectStore.list(userId);
402
478
  return projects.map((p) => p.id);
403
479
  },
404
- // AD-089: доступ по id — участник проекта сессии (owner/член), не только владелец.
480
+ // ADR-089: доступ по id — участник проекта сессии (owner/член), не только владелец.
405
481
  resolveCanAccessExtra: async (session, _c, userId) => {
406
482
  if (!projectStore || !session.projectId)
407
483
  return false;
@@ -420,7 +496,7 @@ requestSessionService) {
420
496
  promptMiddleware: [createRateLimiter(30, 60_000)],
421
497
  enableSessionEvents: false,
422
498
  resolveDefaultAgent,
423
- // AD-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
499
+ // ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
424
500
  scopeGuard,
425
501
  projectGuard,
426
502
  messages: {
@@ -28,7 +28,7 @@ export function createUserRoutes(kit, profiles) {
28
28
  });
29
29
  });
30
30
  // GET /api/v2/users/:id — детали пользователя (ADMIN или scope `users:read`).
31
- // AD-089/O1: отдаёт `identities` профиля (snake_case) — нужно аддонам для
31
+ // ADR-089/O1: отдаёт `identities` профиля (snake_case) — нужно аддонам для
32
32
  // адресации внешних идентичностей машинной кредой.
33
33
  app.get('/:id', requireAdminOrScope('users:read'), async (c) => {
34
34
  const id = c.req.param('id');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-backend",
3
- "version": "0.10.0",
3
+ "version": "0.10.1",
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.0",
12
- "@itphx/synth-shared": "0.10.0",
11
+ "@itphx/synth-core": "0.10.1",
12
+ "@itphx/synth-shared": "0.10.1",
13
13
  "hono": "^4.9.0",
14
14
  "hono-rate-limiter": "^0.5.3",
15
15
  "jose": "^6.2.3",