@itphx/synth-backend 0.9.0 → 0.10.0

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.
@@ -15,7 +15,13 @@ export function createProjectAccess(kit) {
15
15
  /** D5: owner / EDITOR / глобальные LEAD/ADMIN — редактирование контента проекта. */
16
16
  const canEditProjectContent = (c, project, userId) => canManageProject(c, project, userId)
17
17
  || project.members?.[userId] === ProjectRole.EDITOR;
18
- return { canManageProject, canEditProjectContent };
18
+ /**
19
+ * AD-089: чтение проекта по id — owner / любой участник (любая роль, в т.ч.
20
+ * VIEWER) / глобальные LEAD/ADMIN. Не расширяет права на редактирование.
21
+ */
22
+ const canReadProject = (c, project, userId) => canManageProject(c, project, userId)
23
+ || userId in (project.members ?? {});
24
+ return { canManageProject, canEditProjectContent, canReadProject };
19
25
  }
20
26
  /**
21
27
  * Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только
@@ -28,10 +34,14 @@ export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
28
34
  mcpManager,
29
35
  /** AD-046 §4.5: сид скиллов нового проекта (системные дефолты). */
30
36
  skillService, settingsStore, mcpRegistryStore) {
31
- const { canManageProject, canEditProjectContent } = createProjectAccess(kit);
37
+ const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
32
38
  return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
33
39
  canManage: canManageProject,
34
40
  canEditContent: canEditProjectContent,
41
+ canRead: canReadProject,
42
+ // AD-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
43
+ resolveElevated: (c) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
44
+ || (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD')),
35
45
  getCurrentUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
36
46
  messages: {
37
47
  nameRequired: (c) => t('errors.validation.nameRequired', undefined, c),
@@ -5,6 +5,7 @@ import type { EventBus } from '@itphx/synth-core';
5
5
  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
+ import type { RequestSessionService } from '@itphx/synth-core';
8
9
  import type { ProfileStore } from '@itphx/synth-shared';
9
10
  import type { EventHub } from '../events/hub.js';
10
11
  import type { ProjectStore } from '@itphx/synth-core';
@@ -23,4 +24,9 @@ export declare function createSessionRoutes(kit: AuthKit, sessionManager: Sessio
23
24
  /** Профили пользователей: display name для статистики (fallback — username). */
24
25
  profilesStore?: ProfileStore,
25
26
  /** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
26
- resolveDefaultAgent?: () => string | Promise<string>): Hono;
27
+ resolveDefaultAgent?: () => string | Promise<string>,
28
+ /**
29
+ * AD-089: единый funnel создания сессий (прокидывается в core-фабрику).
30
+ * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
31
+ */
32
+ requestSessionService?: RequestSessionService): Hono;
@@ -1,6 +1,7 @@
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';
4
5
  import { enqueueUserMessage, serializeSession, createSessionRoutes as createCoreSessionRoutes, } from '@itphx/synth-core';
5
6
  import { t } from '../lib/i18n.js';
6
7
  /**
@@ -18,7 +19,12 @@ export function createSessionRoutes(kit, sessionManager, eventBus, queueManager,
18
19
  /** Профили пользователей: display name для статистики (fallback — username). */
19
20
  profilesStore,
20
21
  /** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
21
- resolveDefaultAgent) {
22
+ resolveDefaultAgent,
23
+ /**
24
+ * AD-089: единый funnel создания сессий (прокидывается в core-фабрику).
25
+ * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
26
+ */
27
+ requestSessionService) {
22
28
  const app = new Hono();
23
29
  const agentRegistry = orchestrator.agentRegistry;
24
30
  // AD-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
@@ -123,6 +129,8 @@ resolveDefaultAgent) {
123
129
  // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
124
130
  // (перенос истории между мирами). Тело: объект экспорта + import.project_id
125
131
  // (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
132
+ // AD-089: это materialization-операция (создание-как-факт переноса истории),
133
+ // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
126
134
  app.post('/import', kit.requireAuth, async (c) => {
127
135
  const user = (await kit.getCurrentUser(c));
128
136
  const body = await c.req.json().catch(() => ({}));
@@ -140,6 +148,7 @@ resolveDefaultAgent) {
140
148
  return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
141
149
  }
142
150
  }
151
+ // AD-089: materialization (перенос истории), не request — прямой createSession.
143
152
  const session = await sessionManager.createSession({
144
153
  title: typeof body.title === 'string' ? body.title : undefined,
145
154
  projectId: targetProjectId,
@@ -373,11 +382,34 @@ resolveDefaultAgent) {
373
382
  });
374
383
  // Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
375
384
  // последней: статические/backend-only сегменты должны матчиться раньше.
376
- app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore }, {
385
+ app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService }, {
377
386
  resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
378
387
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
379
388
  forkWithOwner: true,
380
389
  canAccess: (session, c, userId) => isSessionOwner(session, userId) || kit.isAdmin(c),
390
+ // AD-089: сквозной обзор сессий для ADMIN/LEAD. Вызовы `kit.isAdmin`/`hasRole`
391
+ // защищены `typeof` — у мок-AuthKit в тестах они могут отсутствовать.
392
+ resolveElevated: (c) => {
393
+ const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
394
+ const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
395
+ return isAdmin || isLead;
396
+ },
397
+ // AD-089: проекты-участия пользователя — проектные сессии видны участникам.
398
+ resolveMemberProjectIds: async (_c, userId) => {
399
+ if (!projectStore)
400
+ return [];
401
+ const projects = await projectStore.list(userId);
402
+ return projects.map((p) => p.id);
403
+ },
404
+ // AD-089: доступ по id — участник проекта сессии (owner/член), не только владелец.
405
+ resolveCanAccessExtra: async (session, _c, userId) => {
406
+ if (!projectStore || !session.projectId)
407
+ return false;
408
+ const project = await projectStore.load(session.projectId);
409
+ if (!project)
410
+ return false;
411
+ return project.ownerId === userId || userId in (project.members ?? {});
412
+ },
381
413
  resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
382
414
  promptMessageId: 'stream',
383
415
  publishRenamed: false,
@@ -388,6 +420,9 @@ resolveDefaultAgent) {
388
420
  promptMiddleware: [createRateLimiter(30, 60_000)],
389
421
  enableSessionEvents: false,
390
422
  resolveDefaultAgent,
423
+ // AD-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
424
+ scopeGuard,
425
+ projectGuard,
391
426
  messages: {
392
427
  sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
393
428
  forbidden: (c) => t('auth.forbidden', undefined, c),
@@ -2,10 +2,12 @@ import { Hono } from 'hono';
2
2
  import { nowISO } from '@itphx/synth-shared';
3
3
  import { randomUUID } from 'node:crypto';
4
4
  import { t } from '../lib/i18n.js';
5
+ import { requireAdminOrScope } from '../auth/guards.js';
5
6
  export function createUserRoutes(kit, profiles) {
6
7
  const app = new Hono();
7
- // GET /api/v2/users — список всех пользователей (admin)
8
- app.get('/', kit.requireAdmin, async (c) => {
8
+ // GET /api/v2/users — список всех пользователей (ADMIN или scope `users:read`).
9
+ // Идентичности сознательно не включаются: список не раздувается (детали — в /:id).
10
+ app.get('/', requireAdminOrScope('users:read'), async (c) => {
9
11
  const all = await profiles.listProfiles();
10
12
  return c.json({
11
13
  users: all.map((p) => ({
@@ -25,8 +27,10 @@ export function createUserRoutes(kit, profiles) {
25
27
  })),
26
28
  });
27
29
  });
28
- // GET /api/v2/users/:id — детали пользователя (admin)
29
- app.get('/:id', kit.requireAdmin, async (c) => {
30
+ // GET /api/v2/users/:id — детали пользователя (ADMIN или scope `users:read`).
31
+ // AD-089/O1: отдаёт `identities` профиля (snake_case) — нужно аддонам для
32
+ // адресации внешних идентичностей машинной кредой.
33
+ app.get('/:id', requireAdminOrScope('users:read'), async (c) => {
30
34
  const id = c.req.param('id');
31
35
  const p = await profiles.loadProfile(id);
32
36
  if (!p) {
@@ -42,6 +46,14 @@ export function createUserRoutes(kit, profiles) {
42
46
  display_name: p.displayName || null,
43
47
  is_active: p.isActive,
44
48
  notes: p.notes,
49
+ identities: (p.identities ?? []).map((identity) => ({
50
+ provider: identity.provider,
51
+ external_id: identity.externalId,
52
+ ...(identity.username !== undefined ? { username: identity.username } : {}),
53
+ ...(identity.displayName !== undefined ? { display_name: identity.displayName } : {}),
54
+ linked_at: identity.linkedAt,
55
+ ...(identity.linkedBy !== undefined ? { linked_by: identity.linkedBy } : {}),
56
+ })),
45
57
  created_at: p.createdAt,
46
58
  updated_at: p.updatedAt,
47
59
  last_login: p.lastLogin || null,
@@ -74,6 +86,7 @@ export function createUserRoutes(kit, profiles) {
74
86
  isActive: body.is_active ?? true,
75
87
  preferences: {},
76
88
  notes: body.notes || '',
89
+ interviewCompleted: false,
77
90
  displayName: body.display_name || undefined,
78
91
  createdAt: now,
79
92
  updatedAt: now,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-backend",
3
- "version": "0.9.0",
3
+ "version": "0.10.0",
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.9.0",
12
- "@itphx/synth-shared": "0.9.0",
11
+ "@itphx/synth-core": "0.10.0",
12
+ "@itphx/synth-shared": "0.10.0",
13
13
  "hono": "^4.9.0",
14
14
  "hono-rate-limiter": "^0.5.3",
15
15
  "jose": "^6.2.3",
@@ -27,7 +27,7 @@
27
27
  "scripts": {
28
28
  "dev": "tsx src/main.ts",
29
29
  "start": "node dist/main.js",
30
- "build": "rm -rf dist && tsc -p tsconfig.build.json && mkdir -p dist/agents && cp -r src/agents/definitions dist/agents/definitions",
30
+ "build": "rm -rf dist && tsc -p tsconfig.build.json",
31
31
  "typecheck": "tsc --noEmit",
32
32
  "lint": "eslint src/",
33
33
  "test": "vitest run",
@@ -1,24 +0,0 @@
1
- {
2
- "id": "admin",
3
- "displayName": {
4
- "en": "Admin",
5
- "ru": "Админ"
6
- },
7
- "description": {
8
- "en": "System administration and configuration",
9
- "ru": "Системное администрирование и настройка"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "file_write",
14
- "search",
15
- "shell",
16
- "git_read",
17
- "git_write",
18
- "task",
19
- "mcp"
20
- ],
21
- "icon": "shield-keyhole",
22
- "color": "--status-error",
23
- "contextFile": "ADMIN.md"
24
- }
@@ -1,20 +0,0 @@
1
- {
2
- "id": "analyst",
3
- "displayName": {
4
- "en": "Analyst",
5
- "ru": "Аналитик"
6
- },
7
- "description": {
8
- "en": "Code analysis, research and documentation",
9
- "ru": "Анализ кода, исследование и документация"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "search",
14
- "web",
15
- "mcp"
16
- ],
17
- "icon": "chart-line",
18
- "color": "--syntax-function",
19
- "contextFile": "ANALYST.md"
20
- }
@@ -1,25 +0,0 @@
1
- {
2
- "id": "assistant",
3
- "displayName": {
4
- "en": "Assistant",
5
- "ru": "Ассистент"
6
- },
7
- "description": {
8
- "en": "Universal assistant for any task",
9
- "ru": "Универсальный ассистент для любых задач"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "file_write",
14
- "search",
15
- "shell",
16
- "web",
17
- "git_read",
18
- "git_write",
19
- "task",
20
- "mcp"
21
- ],
22
- "icon": "robot-3",
23
- "color": "--status-success",
24
- "contextFile": "ASSISTANT.md"
25
- }
@@ -1,19 +0,0 @@
1
- {
2
- "id": "auditor",
3
- "displayName": {
4
- "en": "Security Auditor",
5
- "ru": "Аудитор безопасности"
6
- },
7
- "description": {
8
- "en": "Security audit and vulnerability search",
9
- "ru": "Аудит безопасности и поиск уязвимостей"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "search",
14
- "mcp"
15
- ],
16
- "icon": "shield-check",
17
- "color": "--status-warning",
18
- "contextFile": "AUDITOR.md"
19
- }
@@ -1,23 +0,0 @@
1
- {
2
- "id": "developer",
3
- "displayName": {
4
- "en": "Developer",
5
- "ru": "Разработчик"
6
- },
7
- "description": {
8
- "en": "Code development and refactoring",
9
- "ru": "Разработка и рефакторинг кода"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "file_write",
14
- "search",
15
- "shell",
16
- "git_read",
17
- "git_write",
18
- "mcp"
19
- ],
20
- "icon": "code-s-slash",
21
- "color": "--status-info",
22
- "contextFile": "DEVELOPER.md"
23
- }
@@ -1,23 +0,0 @@
1
- {
2
- "id": "devops",
3
- "displayName": {
4
- "en": "DevOps",
5
- "ru": "DevOps"
6
- },
7
- "description": {
8
- "en": "Infrastructure, CI/CD, deployment",
9
- "ru": "Инфраструктура, CI/CD, деплоймент"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "file_write",
14
- "search",
15
- "shell",
16
- "git_read",
17
- "git_write",
18
- "mcp"
19
- ],
20
- "icon": "server",
21
- "color": "--syntax-type",
22
- "contextFile": "DEVOPS.md"
23
- }
@@ -1,15 +0,0 @@
1
- {
2
- "id": "explore",
3
- "displayName": { "en": "Explorer", "ru": "Исследователь" },
4
- "description": {
5
- "en": "Fast codebase exploration and search (read-only)",
6
- "ru": "Быстрый поиск и исследование кодовой базы (только чтение)"
7
- },
8
- "capabilities": ["file_read", "search", "web", "mcp"],
9
- "icon": "search-eye",
10
- "color": "--syntax-keyword",
11
- "contextFile": "",
12
- "agentMode": ["subagent"],
13
- "subagentPrompt": "Ты — специалист по исследованию кодовых баз. Твоя задача — быстро находить файлы по шаблонам (glob), искать код по ключевым словам (grep), читать файлы и отвечать на вопросы о структуре проекта.\n\n## Инструменты\nУ тебя есть доступ к инструментам только для чтения: read_file, list_directory, glob, grep_files, web_fetch, web_search.\n\n## Что ты можешь\n- Находить файлы по glob-паттернам (например, \"src/components/**/*.tsx\")\n- Искать код по ключевым словам или регулярным выражениям\n- Читать содержимое найденных файлов\n- Отвечать на вопросы о структуре и содержимом кодовой базы\n\n## Что ты НЕ можешь\n- Изменять файлы\n- Выполнять shell-команды\n- Делать git-операции\n\n## Формат ответа\nВозвращай результат в формате:\n- Найденные файлы: абсолютные пути\n- Краткое описание находки\n- Ответ на поставленный вопрос\n\nБудь тщательным в поиске. Если задача требует поиска в нескольких местах, делай несколько запросов.",
14
- "maxSteps": 10
15
- }
@@ -1,15 +0,0 @@
1
- {
2
- "id": "general",
3
- "displayName": { "en": "General", "ru": "Универсальный" },
4
- "description": {
5
- "en": "Universal subagent for complex multi-step tasks",
6
- "ru": "Универсальный сабагент для сложных многошаговых задач"
7
- },
8
- "capabilities": ["file_read", "file_write", "search", "shell", "git_read", "git_write", "web", "mcp"],
9
- "icon": "robot-3",
10
- "color": "--syntax-variable",
11
- "contextFile": "",
12
- "agentMode": ["subagent"],
13
- "subagentPrompt": "Ты — универсальный помощник для выполнения сложных многошаговых задач.\nУ тебя есть доступ к инструментам для работы с файлами, поиска, git и shell.\n\n## Инструменты\nУ тебя есть полный набор инструментов: read_file, write_file, edit_file, list_directory, glob, grep_files, execute_shell, git_status, git_diff, git_log, git_commit, web_fetch, web_search.\n\n## Принципы работы\n1. Анализируй задачу и разбивай на логические шаги\n2. Выполняй шаги последовательно\n3. Проверяй результаты каждого шага\n4. Возвращай структурированный результат\n\n## Формат ответа\nВозвращай результат в формате:\n- Что было сделано (краткий список шагов)\n- Результат (ключевые находки, изменения, выводы)\n- Если что-то не получилось — объясни почему\n\nРаботай автономно, не задавай уточняющих вопросов если контекст достаточен.",
14
- "maxSteps": 15
15
- }
@@ -1,20 +0,0 @@
1
- {
2
- "id": "pm",
3
- "displayName": {
4
- "en": "Project Manager",
5
- "ru": "Менеджер проекта"
6
- },
7
- "description": {
8
- "en": "Planning, requirements analysis, coordination",
9
- "ru": "Планирование, анализ требований, координация"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "search",
14
- "web",
15
- "mcp"
16
- ],
17
- "icon": "clipboard",
18
- "color": "--primary",
19
- "contextFile": "PM.md"
20
- }
@@ -1,22 +0,0 @@
1
- {
2
- "id": "qa",
3
- "displayName": {
4
- "en": "QA Engineer",
5
- "ru": "Тестировщик"
6
- },
7
- "description": {
8
- "en": "Testing, quality assurance, bug reports",
9
- "ru": "Тестирование, контроль качества, баг-репорты"
10
- },
11
- "capabilities": [
12
- "file_read",
13
- "file_write",
14
- "search",
15
- "shell",
16
- "git_read",
17
- "mcp"
18
- ],
19
- "icon": "bug",
20
- "color": "--syntax-number",
21
- "contextFile": "QA.md"
22
- }