@itphx/synth-shared 0.9.0 → 0.10.1

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 (72) hide show
  1. package/dist/config/defaults.js +51 -1
  2. package/dist/config/env-overrides.d.ts +68 -0
  3. package/dist/config/env-overrides.js +165 -0
  4. package/dist/config/index.d.ts +1 -0
  5. package/dist/config/index.js +1 -0
  6. package/dist/config/loader.d.ts +3 -1
  7. package/dist/config/loader.js +12 -4
  8. package/dist/config/resolve.d.ts +23 -6
  9. package/dist/config/resolve.js +33 -12
  10. package/dist/config/types.d.ts +699 -146
  11. package/dist/config/types.js +195 -28
  12. package/dist/i18n/index.d.ts +1 -1
  13. package/dist/i18n/index.js +50 -8
  14. package/dist/index.d.ts +4 -2
  15. package/dist/index.js +3 -2
  16. package/dist/interfaces/index.d.ts +8 -1
  17. package/dist/schemas/index.d.ts +1723 -45
  18. package/dist/schemas/index.js +403 -29
  19. package/dist/skills/frontmatter.js +1 -1
  20. package/dist/types/agent.d.ts +30 -0
  21. package/dist/types/agent.js +1 -0
  22. package/dist/types/bus-events.d.ts +7 -0
  23. package/dist/types/bus-events.js +1 -0
  24. package/dist/types/commands.d.ts +10 -10
  25. package/dist/types/commands.js +2 -2
  26. package/dist/types/decision.d.ts +502 -0
  27. package/dist/types/decision.js +98 -0
  28. package/dist/types/events.d.ts +219 -0
  29. package/dist/types/events.js +1 -0
  30. package/dist/types/fs.d.ts +44 -0
  31. package/dist/types/fs.js +16 -0
  32. package/dist/types/git.d.ts +63 -0
  33. package/dist/types/git.js +1 -0
  34. package/dist/types/hooks.d.ts +96 -0
  35. package/dist/types/hooks.js +1 -0
  36. package/dist/types/index.d.ts +18 -1097
  37. package/dist/types/index.js +44 -215
  38. package/dist/types/llm.d.ts +32 -0
  39. package/dist/types/llm.js +8 -0
  40. package/dist/types/mcp.d.ts +104 -0
  41. package/dist/types/mcp.js +40 -0
  42. package/dist/types/message.d.ts +63 -0
  43. package/dist/types/message.js +12 -0
  44. package/dist/types/permission.d.ts +2 -2
  45. package/dist/types/permission.js +1 -1
  46. package/dist/types/project.d.ts +134 -0
  47. package/dist/types/project.js +67 -0
  48. package/dist/types/prompt.d.ts +236 -0
  49. package/dist/types/prompt.js +15 -0
  50. package/dist/types/provider.d.ts +84 -0
  51. package/dist/types/provider.js +35 -0
  52. package/dist/types/schedules.d.ts +109 -0
  53. package/dist/types/schedules.js +9 -0
  54. package/dist/types/service-keys.d.ts +106 -0
  55. package/dist/types/service-keys.js +72 -0
  56. package/dist/types/session.d.ts +269 -0
  57. package/dist/types/session.js +13 -0
  58. package/dist/types/skills.d.ts +11 -11
  59. package/dist/types/skills.js +6 -6
  60. package/dist/types/tools.d.ts +4 -3
  61. package/dist/types/tools.js +2 -0
  62. package/dist/types/user.d.ts +113 -0
  63. package/dist/types/user.js +31 -0
  64. package/dist/types/webhooks.d.ts +97 -0
  65. package/dist/types/webhooks.js +53 -0
  66. package/dist/utils/glob.d.ts +1 -1
  67. package/dist/utils/glob.js +1 -1
  68. package/dist/utils/index.js +2 -2
  69. package/dist/utils/workspace.js +1 -1
  70. package/dist/version.d.ts +1 -1
  71. package/dist/version.js +1 -1
  72. package/package.json +1 -1
@@ -110,6 +110,54 @@ export const defaultConfig = {
110
110
  maxArgumentsLength: 10_000,
111
111
  maxRenderedBytes: 200_000,
112
112
  },
