@itphx/synth-backend 0.13.4 → 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.
Files changed (67) hide show
  1. package/dist/app/deps.d.ts +22 -1
  2. package/dist/app/deps.js +743 -63
  3. package/dist/app/listen.js +30 -35
  4. package/dist/app/mount-routes.js +405 -46
  5. package/dist/app/public-routes.d.ts +2 -0
  6. package/dist/app/public-routes.js +11 -0
  7. package/dist/app/sse-events.js +2 -0
  8. package/dist/app.d.ts +8 -1
  9. package/dist/app.js +45 -11
  10. package/dist/auth/api-key.d.ts +19 -0
  11. package/dist/auth/api-key.js +56 -0
  12. package/dist/auth/middleware.js +11 -15
  13. package/dist/auth/oidc.d.ts +46 -4
  14. package/dist/auth/oidc.js +55 -8
  15. package/dist/events/hub.d.ts +36 -2
  16. package/dist/events/hub.js +66 -4
  17. package/dist/events/visible-session-ids.d.ts +35 -0
  18. package/dist/events/visible-session-ids.js +29 -0
  19. package/dist/init.d.ts +1 -0
  20. package/dist/init.js +96 -0
  21. package/dist/lib/app-config.js +42 -1
  22. package/dist/lib/bind-host.d.ts +10 -0
  23. package/dist/lib/bind-host.js +32 -0
  24. package/dist/lib/i18n.js +24 -0
  25. package/dist/lib/principal-identity.d.ts +35 -0
  26. package/dist/lib/principal-identity.js +43 -0
  27. package/dist/lib/project-principal.d.ts +27 -0
  28. package/dist/lib/project-principal.js +27 -0
  29. package/dist/lib/recalc-can-summarize.js +8 -5
  30. package/dist/main.js +9 -2
  31. package/dist/middleware/rate-limiter.d.ts +4 -1
  32. package/dist/middleware/rate-limiter.js +15 -2
  33. package/dist/routes/agents.d.ts +3 -3
  34. package/dist/routes/agents.js +6 -2
  35. package/dist/routes/auth.js +38 -20
  36. package/dist/routes/llm.js +65 -7
  37. package/dist/routes/mcp-remote.d.ts +23 -0
  38. package/dist/routes/mcp-remote.js +152 -0
  39. package/dist/routes/mcp.d.ts +11 -6
  40. package/dist/routes/mcp.js +35 -6
  41. package/dist/routes/project-access.d.ts +61 -0
  42. package/dist/routes/project-access.js +62 -0
  43. package/dist/routes/projects.d.ts +42 -5
  44. package/dist/routes/projects.js +128 -17
  45. package/dist/routes/providers.d.ts +4 -1
  46. package/dist/routes/providers.js +19 -99
  47. package/dist/routes/queue.d.ts +7 -1
  48. package/dist/routes/queue.js +7 -1
  49. package/dist/routes/schedules.d.ts +46 -0
  50. package/dist/routes/schedules.js +10 -0
  51. package/dist/routes/sessions.d.ts +67 -6
  52. package/dist/routes/sessions.js +348 -208
  53. package/dist/routes/users.d.ts +14 -1
  54. package/dist/routes/users.js +91 -1
  55. package/package.json +5 -5
  56. package/dist/routes/audit.d.ts +0 -17
  57. package/dist/routes/audit.js +0 -64
  58. package/dist/routes/context.d.ts +0 -4
  59. package/dist/routes/context.js +0 -93
  60. package/dist/routes/debug.d.ts +0 -3
  61. package/dist/routes/debug.js +0 -30
  62. package/dist/routes/gateway-patterns.d.ts +0 -9
  63. package/dist/routes/gateway-patterns.js +0 -57
  64. package/dist/routes/logs.d.ts +0 -24
  65. package/dist/routes/logs.js +0 -100
  66. package/dist/routes/mcp-registry.d.ts +0 -28
  67. package/dist/routes/mcp-registry.js +0 -483
package/dist/app/deps.js CHANGED
@@ -1,32 +1,58 @@
1
1
  // Сборка зависимостей backend: хранилища, менеджеры, оркестратор, событийное
2
2
  // ядро (ADR-089), планировщик (ADR-051), webhooks (ADR-052), скиллы/команды
3
- // (ADR-046), runtime-настройки (ADR-005/023).
3
+ // (ADR-126), runtime-настройки (ADR-005/023).
4
4
  // Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
5
5
  import { mkdir } from 'node:fs/promises';
6
+ import { existsSync } from 'node:fs';
6
7
  import { join } from 'node:path';
7
8
  import { ensureDataDir, mergeModelCompatibility, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword, resolveDegradedMode, resolveStorageFallbackDir, resolveExecutionConfig, readTlsRuntimeSettings, SYNTH_VERSION, generateId, makeTextPart, nowISO, MessageRole, } from '@itphx/synth-shared';
9
+ // ADR-135: применение runtime-каталога профилей исполнения (runtime > config;
10
+ // env/CLI выше — их разрешает `resolveExecutionConfig`, ADR-023).
11
+ import { applyExecutionRuntimeSettings, resolvePromptInjection } from '@itphx/synth-shared/config';
8
12
  import { DEFAULT_TOOL_OUTPUT_MAX_BYTES, DEFAULT_TOOL_OUTPUT_MAX_LINES } from '@itphx/synth-shared/config';
9
- import { SessionManager, EventBus, QueueProcessorManager, ContextBuilder, ContextOptimizer, ChatOrchestrator, enqueueUserMessage, requeueMessages, createToolRegistry, createAgentRegistry, McpManager, DEFAULT_AGENT_ID, registerStoredAgents, migrateLegacyStoredAgents, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeEventsConfig, mergeDecisionConfig, mergePluginsConfig,
13
+ import { SessionManager, EventBus, QueueProcessorManager, ContextBuilder, ContextOptimizer, ChatOrchestrator, enqueueUserMessage, requeueMessages, createToolRegistry, createAgentRegistry, McpManager, hiddenMcpServersForExecution,
14
+ // ADR-077: fail-closed проверка режима исполнения при старте (единственное
15
+ // место в backend — `app.ts` секцию не разрешает повторно).
16
+ checkExecutionMode, DEFAULT_AGENT_ID, registerStoredAgents, migrateLegacyStoredAgents, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeEventsConfig, mergeDecisionConfig, mergePluginsConfig,
10
17
  // ADR-115: живое состояние runtime-настроек вложений (`/settings/attachments`).
11
18
  createLiveAttachmentsSettings,
12
19
  // Политика контекстного окна (`/settings/context-window`).
13
20
  createLiveContextWindowPolicy,
14
21
  // Бюджет промпта саб-агента (`/settings/agents-limits`).
15
22
  createLiveSubagentMaxInputTokens,
23
+ // Лимит тяжёлых операций с сессиями (`/settings/limits`).
24
+ createLiveSessionOpsPerMinute,
16
25
  // Дефолты оптимизации контекста новых сессий (`/settings/context-defaults`).
17
26
  createLiveContextDefaults,
18
27
  // Instance-wide лимиты заметок сессии (`/settings/sticky-notes`).
19
- createLiveStickyNotesLimits, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner,
28
+ createLiveStickyNotesLimits,
29
+ // PROP-124: режим инстанса для SSH-ключей (`/settings/ssh`).
30
+ createLiveSshMode,
31
+ // Этап 1 roadmap 0.13 (блок 4): секция `background` (`/settings/background`).
32
+ createLiveBackgroundSettings,
33
+ // ADR-135: чтение runtime-каталога профилей исполнения (`/settings/execution`).
34
+ readExecutionRuntimeSettings, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner,
20
35
  // ADR-105 (Ф3): источник access-токена для MCP-коннекторов + OAuth-сервис.
21
- OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, detectRuntimeDeps, syncProvidersFromEnv,
36
+ OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, SnippetService, detectRuntimeDeps, syncProvidersFromEnv,
22
37
  // ADR-115 × ADR-101: доступность `ffmpeg` — обработчик вложения aux-моделью шага.
23
- isFfmpegAvailable, HookBus, startEphemeralSweeper, assertInstanceDataNotTooNew, applyStartupMigrations, applyPendingRestore, EventRouter, RequestSessionService, EventIngress, eventToMessage, addEventAttachmentRefs, AttachmentService, ProjectRuleProvider, DecisionRuleProvider, PipelineTracker, SchedulerRuleProvider, SchedulerService, AlwaysLeader, FileLeader, createExternalIdentityResolver, startEventJournalPruner,
38
+ isFfmpegAvailable, HookBus, startEphemeralSweeper, assertInstanceDataNotTooNew,
39
+ // PROP-137 Ф1: fail-closed проверка записи в каталог данных — до сборки
40
+ // хранилища (общая реализация в core, ADR-096: хранилище — только порты).
41
+ assertDataDirWritable, applyStartupMigrations, applyPendingRestore, EventRouter, RequestSessionService, EventIngress, eventToMessage, addEventAttachmentRefs, AttachmentService, ProjectRuleProvider, DecisionRuleProvider, PipelineTracker, SchedulerRuleProvider, SchedulerService, AlwaysLeader, FileLeader, SharedLeader,
42
+ // PROP-141 (Часть B): движок таймеров/будильников + правило маршрутизации.
43
+ TimerService, TimerRuleProvider, TIMER_EVENT_SOURCE, TIMER_EVENT_TYPE,
44
+ // PROP-141 (Часть D): сервис переноса сессии между проектами.
45
+ SessionMoveService, createExternalIdentityResolver, startEventJournalPruner,
24
46
  // Этап 1 roadmap 0.13 (блок 3): сервис вопросов пользователю + retention.
25
47
  QuestionService, startQuestionPruner,
26
48
  // Этап 1 roadmap 0.13 (блок 4): реестр фоновых прогонов + retention.
27
49
  BackgroundRunService, startBackgroundRunPruner, createBackgroundParentNotifier,
50
+ // PROP-143: durable-запись о прогоне, потерянном при рестарте.
51
+ appendLostRunRecords,
28
52
  // PROP-097 (блок 5b): сервис фоновых шелл-процессов + retention логов.
29
53
  ProcessService, startProcessLogPruner,
54
+ // ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск).
55
+ ScriptService,
30
56
  // ADR-115: GC осиротевших вложений сообщений.
31
57
  startAttachmentPruner,
32
58
  // ADR-115 × ADR-077: медиа-раннер (ffmpeg inline/remote) и серверные миниатюры.
@@ -34,7 +60,7 @@ createMediaRunner, ThumbnailService,
34
60
  // ADR-115 × ADR-077: уборка временных каталогов медиа-раннера
35
61
  // (`{workspacesRoot}/.synth-media/*`) — после жёсткого kill они остаются.
36
62
  startMediaTempPruner,
37
- // ADR-114: сервис worktree'ов (per-session рабочий каталог) + публикация
63
+ // ADR-114: сервис worktree (per-session рабочий каталог) + публикация
38
64
  // `worktree.updated` в каналы сессий проекта.
39
65
  WorktreeService, publishWorktreeUpdated, startWorktreeSweeper, WebhookService, startWebhookDeliveryPruner, AnalyticsRecorder, attachAnalyticsActivityHooks, startAnalyticsRollupPruner, sessionAxes, createStorageContextAsync, initTlsTrust, applyStartupProxyConfig, attachBusMetrics, startSessionMetrics, startStorageMetrics,
40
66
  // ADR-094/PROP-047: метрики памяти (`synth_memory_*`).
@@ -44,12 +70,21 @@ startMemoryMetrics,
44
70
  createMemoryTelemetry, registerDecisionMetrics, createSchedulerMetrics,
45
71
  // ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`).
46
72
  createExecutorMetricsCollector, createWebhookMetrics, createEventMetrics,
73
+ // PROP-141 (Часть B): метрики таймеров (`synth_timer_*`, ADR-094).
74
+ createTimerMetrics,
47
75
  // ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) + установка их
48
76
  // sink'а (сервис вложений собирается внутри фабрики роутов сессий).
49
77
  createAttachmentMetrics, setAttachmentMetricsHook,
50
78
  // ADR-106 Ф1/Ф2: счётчик решений Authority-слоя (`synth_authority_decisions_total`)
51
79
  // и guard-слоя (решение считается; в enforced-режиме — применяется).
52
- createAuthorityMetrics, AuthorityGuard,
80
+ createAuthorityMetrics,
81
+ // PROP-136 (слайс 136a): журнал исполнений команд + его метрики.
82
+ createCommandAuditLog, createCommandAuditMetrics,
83
+ // ADR-136/ADR-126 §5: парная запись `finished` по терминальному переходу
84
+ // фонового скрипта.
85
+ createScriptRunAuditFinisher,
86
+ // PROP-136b (слайс 136b-2a): зеркальный чекер команд (провайдер + метрики).
87
+ createCommandPolicyMetrics, createCommandPolicyProvider, AuthorityGuard,
53
88
  // ADR-106 Ф3: реестр подтверждений + покрытие (носитель покрывающего гранта).
54
89
  ApprovalRegistry, buildApprovalResponderProfile, createApprovalCoverageResolver, startEventJournalMetrics,
55
90
  // ADR-101 (Э5): движок пайплайнов, исполнители шагов, обработчики выходов.
@@ -61,11 +96,28 @@ PipelineRunControl, createToolStepExecutor, createScriptStepExecutor, createHuma
61
96
  createPipelineAttachmentDerive, ensureBuiltinPipelines,
62
97
  // ADR-101 §4 × `AgentDefinition`: провайдер агентского шага (код общий с core).
63
98
  resolvePipelineStepProvider, toCoreProviderConfig, ProviderFactory,
64
- // ADR-077: порт исполнения команд (inline/remote).
65
- createExecutionPortForConfig,
99
+ // PROP-135 Ф4b-1: instance-порт (при `provider: http` — ленивый, на пул).
100
+ createInstanceExecutionPort,
101
+ // PROP-135 Ф4a: роутер портов исполнения (пулы/профили).
102
+ createExecutionRouter,
103
+ // PROP-135 слайс 5b-2: резолвер проектного (браузерного) пула для вызовов
104
+ // MCP-инструментов исполнителя.
105
+ createExecutorMcpPoolResolver,
106
+ // PROP-132 (Ф3в): сервис терминалов инстанса + настройки секции `terminal`
107
+ // (env > runtime > config > default, по каждому полю).
108
+ createTerminalService, resolveTerminalSettings,
109
+ // PROP-135: порт терминала — тем же роутером, что и порт тулов.
110
+ createTerminalPortResolver,
111
+ // PROP-132 (Ф5): сообщение-уведомление о завершении запуска команды в
112
+ // терминале (точка сборки — тот же нотификатор, что у фоновых процессов).
113
+ buildTerminalRunNotification,
66
114
  // ADR-090 (Ф3а) / §5, §10 (Ф5б-1): общий реестр
67
115
  // блоков промпта (композер + фасад плагинов) и рантайм плагинов.
68
- PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, serializeMessage, } from '@itphx/synth-core';
116
+ PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, serializeMessage,
117
+ // PROP-142 §3: бюджет автовосстановления + планировщик boot-восстановления.
118
+ recordRecoveryAttempt, planBootRecovery, resolveRecoveryBudget,
119
+ // PROP-143: durable-запись причины остановки хода (след отказа по бюджету).
120
+ appendStopRecord, } from '@itphx/synth-core';
69
121
  import { EventHub } from '../events/hub.js';
