@itphx/synth-backend 0.11.3 → 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.
package/dist/app/deps.js CHANGED
@@ -4,12 +4,56 @@
4
4
  // Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
5
5
  import { mkdir } from 'node:fs/promises';
6
6
  import { join } from 'node:path';
7
- import { ensureDataDir, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword, resolveDegradedMode, resolveStorageFallbackDir, readTlsRuntimeSettings, } from '@itphx/synth-shared';
8
- import { SessionManager, EventBus, QueueProcessorManager, ContextBuilder, ContextOptimizer, ChatOrchestrator, enqueueUserMessage, createToolRegistry, createAgentRegistry, McpManager, DEFAULT_AGENT_ID, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeEventsConfig, mergeDecisionConfig, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner, SkillService, resolveProjectSkillSeed, CommandService, detectRuntimeDeps, syncProvidersFromEnv, HookBus, startEphemeralSweeper, assertInstanceDataNotTooNew, applyStartupMigrations, applyPendingRestore, EventRouter, RequestSessionService, EventIngress, eventToMessage, ProjectRuleProvider, DecisionRuleProvider, SchedulerRuleProvider, SchedulerService, AlwaysLeader, FileLeader, createExternalIdentityResolver, startEventJournalPruner, WebhookService, startWebhookDeliveryPruner, AnalyticsRecorder, attachAnalyticsActivityHooks, startAnalyticsRollupPruner, sessionAxes, createStorageContextAsync, initTlsTrust, applyStartupProxyConfig, attachBusMetrics, startSessionMetrics, startStorageMetrics, registerDecisionMetrics, createSchedulerMetrics, createWebhookMetrics, createEventMetrics, startEventJournalMetrics, } from '@itphx/synth-core';
7
+ import { ensureDataDir, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword, resolveDegradedMode, resolveStorageFallbackDir, resolveExecutionConfig, readTlsRuntimeSettings, SYNTH_VERSION, } from '@itphx/synth-shared';
8
+ import { SessionManager, EventBus, QueueProcessorManager, ContextBuilder, ContextOptimizer, ChatOrchestrator, enqueueUserMessage, createToolRegistry, createAgentRegistry, McpManager, DEFAULT_AGENT_ID, registerStoredAgents, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeEventsConfig, mergeDecisionConfig, mergePluginsConfig,
9
+ // ADR-115: живое состояние runtime-настроек вложений (`/settings/attachments`).
10
+ createLiveAttachmentsSettings, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner,
11
+ // ADR-105 (Ф3): источник access-токена для MCP-коннекторов + OAuth-сервис.
12
+ OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, detectRuntimeDeps, syncProvidersFromEnv,
13
+ // ADR-115 × ADR-101: доступность `ffmpeg` — обработчик вложения aux-моделью шага.
14
+ isFfmpegAvailable, HookBus, startEphemeralSweeper, assertInstanceDataNotTooNew, applyStartupMigrations, applyPendingRestore, EventRouter, RequestSessionService, EventIngress, eventToMessage, addEventAttachmentRefs, AttachmentService, ProjectRuleProvider, DecisionRuleProvider, PipelineTracker, SchedulerRuleProvider, SchedulerService, AlwaysLeader, FileLeader, createExternalIdentityResolver, startEventJournalPruner,
15
+ // Этап 1 roadmap 0.13 (блок 3): сервис вопросов пользователю + retention.
16
+ QuestionService, startQuestionPruner,
17
+ // Этап 1 roadmap 0.13 (блок 4): реестр фоновых прогонов + retention.
18
+ BackgroundRunService, startBackgroundRunPruner, createBackgroundParentNotifier,
19
+ // PROP-097 (блок 5b): сервис фоновых шелл-процессов + retention логов.
20
+ ProcessService, startProcessLogPruner,
21
+ // ADR-115: GC осиротевших вложений сообщений.
22
+ startAttachmentPruner,
23
+ // ADR-114: сервис worktree'ов (per-session рабочий каталог) + публикация
24
+ // `worktree.updated` в каналы сессий проекта.
25
+ WorktreeService, publishWorktreeUpdated, startWorktreeSweeper, WebhookService, startWebhookDeliveryPruner, AnalyticsRecorder, attachAnalyticsActivityHooks, startAnalyticsRollupPruner, sessionAxes, createStorageContextAsync, initTlsTrust, applyStartupProxyConfig, attachBusMetrics, startSessionMetrics, startStorageMetrics,
26
+ // ADR-094/PROP-047: метрики памяти (`synth_memory_*`).
27
+ startMemoryMetrics,
28
+ // ADR-107: телеметрия контекста памяти и recall (`synth_memory_context_*`,
29
+ // `synth_memory_recall_*`).
30
+ createMemoryTelemetry, registerDecisionMetrics, createSchedulerMetrics,
31
+ // ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`).
32
+ createExecutorMetricsCollector, createWebhookMetrics, createEventMetrics,
33
+ // ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) + установка их
34
+ // sink'а (сервис вложений собирается внутри фабрики роутов сессий).
35
+ createAttachmentMetrics, setAttachmentMetricsHook,
36
+ // ADR-106 Ф1/Ф2: счётчик решений Authority-слоя (`synth_authority_decisions_total`)
37
+ // и guard-слоя (решение считается; в enforced-режиме — применяется).
38
+ createAuthorityMetrics, AuthorityGuard,
39
+ // ADR-106 Ф3: реестр подтверждений + покрытие (носитель покрывающего гранта).
40
+ ApprovalRegistry, buildApprovalResponderProfile, createApprovalCoverageResolver, startEventJournalMetrics,
41
+ // ADR-101 (Э5): движок пайплайнов, исполнители шагов, обработчики выходов.
42
+ PipelineArtifactStore, PipelineEngine,
43
+ // ADR-101: реестр активных прогонов (soft-lock + отмена) — общий экземпляр
44
+ // для HTTP-роута пайплайнов и встроенных тулов агента.
45
+ PipelineRunControl, createToolStepExecutor, createScriptStepExecutor, createHumanStepExecutor, createAgentStepExecutor, createPipelineExitHandler, createPipelineMetrics,
46
+ // ADR-115 × ADR-101: вложения прогона — derive для text-only модели шага.
47
+ createPipelineAttachmentDerive, ensureBuiltinPipelines, toCoreProviderConfig, ProviderFactory,
48
+ // ADR-077: порт исполнения команд (inline/remote).
49
+ createExecutionPortForConfig,
50
+ // ADR-090 (Ф3а) / §5, §10 (Ф5б-1): общий реестр
51
+ // блоков промпта (композер + фасад плагинов) и рантайм плагинов.
52
+ PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, } from '@itphx/synth-core';
9
53
  import { EventHub } from '../events/hub.js';
10
54
  import { seedDebugTestUsers } from './bootstrap.js';
11
55
  /**
12
- * PROP-032 (W2.4): единая точка сборки слоя хранения backend — `app.ts` строит
56
+ * ADR-096 (W2.4): единая точка сборки слоя хранения backend — `app.ts` строит
13
57
  * её до `auth` (реестр `serviceKeys` нужен резолверу ключа, `mcpRegistry` —
14
58
  * сидированию instance-серверов), а `createBackendDeps` переиспользует инстанс.
15
59
  */
@@ -39,6 +83,11 @@ export async function createBackendStorage(config) {
39
83
  dedupStore: config.synth.events.dedupStore,
40
84
  scheduleCrossProcess: config.synth.scheduler.crossProcessLocks,
41
85
  bundlesPath: config.synth.commands.bundlesPath,
86
+ // ADR-090: путь lock-файла плагинов задаёт раскладка (композиционный
87
+ // корень) — `<home>/plugin/plugins.lock.json` либо `{dataDir}/plugin/…`.
88
+ // Резолвер один — `resolvePluginLayout` (его же использует `PluginRuntime`),
89
+ // поэтому порт и каталоги установки согласованы.
90
+ pluginLockPath: resolvePluginLayout({ dataDir: config.dataDir, env: process.env }).lockPath,
42
91
  });
43
92
  // ADR-099: второй шаг egress — runtime-override прокси после хранилища и до
44
93
  // создания deps/провайдеров (TLS/PG уже применены ранним `initTlsTrust`).
@@ -50,7 +99,12 @@ export async function createBackendStorage(config) {
50
99
  * событийное ядро/планировщик/webhooks). Роуты монтирует вызывающий
51
100
  * (`mountBackendRoutes`), поэтому здесь нет ни одного `app.*`-вызова.
52
101
  */