113
+ events: {
114
+ enabled: true,
115
+ defaultMode: 'bound',
116
+ ephemeralTtl: '24h',
117
+ journalRetentionDays: 30,
118
+ allowedSources: [],
119
+ // Default OFF: дедуп in-process, поведение single-process не меняется (ADR-051/ADR-089).
120
+ dedupStore: 'memory',
121
+ // Неизвестный agentTemplate → drop с аудитом (fail-safe, ADR-089).
122
+ unknownAgentTemplate: 'drop',
123
+ // Глобальный дефолт лимита запросов/мин на API-ключ привязки (0 — без лимита).
124
+ keyRateLimitPerMinute: 0,
125
+ // ADR-084 × ADR-089: decision-маршрутизация событий выключена по умолчанию (opt-in).
126
+ decisionRouting: false,
127
+ // ADR-089 (auto-bind): фоллбек-закрепление события с chatKey/threadKey за сессией — по умолчанию выключено.
128
+ autoBind: false,
129
+ autoBindAgentTemplate: '',
130
+ // ADR-089: маппинг идентичности отправителя события на владельца сессии (пусто — не переопределяется).
131
+ identityMap: {},
132
+ },
133
+ scheduler: {
134
+ enabled: true,
135
+ tickSec: 60,
136
+ catchUp: 'skip',
137
+ jobRetentionDays: 30,
138
+ // Default OFF: leader election и межпроцессные локи выключены (ADR-051/ADR-089).
139
+ leaderElection: 'none',
140
+ crossProcessLocks: false,
141
+ },
142
+ decision: {
143
+ // ADR-084: decision-слой выключен по умолчанию (провайдер задаёт админ).
144
+ enabled: false,
145
+ provider: '',
146
+ model: '',
147
+ confidenceThreshold: 0.6,
148
+ // ADR-084: тир эскалации не задан (пусто — эскалации нет).
149
+ escalationProvider: '',
150
+ escalationModel: '',
151
+ },
152
+ webhooks: {
153
+ // ADR-052 (этап II): доставка webhooks выключена по умолчанию (opt-in).
154
+ enabled: false,
155
+ maxAttempts: 5,
156
+ timeoutMs: 10_000,
157
+ // Только https и публичные адреса; приватные/loopback — запрещены (SSRF).
158
+ allowPrivateTargets: false,
159
+ deliveryRetentionDays: 30,
160
+ },
113
161
  instructions: {
114
162
  enabled: true,
115
163
  claudeCompat: true,
@@ -211,7 +259,9 @@ export const defaultConfig = {
211
259
  protectedPaths: {
212
260
  enabled: true,
213
261
  },
214
- // Пусто — core использует файл {dataDir}/secrets/master.key (AD-076).
262
+ // Пусто — core использует файл {dataDir}/secrets/master.key (ADR-076).
215
263
  secretKey: '',
264
+ // ADR-052/O1: installer service-key'и из env/Secret (по умолчанию нет).
265
+ bootstrapServiceKeys: [],
216
266
  },
217
267
  };
