@itphx/synth-shared 0.10.0 → 0.11.3

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 (83) hide show
  1. package/dist/config/defaults.js +60 -14
  2. package/dist/config/env-overrides.d.ts +7 -4
  3. package/dist/config/env-overrides.js +46 -13
  4. package/dist/config/index.d.ts +3 -0
  5. package/dist/config/index.js +3 -0
  6. package/dist/config/loader.d.ts +2 -2
  7. package/dist/config/loader.js +23 -4
  8. package/dist/config/proxy.d.ts +415 -0
  9. package/dist/config/proxy.js +1565 -0
  10. package/dist/config/resolve.d.ts +77 -10
  11. package/dist/config/resolve.js +203 -17
  12. package/dist/config/tls-runtime.d.ts +78 -0
  13. package/dist/config/tls-runtime.js +356 -0
  14. package/dist/config/tls.d.ts +215 -0
  15. package/dist/config/tls.js +394 -0
  16. package/dist/config/types.d.ts +1820 -334
  17. package/dist/config/types.js +320 -54
  18. package/dist/i18n/index.d.ts +1 -1
  19. package/dist/i18n/index.js +18 -10
  20. package/dist/index.d.ts +11 -2
  21. package/dist/index.js +11 -2
  22. package/dist/interfaces/index.d.ts +3 -3
  23. package/dist/protocols/index.d.ts +0 -1
  24. package/dist/schemas/index.d.ts +230 -105
  25. package/dist/schemas/index.js +121 -74
  26. package/dist/skills/frontmatter.js +1 -1
  27. package/dist/types/agent.d.ts +30 -0
  28. package/dist/types/agent.js +1 -0
  29. package/dist/types/analytics.d.ts +113 -0
  30. package/dist/types/analytics.js +61 -0
  31. package/dist/types/bus-events.d.ts +7 -0
  32. package/dist/types/bus-events.js +1 -0
  33. package/dist/types/commands.d.ts +10 -10
  34. package/dist/types/commands.js +2 -2
  35. package/dist/types/decision.d.ts +16 -16
  36. package/dist/types/decision.js +4 -4
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +22 -23
  40. package/dist/types/fs.d.ts +55 -0
  41. package/dist/types/fs.js +27 -0
  42. package/dist/types/git.d.ts +63 -0
  43. package/dist/types/git.js +1 -0
  44. package/dist/types/hooks.d.ts +24 -4
  45. package/dist/types/index.d.ts +15 -1165
  46. package/dist/types/index.js +44 -244
  47. package/dist/types/llm.d.ts +32 -0
  48. package/dist/types/llm.js +8 -0
  49. package/dist/types/maintenance.d.ts +39 -0
  50. package/dist/types/maintenance.js +11 -0
  51. package/dist/types/mcp.d.ts +169 -0
  52. package/dist/types/mcp.js +119 -0
  53. package/dist/types/message.d.ts +63 -0
  54. package/dist/types/message.js +12 -0
  55. package/dist/types/permission.d.ts +9 -7
  56. package/dist/types/permission.js +1 -1
  57. package/dist/types/project.d.ts +134 -0
  58. package/dist/types/project.js +67 -0
  59. package/dist/types/prompt.d.ts +237 -0
  60. package/dist/types/prompt.js +15 -0
  61. package/dist/types/provider.d.ts +84 -0
  62. package/dist/types/provider.js +35 -0
  63. package/dist/types/schedules.d.ts +8 -8
  64. package/dist/types/schedules.js +1 -1
  65. package/dist/types/service-keys.d.ts +10 -10
  66. package/dist/types/service-keys.js +3 -3
  67. package/dist/types/session.d.ts +268 -0
  68. package/dist/types/session.js +13 -0
  69. package/dist/types/skills.d.ts +11 -11
  70. package/dist/types/skills.js +6 -6
  71. package/dist/types/tools.d.ts +3 -3
  72. package/dist/types/user.d.ts +113 -0
  73. package/dist/types/user.js +31 -0
  74. package/dist/types/webhooks.d.ts +6 -6
  75. package/dist/types/webhooks.js +1 -1
  76. package/dist/utils/glob.d.ts +1 -1
  77. package/dist/utils/glob.js +1 -1
  78. package/dist/utils/index.d.ts +15 -0
  79. package/dist/utils/index.js +55 -2
  80. package/dist/utils/workspace.js +1 -1
  81. package/dist/version.d.ts +1 -1
  82. package/dist/version.js +1 -1
  83. package/package.json +1 -1