53
- export async function createBackendDeps(config, storage, metrics) {
102
+ export async function createBackendDeps(config, storage, metrics,
103
+ /**
104
+ * ADR-077: эффективная секция `execution` (режим исполнения + параметры
105
+ * удалённого исполнителя). Не задана — резолвится из конфигу инстанса.
106
+ */
107
+ executionConfig) {
54
108
  // Хранилища
55
109
  const dataDir = config.dataDir;
56
110
  await ensureDataDir(dataDir);
@@ -62,24 +116,43 @@ export async function createBackendDeps(config, storage, metrics) {
62
116
  // данные новее Synth → отказ старта (fail-fast); устаревшая схема → авто-миграции
63
117
  // с обязательной страховочной копией ниже (`applyStartupMigrations`).
64
118
  await assertInstanceDataNotTooNew(dataDir);
65
- // PROP-032 (W2.3/W2.4): единый контекст хранения — домен получает порты из
119
+ // ADR-096 (W2.3/W2.4): единый контекст хранения — домен получает порты из
66
120
  // одного места. По умолчанию собирается `createBackendStorage`, готовый можно
67
121
  // передать (паритет с `app.ts`, где `serviceKeys`/`mcpRegistry` нужны до `auth`).
68
122
  const storageContext = storage ?? (await createBackendStorage(config));
69
- // PROP-032 (W5): деградированное хранилище (postgres недоступен → файловый
123
+ // ADR-098 (W5): деградированное хранилище (postgres недоступен → файловый
70
124
  // фоллбек, read-only). Фоновые писатели отключаются (split-brain): миграции,
71
125
  // провайдеры из env, шедулер, webhooks, sweeper/ephemeral, retention-прунеры.
72
126
  const storageDegraded = storageContext.degraded !== undefined;
73
- const { settings: settingsStore, defaults: defaultsStore, secretPatterns: patternStore, protectedPaths: protectedPathsStore, sessions: fileStore, projects: projectStore, profiles: profilesStore, sshKeys: sshKeyStore, contextFiles: contextConfig, providers: providerStore, models: modelStore, agents: agentStore, dictionaries: dictionaryStore, serviceKeys: serviceApiKeyStore, webhooks: webhookStore, securityAudit, egressRequests, webhookDeliveries: webhookDeliveryStore, eventBindings: eventBindingStore, eventApiKeys: eventApiKeyStore, eventJournal, eventRoutes: routeRuleStore, identityClaims: identityClaimStore, dedup: dedupStore, schedules: scheduleStore, jobs: jobStore, skillBundles: bundleStore, mcpRegistry: mcpRegistryStore, analyticsRollups, } = storageContext;
127
+ const { settings: settingsStore, defaults: defaultsStore, secretPatterns: patternStore, protectedPaths: protectedPathsStore, sessions: fileStore, projects: projectStore, profiles: profilesStore, sshKeys: sshKeyStore, contextFiles: contextConfig, providers: providerStore, models: modelStore, agents: agentStore, dictionaries: dictionaryStore, serviceKeys: serviceApiKeyStore, webhooks: webhookStore, securityAudit, egressRequests, webhookDeliveries: webhookDeliveryStore, eventBindings: eventBindingStore, eventApiKeys: eventApiKeyStore, eventJournal, eventRoutes: routeRuleStore, identityClaims: identityClaimStore, dedup: dedupStore, schedules: scheduleStore, jobs: jobStore, skillBundles: bundleStore, mcpRegistry: mcpRegistryStore, analyticsRollups,
128
+ // ADR-051/ADR-100: реестр пайплайнов; ADR-086 §5: реестр установок пакетов.
129
+ pipelines: pipelineStore, packs: packStore, } = storageContext;
130
+ // ADR-101: реестр активных прогонов пайплайнов — **один на процесс**.
131
+ // Его получают и HTTP-роут пайплайнов, и встроенные тулы агента: поэтому
132
+ // soft-lock «не запустить второй прогон того же пайплайна» и отмена
133
+ // идущего прогона работают одинаково для обоих контуров.
134
+ const pipelineRunControl = new PipelineRunControl();
135
+ // ADR-101/ADR-051: рантайм автоматизации для встроенных тулов
136
+ // (`pipeline_*`/`schedule_*`). Движок пайплайнов и шедулер создаются
137
+ // **ниже** (после оркестратора), поэтому объект заполняется по мере сборки,
138
+ // а оркестратор получает late-bound геттер (`engine/tools/automation-runtime.ts`).
139
+ const automationRuntime = {
140
+ pipelines: storageContext.projectPipelines,
141
+ runs: storageContext.pipelineRuns,
142
+ runControl: pipelineRunControl,
143
+ templates: pipelineStore,
144
+ schedules: scheduleStore,
145
+ jobs: jobStore,
146
+ };
74
147
  // ADR-030: ядровая шина хуков — общий инстанс для SessionManager и оркестратора.
75
148
  const hooks = new HookBus();
76
- // PROP-102: сборщик роллапов аналитики (write-path) — только через порт слоя
149
+ // ADR-102: сборщик роллапов аналитики (write-path) — только через порт слоя
77
150
  // хранения; в деградации выключен (не пишем домен в файловый фоллбек).
78
151
  const analytics = storageDegraded ? undefined : new AnalyticsRecorder({ repo: analyticsRollups });
79
152
  const sessionManager = new SessionManager(fileStore, {
80
153
  projectStore,
81
154
  hooks,
82
- // PROP-102: точка персиста сообщений (`messages_assistant`/`messages_tool`).
155
+ // ADR-102: точка персиста сообщений (`messages_assistant`/`messages_tool`).
83
156
  analytics,
84
157
  // ADR-071 §2.4 / ADR-046 §4.5: системные дефолты для сессий без проекта.
85
158
  systemDefaultsProvider: async () => ({
@@ -90,7 +163,7 @@ export async function createBackendDeps(config, storage, metrics) {
90
163
  // ADR-089: авто-архивация ephemeral-сессий по TTL (таймер `unref`).
91
164
  // Остановка — через хэндл `stopEphemeralSweeper` на graceful shutdown.
92
165
  const stopEphemeralSweeper = storageDegraded ? () => { } : startEphemeralSweeper(sessionManager);
93
- // PROP-102: шов записи `activity` через hook-шину (ADR-030) + retention суточных
166
+ // ADR-102: шов записи `activity` через hook-шину (ADR-030) + retention суточных
94
167
  // роллапов (prune на старте и каждые 6 ч, таймер `unref`).
95
168
  const detachAnalyticsHooks = analytics
96
169
  ? attachAnalyticsActivityHooks(hooks, {
@@ -137,19 +210,155 @@ export async function createBackendDeps(config, storage, metrics) {
137
210
  const egressLogConfig = config.synth.egress.log;
138
211
  const egressLog = createEgressLogSink(egressRequests, { enabled: () => egressLogConfig.enabled });
139
212
  configureEgressRuntime({ resolver: egressResolver, log: egressLog });
213
+ // ADR-115: живое состояние настроек вложений. Приоритет env > runtime
214
+ // (`settings.json`/PG) > config.yaml > defaults; мутации — админ-API
215
+ // `/api/v2/settings/attachments`. Резолвер синхронный: сервис вложений,
216
+ // промпт и GC читают его на каждый вызов (применение без рестарта).
217
+ const attachmentsSettings = createLiveAttachmentsSettings({
218
+ config: config.synth.attachments,
219
+ runtime: await settingsStore.getAttachments(),
220
+ });
140
221
  const stopEgressLogPruner = storageDegraded || !egressLogConfig.enabled
141
222
  ? () => { }
142
223
  : startEgressLogPruner(egressRequests, { getRetentionDays: () => egressLogConfig.retentionDays });
143
224
  // ADR-071 §2.3.1: политика сетевого доступа HTTP-серверов (SSRF/egress)
144
225
  // резолвится при каждом connect/probe (live; без стартового снимка).
145
226
  mcpManager.setNetworkPolicyResolver(() => egressResolver.resolveMcp());
227
+ // ADR-105 (Ф3): коннекторы с `auth.kind='credential'` авторизуются токеном
228
+ // из слоя доступов (подстановка в транспорт, refresh при 401).
229
+ const oauthProviders = new OAuthProviderRegistry();
230
+ // Каталог OAuth-провайдеров из конфига инстанса (`oauth.providers`): без него
231
+ // refresh живого доступа не работает — провайдера не найти.
232
+ await registerOAuthProvidersFromConfig(oauthProviders, config.synth.oauth.providers, {
233
+ dataDir,
234
+ });
235
+ const oauthCredentialService = new OAuthCredentialService({
236
+ repo: storageContext.externalCredentials,
237
+ clientFor: (provider) => oauthProviders.clientFor(provider),
238
+ // ADR-105 (Ф4): журнал операций со слоем доступов (append-only).
239
+ audit: storageContext.credentialAudit,
240
+ });
241
+ mcpManager.setCredentialSource(createRepositoryCredentialSource({
242
+ repo: storageContext.externalCredentials,
243
+ refresh: async (credentialId) => {
244
+ await oauthCredentialService.refresh(credentialId);
245
+ },
246
+ // ADR-105 (Ф4): подстановка токена в транспорт журналируется (`use`).
247
+ audit: storageContext.credentialAudit,
248
+ }));
146
249
  // Сидирование тестовых пользователей (debug mode) — до построения рантайма
147
250
  // (паритет с прежним `app.ts`: сид стоял между хранилищами и рантаймом).
148
251
  seedDebugTestUsers(profilesStore, config.auth);
149
252
  const eventBus = new EventBus();
150
253
  const queueManager = new QueueProcessorManager();
151
- // PROP-102: пользовательские сообщения персистит процессор — мера `messages_user`.
254
+ // ADR-102: пользовательские сообщения персистит процессор — мера `messages_user`.
152
255
  queueManager.setAnalytics(analytics);
256
+ // Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
257
+ //
258
+ // Паритет с standalone-core: тот же порт записи (ADR-096), тот же срок
259
+ // ожидания ответа из конфигурации `questions.timeoutMs` (`0` — без
260
+ // таймаута). Один инстанс на процесс: его получают и оркестратор (тул
261
+ // `question`), и HTTP-роуты сессий.
262
+ const questionService = storageDegraded
263
+ ? undefined
264
+ : new QuestionService({
265
+ repository: storageContext.questions,
266
+ eventBus,
267
+ timeoutMs: config.synth.questions.timeoutMs,
268
+ });
269
+ // Старт: открытые вопросы прошлого процесса не пережили рестарт (ожидание
270
+ // в памяти) — снимаем их с причиной `interrupted`. Best-effort: ошибка не
271
+ // роняет старт.
272
+ if (questionService) {
273
+ try {
274
+ await questionService.recoverOnStart();
275
+ }
276
+ catch (err) {
277
+ console.warn(`[questions] восстановление открытых вопросов не удалось: ${err instanceof Error ? err.message : String(err)}`);
278
+ }
279
+ }
280
+ // Retention-очистка терминальных записей вопросов (сразу + каждые 6 ч).
281
+ const stopQuestionPruner = storageDegraded
282
+ ? () => { }
283
+ : startQuestionPruner(storageContext.questions, {
284
+ getRetentionDays: () => config.synth.questions.retentionDays,
285
+ });
286
+ // Этап 1 roadmap 0.13 (блок 4): единый реестр фоновых прогонов (PROP-096).
287
+ //
288
+ // Паритет с standalone-core: тот же порт записи (ADR-096), те же лимиты из
289
+ // конфигурации `background.*`. Один инстанс на процесс: его получают тул
290
+ // `task` (фоновый запуск саб-агента) и HTTP-точки обслуживания реестра.
291
+ //
292
+ // Уведомление родителя о завершении фонового прогона (ADR-111): ОДИН путь —
293
+ // постановка в очередь (`enqueueUserMessage`); процессор добавит сообщение в
294
+ // историю сам и опубликует `message.added` (двух копий больше нет).
295
+ // `processMessage` собирается ниже (после оркестратора) — нотификатор
296
+ // создаётся лениво, при первом вызове колбэка (он приходит только из
297
+ // фонового прогона, т.е. уже после старта).
298
+ let backgroundNotifier = null;
299
+ const notifyBackgroundParent = async (sessionId, message) => {
300
+ backgroundNotifier ??= createBackgroundParentNotifier({
301
+ sessionManager,
302
+ eventBus,
303
+ processorManager: queueManager,
304
+ processMessage,
305
+ });
306
+ await backgroundNotifier(sessionId, message);
307
+ };
308
+ const backgroundService = storageDegraded
309
+ ? undefined
310
+ : new BackgroundRunService({
311
+ repository: storageContext.backgroundRuns,
312
+ eventBus,
313
+ limits: {
314
+ maxSubagentsPerSession: config.synth.background.maxSubagentsPerSession,
315
+ // PROP-097: лимит одновременных фоновых шелл-процессов на сессию.
316
+ maxProcessesPerSession: config.synth.background.maxProcessesPerSession,
317
+ maxRunsPerSession: config.synth.background.maxRunsPerSession,
318
+ },
319
+ // Точка сборки уведомления — здесь (глобальных синглтонов нет).
320
+ //
321
+ // ADR-036: обфускация user-сообщений НЕ применяется — уведомление
322
+ // системное (автор `Subagent`/`Process`), а не пользовательский ввод;
323
+ // секреты в исходящих LLM-запросах обфусцирует сам Gateway.
324
+ onNotifyParent: notifyBackgroundParent,
325
+ });
326
+ // Старт: прогоны прошлого процесса не пережили рестарт (хэндлы отмены — в
327
+ // памяти) — помечаем их `orphaned`. Best-effort: ошибка не роняет старт.
328
+ if (backgroundService) {
329
+ try {
330
+ await backgroundService.recoverOnStart();
331
+ }
332
+ catch (err) {
333
+ console.warn(`[background] восстановление фоновых прогонов не удалось: ${err instanceof Error ? err.message : String(err)}`);
334
+ }
335
+ }
336
+ // Retention-очистка терминальных записей реестра (сразу + каждые 6 ч).
337
+ const stopBackgroundRunPruner = storageDegraded
338
+ ? () => { }
339
+ : startBackgroundRunPruner(storageContext.backgroundRuns, {
340
+ getRetentionDays: () => config.synth.background.retentionDays,
341
+ });
342
+ // PROP-097 (блок 5b): retention логов фоновых процессов. Создаётся **до**
343
+ // pruner'а записей реестра: лог удаляется, пока его запись ещё видна.
344
+ const stopProcessLogPruner = storageDegraded
345
+ ? () => { }
346
+ : startProcessLogPruner(storageContext.backgroundRuns, storageContext.blobs, {
347
+ getRetentionDays: () => config.synth.background.retentionDays,
348
+ });
349
+ // ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) — создаются до GC,
350
+ // чтобы счётчик удалённых объектов был доступен при первом прогоне.
351
+ const attachmentMetrics = metrics ? createAttachmentMetrics(metrics) : undefined;
352
+ // ADR-115: GC осиротевших вложений (нет ссылок `blob_refs` + объект старше
353
+ // `attachments.gcDays`; `<= 0` — без ограничения).
354
+ const stopAttachmentPruner = storageDegraded
355
+ ? () => { }
356
+ : startAttachmentPruner({
357
+ blobs: storageContext.blobs,
358
+ blobRefs: storageContext.blobRefs,
359
+ gcDays: () => attachmentsSettings.getConfig().gcDays,
360
+ ...(attachmentMetrics ? { metrics: attachmentMetrics } : {}),
361
+ });
153
362
  // ADR-094: доменные коллекторы. `metrics` приходит только при
154
363
  // `metrics.enabled=true` — иначе реестр остаётся пустым (`/metrics` → 404).
155
364
  // Фоновые таймеры `unref`-ятся; остановка — `stopMetricsCollectors` на
@@ -159,7 +368,13 @@ export async function createBackendDeps(config, storage, metrics) {
159
368
  const schedulerJobMetrics = metrics ? createSchedulerMetrics(metrics) : undefined;
160
369
  const webhookDeliveryMetrics = metrics ? createWebhookMetrics(metrics) : undefined;
161
370
  const eventMetrics = metrics ? createEventMetrics(metrics) : undefined;
371
+ // ADR-106 Ф1: решения Authority-слоя (`synth_authority_decisions_total`) —
372
+ // лейблы только `action`/`effect`/`source`, без id (ADR-094).
373
+ const authorityMetrics = metrics ? createAuthorityMetrics(metrics) : undefined;
162
374
  if (metrics) {
375
+ // ADR-115: сервис вложений собирается внутри фабрики роутов сессий, куда
376
+ // метрики не прокинуть — ставим хуки в sink коллектора (снимается на stop).
377
+ stopMetricsCollectors.push(setAttachmentMetricsHook(attachmentMetrics ?? null));
163
378
  stopMetricsCollectors.push(attachBusMetrics(metrics, eventBus));
164
379
  stopMetricsCollectors.push(startSessionMetrics(metrics, sessionManager));
165
380
  stopMetricsCollectors.push(startStorageMetrics(metrics, {
@@ -179,7 +394,16 @@ export async function createBackendDeps(config, storage, metrics) {
179
394
  stopMetricsCollectors.push(registerDecisionMetrics(metrics));
180
395
  // ADR-094: размер журнала внешних событий (фон, раз в 5 минут).
181
396
  stopMetricsCollectors.push(startEventJournalMetrics(metrics, eventJournal));
397
+ // ADR-094/PROP-047: метрики памяти (`synth_memory_*`) — пересчёт на скрейпе.
398
+ stopMetricsCollectors.push(startMemoryMetrics(metrics, {
399
+ facts: storageContext.memoryFacts,
400
+ indexes: storageContext.memoryIndexes,
401
+ }));
182
402
  }
403
+ // ADR-107: телеметрия памяти — блоки памяти в промпте хода и recall-запросы
404
+ // плагина памяти. Метрики выключены — телеметрии нет (плагин и ход работают
405
+ // как раньше).
406
+ const memoryTelemetry = metrics ? createMemoryTelemetry(metrics) : undefined;
183
407
  // ADR-052 (этап II): исходящие webhooks — реестр подписок (signing-секрет
184
408
  // `whsec_…` шифруется at-rest мастер-ключом), append-only журнал доставок и
185
409
  // движок над той же шиной `EventBus`, что обслуживает сессии/SSE. Движок
@@ -221,7 +445,7 @@ export async function createBackendDeps(config, storage, metrics) {
221
445
  // ADR-038: синхронизация провайдеров/моделей из переменных окружения (общая
222
446
  // core-реализация). Вызывается ПОСЛЕ создания providerStore/modelStore, но ДО
223
447
  // заполнения кэшей, чтобы env-провайдеры попали в providerCache/modelCache.
224
- // PROP-032 (W5): в деградации не пишем в фоллбек.
448
+ // ADR-098 (W5): в деградации не пишем в фоллбек.
225
449
  if (!storageDegraded)
226
450
  await syncProvidersFromEnv(providerStore, modelStore);
227
451
  // Кеш провайдеров (заполняется при старте)
@@ -311,9 +535,28 @@ export async function createBackendDeps(config, storage, metrics) {
311
535
  // Orchestrator
312
536
  const toolRegistry = createToolRegistry();
313
537
  const agentRegistry = createAgentRegistry(toolRegistry, join(dataDir, 'agents'));
538
+ // ADR-090 (Ф3а): **один** реестр провайдеров блоков
539
+ // системного промпта на инстанс — композер добавляет блоки в промпт сессии,
540
+ // фасад плагинов (`PluginRuntime` → `PluginHost`) их регистрирует.
541
+ const promptBlocks = new PromptBlockRegistry();
542
+ // ADR-096 + ADR-086 §5: агенты из **стора** — в реестр при старте.
543
+ // `createAgentRegistry` читает только файловый каталог `{dataDir}/agents`,
544
+ // а при `storage.backend=postgres` стор агентов — это БД: агент, поставленный
545
+ // пакетом расширения, после рестарта не попадал в реестр → Router не
546
+ // резолвил `agentTemplate` (`resolveAgentTemplate` → `null`) и сессия не
547
+ // создавалась. Merge — как в `GET /api/v2/agents` (override выигрывает).
548
+ try {
549
+ registerStoredAgents(agentRegistry, await agentStore.list());
550
+ }
551
+ catch (err) {
552
+ console.warn(`[agents] не удалось загрузить агентов из стора: ${err instanceof Error ? err.message : String(err)}`);
553
+ }
314
554
  // ADR-046: сервис скиллов (discovery + instance-запись + каталог промпта).
555
+ // ADR-116: instance-скиллы — порт слоя хранения (`storageContext.skills`):
556
+ // при `storage.backend=postgres` это метаданные в SQL + содержимое в blobs.
315
557
  const skillService = new SkillService({
316
558
  dataDir,
559
+ store: storageContext.skills,
317
560
  configPaths: config.synth.skills.paths,
318
561
  urls: config.synth.skills.urls,
319
562
  trustedProjectDirs: config.synth.skills.trustedProjectDirs,
@@ -336,11 +579,147 @@ export async function createBackendDeps(config, storage, metrics) {
336
579
  skillSource: skillService,
337
580
  bundleStore,
338
581
  });
582
+ // ADR-077: порт исполнения команд. Режим (`inline`/`remote`) — параметр
583
+ // запуска процесса (инвариант 24), поэтому порт собирается здесь, при старте.
584
+ // Тот же порт получают оркестратор (тулы, inline-shell, детект зависимостей)
585
+ // и резолвер проектных инструкций.
586
+ const execution = executionConfig ?? resolveExecutionConfig(config.synth, process.env);
587
+ // ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`) — приёмник
588
+ // для клиента удалённого порта (очередь, занятость, ожидание, исход).
589
+ const executorMetrics = metrics ? createExecutorMetricsCollector(metrics) : undefined;
590
+ const executionPort = await createExecutionPortForConfig(execution, executorMetrics ? { metricsSink: executorMetrics } : undefined);
591
+ // PROP-097 (блок 5b): сервис фоновых шелл-процессов (паритет с standalone).
592
+ //
593
+ // Тот же порт исполнения, что у тулов (ADR-077): фон — это лишь способ
594
+ // ожидания, а не отдельный путь исполнения. Учёт прогона — общий реестр
595
+ // фоновых прогонов (`kind: 'process'`), лог — blob-хранилище (ADR-096).
596
+ // В деградированном режиме хранилища сервиса нет (писать некуда).
597
+ const processService = backgroundService
598
+ ? new ProcessService({
599
+ executionPort,
600
+ background: backgroundService,
601
+ blobs: storageContext.blobs,
602
+ eventBus,
603
+ limits: { maxLogBytes: config.synth.background.logMaxBytes },
604
+ })
605
+ : undefined;
606
+ // ADR-114: сервис worktree'ов (per-session рабочий каталог).
607
+ //
608
+ // Один инстанс на процесс: его получают HTTP-роуты проектов
609
+ // (`/projects/:id/worktrees*`), тулы `git_worktree_*` и привязка сессии
610
+ // (`PATCH /sessions/:id { worktreeId }`). Порт инвентаря — из контекста
611
+ // хранения (ADR-096); git-команды — через порт исполнения (ADR-077);
612
+ // `onUpdated` публикует `worktree.updated` в каналы сессий проекта
613
+ // (ADR-114 §6, ADR-024). В деградированном режиме хранилища сервиса нет
614
+ // (писать некуда — split-brain).
615
+ const worktreeService = storageDegraded
616
+ ? undefined
617
+ : new WorktreeService({
618
+ repository: storageContext.worktrees,
619
+ workspacesRoot: config.workspacesRoot,
620
+ execution: executionPort,
621
+ defaultWorkingDir,
622
+ // Привязанная живая сессия — по полю `session.worktree` (ADR-114 §1.3).
623
+ resolveAttachedSession: async (worktreeId) => {
624
+ const sessions = await sessionManager.listSessions(undefined, { light: true });
625
+ return sessions.find((s) => s.worktree?.worktreeId === worktreeId)?.id;
626
+ },
627
+ onUpdated: (projectId, detail) => {
628
+ void publishWorktreeUpdated({ eventBus, sessionStore: sessionManager }, {
629
+ projectId,
630
+ ...(detail.worktreeId !== undefined ? { worktreeId: detail.worktreeId } : {}),
631
+ action: detail.action,
632
+ });
633
+ },
634
+ });
635
+ // ADR-114 §7.4: sweep осиротевших записей worktree'ов при старте процесса
636
+ // (записи без каталога — их чистит и prune проекта, §7.3). Фоново: старт
637
+ // **не блокируется**, ошибка — в лог, процесс продолжает жить. В деградированном
638
+ // режиме хранилища сервиса нет — вычищать нечего.
639
+ if (worktreeService)
640
+ startWorktreeSweeper(worktreeService);
641
+ // ADR-070 §2.9.1/ADR-101: зависимости окружения (git/rg/sh) — детекция при
642
+ // старте, fail-open при ошибке. Общий для оркестратора и движка пайплайнов
643
+ // (контекст шага, ADR-101 §10).
644
+ //
645
+ // ADR-077: проба бинарников идёт **через порт исполнения** — в split-режиме
646
+ // они ищутся в окружении исполнителя. Порт передаётся здесь: кэш детекции
647
+ // модульный, порт берётся из первого вызова (fail-closed в remote-режиме).
648
+ const runtimeDeps = await detectRuntimeDeps(executionPort);
649
+ // ADR-106 Ф1/Ф2: Authority-слой. Решение считается и пишется в журнал
650
+ // (`{dataDir}/audit/authority.jsonl` через порт). При `authority.enabled`
651
+ // **без** `authority.shadow` решение **применяется** (Ф2): `deny`/`ask`
652
+ // сужают решение permission-слоя. Секция `authority` выключена по умолчанию:
653
+ // слой считает решения только когда его явно включили.
654
+ const authorityPolicy = (await storageContext.authorityPolicy?.getPolicy()) ?? null;
655
+ const authorityGuard = config.synth.authority?.enabled
656
+ ? new AuthorityGuard({
657
+ enabled: true,
658
+ shadow: config.synth.authority.shadow,
659
+ journal: storageContext.authorityDecisions,
660
+ policy: authorityPolicy,
661
+ // ADR-094: счётчик решений Authority-слоя (`synth_authority_decisions_total`).
662
+ onDecision: authorityMetrics?.onDecision,
663
+ })
664
+ : undefined;
665
+ // ADR-106 Ф3: реестр подтверждений. Задаётся **только** в enforced-режиме
666
+ // (слой Authority применяет решения): ответ на `permission_reply` принимает
667
+ // лишь носитель покрывающего гранта — не «кто видит сессию» (дыра
668
+ // «`VIEWER` подтверждает мутирующий тул»).
669
+ const approvalRegistry = authorityGuard?.enforced
670
+ ? new ApprovalRegistry({
671
+ coverage: createApprovalCoverageResolver({
672
+ policy: authorityPolicy,
673
+ profile: async (sessionId, principal) => {
674
+ const session = await sessionManager.getSession(sessionId);
675
+ const project = session?.projectId
676
+ ? await projectStore.load(session.projectId)
677
+ : null;
678
+ return buildApprovalResponderProfile({
679
+ principal,
680
+ sources: { session, project },
681
+ });
682
+ },
683
+ }),
684
+ })
685
+ : undefined;
686
+ /**
687
+ * ADR-115: модальности модели — только из её конфига (каталог провайдера при
688
+ * синхронизации моделей либо ручной override). Справочника модальностей в
689
+ * ядре нет (решение 2026-10-27): не нашли — `undefined`, и гидратация
690
+ * вложений их не фильтрует (ошибку модальности вернёт провайдер).
691
+ *
692
+ * Один резолвер на инстанс: тот же нужен шагам пайплайна (ADR-115 × ADR-101),
693
+ * иначе сессии и прогоны разошлись бы по фильтру модальностей.
694
+ */
695
+ const resolveModelModalities = (providerName, modelId) => {
696
+ const direct = modelCache.get(`${providerName}/${modelId}`) ?? modelCache.get(modelId);
697
+ if (direct?.modalities?.length)
698
+ return direct.modalities;
699
+ let prefixMatch;
700
+ for (const model of modelCache.values()) {
701
+ if (model.provider !== providerName || !model.modalities?.length)
702
+ continue;
703
+ if (model.name === modelId)
704
+ return model.modalities;
705
+ // В сессии имя может нести суффикс (например, `-1017`).
706
+ if (!prefixMatch && modelId.startsWith(model.name))
707
+ prefixMatch = model.modalities;
708
+ }
709
+ return prefixMatch;
710
+ };
339
711
  const orchestrator = new ChatOrchestrator({
340
712
  sessionManager,
341
713
  eventBus,
342
714
  hooks,
343
- // PROP-102: сборщик `usage`/`decision` роллапов (write-path).
715
+ // ADR-106 Ф1/Ф2: шов решения Authority-слоя (считает, журналит и —
716
+ // в enforced-режиме — применяет решение).
717
+ authorityGate: authorityGuard?.gate,
718
+ // ADR-106 Ф3: реестр подтверждений (привязка к ходу + носитель гранта).
719
+ ...(approvalRegistry ? { approvalRegistry } : {}),
720
+ // ADR-077: порт исполнения команд (inline — исполнение в процессе).
721
+ executionPort,
722
+ // ADR-102: сборщик `usage`/`decision` роллапов (write-path).
344
723
  analytics,
345
724
  contextBuilder,
346
725
  contextConfig,
@@ -350,14 +729,33 @@ export async function createBackendDeps(config, storage, metrics) {
350
729
  dataDir,
351
730
  toolRegistry,
352
731
  agentRegistry,
732
+ // ADR-090: тот же реестр, что у фасада плагинов
733
+ // (ниже, `PluginRuntime`) — блоки плагинов попадают в промпт сессии.
734
+ promptBlocks,
353
735
  mcpManager,
354
736
  projectStore,
355
737
  // Онбординг: тул `profile_update` сохраняет ответы интервью в профиль.
356
738
  profilesStore,
357
739
  // ADR-076 §T6: тот же store, что у git/ssh-роутов — без дублей инстансов.
358
740
  sshKeyStore,
359
- // PROP-032 (W2.4): словари классификации — порт из контекста хранения.
741
+ // ADR-096 (W2.4): словари классификации — порт из контекста хранения.
360
742
  dictionaryStore,
743
+ // ADR-115/ADR-116: blob-порт гидратации вложений — из контекста хранения
744
+ // (managed: тот же корень, что у раздачи/записи blob'ов).
745
+ blobs: storageContext.blobs,
746
+ // ADR-115: модальности модели — из её конфига (общий резолвер инстанса,
747
+ // выше: им же пользуются шаги пайплайнов).
748
+ resolveModelModalities,
749
+ // ADR-115: `attachments.workspaceFallback` — материализация отброшенных
750
+ // вложений в workspace; live-конфиг (проверяется на каждый ход).
751
+ attachmentsConfig: () => attachmentsSettings.getConfig(),
752
+ // ADR-115: каталог моделей инстанса для агента (тул `list_models`):
753
+ // тот же `modelStore`, что у `GET /api/v2/models` (каталог провайдеров +
754
+ // ручные override), поэтому модальности совпадают с UI.
755
+ listModels: () => modelStore.list(),
756
+ // ADR-115: порт ссылок на blob-объекты — для инъекции вложений тулов
757
+ // (`ToolResult.attachments`, включая `attach_workspace_file`).
758
+ blobRefs: storageContext.blobRefs,
361
759
  workspacesRoot: config.workspacesRoot,
362
760
  // ADR-075: backend — managed-режим, workspace вне workspacesRoot запрещён.
363
761
  workspaceManaged: true,
@@ -374,9 +772,15 @@ export async function createBackendDeps(config, storage, metrics) {
374
772
  gatewayAuditLogger,
375
773
  gatewayPayloadLogPath,
376
774
  gatewayPatternStore: patternStore,
775
+ // ADR-090: бюджет времени фильтров LLM-вызовов
776
+ // (`plugins.llmFilterTimeoutMs`); реестр — `orchestrator.getLlmFilters()`.
777
+ llmFilterTimeoutMs: config.synth.plugins?.llmFilterTimeoutMs,
377
778
  // ADR-094: реестр метрик (только при `metrics.enabled`) — LLM-вызовы
378
779
  // сессий учитываются и при выключенном LLM Gateway.
379
780
  metrics,
781
+ // ADR-107: телеметрия блоков памяти в промпте хода
782
+ // (`synth_memory_context_*`).
783
+ ...(memoryTelemetry ? { onMemoryContext: memoryTelemetry.recordContext } : {}),
380
784
  cachePolicy: config.synth.llm.cache,
381
785
  toolsPolicy,
382
786
  mcpPolicy,
@@ -384,7 +788,8 @@ export async function createBackendDeps(config, storage, metrics) {
384
788
  // ADR-046 §4.5: системный hard-gate скиллов (runtime-настройка).
385
789
  skillsDisabled,
386
790
  // ADR-070 §2.9.1: зависимости окружения (git/rg/sh) — детекция при старте.
387
- runtimeDeps: await detectRuntimeDeps(),
791
+ // Проба бинарников — через тот же порт исполнения (ADR-077).
792
+ runtimeDeps: await detectRuntimeDeps(executionPort),
388
793
  // ADR-071 §2.6: калибровка chars-per-token по модели (runtime-настройки).
389
794
  tokenRatioLoader: (model) => settingsStore.getTokenRatio(model),
390
795
  onTokenRatioCalibrated: (model, ratio) => settingsStore.setTokenRatio(model, ratio),
@@ -402,9 +807,101 @@ export async function createBackendDeps(config, storage, metrics) {
402
807
  // ADR-051: late-bound резолвер активности расписания в сессии (ScheduleStore
403
808
  // создаётся ниже) — включает статический блок `Scheduler` в промпт.
404
809
  isSchedulerActive: (sid) => scheduleStore.hasEnabledTargetFor(sid),
810
+ // ADR-101/ADR-051: late-bound рантайм автоматизации для встроенных тулов
811
+ // (`pipeline_*`/`schedule_*`) — движок пайплайнов и шедулер создаются ниже,
812
+ // поэтому геттер отдаёт актуальный снимок в момент хода.
813
+ getAutomationRuntime: () => automationRuntime,
405
814
  // «Стоп»: персистентный флаг отмены сессии — прерывает длинный
406
815
  // многоитерационный Tool Use на границе итерации (backoff/гонка).
407
816
  isCancelRequested: async (sid) => (await sessionManager.getSession(sid))?.status.cancelRequested === true,
817
+ // Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» — тул
818
+ // `question` задаёт вопрос и ждёт ответа пользователя.
819
+ ...(questionService ? { questionService } : {}),
820
+ // Этап 1 roadmap 0.13 (блок 4): единый реестр фоновых прогонов — тул
821
+ // `task` с `background: true` регистрирует фонового саб-агента и
822
+ // возвращает управление сразу (PROP-096).
823
+ ...(backgroundService ? { backgroundService } : {}),
824
+ // PROP-097: сервис фоновых шелл-процессов — тот же экземпляр, что у
825
+ // реестра и тула `execute_shell` (через `ctx.extra.processService`).
826
+ ...(processService ? { processService } : {}),
827
+ // ADR-114: сервис worktree'ов — тулы `git_worktree_*` (инвентарь
828
+ // per-session рабочих каталогов проекта).
829
+ ...(worktreeService ? { worktreeService } : {}),
830
+ backgroundEnabled: config.synth.background.enabled,
831
+ });
832
+ // ADR-090 (Ф5б-2): эффективный конфиг слоя = config.yaml (+env) поверх
833
+ // runtime-настроек (`settings.json`/PG): админка `/api/v2/settings/plugins`
834
+ // пишет runtime, рантайм собирается при старте (применение — рестартом,
835
+ // инвариант 24), поэтому слияние делается **здесь**, а не в рантайме.
836
+ const effectivePluginsConfig = mergePluginsConfig(config.synth.plugins, await settingsStore.getPlugins());
837
+ // ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
838
+ // (`plugins.lock.json` — источник истины), список со статусом активации и
839
+ // точки `activate`/`deactivate` для HTTP API/CLI (Ф5б-2/3). Реестры — **те же**
840
+ // экземпляры, что у оркестратора (`promptBlocks`, `getLlmFilters()`, `toolRegistry`).
841
+ // `plugins.executionEnabled=false` (дефолт) → `activateInstalled()` — no-op.
842
+ // Ф4б-2: транспорты исполнения плагина (`inline` — в процессе core,
843
+ // `remote` — отдельный процесс на loopback). Менеджер процессов гасится в
844
+ // `PluginRuntime.dispose()` при остановке инстанса.
845
+ const pluginProcessManager = new PluginProcessManager({
846
+ secretsDir: join(dataDir, 'secrets'),
847
+ logger: { warn: (message) => console.warn(`[plugin-process] ${message}`) },
848
+ });
849
+ // ADR-090 (WP-F): сервис эмбеддингов фасада (`facade.embed`).
850
+ //
851
+ // Эмбеддинги плагина идут **тем же** путём, что и остальные LLM-вызовы:
852
+ // провайдер создаётся `ProviderFactory`, оборачивается в `GatewayProvider`
853
+ // (`orchestrator.wrapProviderWithGateway`) — значит, работают guard'ы,
854
+ // обфускация, rate-limit, аудит и embedding-фаза фильтров `llmFilters`
855
+ // (инвариант 3, ADR-036). Плагин провайдера напрямую не достаёт.
856
+ //
857
+ // Провайдер/модель приходят из фасада: конфиг инстанса
858
+ // (`plugins.embeddingProvider`/`plugins.embeddingModel`) с перекрытием
859
+ // аргументом вызова. `GatewayProvider.embed` принимает **одну** строку —
860
+ // батча в v1 нет, поэтому цикл по текстам.
861
+ const pluginEmbed = async (texts, opts) => {
862
+ const providerName = opts?.provider?.trim() ?? '';
863
+ if (!providerName) {
864
+ throw new PluginFacadeError('plugin.embedding_not_configured', 'Эмбеддинги не сконфигурированы: задайте plugins.embeddingProvider ' +
865
+ '(или передайте провайдера в вызове facade.embed).');
866
+ }
867
+ const sharedConfig = providerLoader(providerName);
868
+ if (!sharedConfig) {
869
+ throw new PluginFacadeError('plugin.embedding_not_configured', `Провайдер «${providerName}» не найден в инстансе — эмбеддинги недоступны.`);
870
+ }
871
+ const model = opts?.model?.trim() || sharedConfig.defaultModel || '';
872
+ const provider = orchestrator.wrapProviderWithGateway(ProviderFactory.create(providerName, toCoreProviderConfig(sharedConfig, model)));
873
+ const vectors = [];
874
+ for (const text of texts) {
875
+ vectors.push(await provider.embed(text));
876
+ }
877
+ return vectors;
878
+ };
879
+ const pluginRuntime = new PluginRuntime({
880
+ layout: resolvePluginLayout({ dataDir, env: process.env }),
881
+ config: effectivePluginsConfig,
882
+ hostVersion: SYNTH_VERSION,
883
+ audit: storageContext.pluginAudit,
884
+ lock: storageContext.pluginLock,
885
+ promptBlocks,
886
+ llmFilters: orchestrator.getLlmFilters(),
887
+ tools: toolRegistry,
888
+ // PROP-047 §2.1: порты памяти инстанса — фасад плагина отдаёт **scoped**
889
+ // доступ (namespace навязывает хост). Порты обязательны в
890
+ // `StorageContext`, поэтому сервис доступен всегда.
891
+ memory: {
892
+ memoryFacts: storageContext.memoryFacts,
893
+ memoryIndexes: storageContext.memoryIndexes,
894
+ },
895
+ loaders: {
896
+ inline: createInlinePluginLoader(),
897
+ remote: createRemotePluginLoader({ processManager: pluginProcessManager }),
898
+ },
899
+ processManager: pluginProcessManager,
900
+ // ADR-090 (WP-F): сервис эмбеддингов фасада — через Gateway (инвариант 3).
901
+ embed: pluginEmbed,
902
+ // ADR-107: телеметрия recall/search-запросов памяти
903
+ // (`synth_memory_recall_*`).
904
+ ...(memoryTelemetry ? { memoryTelemetry: memoryTelemetry.recordRecall } : {}),
408
905
  });
409
906
  const processMessage = orchestrator.createProcessMessage();
410
907
  // ADR-089: ядро маршрутизации внешних событий и единый funnel создания сессий.
@@ -457,7 +954,7 @@ export async function createBackendDeps(config, storage, metrics) {
457
954
  displayName: agent.displayName,
458
955
  description: agent.description,
459
956
  })),
460
- // PROP-102: персистентные decision-метрики (ось provider/model).
957
+ // ADR-102: персистентные decision-метрики (ось provider/model).
461
958
  analytics,
462
959
  }));
463
960
  // ADR-089: резолвинг `agentTemplate` (события/правила) через `AgentRegistry`:
@@ -479,6 +976,22 @@ export async function createBackendDeps(config, storage, metrics) {
479
976
  profiles: profilesStore,
480
977
  getIdentityMap: () => effectiveEventsSettings.identityMap,
481
978
  });
979
+ // ADR-089/ADR-051: учёт экземпляров пайплайна (ADR-100) — состояние
980
+ // автомата публикации живёт в ядре (решение владельца), add-on отдаёт
981
+ // артефакт по id. Трекер работает через порт `storage.pipelines`.
982
+ const pipelineTracker = new PipelineTracker({ repository: pipelineStore });
983
+ // ADR-089: дефолтные `provider`/`model` инстанса — общий seam для funnel'а
984
+ // сессий и движка пайплайнов (ADR-101): приоритет — runtime-пара «Модели»
985
+ // (provider+model), затем config.yaml (llm.defaultProvider/defaultModel).
986
+ const resolveLlmDefaults = async () => {
987
+ const pair = await settingsStore.getDefaultModel();
988
+ if (pair)
989
+ return { provider: pair.provider, model: pair.model };
990
+ return {
991
+ provider: config.synth.llm.defaultProvider,
992
+ model: config.synth.llm.defaultModel,
993
+ };
994
+ };
482
995
  const requestSessionService = new RequestSessionService({
483
996
  sessionManager,
484
997
  eventRouter,
@@ -526,20 +1039,15 @@ export async function createBackendDeps(config, storage, metrics) {
526
1039
  // — для сессий из внешних событий (materialize ephemeral/bind), чтобы агент
527
1040
  // мог ответить без ручной простановки модели. Приоритет: runtime-пара
528
1041
  // «Модели» (provider+model), затем config.
529
- resolveLlmDefaults: async () => {
530
- const pair = await settingsStore.getDefaultModel();
531
- if (pair)
532
- return { provider: pair.provider, model: pair.model };
533
- return {
534
- provider: config.synth.llm.defaultProvider,
535
- model: config.synth.llm.defaultModel,
536
- };
537
- },
1042
+ resolveLlmDefaults,
538
1043
  // ADR-089: агент по умолчанию инстанса — чтобы сессия из внешнего события
539
1044
  // (auto-bind/bind/ephemeral) фиксировала `settings.agentRole` и UI рисовал
540
1045
  // бейдж агента (паритет с `POST /api/v2/sessions`). Источник — админка
541
1046
  // «Агенты» (`getDefaultAgentId`) поверх `DEFAULT_AGENT_ID`.
542
1047
  resolveDefaultAgent: getDefaultAgentId,
1048
+ // ADR-089/ADR-051: учёт экземпляров пайплайна (ADR-100) — решение с
1049
+ // `pipeline: {id, step}` продвигает автомат пайплайна; учёт best-effort.
1050
+ pipelineTracker,
543
1051
  // ADR-089: UI-событие после материализации внешнего события.
544
1052
  publish: (type, sessionId, data) => eventBus.publish(sessionId, type, data),
545
1053
  deliver: async (sessionId, event, mode, context) => {
@@ -569,23 +1077,183 @@ export async function createBackendDeps(config, storage, metrics) {
569
1077
  if (mode === 'run') {
570
1078
  // ADR-036: обфускация user-сообщения ДО сохранения в историю (паритет с
571
1079
  // prompt-путём — core routes/sessions.ts).
572
- await enqueueUserMessage(sessionManager, eventBus, sessionId, message, queueManager, processMessage, (sid, msg) => orchestrator.obfuscateUserMessageForHistory(sid, msg));
1080
+ const queued = await enqueueUserMessage(sessionManager, eventBus, sessionId, message, queueManager, processMessage, (sid, msg) => orchestrator.obfuscateUserMessageForHistory(sid, msg));
1081
+ // ADR-115 × ADR-089: ссылки на вложения события — только после успешной
1082
+ // постановки (иначе GC удалит объект, на который сообщение не ссылается).
1083
+ if (queued) {
1084
+ await addEventAttachmentRefs(storageContext.blobRefs, event, message.id);
1085
+ }
573
1086
  }
574
1087
  else {
575
1088
  // ADR-036: `defer` тоже кладёт сообщение в историю — обфусцируем до
576
1089
  // постановки. Старт процессора не выполняем (только очередь владельца).
577
1090
  message = await orchestrator.obfuscateUserMessageForHistory(sessionId, message);
578
- await sessionManager.addPendingMessage(sessionId, message);
1091
+ const queued = await sessionManager.addPendingMessage(sessionId, message);
1092
+ if (queued) {
1093
+ await addEventAttachmentRefs(storageContext.blobRefs, event, message.id);
1094
+ }
579
1095
  }
580
1096
  },
581
1097
  });
582
1098
  // ADR-089: ingress-точка приёма внешних событий (Этап 6).
583
- const eventIngress = new EventIngress({ requestSessionService, metrics: eventMetrics });
1099
+ // ADR-115 × ADR-089: сервис вложений проверяет ссылки `attachments[]` события
1100
+ // (объект есть, метаданные совпадают со sidecar) и даёт лимиты
1101
+ // `attachments.maxFilesPerMessage`/`maxBytesPerFile` (runtime-настройки — живые).
1102
+ const eventAttachmentService = new AttachmentService({
1103
+ blobs: storageContext.blobs,
1104
+ config: () => attachmentsSettings.getConfig(),
1105
+ });
1106
+ const eventIngress = new EventIngress({
1107
+ requestSessionService,
1108
+ metrics: eventMetrics,
1109
+ attachments: eventAttachmentService,
1110
+ });
1111
+ // ADR-101 (Э5): движок пайплайнов — второй движок рядом с оркестратором
1112
+ // (ADR-101 §1). Собирается в точке сборки (никаких глобальных синглтонов):
1113
+ // шаг пайплайна не сессия, но окружение то же — порты хранилища (ADR-096),
1114
+ // permission-слой (ADR-029), промпт (ADR-070), Gateway (ADR-036).
1115
+ //
1116
+ // HTTP-роутов у движка нет (Э6): он живёт в `deps` и используется
1117
+ // вызывающим кодом (запуск прогона/возобновление — Э6).
1118
+ const pipelinePermissions = {
1119
+ permissionConfig: config.synth.permission,
1120
+ runtimeDeps,
1121
+ };
1122
+ // ADR-036/ADR-101: провайдер шага — **всегда** через `GatewayProvider`
1123
+ // (обёртка оркестратора: та же точка, что у пула провайдеров). Провайдер
1124
+ // не кэшируется — обёртка подхватывает live-конфиг LLM Gateway.
1125
+ const resolvePipelineProvider = async () => {
1126
+ try {
1127
+ const defaults = await resolveLlmDefaults();
1128
+ const providerName = defaults.provider?.trim();
1129
+ if (!providerName)
1130
+ return null;
1131
+ const sharedConfig = providerLoader(providerName);
1132
+ if (!sharedConfig)
1133
+ return null;
1134
+ const coreConfig = toCoreProviderConfig(sharedConfig, defaults.model?.trim() || sharedConfig.defaultModel || '');
1135
+ return orchestrator.wrapProviderWithGateway(ProviderFactory.create(providerName, coreConfig));
1136
+ }
1137
+ catch {
1138
+ // Провайдер не собран — шаг упадёт с `pipeline.provider_not_found`.
1139
+ return null;
1140
+ }
1141
+ };
1142
+ // ADR-101 §9 / ADR-116: артефакты прогонов — байты в общем blob-порте
1143
+ // (отдельного хранилища артефактов нет). Тот же инстанс получают выход `file`
1144
+ // (запись) и HTTP-раздача артефактов прогона (`GET
1145
+ // /pipeline-runs/:runId/artifacts/:name`), иначе route отдавал бы 404.
1146
+ const pipelineArtifacts = new PipelineArtifactStore({
1147
+ blobs: storageContext.blobs,
1148
+ blobRefs: storageContext.blobRefs,
1149
+ });
1150
+ const pipelineEngine = new PipelineEngine({
1151
+ // ADR-096: порты спецификаций пайплайнов и прогонов — из контекста хранения.
1152
+ pipelines: storageContext.projectPipelines,
1153
+ runs: storageContext.pipelineRuns,
1154
+ // ADR-101 §4: исполнители видов шага (tool/script/human/agent).
1155
+ executors: [
1156
+ createToolStepExecutor({ toolRegistry, permissions: pipelinePermissions }),
1157
+ createScriptStepExecutor({ toolRegistry, permissions: pipelinePermissions }),
1158
+ createHumanStepExecutor(),
1159
+ createAgentStepExecutor({ toolRegistry, permissions: pipelinePermissions }),
1160
+ ],
1161
+ // ADR-101 §9: выходы пайплайна — сессия/файл/шлюз/none.
1162
+ exits: [
1163
+ createPipelineExitHandler({
1164
+ sessionManager,
1165
+ projectStore,
1166
+ eventBus,
1167
+ ingress: eventIngress,
1168
+ // ADR-116: выход `file` дополнительно кладёт байты в blob-порт —
1169
+ // артефакт прогона переживает очистку workspace.
1170
+ artifacts: pipelineArtifacts,
1171
+ workspacesRoot: config.workspacesRoot,
1172
+ resolveLlmDefaults,
1173
+ // ADR-089: владелец сессии, созданной выходом, — владелец проекта
1174
+ // прогона (резолвится в обработчике выхода). Без проекта владельца нет:
1175
+ // сессия инстансная (видима ADMIN/LEAD) — права уточняются в Э6.
1176
+ onSessionMaterialized: (session) => {
1177
+ const owner = session.ownerId || session.userId;
1178
+ if (!owner)
1179
+ return;
1180
+ void eventHub.subscribeToSession(owner, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
1181
+ },
1182
+ }),
1183
+ ],
1184
+ // ADR-101 §2.12: инстансные события прогона (новая шина не заводится).
1185
+ eventBus,
1186
+ // ADR-094: метрики прогонов (`synth_pipeline_*`).
1187
+ metrics: metrics ? createPipelineMetrics(metrics) : undefined,
1188
+ // ADR-101 §4/ADR-070: промпт шага — тем же сборщиком, что у сессий.
1189
+ composer: orchestrator.getComposer(),
1190
+ resolveProvider: resolvePipelineProvider,
1191
+ resolveLlmDefaults,
1192
+ // ADR-115 × ADR-101: вложения прогона — тот же сервис вложений, что у
1193
+ // приёма событий (чтение `attachments/…`, sidecar-метаданные, лимиты) и
1194
+ // тот же blob-порт артефактов, что у HTTP-раздачи (`artifacts/…`).
1195
+ attachments: eventAttachmentService,
1196
+ artifacts: pipelineArtifacts,
1197
+ resolveModalities: resolveModelModalities,
1198
+ deriveAttachment: createPipelineAttachmentDerive({
1199
+ config: () => attachmentsSettings.getConfig(),
1200
+ attachments: eventAttachmentService,
1201
+ blobs: storageContext.blobs,
1202
+ // Инвариант 3: LLM-вызов только через gateway — провайдер aux-модели
1203
+ // обёрнут той же обвязкой, что и провайдер шага.
1204
+ resolveProvider: async (provider, model) => {
1205
+ try {
1206
+ const sharedConfig = providerLoader(provider);
1207
+ if (!sharedConfig)
1208
+ return null;
1209
+ return orchestrator.wrapProviderWithGateway(ProviderFactory.create(provider, toCoreProviderConfig(sharedConfig, model)));
1210
+ }
1211
+ catch {
1212
+ return null;
1213
+ }
1214
+ },
1215
+ hasFfmpeg: () => isFfmpegAvailable(executionPort).catch(() => false),
1216
+ promptTemplate: (language) => contextConfig.getMediaDeriveTemplate(language),
1217
+ language: 'ru',
1218
+ log: (message) => console.warn(message),
1219
+ }),
1220
+ attachmentsNoticeTemplate: (language) => contextConfig.getAttachmentsDroppedTemplate(language),
1221
+ // ADR-101 §10: контекст шага — те же объекты, что собраны для сессий.
1222
+ projectStore,
1223
+ toolRegistry,
1224
+ mcpManager,
1225
+ instructionsResolver: orchestrator.getInstructionsResolver(),
1226
+ agentRegistry,
1227
+ skillsCatalog: skillService,
1228
+ runtimeDeps,
1229
+ workspacesRoot: config.workspacesRoot,
1230
+ });
1231
+ // ADR-101/ADR-051: движок пайплайнов появился — отдаём его тулам
1232
+ // `pipeline_*` через рантайм автоматизации (late-bound).
1233
+ automationRuntime.engine = pipelineEngine;
1234
+ // ADR-101: встроенные шаблоны пайплайнов инстанса (сид при старте).
1235
+ // Идемпотентно: существующий шаблон не перезаписывается. Ошибка сидирования
1236
+ // **не** роняет старт — только предупреждение в лог. В деградированном
1237
+ // режиме (ADR-098) хранилище read-only — запись не выполняется вовсе.
1238
+ if (!storageDegraded) {
1239
+ try {
1240
+ await ensureBuiltinPipelines({
1241
+ pipelines: storageContext.projectPipelines,
1242
+ logger: {
1243
+ info: (message) => console.log(message),
1244
+ warn: (message) => console.warn(message),
1245
+ },
1246
+ });
1247
+ }
1248
+ catch (err) {
1249
+ console.warn(`[pipelines] не удалось засеять встроенные шаблоны: ${err instanceof Error ? err.message : String(err)}`);
1250
+ }
1251
+ }
584
1252
  // ADR-051 (срез) / ADR-089: планировщик публикует cron-события через ingress.
585
1253
  // `start()` гейтится конфигом (`scheduler.enabled: false` — тикер не стартует),
586
1254
  // ошибки старта логируются и не роняют процесс; остановка — `stopScheduler`.
587
1255
  const schedulerTickMs = config.synth.scheduler.tickSec * 1000;
588
- // PROP-032: `leaderElection=postgres` требует advisory-локов backend'а
1256
+ // ADR-097: `leaderElection=postgres` требует advisory-локов backend'а
589
1257
  // (`storage.backend=postgres`); иначе — предупреждение и AlwaysLeader.
590
1258
  if (config.synth.scheduler.leaderElection === 'postgres' && !storageContext.locks) {
591
1259
  console.warn('[scheduler] leaderElection=postgres, но backend не предоставляет advisory-локи ' +
@@ -599,9 +1267,29 @@ export async function createBackendDeps(config, storage, metrics) {
599
1267
  defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
600
1268
  catchUp: config.synth.scheduler.catchUp,
601
1269
  jobRetentionDays: config.synth.scheduler.jobRetentionDays,
1270
+ // ADR-030 (Ф0 ADR-090): хук `schedule_fired` (async, метаданные расписания).
1271
+ hooks,
602
1272
  // ADR-094: завершённые Job (outcome + дрейф cron).
603
1273
  onJob: schedulerJobMetrics,
604
- // ADR-051/ADR-089/PROP-032: тикер стартует только у лидера (default —
1274
+ // ADR-101: цель расписания `mode:'pipeline'` — прямой запуск прогона.
1275
+ // Прогон идёт в фоне: ждём только `onStarted` (id прогона), не конца.
1276
+ runPipeline: async ({ projectId, pipelineId, version, payload, dedupKey }) => {
1277
+ const started = new Promise((resolve, reject) => {
1278
+ const p = pipelineEngine.run({
1279
+ projectId,
1280
+ pipelineId,
1281
+ ...(version !== undefined ? { version } : {}),
1282
+ trigger: { kind: 'schedule', source: 'cron', type: 'schedule_fired', payload, dedupKey },
1283
+ onStarted: resolve,
1284
+ });
1285
+ // Ошибка до старта — reject (Job → error). Ошибка после старта — в журнале
1286
+ // прогона; обработчик снимает unhandled rejection, `reject` уже не сработает.
1287
+ p.catch(reject);
1288
+ });
1289
+ const run = await started;
1290
+ return { runId: run.id };
1291
+ },
1292
+ // ADR-051/ADR-089/ADR-096: тикер стартует только у лидера (default —
605
1293
  // AlwaysLeader). `file` — файловый лок на общем dataDir, `postgres` —
606
1294
  // session-level advisory-lock драйвера (доступен только при PG-backend).
607
1295
  leader: config.synth.scheduler.leaderElection === 'file'
@@ -615,11 +1303,14 @@ export async function createBackendDeps(config, storage, metrics) {
615
1303
  console.warn(`[scheduler] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
616
1304
  });
617
1305
  }
1306
+ // ADR-101/ADR-051: шедулер появился — отдаём его тулам `schedule_*`
1307
+ // через рантайм автоматизации (late-bound).
1308
+ automationRuntime.scheduler = schedulerService;
618
1309
  // ADR-092: авто-миграции схемы данных при старте (паритет со standalone-core) —
619
1310
  // обязательная страховочная копия + межпроцессный лок. Миграция снапшотов скоупа —
620
1311
  // зарегистрированная миграция реестра (`session-scope-snapshots-v1`), отдельный
621
1312
  // прямой вызов больше не нужен. Fail-closed: ошибка не глушится.
622
- // PROP-032 (W5): в деградации миграции не применяем (фоллбек-каталог пуст —
1313
+ // ADR-098 (W5): в деградации миграции не применяем (фоллбек-каталог пуст —
623
1314
  // страховочная копия/миграция были бы доменной записью в фоллбек).
624
1315
  if (!storageDegraded) {
625
1316
  await applyStartupMigrations({
@@ -627,7 +1318,7 @@ export async function createBackendDeps(config, storage, metrics) {
627
1318
  settingsStore,
628
1319
  sessionManager,
629
1320
  projectStore,
630
- // PROP-032: под PG — advisory-лок драйвера вместо файлового `{dataDir}/migrate`.
1321
+ // ADR-097: под PG — advisory-лок драйвера вместо файлового `{dataDir}/migrate`.
631
1322
  ...(storageContext.locks
632
1323
  ? { mutex: storageContext.locks.createMutex({ name: 'startup-migrate' }) }
633
1324
  : {}),
@@ -639,7 +1330,9 @@ export async function createBackendDeps(config, storage, metrics) {
639
1330
  }
640
1331
  return {
641
1332
  dataDir,
642
- // PROP-032: контекст хранения инстанса — для операций, которым нужен
1333
+ // ADR-106 Ф3: реестр подтверждений (enforced-режим Authority-слоя).
1334
+ approvalRegistry,
1335
+ // ADR-096: контекст хранения инстанса — для операций, которым нужен
643
1336
  // целиком (напр. портативный экспорт/импорт проекта, ADR-091).
644
1337
  storageContext,
645
1338
  // ADR-094: реестр метрик (доменные коллекторы подключаются выше) и
@@ -654,7 +1347,7 @@ export async function createBackendDeps(config, storage, metrics) {
654
1347
  providerStore,
655
1348
  modelStore,
656
1349
  agentStore,
657
- // PROP-032 (W2.4): конфигурационные словари и реестр service-key — из контекста.
1350
+ // ADR-096 (W2.4): конфигурационные словари и реестр service-key — из контекста.
658
1351
  dictionaries: dictionaryStore,
659
1352
  serviceApiKeyStore,
660
1353
  contextConfig,
@@ -668,17 +1361,51 @@ export async function createBackendDeps(config, storage, metrics) {
668
1361
  egressLogConfig,
669
1362
  securityAudit,
670
1363
  egressRequests,
671
- // PROP-102 (волна 1): порт пред-агрегированных роллапов аналитики — для роутов отчётов.
1364
+ // ADR-102 (волна 1): порт пред-агрегированных роллапов аналитики — для роутов отчётов.
672
1365
  analyticsRollups,
673
- // PROP-102: write-path — сборщик роллапов (+ остановка hook-подписки и pruner'а).
1366
+ // ADR-102: write-path — сборщик роллапов (+ остановка hook-подписки и pruner'а).
674
1367
  analytics,
675
1368
  detachAnalyticsHooks,
676
1369
  stopAnalyticsRollupPruner,
677
1370
  stopEgressLogPruner,
678
1371
  mcpManager,
679
1372
  mcpRegistryStore,
1373
+ // ADR-105 (Ф3/Ф4): реестр описаний OAuth-провайдеров и сервис слоя доступов
1374
+ // (HTTP-контур `/api/v2/oauth/credentials`).
1375
+ oauthProviders,
1376
+ oauthCredentialService,
1377
+ // ADR-051/ADR-100: порт реестра пайплайнов (определения + экземпляры).
1378
+ pipelines: pipelineStore,
1379
+ // ADR-101 (Э5): движок пайплайнов (второй движок) — HTTP-роутов нет (Э6).
1380
+ pipelineEngine,
1381
+ // ADR-101 §9/ADR-116: хранилище артефактов прогонов поверх blob-порта —
1382
+ // получает HTTP-раздача `GET /pipeline-runs/:runId/artifacts/:name`.
1383
+ pipelineArtifacts,
1384
+ // ADR-115 × ADR-101: сервис вложений — проверка `attachments[]` в теле
1385
+ // запуска прогона (тот же экземпляр, что у приёма событий).
1386
+ pipelineAttachments: eventAttachmentService,
1387
+ // ADR-101: реестр активных прогонов — общий для HTTP-роута пайплайнов и
1388
+ // встроенных тулов агента (soft-lock + отмена идущего прогона).
1389
+ pipelineRunControl,
1390
+ // ADR-086 §5: порт реестра установок пакетов расширений.
1391
+ packs: packStore,
680
1392
  eventBus,
681
1393
  queueManager,
1394
+ // Этап 1 roadmap 0.13 (блок 3): сервис вопросов пользователю (+ pruner).
1395
+ questionService,
1396
+ stopQuestionPruner,
1397
+ // Этап 1 roadmap 0.13 (блок 4): реестр фоновых прогонов (+ pruner).
1398
+ backgroundService,
1399
+ stopBackgroundRunPruner,
1400
+ // PROP-097 (блок 5b): сервис фоновых шелл-процессов (+ pruner логов).
1401
+ processService,
1402
+ stopProcessLogPruner,
1403
+ // ADR-115: GC осиротевших вложений сообщений.
1404
+ stopAttachmentPruner,
1405
+ // ADR-115: живое состояние настроек вложений (сервис/промпт/GC + админ-API).
1406
+ attachmentsSettings,
1407
+ // ADR-114: сервис worktree'ов — HTTP-контур проектов и привязка сессии.
1408
+ worktreeService,
682
1409
  webhookStore,
683
1410
  webhookDeliveryStore,
684
1411
  webhookService,
@@ -700,6 +1427,12 @@ export async function createBackendDeps(config, storage, metrics) {
700
1427
  bundleStore,
701
1428
  commandService,
702
1429
  orchestrator,
1430
+ // ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
1431
+ // (`app.ts`/`main.ts`) и точки для HTTP API/CLI (Ф5б-2/3). `host`+`installer` внутри.
1432
+ pluginRuntime,
1433
+ // ADR-077: порт исполнения — тот же инстанс, что у оркестратора и тулов
1434
+ // (резолвер проектных инструкций берёт его для `git rev-parse`).
1435
+ executionPort,
703
1436
  processMessage,
704
1437
  eventBindingStore,
705
1438
  eventApiKeyStore,