@@ -0,0 +1,68 @@
1
+ export type EnvOverrideType = 'boolean' | 'number' | 'string';
2
+ export interface EnvOverrideDefinition {
3
+ /** Секция верхнего уровня конфига (`events`, `scheduler`, `webhooks`, `decision`). */
4
+ section: string;
5
+ /** Ключ внутри секции (camelCase, как в `types.ts`). */
6
+ key: string;
7
+ /** Тип значения для парсинга env-строки. */
8
+ type: EnvOverrideType;
9
+ }
10
+ /**
11
+ * Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
12
+ *
13
+ * Объектные/нескалярные ключи (`events.allowedSources`, `events.identityMap`,
14
+ * `events.dedupStore`, `events.unknownAgentTemplate`, `scheduler.leaderElection`,
15
+ * `scheduler.crossProcessLocks`, `mcp.servers`, …) намеренно не входят: у них нет
16
+ * плоского строкового представления — они остаются в config.yaml.
17
+ */
18
+ export declare const ENV_OVERRIDES: readonly EnvOverrideDefinition[];
19
+ /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
20
+ export declare function toSnakeCase(value: string): string;
21
+ /** Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. */
22
+ export declare function envOverrideName(def: EnvOverrideDefinition): string;
23
+ export type ParsedEnvValue = {
24
+ ok: true;
25
+ value: boolean | number | string;
26
+ } | {
27
+ ok: false;
28
+ };
29
+ /**
30
+ * Парсинг env-строки по типу ключа:
31
+ * - `boolean` — `true`/`1`/`false`/`0` (регистронезависимо);
32
+ * - `number` — `Number()` с проверкой `Number.isFinite`;
33
+ * - `string` — как есть.
34
+ *
35
+ * Пустая строка (переменная задана, но пуста) → `{ok:false}` — трактуется как
36
+ * «не задано» (как `resolveDataDir`/`resolveDecisionProvider` с `if (envVal)`).
37
+ * Нераспознанное значение → `{ok:false}`: потребитель логирует warn и игнорирует.
38
+ */
39
+ export declare function parseEnvValue(raw: string, type: EnvOverrideType): ParsedEnvValue;
40
+ /**
41
+ * Применяет env-оверрайды к уже слитому конфигу (defaults + config.yaml).
42
+ *
43
+ * Мутирует переданный объект (в `loadConfig` это свежий результат `deepMerge`) и
44
+ * возвращает его. Секции клонируются, чтобы не мутировать `defaultConfig`.
45
+ * Неизвестные env игнорируются молча; невалидное значение — warn в console и
46
+ * игнор (как `resolvePort`/`resolveIgnoreRules`, без падения).
47
+ */
48
+ export declare function applyEnvOverrides<T extends Record<string, unknown>>(config: T, env?: NodeJS.ProcessEnv): T;
49
+ /**
50
+ * ADR-052/O1: env-имя JSON-списка installer service-key'ев
51
+ * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
52
+ * `{ label, secret, scopes, roles?, description? }`. Приоритет — как у
53
+ * скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
54
+ * Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
55
+ * (передаётся из env/Secret).
56
+ */
57
+ export declare const BOOTSTRAP_SERVICE_KEYS_ENV = "SYNTH_BOOTSTRAP_SERVICE_KEYS";
58
+ /**
59
+ * Применяет объектные env-оверрайды, у которых нет плоского строкового
60
+ * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
61
+ * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
62
+ * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
63
+ * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
64
+ *
65
+ * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
66
+ * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
67
+ */
68
+ export declare function applyObjectEnvOverrides<T extends Record<string, unknown>>(config: T, env?: NodeJS.ProcessEnv): T;
@@ -0,0 +1,165 @@
1
+ /**
2
+ * ADR-023: декларативные env-оверрайды скалярных ключей конфигурации.
3
+ *
4
+ * Имя переменной собирается по правилу `SYNTH_<SECTION>_<KEY>`, где camelCase
5
+ * ключа переводится в SNAKE_CASE (`autoBind` → `SYNTH_EVENTS_AUTO_BIND`,
6
+ * `ephemeralTtl` → `SYNTH_EVENTS_EPHEMERAL_TTL`). Реестр `ENV_OVERRIDES` —
7
+ * единственный источник истины; применяется **в одном месте** (`loadConfig`,
8
+ * после слияния defaults + config.yaml и до CLI-overrides), поэтому все
9
+ * потребители `@itphx/synth-shared/config` получают поддержку автоматически.
10
+ *
11
+ * Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
12
+ */
13
+ import { bootstrapServiceKeysSchema } from './types.js';
14
+ /**
15
+ * Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
16
+ *
17
+ * Объектные/нескалярные ключи (`events.allowedSources`, `events.identityMap`,
18
+ * `events.dedupStore`, `events.unknownAgentTemplate`, `scheduler.leaderElection`,
19
+ * `scheduler.crossProcessLocks`, `mcp.servers`, …) намеренно не входят: у них нет
20
+ * плоского строкового представления — они остаются в config.yaml.
21
+ */
22
+ export const ENV_OVERRIDES = [
23
+ // events (ADR-089)
24
+ { section: 'events', key: 'enabled', type: 'boolean' },
25
+ { section: 'events', key: 'defaultMode', type: 'string' },
26
+ { section: 'events', key: 'ephemeralTtl', type: 'string' },
27
+ { section: 'events', key: 'journalRetentionDays', type: 'number' },
28
+ { section: 'events', key: 'keyRateLimitPerMinute', type: 'number' },
29
+ { section: 'events', key: 'decisionRouting', type: 'boolean' },
30
+ { section: 'events', key: 'autoBind', type: 'boolean' },
31
+ { section: 'events', key: 'autoBindAgentTemplate', type: 'string' },
32
+ // scheduler (ADR-051 срез / ADR-089)
33
+ { section: 'scheduler', key: 'enabled', type: 'boolean' },
34
+ { section: 'scheduler', key: 'tickSec', type: 'number' },
35
+ { section: 'scheduler', key: 'catchUp', type: 'string' },
36
+ { section: 'scheduler', key: 'jobRetentionDays', type: 'number' },
37
+ // webhooks (ADR-052, этап II)
38
+ { section: 'webhooks', key: 'enabled', type: 'boolean' },
39
+ { section: 'webhooks', key: 'maxAttempts', type: 'number' },
40
+ { section: 'webhooks', key: 'timeoutMs', type: 'number' },
41
+ { section: 'webhooks', key: 'allowPrivateTargets', type: 'boolean' },
42
+ { section: 'webhooks', key: 'deliveryRetentionDays', type: 'number' },
43
+ // decision (ADR-084)
44
+ { section: 'decision', key: 'enabled', type: 'boolean' },
45
+ { section: 'decision', key: 'provider', type: 'string' },
46
+ { section: 'decision', key: 'model', type: 'string' },
47
+ { section: 'decision', key: 'confidenceThreshold', type: 'number' },
48
+ { section: 'decision', key: 'escalationProvider', type: 'string' },
49
+ { section: 'decision', key: 'escalationModel', type: 'string' },
50
+ ];
51
+ /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
52
+ export function toSnakeCase(value) {
53
+ return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
54
+ }
55
+ /** Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. */
56
+ export function envOverrideName(def) {
57
+ return `SYNTH_${toSnakeCase(def.section)}_${toSnakeCase(def.key)}`;
58
+ }
59
+ /**
60
+ * Парсинг env-строки по типу ключа:
61
+ * - `boolean` — `true`/`1`/`false`/`0` (регистронезависимо);
62
+ * - `number` — `Number()` с проверкой `Number.isFinite`;
63
+ * - `string` — как есть.
64
+ *
65
+ * Пустая строка (переменная задана, но пуста) → `{ok:false}` — трактуется как
66
+ * «не задано» (как `resolveDataDir`/`resolveDecisionProvider` с `if (envVal)`).
67
+ * Нераспознанное значение → `{ok:false}`: потребитель логирует warn и игнорирует.
68
+ */
69
+ export function parseEnvValue(raw, type) {
70
+ if (raw === '')
71
+ return { ok: false };
72
+ switch (type) {
73
+ case 'boolean': {
74
+ const v = raw.toLowerCase();
75
+ if (v === 'true' || v === '1')
76
+ return { ok: true, value: true };
77
+ if (v === 'false' || v === '0')
78
+ return { ok: true, value: false };
79
+ return { ok: false };
80
+ }
81
+ case 'number': {
82
+ const n = Number(raw);
83
+ if (!Number.isFinite(n))
84
+ return { ok: false };
85
+ return { ok: true, value: n };
86
+ }
87
+ case 'string':
88
+ return { ok: true, value: raw };
89
+ }
90
+ }
91
+ /**
92
+ * Применяет env-оверрайды к уже слитому конфигу (defaults + config.yaml).
93
+ *
94
+ * Мутирует переданный объект (в `loadConfig` это свежий результат `deepMerge`) и
95
+ * возвращает его. Секции клонируются, чтобы не мутировать `defaultConfig`.
96
+ * Неизвестные env игнорируются молча; невалидное значение — warn в console и
97
+ * игнор (как `resolvePort`/`resolveIgnoreRules`, без падения).
98
+ */
99
+ export function applyEnvOverrides(config, env = process.env) {
100
+ for (const def of ENV_OVERRIDES) {
101
+ const name = envOverrideName(def);
102
+ const raw = env[name];
103
+ if (raw === undefined)
104
+ continue;
105
+ const parsed = parseEnvValue(raw, def.type);
106
+ if (!parsed.ok) {
107
+ // Пустая строка — «не задано» (тихий игнор). Нераспознанное значение — warn.
108
+ if (raw !== '') {
109
+ console.warn(`[config] невалидное значение ${name}="${raw}" (ожидается ${def.type}) — игнорируется`);
110
+ }
111
+ continue;
112
+ }
113
+ const current = config[def.section];
114
+ const section = current !== null && typeof current === 'object' && !Array.isArray(current)
115
+ ? { ...current }
116
+ : {};
117
+ section[def.key] = parsed.value;
118
+ config[def.section] = section;
119
+ }
120
+ return config;
121
+ }
122
+ /**
123
+ * ADR-052/O1: env-имя JSON-списка installer service-key'ев
124
+ * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
125
+ * `{ label, secret, scopes, roles?, description? }`. Приоритет — как у
126
+ * скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
127
+ * Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
128
+ * (передаётся из env/Secret).
129
+ */
130
+ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
131
+ /**
132
+ * Применяет объектные env-оверрайды, у которых нет плоского строкового
133
+ * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
134
+ * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
135
+ * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
136
+ * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
137
+ *
138
+ * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
139
+ * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
140
+ */
141
+ export function applyObjectEnvOverrides(config, env = process.env) {
142
+ const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
143
+ if (raw === undefined || raw === '')
144
+ return config;
145
+ let parsed;
146
+ try {
147
+ parsed = JSON.parse(raw);
148
+ }
149
+ catch {
150
+ console.warn(`[config] невалидный JSON ${BOOTSTRAP_SERVICE_KEYS_ENV} — игнорируется`);
151
+ return config;
152
+ }
153
+ const validated = bootstrapServiceKeysSchema.safeParse(parsed);
154
+ if (!validated.success) {
155
+ console.warn(`[config] ${BOOTSTRAP_SERVICE_KEYS_ENV} не прошёл валидацию — игнорируется`);
156
+ return config;
157
+ }
158
+ const current = config.security;
159
+ const security = current !== null && typeof current === 'object' && !Array.isArray(current)
160
+ ? { ...current }
161
+ : {};
162
+ security.bootstrapServiceKeys = validated.data;
163
+ config.security = security;
164
+ return config;
165
+ }
@@ -1,5 +1,6 @@
1
1
  export * from './types.js';