70
122
  import { seedDebugTestUsers } from './bootstrap.js';
71
123
  /**
@@ -91,6 +143,14 @@ export async function createBackendStorage(config) {
91
143
  if (kind === 'memory') {
92
144
  console.warn('storage.backend=memory: данные не сохраняются на диск');
93
145
  }
146
+ // PROP-137 Ф1: fail-closed проверка записи в каталог данных — **до** сборки
147
+ // хранилища. Каталог нужен и при 'file' (все JSON-данные), и при
148
+ // 'postgres' (секреты, мастер-ключ и blob-хранилище — ADR-116/ADR-097).
149
+ // Без проверки EACCES всплывает позже и неясно (сессии/секреты/блобы),
150
+ // а UI при этом отвечает 200 — «сайт открыт, данные не сохраняются».
151
+ if (kind !== 'memory') {
152
+ await assertDataDirWritable(config.dataDir);
153
+ }
94
154
  const storage = await createStorageContextAsync(kind, {
95
155
  dataDir: config.dataDir,
96
156
  secretKey: resolveSecretKey(config.synth),
@@ -179,17 +239,43 @@ executionConfig) {
179
239
  config: config.synth.context?.stickyNotes,
180
240
  runtime: await settingsStore.getStickyNotesLimits(),
181
241
  });
242
+ // PROP-124: режим инстанса для SSH-ключей (`ssh.mode`): приоритет
243
+ // env > runtime > config.yaml > `tools`; применяется без рестарта.
244
+ const sshModeSettings = createLiveSshMode({
245
+ config: config.synth.ssh?.mode,
246
+ runtime: await settingsStore.getSshMode(),
247
+ });
248
+ // Этап 1 roadmap 0.13 (блок 4): секция `background` (реестр фоновых
249
+ // прогонов) — приоритет env > runtime > config.yaml > default. Один
250
+ // экземпляр на процесс: сервисы/прунеры/оркестратор читают его на каждый
251
+ // запуск/тик, поэтому runtime-настройка применяется без рестарта.
252
+ const backgroundSettings = createLiveBackgroundSettings({
253
+ store: settingsStore,
254
+ config: config.synth.background,
255
+ });
256
+ await backgroundSettings.refresh();
182
257
  // ADR-102: сборщик роллапов аналитики (write-path) — только через порт слоя
183
258
  // хранения; в деградации выключен (не пишем домен в файловый фоллбек).
184
259
  const analytics = storageDegraded ? undefined : new AnalyticsRecorder({ repo: analyticsRollups });
260
+ // PROP-141 (Часть B): каскад удаления сессии — снятие её таймеров/будильников.
261
+ // Сервис таймеров собирается ниже (после ingress'а), поэтому ссылка
262
+ // late-bound: шов один — `SessionManager.deleteSession` (инвариант 16).
263
+ const timerServiceRef = {};
264
+ // PROP-141 (Часть D): сервис переноса сессии — late-bound (собирается после
265
+ // движка таймеров, а оркестратор/extra тулов читают его на лету).
266
+ const moveServiceRef = {};
185
267
  const sessionManager = new SessionManager(fileStore, {
186
268
  projectStore,
187
269
  hooks,
270
+ // PROP-141: удаление сессии снимает её автоматизации (таймеры/будильники).
271
+ onSessionDeleted: async (sessionId) => {
272
+ await timerServiceRef.service?.onSessionDeleted(sessionId);
273
+ },
188
274
  // Дефолты оптимизации контекста новых сессий (`context.defaults` + runtime).
189
275
  contextDefaults: () => contextDefaultsSettings.getDefaults(),
190
276
  // ADR-102: точка персиста сообщений (`messages_assistant`/`messages_tool`).
191
277
  analytics,
192
- // ADR-071 §2.4 / ADR-046 §4.5: системные дефолты для сессий без проекта.
278
+ // ADR-071 §2.4 / ADR-126 §11: системные дефолты для сессий без проекта.
193
279
  systemDefaultsProvider: async () => ({
194
280
  mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
195
281
  skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
@@ -224,7 +310,12 @@ executionConfig) {
224
310
  // MCP: единый источник истины — реестр `McpRegistryStore` (ADR-071 §2.5).
225
311
  // Legacy `YamlMcpConfigStore` удалён: instance-серверы из config.mcp.servers
226
312
  // сидируются в реестр при старте (seed без дублирования по имени).
227
- const mcpManager = new McpManager();
313
+ const mcpManager = new McpManager({
314
+ // Advisory-детекция prompt injection в описаниях/`instructions` MCP
315
+ // (ru+en словарь `injection`) — только пометка в промпте, без блокировки.
316
+ dictionaryStore,
317
+ ...(metrics ? { metrics } : {}),
318
+ });
228
319
  await mcpRegistryStore.seedFromConfig(config.synth.mcp.servers);
229
320
  // Одно чтение реестра на все карты менеджера (вместо пяти).
230
321
  const mcpMaps = await mcpRegistryStore.toManagerMaps();
@@ -265,6 +356,13 @@ executionConfig) {
265
356
  config: config.synth.agents.subagentMaxInputTokens,
266
357
  runtime: await settingsStore.getSubagentMaxInputTokens(),
267
358
  });
359
+ // Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`):
360
+ // приоритет env > runtime > config.yaml > 10; `0` — без лимита. Лимитеры
361
+ // читают значение на каждый запрос — runtime-настройка применяется без рестарта.
362
+ const sessionOpsPerMinuteSettings = createLiveSessionOpsPerMinute({
363
+ config: config.synth.limits.sessionOpsPerMinute,
364
+ runtime: await settingsStore.getSessionOpsPerMinute(),
365
+ });
268
366
  const stopEgressLogPruner = storageDegraded || !egressLogConfig.enabled
269
367
  ? () => { }
270
368
  : startEgressLogPruner(egressRequests, { getRetentionDays: () => egressLogConfig.retentionDays });
@@ -412,12 +510,15 @@ executionConfig) {
412
510
  : new BackgroundRunService({
413
511
  repository: storageContext.backgroundRuns,
414
512
  eventBus,
513
+ // Снимок — fallback; живой резолвер читается на каждый запуск
514
+ // (runtime-настройка применяется без рестарта).
415
515
  limits: {
416
516
  maxSubagentsPerSession: config.synth.background.maxSubagentsPerSession,
417
517
  // PROP-097: лимит одновременных фоновых шелл-процессов на сессию.
418
518
  maxProcessesPerSession: config.synth.background.maxProcessesPerSession,
419
519
  maxRunsPerSession: config.synth.background.maxRunsPerSession,
420
520
  },
521
+ getLimits: () => backgroundSettings.getLimits(),
421
522
  // Точка сборки уведомления — здесь (глобальных синглтонов нет).
422
523
  //
423
524
  // ADR-036: обфускация user-сообщений НЕ применяется — уведомление
@@ -435,12 +536,30 @@ executionConfig) {
435
536
  // Старт: прогоны прошлого процесса не пережили рестарт (хэндлы отмены — в
436
537
  // памяти) — помечаем их `orphaned`. Best-effort: ошибка не роняет старт.
437
538
  if (backgroundService) {
539
+ let recovered = [];
438
540
  try {
439
- await backgroundService.recoverOnStart();
541
+ recovered = await backgroundService.recoverOnStart();
440
542
  }
441
543
  catch (err) {
442
544
  console.warn(`[background] восстановление фоновых прогонов не удалось: ${err instanceof Error ? err.message : String(err)}`);
443
545
  }
546
+ // PROP-143 §4 п.3: факт прерывания возвращается в историю сессии-владельца
547
+ // (durable-запись `execution_stopped`) — иначе о потере прогона знает только
548
+ // реестр, а не человек/родитель. Ход не запускается — только дозапись.
549
+ if (recovered.length) {
550
+ try {
551
+ const written = await appendLostRunRecords({
552
+ sessionManager,
553
+ eventBus,
554
+ records: recovered,
555
+ logger: { warn: (message) => console.warn(message) },
556
+ });
557
+ console.log(`[background] фоновые прогоны прерваны рестартом: осиротело ${recovered.length}, записей в историю добавлено ${written}`);
558
+ }
559
+ catch (err) {
560
+ console.warn(`[background] записи о прерванных прогонах не добавлены: ${err instanceof Error ? err.message : String(err)}`);
561
+ }
562
+ }
444
563
  }
445
564
  /**
446
565
  * Info-блок «ход продолжен после рестарта»: пишется в историю (роль INFO — в
@@ -488,6 +607,30 @@ executionConfig) {
488
607
  // показывает активность. Восстановление отложено на 60 с, чтобы старый под
489
608
  // успел умереть, а живые маркеры работающего процесса не были сняты.
490
609
  // В деградации хранилище read-only — ничего не пишем и не запускаем.
610
+ //
611
+ // PROP-142 §3: автовосстановление — **под бюджетом** (попытки на ход +
612
+ // детект crash-loop). Секция `recovery` конфига (`shared/config/types.ts`).
613
+ const recoveryBudget = resolveRecoveryBudget(config.synth);
614
+ /**
615
+ * Отказ по бюджету автовосстановления: след в истории (PROP-143) —
616
+ * durable-запись `execution_stopped` с причиной `orphaned`. Запись
617
+ * идемпотентна по `dedupeKey` (ход/сессия), ошибка записи не ломает boot.
618
+ */
619
+ const recordRecoveryDenied = async (sessionId, reason, dedupeKey) => {
620
+ try {
621
+ await appendStopRecord({
622
+ sessionManager,
623
+ eventBus,
624
+ sessionId,
625
+ input: { reason: 'orphaned', error: `recovery budget exhausted (${reason})` },
626
+ dedupeKey,
627
+ });
628
+ }
629
+ catch (err) {
630
+ console.warn(`[sessions] запись об отказе восстановления не добавлена: ${err instanceof Error ? err.message : String(err)}`);
631
+ }
632
+ console.warn(`[sessions] восстановление ${sessionId} запрещено бюджетом (${reason})`);
633
+ };
491
634
  if (!storageDegraded) {
492
635
  const bootRecovery = setTimeout(() => {
493
636
  void sessionManager.recoverInterruptedSessions()
@@ -500,14 +643,56 @@ executionConfig) {
500
643
  status: 'stopped',
501
644
  });
502
645
  eventBus.publish(r.sessionId, 'session.updated', { session_id: r.sessionId });
503
- if (!r.resumeMessage)
504
- continue;
505
- // Автопродолжение: info-блок в истории (в LLM-контекст не попадает —
506
- // роль INFO исключена из промпта) и resume-сообщение процессору.
507
- await addRestartResumedNotice(r.sessionId, r.streamId);
508
- queueManager.createProcessor(r.sessionId, sessionManager, eventBus, processMessage, {
509
- resumeMessage: r.resumeMessage,
510
- });
646
+ // PROP-142 §3: план восстановления — вид сессии (основная/дочерняя)
647
+ // и бюджет попыток/crash-loop. Одна сессия не должна ломать boot.
648
+ try {
649
+ const session = await sessionManager.getSession(r.sessionId);
650
+ const plan = planBootRecovery({
651
+ sessions: [
652
+ {
653
+ id: r.sessionId,
654
+ ...(session?.parentId ? { parentId: session.parentId } : {}),
655
+ ...(session?.sessionOrigin ? { sessionOrigin: session.sessionOrigin } : {}),
656
+ ...(session?.status.recovery ? { recovery: session.status.recovery } : {}),
657
+ },
658
+ ],
659
+ config: recoveryBudget,
660
+ })[0];
661
+ if (!plan)
662
+ continue;
663
+ if (plan.action === 'deny') {
664
+ // Бюджет исчерпан: ход терминализируется, след — в истории.
665
+ await recordRecoveryDenied(r.sessionId, plan.reason, `recovery:${r.turnId ?? r.sessionId}`);
666
+ continue;
667
+ }
668
+ if (plan.action === 'resume-child') {
669
+ // Дочерняя сессия (саб-агент): её цикл ведёт родитель — процессор
670
+ // очереди не создаём (у ребёнка нет своей очереди), возобновляем
671
+ // через цикл саб-агента (PROP-142 §3).
672
+ await recordRecoveryAttempt(sessionManager, r.sessionId);
673
+ try {
674
+ await orchestrator.startSubagentResume(r.sessionId);
675
+ await addRestartResumedNotice(r.sessionId, r.streamId);
676
+ }
677
+ catch (err) {
678
+ console.warn(`[sessions] возобновление дочерней сессии не выполнено: ${err instanceof Error ? err.message : String(err)}`);
679
+ }
680
+ continue;
681
+ }
682
+ // Основная сессия — прежнее поведение автопродолжения.
683
+ if (!r.resumeMessage)
684
+ continue;
685
+ await recordRecoveryAttempt(sessionManager, r.sessionId);
686
+ // Автопродолжение: info-блок в истории (в LLM-контекст не попадает —
687
+ // роль INFO исключена из промпта) и resume-сообщение процессору.
688
+ await addRestartResumedNotice(r.sessionId, r.streamId);
689
+ queueManager.createProcessor(r.sessionId, sessionManager, eventBus, processMessage, {
690
+ resumeMessage: r.resumeMessage,
691
+ });
692
+ }
693
+ catch (err) {
694
+ console.warn(`[sessions] восстановление сессии не выполнено: ${err instanceof Error ? err.message : String(err)}`);
695
+ }
511
696
  }
