@itphx/synth-backend 0.13.8 → 0.13.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/app/deps.js CHANGED
@@ -1,13 +1,19 @@
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
6
  import { existsSync } from 'node:fs';
7
7
  import { join } from 'node:path';
8
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';
9
12
  import { DEFAULT_TOOL_OUTPUT_MAX_BYTES, DEFAULT_TOOL_OUTPUT_MAX_LINES } from '@itphx/synth-shared/config';
10
- 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,
11
17
  // ADR-115: живое состояние runtime-настроек вложений (`/settings/attachments`).
12
18
  createLiveAttachmentsSettings,
13
19
  // Политика контекстного окна (`/settings/context-window`).
@@ -21,17 +27,32 @@ createLiveContextDefaults,
21
27
  // Instance-wide лимиты заметок сессии (`/settings/sticky-notes`).
22
28
  createLiveStickyNotesLimits,
23
29
  // PROP-124: режим инстанса для SSH-ключей (`/settings/ssh`).
24
- createLiveSshMode, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner,
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,
25
35
  // ADR-105 (Ф3): источник access-токена для MCP-коннекторов + OAuth-сервис.
26
- OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, detectRuntimeDeps, syncProvidersFromEnv,
36
+ OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, SnippetService, detectRuntimeDeps, syncProvidersFromEnv,
27
37
  // ADR-115 × ADR-101: доступность `ffmpeg` — обработчик вложения aux-моделью шага.
28
- 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,
29
46
  // Этап 1 roadmap 0.13 (блок 3): сервис вопросов пользователю + retention.
30
47
  QuestionService, startQuestionPruner,
31
48
  // Этап 1 roadmap 0.13 (блок 4): реестр фоновых прогонов + retention.
32
49
  BackgroundRunService, startBackgroundRunPruner, createBackgroundParentNotifier,
50
+ // PROP-143: durable-запись о прогоне, потерянном при рестарте.
51
+ appendLostRunRecords,
33
52
  // PROP-097 (блок 5b): сервис фоновых шелл-процессов + retention логов.
34
53
  ProcessService, startProcessLogPruner,
54
+ // ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск).
55
+ ScriptService,
35
56
  // ADR-115: GC осиротевших вложений сообщений.
36
57
  startAttachmentPruner,
37
58
  // ADR-115 × ADR-077: медиа-раннер (ffmpeg inline/remote) и серверные миниатюры.
@@ -49,12 +70,21 @@ startMemoryMetrics,
49
70
  createMemoryTelemetry, registerDecisionMetrics, createSchedulerMetrics,
50
71
  // ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`).
51
72
  createExecutorMetricsCollector, createWebhookMetrics, createEventMetrics,
73
+ // PROP-141 (Часть B): метрики таймеров (`synth_timer_*`, ADR-094).
74
+ createTimerMetrics,
52
75
  // ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) + установка их
53
76
  // sink'а (сервис вложений собирается внутри фабрики роутов сессий).
54
77
  createAttachmentMetrics, setAttachmentMetricsHook,
55
78
  // ADR-106 Ф1/Ф2: счётчик решений Authority-слоя (`synth_authority_decisions_total`)
56
79
  // и guard-слоя (решение считается; в enforced-режиме — применяется).
57
- 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,
58
88
  // ADR-106 Ф3: реестр подтверждений + покрытие (носитель покрывающего гранта).
59
89
  ApprovalRegistry, buildApprovalResponderProfile, createApprovalCoverageResolver, startEventJournalMetrics,
60
90
  // ADR-101 (Э5): движок пайплайнов, исполнители шагов, обработчики выходов.
@@ -66,11 +96,28 @@ PipelineRunControl, createToolStepExecutor, createScriptStepExecutor, createHuma
66
96
  createPipelineAttachmentDerive, ensureBuiltinPipelines,
67
97
  // ADR-101 §4 × `AgentDefinition`: провайдер агентского шага (код общий с core).
68
98
  resolvePipelineStepProvider, toCoreProviderConfig, ProviderFactory,
