@itphx/synth-shared 0.10.1 → 0.12.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.
Files changed (104) hide show
  1. package/dist/config/defaults.js +172 -3
  2. package/dist/config/env-overrides.d.ts +33 -1
  3. package/dist/config/env-overrides.js +191 -5
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +4 -0
  7. package/dist/config/index.js +4 -0
  8. package/dist/config/loader.js +19 -0
  9. package/dist/config/proxy.d.ts +415 -0
  10. package/dist/config/proxy.js +1567 -0
  11. package/dist/config/resolve.d.ts +67 -0
  12. package/dist/config/resolve.js +187 -1
  13. package/dist/config/tls-runtime.d.ts +78 -0
  14. package/dist/config/tls-runtime.js +356 -0
  15. package/dist/config/tls.d.ts +215 -0
  16. package/dist/config/tls.js +394 -0
  17. package/dist/config/types.d.ts +1571 -2835
  18. package/dist/config/types.js +717 -58
  19. package/dist/i18n/index.d.ts +1 -1
  20. package/dist/i18n/index.js +279 -0
  21. package/dist/index.d.ts +24 -3
  22. package/dist/index.js +25 -2
  23. package/dist/model-metadata.d.ts +10 -0
  24. package/dist/protocols/index.d.ts +0 -1
  25. package/dist/schemas/index.d.ts +1014 -2231
  26. package/dist/schemas/index.js +222 -14
  27. package/dist/types/analytics.d.ts +113 -0
  28. package/dist/types/analytics.js +61 -0
  29. package/dist/types/authority.d.ts +464 -0
  30. package/dist/types/authority.js +445 -0
  31. package/dist/types/background.d.ts +96 -0
  32. package/dist/types/background.js +24 -0
  33. package/dist/types/bus-events.d.ts +23 -1
  34. package/dist/types/catalog.d.ts +349 -0
  35. package/dist/types/catalog.js +393 -0
  36. package/dist/types/decision.d.ts +28 -337
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +54 -2
  40. package/dist/types/external-credentials.d.ts +352 -0
  41. package/dist/types/external-credentials.js +200 -0
  42. package/dist/types/fs.d.ts +11 -0
  43. package/dist/types/fs.js +11 -0
  44. package/dist/types/hooks.d.ts +50 -9
  45. package/dist/types/index.d.ts +23 -0
  46. package/dist/types/index.js +55 -0
  47. package/dist/types/llm-filters.d.ts +150 -0
  48. package/dist/types/llm-filters.js +54 -0
  49. package/dist/types/maintenance.d.ts +39 -0
  50. package/dist/types/maintenance.js +11 -0
  51. package/dist/types/mcp.d.ts +101 -5
  52. package/dist/types/mcp.js +127 -5
  53. package/dist/types/message.d.ts +45 -1
  54. package/dist/types/pack.d.ts +1102 -0
  55. package/dist/types/pack.js +1003 -0
  56. package/dist/types/permission.d.ts +31 -15
  57. package/dist/types/permission.js +1 -1
  58. package/dist/types/pipeline-engine.d.ts +453 -0
  59. package/dist/types/pipeline-engine.js +440 -0
  60. package/dist/types/pipeline.d.ts +275 -0
  61. package/dist/types/pipeline.js +212 -0
  62. package/dist/types/plugin-audit.d.ts +110 -0
  63. package/dist/types/plugin-audit.js +185 -0
  64. package/dist/types/plugin-hybrid.d.ts +85 -0
  65. package/dist/types/plugin-hybrid.js +68 -0
  66. package/dist/types/plugin-lock.d.ts +95 -0
  67. package/dist/types/plugin-lock.js +1 -0
  68. package/dist/types/plugin-protocol.d.ts +221 -0
  69. package/dist/types/plugin-protocol.js +322 -0
  70. package/dist/types/plugin-runtime.d.ts +25 -0
  71. package/dist/types/plugin-runtime.js +11 -0
  72. package/dist/types/plugin-scan.d.ts +159 -0
  73. package/dist/types/plugin-scan.js +166 -0
  74. package/dist/types/plugin-tools.d.ts +51 -0
  75. package/dist/types/plugin-tools.js +72 -0
  76. package/dist/types/project.d.ts +14 -0
  77. package/dist/types/prompt-blocks.d.ts +102 -0
  78. package/dist/types/prompt-blocks.js +24 -0
  79. package/dist/types/prompt.d.ts +47 -4
  80. package/dist/types/provider.d.ts +11 -0
  81. package/dist/types/question.d.ts +153 -0
  82. package/dist/types/question.js +65 -0
  83. package/dist/types/schedules.d.ts +26 -3
  84. package/dist/types/semver.d.ts +48 -0
  85. package/dist/types/semver.js +218 -0
  86. package/dist/types/service-keys.d.ts +41 -3
  87. package/dist/types/service-keys.js +44 -2
  88. package/dist/types/session.d.ts +54 -1
  89. package/dist/types/steering.d.ts +74 -0
  90. package/dist/types/steering.js +75 -0
  91. package/dist/types/tools.d.ts +125 -5
  92. package/dist/types/tools.js +75 -0
  93. package/dist/types/trust.d.ts +31 -0
  94. package/dist/types/trust.js +27 -0
  95. package/dist/types/webhooks.d.ts +1 -1
  96. package/dist/types/worktree.d.ts +170 -0
  97. package/dist/types/worktree.js +101 -0
  98. package/dist/utils/index.d.ts +46 -1
  99. package/dist/utils/index.js +145 -12
  100. package/dist/utils/reasoning.d.ts +16 -0
  101. package/dist/utils/reasoning.js +37 -0
  102. package/dist/version.d.ts +1 -1
  103. package/dist/version.js +1 -1
  104. package/package.json +2 -2