512
697
  if (recovered.length) {
513
698
  console.log(`[sessions] сняты маркеры прерванных ходов: ${recovered.length}`);
@@ -533,26 +718,51 @@ executionConfig) {
533
718
  if (s.pendingMessages.length === 0)
534
719
  continue;
535
720
  queueCandidates += 1;
536
- if (s.status.queueStopped) {
537
- eventBus.publish(s.id, 'queue.stalled', {
538
- pending_count: s.pendingMessages.length,
539
- });
540
- continue;
721
+ try {
722
+ // PROP-142 §3: бюджет автовосстановления — до любых действий
723
+ // (в т.ч. `queue.stalled`): при отказе очередь не трогаем, след
724
+ // в истории оставляем.
725
+ const plan = planBootRecovery({
726
+ sessions: [
727
+ {
728
+ id: s.id,
729
+ ...(s.parentId ? { parentId: s.parentId } : {}),
730
+ ...(s.sessionOrigin ? { sessionOrigin: s.sessionOrigin } : {}),
731
+ ...(s.status.recovery ? { recovery: s.status.recovery } : {}),
732
+ },
733
+ ],
734
+ config: recoveryBudget,
735
+ })[0];
736
+ if (plan?.action === 'deny') {
737
+ await recordRecoveryDenied(s.id, plan.reason, `recovery:queue:${s.id}`);
738
+ continue;
739
+ }
740
+ if (s.status.queueStopped) {
741
+ eventBus.publish(s.id, 'queue.stalled', {
742
+ pending_count: s.pendingMessages.length,
743
+ });
744
+ continue;
745
+ }
746
+ // Маркеры мог снять прошлый recovery, а сообщение осталось и в
747
+ // истории, и в очереди. Это прерванный in-flight ход: продолжаем
748
+ // его как resume (info-блок + метка `resumed`), а не как новую
749
+ // очередь — иначе сообщение материализуется в историю повторно.
750
+ const resume = await sessionManager.takePendingInFlight(s.id);
751
+ if (resume) {
752
+ inFlightResumed += 1;
753
+ await recordRecoveryAttempt(sessionManager, s.id);
754
+ await addRestartResumedNotice(s.id, resume.metadata?.stream_id);
755
+ queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage, {
756
+ resumeMessage: resume,
757
+ });
758
+ continue;
759
+ }
760
+ await recordRecoveryAttempt(sessionManager, s.id);
761
+ queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage);
541
762
  }
542
- // Маркеры мог снять прошлый recovery, а сообщение осталось и в
543
- // истории, и в очереди. Это прерванный in-flight ход: продолжаем
544
- // его как resume (info-блок + метка `resumed`), а не как новую
545
- // очередь — иначе сообщение материализуется в историю повторно.
546
- const resume = await sessionManager.takePendingInFlight(s.id);
547
- if (resume) {
548
- inFlightResumed += 1;
549
- await addRestartResumedNotice(s.id, resume.metadata?.stream_id);
550
- queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage, {
551
- resumeMessage: resume,
552
- });
553
- continue;
763
+ catch (err) {
764
+ console.warn(`[sessions] автозапуск очереди не выполнен: ${err instanceof Error ? err.message : String(err)}`);
554
765
  }