@@ -1,4 +1,5 @@
1
- import { DEFAULT_MCP_PRIVATE_CIDRS } from '../types/index.js';
1
+ import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, } from '../types/index.js';
2
+ import { DEFAULT_MAX_UPLOAD_BYTES } from '../types/index.js';
2
3
  export const defaultConfig = {
3
4
  server: {
4
5
  host: '0.0.0.0',
@@ -8,9 +9,16 @@ export const defaultConfig = {
8
9
  },
9
10
  storage: {
10
11
  dataDir: '/var/synth/data',
12
+ backend: 'file',
13
+ // PROP-032: параметры PostgreSQL-backend (пусто — драйвер берёт дефолты/env).
14
+ postgres: {},
15
+ // PROP-032 (задел W5): при недоступности backend — файловый фоллбек в {dataDir}/fallback.
16
+ degradedMode: 'fallback-file',
17
+ fallbackDir: '',
11
18
  workspacesRoot: '',
12
19
  defaultWorkspace: '',
13
20
  workspaceOutsideRoot: '',
21
+ maxUploadBytes: DEFAULT_MAX_UPLOAD_BYTES,
14
22
  },
15
23
  auth: {
16
24
  debugMode: false,
@@ -84,6 +92,7 @@ export const defaultConfig = {
84
92
  networkPolicy: {
85
93
  mode: 'deny',
86
94
  list: [...DEFAULT_MCP_PRIVATE_CIDRS],
95
+ exceptions: [],
87
96
  },
88
97
  },
89
98
  tools: {
@@ -116,18 +125,18 @@ export const defaultConfig = {
116
125
  ephemeralTtl: '24h',
117
126
  journalRetentionDays: 30,
118
127
  allowedSources: [],
119
- // Default OFF: дедуп in-process, поведение single-process не меняется (AD-051/AD-089).
128
+ // Default OFF: дедуп in-process, поведение single-process не меняется (ADR-051/ADR-089).
120
129
  dedupStore: 'memory',
121
- // Неизвестный agentTemplate → drop с аудитом (fail-safe, AD-089).
130
+ // Неизвестный agentTemplate → drop с аудитом (fail-safe, ADR-089).
122
131
  unknownAgentTemplate: 'drop',
123
132
  // Глобальный дефолт лимита запросов/мин на API-ключ привязки (0 — без лимита).
124
133
  keyRateLimitPerMinute: 0,
125
- // AD-084 × AD-089: decision-маршрутизация событий выключена по умолчанию (opt-in).
134
+ // ADR-084 × ADR-089: decision-маршрутизация событий выключена по умолчанию (opt-in).
126
135
  decisionRouting: false,
127
- // AD-089 (auto-bind): фоллбек-закрепление события с chatKey/threadKey за сессией — по умолчанию выключено.
136
+ // ADR-089 (auto-bind): фоллбек-закрепление события с chatKey/threadKey за сессией — по умолчанию выключено.
128
137
  autoBind: false,
129
138
  autoBindAgentTemplate: '',
130
- // AD-089: маппинг идентичности отправителя события на владельца сессии (пусто — не переопределяется).
139
+ // ADR-089: маппинг идентичности отправителя события на владельца сессии (пусто — не переопределяется).
131
140
  identityMap: {},
132
141
  },
133
142
  scheduler: {
@@ -135,27 +144,49 @@ export const defaultConfig = {
135
144
  tickSec: 60,
136
145
  catchUp: 'skip',
137
146
  jobRetentionDays: 30,
138
- // Default OFF: leader election и межпроцессные локи выключены (AD-051/AD-089).
147
+ // Default OFF: leader election и межпроцессные локи выключены (ADR-051/ADR-089).
139
148
  leaderElection: 'none',
140
149
  crossProcessLocks: false,
141
150
  },
142
151
  decision: {
143
- // AD-084: decision-слой выключен по умолчанию (провайдер задаёт админ).
152
+ // ADR-084: decision-слой выключен по умолчанию (провайдер задаёт админ).
144
153
  enabled: false,
145
154
  provider: '',
146
155
  model: '',
147
156
  confidenceThreshold: 0.6,
148
- // AD-084: тир эскалации не задан (пусто — эскалации нет).
157
+ // ADR-084: тир эскалации не задан (пусто — эскалации нет).
149
158
  escalationProvider: '',
150
159
  escalationModel: '',
151
160
  },
161
+ analytics: {
162
+ // PROP-102: срок хранения суточных роллапов — 400 дней (<= 0 — без ограничения).
163
+ retentionDays: 400,
164
+ },
165
+ metrics: {
166
+ // ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
167
+ enabled: false,
168
+ },
169
+ egress: {
170
+ // Политика встроенных инструментов: deny приватных/служебных диапазонов.
171
+ tools: {
172
+ mode: DEFAULT_EGRESS_TOOLS_POLICY.mode,
173
+ list: [...DEFAULT_EGRESS_TOOLS_POLICY.list],
174
+ exceptions: [],
175
+ },
176
+ // Политика webhooks: deny приватных + обязательный https (`off` — dev).
177
+ webhooks: {
178
+ mode: DEFAULT_EGRESS_WEBHOOKS_POLICY.mode,
179
+ list: [...DEFAULT_EGRESS_WEBHOOKS_POLICY.list],
180
+ exceptions: [],
181
+ },
182
+ // Журнал внешних запросов: включён, retention 7 дней (0 — без очистки).
183
+ log: { ...DEFAULT_EGRESS_LOG },
184
+ },
152
185
  webhooks: {
153
- // AD-052 (этап II): доставка webhooks выключена по умолчанию (opt-in).
186
+ // ADR-052 (этап II): доставка webhooks выключена по умолчанию (opt-in).
154
187
  enabled: false,
155
188
  maxAttempts: 5,
156
189
  timeoutMs: 10_000,
157
- // Только https и публичные адреса; приватные/loopback — запрещены (SSRF).
158
- allowPrivateTargets: false,
159
190
  deliveryRetentionDays: 30,
160
191
  },
161
192
  instructions: {
@@ -212,6 +243,18 @@ export const defaultConfig = {
212
243
  provider: '',
213
244
  },
214
245
  },
246
+ proxy: {
247
+ // ADR-099 (D1): прокси выключен по умолчанию (поведение не меняется).
248
+ // `enabled` намеренно не задан: явный `false` в config.yaml подавляет
249
+ // стандартные HTTP_PROXY/…, а отсутствие — позволяет включиться из env.
250
+ // `profiles`/`rules` намеренно не заданы: отсутствие = legacy-поведение
251
+ // (top-level URL + синтетический профиль `default`).
252
+ mode: 'all',
253
+ noProxy: [],
254
+ fromEnv: true,
255
+ fallbackDirect: false,
256
+ connectTimeoutMs: 10_000,
257
+ },
215
258
  remote: {
216
259
  enabled: false,
217
260
  backendUrl: '',
@@ -259,9 +302,12 @@ export const defaultConfig = {
259
302
  protectedPaths: {
260
303
  enabled: true,
261
304
  },
262
- // Пусто — core использует файл {dataDir}/secrets/master.key (AD-076).
305
+ // ADR-099: доверие TLS/CA исходящих соединений. Пусто — системное доверие
306
+ // (поведение не меняется); caFile — корпоративный CA, cert/key — mTLS.
307
+ tls: {},
308
+ // Пусто — core использует файл {dataDir}/secrets/master.key (ADR-076).
263
309
  secretKey: '',
264
- // AD-052/O1: installer service-key'и из env/Secret (по умолчанию нет).
310
+ // ADR-052/O1: installer service-key'и из env/Secret (по умолчанию нет).
265
311
  bootstrapServiceKeys: [],
266
312
  },
267
313
  };
@@ -8,7 +8,7 @@ export interface EnvOverrideDefinition {
8
8
  type: EnvOverrideType;
9
9
  }
10
10
  /**
11
- * Реестр env-оверрайдов скалярных ключей вложенных секций (AD-023).
11
+ * Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
12
12
  *
13
13
  * Объектные/нескалярные ключи (`events.allowedSources`, `events.identityMap`,
14
14
  * `events.dedupStore`, `events.unknownAgentTemplate`, `scheduler.leaderElection`,
@@ -18,7 +18,10 @@ export interface EnvOverrideDefinition {
18
18
  export declare const ENV_OVERRIDES: readonly EnvOverrideDefinition[];
19
19
  /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
20
20
  export declare function toSnakeCase(value: string): string;
21
- /** Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. */
21
+ /**
22
+ * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
23
+ * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
24
+ */
22
25
  export declare function envOverrideName(def: EnvOverrideDefinition): string;
23
26
  export type ParsedEnvValue = {
24
27
  ok: true;
@@ -47,10 +50,10 @@ export declare function parseEnvValue(raw: string, type: EnvOverrideType): Parse
47
50
  */
48
51
  export declare function applyEnvOverrides<T extends Record<string, unknown>>(config: T, env?: NodeJS.ProcessEnv): T;
49
52
  /**
50
- * AD-052/O1: env-имя JSON-списка installer service-key'ев
53
+ * ADR-052/O1: env-имя JSON-списка installer service-key'ев
51
54
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
52
55
  * `{ label, secret, scopes, roles?, description? }`. Приоритет — как у
53
- * скалярных env-оверрайдов: env > config.yaml (AD-023), но выше CLI-overrides.
56
+ * скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
54
57
  * Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
55
58
  * (передаётся из env/Secret).
56
59
  */
@@ -1,5 +1,5 @@
1
1
  /**
2
- * AD-023: декларативные env-оверрайды скалярных ключей конфигурации.
2
+ * ADR-023: декларативные env-оверрайды скалярных ключей конфигурации.
3
3
  *
4
4
  * Имя переменной собирается по правилу `SYNTH_<SECTION>_<KEY>`, где camelCase
5
5
  * ключа переводится в SNAKE_CASE (`autoBind` → `SYNTH_EVENTS_AUTO_BIND`,
@@ -8,11 +8,11 @@
8
8
  * после слияния defaults + config.yaml и до CLI-overrides), поэтому все
9
9
  * потребители `@itphx/synth-shared/config` получают поддержку автоматически.
10
10
  *
11
- * Приоритет (AD-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
11
+ * Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
12
12
  */
13
13
  import { bootstrapServiceKeysSchema } from './types.js';
14
14
  /**
15
- * Реестр env-оверрайдов скалярных ключей вложенных секций (AD-023).
15
+ * Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
16
16
  *
17
17
  * Объектные/нескалярные ключи (`events.allowedSources`, `events.identityMap`,
18
18
  * `events.dedupStore`, `events.unknownAgentTemplate`, `scheduler.leaderElection`,
@@ -20,7 +20,7 @@ import { bootstrapServiceKeysSchema } from './types.js';
20
20
  * плоского строкового представления — они остаются в config.yaml.
21
21
  */
22
22
  export const ENV_OVERRIDES = [
23
- // events (AD-089)
23
+ // events (ADR-089)
24
24
  { section: 'events', key: 'enabled', type: 'boolean' },
25
25
  { section: 'events', key: 'defaultMode', type: 'string' },
26
26
  { section: 'events', key: 'ephemeralTtl', type: 'string' },
@@ -29,32 +29,52 @@ export const ENV_OVERRIDES = [
29
29
  { section: 'events', key: 'decisionRouting', type: 'boolean' },
30
30
  { section: 'events', key: 'autoBind', type: 'boolean' },
31
31
  { section: 'events', key: 'autoBindAgentTemplate', type: 'string' },
32
- // scheduler (AD-051 срез / AD-089)
32
+ // scheduler (ADR-051 срез / ADR-089)
33
33
  { section: 'scheduler', key: 'enabled', type: 'boolean' },
34
34
  { section: 'scheduler', key: 'tickSec', type: 'number' },
35
35
  { section: 'scheduler', key: 'catchUp', type: 'string' },
36
36
  { section: 'scheduler', key: 'jobRetentionDays', type: 'number' },
37
- // webhooks (AD-052, этап II)
37
+ // webhooks (ADR-052, этап II)
38
38
  { section: 'webhooks', key: 'enabled', type: 'boolean' },
39
39
  { section: 'webhooks', key: 'maxAttempts', type: 'number' },
40
40
  { section: 'webhooks', key: 'timeoutMs', type: 'number' },
41
- { section: 'webhooks', key: 'allowPrivateTargets', type: 'boolean' },
42
41
  { section: 'webhooks', key: 'deliveryRetentionDays', type: 'number' },
43
- // decision (AD-084)
42
+ // egress (настраиваемая политика + журнал): только скалярные ключи.
43
+ { section: 'egress', key: 'tools.mode', type: 'string' },
44
+ { section: 'egress', key: 'webhooks.mode', type: 'string' },
45
+ { section: 'egress', key: 'log.enabled', type: 'boolean' },
46
+ { section: 'egress', key: 'log.retentionDays', type: 'number' },
47
+ // proxy (ADR-099, D1): скалярные ключи секции; списки (noProxy) — в config/env.
48
+ { section: 'proxy', key: 'enabled', type: 'boolean' },
49
+ { section: 'proxy', key: 'url', type: 'string' },
50
+ { section: 'proxy', key: 'httpProxy', type: 'string' },
51
+ { section: 'proxy', key: 'httpsProxy', type: 'string' },
52
+ { section: 'proxy', key: 'allProxy', type: 'string' },
53
+ { section: 'proxy', key: 'fallbackDirect', type: 'boolean' },
54
+ { section: 'proxy', key: 'connectTimeoutMs', type: 'number' },
55
+ // decision (ADR-084)
44
56
  { section: 'decision', key: 'enabled', type: 'boolean' },
45
57
  { section: 'decision', key: 'provider', type: 'string' },
46
58
  { section: 'decision', key: 'model', type: 'string' },
47
59
  { section: 'decision', key: 'confidenceThreshold', type: 'number' },
48
60
  { section: 'decision', key: 'escalationProvider', type: 'string' },
49
61
  { section: 'decision', key: 'escalationModel', type: 'string' },
62
+ // analytics (PROP-102)
63
+ { section: 'analytics', key: 'retentionDays', type: 'number' },
64
+ // metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
65
+ { section: 'metrics', key: 'enabled', type: 'boolean' },
50
66
  ];
51
67
  /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
52
68
  export function toSnakeCase(value) {
53
69
  return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
54
70
  }
55
- /** Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. */
71
+ /**
72
+ * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
73
+ * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
74
+ */
56
75
  export function envOverrideName(def) {
57
- return `SYNTH_${toSnakeCase(def.section)}_${toSnakeCase(def.key)}`;
76
+ const key = def.key.split('.').map(toSnakeCase).join('_');
77
+ return `SYNTH_${toSnakeCase(def.section)}_${key}`;
58
78
  }
59
79
  /**
60
80
  * Парсинг env-строки по типу ключа:
@@ -114,16 +134,29 @@ export function applyEnvOverrides(config, env = process.env) {
114
134
  const section = current !== null && typeof current === 'object' && !Array.isArray(current)
115
135
  ? { ...current }
116
136
  : {};
117
- section[def.key] = parsed.value;
137
+ // `key` может быть вложенным (`log.enabled`): клонируем промежуточные объекты,
138
+ // чтобы не мутировать defaultConfig.
139
+ const path = def.key.split('.');
140
+ let target = section;
141
+ for (let i = 0; i < path.length - 1; i += 1) {
142
+ const part = path[i];
143
+ const child = target[part];
144
+ const copy = child !== null && typeof child === 'object' && !Array.isArray(child)
145
+ ? { ...child }
146
+ : {};
147
+ target[part] = copy;
148
+ target = copy;
149
+ }
150
+ target[path[path.length - 1]] = parsed.value;
118
151
  config[def.section] = section;
119
152
  }
120
153
  return config;
121
154
  }
122
155
  /**
123
- * AD-052/O1: env-имя JSON-списка installer service-key'ев
156
+ * ADR-052/O1: env-имя JSON-списка installer service-key'ев
124
157
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
125
158
  * `{ label, secret, scopes, roles?, description? }`. Приоритет — как у
126
- * скалярных env-оверрайдов: env > config.yaml (AD-023), но выше CLI-overrides.
159
+ * скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
127
160
  * Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
128
161
  * (передаётся из env/Secret).
129
162
  */
@@ -4,3 +4,6 @@ export * from './loader.js';
4
4
  export * from './env-overrides.js';
5
5
  export * from './merge.js';
6
6
  export * from './resolve.js';
7
+ export * from './tls.js';
8
+ export * from './tls-runtime.js';
9
+ export * from './proxy.js';
@@ -4,3 +4,6 @@ export * from './loader.js';
4
4
  export * from './env-overrides.js';
5
5
  export * from './merge.js';
6
6
  export * from './resolve.js';
7
+ export * from './tls.js';
8
+ export * from './tls-runtime.js';
9
+ export * from './proxy.js';
@@ -1,10 +1,10 @@
1
1
  import { type SynthConfig } from './types.js';
2
2
  export interface LoadConfigOptions {
3
3
  configPath?: string;
4
- /** AD-079: home-каталог — конфиг резолвится как `<home>/config.yaml`, если path не задан. */
4
+ /** ADR-079: home-каталог — конфиг резолвится как `<home>/config.yaml`, если path не задан. */
5
5
  home?: string;
6
6
  overrides?: Partial<SynthConfig>;
7
- /** AD-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
7
+ /** ADR-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
8
8
  env?: NodeJS.ProcessEnv;
9
9
  }
10
10
  export declare function loadConfig(options?: LoadConfigOptions): Promise<SynthConfig>;
@@ -14,7 +14,7 @@ const SYSTEM_CONFIG_PATH = '/etc/synth/config.yaml';
14
14
  function searchPaths(explicitPath, home) {
15
15
  if (explicitPath)
16
16
  return [explicitPath];
17
- // AD-079: при заданном home конфиг ищется строго в <home>/config.yaml
17
+ // ADR-079: при заданном home конфиг ищется строго в <home>/config.yaml
18
18
  // (home приоритетнее cwd/XDG-цепочки).
19
19
  if (home)
20
20
  return [join(home, 'config.yaml')];
@@ -41,8 +41,26 @@ async function tryReadYaml(path) {
41
41
  return null;
42
42
  }
43
43
  }
44
+ /**
45
+ * Fail-closed миграция: удалённый `webhooks.allowPrivateTargets` больше не
46
+ * читается. Присутствие ключа в config.yaml — warn с указанием замены
47
+ * (`egress.webhooks.mode: 'off'`), значение игнорируется.
48
+ */
49
+ function warnLegacyKeys(fileConfig, env) {
50
+ const webhooks = fileConfig.webhooks;
51
+ if (webhooks && typeof webhooks === 'object' && !Array.isArray(webhooks)) {
52
+ if (Object.prototype.hasOwnProperty.call(webhooks, 'allowPrivateTargets')) {
53
+ console.warn('[config] webhooks.allowPrivateTargets удалён и игнорируется — используйте ' +
54
+ "egress.webhooks.mode: 'off' (dev) либо список исключений egress.webhooks.exceptions");
55
+ }
56
+ }
57
+ if (env.SYNTH_WEBHOOKS_ALLOW_PRIVATE_TARGETS !== undefined) {
58
+ console.warn('[config] SYNTH_WEBHOOKS_ALLOW_PRIVATE_TARGETS удалён и игнорируется — используйте ' +
59
+ "SYNTH_EGRESS_WEBHOOKS_MODE=off (dev)");
60
+ }
61
+ }
44
62
  export async function loadConfig(options = {}) {
45
- // AD-023/AD-071: явный путь — из опций, иначе из SYNTH_CONFIG (как в
63
+ // ADR-023/ADR-071: явный путь — из опций, иначе из SYNTH_CONFIG (как в
46
64
  // findConfigPath). Без этого dev-запуск backend с cwd=synth/ не читал
47
65
  // packages/backend/config.yaml (mcp.servers) и seed реестра был пустым.
48
66
  const explicitPath = options.configPath ?? process.env.SYNTH_CONFIG;
@@ -55,12 +73,13 @@ export async function loadConfig(options = {}) {
55
73
  break;
56
74
  }
57
75
  }
76
+ warnLegacyKeys(fileConfig, options.env ?? process.env);
58
77
  const merged = deepMerge(defaultConfig, fileConfig);
59
- // AD-023: env-оверрайды скалярных ключей вложенных секций применяются одним
78
+ // ADR-023: env-оверрайды скалярных ключей вложенных секций применяются одним
60
79
  // местом — поверх defaults + config.yaml и ниже CLI-overrides
61
80
  // (приоритет: CLI > env > config.yaml > defaults).
62
81
  const withEnv = applyEnvOverrides(merged, options.env ?? process.env);
63
- // AD-052/O1: объектный env-оверрайд installer service-key'ев
82
+ // ADR-052/O1: объектный env-оверрайд installer service-key'ев
64
83
  // (`SYNTH_BOOTSTRAP_SERVICE_KEYS`, JSON) — там же, до CLI-overrides.
65
84
  applyObjectEnvOverrides(withEnv, options.env ?? process.env);
66
85
  const finalConfig = options.overrides