69
- // ADR-077: порт исполнения команд (inline/remote).
70
- 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,
71
114
  // ADR-090 (Ф3а) / §5, §10 (Ф5б-1): общий реестр
72
115
  // блоков промпта (композер + фасад плагинов) и рантайм плагинов.
73
- 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';
74
121
  import { EventHub } from '../events/hub.js';
75
122
  import { seedDebugTestUsers } from './bootstrap.js';
76
123
  /**
@@ -96,6 +143,14 @@ export async function createBackendStorage(config) {
96
143
  if (kind === 'memory') {
97
144
  console.warn('storage.backend=memory: данные не сохраняются на диск');
98
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
+ }
99
154
  const storage = await createStorageContextAsync(kind, {
100
155
  dataDir: config.dataDir,
101
156
  secretKey: resolveSecretKey(config.synth),
@@ -190,17 +245,37 @@ executionConfig) {
190
245
  config: config.synth.ssh?.mode,
191
246
  runtime: await settingsStore.getSshMode(),
192
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();
193
257
  // ADR-102: сборщик роллапов аналитики (write-path) — только через порт слоя
194
258
  // хранения; в деградации выключен (не пишем домен в файловый фоллбек).
195
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 = {};
196
267
  const sessionManager = new SessionManager(fileStore, {
197
268
  projectStore,
198
269
  hooks,
270
+ // PROP-141: удаление сессии снимает её автоматизации (таймеры/будильники).
271
+ onSessionDeleted: async (sessionId) => {
272
+ await timerServiceRef.service?.onSessionDeleted(sessionId);
273
+ },
199
274
  // Дефолты оптимизации контекста новых сессий (`context.defaults` + runtime).
200
275
  contextDefaults: () => contextDefaultsSettings.getDefaults(),
201
276
  // ADR-102: точка персиста сообщений (`messages_assistant`/`messages_tool`).
202
277
  analytics,
203
- // ADR-071 §2.4 / ADR-046 §4.5: системные дефолты для сессий без проекта.
278
+ // ADR-071 §2.4 / ADR-126 §11: системные дефолты для сессий без проекта.
204
279
  systemDefaultsProvider: async () => ({
205
280
  mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
206
281
  skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
@@ -235,7 +310,12 @@ executionConfig) {
235
310
  // MCP: единый источник истины — реестр `McpRegistryStore` (ADR-071 §2.5).
236
311
  // Legacy `YamlMcpConfigStore` удалён: instance-серверы из config.mcp.servers
237
312
  // сидируются в реестр при старте (seed без дублирования по имени).
238
- 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
+ });
239
319
  await mcpRegistryStore.seedFromConfig(config.synth.mcp.servers);
240
320
  // Одно чтение реестра на все карты менеджера (вместо пяти).
241
321
  const mcpMaps = await mcpRegistryStore.toManagerMaps();
@@ -430,12 +510,15 @@ executionConfig) {
430
510
  : new BackgroundRunService({
431
511
  repository: storageContext.backgroundRuns,
432
512
  eventBus,
513
+ // Снимок — fallback; живой резолвер читается на каждый запуск
514
+ // (runtime-настройка применяется без рестарта).
433
515
  limits: {
434
516
  maxSubagentsPerSession: config.synth.background.maxSubagentsPerSession,
435
517
  // PROP-097: лимит одновременных фоновых шелл-процессов на сессию.
436
518
  maxProcessesPerSession: config.synth.background.maxProcessesPerSession,
437
519
  maxRunsPerSession: config.synth.background.maxRunsPerSession,
438
520
  },
521
+ getLimits: () => backgroundSettings.getLimits(),
439
522
  // Точка сборки уведомления — здесь (глобальных синглтонов нет).
440
523
  //
441
524
  // ADR-036: обфускация user-сообщений НЕ применяется — уведомление
@@ -453,12 +536,30 @@ executionConfig) {
453
536
  // Старт: прогоны прошлого процесса не пережили рестарт (хэндлы отмены — в
454
537
  // памяти) — помечаем их `orphaned`. Best-effort: ошибка не роняет старт.
455
538
  if (backgroundService) {
539
+ let recovered = [];
456
540
  try {
457
- await backgroundService.recoverOnStart();
541
+ recovered = await backgroundService.recoverOnStart();
458
542
  }
459
543
  catch (err) {
460
544
  console.warn(`[background] восстановление фоновых прогонов не удалось: ${err instanceof Error ? err.message : String(err)}`);
461
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
+ }
462
563
  }
463
564
  /**
464
565
  * Info-блок «ход продолжен после рестарта»: пишется в историю (роль INFO — в
@@ -506,6 +607,30 @@ executionConfig) {
506
607
  // показывает активность. Восстановление отложено на 60 с, чтобы старый под
507
608
  // успел умереть, а живые маркеры работающего процесса не были сняты.
508
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
+ };
509
634
  if (!storageDegraded) {
510
635
  const bootRecovery = setTimeout(() => {
511
636
  void sessionManager.recoverInterruptedSessions()
@@ -518,14 +643,56 @@ executionConfig) {
518
643
  status: 'stopped',
519
644
  });
520
645
  eventBus.publish(r.sessionId, 'session.updated', { session_id: r.sessionId });
521
- if (!r.resumeMessage)
522
- continue;
523
- // Автопродолжение: info-блок в истории (в LLM-контекст не попадает —
524
- // роль INFO исключена из промпта) и resume-сообщение процессору.
525
- await addRestartResumedNotice(r.sessionId, r.streamId);
526
- queueManager.createProcessor(r.sessionId, sessionManager, eventBus, processMessage, {
527
- resumeMessage: r.resumeMessage,
528
- });
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
+ }
529
696
  }
530
697
  if (recovered.length) {
531
698
  console.log(`[sessions] сняты маркеры прерванных ходов: ${recovered.length}`);
@@ -551,26 +718,51 @@ executionConfig) {
551
718
  if (s.pendingMessages.length === 0)
552
719
  continue;
553
720
  queueCandidates += 1;
554
- if (s.status.queueStopped) {
555
- eventBus.publish(s.id, 'queue.stalled', {
556
- pending_count: s.pendingMessages.length,
557
- });
558
- 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);
559
762
  }
560
- // Маркеры мог снять прошлый recovery, а сообщение осталось и в
561
- // истории, и в очереди. Это прерванный in-flight ход: продолжаем
562
- // его как resume (info-блок + метка `resumed`), а не как новую
563
- // очередь — иначе сообщение материализуется в историю повторно.
564
- const resume = await sessionManager.takePendingInFlight(s.id);
565
- if (resume) {
566
- inFlightResumed += 1;
567
- await addRestartResumedNotice(s.id, resume.metadata?.stream_id);
568
- queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage, {
569
- resumeMessage: resume,
570
- });
571
- continue;
763
+ catch (err) {
764
+ console.warn(`[sessions] автозапуск очереди не выполнен: ${err instanceof Error ? err.message : String(err)}`);
572
765
  }
573
- queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage);
574
766
  }
575
767
  if (queueCandidates > 0) {
576
768
  // Только счётчики: ни id, ни содержимого сессий/сообщений.
@@ -591,14 +783,16 @@ executionConfig) {
591
783
  const stopBackgroundRunPruner = storageDegraded
592
784
  ? () => { }
593
785
  : startBackgroundRunPruner(storageContext.backgroundRuns, {
594
- getRetentionDays: () => config.synth.background.retentionDays,
786
+ // Живой резолвер: retention-настройка применяется на каждом тике.
787
+ getRetentionDays: () => backgroundSettings.getRetentionDays(),
595
788
  });
596
789
  // PROP-097 (блок 5b): retention логов фоновых процессов. Создаётся **до**
597
790
  // pruner'а записей реестра: лог удаляется, пока его запись ещё видна.
598
791
  const stopProcessLogPruner = storageDegraded
599
792
  ? () => { }
600
793
  : startProcessLogPruner(storageContext.backgroundRuns, storageContext.blobs, {
601
- getRetentionDays: () => config.synth.background.retentionDays,
794
+ // Живой резолвер: retention-настройка применяется на каждом тике.
795
+ getRetentionDays: () => backgroundSettings.getRetentionDays(),
602
796
  });
603
797
  // ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) — создаются до GC,
604
798
  // чтобы счётчик удалённых объектов был доступен при первом прогоне.
@@ -634,6 +828,15 @@ executionConfig) {
634
828
  // ADR-106 Ф1: решения Authority-слоя (`synth_authority_decisions_total`) —
635
829
  // лейблы только `action`/`effect`/`source`, без id (ADR-094).
636
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
+ });
637
840
  if (metrics) {
638
841
  // ADR-115: сервис вложений собирается внутри фабрики роутов сессий, куда
639
842
  // метрики не прокинуть — ставим хуки в sink коллектора (снимается на stop).
@@ -783,6 +986,20 @@ executionConfig) {
783
986
  // приоритетнее config.yaml — мёржим при старте, чтобы защита применялась к оркестратору.
784
987
  const runtimeSecurity = await settingsStore.getSecuritySettings();
785
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;
786
1003
  // ADR-071 §2.3: runtime-политика встроенных инструментов (админка) приоритетнее config.yaml
787
1004
  const runtimeToolsPolicy = await settingsStore.getToolsPolicy();
788
1005
  const toolsPolicy = runtimeToolsPolicy ?? config.synth.tools.policy;
@@ -792,10 +1009,10 @@ executionConfig) {
792
1009
  // ADR-071 §2.6: runtime-отключение инструментов (админка) приоритетнее config.yaml
793
1010
  const runtimeToolsDisabled = await settingsStore.getToolsDisabled();
794
1011
  const toolsDisabled = runtimeToolsDisabled ?? config.synth.tools.disabled ?? { capabilities: [], tools: [] };
795
- // ADR-046 §4.5: runtime-отключение скиллов (админка) — hard-gate системного уровня.
1012
+ // ADR-126 §11: runtime-отключение скиллов (админка) — hard-gate системного уровня.
796
1013
  const skillsDisabled = (await settingsStore.getSkillsDisabled())
797
1014
  ?? { categories: [], groups: [], skills: [] };
798
- // ADR-046/ADR-069: project-trust гейт скиллов/команд/инструкций. Runtime
1015
+ // ADR-126/ADR-069: project-trust гейт скиллов/команд/инструкций. Runtime
799
1016
  // (`settings.json`/PG) приоритетнее `config.yaml`; применяется при старте —
800
1017
  // `restartRequired` в API, инвариант 24.
801
1018
  const effectiveSkillsTrustedProjectDirs = (await settingsStore.getSkillsTrustedProjectDirs())
@@ -841,7 +1058,7 @@ executionConfig) {
841
1058
  catch (err) {
842
1059
  console.warn(`[agents] не удалось загрузить агентов из стора: ${err instanceof Error ? err.message : String(err)}`);
843
1060
  }
844
- // ADR-046: сервис скиллов (discovery + instance-запись + каталог промпта).
1061
+ // ADR-126: сервис скиллов (discovery + instance-запись + каталог промпта).
845
1062
  // ADR-116: instance-скиллы — порт слоя хранения (`storageContext.skills`):
846
1063
  // при `storage.backend=postgres` это метаданные в SQL + содержимое в blobs.
847
1064
  const skillService = new SkillService({
@@ -852,7 +1069,13 @@ executionConfig) {
852
1069
  trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
853
1070
  toolsets: config.synth.skills.toolsets,
854
1071
  });
855
- // 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).
856
1079
  const commandService = new CommandService({
857
1080
  config: {
858
1081
  dataDir,
@@ -873,24 +1096,167 @@ executionConfig) {
873
1096
  // запуска процесса (инвариант 24), поэтому порт собирается здесь, при старте.
874
1097
  // Тот же порт получают оркестратор (тулы, inline-shell, детект зависимостей)
875
1098
  // и резолвер проектных инструкций.
876
- 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));
877
1127
  // ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`) — приёмник
878
1128
  // для клиента удалённого порта (очередь, занятость, ожидание, исход).
879
1129
  const executorMetrics = metrics ? createExecutorMetricsCollector(metrics) : undefined;
880
- 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);
881
1218
  // PROP-097 (блок 5b): сервис фоновых шелл-процессов (паритет с standalone).
882
1219
  //
883
1220
  // Тот же порт исполнения, что у тулов (ADR-077): фон — это лишь способ
884
1221
  // ожидания, а не отдельный путь исполнения. Учёт прогона — общий реестр
885
1222
  // фоновых прогонов (`kind: 'process'`), лог — blob-хранилище (ADR-096).
886
1223
  // В деградированном режиме хранилища сервиса нет (писать некуда).
1224
+ //
1225
+ // Логгер сервиса: предупреждения — в вывод процесса (в journal — консоль).
1226
+ const processLogger = { warn: (message) => console.warn(message) };
887
1227
  const processService = backgroundService
888
1228
  ? new ProcessService({
889
1229
  executionPort,
890
1230
  background: backgroundService,
891
1231
  blobs: storageContext.blobs,
892
1232
  eventBus,
1233
+ // Снимок — fallback; живой предел лога читается при создании лога.
893
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
+ }),
1244
+ })
1245
+ : undefined;
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,
894
1260
  })
895
1261
  : undefined;
896
1262
  // ADR-114: сервис worktree (per-session рабочий каталог).
@@ -1110,6 +1476,18 @@ executionConfig) {
1110
1476
  ...(storageDegraded ? {} : { pendingApprovalRepository: storageContext.pendingApprovals }),
1111
1477
  // ADR-077: порт исполнения команд (inline — исполнение в процессе).
1112
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 } : {}),
1113
1491
  // ADR-102: сборщик `usage`/`decision` роллапов (write-path).
1114
1492
  analytics,
1115
1493
  // Аудит выдачи сессионных shell-грантов (паттерны команд и каталоги
@@ -1218,6 +1596,11 @@ executionConfig) {
1218
1596
  ...(config.synth.session?.autoTitle ? { autoTitle: config.synth.session.autoTitle } : {}),
1219
1597
  securityConfig,
1220
1598
  gatewayConfig,
1599
+ // PROP-136 (слайс 136a): журнал исполнений команд — тот же экземпляр
1600
+ // читает `GET /api/v2/audit/commands`.
1601
+ commandAudit: commandAuditLog,
1602
+ // PROP-136b (слайс 136b-2a): зеркальный чекер команд (нет — прежнее поведение).
1603
+ ...(commandPolicyProvider ? { commandPolicy: commandPolicyProvider } : {}),
1221
1604
  gatewayAuditLogger,
1222
1605
  gatewayPayloadLogPath,
1223
1606
  gatewayPatternStore: patternStore,
@@ -1234,7 +1617,7 @@ executionConfig) {
1234
1617
  toolsPolicy,
1235
1618
  mcpPolicy,
1236
1619
  toolsDisabled,
1237
- // ADR-046 §4.5: системный hard-gate скиллов (runtime-настройка).
1620
+ // ADR-126 §11: системный hard-gate скиллов (runtime-настройка).
1238
1621
  skillsDisabled,
1239
1622
  // ADR-070 §2.9.1: зависимости окружения (git/rg/sh) — детекция при старте.
1240
1623
  // Проба бинарников — через тот же порт исполнения (ADR-077).
@@ -1242,9 +1625,9 @@ executionConfig) {
1242
1625
  // ADR-071 §2.6: калибровка chars-per-token по модели (runtime-настройки).
1243
1626
  tokenRatioLoader: (model) => settingsStore.getTokenRatio(model),
1244
1627
  onTokenRatioCalibrated: (model, ratio) => settingsStore.setTokenRatio(model, ratio),
1245
- // ADR-046 §5: каталог скиллов в промпт + тул `skill`.
1628
+ // ADR-126 §5: каталог скиллов в промпт + тул `skill`.
1246
1629
  skillRuntime: skillService,
1247
- // ADR-046 §7: резолвинг `/`-команд до LLM.
1630
+ // ADR-126 §1: резолвинг `/`-команд до LLM.
1248
1631
  commandRuntime: commandService,
1249
1632
  // ADR-069 Фаза 1: проектные инструкции (merged chain AGENTS.md).
1250
1633
  instructionsConfig: config.synth.instructions,
@@ -1256,6 +1639,14 @@ executionConfig) {
1256
1639
  // ADR-051: late-bound резолвер активности расписания в сессии (ScheduleStore
1257
1640
  // создаётся ниже) — включает статический блок `Scheduler` в промпт.
1258
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,
1259
1650
  // ADR-101/ADR-051: late-bound рантайм автоматизации для встроенных тулов
1260
1651
  // (`pipeline_*`/`schedule_*`) — движок пайплайнов и шедулер создаются ниже,
1261
1652
  // поэтому геттер отдаёт актуальный снимок в момент хода.
@@ -1275,6 +1666,12 @@ executionConfig) {
1275
1666
  // PROP-097: сервис фоновых шелл-процессов — тот же экземпляр, что у
1276
1667
  // реестра и тула `execute_shell` (через `ctx.extra.processService`).
1277
1668
  ...(processService ? { processService } : {}),
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,
1278
1675
  // PROP-124 §0: режим инстанса для SSH-ключей (`ssh.mode`) — live-геттер:
1279
1676
  // runtime-настройка (`/api/v2/settings/ssh`) применяется без рестарта.
1280
1677
  // `tools` (дефолт) — ключ в окружение команд не попадает; `agent` — ключи
@@ -1283,7 +1680,10 @@ executionConfig) {
1283
1680
  // ADR-114: сервис worktree — тулы `git_worktree_*` (инвентарь
1284
1681
  // per-session рабочих каталогов проекта).
1285
1682
  ...(worktreeService ? { worktreeService } : {}),
1683
+ // Снимок — fallback; живой геттер читается при сборке контекста каждого
1684
+ // вызова (runtime-тумблер `background.enabled` действует без рестарта).
1286
1685
  backgroundEnabled: config.synth.background.enabled,
1686
+ getBackgroundEnabled: () => backgroundSettings.isEnabled(),
1287
1687
  // Предохранитель по объёму промпта саб-агента (`agents.subagentMaxInputTokens`).
1288
1688
  subagentMaxInputTokens: config.synth.agents.subagentMaxInputTokens,
1289
1689
  // Лимит глубины вложенности саб-агентов (`agents.subagentDepth`): при
@@ -1421,6 +1821,10 @@ executionConfig) {
1421
1821
  // ADR-051 (срез) / ADR-089: правило маршрутизации cron-событий по расписанию
1422
1822
  // (паритет с core `server/app.ts`; store без дублей).
1423
1823
  eventRouter.registerRuleProvider(new SchedulerRuleProvider(scheduleStore, effectiveEvents.ephemeralTtl));
1824
+ // PROP-141 (Часть B): правило маршрутизации срабатываний таймеров/будильников.
1825
+ // Источник свой (`timer`), тип свой (`timer_fired`) — правила cron и внешних
1826
+ // событий не затрагиваются.
1827
+ eventRouter.registerRuleProvider(new TimerRuleProvider());
1424
1828
  // ADR-089: правила маршрутизации по матчу события (после scheduler).
1425
1829
  eventRouter.registerRuleProvider(new ProjectRuleProvider(routeRuleStore, effectiveEvents.ephemeralTtl));
1426
1830
  // ADR-084 × ADR-089: decision-маршрутизация при промахе декларативных правил
@@ -1451,7 +1855,9 @@ executionConfig) {
1451
1855
  // EventHub — центральный диспетчер подписок. Создаётся до funnel: колбэк
1452
1856
  // `onSessionMaterialized` подписывает клиентов владельца на сессии,
1453
1857
  // созданные после их подключения (`subscribeToSession`, ADR-089).
1454
- const eventHub = new EventHub(eventBus, sessionManager);
1858
+ // PROP-133 §6: проекты — чтобы подписка покрывала сессии всех видимых
1859
+ // проектов (не только свои).
1860
+ const eventHub = new EventHub(eventBus, sessionManager, projectStore);
1455
1861
  // ADR-089: резолвер внешнего отправителя (профиль `identities`, principalId) в
1456
1862
  // пользователя инстанса; override `identityMap` — приоритетнее профиля.
1457
1863
  // `getIdentityMap` читает актуальное значение — `onEventsChange` обновляет
@@ -1541,7 +1947,10 @@ executionConfig) {
1541
1947
  let message = eventToMessage(event);
1542
1948
  // ADR-089: для слинкованного человека `displayName` из резолвера приоритетнее
1543
1949
  // имени из `payload.from` (tg-имя). Cron (`Scheduler`) не переопределяем.
1544
- 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) {
1545
1954
  try {
1546
1955
  const linked = await resolveExternalIdentity(event.identity);
1547
1956
  if (linked?.displayName)
@@ -1569,6 +1978,17 @@ executionConfig) {
1569
1978
  await addEventAttachmentRefs(storageContext.blobRefs, event, message.id);
1570
1979
  }
1571
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
+ }
1572
1992
  else {
1573
1993
  // ADR-036: `defer` тоже кладёт сообщение в историю — обфусцируем до
1574
1994
  // постановки. Старт процессора не выполняем (только очередь владельца).
@@ -1683,6 +2103,15 @@ executionConfig) {
1683
2103
  metrics: metrics ? createPipelineMetrics(metrics) : undefined,
1684
2104
  // ADR-101 §4/ADR-070: промпт шага — тем же сборщиком, что у сессий.
1685
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(),
1686
2115
  resolveProvider: resolvePipelineProvider,
1687
2116
  resolveLlmDefaults,
1688
2117
  // ADR-115 × ADR-101: вложения прогона — тот же сервис вложений, что у
@@ -1725,6 +2154,12 @@ executionConfig) {
1725
2154
  skillsCatalog: skillService,
1726
2155
  runtimeDeps,
1727
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,
1728
2163
  });
1729
2164
  // ADR-101/ADR-051: движок пайплайнов появился — отдаём его тулам
1730
2165
  // `pipeline_*` через рантайм автоматизации (late-bound).
@@ -1757,6 +2192,15 @@ executionConfig) {
1757
2192
  console.warn('[scheduler] leaderElection=postgres, но backend не предоставляет advisory-локи ' +
1758
2193
  '(нужен storage.backend=postgres) — используется AlwaysLeader');
1759
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());
1760
2204
  const schedulerService = new SchedulerService({
1761
2205
  scheduleStore,
1762
2206
  ingress: eventIngress,
@@ -1790,17 +2234,104 @@ executionConfig) {
1790
2234
  // ADR-051/ADR-089/ADR-096: тикер стартует только у лидера (default —
1791
2235
  // AlwaysLeader). `file` — файловый лок на общем dataDir, `postgres` —
1792
2236
  // session-level advisory-lock драйвера (доступен только при PG-backend).
1793
- leader: config.synth.scheduler.leaderElection === 'file'
1794
- ? new FileLeader({ dataDir, tickMs: schedulerTickMs })
1795
- : config.synth.scheduler.leaderElection === 'postgres' && storageContext.locks
1796
- ? storageContext.locks.createLeader({ name: 'scheduler/leader', tickMs: schedulerTickMs })
1797
- : new AlwaysLeader(),
2237
+ // PROP-141: тот же лидер-выбор — и у шедулера, и у таймеров.
2238
+ leader: sharedLeader,
1798
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
+ }
1799
2257
  if (config.synth.scheduler.enabled !== false && !storageDegraded) {
1800
2258
  void schedulerService.start().catch((err) => {
1801
2259
  console.warn(`[scheduler] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
1802
2260
  });
1803
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;
1804
2335
  // ADR-101/ADR-051: шедулер появился — отдаём его тулам `schedule_*`
1805
2336
  // через рантайм автоматизации (late-bound).
1806
2337
  automationRuntime.scheduler = schedulerService;
@@ -1828,6 +2359,15 @@ executionConfig) {
1828
2359
  }
1829
2360
  return {
1830
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,
1831
2371
  // ADR-106 Ф3: реестр подтверждений (enforced-режим Authority-слоя).
1832
2372
  approvalRegistry,
1833
2373
  // ADR-096: контекст хранения инстанса — для операций, которым нужен
@@ -1856,7 +2396,7 @@ executionConfig) {
1856
2396
  defaultWorkingDir,
1857
2397
  getDefaultAgentId,
1858
2398
  /**
1859
- * ADR-046/ADR-069: эффективный project-trust гейт скиллов/команд/инструкций
2399
+ * ADR-126/ADR-069: эффективный project-trust гейт скиллов/команд/инструкций
1860
2400
  * (runtime > config), снятый на старте; нужен резолверу инструкций в
1861
2401
  * `mount-routes`.
1862
2402
  */