555
- queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage);
556
766
  }
557
767
  if (queueCandidates > 0) {
558
768
  // Только счётчики: ни id, ни содержимого сессий/сообщений.
@@ -573,14 +783,16 @@ executionConfig) {
573
783
  const stopBackgroundRunPruner = storageDegraded
574
784
  ? () => { }
575
785
  : startBackgroundRunPruner(storageContext.backgroundRuns, {
576
- getRetentionDays: () => config.synth.background.retentionDays,
786
+ // Живой резолвер: retention-настройка применяется на каждом тике.
787
+ getRetentionDays: () => backgroundSettings.getRetentionDays(),
577
788
  });
578
789
  // PROP-097 (блок 5b): retention логов фоновых процессов. Создаётся **до**
579
790
  // pruner'а записей реестра: лог удаляется, пока его запись ещё видна.
580
791
  const stopProcessLogPruner = storageDegraded
581
792
  ? () => { }
582
793
  : startProcessLogPruner(storageContext.backgroundRuns, storageContext.blobs, {
583
- getRetentionDays: () => config.synth.background.retentionDays,
794
+ // Живой резолвер: retention-настройка применяется на каждом тике.
795
+ getRetentionDays: () => backgroundSettings.getRetentionDays(),
584
796
  });
585
797
  // ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) — создаются до GC,
586
798
  // чтобы счётчик удалённых объектов был доступен при первом прогоне.
@@ -616,6 +828,15 @@ executionConfig) {
616
828
  // ADR-106 Ф1: решения Authority-слоя (`synth_authority_decisions_total`) —
617
829
  // лейблы только `action`/`effect`/`source`, без id (ADR-094).
618
830
  const authorityMetrics = metrics ? createAuthorityMetrics(metrics) : undefined;
831
+ // PROP-136 (слайс 136a): append-only журнал исполнений `execute_shell`/
832
+ // `sandbox_exec`. Managed-профиль включает его по умолчанию
833
+ // (`security.commandAudit.enabled`, `loadBackendConfig`).
834
+ const commandAuditMetrics = metrics ? createCommandAuditMetrics(metrics) : undefined;
835
+ const commandAuditLog = createCommandAuditLog({
836
+ dataDir,
837
+ ...(config.synth.security?.commandAudit ? { config: config.synth.security.commandAudit } : {}),
838
+ ...(commandAuditMetrics ? { metrics: commandAuditMetrics } : {}),
839
+ });
619
840
  if (metrics) {
620
841
  // ADR-115: сервис вложений собирается внутри фабрики роутов сессий, куда
621
842
  // метрики не прокинуть — ставим хуки в sink коллектора (снимается на stop).
@@ -765,6 +986,20 @@ executionConfig) {
765
986
  // приоритетнее config.yaml — мёржим при старте, чтобы защита применялась к оркестратору.
766
987
  const runtimeSecurity = await settingsStore.getSecuritySettings();
767
988
  const securityConfig = mergeSecurityConfig(config.synth.security, runtimeSecurity);
989
+ if (securityConfig) {
990
+ // ADR-023: env `SYNTH_SECURITY_PROMPT_INJECTION_*` перекрывает runtime и
991
+ // config.yaml (приоритет env > runtime > config > default, по полю).
992
+ securityConfig.promptInjection = resolvePromptInjection(config.synth.security?.promptInjection, runtimeSecurity.promptInjection).config;
993
+ }
994
+ // PROP-136b (слайс 136b-2a): зеркальный чекер команд (`security.commandPolicy`).
995
+ // Managed-профиль поднимает `failMode` до `closed` (`loadBackendConfig`);
996
+ // `enabled: true` без адреса — ошибка старта (fail-closed).
997
+ const commandPolicyMetrics = metrics ? createCommandPolicyMetrics(metrics) : undefined;
998
+ const commandPolicyProvider = securityConfig?.commandPolicy
999
+ ? createCommandPolicyProvider(securityConfig.commandPolicy, {
1000
+ ...(commandPolicyMetrics ? { metrics: commandPolicyMetrics } : {}),
1001
+ })
1002
+ : null;
768
1003
  // ADR-071 §2.3: runtime-политика встроенных инструментов (админка) приоритетнее config.yaml
769
1004
  const runtimeToolsPolicy = await settingsStore.getToolsPolicy();
770
1005
  const toolsPolicy = runtimeToolsPolicy ?? config.synth.tools.policy;
@@ -774,9 +1009,15 @@ executionConfig) {
774
1009
  // ADR-071 §2.6: runtime-отключение инструментов (админка) приоритетнее config.yaml
775
1010
  const runtimeToolsDisabled = await settingsStore.getToolsDisabled();
776
1011
  const toolsDisabled = runtimeToolsDisabled ?? config.synth.tools.disabled ?? { capabilities: [], tools: [] };
777
- // ADR-046 §4.5: runtime-отключение скиллов (админка) — hard-gate системного уровня.
1012
+ // ADR-126 §11: runtime-отключение скиллов (админка) — hard-gate системного уровня.
778
1013
  const skillsDisabled = (await settingsStore.getSkillsDisabled())
779
1014
  ?? { categories: [], groups: [], skills: [] };
1015
+ // ADR-126/ADR-069: project-trust гейт скиллов/команд/инструкций. Runtime
1016
+ // (`settings.json`/PG) приоритетнее `config.yaml`; применяется при старте —
1017
+ // `restartRequired` в API, инвариант 24.
1018
+ const effectiveSkillsTrustedProjectDirs = (await settingsStore.getSkillsTrustedProjectDirs())
1019
+ ?? config.synth.skills.trustedProjectDirs
1020
+ ?? [];
780
1021
  // ADR-084: runtime/эффективный конфиг decision-слоя (админка) приоритетнее
781
1022
  // config.yaml `decision`. Live-применяется ко всем трём потребителям
782
1023
  // (микро-каскад, роутер, события ADR-089) через `live.setDecision`.
@@ -817,7 +1058,7 @@ executionConfig) {
817
1058
  catch (err) {
818
1059
  console.warn(`[agents] не удалось загрузить агентов из стора: ${err instanceof Error ? err.message : String(err)}`);
819
1060
  }
820
- // ADR-046: сервис скиллов (discovery + instance-запись + каталог промпта).
1061
+ // ADR-126: сервис скиллов (discovery + instance-запись + каталог промпта).
821
1062
  // ADR-116: instance-скиллы — порт слоя хранения (`storageContext.skills`):
822
1063
  // при `storage.backend=postgres` это метаданные в SQL + содержимое в blobs.
823
1064
  const skillService = new SkillService({
@@ -825,10 +1066,16 @@ executionConfig) {
825
1066
  store: storageContext.skills,
826
1067
  configPaths: config.synth.skills.paths,
827
1068
  urls: config.synth.skills.urls,
828
- trustedProjectDirs: config.synth.skills.trustedProjectDirs,
1069
+ trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
829
1070
  toolsets: config.synth.skills.toolsets,
830
1071
  });
831
- // ADR-046 §7: slash-команды и bundles (mirror core).
1072
+ // ADR-126 §4: сервис сниппетов (`#`) — три уровня (`instance`/`project`/`user`),
1073
+ // discovery + запись файлов + раскрытие (mirror core).
1074
+ const snippetService = new SnippetService({
1075
+ dataDir,
1076
+ trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
1077
+ });
1078
+ // ADR-126 §1: slash-команды и bundles (mirror core).
832
1079
  const commandService = new CommandService({
833
1080
  config: {
834
1081
  dataDir,
@@ -838,7 +1085,7 @@ executionConfig) {
838
1085
  maxArgumentsLength: config.synth.commands.maxArgumentsLength,
839
1086
  maxRenderedBytes: config.synth.commands.maxRenderedBytes,
840
1087
  toolsets: config.synth.skills.toolsets,
841
- trustedProjectDirs: config.synth.skills.trustedProjectDirs,
1088
+ trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
842
1089
  inlineShell: config.synth.skills.inlineShell ?? false,
843
1090
  },
844
1091
  skillRuntime: skillService,
@@ -849,27 +1096,170 @@ executionConfig) {
849
1096
  // запуска процесса (инвариант 24), поэтому порт собирается здесь, при старте.
850
1097
  // Тот же порт получают оркестратор (тулы, inline-shell, детект зависимостей)
851
1098
  // и резолвер проектных инструкций.
852
- const execution = executionConfig ?? resolveExecutionConfig(config.synth, process.env);
1099
+ //
1100
+ // ADR-135: поверх config-уровня применяется **runtime-каталог профилей
1101
+ // исполнения** (`settings.json`/PG). Приоритет — **env/CLI > runtime >
1102
+ // config.yaml** (env/CLI разрешаются внутри `resolveExecutionConfig`,
1103
+ // ADR-023); каталог `profiles` runtime-секции **заменяет** каталог
1104
+ // config.yaml целиком. Секция `execution` — параметр запуска: порты пулов и
1105
+ // роутер создаются на старте, поэтому изменение требует рестарта
1106
+ // (`restartRequired` в `/api/v2/settings/execution`). Хранилище может быть
1107
+ // недоступно (деградация, ADR-098) — тогда действует config-уровень.
1108
+ const baseExecution = executionConfig ?? resolveExecutionConfig(config.synth, process.env);
1109
+ const runtimeExecution = await readExecutionRuntimeSettings(settingsStore);
1110
+ const execution = applyExecutionRuntimeSettings(baseExecution, runtimeExecution);
1111
+ // ADR-077: fail-closed проверка режима исполнения — **единственное** место
1112
+ // (backend `app.ts` разрешение секции не дублирует): неверный
1113
+ // `mode`/`failMode` — ошибка; `remote` без адресов/пакета исполнителя/
1114
+ // читаемого токена — старт прерывается, а не «молча уходит в inline».
1115
+ // Runtime-каталог профилей проверку не меняет (общий адрес секции и режим
1116
+ // остаются config/env-уровня).
1117
+ const executionCheck = await checkExecutionMode(execution);
1118
+ if (!executionCheck.ok) {
1119
+ throw new Error(executionCheck.message);
1120
+ }
1121
+ // PROP-135 D1/D2: браузерный MCP-сервер исполнителя (дефолт `playwright`)
1122
+ // остаётся подключённым — его вызывает `ExecutionPort.browserCall` напрямую
1123
+ // (`POST /mcp/call`), — но его инструменты не регистрируются: модели нужны
1124
+ // встроенные `browser_*`, а `playwright_*` были дублями в реестре/промпте.
1125
+ // `inline`/пустое имя → скрытых нет (прежнее поведение).
1126
+ mcpManager.setHiddenServers(hiddenMcpServersForExecution(execution));
853
1127
  // ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`) — приёмник
854
1128
  // для клиента удалённого порта (очередь, занятость, ожидание, исход).
855
1129
  const executorMetrics = metrics ? createExecutorMetricsCollector(metrics) : undefined;
856
- const executionPort = await createExecutionPortForConfig(execution, executorMetrics ? { metricsSink: executorMetrics } : undefined);
1130
+ // PROP-135 Ф4b-1: при `provider: http` адреса исполнителей приходят от
1131
+ // provisioner'а — instance-порт собирается **лениво** (на instance-пул),
1132
+ // статический `execution.remote.url` не требуется.
1133
+ const executionPort = await createInstanceExecutionPort(execution, executorMetrics ? { metricsSink: executorMetrics } : undefined);
1134
+ // PROP-135 Ф4a: роутер портов исполнения (пулы/профили). Порты профилей
1135
+ // создаются **на старте** (инвариант 24: `execution.*` — параметр запуска),
1136
+ // поэтому роутер синхронен: `portFor(profile)` отдаёт порт профиля.
1137
+ // Instance-порт переиспользуется (второй клиент удалённого пула не нужен).
1138
+ const executionRouter = await createExecutionRouter({
1139
+ config: execution,
1140
+ ...(executorMetrics ? { metricsSink: executorMetrics } : {}),
1141
+ instancePort: executionPort,
1142
+ });
1143
+ // PROP-135 слайс 5b-2: резолвер **проектного** (браузерного) пула для
1144
+ // вызовов MCP-инструментов исполнителя (`project:<id>:browser:<profile>`).
1145
+ // Роутер не умеет отдавать ссылку (`poolRefFor` нет — `inline`/вырожденный
1146
+ // роутер) → резолвера нет: вызовы идут с инстанс-пула (прежнее поведение).
1147
+ const executorMcpResolvePool = createExecutorMcpPoolResolver(executionRouter);
1148
+ // PROP-132 (Ф3в): сервис терминалов инстанса — **один экземпляр на процесс**
1149
+ // (реестр живых терминалов, поток вывода, ввод, лимиты, аудит, метрики).
1150
+ //
1151
+ // Жизненный цикл — здесь, а не в `mount-routes.ts`: сервис гасится на
1152
+ // graceful shutdown (`stopTerminalService`), а мастер-выключатель
1153
+ // `terminal.enabled` применяется **live** (`setEnabled`): живые терминалы
1154
+ // закрываются, создание новых запрещается — рестарт не нужен.
1155
+ //
1156
+ // PROP-135: порт терминала выбирается **тем же** роутером, что и порт тулов
1157
+ // (профиль по binding'у + область пула + `workspaceSubPath`) — терминал живёт
1158
+ // на той же точке исполнения, что и ход сессии.
1159
+ const terminalPortResolver = createTerminalPortResolver({
1160
+ router: executionRouter,
1161
+ sessions: { getSession: (id) => sessionManager.getSession(id) },
1162
+ projects: { load: (id) => projectStore.load(id) },
1163
+ agents: { get: (role) => agentRegistry.get(role) },
1164
+ workspacesRoot: config.workspacesRoot ?? join(dataDir, 'workspaces'),
1165
+ });
1166
+ // Эффективные настройки секции `terminal` (env > runtime > config > default,
1167
+ // по каждому полю): читаются **до** сборки сервиса — параметры выполнения,
1168
+ // оболочка новых терминалов и журналирование ввода приезжают стартовыми
1169
+ // значениями, дальше меняются live из `/api/v2/settings/terminal`.
1170
+ const terminalRuntime = await settingsStore.getTerminal();
1171
+ const terminalSettings = resolveTerminalSettings({
1172
+ ...(config.synth.terminal ? { config: config.synth.terminal } : {}),
1173
+ runtime: terminalRuntime,
1174
+ env: process.env,
1175
+ });
1176
+ const terminalService = createTerminalService({
1177
+ port: executionPort,
1178
+ resolvePort: terminalPortResolver,
1179
+ blobs: storageContext.blobs,
1180
+ eventBus,
1181
+ commandAuditLog,
1182
+ ...(metrics ? { metrics } : {}),
1183
+ sessions: { getSession: (id) => sessionManager.getSession(id) },
1184
+ limits: {
1185
+ idleMs: terminalSettings.idleMinutes * 60_000,
1186
+ maxPerProject: terminalSettings.maxPerProject,
1187
+ maxPerInstance: terminalSettings.maxPerInstance,
1188
+ },
1189
+ defaultShell: terminalSettings.shell,
1190
+ auditInput: terminalSettings.auditInput,
1191
+ // PROP-132 (Ф5): результат запуска команды в терминале приходит в сессию
1192
+ // **сообщением** — тем же нотификатором, что у фоновых шелл-процессов
1193
+ // (ADR-113): ровно одна копия (steer при активном ходе, иначе очередь).
1194
+ onRunFinished: async (run, terminal) => {
1195
+ const sessionId = terminal?.sessionId ?? run.sessionId;
1196
+ if (!sessionId) {
1197
+ // Терминал без привязки к сессии — уведомлять некуда (только лог).
1198
+ console.warn(`[terminal] терминал ${run.terminalId} не привязан к сессии — результат запуска ${run.runId} не доставлен`);
1199
+ return;
1200
+ }
1201
+ await notifyBackgroundParent(sessionId, buildTerminalRunNotification(run));
1202
+ },
1203
+ });
1204
+ // PROP-132: восстановление терминалов из снимков — тот же порядок
1205
+ // приоритета. Значение применяется **до** восстановления: выключенное
1206
+ // восстановление → снимки не поднимаются (их уберёт reaper).
1207
+ terminalService.setAutoRestore(terminalSettings.autoRestore);
1208
+ // Снимки терминалов поднимаются **до** применения мастер-выключателя:
1209
+ // восстановление поднимает **процесс** (новый PTY) для терминалов, живых на
1210
+ // момент остановки, — при выключенном контуре они сразу закрываются
1211
+ // (`setEnabled(false)`), при включённом возвращаются с сохранённой историей
1212
+ // вывода.
1213
+ const restoredTerminals = await terminalService.restoreFromSnapshots();
1214
+ if (restoredTerminals > 0) {
1215
+ console.log(`[terminal] восстановлено терминалов из снимков: ${restoredTerminals}`);
1216
+ }
1217
+ terminalService.setEnabled(terminalSettings.enabled);
857
1218
  // PROP-097 (блок 5b): сервис фоновых шелл-процессов (паритет с standalone).
858
1219
  //
859
1220
  // Тот же порт исполнения, что у тулов (ADR-077): фон — это лишь способ
860
1221
  // ожидания, а не отдельный путь исполнения. Учёт прогона — общий реестр
861
1222
  // фоновых прогонов (`kind: 'process'`), лог — blob-хранилище (ADR-096).
862
1223
  // В деградированном режиме хранилища сервиса нет (писать некуда).
1224
+ //
1225
+ // Логгер сервиса: предупреждения — в вывод процесса (в journal — консоль).
1226
+ const processLogger = { warn: (message) => console.warn(message) };
863
1227
  const processService = backgroundService
864
1228
  ? new ProcessService({
865
1229
  executionPort,
866
1230
  background: backgroundService,
867
1231
  blobs: storageContext.blobs,
868
1232
  eventBus,
1233
+ // Снимок — fallback; живой предел лога читается при создании лога.
869
1234
  limits: { maxLogBytes: config.synth.background.logMaxBytes },
1235
+ getMaxLogBytes: () => backgroundSettings.getMaxLogBytes(),
1236
+ logger: processLogger,
1237
+ // ADR-136/ADR-126 §5: терминальный переход фонового процесса
1238
+ // дописывает в журнал исполнений парную запись `finished`
1239
+ // (только метаданные — вывод процесса не пишется).
1240
+ onFinished: createScriptRunAuditFinisher({
1241
+ audit: commandAuditLog,
1242
+ logger: processLogger,
1243
+ }),
870
1244
  })
871
1245
  : undefined;
872
- // ADR-114: сервис worktree'ов (per-session рабочий каталог).
1246
+ // ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск) — mirror core.
1247
+ //
1248
+ // Тот же экземпляр получают HTTP-роуты `/api/v2/sessions/:id/scripts*` и
1249
+ // тулы `script_list`/`script_run`. Создаётся только вместе с
1250
+ // `processService`: запускать скрипты негде (фоновые процессы в
1251
+ // деградированном режиме хранилища не создаются).
1252
+ const scriptService = processService
1253
+ ? new ScriptService({
1254
+ config: {
1255
+ dataDir,
1256
+ scriptsPaths: config.synth.scripts.paths,
1257
+ trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
1258
+ },
1259
+ processService,
1260
+ })
1261
+ : undefined;
1262
+ // ADR-114: сервис worktree (per-session рабочий каталог).
873
1263
  //
874
1264
  // Один инстанс на процесс: его получают HTTP-роуты проектов
875
1265
  // (`/projects/:id/worktrees*`), тулы `git_worktree_*` и привязка сессии
@@ -898,7 +1288,7 @@ executionConfig) {
898
1288
  });
899
1289
  },
900
1290
  });