@@ -0,0 +1,1003 @@
1
+ /**
2
+ * ADR-086 §5 / ADR-090: единый манифест расширения `synth.pack`.
3
+ *
4
+ * Манифест — файл `synth.pack` (JSON) в корне репозитория расширения. Формат
5
+ * **общий** для всех классов расширений: Plugin (ADR-090), Gateway (ADR-087),
6
+ * Add-on (эталон — `synth-media`), контент-пак (PROP-068) и драйвер слоя
7
+ * хранения (`kind: 'storage'`, ADR-097).
8
+ *
9
+ * Здесь только контракт (типы + zod-схемы): загрузка, установка и активация
10
+ * расширений — в core (ADR-090 отложен до 2026-10-19). Модуль browser-safe
11
+ * (`zod` + локальные типы), в UI-бандл `node:*` не попадает.
12
+ */
13
+ import { z } from 'zod';
14
+ import { authorityActionSchema, authorityRoleSchema, authorityTargetDeclarationSchema, isAuthorityMutatingAction, validateAuthorityContent, } from './authority.js';
15
+ import { pipelineDefinitionSchema } from './pipeline.js';
16
+ import { SEMVER_RANGE_REGEX, isSemverRange, satisfiesSemverRange } from './semver.js';
17
+ import { CATALOG_TRUST_LEVELS, catalogTrustLevelSchema, trustLevelRank } from './trust.js';
18
+ import { ToolCapability } from './tools.js';
19
+ // --- Реестры классов и типов расширений ---
20
+ /**
21
+ * Классы расширений (ADR-086 §5):
22
+ * - `plugin` — код в процессе ядра (ADR-090);
23
+ * - `gateway` — внешний транспорт «внешний мир ↔ Synth» (ADR-087);
24
+ * - `addon` — внешний сервис-надстройка (эталон — `synth-media`);
25
+ * - `pack` — контент-пак;
26
+ * - `storage` — драйвер слоя хранения (ADR-097).
27
+ */
28
+ export const PACK_KINDS = ['plugin', 'gateway', 'addon', 'pack', 'storage'];
29
+ export const packKindSchema = z.enum(PACK_KINDS);
30
+ /**
31
+ * Типы контент-пака (`kind: 'pack'`) — ADR-086 §5 / PROP-068.
32
+ *
33
+ * `packType` описывает **основной** вид вклада пака; фактический состав задаёт
34
+ * `provides`. Решение владельца: «контент-пак» = **набор `provides`**, поэтому
35
+ * `provides` у любого класса (в т.ч. у `addon` — у `synth-media` свой
36
+ * сервис-receiver, `kind` остаётся `addon`) может включать `agents` и
37
+ * `pipelines`; `packType` — только для `kind: 'pack'`.
38
+ */
39
+ export const PACK_TYPES = [
40
+ 'skills',
41
+ 'agents',
42
+ 'mcp',
43
+ 'themes',
44
+ 'i18n',
45
+ 'providers',
46
+ 'prompts',
47
+ 'automation',
48
+ 'policies',
49
+ 'memory',
50
+ 'ui',
51
+ ];
52
+ export const packTypeSchema = z.enum(PACK_TYPES);
53
+ // --- Имя, версия, диапазон версий host ---
54
+ /**
55
+ * Имя расширения: slug (`synth-media`) либо npm-имя со scope
56
+ * (`@itphx/synth-gateway-telegram`).
57
+ */
58
+ export const PACK_NAME_REGEX = /^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
59
+ export const packNameSchema = z
60
+ .string()
61
+ .min(1)
62
+ .max(214)
63
+ .regex(PACK_NAME_REGEX, 'имя расширения: slug или npm-имя со scope (строчные латинские буквы/цифры, разделитель — дефис)');
64
+ /** Semver версии расширения (`MAJOR.MINOR.PATCH`, с пре-релизом/сборкой). */
65
+ export const PACK_VERSION_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
66
+ export const packVersionSchema = z
67
+ .string()
68
+ .min(1)
69
+ .regex(PACK_VERSION_REGEX, 'версия расширения: semver (MAJOR.MINOR.PATCH)');
70
+ /**
71
+ * Диапазон версий host-приложения — semver-range, как `engines` в package.json
72
+ * (`^0.9.0`, `~1.2.3`, `>=1.0.0 <2.0.0`, `1.x`).
73
+ *
74
+ * Грамматика — единая для `host` и `contracts` манифеста (ADR-090):
75
+ * реализация и матчер — в `types/semver.ts`.
76
+ */
77
+ export const PACK_HOST_RANGE_REGEX = SEMVER_RANGE_REGEX;
78
+ /** Проверяет, что значение — корректный semver-диапазон (host-версия). */
79
+ export function isPackHostRange(value) {
80
+ return isSemverRange(value);
81
+ }
82
+ export const packHostSchema = z
83
+ .string()
84
+ .min(1)
85
+ .refine(isPackHostRange, 'диапазон версий host: semver-range (например, ^0.9.0)');
86
+ // --- Вклады (`provides`) ---
87
+ /**
88
+ * MCP-предоставление: MCP-сервер, который расширение регистрирует в инстансе
89
+ * (ADR-071). `transport: 'http'` — сервер в контуре расширения (адрес собирается
90
+ * из `url`/`port`+`path`), `transport: 'stdio'` — локальный процесс.
91
+ */
92
+ export const packMcpProvideSchema = z.object({
93
+ /** Имя MCP-сервера (как в реестре MCP). */
94
+ name: z.string().min(1),
95
+ transport: z.enum(['http', 'stdio']),
96
+ /** Порт HTTP-сервера. */
97
+ port: z.number().int().positive().optional(),
98
+ /** Путь HTTP-сервера (может быть шаблоном, напр. `/mcp/{tenant}`). */
99
+ path: z.string().min(1).optional(),
100
+ /** Полный URL HTTP-сервера. */
101
+ url: z.string().min(1).optional(),
102
+ /** Человекочитаемое описание. */
103
+ description: z.string().optional(),
104
+ /** Заголовки HTTP-сервера (без секретов — инвариант 13). */
105
+ headers: z.record(z.string(), z.string()).optional(),
106
+ });
107
+ /**
108
+ * Метаданные скилла в манифесте. Блок `metadata.synth` (ADR-046 §6.2:
109
+ * `agents`/`requires_capabilities`/`scope`/`trigger`/`groups`) произвольный по
110
+ * составу — схема его не детализирует, но и не отбрасывает.
111
+ */
112
+ export const packSkillMetadataSchema = z
113
+ .object({ synth: z.record(z.string(), z.unknown()).optional() })
114
+ .catchall(z.unknown());
115
+ /** Скилл-предоставление (ADR-046): каталог скилла внутри пака. */
116
+ export const packSkillProvideSchema = z.object({
117
+ /** Имя скилла (совпадает с `SKILL_NAME_REGEX` конвенцией ADR-046 §3.2). */
118
+ name: z.string().min(1),
119
+ /** Путь к каталогу скилла относительно корня расширения. */
120
+ path: z.string().min(1),
121
+ metadata: packSkillMetadataSchema.optional(),
122
+ });
123
+ /** Режимы агента — зеркалят `AgentMode` (`types/agent.ts`). */
124
+ export const PACK_AGENT_MODES = [
125
+ 'primary',
126
+ 'subagent',
127
+ 'system',
128
+ ];
129
+ /**
130
+ * Агент-предоставление (PROP-068: agent-паки). Поля повторяют
131
+ * `AgentDefinition` (`types/agent.ts`), но без runtime-полей (`enabled`,
132
+ * `isOverridden`): манифест объявляет **предоставление**, а не состояние.
133
+ *
134
+ * `capabilities` — строки; принадлежность известному набору `ToolCapability`
135
+ * проверяет `validatePackManifest` (схема намеренно терпима: новые capability
136
+ * не должны ломать чтение манифеста).
137
+ */
138
+ export const packAgentProvideSchema = z.object({
139
+ /** Идентификатор агента (уникален в пределах пака). */
140
+ id: z.string().min(1),
141
+ /** Путь к файлу/каталогу определения агента. */
142
+ path: z.string().min(1).optional(),
143
+ /** Ролевой промпт агента: файл (`path`) или inline-текст (`content`). */
144
+ rolePrompt: z
145
+ .object({
146
+ path: z.string().min(1).optional(),
147
+ content: z.string().optional(),
148
+ })
149
+ .optional(),
150
+ /** Отображаемое имя. */
151
+ displayName: z.string().optional(),
152
+ /** Краткое описание. */
153
+ description: z.string().optional(),
154
+ /** Группы инструментов (capability), см. `validatePackManifest`. */
155
+ capabilities: z.array(z.string()).optional(),
156
+ /** Режим агента (один или несколько). */
157
+ agentMode: z.union([z.enum(PACK_AGENT_MODES), z.array(z.enum(PACK_AGENT_MODES))]).optional(),
158
+ /** Иконка агента (ключ/эмодзи). */
159
+ icon: z.string().optional(),
160
+ /** Цвет агента (ключ палитры). */
161
+ color: z.string().optional(),
162
+ /** Провайдер по умолчанию. */
163
+ provider: z.string().optional(),
164
+ /** Модель по умолчанию. */
165
+ model: z.string().optional(),
166
+ /** Группы агентов (ADR-046 §6.2: привязка скиллов к агентам). */
167
+ groups: z.array(z.string()).optional(),
168
+ /** Лимит шагов агента (`0` — без ограничений). */
169
+ maxSteps: z.number().int().min(0).optional(),
170
+ });
171
+ /**
172
+ * Пайплайн-предоставление (ADR-051/ADR-100): описание автомата. Либо файл
173
+ * (`path`), либо inline-определение (`definition` — тот же контракт, что и
174
+ * `pipelineDefinitionSchema`).
175
+ */
176
+ export const packPipelineProvideSchema = z.object({
177
+ /** Идентификатор пайплайна (уникален в пределах пака). */
178
+ id: z.string().min(1),
179
+ /** Путь к файлу определения пайплайна. */
180
+ path: z.string().min(1).optional(),
181
+ /** Inline-определение пайплайна. */
182
+ definition: pipelineDefinitionSchema.optional(),
183
+ });
184
+ /**
185
+ * `provides.mcp` — массив MCP-серверов **или** одиночный объект.
186
+ *
187
+ * Объектная форма — обратная совместимость: уже выпущенные манифесты
188
+ * (`synth-media`, `synth-gateway-telegram`) объявляют `provides.mcp` объектом.
189
+ * Форма нормализуется в массив, чтобы один пак мог регистрировать несколько
190
+ * MCP-серверов; `normalizePackProvides` делает то же для сырого JSON.
191
+ */
192
+ export const packMcpProvidesSchema = z
193
+ .union([z.array(packMcpProvideSchema), packMcpProvideSchema])
194
+ .transform((value) => (Array.isArray(value) ? value : [value]));
195
+ // --- Вклады плагина (ADR-090) ---
196
+ /**
197
+ * ADR-090: режим исполнения плагина — `inline` (код в процессе core) или
198
+ * `remote` (отдельный процесс), `both` — оба транспорта.
199
+ *
200
+ * Поле допустимо **только** для `kind: 'plugin'` (у остальных классов режим
201
+ * исполнения не задаётся — см. `validatePackManifest`).
202
+ */
203
+ export const PACK_PLUGIN_MODES = ['inline', 'remote', 'both'];
204
+ export const packPluginModeSchema = z.enum(PACK_PLUGIN_MODES);
205
+ /**
206
+ * ADR-090: заявленные расширением доступы (`permissions`).
207
+ *
208
+ * - `network` — хосты, к которым плагин обращается (проверяются по
209
+ * egress-политике, ADR-099);
210
+ * - `secrets` — имена секретов, которые плагин запрашивает через API
211
+ * (at-rest по модели ADR-076; значение секрета в манифесте не хранится);
212
+ * - `tools` — имена встроенных тулов, которые плагин использует;
213
+ * - `hooks` — имена хуков, на которые плагин подписывается.
214
+ *
215
+ * Заявление прав — **не** само разрешение: фактический доступ определяется
216
+ * permission-слоем (ADR-025/ADR-028/ADR-029) и egress-политикой.
217
+ */
218
+ export const packPermissionsSchema = z.object({
219
+ network: z.array(z.string().min(1)).default([]),
220
+ secrets: z.array(z.string().min(1)).default([]),
221
+ tools: z.array(z.string().min(1)).default([]),
222
+ hooks: z.array(z.string().min(1)).default([]),
223
+ });
224
+ /**
225
+ * ADR-090: заявленный автором уровень/источник доверия.
226
+ *
227
+ * **Заявленный уровень — только верхняя граница:** фактический trust
228
+ * резолвится по источнику/реестру (PROP-068 §4.1), манифест не может его
229
+ * повысить. Для `kind: 'plugin'` уровень не должен быть выше `trusted`
230
+ * (trust-floor плагина, ADR-090) — проверяется в `validatePackManifest`.
231
+ */
232
+ export const packTrustSchema = z.object({
233
+ level: catalogTrustLevelSchema.optional(),
234
+ source: z.string().min(1).optional(),
235
+ });
236
+ /**
237
+ * ADR-090: `provides.tools[]` — имена тулов, которые регистрирует
238
+ * плагин (имя тула — `tool.name` в `ToolRegistry.register`).
239
+ *
240
+ * Имена уникальны в пределах манифеста; фактические регистрации обязаны
241
+ * совпадать с этим списком (сверка — `diffPackProvides`).
242
+ */
243
+ export const packToolsProvideSchema = z
244
+ .array(z.string().min(1, 'имя тула: непустая строка'))
245
+ .superRefine((names, ctx) => {
246
+ const seen = new Set();
247
+ names.forEach((name, index) => {
248
+ if (seen.has(name)) {
249
+ ctx.addIssue({
250
+ code: z.ZodIssueCode.custom,
251
+ message: `дубликат имени тула «${name}»`,
252
+ path: [index],
253
+ });
254
+ }
255
+ seen.add(name);
256
+ });
257
+ });
258
+ /**
259
+ * ADR-090: `provides.promptBlocks[]` — описание плагинных блоков
260
+ * системного промпта.
261
+ *
262
+ * - `key` — ключ блока (для плагина — `plugin.<pluginName>.<slot>`);
263
+ * - `tier` — тир блока: **только** `context`/`volatile`; `stable` запрещён
264
+ * (граница prompt-cache, ADR-070);
265
+ * - `order` — порядок внутри тира (число);
266
+ * - `title`/`provenance` — подпись для манифеста промпта и источник
267
+ * (`provenance` для плагинного блока — `plugin:<name>`).
268
+ *
269
+ * Схема **строгая** (`.strict()`): неизвестное поле — ошибка, а не молчаливое
270
+ * проигнорирование (иначе опечатка в манифесте проходит незамеченной).
271
+ */
272
+ export const packPromptBlockProvideSchema = z
273
+ .object({
274
+ key: z.string().min(1),
275
+ tier: z.enum(['context', 'volatile']),
276
+ order: z.number().int(),
277
+ title: z.string().min(1).optional(),
278
+ provenance: z.string().min(1).optional(),
279
+ })
280
+ .strict();
281
+ /**
282
+ * ADR-090: `provides.llmFilters[]` — описание фильтров LLM-вызовов.
283
+ *
284
+ * - `id` — идентификатор фильтра (`plugin:<pluginName>:<filterName>`);
285
+ * - `phase` — фаза: `pre_request` / `post_response` / `embedding`
286
+ * (третья фаза — решение владельца 2026-10-22);
287
+ * - `failMode` — поведение при сбое/таймауте фильтра (`open` — пропустить,
288
+ * `closed` — заблокировать); не задан — по классу фильтра (блокирующий —
289
+ * `closed`, наблюдательный — `open`);
290
+ * - `timeoutMs` — бюджет времени на вызов фильтра (мс).
291
+ */
292
+ export const packLlmFilterProvideSchema = z
293
+ .object({
294
+ id: z.string().min(1),
295
+ phase: z.enum(['pre_request', 'post_response', 'embedding']),
296
+ failMode: z.enum(['open', 'closed']).optional(),
297
+ timeoutMs: z.number().int().positive().optional(),
298
+ })
299
+ .strict();
300
+ /**
301
+ * ADR-106 §«Доменная нейтральность и доставка контентом»: агент, которому
302
+ * пакет поставляет роли и потолок.
303
+ *
304
+ * `roles[]` — роли агента (id из `provides.authority.roles[]`), `ceiling[]` —
305
+ * потолок агента (id действий из `provides.authority.actions[]`). Оба списка
306
+ * проверяются на объявленность — неизвестная роль/действие → отказ установки.
307
+ */
308
+ export const packAuthorityAgentProvideSchema = z
309
+ .object({
310
+ /** Идентификатор агента (уникален в пределах пака). */
311
+ id: z.string().min(1).max(128),
312
+ /** Роли агента (id из `provides.authority.roles[]`). */
313
+ roles: z.array(z.string().min(1).max(128)).default([]),
314
+ /** Потолок агента — идентификаторы действий. */
315
+ ceiling: z.array(z.string().min(1).max(64)).default([]),
316
+ })
317
+ .strict();
318
+ /**
319
+ * ADR-106: `provides.authority` — **контент** полномочий: роли, действия,
320
+ * цели и агенты с ролями.
321
+ *
322
+ * Схема **строгая** (`.strict()`): неизвестное поле — ошибка, а не молчаливое
323
+ * игнорирование. Кросс-ссылки проверяются на разборе: грант на
324
+ * необъявленное действие, агент на необъявленную роль, шаблон цели на
325
+ * неизвестный вид цели → **отказ** (ADR-106 §«Валидация, а не каст»).
326
+ *
327
+ * Пакет **не выдаёт права сам себе**: объявленные роли становятся активными
328
+ * только после одобрения ADMIN и пересечения с политикой инстанса
329
+ * (ADR-106 §«Пересечение, не дарование»).
330
+ */
331
+ export const packAuthorityProvidesSchema = z
332
+ .object({
333
+ /** Роли (именованные наборы грантов). */
334
+ roles: z.array(authorityRoleSchema).default([]),
335
+ /** Объявленные доменные действия. */
336
+ actions: z.array(authorityActionSchema).default([]),
337
+ /** Виды целей, которые пакет вводит (доменные). */
338
+ targets: z.array(authorityTargetDeclarationSchema).default([]),
339
+ /** Агенты с ролями и потолком. */
340
+ agents: z.array(packAuthorityAgentProvideSchema).default([]),
341
+ })
342
+ .strict()
343
+ .superRefine((value, ctx) => {
344
+ const problems = validateAuthorityContent({
345
+ actions: value.actions,
346
+ roles: value.roles,
347
+ targets: value.targets,
348
+ agents: value.agents,
349
+ });
350
+ for (const problem of problems) {
351
+ ctx.addIssue({ code: z.ZodIssueCode.custom, message: problem });
352
+ }
353
+ });
354
+ /** true — значение — объект (не массив, не null). */
355
+ function isPlainObject(value) {
356
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
357
+ }
358
+ /** Список строк из «сырого» значения (только строки). */
359
+ function stringList(value) {
360
+ if (!Array.isArray(value))
361
+ return [];
362
+ return value.filter((item) => typeof item === 'string');
363
+ }
364
+ /**
365
+ * Сводка контента полномочий пакета (`provides.authority`).
366
+ *
367
+ * Принимает **сырой** `provides` (как в сохранённом манифесте) — разбор
368
+ * defensive: неизвестные/битые элементы пропускаются, а не роняют ответ.
369
+ * Пустой контент → пустая сводка (нулевые итоги).
370
+ */
371
+ export function summarizePackAuthority(provides) {
372
+ const authority = isPlainObject(provides) && isPlainObject(provides.authority)
373
+ ? provides.authority
374
+ : {};
375
+ const rawRoles = Array.isArray(authority.roles) ? authority.roles : [];
376
+ const roles = [];
377
+ for (const raw of rawRoles) {
378
+ if (!isPlainObject(raw))
379
+ continue;
380
+ const id = typeof raw.id === 'string' ? raw.id : '';
381
+ if (!id)
382
+ continue;
383
+ const grants = Array.isArray(raw.grants) ? raw.grants : [];
384
+ const mutatingGrants = grants.filter((grant) => {
385
+ if (!isPlainObject(grant))
386
+ return false;
387
+ const action = typeof grant.action === 'string' ? grant.action : '';
388
+ return action !== '' && isAuthorityMutatingAction(action);
389
+ }).length;
390
+ roles.push({
391
+ id,
392
+ ...(typeof raw.displayName === 'string' ? { displayName: raw.displayName } : {}),
393
+ domain: typeof raw.domain === 'string' ? raw.domain : '',
394
+ grants: grants.length,
395
+ mutatingGrants,
396
+ });
397
+ }
398
+ const rawActions = Array.isArray(authority.actions) ? authority.actions : [];
399
+ const actions = [];
400
+ for (const raw of rawActions) {
401
+ if (!isPlainObject(raw))
402
+ continue;
403
+ const id = typeof raw.id === 'string' ? raw.id : '';
404
+ if (!id)
405
+ continue;
406
+ actions.push({ id, mutating: raw.mutating === true });
407
+ }
408
+ const rawTargets = Array.isArray(authority.targets) ? authority.targets : [];
409
+ const targets = [];
410
+ for (const raw of rawTargets) {
411
+ if (!isPlainObject(raw))
412
+ continue;
413
+ const kind = typeof raw.kind === 'string' ? raw.kind : '';
414
+ if (!kind)
415
+ continue;
416
+ targets.push({
417
+ kind,
418
+ ...(typeof raw.resolver === 'string' ? { resolver: raw.resolver } : {}),
419
+ });
420
+ }
421
+ const rawAgents = Array.isArray(authority.agents) ? authority.agents : [];
422
+ const agents = [];
423
+ for (const raw of rawAgents) {
424
+ if (!isPlainObject(raw))
425
+ continue;
426
+ const id = typeof raw.id === 'string' ? raw.id : '';
427
+ if (!id)
428
+ continue;
429
+ agents.push({
430
+ id,
431
+ roles: stringList(raw.roles),
432
+ ceiling: stringList(raw.ceiling),
433
+ });
434
+ }
435
+ const grants = roles.reduce((sum, role) => sum + role.grants, 0);
436
+ const mutatingGrants = roles.reduce((sum, role) => sum + role.mutatingGrants, 0);
437
+ return {
438
+ roles,
439
+ actions,
440
+ targets,
441
+ agents,
442
+ totals: {
443
+ roles: roles.length,
444
+ actions: actions.length,
445
+ targets: targets.length,
446
+ agents: agents.length,
447
+ grants,
448
+ mutatingGrants,
449
+ },
450
+ };
451
+ }
452
+ /** Контент полномочий пакета непустой? (пустой контент — нечего активировать). */
453
+ export function hasPackAuthorityContent(provides) {
454
+ const summary = summarizePackAuthority(provides);
455
+ return (summary.totals.roles > 0 ||
456
+ summary.totals.actions > 0 ||
457
+ summary.totals.targets > 0 ||
458
+ summary.totals.agents > 0);
459
+ }
460
+ /**
461
+ * Набор вкладов расширения. Списки нормализованы (отсутствующий список —
462
+ * пустой массив), неизвестные ключи сохраняются: виды вкладов расширяются
463
+ * без изменения формата манифеста.
464
+ *
465
+ * Ключи `tools`/`promptBlocks`/`llmFilters` (ADR-090) описаны **явными**
466
+ * схемами — без `.passthrough()`: иначе опечатка в манифесте (пустое имя тула,
467
+ * дубль, тир `stable`, неизвестная фаза фильтра) проходит молча, и правило
468
+ * «фактические регистрации обязаны совпадать с `provides`» нечем проверять.
469
+ *
470
+ * `authority` (ADR-106) — тоже **явная** схема: контент полномочий не
471
+ * проходит «как есть» (неизвестное действие/цель/роль → отказ разбора).
472
+ */
473
+ export const packProvidesSchema = z
474
+ .object({
475
+ mcp: packMcpProvidesSchema.default([]),
476
+ skills: z.array(packSkillProvideSchema).default([]),
477
+ agents: z.array(packAgentProvideSchema).default([]),
478
+ pipelines: z.array(packPipelineProvideSchema).default([]),
479
+ tools: packToolsProvideSchema.default([]),
480
+ promptBlocks: z.array(packPromptBlockProvideSchema).default([]),
481
+ llmFilters: z.array(packLlmFilterProvideSchema).default([]),
482
+ authority: packAuthorityProvidesSchema.prefault({}),
483
+ })
484
+ .passthrough();
485
+ // --- Манифест ---
486
+ /**
487
+ * Инвариант `packType` — общий для манифеста (`packManifestSchema`) и карточки
488
+ * каталога расширений (`catalogEntrySchema`, PROP-068 §12):
489
+ * - `kind: 'pack'` **требует** `packType`;
490
+ * - `packType` запрещён у остальных `kind` (`addon`/`gateway`/`plugin`/
491
+ * `storage` — это классы кода/сервиса, а не контент-паки).
492
+ */
493
+ export function refinePackType(value, ctx) {
494
+ if (value.kind === 'pack' && value.packType === undefined) {
495
+ ctx.addIssue({
496
+ code: z.ZodIssueCode.custom,
497
+ message: 'packType обязателен для kind «pack»',
498
+ path: ['packType'],
499
+ });
500
+ }
501
+ if (value.kind !== 'pack' && value.packType !== undefined) {
502
+ ctx.addIssue({
503
+ code: z.ZodIssueCode.custom,
504
+ message: `packType допустим только для kind «pack» (kind: «${value.kind}»)`,
505
+ path: ['packType'],
506
+ });
507
+ }
508
+ }
509
+ /**
510
+ * Единый манифест расширения `synth.pack` (ADR-086 §5).
511
+ *
512
+ * Инварианты, зашитые в схему:
513
+ * - `kind: 'pack'` **требует** `packType`;
514
+ * - `packType` запрещён у остальных `kind` (`addon`/`gateway`/`plugin`/
515
+ * `storage` — это классы кода/сервиса, а не контент-паки).
516
+ *
517
+ * Поля `mode`/`permissions`/`trust` (ADR-090) — опциональные и
518
+ * **явные**: `z.object` выбрасывает неизвестные ключи, поэтому без них
519
+ * эти поля молча терялись при разборе манифеста.
520
+ */
521
+ export const packManifestSchema = z
522
+ .object({
523
+ /** Имя расширения (slug или npm-имя со scope). */
524
+ name: packNameSchema,
525
+ /** Semver версии расширения. */
526
+ version: packVersionSchema,
527
+ /** Класс расширения. */
528
+ kind: packKindSchema,
529
+ /** Диапазон версий host-приложения (semver-range). */
530
+ host: packHostSchema.optional(),
531
+ /**
532
+ * Версии контрактов, которые расширение использует (напр. `apiV2: '^2'`).
533
+ * Значения — semver-диапазоны (та же грамматика, что у `host`).
534
+ */
535
+ contracts: z
536
+ .record(z.string(), z.string())
537
+ .optional()
538
+ .refine((contracts) => Object.values(contracts ?? {}).every((range) => isSemverRange(range)), 'contracts: значения — semver-диапазоны (например, "^1")'),
539
+ /** Краткое описание (инспекция/каталог). */
540
+ description: z.string().min(1),
541
+ /** Что расширение регистрирует. */
542
+ provides: packProvidesSchema,
543
+ /** Тип контент-пака — только для `kind: 'pack'`. */
544
+ packType: packTypeSchema.optional(),
545
+ /** ADR-090: режим исполнения — только для `kind: 'plugin'`. */
546
+ mode: packPluginModeSchema.optional(),
547
+ /** ADR-090: заявленные расширением доступы. */
548
+ permissions: packPermissionsSchema.optional(),
549
+ /** ADR-090: заявленный уровень/источник доверия (верхняя граница). */
550
+ trust: packTrustSchema.optional(),
551
+ })
552
+ .superRefine(refinePackType);
553
+ // --- Нормализация и проверка целостности ---
554
+ function isRecord(value) {
555
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
556
+ }
557
+ /** Одиночный объект → массив из одного элемента; массив — как есть. */
558
+ function toMcpList(value) {
559
+ if (Array.isArray(value))
560
+ return value;
561
+ if (isRecord(value))
562
+ return [value];
563
+ return [];
564
+ }
565
+ /** Только массив; всё прочее (в т.ч. объект) → пустой список. */
566
+ function toList(value) {
567
+ return Array.isArray(value) ? value : [];
568
+ }
569
+ /**
570
+ * Нормализация `provides` из сырого JSON: `mcp`-объект → массив, отсутствующие
571
+ * списки → пустые массивы, прочие (пока неизвестные) виды вкладов сохраняются.
572
+ *
573
+ * Зачем отдельная функция: манифесты `synth-media` и `synth-gateway-telegram`
574
+ * (выпущены и работают) объявляют `provides.mcp` **объектом**. Переход на
575
+ * массив не должен ломать их — потребитель (загрузчик расширений в core)
576
+ * всегда работает с нормализованной формой и не знает про legacy-объект.
577
+ *
578
+ * Нормализация отвечает только за **форму** (списки вместо объекта/пустоты);
579
+ * содержимое элементов остаётся ответственностью `packProvidesSchema`
580
+ * (валидация) — здесь элементы не проверяются и не отбрасываются.
581
+ */
582
+ export function normalizePackProvides(provides) {
583
+ const source = isRecord(provides) ? provides : {};
584
+ return {
585
+ ...source,
586
+ mcp: toMcpList(source.mcp),
587
+ skills: toList(source.skills),
588
+ agents: toList(source.agents),
589
+ pipelines: toList(source.pipelines),
590
+ tools: toList(source.tools),
591
+ promptBlocks: toList(source.promptBlocks),
592
+ llmFilters: toList(source.llmFilters),
593
+ // ADR-106: контент полномочий нормализуется так же (списки вместо
594
+ // отсутствия). Содержимое проверяет `packAuthorityProvidesSchema`.
595
+ authority: {
596
+ roles: toList(source.authority?.roles),
597
+ actions: toList(source.authority?.actions),
598
+ targets: toList(source.authority?.targets),
599
+ agents: toList(source.authority?.agents),
600
+ },
601
+ };
602
+ }
603
+ /**
604
+ * Проверка целостности манифеста — **список проблем строками**, без throw.
605
+ *
606
+ * Функция принимает «сырое» значение (например, разобранный JSON): в отличие
607
+ * от `packManifestSchema` она не отбрасывает манифест целиком, а перечисляет
608
+ * все проблемы (неизвестный `kind`/`packType`, пустой `provides`, дубликаты,
609
+ * записи без обязательных полей, неизвестные capability).
610
+ *
611
+ * Разделение ответственности: `packManifestSchema` — **структура** (формат
612
+ * полей, semver, инвариант `packType`), `validatePackManifest` — **семантика**
613
+ * (смысловые правила целостности, перечисленные ниже).
614
+ *
615
+ * Проверяются правила:
616
+ * 1. неизвестный `kind`;
617
+ * 2. неизвестный `packType`;
618
+ * 3. `provides` без единого элемента;
619
+ * 4. `kind: 'pack'` без `packType`;
620
+ * 5. `packType` у другого `kind`;
621
+ * 6. дубликаты `name`/`id` внутри `provides`;
622
+ * 7. агент без `id`;
623
+ * 8. MCP без `name`/`transport`;
624
+ * 9. скилл без `name`/`path`;
625
+ * 10. пайплайн без `id`;
626
+ * 11. `agents[].capabilities` — строки из известного набора `ToolCapability`;
627
+ * 12. вклады плагина (`provides.tools`/`promptBlocks`/`llmFilters`) — по
628
+ * явным схемам ADR-090;
629
+ * 13. `mode` — только для `kind: 'plugin'`;
630
+ * 14. `trust.level` плагина — не выше `trusted` (trust-floor, ADR-090);
631
+ * 15. контент полномочий (`provides.authority`) — строгая схема + кросс-ссылки
632
+ * (ADR-106 §«Валидация, а не каст»): неизвестное действие/цель/роль —
633
+ * проблема, а не молчаливый проход.
634
+ */
635
+ export function validatePackManifest(manifest) {
636
+ const problems = [];
637
+ if (!isRecord(manifest)) {
638
+ return ['манифест: ожидается объект'];
639
+ }
640
+ // 1. Класс расширения.
641
+ const kind = manifest.kind;
642
+ if (typeof kind !== 'string' || kind.trim() === '') {
643
+ problems.push('kind: обязательное поле (класс расширения)');
644
+ }
645
+ else if (!PACK_KINDS.includes(kind)) {
646
+ problems.push(`kind: неизвестный класс расширения «${kind}» (допустимо: ${PACK_KINDS.join('|')})`);
647
+ }
648
+ // 2/4/5. Тип контент-пака.
649
+ const packType = manifest.packType;
650
+ if (kind === 'pack') {
651
+ if (packType === undefined || packType === null) {
652
+ problems.push('packType: обязателен для kind «pack»');
653
+ }
654
+ else if (typeof packType !== 'string' || !PACK_TYPES.includes(packType)) {
655
+ problems.push(`packType: неизвестный тип контент-пака «${String(packType)}» (допустимо: ${PACK_TYPES.join('|')})`);
656
+ }
657
+ }
658
+ else if (packType !== undefined && packType !== null) {
659
+ problems.push(`packType: допустим только для kind «pack» (текущий kind — «${String(kind)}»)`);
660
+ }
661
+ // 3/6/7/8/9/10/11. Вклады.
662
+ const rawProvides = manifest.provides;
663
+ if (!isRecord(rawProvides)) {
664
+ problems.push('provides: ожидается объект с объявлениями вкладов');
665
+ return problems;
666
+ }
667
+ for (const key of ['skills', 'agents', 'pipelines', 'tools', 'promptBlocks', 'llmFilters']) {
668
+ const value = rawProvides[key];
669
+ if (value !== undefined && !Array.isArray(value)) {
670
+ problems.push(`provides.${key}: ожидается массив`);
671
+ }
672
+ }
673
+ const rawMcp = rawProvides.mcp;
674
+ if (rawMcp !== undefined && !Array.isArray(rawMcp) && !isRecord(rawMcp)) {
675
+ problems.push('provides.mcp: ожидается объект или массив объектов');
676
+ }
677
+ const rawAuthority = rawProvides.authority;
678
+ if (rawAuthority !== undefined && !isRecord(rawAuthority)) {
679
+ problems.push('provides.authority: ожидается объект { roles[], actions[], targets[], agents[] }');
680
+ }
681
+ const provides = normalizePackProvides(rawProvides);
682
+ const authorityCount = provides.authority.roles.length
683
+ + provides.authority.actions.length
684
+ + provides.authority.targets.length
685
+ + provides.authority.agents.length;
686
+ const declared = provides.mcp.length
687
+ + provides.skills.length
688
+ + provides.agents.length
689
+ + provides.pipelines.length
690
+ + provides.tools.length
691
+ + provides.promptBlocks.length
692
+ + provides.llmFilters.length
693
+ + authorityCount;
694
+ if (declared === 0) {
695
+ problems.push('provides: не заявлен ни один вклад (mcp/skills/agents/pipelines/tools/promptBlocks/llmFilters/authority)');
696
+ }
697
+ // MCP: имя + транспорт, дубликаты имён.
698
+ const mcpNames = new Set();
699
+ provides.mcp.forEach((item, index) => {
700
+ if (!isRecord(item)) {
701
+ problems.push(`provides.mcp[${index}]: ожидается объект`);
702
+ return;
703
+ }
704
+ const name = item.name;
705
+ if (typeof name !== 'string' || name.trim() === '') {
706
+ problems.push(`provides.mcp[${index}]: MCP без поля «name»`);
707
+ }
708
+ else if (mcpNames.has(name)) {
709
+ problems.push(`provides.mcp[${index}]: дубликат имени MCP «${name}»`);
710
+ }
711
+ else {
712
+ mcpNames.add(name);
713
+ }
714
+ const transport = item.transport;
715
+ if (typeof transport !== 'string' || transport.trim() === '') {
716
+ problems.push(`provides.mcp[${index}]: MCP без поля «transport»`);
717
+ }
718
+ else if (transport !== 'http' && transport !== 'stdio') {
719
+ problems.push(`provides.mcp[${index}]: неизвестный транспорт MCP «${transport}» (допустимо: http|stdio)`);
720
+ }
721
+ });
722
+ // Скиллы: имя + путь, дубликаты имён.
723
+ const skillNames = new Set();
724
+ provides.skills.forEach((item, index) => {
725
+ if (!isRecord(item)) {
726
+ problems.push(`provides.skills[${index}]: ожидается объект`);
727
+ return;
728
+ }
729
+ const name = item.name;
730
+ if (typeof name !== 'string' || name.trim() === '') {
731
+ problems.push(`provides.skills[${index}]: скилл без поля «name»`);
732
+ }
733
+ else if (skillNames.has(name)) {
734
+ problems.push(`provides.skills[${index}]: дубликат имени скилла «${name}»`);
735
+ }
736
+ else {
737
+ skillNames.add(name);
738
+ }
739
+ if (typeof item.path !== 'string' || item.path.trim() === '') {
740
+ problems.push(`provides.skills[${index}]: скилл без поля «path»`);
741
+ }
742
+ });
743
+ // Агенты: id, дубликаты id, известные capability.
744
+ const agentIds = new Set();
745
+ provides.agents.forEach((item, index) => {
746
+ if (!isRecord(item)) {
747
+ problems.push(`provides.agents[${index}]: ожидается объект`);
748
+ return;
749
+ }
750
+ const id = item.id;
751
+ if (typeof id !== 'string' || id.trim() === '') {
752
+ problems.push(`provides.agents[${index}]: агент без поля «id»`);
753
+ }
754
+ else if (agentIds.has(id)) {
755
+ problems.push(`provides.agents[${index}]: дубликат id агента «${id}»`);
756
+ }
757
+ else {
758
+ agentIds.add(id);
759
+ }
760
+ const capabilities = item.capabilities;
761
+ if (capabilities === undefined)
762
+ return;
763
+ if (!Array.isArray(capabilities)) {
764
+ problems.push(`provides.agents[${index}].capabilities: ожидается массив строк`);
765
+ return;
766
+ }
767
+ const known = Object.values(ToolCapability);
768
+ capabilities.forEach((capability, capIndex) => {
769
+ if (typeof capability !== 'string' || !known.includes(capability)) {
770
+ problems.push(`provides.agents[${index}].capabilities[${capIndex}]: неизвестная capability «${String(capability)}» (допустимо: ${known.join('|')})`);
771
+ }
772
+ });
773
+ });
774
+ // Пайплайны: id + дубликаты id.
775
+ const pipelineIds = new Set();
776
+ provides.pipelines.forEach((item, index) => {
777
+ if (!isRecord(item)) {
778
+ problems.push(`provides.pipelines[${index}]: ожидается объект`);
779
+ return;
780
+ }
781
+ const id = item.id;
782
+ if (typeof id !== 'string' || id.trim() === '') {
783
+ problems.push(`provides.pipelines[${index}]: пайплайн без поля «id»`);
784
+ }
785
+ else if (pipelineIds.has(id)) {
786
+ problems.push(`provides.pipelines[${index}]: дубликат id пайплайна «${id}»`);
787
+ }
788
+ else {
789
+ pipelineIds.add(id);
790
+ }
791
+ });
792
+ // 12. Вклады плагина (ADR-090): проверяются явными схемами — неизвестное
793
+ // поле, невалидный тир/фаза, пустое имя и дубль — проблема, а не молчаливый
794
+ // проход (иначе правило «регистрации обязаны совпадать с provides» нечем
795
+ // проверять).
796
+ problems.push(...validatePluginProvides(provides));
797
+ // 15. Контент полномочий (ADR-106): та же строгая схема + кросс-ссылки —
798
+ // неизвестное действие/цель/роль → отказ (не passthrough).
799
+ problems.push(...validateAuthorityProvides(provides));
800
+ // 13. `mode` — режим исполнения, допустим только для плагина.
801
+ const mode = manifest.mode;
802
+ if (mode !== undefined && mode !== null) {
803
+ if (kind !== 'plugin') {
804
+ problems.push(`mode: допустим только для kind «plugin» (текущий kind — «${String(kind)}»)`);
805
+ }
806
+ else if (typeof mode !== 'string' || !PACK_PLUGIN_MODES.includes(mode)) {
807
+ problems.push(`mode: неизвестный режим исполнения «${String(mode)}» (допустимо: ${PACK_PLUGIN_MODES.join('|')})`);
808
+ }
809
+ }
810
+ // 14. `trust.level` — верхняя граница; для плагина — не выше trust-floor.
811
+ problems.push(...validateManifestTrust(manifest, kind));
812
+ return problems;
813
+ }
814
+ /**
815
+ * Проверка вкладов плагина (`provides.tools`/`promptBlocks`/`llmFilters`) по
816
+ * явным схемам ADR-090. Проблемы — строками (как остальные правила).
817
+ */
818
+ function validatePluginProvides(provides) {
819
+ const problems = [];
820
+ // Тулы: непустое имя, без дублей.
821
+ const toolNames = new Set();
822
+ provides.tools.forEach((name, index) => {
823
+ if (typeof name !== 'string' || name.trim() === '') {
824
+ problems.push(`provides.tools[${index}]: пустое имя тула`);
825
+ return;
826
+ }
827
+ if (toolNames.has(name)) {
828
+ problems.push(`provides.tools[${index}]: дубликат имени тула «${name}»`);
829
+ return;
830
+ }
831
+ toolNames.add(name);
832
+ });
833
+ // Промпт-блоки: ключ/тир/порядок; тир `stable` запрещён (ADR-070).
834
+ const blockKeys = new Set();
835
+ provides.promptBlocks.forEach((item, index) => {
836
+ const parsed = packPromptBlockProvideSchema.safeParse(item);
837
+ if (!parsed.success) {
838
+ problems.push(`provides.promptBlocks[${index}]: ${describeZodIssues(parsed.error)}`);
839
+ return;
840
+ }
841
+ const key = parsed.data.key;
842
+ if (blockKeys.has(key)) {
843
+ problems.push(`provides.promptBlocks[${index}]: дубликат ключа блока «${key}»`);
844
+ return;
845
+ }
846
+ blockKeys.add(key);
847
+ });
848
+ // LLM-фильтры: id/фаза; id уникален.
849
+ const filterIds = new Set();
850
+ provides.llmFilters.forEach((item, index) => {
851
+ const parsed = packLlmFilterProvideSchema.safeParse(item);
852
+ if (!parsed.success) {
853
+ problems.push(`provides.llmFilters[${index}]: ${describeZodIssues(parsed.error)}`);
854
+ return;
855
+ }
856
+ const id = parsed.data.id;
857
+ if (filterIds.has(id)) {
858
+ problems.push(`provides.llmFilters[${index}]: дубликат id фильтра «${id}»`);
859
+ return;
860
+ }
861
+ filterIds.add(id);
862
+ });
863
+ return problems;
864
+ }
865
+ /** Человекочитаемая сводка проблем zod-валидации (для списка проблем). */
866
+ function describeZodIssues(error) {
867
+ return error.issues
868
+ .map((issue) => {
869
+ const path = issue.path.join('.');
870
+ return path ? `${path}: ${issue.message}` : issue.message;
871
+ })
872
+ .join('; ');
873
+ }
874
+ /**
875
+ * Проверка контента полномочий (`provides.authority`, ADR-106).
876
+ *
877
+ * Схема строгая (`.strict()`) — неизвестное поле, неизвестное действие,
878
+ * неизвестная цель или неизвестная роль дают проблему, а не «проскочивший»
879
+ * passthrough. Проблемы — строками (как остальные правила манифеста).
880
+ */
881
+ function validateAuthorityProvides(provides) {
882
+ const problems = [];
883
+ const authority = provides.authority;
884
+ const parsed = packAuthorityProvidesSchema.safeParse(authority);
885
+ if (!parsed.success) {
886
+ problems.push(`provides.authority: ${describeZodIssues(parsed.error)}`);
887
+ return problems;
888
+ }
889
+ return validateAuthorityContent({
890
+ actions: parsed.data.actions,
891
+ roles: parsed.data.roles,
892
+ targets: parsed.data.targets,
893
+ agents: parsed.data.agents,
894
+ });
895
+ }
896
+ /**
897
+ * Проверка заявленного доверия (ADR-090).
898
+ *
899
+ * Заявленный уровень — **верхняя граница**: фактический trust резолвится по
900
+ * источнику/реестру, манифест не может его повысить. Для `kind: 'plugin'`
901
+ * уровень не должен быть выше `trusted` — trust-floor плагина и «право вето
902
+ * только у доверенных» (ADR-090).
903
+ */
904
+ function validateManifestTrust(manifest, kind) {
905
+ const problems = [];
906
+ const trust = manifest.trust;
907
+ if (trust === undefined || trust === null)
908
+ return problems;
909
+ if (!isRecord(trust)) {
910
+ problems.push('trust: ожидается объект { level?, source? }');
911
+ return problems;
912
+ }
913
+ const level = trust.level;
914
+ if (level === undefined || level === null)
915
+ return problems;
916
+ if (typeof level !== 'string' || !CATALOG_TRUST_LEVELS.includes(level)) {
917
+ problems.push(`trust.level: неизвестный уровень доверия «${String(level)}» (допустимо: ${CATALOG_TRUST_LEVELS.join('|')})`);
918
+ return problems;
919
+ }
920
+ if (kind !== 'plugin')
921
+ return problems;
922
+ const floor = 'trusted';
923
+ if (trustLevelRank(level) < trustLevelRank(floor)) {
924
+ problems.push(`trust.level: «${level}» выше trust-floor плагина «${floor}» (право вето — только у доверенных)`);
925
+ }
926
+ return problems;
927
+ }
928
+ /**
929
+ * ADR-090: сверка объявленных в манифесте вкладов с фактическими
930
+ * регистрациями расширения.
931
+ *
932
+ * Правило: «фактические регистрации обязаны совпадать с `provides`» —
933
+ * расхождение (объявлено, но не зарегистрировано — и наоборот) означает
934
+ * несогласованную сборку и должно вести к отказу активации (Ф1/Ф3).
935
+ *
936
+ * Функция возвращает **список расхождений** (пустой — совпадение) и не
937
+ * бросает исключений: вызывающий (загрузчик `PluginHost`) сам решает, что
938
+ * с ними делать.
939
+ */
940
+ export function diffPackProvides(declared, registered) {
941
+ const mismatches = [];
942
+ const diff = (kind, declaredNames, registeredNames) => {
943
+ const registeredSet = new Set(registeredNames);
944
+ const declaredSet = new Set(declaredNames);
945
+ for (const name of declaredNames) {
946
+ if (!registeredSet.has(name))
947
+ mismatches.push({ kind, name, issue: 'missing' });
948
+ }
949
+ for (const name of registeredNames) {
950
+ if (!declaredSet.has(name))
951
+ mismatches.push({ kind, name, issue: 'unexpected' });
952
+ }
953
+ };
954
+ diff('tool', declared.tools ?? [], registered.tools ?? []);
955
+ diff('promptBlock', (declared.promptBlocks ?? []).map((block) => block.key), registered.promptBlocks ?? []);
956
+ diff('llmFilter', (declared.llmFilters ?? []).map((filter) => filter.id), registered.llmFilters ?? []);
957
+ return mismatches;
958
+ }
959
+ /** Имя контракта Extension API по умолчанию (ADR-090). */
960
+ export const DEFAULT_EXTENSION_CONTRACT = 'extensionApi';
961
+ /**
962
+ * ADR-090 (шаг 3): семвер-гейт расширения против хоста.
963
+ *
964
+ * Проверяются два объявления манифеста:
965
+ * - `contracts.extensionApi` — semver-диапазон версии контракта точки
966
+ * расширения, которую предоставляет хост (сейчас — мажор `1`);
967
+ * - `host` — semver-диапазон версий Synth, совместимых с расширением.
968
+ *
969
+ * Порядок проверок — как в пайплайне активации: сначала контракт, потом
970
+ * host. Точные исключения (`exactHostExceptions`) — список версий Synth,
971
+ * совместимых **вопреки** диапазону `host` (формат файла исключений —
972
+ * открытый вопрос ADR-090; здесь — сам список).
973
+ *
974
+ * Вердикт — машиночитаемый: `{ ok, reason, expected, actual }`; загрузчик
975
+ * `PluginHost` (Ф1) переиспользует функцию как есть.
976
+ */
977
+ export function checkExtensionCompatibility(input) {
978
+ const contractName = input.contractName ?? DEFAULT_EXTENSION_CONTRACT;
979
+ const contractRange = input.contracts?.[contractName];
980
+ if (contractRange !== undefined) {
981
+ if (!satisfiesSemverRange(input.contractVersion, contractRange)) {
982
+ return {
983
+ ok: false,
984
+ reason: 'contract_mismatch',
985
+ expected: contractRange,
986
+ actual: input.contractVersion,
987
+ };
988
+ }
989
+ }
990
+ const hostRange = input.host;
991
+ if (hostRange !== undefined) {
992
+ const excepted = (input.exactHostExceptions ?? []).includes(input.hostVersion);
993
+ if (!excepted && !satisfiesSemverRange(input.hostVersion, hostRange)) {
994
+ return {
995
+ ok: false,
996
+ reason: 'host_mismatch',
997
+ expected: hostRange,
998
+ actual: input.hostVersion,
999
+ };
1000
+ }
1001
+ }
1002
+ return { ok: true };
1003
+ }