2
2
  export * from './defaults.js';
3
3
  export * from './loader.js';
4
+ export * from './env-overrides.js';
4
5
  export * from './merge.js';
5
6
  export * from './resolve.js';
@@ -1,5 +1,6 @@
1
1
  export * from './types.js';
2
2
  export * from './defaults.js';
3
3
  export * from './loader.js';
4
+ export * from './env-overrides.js';
4
5
  export * from './merge.js';
5
6
  export * from './resolve.js';
@@ -1,8 +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
+ /** ADR-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
8
+ env?: NodeJS.ProcessEnv;
7
9
  }
8
10
  export declare function loadConfig(options?: LoadConfigOptions): Promise<SynthConfig>;
@@ -4,6 +4,7 @@ import { load as parseYaml } from 'js-yaml';
4
4
  import { synthConfigSchema } from './types.js';
5
5
  import { defaultConfig } from './defaults.js';
6
6
  import { deepMerge } from './merge.js';
7
+ import { applyEnvOverrides, applyObjectEnvOverrides } from './env-overrides.js';
7
8
  const CONFIG_SEARCH_PATHS = [
8
9
  'synth.config.yaml',
9
10
  'config.yaml',
@@ -13,7 +14,7 @@ const SYSTEM_CONFIG_PATH = '/etc/synth/config.yaml';
13
14
  function searchPaths(explicitPath, home) {
14
15
  if (explicitPath)
15
16
  return [explicitPath];
16
- // AD-079: при заданном home конфиг ищется строго в <home>/config.yaml
17
+ // ADR-079: при заданном home конфиг ищется строго в <home>/config.yaml
17
18
  // (home приоритетнее cwd/XDG-цепочки).
18
19
  if (home)
19
20
  return [join(home, 'config.yaml')];
@@ -41,7 +42,7 @@ async function tryReadYaml(path) {
41
42
  }
42
43
  }
43
44
  export async function loadConfig(options = {}) {
44
- // AD-023/AD-071: явный путь — из опций, иначе из SYNTH_CONFIG (как в
45
+ // ADR-023/ADR-071: явный путь — из опций, иначе из SYNTH_CONFIG (как в
45
46
  // findConfigPath). Без этого dev-запуск backend с cwd=synth/ не читал
46
47
  // packages/backend/config.yaml (mcp.servers) и seed реестра был пустым.
47
48
  const explicitPath = options.configPath ?? process.env.SYNTH_CONFIG;
@@ -55,9 +56,16 @@ export async function loadConfig(options = {}) {
55
56
  }
56
57
  }
57
58
  const merged = deepMerge(defaultConfig, fileConfig);
59
+ // ADR-023: env-оверрайды скалярных ключей вложенных секций применяются одним
60
+ // местом — поверх defaults + config.yaml и ниже CLI-overrides
61
+ // (приоритет: CLI > env > config.yaml > defaults).
62
+ const withEnv = applyEnvOverrides(merged, options.env ?? process.env);
63
+ // ADR-052/O1: объектный env-оверрайд installer service-key'ев
64
+ // (`SYNTH_BOOTSTRAP_SERVICE_KEYS`, JSON) — там же, до CLI-overrides.
65
+ applyObjectEnvOverrides(withEnv, options.env ?? process.env);
58
66
  const finalConfig = options.overrides
59
- ? deepMerge(merged, options.overrides)
60
- : merged;
67
+ ? deepMerge(withEnv, options.overrides)
68
+ : withEnv;
61
69
  const parsed = synthConfigSchema.safeParse(finalConfig);
62
70
  if (!parsed.success) {
63
71
  throw new Error(`Невалидная конфигурация: ${parsed.error.message}`);
@@ -3,7 +3,7 @@ import type { WorkspaceOutsideRootPolicy } from '../types/index.js';
3
3
  export type DeployMode = 'user' | 'docker' | 'server' | 'dev';
4
4
  export declare function resolveDeployMode(): DeployMode;
5
5
  /**
6
- * AD-079: базовый home-каталог локального инстанса. Приоритет: явный флаг
6
+ * ADR-079: базовый home-каталог локального инстанса. Приоритет: явный флаг
7
7
  * (`explicitHome`) > env `SYNTH_HOME` > null (XDG-дефолты). Возвращает
8
8
  * абсолютный путь либо null.
9
9
  */