901
- // ADR-114 §7.4: sweep осиротевших записей worktree'ов при старте процесса
1291
+ // ADR-114 §7.4: sweep осиротевших записей worktree при старте процесса
902
1292
  // (записи без каталога — их чистит и prune проекта, §7.3). Фоново: старт
903
1293
  // **не блокируется**, ошибка — в лог, процесс продолжает жить. В деградированном
904
1294
  // режиме хранилища сервиса нет — вычищать нечего.
@@ -1044,6 +1434,32 @@ executionConfig) {
1044
1434
  }
1045
1435
  return model ? model.enabled !== false : undefined;
1046
1436
  };
1437
+ // Workstream A1: снимок метаданных инстанса для read-only тула `synth_info`
1438
+ // (managed). Секретов нет: только флаги наличия ключей/настроек.
1439
+ const authDebug = config.auth.debugMode === true;
1440
+ const oidcEnabled = config.auth.oidc?.enabled === true;
1441
+ const apiKeyConfigured = Boolean(config.auth.apiKey || process.env.SYNTH_API_KEY);
1442
+ const instanceMeta = {
1443
+ mode: 'managed',
1444
+ server: { port: config.port },
1445
+ auth: {
1446
+ mode: authDebug ? 'debug' : oidcEnabled ? 'oidc' : apiKeyConfigured ? 'api-key' : 'unknown',
1447
+ localKeyPresent: existsSync(join(dataDir, 'secrets/api-key')),
1448
+ apiKeyConfigured,
1449
+ oidcEnabled,
1450
+ debug: authDebug,
1451
+ },
1452
+ storage: {
1453
+ backend: resolveStorageBackend(config.synth, process.env),
1454
+ degraded: storageDegraded,
1455
+ },
1456
+ features: {
1457
+ mcp: true,
1458
+ metrics: config.synth.metrics.enabled === true,
1459
+ memory: true,
1460
+ restartMode: process.env.SYNTH_RESTART_MODE ?? 'disabled',
1461
+ },
1462
+ };
1047
1463
  const orchestrator = new ChatOrchestrator({
1048
1464
  sessionManager,
1049
1465
  eventBus,
@@ -1053,10 +1469,51 @@ executionConfig) {
1053
1469
  authorityGate: authorityGuard?.gate,
1054
1470
  // ADR-106 Ф3: реестр подтверждений (привязка к ходу + носитель гранта).
1055
1471
  ...(approvalRegistry ? { approvalRegistry } : {}),
1472
+ // ADR-029: отдельное хранилище ожиданий подтверждения (ADR-096) —
1473
+ // персистентная копия ожидания, переживающая рестарт инстанса. Документ
1474
+ // сессии не трогаем: запись в него — полная замена истории, а результаты
1475
+ // параллельных тулов пишутся точечно (`appendMessage`, ADR-118 §4).
1476
+ ...(storageDegraded ? {} : { pendingApprovalRepository: storageContext.pendingApprovals }),
1056
1477
  // ADR-077: порт исполнения команд (inline — исполнение в процессе).
1057
1478
  executionPort,
1479
+ // PROP-135 Ф4a: роутер портов — порт тулов выбирается по профилю
1480
+ // сессии (`session.settings.executorProfile`).
1481
+ executionRouter,
1482
+ // ADR-135/PROP-135: эффективная секция `execution` — из неё выводится вид
1483
+ // среды исполнения (блок `[СРЕДА ИСПОЛНЕНИЯ]` в системном промпте).
1484
+ executionConfig: execution,
1485
+ // PROP-135 слайс 5b-2: резолвер **проектного** (браузерного) пула для
1486
+ // вызовов MCP-инструментов исполнителя: по `projectId` цели — адреса и
1487
+ // токен пула `project:<id>:browser:<profile>`. Роутер не умеет отдавать
1488
+ // ссылку (`poolRefFor` нет) → резолвера нет, вызовы идут с инстанс-пула
1489
+ // (прежнее поведение).
1490
+ ...(executorMcpResolvePool ? { executorMcpResolvePool } : {}),
1058
1491
  // ADR-102: сборщик `usage`/`decision` роллапов (write-path).
1059
1492
  analytics,
1493
+ // Аудит выдачи сессионных shell-грантов (паттерны команд и каталоги
1494
+ // правила `external_directory`).
1495
+ onPermissionGrant: (entry) => {
1496
+ if (!securityAudit)
1497
+ return;
1498
+ void securityAudit.append({
1499
+ id: `sa_${generateId()}`,
1500
+ ts: nowISO(),
1501
+ actor: entry.actor,
1502
+ scope: 'permission',
1503
+ action: 'grant',
1504
+ source: 'runtime',
1505
+ before: null,
1506
+ after: {
1507
+ sessionId: entry.sessionId,
1508
+ patterns: entry.patterns,
1509
+ directories: entry.directories,
1510
+ command: entry.command,
1511
+ },
1512
+ version: 1,
1513
+ }).catch((err) => {
1514
+ console.warn(`[permission] аудит гранта не записан: ${err instanceof Error ? err.message : String(err)}`);
1515
+ });
1516
+ },
1060
1517
  contextBuilder,
1061
1518
  contextConfig,
1062
1519
  providerLoader,
@@ -1069,6 +1526,11 @@ executionConfig) {
1069
1526
  // (ниже, `PluginRuntime`) — блоки плагинов попадают в промпт сессии.
1070
1527
  promptBlocks,
1071
1528
  mcpManager,
1529
+ // Workstream A1: реестр MCP и снимок инстанса — read-only тулы
1530
+ // `synth_info`/`synth_mcp_list`/`synth_mcp_test`. Политика читается live.
1531
+ mcpRegistry: mcpRegistryStore,
1532
+ getMcpNetworkPolicy: () => egressResolver.resolveMcp(),
1533
+ instanceMeta,
1072
1534
  projectStore,
1073
1535
  // Онбординг: тул `profile_update` сохраняет ответы интервью в профиль.
1074
1536
  profilesStore,
@@ -1134,6 +1596,11 @@ executionConfig) {
1134
1596
  ...(config.synth.session?.autoTitle ? { autoTitle: config.synth.session.autoTitle } : {}),
1135
1597
  securityConfig,
1136
1598
  gatewayConfig,
1599
+ // PROP-136 (слайс 136a): журнал исполнений команд — тот же экземпляр
1600
+ // читает `GET /api/v2/audit/commands`.
1601
+ commandAudit: commandAuditLog,
1602
+ // PROP-136b (слайс 136b-2a): зеркальный чекер команд (нет — прежнее поведение).
1603
+ ...(commandPolicyProvider ? { commandPolicy: commandPolicyProvider } : {}),
1137
1604
  gatewayAuditLogger,
1138
1605
  gatewayPayloadLogPath,
1139
1606
  gatewayPatternStore: patternStore,
@@ -1150,7 +1617,7 @@ executionConfig) {
1150
1617
  toolsPolicy,
1151
1618
  mcpPolicy,
1152
1619
  toolsDisabled,
1153
- // ADR-046 §4.5: системный hard-gate скиллов (runtime-настройка).
1620
+ // ADR-126 §11: системный hard-gate скиллов (runtime-настройка).
1154
1621
  skillsDisabled,
1155
1622
  // ADR-070 §2.9.1: зависимости окружения (git/rg/sh) — детекция при старте.
1156
1623
  // Проба бинарников — через тот же порт исполнения (ADR-077).
@@ -1158,20 +1625,28 @@ executionConfig) {
1158
1625
  // ADR-071 §2.6: калибровка chars-per-token по модели (runtime-настройки).
1159
1626
  tokenRatioLoader: (model) => settingsStore.getTokenRatio(model),
1160
1627
  onTokenRatioCalibrated: (model, ratio) => settingsStore.setTokenRatio(model, ratio),
1161
- // ADR-046 §5: каталог скиллов в промпт + тул `skill`.
1628
+ // ADR-126 §5: каталог скиллов в промпт + тул `skill`.
1162
1629
  skillRuntime: skillService,
1163
- // ADR-046 §7: резолвинг `/`-команд до LLM.
1630
+ // ADR-126 §1: резолвинг `/`-команд до LLM.
1164
1631
  commandRuntime: commandService,
1165
1632
  // ADR-069 Фаза 1: проектные инструкции (merged chain AGENTS.md).
1166
1633
  instructionsConfig: config.synth.instructions,
1167
1634
  // ADR-069 Фаза 2a: project-trust гейт инструкций (config.skills.trustedProjectDirs).
1168
- instructionsTrustedProjectDirs: config.synth.skills.trustedProjectDirs,
1635
+ instructionsTrustedProjectDirs: effectiveSkillsTrustedProjectDirs,
1169
1636
  // ADR-089: late-bound funnel создания сессий для тула `task` (саб-агент).
1170
1637
  // Сервис создаётся ниже (после оркестратора) — геттер читает его в рантайме.
1171
1638
  getRequestSessionService: () => requestSessionService,
1172
1639
  // ADR-051: late-bound резолвер активности расписания в сессии (ScheduleStore
1173
1640
  // создаётся ниже) — включает статический блок `Scheduler` в промпт.
1174
1641
  isSchedulerActive: (sid) => scheduleStore.hasEnabledTargetFor(sid),
1642
+ // PROP-141 (Часть D): сервис переноса сессии (late-bound — собирается
1643
+ // после движка таймеров) → extra тулов `project_attach`/`project_create`.
1644
+ getMoveService: () => moveServiceRef.service,
1645
+ // PROP-141 (этап 6): движок таймеров/будильников (late-bound — тот же
1646
+ // экземпляр, что у HTTP-роутов `/api/v2/timers*`) и порт реестра →
1647
+ // extra тулов `timer`/`alarm`.
1648
+ getTimerService: () => timerServiceRef.service,
1649
+ timerRepository: storageContext.timers,
1175
1650
  // ADR-101/ADR-051: late-bound рантайм автоматизации для встроенных тулов
1176
1651
  // (`pipeline_*`/`schedule_*`) — движок пайплайнов и шедулер создаются ниже,
1177
1652
  // поэтому геттер отдаёт актуальный снимок в момент хода.
@@ -1191,10 +1666,24 @@ executionConfig) {
1191
1666
  // PROP-097: сервис фоновых шелл-процессов — тот же экземпляр, что у
1192
1667
  // реестра и тула `execute_shell` (через `ctx.extra.processService`).
1193
1668
  ...(processService ? { processService } : {}),
1194
- // ADR-114: сервис worktree'ов — тулы `git_worktree_*` (инвентарь
1669
+ // ADR-126 §5: реестр скриптов проекта — тулы `script_list`/`script_run`
1670
+ // (через `ctx.extra.scriptService`) и HTTP-роут `/sessions/:id/scripts*`.
1671
+ ...(scriptService ? { scriptService } : {}),
1672
+ // PROP-132 (Ф5): сервис интерактивных терминалов — тот же экземпляр, что у
1673
+ // HTTP-роутов `/api/v2/terminals*` (через `ctx.extra.terminalService`).
1674
+ terminalService,
1675
+ // PROP-124 §0: режим инстанса для SSH-ключей (`ssh.mode`) — live-геттер:
1676
+ // runtime-настройка (`/api/v2/settings/ssh`) применяется без рестарта.
1677
+ // `tools` (дефолт) — ключ в окружение команд не попадает; `agent` — ключи
1678
+ // роли агента выдаются вызову `execute_shell` (эфемерный `ssh-agent`).
1679
+ getSshMode: () => sshModeSettings.getMode(),
1680
+ // ADR-114: сервис worktree — тулы `git_worktree_*` (инвентарь
1195
1681
  // per-session рабочих каталогов проекта).
1196
1682
  ...(worktreeService ? { worktreeService } : {}),
1683
+ // Снимок — fallback; живой геттер читается при сборке контекста каждого
1684
+ // вызова (runtime-тумблер `background.enabled` действует без рестарта).
1197
1685
  backgroundEnabled: config.synth.background.enabled,
1686
+ getBackgroundEnabled: () => backgroundSettings.isEnabled(),
1198
1687
  // Предохранитель по объёму промпта саб-агента (`agents.subagentMaxInputTokens`).
1199
1688
  subagentMaxInputTokens: config.synth.agents.subagentMaxInputTokens,
1200
1689
  // Лимит глубины вложенности саб-агентов (`agents.subagentDepth`): при
@@ -1207,6 +1696,24 @@ executionConfig) {
1207
1696
  maxBytes: config.synth.tools.outputMaxBytes ?? DEFAULT_TOOL_OUTPUT_MAX_BYTES,
1208
1697
  },
1209
1698
  });
