@itphx/synth-shared 0.10.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 (65) hide show
  1. package/dist/config/defaults.js +11 -11
  2. package/dist/config/env-overrides.d.ts +3 -3
  3. package/dist/config/env-overrides.js +9 -9
  4. package/dist/config/loader.d.ts +2 -2
  5. package/dist/config/loader.js +4 -4
  6. package/dist/config/resolve.d.ts +10 -10
  7. package/dist/config/resolve.js +16 -16
  8. package/dist/config/types.d.ts +190 -190
  9. package/dist/config/types.js +47 -47
  10. package/dist/i18n/index.d.ts +1 -1
  11. package/dist/i18n/index.js +16 -10
  12. package/dist/interfaces/index.d.ts +3 -3
  13. package/dist/schemas/index.d.ts +96 -96
  14. package/dist/schemas/index.js +70 -70
  15. package/dist/skills/frontmatter.js +1 -1
  16. package/dist/types/agent.d.ts +30 -0
  17. package/dist/types/agent.js +1 -0
  18. package/dist/types/bus-events.d.ts +7 -0
  19. package/dist/types/bus-events.js +1 -0
  20. package/dist/types/commands.d.ts +10 -10
  21. package/dist/types/commands.js +2 -2
  22. package/dist/types/decision.d.ts +16 -16
  23. package/dist/types/decision.js +4 -4
  24. package/dist/types/events.d.ts +22 -22
  25. package/dist/types/fs.d.ts +44 -0
  26. package/dist/types/fs.js +16 -0
  27. package/dist/types/git.d.ts +63 -0
  28. package/dist/types/git.js +1 -0
  29. package/dist/types/hooks.d.ts +4 -4
  30. package/dist/types/index.d.ts +12 -1165
  31. package/dist/types/index.js +38 -244
  32. package/dist/types/llm.d.ts +32 -0
  33. package/dist/types/llm.js +8 -0
  34. package/dist/types/mcp.d.ts +104 -0
  35. package/dist/types/mcp.js +40 -0
  36. package/dist/types/message.d.ts +63 -0
  37. package/dist/types/message.js +12 -0
  38. package/dist/types/permission.d.ts +2 -2
  39. package/dist/types/permission.js +1 -1
  40. package/dist/types/project.d.ts +134 -0
  41. package/dist/types/project.js +67 -0
  42. package/dist/types/prompt.d.ts +236 -0
  43. package/dist/types/prompt.js +15 -0
  44. package/dist/types/provider.d.ts +84 -0
  45. package/dist/types/provider.js +35 -0
  46. package/dist/types/schedules.d.ts +8 -8
  47. package/dist/types/schedules.js +1 -1
  48. package/dist/types/service-keys.d.ts +10 -10
  49. package/dist/types/service-keys.js +3 -3
  50. package/dist/types/session.d.ts +269 -0
  51. package/dist/types/session.js +13 -0
  52. package/dist/types/skills.d.ts +11 -11
  53. package/dist/types/skills.js +6 -6
  54. package/dist/types/tools.d.ts +3 -3
  55. package/dist/types/user.d.ts +113 -0
  56. package/dist/types/user.js +31 -0
  57. package/dist/types/webhooks.d.ts +5 -5
  58. package/dist/types/webhooks.js +1 -1
  59. package/dist/utils/glob.d.ts +1 -1
  60. package/dist/utils/glob.js +1 -1
  61. package/dist/utils/index.js +2 -2
  62. package/dist/utils/workspace.js +1 -1
  63. package/dist/version.d.ts +1 -1
  64. package/dist/version.js +1 -1
  65. package/package.json +1 -1
@@ -116,18 +116,18 @@ export const defaultConfig = {
116
116
  ephemeralTtl: '24h',
117
117
  journalRetentionDays: 30,
118
118
  allowedSources: [],
119
- // Default OFF: дедуп in-process, поведение single-process не меняется (AD-051/AD-089).
119
+ // Default OFF: дедуп in-process, поведение single-process не меняется (ADR-051/ADR-089).
120
120
  dedupStore: 'memory',
121
- // Неизвестный agentTemplate → drop с аудитом (fail-safe, AD-089).
121
+ // Неизвестный agentTemplate → drop с аудитом (fail-safe, ADR-089).
122
122
  unknownAgentTemplate: 'drop',
123
123
  // Глобальный дефолт лимита запросов/мин на API-ключ привязки (0 — без лимита).
124
124
  keyRateLimitPerMinute: 0,
125
- // AD-084 × AD-089: decision-маршрутизация событий выключена по умолчанию (opt-in).
125
+ // ADR-084 × ADR-089: decision-маршрутизация событий выключена по умолчанию (opt-in).
126
126
  decisionRouting: false,
127
- // AD-089 (auto-bind): фоллбек-закрепление события с chatKey/threadKey за сессией — по умолчанию выключено.
127
+ // ADR-089 (auto-bind): фоллбек-закрепление события с chatKey/threadKey за сессией — по умолчанию выключено.
128
128
  autoBind: false,
129
129
  autoBindAgentTemplate: '',
130
- // AD-089: маппинг идентичности отправителя события на владельца сессии (пусто — не переопределяется).
130
+ // ADR-089: маппинг идентичности отправителя события на владельца сессии (пусто — не переопределяется).
131
131
  identityMap: {},
132
132
  },
