@itphx/synth-backend 0.13.8 → 0.13.10
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.
- package/dist/app/deps.d.ts +15 -2
- package/dist/app/deps.js +620 -57
- package/dist/app/listen.js +30 -35
- package/dist/app/mount-routes.js +258 -22
- package/dist/app/sse-events.js +2 -0
- package/dist/app.d.ts +7 -0
- package/dist/app.js +14 -11
- package/dist/auth/middleware.js +4 -12
- package/dist/auth/oidc.d.ts +46 -4
- package/dist/auth/oidc.js +55 -8
- package/dist/events/hub.d.ts +36 -2
- package/dist/events/hub.js +62 -3
- package/dist/events/visible-session-ids.d.ts +35 -0
- package/dist/events/visible-session-ids.js +29 -0
- package/dist/lib/app-config.js +35 -5
- package/dist/lib/i18n.js +14 -0
- package/dist/lib/principal-identity.d.ts +35 -0
- package/dist/lib/principal-identity.js +43 -0
- package/dist/lib/project-principal.d.ts +27 -0
- package/dist/lib/project-principal.js +27 -0
- package/dist/lib/recalc-can-summarize.js +8 -5
- package/dist/main.js +5 -1
- package/dist/routes/agents.d.ts +3 -3
- package/dist/routes/agents.js +6 -2
- package/dist/routes/auth.js +33 -0
- package/dist/routes/project-access.d.ts +61 -0
- package/dist/routes/project-access.js +62 -0
- package/dist/routes/projects.d.ts +41 -4
- package/dist/routes/projects.js +117 -15
- package/dist/routes/queue.d.ts +7 -1
- package/dist/routes/queue.js +7 -1
- package/dist/routes/schedules.d.ts +46 -0
- package/dist/routes/schedules.js +10 -0
- package/dist/routes/sessions.d.ts +53 -1
- package/dist/routes/sessions.js +92 -26
- package/dist/routes/users.d.ts +14 -1
- package/dist/routes/users.js +91 -1
- package/package.json +5 -5
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-140: связь профиля пользователя с принципалом (ACL-id).
|
|
3
|
+
*
|
|
4
|
+
* `ProfileData.id` — внутренний UUID профиля, а ACL-id (то, что стоит в
|
|
5
|
+
* `project.ownerId`, `project.members`, `session.ownerId`) — идентификатор
|
|
6
|
+
* пользователя из токена: OIDC `sub` либо debug-id (`admin`/`developer`).
|
|
7
|
+
* Из-за расхождения гранты, выданные через UI (каталог отдавал `profile.id`),
|
|
8
|
+
* не совпадали с принципалом, а передача владения не находила получателя.
|
|
9
|
+
*
|
|
10
|
+
* Связь делается через существующий механизм идентичностей (`ADR-089`):
|
|
11
|
+
* при логине профилю привязывается auth-идентичность (`provider: 'auth'`,
|
|
12
|
+
* `externalId` = id пользователя из токена). Миграции схемы не нужны —
|
|
13
|
+
* используется поле `ProfileData.identities`.
|
|
14
|
+
*/
|
|
15
|
+
import type { ProfileData, ProfileStore, User } from '@itphx/synth-shared';
|
|
16
|
+
/** Провайдер auth-идентичности: id пользователя из токена (OIDC `sub`/debug-id). */
|
|
17
|
+
export declare const AUTH_IDENTITY_PROVIDER = "auth";
|
|
18
|
+
/**
|
|
19
|
+
* ACL-id профиля: привязанная auth-идентичность (sub/debug-id) либо
|
|
20
|
+
* `profile.id` (legacy — профиль без auth-идентичности).
|
|
21
|
+
*/
|
|
22
|
+
export declare function principalIdOf(profile: ProfileData): string;
|
|
23
|
+
/**
|
|
24
|
+
* Привязать auth-идентичность пользователя к его профилю (при логине).
|
|
25
|
+
*
|
|
26
|
+
* Идемпотентно и best-effort: ошибка привязки не ломает вход (логируется
|
|
27
|
+
* вызывающим, без секретов).
|
|
28
|
+
* - профиль с такой auth-идентичностью уже есть → ничего не делаем;
|
|
29
|
+
* - иначе профиль по username → привязываем идентичность;
|
|
30
|
+
* - иначе создаём профиль и привязываем.
|
|
31
|
+
*
|
|
32
|
+
* `linkIdentity` возвращает `null`, если пара `(auth, id)` уже занята другим
|
|
33
|
+
* профилем (конфликт) — это не ошибка входа: факт логируется, вход продолжается.
|
|
34
|
+
*/
|
|
35
|
+
export declare function ensurePrincipalIdentity(profiles: ProfileStore, user: User): Promise<void>;
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { nowISO } from '@itphx/synth-shared';
|
|
2
|
+
/** Провайдер auth-идентичности: id пользователя из токена (OIDC `sub`/debug-id). */
|
|
3
|
+
export const AUTH_IDENTITY_PROVIDER = 'auth';
|
|
4
|
+
/**
|
|
5
|
+
* ACL-id профиля: привязанная auth-идентичность (sub/debug-id) либо
|
|
6
|
+
* `profile.id` (legacy — профиль без auth-идентичности).
|
|
7
|
+
*/
|
|
8
|
+
export function principalIdOf(profile) {
|
|
9
|
+
const auth = (profile.identities ?? []).find((i) => i.provider === AUTH_IDENTITY_PROVIDER);
|
|
10
|
+
return auth?.externalId ?? profile.id;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Привязать auth-идентичность пользователя к его профилю (при логине).
|
|
14
|
+
*
|
|
15
|
+
* Идемпотентно и best-effort: ошибка привязки не ломает вход (логируется
|
|
16
|
+
* вызывающим, без секретов).
|
|
17
|
+
* - профиль с такой auth-идентичностью уже есть → ничего не делаем;
|
|
18
|
+
* - иначе профиль по username → привязываем идентичность;
|
|
19
|
+
* - иначе создаём профиль и привязываем.
|
|
20
|
+
*
|
|
21
|
+
* `linkIdentity` возвращает `null`, если пара `(auth, id)` уже занята другим
|
|
22
|
+
* профилем (конфликт) — это не ошибка входа: факт логируется, вход продолжается.
|
|
23
|
+
*/
|
|
24
|
+
export async function ensurePrincipalIdentity(profiles, user) {
|
|
25
|
+
const linked = await profiles.findProfileByExternalId(AUTH_IDENTITY_PROVIDER, user.id);
|
|
26
|
+
if (linked)
|
|
27
|
+
return;
|
|
28
|
+
const byUsername = await profiles.getProfileByUsername(user.username);
|
|
29
|
+
const profile = byUsername ?? await profiles.getOrCreateProfile({
|
|
30
|
+
username: user.username,
|
|
31
|
+
roles: user.roles,
|
|
32
|
+
});
|
|
33
|
+
const updated = await profiles.linkIdentity(profile.id, {
|
|
34
|
+
provider: AUTH_IDENTITY_PROVIDER,
|
|
35
|
+
externalId: user.id,
|
|
36
|
+
linkedAt: nowISO(),
|
|
37
|
+
linkedBy: 'login',
|
|
38
|
+
});
|
|
39
|
+
if (!updated) {
|
|
40
|
+
// Конфликт: пара `(auth, id)` занята другим профилем — перезаписывать нельзя.
|
|
41
|
+
console.warn('[auth] привязка auth-идентичности не выполнена: пара занята другим профилем');
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-133 §1: принципал доступа к проекту — пользователь, его роли инстанса
|
|
3
|
+
* и группы.
|
|
4
|
+
*
|
|
5
|
+
* Единая точка сборки принципала для backend-контуров (`routes/projects.ts`,
|
|
6
|
+
* `routes/sessions.ts`, `events/hub.ts`): иначе «кто запрашивает» собирался бы
|
|
7
|
+
* в трёх местах по-разному, а правила доступа разошлись бы (PROP-133 §1).
|
|
8
|
+
*
|
|
9
|
+
* Группы (ADR-140 Ф2): источник — claim `groups` из IdP, доставленный в
|
|
10
|
+
* `User.groups` (снимок на момент логина). Поле читается напрямую; нет поля /
|
|
11
|
+
* не массив / пусто → групп нет (fail-closed).
|
|
12
|
+
*/
|
|
13
|
+
import type { ProjectPrincipal, User } from '@itphx/synth-shared';
|
|
14
|
+
/**
|
|
15
|
+
* ADR-140: группы пользователя.
|
|
16
|
+
*
|
|
17
|
+
* Нет поля / не массив / пусто → `undefined` (групп нет — fail-closed).
|
|
18
|
+
*/
|
|
19
|
+
export declare function groupsOf(user: User | null | undefined): readonly string[] | undefined;
|
|
20
|
+
/**
|
|
21
|
+
* PROP-133 §1: принципал доступа к проекту.
|
|
22
|
+
*
|
|
23
|
+
* `userId` — идентификатор пользователя запроса (владелец сессии/проекта);
|
|
24
|
+
* `roles` — глобальные роли инстанса (`ADMIN`/`LEAD` — сквозной обзор);
|
|
25
|
+
* `groups` — группы пользователя (ADR-140; нет — `undefined`).
|
|
26
|
+
*/
|
|
27
|
+
export declare function projectPrincipalOf(user: User | null | undefined, userId: string, roles?: readonly string[]): ProjectPrincipal;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-140: группы пользователя.
|
|
3
|
+
*
|
|
4
|
+
* Нет поля / не массив / пусто → `undefined` (групп нет — fail-closed).
|
|
5
|
+
*/
|
|
6
|
+
export function groupsOf(user) {
|
|
7
|
+
const groups = user?.groups;
|
|
8
|
+
if (!Array.isArray(groups))
|
|
9
|
+
return undefined;
|
|
10
|
+
const named = groups.filter((group) => typeof group === 'string' && group.length > 0);
|
|
11
|
+
return named.length > 0 ? named : undefined;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* PROP-133 §1: принципал доступа к проекту.
|
|
15
|
+
*
|
|
16
|
+
* `userId` — идентификатор пользователя запроса (владелец сессии/проекта);
|
|
17
|
+
* `roles` — глобальные роли инстанса (`ADMIN`/`LEAD` — сквозной обзор);
|
|
18
|
+
* `groups` — группы пользователя (ADR-140; нет — `undefined`).
|
|
19
|
+
*/
|
|
20
|
+
export function projectPrincipalOf(user, userId, roles) {
|
|
21
|
+
const groups = groupsOf(user);
|
|
22
|
+
return {
|
|
23
|
+
userId,
|
|
24
|
+
roles: roles ?? user?.roles ?? [],
|
|
25
|
+
...(groups ? { groups } : {}),
|
|
26
|
+
};
|
|
27
|
+
}
|
|
@@ -27,12 +27,15 @@ export function createRecalcCanSummarize({ sessionManager, contextOptimizer, eve
|
|
|
27
27
|
shouldClearPending = true;
|
|
28
28
|
}
|
|
29
29
|
}
|
|
30
|
-
|
|
31
|
-
|
|
30
|
+
// Значение считается по **свежему снимку** (нужна история), а запись —
|
|
31
|
+
// точечная, под локом порта: полный снимок затирал бы параллельную
|
|
32
|
+
// дозапись сообщений. `updatedAt` не двигаем — паритет с прежним
|
|
33
|
+
// `saveSession` (пересчёт после правок истории не «оживляет» сессию).
|
|
34
|
+
await sessionManager.mutateMeta(sessionId, (meta) => {
|
|
35
|
+
meta.canSummarize = can;
|
|
32
36
|
if (shouldClearPending)
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
});
|
|
37
|
+
meta.summarizationPending = false;
|
|
38
|
+
}, { touchUpdatedAt: false });
|
|
36
39
|
eventBus.publish(sessionId, 'session.updated', {
|
|
37
40
|
session_id: sessionId,
|
|
38
41
|
can_summarize: can,
|
package/dist/main.js
CHANGED
|
@@ -19,7 +19,7 @@ catch (err) {
|
|
|
19
19
|
console.error(err instanceof Error ? err.message : String(err));
|
|
20
20
|
process.exit(1);
|
|
21
21
|
}
|
|
22
|
-
const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopAnalyticsRollupPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner, stopMetrics, stopQuestionPruner, stopBackgroundRunPruner, stopProcessLogPruner, stopAttachmentPruner, stopMediaTempPruner } = handle;
|
|
22
|
+
const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopAnalyticsRollupPruner, stopScheduler, stopTimerService, stopWebhookService, stopWebhookDeliveryPruner, stopMetrics, stopQuestionPruner, stopBackgroundRunPruner, stopProcessLogPruner, stopAttachmentPruner, stopMediaTempPruner, stopTerminalService } = handle;
|
|
23
23
|
// ADR-090 (Ф5б-1): старт-активация установленных плагинов.
|
|
24
24
|
// `plugins.lock.json` — источник истины; `plugins.executionEnabled=false`
|
|
25
25
|
// (дефолт) → no-op. Ошибка плагина/рантайма **не роняет старт** (только
|
|
@@ -88,11 +88,15 @@ async function gracefulShutdown(signal, exitCode = 0) {
|
|
|
88
88
|
stopAttachmentPruner();
|
|
89
89
|
// ADR-115 × ADR-077: остановить уборку временных каталогов медиа-раннера.
|
|
90
90
|
stopMediaTempPruner();
|
|
91
|
+
// PROP-132 (Ф3в): остановить сервис терминалов (живые PTY гасятся).
|
|
92
|
+
stopTerminalService();
|
|
91
93
|
// ADR-094: остановить процессные метрики и фоновые доменные коллекторы
|
|
92
94
|
// (таймеры сессий/хранилища, подписка шины, decision/journal).
|
|
93
95
|
stopMetrics();
|
|
94
96
|
// ADR-051 (срез): остановить планировщик расписаний.
|
|
95
97
|
stopScheduler();
|
|
98
|
+
// PROP-141 (Часть B): остановить движок таймеров/будильников.
|
|
99
|
+
stopTimerService();
|
|
96
100
|
// ADR-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
|
|
97
101
|
stopWebhookService();
|
|
98
102
|
stopWebhookDeliveryPruner();
|
package/dist/routes/agents.d.ts
CHANGED
|
@@ -2,14 +2,14 @@ import { Hono } from 'hono';
|
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { JsonStoreLike } from '@itphx/synth-core';
|
|
4
4
|
import type { AgentDefinition } from '@itphx/synth-shared';
|
|
5
|
-
import type { AgentRegistry, ContextFileRepository } from '@itphx/synth-core';
|
|
5
|
+
import type { AgentRegistry, ContextFileRepository, ExecutionProfileCatalog } from '@itphx/synth-core';
|
|
6
6
|
/**
|
|
7
7
|
* Backend-обёртка над core-фабрикой агентов: добавляет только RBAC
|
|
8
8
|
* (админ-эндпоинты — ADMIN) и i18n-сообщения. Логика роутов
|
|
9
9
|
* (GET /, GET /all, POST /, GET /:id, DELETE /:id, PATCH /:id/enabled) — в core.
|
|
10
10
|
*
|
|
11
11
|
* `contextFiles` — порт файлов контекста: запись ролевого промпта агента
|
|
12
|
-
* вместе с агентом (ADR-
|
|
12
|
+
* вместе с агентом (ADR-126/ADR-089, поле `role_prompt` в теле POST).
|
|
13
13
|
* Роль пишется тем же guard'ом, что и создание агента (ADMIN).
|
|
14
14
|
*
|
|
15
15
|
* ADR-052: запись агентов (создание + ролевой промпт) — «роль ADMIN **или**
|
|
@@ -17,4 +17,4 @@ import type { AgentRegistry, ContextFileRepository } from '@itphx/synth-core';
|
|
|
17
17
|
* расширений). Guard `requireAdminRoleOrScope` учитывает и роль ADMIN в
|
|
18
18
|
* service-key, и scope — прежние права не отбираются, новые добавляются.
|
|
19
19
|
*/
|
|
20
|
-
export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>, contextFiles?: ContextFileRepository): Hono;
|
|
20
|
+
export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>, contextFiles?: ContextFileRepository, executionProfileCatalog?: ExecutionProfileCatalog, browserProfileCatalog?: ExecutionProfileCatalog): Hono;
|
package/dist/routes/agents.js
CHANGED
|
@@ -8,7 +8,7 @@ import { t } from '../lib/i18n.js';
|
|
|
8
8
|
* (GET /, GET /all, POST /, GET /:id, DELETE /:id, PATCH /:id/enabled) — в core.
|
|
9
9
|
*
|
|
10
10
|
* `contextFiles` — порт файлов контекста: запись ролевого промпта агента
|
|
11
|
-
* вместе с агентом (ADR-
|
|
11
|
+
* вместе с агентом (ADR-126/ADR-089, поле `role_prompt` в теле POST).
|
|
12
12
|
* Роль пишется тем же guard'ом, что и создание агента (ADMIN).
|
|
13
13
|
*
|
|
14
14
|
* ADR-052: запись агентов (создание + ролевой промпт) — «роль ADMIN **или**
|
|
@@ -16,13 +16,17 @@ import { t } from '../lib/i18n.js';
|
|
|
16
16
|
* расширений). Guard `requireAdminRoleOrScope` учитывает и роль ADMIN в
|
|
17
17
|
* service-key, и scope — прежние права не отбираются, новые добавляются.
|
|
18
18
|
*/
|
|
19
|
-
export function createAgentRoutes(kit, agentStore, agentRegistry, getDefaultAgentId, contextFiles) {
|
|
19
|
+
export function createAgentRoutes(kit, agentStore, agentRegistry, getDefaultAgentId, contextFiles, executionProfileCatalog, browserProfileCatalog) {
|
|
20
20
|
const app = new Hono();
|
|
21
21
|
app.route('/', createCoreAgentRoutes({ requireAuth: kit.requireAuth }, agentStore, agentRegistry, getDefaultAgentId, {
|
|
22
22
|
writeGuard: requireAdminRoleOrScope('automation:install'),
|
|
23
23
|
allGuard: kit.requireAdmin,
|
|
24
24
|
detailGuard: kit.requireAdmin,
|
|
25
25
|
roleFiles: contextFiles,
|
|
26
|
+
// PROP-135 Ф6a: каталог профилей — проверка профиля агента при записи.
|
|
27
|
+
...(executionProfileCatalog ? { executionProfileCatalog } : {}),
|
|
28
|
+
// PROP-135 (браузерный контур): каталог браузерных профилей агента.
|
|
29
|
+
...(browserProfileCatalog ? { browserProfileCatalog } : {}),
|
|
26
30
|
messages: {
|
|
27
31
|
idRequired: (c) => t('errors.validation.idRequired', undefined, c),
|
|
28
32
|
invalidAgentId: (c) => t('errors.validation.invalidAgentId', undefined, c),
|
package/dist/routes/auth.js
CHANGED
|
@@ -7,7 +7,17 @@ import { getDefaultLang, setDefaultLang } from '../lib/i18n-config.js';
|
|
|
7
7
|
import { resolveAppearanceDefaults } from '@itphx/synth-core';
|
|
8
8
|
import { readFile, writeFile, unlink } from 'node:fs/promises';
|
|
9
9
|
import { join, resolve, sep } from 'node:path';
|
|
10
|
+
import { ensurePrincipalIdentity } from '../lib/principal-identity.js';
|
|
10
11
|
const OIDC_STATE_COOKIE = 'oidc_state';
|
|
12
|
+
/**
|
|
13
|
+
* ADR-140: группы пользователя в ответах `/auth/*`.
|
|
14
|
+
*
|
|
15
|
+
* Поле добавляется **только при непустом списке** — у пользователя без групп
|
|
16
|
+
* `groups` в ответе отсутствует (аддитивно, старый клиент не ломается).
|
|
17
|
+
*/
|
|
18
|
+
function groupsField(user) {
|
|
19
|
+
return user.groups && user.groups.length > 0 ? { groups: user.groups } : {};
|
|
20
|
+
}
|
|
11
21
|
// Встроенные умолчания оформления (совпадают с тем, что использует UI
|
|
12
22
|
// по умолчанию: packages/ui/src/lib/defaults.ts + uiScale.ts) живут в core —
|
|
13
23
|
// один источник для standalone (`GET /auth/defaults`) и managed (здесь),
|
|
@@ -24,6 +34,8 @@ const DEFAULT_FIELDS = [
|
|
|
24
34
|
'uiScaleDesktop',
|
|
25
35
|
'chatViewMode',
|
|
26
36
|
'chatDensity',
|
|
37
|
+
'userMessageMarkdown',
|
|
38
|
+
'mermaidRenderingMode',
|
|
27
39
|
'chatScaleMobile',
|
|
28
40
|
'chatScaleDesktop',
|
|
29
41
|
];
|
|
@@ -60,6 +72,21 @@ pluginPolicySignal) {
|
|
|
60
72
|
// Сохранённые умолчания перекрывают встроенные; uiScaleMobile/uiScaleDesktop: null — умолчание не задано.
|
|
61
73
|
const resolveDefaults = async () => resolveAppearanceDefaults(defaultsStore, getDefaultLang());
|
|
62
74
|
const getOidcClient = createLazyOidcClient(config.oidc);
|
|
75
|
+
/**
|
|
76
|
+
* ADR-140: привязать auth-идентичность пользователя (id из токена) к его
|
|
77
|
+
* профилю при входе — чтобы ACL-id (каталог, передача владения) совпадал с
|
|
78
|
+
* принципалом. Best-effort: ошибка привязки логируется, вход не ломается.
|
|
79
|
+
*/
|
|
80
|
+
const linkPrincipalIdentity = async (user) => {
|
|
81
|
+
if (!profiles)
|
|
82
|
+
return;
|
|
83
|
+
try {
|
|
84
|
+
await ensurePrincipalIdentity(profiles, user);
|
|
85
|
+
}
|
|
86
|
+
catch (err) {
|
|
87
|
+
console.warn('[auth] привязка auth-идентичности не удалась:', err instanceof Error ? err.message : String(err));
|
|
88
|
+
}
|
|
89
|
+
};
|
|
63
90
|
// GET /auth/login — редирект на Keycloak authorize endpoint
|
|
64
91
|
app.get('/login', async (c) => {
|
|
65
92
|
const client = getOidcClient();
|
|
@@ -94,6 +121,7 @@ pluginPolicySignal) {
|
|
|
94
121
|
const user = oidcUserToUser(oidcUser);
|
|
95
122
|
const sessionId = kit.createSession(user);
|
|
96
123
|
kit.setSessionCookie(c, sessionId);
|
|
124
|
+
await linkPrincipalIdentity(user);
|
|
97
125
|
return c.json({ deployment: 'managed', user: { id: user.id, username: user.username, email: user.email, roles: user.roles } });
|
|
98
126
|
}
|
|
99
127
|
catch (err) {
|
|
@@ -120,6 +148,7 @@ pluginPolicySignal) {
|
|
|
120
148
|
const user = oidcUserToUser(oidcUser);
|
|
121
149
|
const sessionId = kit.createSession(user);
|
|
122
150
|
kit.setSessionCookie(c, sessionId);
|
|
151
|
+
await linkPrincipalIdentity(user);
|
|
123
152
|
return c.redirect('/');
|
|
124
153
|
}
|
|
125
154
|
catch (err) {
|
|
@@ -142,6 +171,7 @@ pluginPolicySignal) {
|
|
|
142
171
|
username: user.username,
|
|
143
172
|
email: user.email,
|
|
144
173
|
roles: user.roles,
|
|
174
|
+
...groupsField(user),
|
|
145
175
|
} : null,
|
|
146
176
|
});
|
|
147
177
|
});
|
|
@@ -176,6 +206,7 @@ pluginPolicySignal) {
|
|
|
176
206
|
username: user.username,
|
|
177
207
|
email: user.email,
|
|
178
208
|
roles: user.roles,
|
|
209
|
+
...groupsField(user),
|
|
179
210
|
},
|
|
180
211
|
});
|
|
181
212
|
});
|
|
@@ -190,6 +221,7 @@ pluginPolicySignal) {
|
|
|
190
221
|
username: user.username,
|
|
191
222
|
email: user.email,
|
|
192
223
|
roles: user.roles,
|
|
224
|
+
...groupsField(user),
|
|
193
225
|
});
|
|
194
226
|
});
|
|
195
227
|
// POST /auth/spa-login — SPA-логин
|
|
@@ -236,6 +268,7 @@ pluginPolicySignal) {
|
|
|
236
268
|
}
|
|
237
269
|
const sessionId = kit.createSession(user);
|
|
238
270
|
kit.setSessionCookie(c, sessionId);
|
|
271
|
+
await linkPrincipalIdentity(user);
|
|
239
272
|
return c.json({
|
|
240
273
|
deployment: 'managed',
|
|
241
274
|
user: {
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Managed-доступ к проектным ресурсам автоматизаций (PROP-141, этап 5 B-1/B-2).
|
|
3
|
+
*
|
|
4
|
+
* Право — на **проект ресурса** (ADR-089 §5.5/§5.8, инвариант 21):
|
|
5
|
+
*
|
|
6
|
+
* | Актор | чтение | мутации |
|
|
7
|
+
* |------------------------------|---------------------------|----------------------------------|
|
|
8
|
+
* | владелец проекта | да | да |
|
|
9
|
+
* | участник `EDITOR` | да | да |
|
|
10
|
+
* | участник `VIEWER` | да | **403** (`VIEWER` не мутирует) |
|
|
11
|
+
* | `LEAD`/`ADMIN` | да (сквозной обзор) | да |
|
|
12
|
+
* | чужой `USER` | **не видно в списке** | 403/404 |
|
|
13
|
+
*
|
|
14
|
+
* Правило доступа — **одно** для HTTP-контура и агентских тулов
|
|
15
|
+
* (`engine/tools/automation-helpers.ts`): источник истины по ролям —
|
|
16
|
+
* `createProjectAccess` (PROP-133), тот же резолвер, что у `routes/processes.ts`
|
|
17
|
+
* и `routes/messages.ts`.
|
|
18
|
+
*
|
|
19
|
+
* **service-key (ADR-052)** — не пользователь проекта (`service:<keyId>` не
|
|
20
|
+
* участник), поэтому ролевая проверка по проекту к нему не применяется:
|
|
21
|
+
* scope проверяет `requireScope`, проекцию `allowedProjects` —
|
|
22
|
+
* `serviceProjectProjection`. Здесь service-key ограничен своей проекцией:
|
|
23
|
+
* список — по `allowedProjects` (не задана — все проекты, пустой список —
|
|
24
|
+
* ничего), а проект вне проекции — 403.
|
|
25
|
+
*
|
|
26
|
+
* Общий хелпер для **расписаний** (`routes/schedules.ts`) и **таймеров**
|
|
27
|
+
* (`routes/timers.ts`): правило одно, копии нет.
|
|
28
|
+
*/
|
|
29
|
+
import type { Context } from 'hono';
|
|
30
|
+
import type { ProjectRepository } from '@itphx/synth-core';
|
|
31
|
+
import type { AuthKit } from '../auth/middleware.js';
|
|
32
|
+
export interface BackendProjectAccessDeps {
|
|
33
|
+
/** AuthKit backend (OIDC/RBAC). */
|
|
34
|
+
auth: AuthKit;
|
|
35
|
+
/** Порт проектов — по нему резолвятся права на проект ресурса. */
|
|
36
|
+
projectStore: ProjectRepository;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Реализации опций core-фабрик (расписаний/таймеров): граничная проверка
|
|
40
|
+
* прав на проект и скоуп видимости списка.
|
|
41
|
+
*/
|
|
42
|
+
export interface BackendProjectAccess {
|
|
43
|
+
/**
|
|
44
|
+
* Граничная проверка доступа к проекту ресурса (инвариант 16):
|
|
45
|
+
* `read` — право чтения, `write` — право изменения содержимого.
|
|
46
|
+
* `null` — доступ разрешён; иначе — готовый ответ (403/404).
|
|
47
|
+
*/
|
|
48
|
+
authorizeProject: (c: Context, projectId: string, mode: 'read' | 'write') => Promise<Response | null>;
|
|
49
|
+
/**
|
|
50
|
+
* Скоуп чтения списка: id проектов, видимых пользователю; `null` — «все»
|
|
51
|
+
* (`ADMIN`/`LEAD` — сквозной обзор; service-key без `allowedProjects`).
|
|
52
|
+
*/
|
|
53
|
+
listVisibleProjectIds: (c: Context) => Promise<string[] | null>;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Собрать managed-правило доступа к проектным ресурсам автоматизаций.
|
|
57
|
+
*
|
|
58
|
+
* Fail-closed: нет пользователя/проекта/прав — отказ; проект не найден — 404
|
|
59
|
+
* (ресурса нет), права не те — 403.
|
|
60
|
+
*/
|
|
61
|
+
export declare function createBackendProjectAccess(deps: BackendProjectAccessDeps): BackendProjectAccess;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { getServiceCredential } from '@itphx/synth-core';
|
|
2
|
+
import { createProjectAccess } from './projects.js';
|
|
3
|
+
import { groupsOf } from '../lib/project-principal.js';
|
|
4
|
+
import { t } from '../lib/i18n.js';
|
|
5
|
+
/**
|
|
6
|
+
* Собрать managed-правило доступа к проектным ресурсам автоматизаций.
|
|
7
|
+
*
|
|
8
|
+
* Fail-closed: нет пользователя/проекта/прав — отказ; проект не найден — 404
|
|
9
|
+
* (ресурса нет), права не те — 403.
|
|
10
|
+
*/
|
|
11
|
+
export function createBackendProjectAccess(deps) {
|
|
12
|
+
const projectAccess = createProjectAccess(deps.auth);
|
|
13
|
+
const forbidden = (c) => c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
14
|
+
const projectNotFound = (c) => c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.project', undefined, c) } }, 404);
|
|
15
|
+
const unauthorized = (c) => c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
16
|
+
const authorizeProject = async (c, projectId, mode) => {
|
|
17
|
+
// ADR-052: service-key — не пользователь проекта (`service:<keyId>` не
|
|
18
|
+
// участник), поэтому ролевую проверку по проекту для него не применяем:
|
|
19
|
+
// scope проверяет `requireScope`, а проекцию `allowedProjects` —
|
|
20
|
+
// `serviceProjectProjection`. Здесь — только граница проекции:
|
|
21
|
+
// проекта вне `allowedProjects` ключ не адресует (403).
|
|
22
|
+
const credential = getServiceCredential(c);
|
|
23
|
+
if (credential) {
|
|
24
|
+
const allowedProjects = credential.allowedProjects;
|
|
25
|
+
if (!allowedProjects || allowedProjects.includes(projectId))
|
|
26
|
+
return null;
|
|
27
|
+
return forbidden(c);
|
|
28
|
+
}
|
|
29
|
+
const user = await deps.auth.getCurrentUser(c);
|
|
30
|
+
if (!user)
|
|
31
|
+
return unauthorized(c);
|
|
32
|
+
const project = await deps.projectStore.load(projectId);
|
|
33
|
+
if (!project)
|
|
34
|
+
return projectNotFound(c);
|
|
35
|
+
const allowed = mode === 'read'
|
|
36
|
+
? projectAccess.canReadProject(c, project, user.id)
|
|
37
|
+
: projectAccess.canEditProjectContent(c, project, user.id);
|
|
38
|
+
return allowed ? null : forbidden(c);
|
|
39
|
+
};
|
|
40
|
+
const listVisibleProjectIds = async (c) => {
|
|
41
|
+
// ADR-052: service-key — область видимости = проекция `allowedProjects`
|
|
42
|
+
// (не задана — все проекты, как и у `isProjectAllowed`). Пустой список —
|
|
43
|
+
// не «всё», а «ничего»: fail-closed.
|
|
44
|
+
const credential = getServiceCredential(c);
|
|
45
|
+
if (credential)
|
|
46
|
+
return credential.allowedProjects ?? null;
|
|
47
|
+
const ctx = c;
|
|
48
|
+
const user = await deps.auth.getCurrentUser(c);
|
|
49
|
+
if (!user)
|
|
50
|
+
return [];
|
|
51
|
+
// `ADMIN`/`LEAD` — сквозной обзор (как `resolveElevated` в проектах).
|
|
52
|
+
if (deps.auth.isAdmin(ctx) || deps.auth.hasRole(ctx, 'LEAD'))
|
|
53
|
+
return null;
|
|
54
|
+
// Остальным — только проекты, доступные для чтения (PROP-133).
|
|
55
|
+
const projects = await deps.projectStore.list({
|
|
56
|
+
userId: user.id,
|
|
57
|
+
groups: groupsOf(c.get('user')),
|
|
58
|
+
});
|
|
59
|
+
return projects.map((project) => project.id);
|
|
60
|
+
};
|
|
61
|
+
return { authorizeProject, listVisibleProjectIds };
|
|
62
|
+
}
|
|
@@ -1,12 +1,18 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository, EventBus } from '@itphx/synth-core';
|
|
3
|
+
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository, EventBus, SecurityAuditRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { ExecutionProfileCatalog } from '@itphx/synth-core';
|
|
4
5
|
import type { WorktreeService } from '@itphx/synth-core';
|
|
5
|
-
import type {
|
|
6
|
+
import type { EventHub } from '../events/hub.js';
|
|
7
|
+
import type { ProfileStore, Project } from '@itphx/synth-shared';
|
|
6
8
|
/**
|
|
7
9
|
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
8
10
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
9
11
|
* ролей не дублировалась.
|
|
12
|
+
*
|
|
13
|
+
* PROP-133 §1: предикат — **единственный** резолвер доступа
|
|
14
|
+
* (`resolveProjectAccess`); здесь только сборка принципала запроса. Своей копии
|
|
15
|
+
* правил (owner/`members`/`ADMIN`/`LEAD`) больше нет.
|
|
10
16
|
*/
|
|
11
17
|
export declare function createProjectAccess(kit: AuthKit): {
|
|
12
18
|
canManageProject: (c: {
|
|
@@ -28,7 +34,7 @@ export declare function createProjectAccess(kit: AuthKit): {
|
|
|
28
34
|
export declare function createProjectRoutes(kit: AuthKit, store: ProjectRepository, sessionManager: SessionManager, workspacesRoot: string,
|
|
29
35
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
30
36
|
mcpManager?: McpManager,
|
|
31
|
-
/** ADR-
|
|
37
|
+
/** ADR-126 §11: сид скиллов нового проекта (системные дефолты). */
|
|
32
38
|
skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository,
|
|
33
39
|
/**
|
|
34
40
|
* ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
|
|
@@ -40,4 +46,35 @@ worktreeService?: WorktreeService,
|
|
|
40
46
|
* `project.updated`/`project.deleted` в канал каждой сессии проекта.
|
|
41
47
|
* Не задана — публикации нет (поведение прежнее).
|
|
42
48
|
*/
|
|
43
|
-
eventBus?: EventBus
|
|
49
|
+
eventBus?: EventBus,
|
|
50
|
+
/**
|
|
51
|
+
* PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
|
|
52
|
+
* валидация `project.executor.profile`/`allowedProfiles` (PUT /:id).
|
|
53
|
+
* Не задан — проверка существования профиля пропускается.
|
|
54
|
+
*/
|
|
55
|
+
executionProfileCatalog?: ExecutionProfileCatalog,
|
|
56
|
+
/**
|
|
57
|
+
* PROP-135 (браузерный контур): каталог браузерных профилей — валидация
|
|
58
|
+
* `project.executor.browserProfile`/`allowedBrowserProfiles`.
|
|
59
|
+
*/
|
|
60
|
+
browserProfileCatalog?: ExecutionProfileCatalog,
|
|
61
|
+
/**
|
|
62
|
+
* PROP-133 §3.1: журнал изменений состояния доступа к проекту
|
|
63
|
+
* (`members`/`group_members`/`everyone_role`) — тот же порт
|
|
64
|
+
* `SecurityAuditRepository`, что у security-аудита (скоуп `projects`).
|
|
65
|
+
* Не задан — аудит не пишется (фича работает).
|
|
66
|
+
*/
|
|
67
|
+
securityAudit?: SecurityAuditRepository,
|
|
68
|
+
/**
|
|
69
|
+
* ADR-140 Ф2: хаб подписок WS/SSE — при смене состояния доступа к проекту
|
|
70
|
+
* подписки уже подключённых клиентов пересчитываются (доступ применяется
|
|
71
|
+
* к тем, кто подключён **до** изменения).
|
|
72
|
+
* Не задан — пересчёта нет (подписки остаются прежними).
|
|
73
|
+
*/
|
|
74
|
+
eventHub?: EventHub,
|
|
75
|
+
/**
|
|
76
|
+
* ADR-140 Ф3: профили пользователей — проверка получателя при передаче
|
|
77
|
+
* владения (`POST /:id/transfer`): цель должна существовать и быть активна.
|
|
78
|
+
* Не задан — передача владения невозможна (цель не проверяется).
|
|
79
|
+
*/
|
|
80
|
+
profilesStore?: ProfileStore): Hono;
|