1699
+ // ADR-029: восстановление ожиданий подтверждения после рестарта инстанса.
1700
+ //
1701
+ // Живой реестр ожиданий живёт в памяти процесса и после рестарта пуст, а
1702
+ // вопрос пользователю — ещё актуально. Персистентная копия лежит в
1703
+ // **отдельном хранилище ожиданий** (`storage.pendingApprovals`, ADR-096) —
1704
+ // в документе сессии её быть не может (гонка lost update с точечной
1705
+ // записью истории, ADR-118 §4).
1706
+ //
1707
+ // Паттерн — тот же, что у `questionService.recoverOnStart()`: best-effort,
1708
+ // ошибка не роняет старт.
1709
+ if (!storageDegraded) {
1710
+ try {
1711
+ await orchestrator.restorePendingApprovals();
1712
+ }
1713
+ catch (err) {
1714
+ console.warn(`[permission] восстановление ожиданий подтверждения не удалось: ${err instanceof Error ? err.message : String(err)}`);
1715
+ }
1716
+ }
1210
1717
  // ADR-090 (Ф5б-2): эффективный конфиг слоя = config.yaml (+env) поверх
1211
1718
  // runtime-настроек (`settings.json`/PG): админка `/api/v2/settings/plugins`
1212
1719
  // пишет runtime, рантайм собирается при старте (применение — рестартом,