133
133
  scheduler: {
@@ -135,22 +135,22 @@ export const defaultConfig = {
135
135
  tickSec: 60,
136
136
  catchUp: 'skip',
137
137
  jobRetentionDays: 30,
138
- // Default OFF: leader election и межпроцессные локи выключены (AD-051/AD-089).
138
+ // Default OFF: leader election и межпроцессные локи выключены (ADR-051/ADR-089).
139
139
  leaderElection: 'none',
140
140
  crossProcessLocks: false,
141
141
  },
142
142
  decision: {
143
- // AD-084: decision-слой выключен по умолчанию (провайдер задаёт админ).
143
+ // ADR-084: decision-слой выключен по умолчанию (провайдер задаёт админ).
144
144
  enabled: false,
145
145
  provider: '',
146
146
  model: '',
147
147
  confidenceThreshold: 0.6,
148
- // AD-084: тир эскалации не задан (пусто — эскалации нет).
148
+ // ADR-084: тир эскалации не задан (пусто — эскалации нет).
149
149
  escalationProvider: '',
150
150
  escalationModel: '',
151
151
  },
152
152
  webhooks: {
153
- // AD-052 (этап II): доставка webhooks выключена по умолчанию (opt-in).
153
+ // ADR-052 (этап II): доставка webhooks выключена по умолчанию (opt-in).
154
154
  enabled: false,
155
155
  maxAttempts: 5,
156
156
  timeoutMs: 10_000,
@@ -259,9 +259,9 @@ export const defaultConfig = {
259
259
  protectedPaths: {
260
260
  enabled: true,
261
261
  },
262
- // Пусто — core использует файл {dataDir}/secrets/master.key (AD-076).
262
+ // Пусто — core использует файл {dataDir}/secrets/master.key (ADR-076).
263
263
  secretKey: '',
264
- // AD-052/O1: installer service-key'и из env/Secret (по умолчанию нет).
264
+ // ADR-052/O1: installer service-key'и из env/Secret (по умолчанию нет).
265
265
  bootstrapServiceKeys: [],
266
266
  },
267
267
  };
@@ -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`,
@@ -47,10 +47,10 @@ export declare function parseEnvValue(raw: string, type: EnvOverrideType): Parse
47
47
  */
48
48
  export declare function applyEnvOverrides<T extends Record<string, unknown>>(config: T, env?: NodeJS.ProcessEnv): T;
49
49
  /**
50
- * AD-052/O1: env-имя JSON-списка installer service-key'ев
50
+ * ADR-052/O1: env-имя JSON-списка installer service-key'ев
51
51
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
52
52
  * `{ label, secret, scopes, roles?, description? }`. Приоритет — как у
53
- * скалярных env-оверрайдов: env > config.yaml (AD-023), но выше CLI-overrides.
53
+ * скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
54
54
  * Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
55
55
  * (передаётся из env/Secret).
56
56
  */
@@ -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,18 +29,18 @@ 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
41
  { section: 'webhooks', key: 'allowPrivateTargets', type: 'boolean' },
42
42
  { section: 'webhooks', key: 'deliveryRetentionDays', type: 'number' },
43
- // decision (AD-084)
43
+ // decision (ADR-084)
44
44
  { section: 'decision', key: 'enabled', type: 'boolean' },
45
45
  { section: 'decision', key: 'provider', type: 'string' },
46
46
  { section: 'decision', key: 'model', type: 'string' },
@@ -120,10 +120,10 @@ export function applyEnvOverrides(config, env = process.env) {
120
120
  return config;
121
121
  }
122
122
  /**
123
- * AD-052/O1: env-имя JSON-списка installer service-key'ев
123
+ * ADR-052/O1: env-имя JSON-списка installer service-key'ев
124
124
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
125
125
  * `{ label, secret, scopes, roles?, description? }`. Приоритет — как у
126
- * скалярных env-оверрайдов: env > config.yaml (AD-023), но выше CLI-overrides.
126
+ * скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
127
127
  * Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
128
128
  * (передаётся из env/Secret).
129
129
  */
@@ -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')];
@@ -42,7 +42,7 @@ async function tryReadYaml(path) {
42
42
  }
43
43
  }
44
44
  export async function loadConfig(options = {}) {
45
- // AD-023/AD-071: явный путь — из опций, иначе из SYNTH_CONFIG (как в
45
+ // ADR-023/ADR-071: явный путь — из опций, иначе из SYNTH_CONFIG (как в
46
46
  // findConfigPath). Без этого dev-запуск backend с cwd=synth/ не читал
47
47
  // packages/backend/config.yaml (mcp.servers) и seed реестра был пустым.
48
48
  const explicitPath = options.configPath ?? process.env.SYNTH_CONFIG;
@@ -56,11 +56,11 @@ export async function loadConfig(options = {}) {
56
56
  }
57
57
  }
58
58
  const merged = deepMerge(defaultConfig, fileConfig);
59
- // AD-023: env-оверрайды скалярных ключей вложенных секций применяются одним
59
+ // ADR-023: env-оверрайды скалярных ключей вложенных секций применяются одним
60
60
  // местом — поверх defaults + config.yaml и ниже CLI-overrides
61
61
  // (приоритет: CLI > env > config.yaml > defaults).
62
62
  const withEnv = applyEnvOverrides(merged, options.env ?? process.env);
63
- // AD-052/O1: объектный env-оверрайд installer service-key'ев
63
+ // ADR-052/O1: объектный env-оверрайд installer service-key'ев
64
64
  // (`SYNTH_BOOTSTRAP_SERVICE_KEYS`, JSON) — там же, до CLI-overrides.
65
65
  applyObjectEnvOverrides(withEnv, options.env ?? process.env);
66
66
  const finalConfig = options.overrides
@@ -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,49 +21,49 @@ 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
52
  /**
53
- * AD-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
53
+ * ADR-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
54
54
  * `config.decision.provider`.
55
55
  *
56
56
  * Примечание: тот же env применяется и общим реестром `ENV_OVERRIDES` в
57
- * `loadConfig` (AD-023, ключ `decision.provider`); резолвер сохранён для
57
+ * `loadConfig` (ADR-023, ключ `decision.provider`); резолвер сохранён для
58
58
  * потребителей, читающих конфиг не через `loadConfig`.
59
59
  */
60
60
  export declare function resolveDecisionProvider(config: SynthConfig, env?: NodeJS.ProcessEnv): string;
61
61
  /**
62
- * AD-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
62
+ * ADR-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
63
63
  * `config.decision.model`.
64
64
  *
65
65
  * См. примечание к `resolveDecisionProvider` — env дублируется реестром
66
- * `ENV_OVERRIDES` (AD-023).
66
+ * `ENV_OVERRIDES` (ADR-023).
67
67
  */
68
68
  export declare function resolveDecisionModel(config: SynthConfig, env?: NodeJS.ProcessEnv): string;
69
69
  export declare function ensureDataDir(dataDir: 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`.
@@ -241,22 +241,22 @@ export function resolveIgnoreRules(explicit, env) {
241
241
  return envVal === '1' || envVal?.toLowerCase() === 'true';
242
242
  }
243
243
  /**
244
- * AD-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
244
+ * ADR-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
245
245
  * `config.decision.provider`.
246
246
  *
247
247
  * Примечание: тот же env применяется и общим реестром `ENV_OVERRIDES` в
248
- * `loadConfig` (AD-023, ключ `decision.provider`); резолвер сохранён для
248
+ * `loadConfig` (ADR-023, ключ `decision.provider`); резолвер сохранён для
249
249
  * потребителей, читающих конфиг не через `loadConfig`.
250
250
  */
251
251
  export function resolveDecisionProvider(config, env) {
252
252
  return (env ?? process.env).SYNTH_DECISION_PROVIDER || config.decision.provider;
253
253
  }
254
254
  /**
255
- * AD-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
255
+ * ADR-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
256
256
  * `config.decision.model`.
257
257
  *
258
258
  * См. примечание к `resolveDecisionProvider` — env дублируется реестром
259
- * `ENV_OVERRIDES` (AD-023).
259
+ * `ENV_OVERRIDES` (ADR-023).
260
260
  */
261
261
  export function resolveDecisionModel(config, env) {
262
262
  return (env ?? process.env).SYNTH_DECISION_MODEL || config.decision.model;