@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.
- package/dist/config/defaults.js +11 -11
- package/dist/config/env-overrides.d.ts +3 -3
- package/dist/config/env-overrides.js +9 -9
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +4 -4
- package/dist/config/resolve.d.ts +10 -10
- package/dist/config/resolve.js +16 -16
- package/dist/config/types.d.ts +190 -190
- package/dist/config/types.js +47 -47
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +16 -10
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/schemas/index.d.ts +96 -96
- package/dist/schemas/index.js +70 -70
- 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/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/events.d.ts +22 -22
- package/dist/types/fs.d.ts +44 -0
- package/dist/types/fs.js +16 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +4 -4
- package/dist/types/index.d.ts +12 -1165
- package/dist/types/index.js +38 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/mcp.d.ts +104 -0
- package/dist/types/mcp.js +40 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +2 -2
- 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 +236 -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 +269 -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 +5 -5
- 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.js +2 -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
|
@@ -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 не меняется (
|
|
119
|
+
// Default OFF: дедуп in-process, поведение single-process не меняется (ADR-051/ADR-089).
|
|
120
120
|
dedupStore: 'memory',
|
|
121
|
-
// Неизвестный agentTemplate → drop с аудитом (fail-safe,
|
|
121
|
+
// Неизвестный agentTemplate → drop с аудитом (fail-safe, ADR-089).
|
|
122
122
|
unknownAgentTemplate: 'drop',
|
|
123
123
|
// Глобальный дефолт лимита запросов/мин на API-ключ привязки (0 — без лимита).
|
|
124
124
|
keyRateLimitPerMinute: 0,
|
|
125
|
-
//
|
|
125
|
+
// ADR-084 × ADR-089: decision-маршрутизация событий выключена по умолчанию (opt-in).
|
|
126
126
|
decisionRouting: false,
|
|
127
|
-
//
|
|
127
|
+
// ADR-089 (auto-bind): фоллбек-закрепление события с chatKey/threadKey за сессией — по умолчанию выключено.
|
|
128
128
|
autoBind: false,
|
|
129
129
|
autoBindAgentTemplate: '',
|
|
130
|
-
//
|
|
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 и межпроцессные локи выключены (
|
|
138
|
+
// Default OFF: leader election и межпроцессные локи выключены (ADR-051/ADR-089).
|
|
139
139
|
leaderElection: 'none',
|
|
140
140
|
crossProcessLocks: false,
|
|
141
141
|
},
|
|
142
142
|
decision: {
|
|
143
|
-
//
|
|
143
|
+
// ADR-084: decision-слой выключен по умолчанию (провайдер задаёт админ).
|
|
144
144
|
enabled: false,
|
|
145
145
|
provider: '',
|
|
146
146
|
model: '',
|
|
147
147
|
confidenceThreshold: 0.6,
|
|
148
|
-
//
|
|
148
|
+
// ADR-084: тир эскалации не задан (пусто — эскалации нет).
|
|
149
149
|
escalationProvider: '',
|
|
150
150
|
escalationModel: '',
|
|
151
151
|
},
|
|
152
152
|
webhooks: {
|
|
153
|
-
//
|
|
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 (
|
|
262
|
+
// Пусто — core использует файл {dataDir}/secrets/master.key (ADR-076).
|
|
263
263
|
secretKey: '',
|
|
264
|
-
//
|
|
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-оверрайдов скалярных ключей вложенных секций (
|
|
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
|
-
*
|
|
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 (
|
|
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
|
-
*
|
|
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,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 (
|
|
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
41
|
{ section: 'webhooks', key: 'allowPrivateTargets', type: 'boolean' },
|
|
42
42
|
{ section: 'webhooks', key: 'deliveryRetentionDays', type: 'number' },
|
|
43
|
-
// decision (
|
|
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
|
-
*
|
|
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 (
|
|
126
|
+
* скалярных env-оверрайдов: env > config.yaml (ADR-023), но выше CLI-overrides.
|
|
127
127
|
* Нужен, чтобы секрет installer-ключа не попадал в файл конфигурации
|
|
128
128
|
* (передаётся из env/Secret).
|
|
129
129
|
*/
|
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')];
|
|
@@ -42,7 +42,7 @@ async function tryReadYaml(path) {
|
|
|
42
42
|
}
|
|
43
43
|
}
|
|
44
44
|
export async function loadConfig(options = {}) {
|
|
45
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
package/dist/config/resolve.d.ts
CHANGED
|
@@ -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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
53
|
+
* ADR-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
|
|
54
54
|
* `config.decision.provider`.
|
|
55
55
|
*
|
|
56
56
|
* Примечание: тот же env применяется и общим реестром `ENV_OVERRIDES` в
|
|
57
|
-
* `loadConfig` (
|
|
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
|
-
*
|
|
62
|
+
* ADR-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
|
|
63
63
|
* `config.decision.model`.
|
|
64
64
|
*
|
|
65
65
|
* См. примечание к `resolveDecisionProvider` — env дублируется реестром
|
|
66
|
-
* `ENV_OVERRIDES` (
|
|
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>;
|
package/dist/config/resolve.js
CHANGED
|
@@ -39,7 +39,7 @@ export function resolveDeployMode() {
|
|
|
39
39
|
return 'user';
|
|
40
40
|
}
|
|
41
41
|
/**
|
|
42
|
-
*
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
135
|
+
// ADR-079: home задаёт плоскую раскладку (<home>/config.yaml, <home>/data).
|
|
136
136
|
const h = resolveHome(home);
|
|
137
|
-
//
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
244
|
+
* ADR-084: имя decision-провайдера. Приоритет: env `SYNTH_DECISION_PROVIDER` >
|
|
245
245
|
* `config.decision.provider`.
|
|
246
246
|
*
|
|
247
247
|
* Примечание: тот же env применяется и общим реестром `ENV_OVERRIDES` в
|
|
248
|
-
* `loadConfig` (
|
|
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
|
-
*
|
|
255
|
+
* ADR-084: модель decision-слоя. Приоритет: env `SYNTH_DECISION_MODEL` >
|
|
256
256
|
* `config.decision.model`.
|
|
257
257
|
*
|
|
258
258
|
* См. примечание к `resolveDecisionProvider` — env дублируется реестром
|
|
259
|
-
* `ENV_OVERRIDES` (
|
|
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;
|