@@ -1314,6 +1821,10 @@ executionConfig) {
1314
1821
  // ADR-051 (срез) / ADR-089: правило маршрутизации cron-событий по расписанию
1315
1822
  // (паритет с core `server/app.ts`; store без дублей).
1316
1823
  eventRouter.registerRuleProvider(new SchedulerRuleProvider(scheduleStore, effectiveEvents.ephemeralTtl));
1824
+ // PROP-141 (Часть B): правило маршрутизации срабатываний таймеров/будильников.
1825
+ // Источник свой (`timer`), тип свой (`timer_fired`) — правила cron и внешних
1826
+ // событий не затрагиваются.
1827
+ eventRouter.registerRuleProvider(new TimerRuleProvider());
1317
1828
  // ADR-089: правила маршрутизации по матчу события (после scheduler).
1318
1829
  eventRouter.registerRuleProvider(new ProjectRuleProvider(routeRuleStore, effectiveEvents.ephemeralTtl));
1319
1830
  // ADR-084 × ADR-089: decision-маршрутизация при промахе декларативных правил
@@ -1344,7 +1855,9 @@ executionConfig) {
1344
1855
  // EventHub — центральный диспетчер подписок. Создаётся до funnel: колбэк
1345
1856
  // `onSessionMaterialized` подписывает клиентов владельца на сессии,
1346
1857
  // созданные после их подключения (`subscribeToSession`, ADR-089).
1347
- const eventHub = new EventHub(eventBus, sessionManager);
1858
+ // PROP-133 §6: проекты — чтобы подписка покрывала сессии всех видимых
1859
+ // проектов (не только свои).
1860
+ const eventHub = new EventHub(eventBus, sessionManager, projectStore);
1348
1861
  // ADR-089: резолвер внешнего отправителя (профиль `identities`, principalId) в
1349
1862
  // пользователя инстанса; override `identityMap` — приоритетнее профиля.
1350
1863
  // `getIdentityMap` читает актуальное значение — `onEventsChange` обновляет
@@ -1434,7 +1947,10 @@ executionConfig) {
1434
1947
  let message = eventToMessage(event);
1435
1948
  // ADR-089: для слинкованного человека `displayName` из резолвера приоритетнее
1436
1949
  // имени из `payload.from` (tg-имя). Cron (`Scheduler`) не переопределяем.
1437
- if (event.source !== 'cron' && event.identity?.principalId) {
1950
+ // PROP-141: таймер — системный автор `Timer`, его не переопределяем.
1951
+ if (event.source !== 'cron'
1952
+ && event.source !== TIMER_EVENT_SOURCE
1953
+ && event.identity?.principalId) {
1438
1954
  try {
1439
1955
  const linked = await resolveExternalIdentity(event.identity);
1440
1956
  if (linked?.displayName)
@@ -1462,6 +1978,17 @@ executionConfig) {
1462
1978
  await addEventAttachmentRefs(storageContext.blobRefs, event, message.id);
1463
1979
  }
1464
1980
  }
1981
+ else if (mode === 'steer') {
1982
+ // PROP-141 (Часть B, «Доставка»): доставка срабатывания таймера —
1983
+ // **как завершение фонового процесса** (ADR-113/ADR-104): ход идёт —
1984
+ // вклинивание в него на границе шага, хода нет — обычная очередь с
1985
+ // автоходом, фоллбек — запись в историю. Ровно одна копия в истории
1986
+ // гарантирует сам нотификатор (`createBackgroundParentNotifier`).
1987
+ //
1988
+ // Ошибка доставки **пробрасывается наружу**: движок таймеров по ней
1989
+ // ставит `outcome:'error'` (и `lastError` у записи).
1990
+ await notifyBackgroundParent(sessionId, message);
1991
+ }
1465
1992
  else {
1466
1993
  // ADR-036: `defer` тоже кладёт сообщение в историю — обфусцируем до
1467
1994
  // постановки. Старт процессора не выполняем (только очередь владельца).
@@ -1576,6 +2103,15 @@ executionConfig) {
1576
2103
  metrics: metrics ? createPipelineMetrics(metrics) : undefined,
1577
2104
  // ADR-101 §4/ADR-070: промпт шага — тем же сборщиком, что у сессий.
1578
2105
  composer: orchestrator.getComposer(),
2106
+ // IPI шага (ADR-101): тот же фильтр контента тулов, что у хода и
2107
+ // саб-агента. Конфиг — **живой** геттер оркестратора (runtime-настройка
2108
+ // безопасности применяется без рестарта), словари — порт инстанса.
2109
+ securityContentFilter: {
2110
+ getConfig: () => orchestrator.getSecurityConfig(),
2111
+ dictionaryStore,
2112
+ },
2113
+ // ADR-135/PROP-135: среда исполнения шага — та же, что у сессий.
2114
+ environmentKind: orchestrator.getEnvironmentKind(),
1579
2115
  resolveProvider: resolvePipelineProvider,
1580
2116
  resolveLlmDefaults,
1581
2117
  // ADR-115 × ADR-101: вложения прогона — тот же сервис вложений, что у
@@ -1618,6 +2154,12 @@ executionConfig) {
1618
2154
  skillsCatalog: skillService,
1619
2155
  runtimeDeps,
1620
2156
  workspacesRoot: config.workspacesRoot,
2157
+ // ADR-077/PROP-135: контур исполнения шага — те же порт и роутер, что у
2158
+ // сессий: плагинный тул получает `ctx.runtime` (PROP-138), `sandbox_exec`
2159
+ // находит пул по классу `sandbox`, а per-project монтирование PVC —
2160
+ // `executionWorkspaceSubPath` (движок считает его от `workspacesRoot`).
2161
+ executionPort,
2162
+ executionRouter,
1621
2163
  });
1622
2164
  // ADR-101/ADR-051: движок пайплайнов появился — отдаём его тулам
1623
2165
  // `pipeline_*` через рантайм автоматизации (late-bound).
@@ -1650,6 +2192,15 @@ executionConfig) {
1650
2192
  console.warn('[scheduler] leaderElection=postgres, но backend не предоставляет advisory-локи ' +
1651
2193
  '(нужен storage.backend=postgres) — используется AlwaysLeader');
1652
2194
  }
2195
+ // ADR-051/ADR-089 + PROP-141: **общий** лидер-выбор для шедулера и движка
2196
+ // таймеров. Второй лок означал бы двух владельцев (тик расписаний в одной
2197
+ // реплике, таймеров — в другой), а `FileMutex` повторно не захватывается тем
2198
+ // же экземпляром. `SharedLeader` — один лок на оба тикера.
2199
+ const sharedLeader = new SharedLeader(config.synth.scheduler.leaderElection === 'file'
2200
+ ? new FileLeader({ dataDir, tickMs: schedulerTickMs })
2201
+ : config.synth.scheduler.leaderElection === 'postgres' && storageContext.locks
2202
+ ? storageContext.locks.createLeader({ name: 'scheduler/leader', tickMs: schedulerTickMs })
2203
+ : new AlwaysLeader());
1653
2204
  const schedulerService = new SchedulerService({
1654
2205
  scheduleStore,
1655
2206
  ingress: eventIngress,
@@ -1683,17 +2234,104 @@ executionConfig) {
1683
2234
  // ADR-051/ADR-089/ADR-096: тикер стартует только у лидера (default —
1684
2235
  // AlwaysLeader). `file` — файловый лок на общем dataDir, `postgres` —
1685
2236
  // session-level advisory-lock драйвера (доступен только при PG-backend).
1686
- leader: config.synth.scheduler.leaderElection === 'file'
1687
- ? new FileLeader({ dataDir, tickMs: schedulerTickMs })
1688
- : config.synth.scheduler.leaderElection === 'postgres' && storageContext.locks
1689
- ? storageContext.locks.createLeader({ name: 'scheduler/leader', tickMs: schedulerTickMs })
1690
- : new AlwaysLeader(),
2237
+ // PROP-141: тот же лидер-выбор — и у шедулера, и у таймеров.
2238
+ leader: sharedLeader,
1691
2239
  });
