@itphx/synth-shared 0.11.3 → 0.12.4

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 (92) hide show
  1. package/dist/config/defaults.js +126 -3
  2. package/dist/config/env-overrides.d.ts +29 -0
  3. package/dist/config/env-overrides.js +155 -2
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +1 -0
  7. package/dist/config/index.js +1 -0
  8. package/dist/config/proxy.js +3 -1
  9. package/dist/config/resolve.d.ts +8 -8
  10. package/dist/config/resolve.js +7 -7
  11. package/dist/config/types.d.ts +1287 -4037
  12. package/dist/config/types.js +461 -68
  13. package/dist/i18n/index.d.ts +1 -1
  14. package/dist/i18n/index.js +277 -0
  15. package/dist/index.d.ts +14 -2
  16. package/dist/index.js +16 -2
  17. package/dist/model-metadata.d.ts +10 -0
  18. package/dist/schemas/index.d.ts +980 -2322
  19. package/dist/schemas/index.js +183 -22
  20. package/dist/types/analytics.d.ts +6 -6
  21. package/dist/types/analytics.js +4 -4
  22. package/dist/types/authority.d.ts +464 -0
  23. package/dist/types/authority.js +445 -0
  24. package/dist/types/background.d.ts +96 -0
  25. package/dist/types/background.js +24 -0
  26. package/dist/types/bus-events.d.ts +23 -1
  27. package/dist/types/catalog.d.ts +349 -0
  28. package/dist/types/catalog.js +393 -0
  29. package/dist/types/decision.d.ts +28 -337
  30. package/dist/types/egress.d.ts +1 -1
  31. package/dist/types/egress.js +1 -1
  32. package/dist/types/events.d.ts +54 -1
  33. package/dist/types/external-credentials.d.ts +352 -0
  34. package/dist/types/external-credentials.js +200 -0
  35. package/dist/types/hooks.d.ts +33 -12
  36. package/dist/types/index.d.ts +20 -0
  37. package/dist/types/index.js +50 -1
  38. package/dist/types/llm-filters.d.ts +150 -0
  39. package/dist/types/llm-filters.js +54 -0
  40. package/dist/types/mcp.d.ts +33 -2
  41. package/dist/types/mcp.js +44 -1
  42. package/dist/types/message.d.ts +45 -1
  43. package/dist/types/pack.d.ts +1102 -0
  44. package/dist/types/pack.js +1003 -0
  45. package/dist/types/permission.d.ts +25 -11
  46. package/dist/types/permission.js +1 -1
  47. package/dist/types/pipeline-engine.d.ts +453 -0
  48. package/dist/types/pipeline-engine.js +440 -0
  49. package/dist/types/pipeline.d.ts +275 -0
  50. package/dist/types/pipeline.js +212 -0
  51. package/dist/types/plugin-audit.d.ts +110 -0
  52. package/dist/types/plugin-audit.js +185 -0
  53. package/dist/types/plugin-hybrid.d.ts +85 -0
  54. package/dist/types/plugin-hybrid.js +68 -0
  55. package/dist/types/plugin-lock.d.ts +95 -0
  56. package/dist/types/plugin-lock.js +1 -0
  57. package/dist/types/plugin-protocol.d.ts +221 -0
  58. package/dist/types/plugin-protocol.js +322 -0
  59. package/dist/types/plugin-runtime.d.ts +25 -0
  60. package/dist/types/plugin-runtime.js +11 -0
  61. package/dist/types/plugin-scan.d.ts +159 -0
  62. package/dist/types/plugin-scan.js +166 -0
  63. package/dist/types/plugin-tools.d.ts +51 -0
  64. package/dist/types/plugin-tools.js +72 -0
  65. package/dist/types/project.d.ts +14 -0
  66. package/dist/types/prompt-blocks.d.ts +102 -0
  67. package/dist/types/prompt-blocks.js +24 -0
  68. package/dist/types/prompt.d.ts +45 -3
  69. package/dist/types/provider.d.ts +11 -0
  70. package/dist/types/question.d.ts +153 -0
  71. package/dist/types/question.js +65 -0
  72. package/dist/types/schedules.d.ts +26 -3
  73. package/dist/types/semver.d.ts +48 -0
  74. package/dist/types/semver.js +218 -0
  75. package/dist/types/service-keys.d.ts +41 -3
  76. package/dist/types/service-keys.js +44 -2
  77. package/dist/types/session.d.ts +54 -0
  78. package/dist/types/steering.d.ts +74 -0
  79. package/dist/types/steering.js +75 -0
  80. package/dist/types/tools.d.ts +125 -5
  81. package/dist/types/tools.js +75 -0
  82. package/dist/types/trust.d.ts +31 -0
  83. package/dist/types/trust.js +27 -0
  84. package/dist/types/worktree.d.ts +170 -0
  85. package/dist/types/worktree.js +101 -0
  86. package/dist/utils/index.d.ts +31 -1
  87. package/dist/utils/index.js +92 -12
  88. package/dist/utils/reasoning.d.ts +16 -0
  89. package/dist/utils/reasoning.js +37 -0
  90. package/dist/version.d.ts +1 -1
  91. package/dist/version.js +1 -1
  92. package/package.json +2 -2
