@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.
- package/dist/config/defaults.js +60 -14
- package/dist/config/env-overrides.d.ts +7 -4
- package/dist/config/env-overrides.js +46 -13
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +23 -4
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1565 -0
- package/dist/config/resolve.d.ts +77 -10
- package/dist/config/resolve.js +203 -17
- package/dist/config/tls-runtime.d.ts +78 -0
- package/dist/config/tls-runtime.js +356 -0
- package/dist/config/tls.d.ts +215 -0
- package/dist/config/tls.js +394 -0
- package/dist/config/types.d.ts +1820 -334
- package/dist/config/types.js +320 -54
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +18 -10
- package/dist/index.d.ts +11 -2
- package/dist/index.js +11 -2
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +230 -105
- package/dist/schemas/index.js +121 -74
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +30 -0
- package/dist/types/agent.js +1 -0
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/bus-events.d.ts +7 -0
- package/dist/types/bus-events.js +1 -0
- package/dist/types/commands.d.ts +10 -10
- package/dist/types/commands.js +2 -2
- package/dist/types/decision.d.ts +16 -16
- package/dist/types/decision.js +4 -4
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +22 -23
- package/dist/types/fs.d.ts +55 -0
- package/dist/types/fs.js +27 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +24 -4
- package/dist/types/index.d.ts +15 -1165
- package/dist/types/index.js +44 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +169 -0
- package/dist/types/mcp.js +119 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +9 -7
- package/dist/types/permission.js +1 -1
- package/dist/types/project.d.ts +134 -0
- package/dist/types/project.js +67 -0
- package/dist/types/prompt.d.ts +237 -0
- package/dist/types/prompt.js +15 -0
- package/dist/types/provider.d.ts +84 -0
- package/dist/types/provider.js +35 -0
- package/dist/types/schedules.d.ts +8 -8
- package/dist/types/schedules.js +1 -1
- package/dist/types/service-keys.d.ts +10 -10
- package/dist/types/service-keys.js +3 -3
- package/dist/types/session.d.ts +268 -0
- package/dist/types/session.js +13 -0
- package/dist/types/skills.d.ts +11 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/tools.d.ts +3 -3
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +6 -6
- package/dist/types/webhooks.js +1 -1
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.d.ts +15 -0
- package/dist/utils/index.js +55 -2
- package/dist/utils/workspace.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/dist/config/defaults.js
CHANGED
|
@@ -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 не меняется (
|
|
128
|
+
// Default OFF: дедуп in-process, поведение single-process не меняется (ADR-051/ADR-089).
|
|
120
129
|
dedupStore: 'memory',
|
|
121
|
-
// Неизвестный agentTemplate → drop с аудитом (fail-safe,
|
|
130
|
+
// Неизвестный agentTemplate → drop с аудитом (fail-safe, ADR-089).
|
|
122
131
|
unknownAgentTemplate: 'drop',
|
|
123
132
|
// Глобальный дефолт лимита запросов/мин на API-ключ привязки (0 — без лимита).
|
|
124
133
|
keyRateLimitPerMinute: 0,
|
|
125
|
-
//
|
|
134
|
+
// ADR-084 × ADR-089: decision-маршрутизация событий выключена по умолчанию (opt-in).
|
|
126
135
|
decisionRouting: false,
|
|
127
|
-
//
|
|
136
|
+
// ADR-089 (auto-bind): фоллбек-закрепление события с chatKey/threadKey за сессией — по умолчанию выключено.
|
|
128
137
|
autoBind: false,
|
|
129
138
|
autoBindAgentTemplate: '',
|
|
130
|
-
//
|
|
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 и межпроцессные локи выключены (
|
|
147
|
+
// Default OFF: leader election и межпроцессные локи выключены (ADR-051/ADR-089).
|
|
139
148
|
leaderElection: 'none',
|
|
140
149
|
crossProcessLocks: false,
|
|
141
150
|
},
|
|
142
151
|
decision: {
|
|
143
|
-
//
|
|
152
|
+
// ADR-084: decision-слой выключен по умолчанию (провайдер задаёт админ).
|
|
144
153
|
enabled: false,
|
|
145
154
|
provider: '',
|
|
146
155
|
model: '',
|
|
147
156
|
confidenceThreshold: 0.6,
|
|
148
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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-оверрайдов скалярных ключей вложенных секций (
|
|
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
|
-
/**
|
|
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
|
-
*
|
|
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 (
|
|
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
|
-
*
|
|
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
|
-
* Приоритет (
|
|
11
|
+
* Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
|
|
12
12
|
*/
|
|
13
13
|
import { bootstrapServiceKeysSchema } from './types.js';
|
|
14
14
|
/**
|
|
15
|
-
* Реестр env-оверрайдов скалярных ключей вложенных секций (
|
|
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 (
|
|
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 (
|
|
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 (
|
|
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
|
-
//
|
|
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
|
-
/**
|
|
71
|
+
/**
|
|
72
|
+
* Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
|
|
73
|
+
* вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
|
|
74
|
+
*/
|
|
56
75
|
export function envOverrideName(def) {
|
|
57
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
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 (
|
|
159
|
+
* скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
|
|
127
160
|
* Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
|
|
128
161
|
* (передаётся из env/Secret).
|
|
129
162
|
*/
|
package/dist/config/index.d.ts
CHANGED
package/dist/config/index.js
CHANGED
package/dist/config/loader.d.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import { type SynthConfig } from './types.js';
|
|
2
2
|
export interface LoadConfigOptions {
|
|
3
3
|
configPath?: string;
|
|
4
|
-
/**
|
|
4
|
+
/** ADR-079: home-каталог — конфиг резолвится как `<home>/config.yaml`, если path не задан. */
|
|
5
5
|
home?: string;
|
|
6
6
|
overrides?: Partial<SynthConfig>;
|
|
7
|
-
/**
|
|
7
|
+
/** ADR-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
|
|
8
8
|
env?: NodeJS.ProcessEnv;
|
|
9
9
|
}
|
|
10
10
|
export declare function loadConfig(options?: LoadConfigOptions): Promise<SynthConfig>;
|
package/dist/config/loader.js
CHANGED
|
@@ -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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|