2240
+ // PROP-141: бэкфилл `projectId` у легаси-расписаний (идемпотентно).
2241
+ //
2242
+ // Выполняется **до** старта шедулера: инстансных автоматизаций нет, каждое
2243
+ // расписание принадлежит проекту. Проект выводится из цели (`pipeline`/
2244
+ // `ephemeral` — из самой цели, `bound`/`queue` — у сессии-цели); вывести
2245
+ // нельзя — запись остаётся в реестре, но отключается (`project_required`)
2246
+ // и не срабатывает. Ошибка бэкфилла не роняет старт (запись не теряется).
2247
+ try {
2248
+ const backfill = await storageContext.schedules.backfillProjectIds?.();
2249
+ if (backfill && (backfill.backfilled > 0 || backfill.disabled > 0)) {
2250
+ console.warn(`[scheduler] бэкфилл проектов расписаний: проект проставлен у ${backfill.backfilled}, `
2251
+ + `отключено ${backfill.disabled}`);
2252
+ }
2253
+ }
2254
+ catch (err) {
2255
+ console.warn(`[scheduler] бэкфилл проектов расписаний не удался: ${err instanceof Error ? err.message : String(err)}`);
2256
+ }
1692
2257
  if (config.synth.scheduler.enabled !== false && !storageDegraded) {
1693
2258
  void schedulerService.start().catch((err) => {
1694
2259
  console.warn(`[scheduler] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
1695
2260
  });
1696
2261
  }
2262
+ // PROP-141 (Часть B, «Доставка»): движок таймеров/будильников.
2263
+ //
2264
+ // Доставка — **гибрид** (PROP-141, «Доставка»): журнал и дедуп — через
2265
+ // событийный контур (`EventIngress` → Router → `TimerRuleProvider`), сама
2266
+ // доставка в сессию — как завершение фонового процесса (ADR-113/ADR-104):
2267
+ // вклинивание в текущий ход, иначе очередь, иначе запись в историю.
2268
+ const timerMetrics = metrics ? createTimerMetrics(metrics) : undefined;
2269
+ const timerService = storageDegraded
2270
+ ? undefined
2271
+ : new TimerService({
2272
+ // ADR-096: порты реестра таймеров и истории срабатываний.
2273
+ timers: storageContext.timers,
2274
+ firings: storageContext.timerFirings,
2275
+ // Ошибка доставки пробрасывается наружу — движок ставит `outcome:'error'`.
2276
+ deliver: async (timer, firing, meta) => {
2277
+ const result = await eventIngress.ingest({
2278
+ source: TIMER_EVENT_SOURCE,
2279
+ type: TIMER_EVENT_TYPE,
2280
+ payload: {
2281
+ sessionId: timer.sessionId,
2282
+ timerId: timer.id,
2283
+ kind: timer.kind,
2284
+ repeat: timer.repeat.mode,
2285
+ comment: timer.comment,
2286
+ ...(timer.name ? { name: timer.name } : {}),
2287
+ scheduledFor: firing.scheduledFor,
2288
+ firedAt: firing.firedAt,
2289
+ catchup: meta.catchup,
2290
+ },
2291
+ // Дедуп по (таймер, плановое время) — повторный тик и смена лидера
2292
+ // не дают двух сообщений.
2293
+ dedupKey: `timer:${timer.id}:${firing.scheduledFor}`,
2294
+ identity: { principalId: timer.ownerId },
2295
+ });
2296
+ if (result.error)
2297
+ throw new Error(result.error);
2298
+ },
2299
+ // PROP-141: лидер тот же, что у шедулера (второго тикера нет).
2300
+ leader: sharedLeader,
2301
+ // ADR-094: метрики `synth_timer_*`.
2302
+ metrics: timerMetrics,
2303
+ // Аудит `scope:'timer'` (создание/правка/срабатывание/отмена).
2304
+ audit: securityAudit,
2305
+ // Live-события в канале сессии (ADR-009/ADR-024; новых каналов нет).
2306
+ onEvent: (sessionId, type, data) => {
2307
+ eventBus.publish(sessionId, type, data);
2308
+ },
2309
+ });
2310
+ timerServiceRef.service = timerService;
2311
+ if (timerService) {
2312
+ void timerService.start().catch((err) => {
2313
+ console.warn(`[timers] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
2314
+ });
2315
+ }
2316
+ // PROP-141 (Часть D): сервис переноса сессии между проектами — единый шов
2317
+ // для HTTP-роута `PATCH /sessions/:id { project_id }` и агентских
2318
+ // `project_attach`/`project_create`.
2319
+ const moveService = storageDegraded
2320
+ ? undefined
2321
+ : new SessionMoveService({
2322
+ sessionManager,
2323
+ backgroundRuns: storageContext.backgroundRuns,
2324
+ ...(backgroundService ? { backgroundService } : {}),
2325
+ ...(processService ? { processService } : {}),
2326
+ terminalService,
2327
+ ...(timerService ? { timerService } : {}),
2328
+ timers: storageContext.timers,
2329
+ scheduleStore,
2330
+ isTurnActive: isBackgroundTurnActive,
2331
+ eventBus,
2332
+ ...(securityAudit ? { audit: securityAudit } : {}),
2333
+ });
2334
+ moveServiceRef.service = moveService;
1697
2335
  // ADR-101/ADR-051: шедулер появился — отдаём его тулам `schedule_*`
1698
2336
  // через рантайм автоматизации (late-bound).
1699
2337
  automationRuntime.scheduler = schedulerService;
@@ -1721,6 +2359,15 @@ executionConfig) {
1721
2359
  }
1722
2360
  return {
1723
2361
  dataDir,
2362
+ // PROP-135 Ф6a: роутер портов исполнения — каталог профилей для
2363
+ // валидации `project.executor`/`settings.executorProfile` в роутах.
2364
+ executionRouter,
2365
+ // PROP-135 Ф6b-1: эффективная секция `execution` — admin-API профилей и
2366
+ // пулов (`/api/v2/execution/*`): `provider`/`pooling`/каталог профилей.
2367
+ executionConfig: execution,
2368
+ // ADR-135: секция `execution` **config-уровня** (без runtime) — база для
2369
+ // runtime-каталога профилей в `/api/v2/settings/execution` («дефолты»).
2370
+ fallbackExecutionConfig: baseExecution,
1724
2371
  // ADR-106 Ф3: реестр подтверждений (enforced-режим Authority-слоя).
1725
2372
  approvalRegistry,
1726
2373
  // ADR-096: контекст хранения инстанса — для операций, которым нужен
@@ -1748,10 +2395,28 @@ executionConfig) {
1748
2395
  defaultsStore,
1749
2396
  defaultWorkingDir,
1750
2397
  getDefaultAgentId,
2398
+ /**
2399
+ * ADR-126/ADR-069: эффективный project-trust гейт скиллов/команд/инструкций
2400
+ * (runtime > config), снятый на старте; нужен резолверу инструкций в
2401
+ * `mount-routes`.
2402
+ */
2403
+ skillsTrustedProjectDirs: effectiveSkillsTrustedProjectDirs,
1751
2404
  egressResolver,
1752
2405
  egressLogConfig,
1753
2406
  securityAudit,
1754
2407
  egressRequests,
2408
+ // PROP-136 (слайс 136a): журнал исполнений команд — роуты
2409
+ // `/api/v2/audit/commands` читают тот же экземпляр, что пишет оркестратор.
2410
+ commandAuditLog,
2411
+ // PROP-132 (Ф3в): сервис терминалов инстанса (один на процесс) + его
2412
+ // остановка на graceful shutdown (`dispose()` закрывает живые терминалы).
2413
+ terminalService,
2414
+ stopTerminalService: () => terminalService.dispose(),
2415
+ // PROP-141 (Часть D): сервис переноса сессии между проектами (роуты
2416
+ // `PATCH /sessions/:id { project_id }`).
2417
+ moveService,
2418
+ // PROP-136b (слайс 136b-2a): зеркальный чекер команд — для тестов/UI.
2419
+ commandPolicyProvider,
1755
2420
  // ADR-102 (волна 1): порт пред-агрегированных роллапов аналитики — для роутов отчётов.
1756
2421
  analyticsRollups,
1757
2422
  // ADR-102: write-path — сборщик роллапов (+ остановка hook-подписки и pruner'а).
@@ -1793,6 +2458,8 @@ executionConfig) {
1793
2458
  // PROP-097 (блок 5b): сервис фоновых шелл-процессов (+ pruner логов).
1794
2459
  processService,
1795
2460
  stopProcessLogPruner,
2461
+ // ADR-126 §5: сервис реестра скриптов проекта (HTTP-контур `/scripts*`).
2462
+ scriptService,
1796
2463
  // ADR-115: GC осиротевших вложений сообщений.
1797
2464
  stopAttachmentPruner,
1798
2465
  // ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
@@ -1802,11 +2469,18 @@ executionConfig) {
1802
2469
  // Политика ограничения контекстного окна (live, админ-API).
1803
2470
  contextWindowSettings,
1804
2471
  subagentMaxInputTokensSettings,
2472
+ // Лимит тяжёлых операций с сессиями (live, админ-API `/settings/limits`).
2473
+ sessionOpsPerMinuteSettings,
1805
2474
  // Дефолты оптимизации контекста новых сессий (live, админ-API).
1806
2475
  contextDefaultsSettings,
1807
2476
  // Instance-wide лимиты заметок сессии (live, админ-API).
1808
2477
  stickyNotesLimitsSettings,
1809
- // ADR-114: сервис worktree'ов — HTTP-контур проектов и привязка сессии.
2478
+ // PROP-124: режим инстанса для SSH-ключей (live, админ-API).
2479
+ sshModeSettings,
2480
+ // Этап 1 roadmap 0.13 (блок 4): живое состояние секции `background`
2481
+ // (сервисы/прунеры/оркестратор + админ-API `/settings/background`).
2482
+ backgroundSettings,
2483
+ // ADR-114: сервис worktree — HTTP-контур проектов и привязка сессии.
1810
2484
  worktreeService,
1811
2485
  webhookStore,
1812
2486
  webhookDeliveryStore,
@@ -1828,6 +2502,8 @@ executionConfig) {
1828
2502
  skillService,
1829
2503
  bundleStore,
1830
2504
  commandService,
2505
+ // ADR-126 §4: сервис сниппетов (`#`) — HTTP-контур `/api/v2/snippets`.
2506
+ snippetService,
1831
2507
  orchestrator,
1832
2508
  // ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
1833
2509
  // (`app.ts`/`main.ts`) и точки для HTTP API/CLI (Ф5б-2/3). `host`+`installer` внутри.
@@ -1852,6 +2528,10 @@ executionConfig) {
1852
2528
  requestSessionService,
1853
2529
  eventIngress,
1854
2530
  schedulerService,
2531
+ // PROP-141 (Часть B): движок таймеров/будильников + его остановка
2532
+ // (graceful shutdown — рядом с `stopScheduler`).
2533
+ timerService,
2534
+ stopTimerService: () => timerService?.stop(),
1855
2535
  /**
1856
2536
  * Живые (мутируемые) эффективные настройки — аксессоры, а не значения:
1857
2537
  * обновляются админкой в рантайме (`mountBackendRoutes`), читаются