@@ -1865,6 +2405,18 @@ executionConfig) {
1865
2405
  egressLogConfig,
1866
2406
  securityAudit,
1867
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,
1868
2420
  // ADR-102 (волна 1): порт пред-агрегированных роллапов аналитики — для роутов отчётов.
1869
2421
  analyticsRollups,
1870
2422
  // ADR-102: write-path — сборщик роллапов (+ остановка hook-подписки и pruner'а).
@@ -1906,6 +2458,8 @@ executionConfig) {
1906
2458
  // PROP-097 (блок 5b): сервис фоновых шелл-процессов (+ pruner логов).
1907
2459
  processService,
1908
2460
  stopProcessLogPruner,
2461
+ // ADR-126 §5: сервис реестра скриптов проекта (HTTP-контур `/scripts*`).
2462
+ scriptService,
1909
2463
  // ADR-115: GC осиротевших вложений сообщений.
1910
2464
  stopAttachmentPruner,
1911
2465
  // ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
@@ -1923,6 +2477,9 @@ executionConfig) {
1923
2477
  stickyNotesLimitsSettings,
1924
2478
  // PROP-124: режим инстанса для SSH-ключей (live, админ-API).
1925
2479
  sshModeSettings,
2480
+ // Этап 1 roadmap 0.13 (блок 4): живое состояние секции `background`
2481
+ // (сервисы/прунеры/оркестратор + админ-API `/settings/background`).
2482
+ backgroundSettings,
1926
2483
  // ADR-114: сервис worktree — HTTP-контур проектов и привязка сессии.
1927
2484
  worktreeService,
1928
2485
  webhookStore,
@@ -1945,6 +2502,8 @@ executionConfig) {
1945
2502
  skillService,
1946
2503
  bundleStore,
1947
2504
  commandService,
2505
+ // ADR-126 §4: сервис сниппетов (`#`) — HTTP-контур `/api/v2/snippets`.
2506
+ snippetService,
1948
2507
  orchestrator,
1949
2508
  // ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
1950
2509
  // (`app.ts`/`main.ts`) и точки для HTTP API/CLI (Ф5б-2/3). `host`+`installer` внутри.
@@ -1969,6 +2528,10 @@ executionConfig) {
1969
2528
  requestSessionService,
1970
2529
  eventIngress,
1971
2530
  schedulerService,
2531
+ // PROP-141 (Часть B): движок таймеров/будильников + его остановка
2532
+ // (graceful shutdown — рядом с `stopScheduler`).
2533
+ timerService,
2534
+ stopTimerService: () => timerService?.stop(),
1972
2535
  /**
1973
2536
  * Живые (мутируемые) эффективные настройки — аксессоры, а не значения:
1974
2537
  * обновляются админкой в рантайме (`mountBackendRoutes`), читаются