@@ -21,33 +21,50 @@ export declare function resolvePort(config: SynthConfig, envKey: string, configF
21
21
  export declare function resolveWorkspacesRoot(config: SynthConfig, env?: NodeJS.ProcessEnv, home?: string | null): string;
22
22
  export declare function resolveDefaultWorkspace(config: SynthConfig, env?: NodeJS.ProcessEnv, home?: string | null): string;
23
23
  /**
24
- * AD-079: путь к реестру профилей серверов. При заданном home — плоская
24
+ * ADR-079: путь к реестру профилей серверов. При заданном home — плоская
25
25
  * раскладка `<home>/profiles.json`, иначе XDG-дефолт `~/.config/synth/profiles.json`.
26
26
  */
27
27
  export declare function resolveProfilesPath(home?: string | null): string;
28
28
  /**
29
- * AD-079: путь к файлу credentials. При заданном home — плоская раскладка
29
+ * ADR-079: путь к файлу credentials. При заданном home — плоская раскладка
30
30
  * `<home>/credentials.json`, иначе XDG-дефолт `~/.config/synth/credentials.json`.
31
31
  */
32
32
  export declare function resolveCredentialsPath(home?: string | null): string;
33
33
  /**
34
- * AD-075: эффективная политика для абсолютного workspace вне `workspacesRoot`
34
+ * ADR-075: эффективная политика для абсолютного workspace вне `workspacesRoot`
35
35
  * (приоритет: env `SYNTH_WORKSPACE_OUTSIDE_ROOT` > `config.storage.workspaceOutsideRoot` > `''`).
36
36
  * `''` — политика не задана; потребитель подставляет `confirm`.
37
37
  */
38
38
  export declare function resolveWorkspaceOutsideRootPolicy(config: SynthConfig, env?: NodeJS.ProcessEnv): WorkspaceOutsideRootPolicy | '';
39
39
  /**
40
- * AD-076: мастер-ключ шифрования секретов at-rest (SSH-ключи, AES-256-GCM).
40
+ * ADR-076: мастер-ключ шифрования секретов at-rest (SSH-ключи, AES-256-GCM).
41
41
  * Приоритет: env `SYNTH_SECRET_KEY` > `config.security.secretKey` > `''`
42
42
  * (пусто — core использует файл `{dataDir}/secrets/master.key`).
43
43
  */
44
44
  export declare function resolveSecretKey(config: SynthConfig, env?: NodeJS.ProcessEnv): string;
45
45
  /**
46
- * AD-069 §9.2: нейтральная сессия без проектных инструкций.
46
+ * ADR-069 §9.2: нейтральная сессия без проектных инструкций.
47
47
  * Приоритет: явный флаг CLI `--ignore-rules`/`--safe-mode` (`explicit`) >
48
48
  * env `SYNTH_IGNORE_RULES` (`1`/`true`). Значение — эффективный
49
49
  * `instructions.enabled=false`.
50
50
  */
51
51
  export declare function resolveIgnoreRules(explicit?: boolean, env?: NodeJS.ProcessEnv): boolean;
52
+ /**
53
+ * ADR-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
54
+ * `config.decision.provider`.
55
+ *
56
+ * Примечание: тот же env применяется и общим реестром `ENV_OVERRIDES` в
57
+ * `loadConfig` (ADR-023, ключ `decision.provider`); резолвер сохранён для
58
+ * потребителей, читающих конфиг не через `loadConfig`.
59
+ */
60
+ export declare function resolveDecisionProvider(config: SynthConfig, env?: NodeJS.ProcessEnv): string;
61
+ /**
62
+ * ADR-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
63
+ * `config.decision.model`.
64
+ *
65
+ * См. примечание к `resolveDecisionProvider` — env дублируется реестром
66
+ * `ENV_OVERRIDES` (ADR-023).
67
+ */
68
+ export declare function resolveDecisionModel(config: SynthConfig, env?: NodeJS.ProcessEnv): string;
52
69
  export declare function ensureDataDir(dataDir: string): Promise<void>;
53
70
  export declare function createDefaultConfig(targetPath: string): Promise<void>;
@@ -39,7 +39,7 @@ export function resolveDeployMode() {
39
39
  return 'user';
40
40
  }
41
41
  /**
42
- * AD-079: базовый home-каталог локального инстанса. Приоритет: явный флаг
42
+ * ADR-079: базовый home-каталог локального инстанса. Приоритет: явный флаг
43
43
  * (`explicitHome`) > env `SYNTH_HOME` > null (XDG-дефолты). Возвращает
44
44
  * абсолютный путь либо null.
45
45
  */
@@ -50,7 +50,7 @@ export function resolveHome(explicitHome, env) {
50
50
  return resolve(raw);
51
51
  }
52
52
  export function resolveDataDir(config, env, home) {
53
- // AD-075: нормализуем к абсолютному пути — относительный dataDir ломает
53
+ // ADR-075: нормализуем к абсолютному пути — относительный dataDir ломает
54
54
  // containment-проверки FS (root остаётся относительным, target — абсолютным).
55
55
  const envVar = (env ?? process.env).SYNTH_DATA_DIR;
56
56
  if (envVar)
@@ -58,7 +58,7 @@ export function resolveDataDir(config, env, home) {
58
58
  if (config.storage.dataDir && config.storage.dataDir !== defaultConfig.storage.dataDir) {
59
59
  return resolve(config.storage.dataDir);
60
60
  }
61
- // AD-079: home-каталог задаёт плоскую раскладку (<home>/data) и приоритетнее
61
+ // ADR-079: home-каталог задаёт плоскую раскладку (<home>/data) и приоритетнее
62
62
  // mode-дефолтов, но ниже явных SYNTH_DATA_DIR/config.storage.dataDir.
63
63
  const h = resolveHome(home, env);
64
64
  if (h)
@@ -74,7 +74,7 @@ export function findConfigPath(home) {
74
74
  const explicit = process.env.SYNTH_CONFIG;
75
75
  if (explicit)
76
76
  return explicit;
77
- // AD-079: при заданном home конфиг — строго <home>/config.yaml (приоритетнее
77
+ // ADR-079: при заданном home конфиг — строго <home>/config.yaml (приоритетнее
78
78
  // cwd/XDG); отсутствие файла не откатывается к дефолтам.
79
79
  const h = resolveHome(home);
80
80
  if (h) {
@@ -107,7 +107,7 @@ export function findConfigPath(home) {
107
107
  }
108
108
  }
109
109
  export function defaultConfigPath(mode, home) {
110
- // AD-079: home задаёт плоскую раскладку (<home>/config.yaml) независимо от mode.
110
+ // ADR-079: home задаёт плоскую раскладку (<home>/config.yaml) независимо от mode.
111
111
  const h = resolveHome(home);
112
112
  if (h)
113
113
  return join(h, 'config.yaml');
@@ -132,9 +132,9 @@ export async function ensureConfigFile(targetPath) {
132
132
  }
133
133
  export async function ensureFirstRun(dataDirOverride, configPathOverride, home) {
134
134
  const mode = resolveDeployMode();
135
- // AD-079: home задаёт плоскую раскладку (<home>/config.yaml, <home>/data).
135
+ // ADR-079: home задаёт плоскую раскладку (<home>/config.yaml, <home>/data).
136
136
  const h = resolveHome(home);
137
- // AD-075: относительный --data-dir абсолютизируем на CLI-границе (иначе
137
+ // ADR-075: относительный --data-dir абсолютизируем на CLI-границе (иначе
138
138
  // containment-проверки FS получают относительный root и абсолютный target).
139
139
  const dataDir = resolve(dataDirOverride ?? resolveDataDir(defaultConfig, undefined, h));
140
140
  const configPath = configPathOverride ?? defaultConfigPath(mode, h);
@@ -182,7 +182,7 @@ export function resolveDefaultWorkspace(config, env, home) {
182
182
  return join(dataDir, 'workspaces', 'default');
183
183
  }
184
184
  /**
185
- * AD-079: путь к реестру профилей серверов. При заданном home — плоская
185
+ * ADR-079: путь к реестру профилей серверов. При заданном home — плоская
186
186
  * раскладка `<home>/profiles.json`, иначе XDG-дефолт `~/.config/synth/profiles.json`.
187
187
  */
188
188
  export function resolveProfilesPath(home) {
@@ -192,7 +192,7 @@ export function resolveProfilesPath(home) {
192
192
  return join(homeDir(), '.config', 'synth', 'profiles.json');
193
193
  }
194
194
  /**
195
- * AD-079: путь к файлу credentials. При заданном home — плоская раскладка
195
+ * ADR-079: путь к файлу credentials. При заданном home — плоская раскладка
196
196
  * `<home>/credentials.json`, иначе XDG-дефолт `~/.config/synth/credentials.json`.
197
197
  */
198
198
  export function resolveCredentialsPath(home) {
@@ -202,7 +202,7 @@ export function resolveCredentialsPath(home) {
202
202
  return join(homeDir(), '.config', 'synth', 'credentials.json');
203
203
  }
204
204
  /**
205
- * AD-075: эффективная политика для абсолютного workspace вне `workspacesRoot`
205
+ * ADR-075: эффективная политика для абсолютного workspace вне `workspacesRoot`
206
206
  * (приоритет: env `SYNTH_WORKSPACE_OUTSIDE_ROOT` > `config.storage.workspaceOutsideRoot` > `''`).
207
207
  * `''` — политика не задана; потребитель подставляет `confirm`.
208
208
  */
@@ -216,7 +216,7 @@ export function resolveWorkspaceOutsideRootPolicy(config, env) {
216
216
  return '';
217
217
  }
218
218
  /**
219
- * AD-076: мастер-ключ шифрования секретов at-rest (SSH-ключи, AES-256-GCM).
219
+ * ADR-076: мастер-ключ шифрования секретов at-rest (SSH-ключи, AES-256-GCM).
220
220
  * Приоритет: env `SYNTH_SECRET_KEY` > `config.security.secretKey` > `''`
221
221
  * (пусто — core использует файл `{dataDir}/secrets/master.key`).
222
222
  */
@@ -229,7 +229,7 @@ export function resolveSecretKey(config, env) {
229
229
  return '';
230
230
  }
231
231
  /**
232
- * AD-069 §9.2: нейтральная сессия без проектных инструкций.
232
+ * ADR-069 §9.2: нейтральная сессия без проектных инструкций.
233
233
  * Приоритет: явный флаг CLI `--ignore-rules`/`--safe-mode` (`explicit`) >
234
234
  * env `SYNTH_IGNORE_RULES` (`1`/`true`). Значение — эффективный
235
235
  * `instructions.enabled=false`.
@@ -240,6 +240,27 @@ export function resolveIgnoreRules(explicit, env) {
240
240
  const envVal = (env ?? process.env).SYNTH_IGNORE_RULES;
241
241
  return envVal === '1' || envVal?.toLowerCase() === 'true';
242
242
  }
243
+ /**
244
+ * ADR-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
245
+ * `config.decision.provider`.
246
+ *
247
+ * Примечание: тот же env применяется и общим реестром `ENV_OVERRIDES` в
248
+ * `loadConfig` (ADR-023, ключ `decision.provider`); резолвер сохранён для
249
+ * потребителей, читающих конфиг не через `loadConfig`.
250
+ */
251
+ export function resolveDecisionProvider(config, env) {
252
+ return (env ?? process.env).SYNTH_DECISION_PROVIDER || config.decision.provider;
253
+ }
254
+ /**
255
+ * ADR-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
256
+ * `config.decision.model`.
257
+ *
258
+ * См. примечание к `resolveDecisionProvider` — env дублируется реестром
259
+ * `ENV_OVERRIDES` (ADR-023).
260
+ */
261
+ export function resolveDecisionModel(config, env) {
262
+ return (env ?? process.env).SYNTH_DECISION_MODEL || config.decision.model;
263
+ }
243
264
  export async function ensureDataDir(dataDir) {
244
265
  await mkdir(dataDir, { recursive: true });
245
266
  for (const subdir of DATA_SUBDIRS) {