@@ -46,7 +46,7 @@ export declare function resolveWorkspaceOutsideRootPolicy(config: SynthConfig, e
46
46
  */
47
47
  export declare function resolveMaxUploadBytes(config: SynthConfig, env?: NodeJS.ProcessEnv): number;
48
48
  /**
49
- * PROP-032: физический backend хранения. Приоритет (ADR-023): env
49
+ * ADR-096: физический backend хранения. Приоритет (ADR-023): env
50
50
  * `SYNTH_STORAGE_BACKEND` > `config.storage.backend` > `'file'`.
51
51
  *
52
52
  * **Fail-closed**: если значение задано явно (env или config) и не входит в
@@ -55,9 +55,9 @@ export declare function resolveMaxUploadBytes(config: SynthConfig, env?: NodeJS.
55
55
  * опечатку и запускало инстанс не на том backend'е).
56
56
  */
57
57
  export declare function resolveStorageBackend(config: SynthConfig, env?: NodeJS.ProcessEnv): StorageBackend;
58
- /** Поддерживаемые физические backend'ы хранения (PROP-032). */
58
+ /** Поддерживаемые физические backend'ы хранения (ADR-096). */
59
59
  export type StorageBackend = 'file' | 'memory' | 'postgres';
60
- /** PROP-032: эффективные параметры PostgreSQL-backend (без пароля — инвариант 13). */
60
+ /** ADR-097: эффективные параметры PostgreSQL-backend (без пароля — инвариант 13). */
61
61
  export interface ResolvedPostgresConfig {
62
62
  dsn?: string;
63
63
  host?: string;
@@ -65,14 +65,14 @@ export interface ResolvedPostgresConfig {
65
65
  database?: string;
66
66
  user?: string;
67
67
  schema?: string;
68
- /** ADR-099/PROP-032: эффективный TLS-режим (нормализованный; `verify-ca` → `verify-full`). */
68
+ /** ADR-099/ADR-097: эффективный TLS-режим (нормализованный; `verify-ca` → `verify-full`). */
69
69
  sslmode?: PostgresSslMode;
70
70
  /** Legacy-флаг TLS (когда `sslmode` не задан). */
71
71
  ssl?: boolean;
72
72
  poolMax?: number;
73
73
  }
74
74
  /**
75
- * PROP-032: параметры PostgreSQL-backend. Приоритет (ADR-023): env
75
+ * ADR-097: параметры PostgreSQL-backend. Приоритет (ADR-023): env
76
76
  * (`SYNTH_POSTGRES_*`) > `config.storage.postgres`. **Пароль не включается**
77
77
  * (инвариант 13) — см. `resolvePostgresPassword`. Некорректное env-значение
78
78
  * (не число/булево) — warn и фолбэк на config (fail-soft, как прочие
@@ -80,7 +80,7 @@ export interface ResolvedPostgresConfig {
80
80
  */
81
81
  export declare function resolvePostgresConfig(config: SynthConfig, env?: NodeJS.ProcessEnv): ResolvedPostgresConfig;
82
82
  /**
83
- * PROP-032: пароль PostgreSQL. **Только** env `SYNTH_POSTGRES_PASSWORD` →
83
+ * ADR-097: пароль PostgreSQL. **Только** env `SYNTH_POSTGRES_PASSWORD` →
84
84
  * файл `{dataDir}/secrets/postgres-password` (инвариант 13: в config.yaml
85
85
  * секретов нет). Файла нет — `undefined` (решение об ошибке принимает драйвер:
86
86
  * для peer/trust-аутентификации пароль не нужен). Читается только, не создаётся.
@@ -89,7 +89,7 @@ export declare function resolvePostgresPassword(opts: {
89
89
  dataDir: string;
90
90
  }, env?: NodeJS.ProcessEnv): string | undefined;
91
91
  /**
92
- * PROP-032 (W5): политика при недоступности выбранного backend —
92
+ * ADR-098 (W5): политика при недоступности выбранного backend —
93
93
  * `fallback-file` (default) | `halt`. Читать через этот резолвер.
94
94
  *
95
95
  * Приоритет (ADR-023): env `SYNTH_DEGRADED_MODE` > `config.storage.degradedMode` >
@@ -98,7 +98,7 @@ export declare function resolvePostgresPassword(opts: {
98
98
  */
99
99
  export declare function resolveDegradedMode(config: SynthConfig, env?: NodeJS.ProcessEnv): 'fallback-file' | 'halt';
100
100
  /**
101
- * PROP-032 (W5): каталог файлового фоллбека. Приоритет (ADR-023): env
101
+ * ADR-098 (W5): каталог файлового фоллбека. Приоритет (ADR-023): env
102
102
  * `SYNTH_STORAGE_FALLBACK_DIR` > явный `config.storage.fallbackDir` → `''`
103
103
  * (эффективно `{dataDir}/fallback`).
104
104
  */
@@ -237,7 +237,7 @@ export function resolveMaxUploadBytes(config, env) {
237
237
  return config.storage.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES;
238
238
  }
239
239
  /**
240
- * PROP-032: физический backend хранения. Приоритет (ADR-023): env
240
+ * ADR-096: физический backend хранения. Приоритет (ADR-023): env
241
241
  * `SYNTH_STORAGE_BACKEND` > `config.storage.backend` > `'file'`.
242
242
  *
243
243
  * **Fail-closed**: если значение задано явно (env или config) и не входит в
@@ -267,7 +267,7 @@ function isStorageBackend(value) {
267
267
  return typeof value === 'string' && STORAGE_BACKENDS.includes(value);
268
268
  }
269
269
  /**
270
- * PROP-032: параметры PostgreSQL-backend. Приоритет (ADR-023): env
270
+ * ADR-097: параметры PostgreSQL-backend. Приоритет (ADR-023): env
271
271
  * (`SYNTH_POSTGRES_*`) > `config.storage.postgres`. **Пароль не включается**
272
272
  * (инвариант 13) — см. `resolvePostgresPassword`. Некорректное env-значение
273
273
  * (не число/булево) — warn и фолбэк на config (fail-soft, как прочие
@@ -307,7 +307,7 @@ export function resolvePostgresConfig(config, env) {
307
307
  const ssl = resolveBooleanEnv(e.SYNTH_POSTGRES_SSL, cfg.ssl, 'SYNTH_POSTGRES_SSL');
308
308
  if (ssl !== undefined)
309
309
  result.ssl = ssl;
310
- // ADR-099/PROP-032: sslmode (env `SYNTH_POSTGRES_SSLMODE` > config); `verify-ca`
310
+ // ADR-099/ADR-097: sslmode (env `SYNTH_POSTGRES_SSLMODE` > config); `verify-ca`
311
311
  // — алиас `verify-full` (warn). Невалидное env-значение — warn + фолбэк на
312
312
  // config (fail-soft, как прочие env-резолверы).
313
313
  const rawEnvSslmode = e.SYNTH_POSTGRES_SSLMODE;
@@ -349,7 +349,7 @@ function resolveBooleanEnv(rawEnv, cfgValue, envName) {
349
349
  return cfgValue;
350
350
  }
351
351
  /**
352
- * PROP-032: пароль PostgreSQL. **Только** env `SYNTH_POSTGRES_PASSWORD` →
352
+ * ADR-097: пароль PostgreSQL. **Только** env `SYNTH_POSTGRES_PASSWORD` →
353
353
  * файл `{dataDir}/secrets/postgres-password` (инвариант 13: в config.yaml
354
354
  * секретов нет). Файла нет — `undefined` (решение об ошибке принимает драйвер:
355
355
  * для peer/trust-аутентификации пароль не нужен). Читается только, не создаётся.
@@ -365,13 +365,13 @@ export function resolvePostgresPassword(opts, env) {
365
365
  }
366
366
  return undefined;
367
367
  }
368
- /** PROP-032 (W5): допустимые политики при недоступности backend'а. */
368
+ /** ADR-098 (W5): допустимые политики при недоступности backend'а. */
369
369
  const DEGRADED_MODES = ['fallback-file', 'halt'];
370
370
  function isDegradedMode(value) {
371
371
  return typeof value === 'string' && DEGRADED_MODES.includes(value);
372
372
  }
373
373
  /**
374
- * PROP-032 (W5): политика при недоступности выбранного backend —
374
+ * ADR-098 (W5): политика при недоступности выбранного backend —
375
375
  * `fallback-file` (default) | `halt`. Читать через этот резолвер.
376
376
  *
377
377
  * Приоритет (ADR-023): env `SYNTH_DEGRADED_MODE` > `config.storage.degradedMode` >
@@ -389,7 +389,7 @@ export function resolveDegradedMode(config, env) {
389
389
  return config.storage.degradedMode ?? 'fallback-file';
390
390
  }
391
391
  /**
392
- * PROP-032 (W5): каталог файлового фоллбека. Приоритет (ADR-023): env
392
+ * ADR-098 (W5): каталог файлового фоллбека. Приоритет (ADR-023): env
393
393
  * `SYNTH_STORAGE_FALLBACK_DIR` > явный `config.storage.fallbackDir` → `''`
394
394
  * (эффективно `{dataDir}/fallback`).
395
395
  */