@itphx/synth-shared 0.11.3 → 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.
- package/dist/config/defaults.js +126 -3
- package/dist/config/env-overrides.d.ts +29 -0
- package/dist/config/env-overrides.js +155 -2
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/proxy.js +3 -1
- package/dist/config/resolve.d.ts +8 -8
- package/dist/config/resolve.js +7 -7
- package/dist/config/types.d.ts +1287 -4037
- package/dist/config/types.js +461 -68
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +277 -0
- package/dist/index.d.ts +14 -2
- package/dist/index.js +16 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/schemas/index.d.ts +980 -2322
- package/dist/schemas/index.js +183 -22
- package/dist/types/analytics.d.ts +6 -6
- package/dist/types/analytics.js +4 -4
- package/dist/types/authority.d.ts +464 -0
- package/dist/types/authority.js +445 -0
- package/dist/types/background.d.ts +96 -0
- package/dist/types/background.js +24 -0
- package/dist/types/bus-events.d.ts +23 -1
- package/dist/types/catalog.d.ts +349 -0
- package/dist/types/catalog.js +393 -0
- package/dist/types/decision.d.ts +28 -337
- package/dist/types/egress.d.ts +1 -1
- package/dist/types/egress.js +1 -1
- package/dist/types/events.d.ts +54 -1
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/hooks.d.ts +33 -12
- package/dist/types/index.d.ts +20 -0
- package/dist/types/index.js +50 -1
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/mcp.d.ts +33 -2
- package/dist/types/mcp.js +44 -1
- package/dist/types/message.d.ts +45 -1
- package/dist/types/pack.d.ts +1102 -0
- package/dist/types/pack.js +1003 -0
- package/dist/types/permission.d.ts +25 -11
- package/dist/types/permission.js +1 -1
- package/dist/types/pipeline-engine.d.ts +453 -0
- package/dist/types/pipeline-engine.js +440 -0
- package/dist/types/pipeline.d.ts +275 -0
- package/dist/types/pipeline.js +212 -0
- package/dist/types/plugin-audit.d.ts +110 -0
- package/dist/types/plugin-audit.js +185 -0
- package/dist/types/plugin-hybrid.d.ts +85 -0
- package/dist/types/plugin-hybrid.js +68 -0
- package/dist/types/plugin-lock.d.ts +95 -0
- package/dist/types/plugin-lock.js +1 -0
- package/dist/types/plugin-protocol.d.ts +221 -0
- package/dist/types/plugin-protocol.js +322 -0
- package/dist/types/plugin-runtime.d.ts +25 -0
- package/dist/types/plugin-runtime.js +11 -0
- package/dist/types/plugin-scan.d.ts +159 -0
- package/dist/types/plugin-scan.js +166 -0
- package/dist/types/plugin-tools.d.ts +51 -0
- package/dist/types/plugin-tools.js +72 -0
- package/dist/types/project.d.ts +14 -0
- package/dist/types/prompt-blocks.d.ts +102 -0
- package/dist/types/prompt-blocks.js +24 -0
- package/dist/types/prompt.d.ts +45 -3
- package/dist/types/provider.d.ts +11 -0
- package/dist/types/question.d.ts +153 -0
- package/dist/types/question.js +65 -0
- package/dist/types/schedules.d.ts +26 -3
- package/dist/types/semver.d.ts +48 -0
- package/dist/types/semver.js +218 -0
- package/dist/types/service-keys.d.ts +41 -3
- package/dist/types/service-keys.js +44 -2
- package/dist/types/session.d.ts +54 -0
- package/dist/types/steering.d.ts +74 -0
- package/dist/types/steering.js +75 -0
- package/dist/types/tools.d.ts +125 -5
- package/dist/types/tools.js +75 -0
- package/dist/types/trust.d.ts +31 -0
- package/dist/types/trust.js +27 -0
- package/dist/types/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +31 -1
- package/dist/utils/index.js +92 -12
- package/dist/utils/reasoning.d.ts +16 -0
- package/dist/utils/reasoning.js +37 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-068 §3/§12: контракт индекса каталога расширений (`format: 1`).
|
|
3
|
+
*
|
|
4
|
+
* Индекс — **versioned JSON-документ**, который собирает CI каталога и который
|
|
5
|
+
* читают и портал-витрина, и инстанс Synth (загрузчик внешнего каталога
|
|
6
|
+
* скиллов, `core/src/engine/skills/remote.ts`). Формат индекса — из референса
|
|
7
|
+
* dshmarket (`format: 1`), поля карточки — из PROP-068 §12 (все классы
|
|
8
|
+
* расширений: `plugin`/`gateway`/`addon`/`pack`/`storage`).
|
|
9
|
+
*
|
|
10
|
+
* Источник истины по техническим полям расширения — манифест `synth.pack`
|
|
11
|
+
* (`types/pack.ts`): здесь переиспользуются `packNameSchema`,
|
|
12
|
+
* `packVersionSchema`, `packKindSchema`, `packTypeSchema` и общий инвариант
|
|
13
|
+
* `packType` (`refinePackType`): обязателен для `kind: 'pack'`, запрещён у
|
|
14
|
+
* остальных.
|
|
15
|
+
*
|
|
16
|
+
* Локализация: RU — канонический язык, EN — зеркало; обе строки обязательны
|
|
17
|
+
* в канонической форме (`description`, `title`, категории/метки).
|
|
18
|
+
*
|
|
19
|
+
* Ключевые поля канонической формы:
|
|
20
|
+
* - `metadata.sources[]` — перечень каталогов-адаптеров верхнего уровня
|
|
21
|
+
* (PROP-068 §3), **обязателен**; не путать с полем записи `source`;
|
|
22
|
+
* - `plugins[].path` — путь внутри каталога к вендоренному контенту
|
|
23
|
+
* (`kind: 'pack'`); legacy-формы кладут его и в `path`, и в `extra.path`.
|
|
24
|
+
*
|
|
25
|
+
* Модуль browser-safe (`zod` + локальные типы), в UI-бандл `node:*` не попадает.
|
|
26
|
+
*/
|
|
27
|
+
import { z } from 'zod';
|
|
28
|
+
import { PACK_KINDS, packHostSchema, packKindSchema, packNameSchema, packTypeSchema, packVersionSchema, refinePackType, } from './pack.js';
|
|
29
|
+
import { catalogTrustLevelSchema } from './trust.js';
|
|
30
|
+
/** Версия формата индекса каталога расширений. */
|
|
31
|
+
export const CATALOG_INDEX_FORMAT = 1;
|
|
32
|
+
/**
|
|
33
|
+
* Локализованный текст карточки: RU — канонический, EN — зеркало.
|
|
34
|
+
* Обе строки обязательны (в канонической форме).
|
|
35
|
+
*/
|
|
36
|
+
export const catalogLocalizedTextSchema = z.object({
|
|
37
|
+
ru: z.string().min(1),
|
|
38
|
+
en: z.string().min(1),
|
|
39
|
+
});
|
|
40
|
+
/**
|
|
41
|
+
* Уровни доверия записи (PROP-068 §4.1). Для каталога расширений
|
|
42
|
+
* `agent-created` не используется — записи каталога публикуются из репозиториев.
|
|
43
|
+
*
|
|
44
|
+
* Перечень живёт в `types/trust.ts` — он общий с манифестом `synth.pack`
|
|
45
|
+
* (`types/pack.ts`), который импортирует схемы каталога (цикл импортов
|
|
46
|
+
* `catalog → pack` не даёт импортировать каталог из `pack`).
|
|
47
|
+
*/
|
|
48
|
+
export { CATALOG_TRUST_LEVELS, catalogTrustLevelSchema, trustLevelRank, } from './trust.js';
|
|
49
|
+
/**
|
|
50
|
+
* Источник/адаптер происхождения записи (PROP-068 §3.1).
|
|
51
|
+
*
|
|
52
|
+
* Это **канал доставки конкретной записи** (`versions[].source.type = 'npm'`),
|
|
53
|
+
* а не перечень каталогов верхнего уровня — см. `catalogSourceAdapterSchema`.
|
|
54
|
+
*/
|
|
55
|
+
export const CATALOG_SOURCES = ['npm', 'github', 'helm', 'builtin', 'registry'];
|
|
56
|
+
export const catalogSourceSchema = z.enum(CATALOG_SOURCES);
|
|
57
|
+
/**
|
|
58
|
+
* Каталог-адаптер верхнего уровня (`metadata.sources[]`, PROP-068 §3) —
|
|
59
|
+
* список каталогов, чьи записи попали в индекс, с их дефолтами доверия и
|
|
60
|
+
* включения.
|
|
61
|
+
*
|
|
62
|
+
* ⚠️ **Не путать с полем записи `source`** (`CatalogSource` =
|
|
63
|
+
* `npm|github|helm|builtin|registry`): `source` у записи — *канал доставки этой
|
|
64
|
+
* записи* (`versions[].source.type`), а `metadata.sources[]` — *каталоги-адаптеры*,
|
|
65
|
+
* из которых индекс собра (репозиторий/подкаталог + уровень доверия +
|
|
66
|
+
* «включён по умолчанию»).
|
|
67
|
+
*/
|
|
68
|
+
export const catalogSourceAdapterSchema = z.object({
|
|
69
|
+
/** Идентификатор каталога-адаптера (`official`, `anthropics`, …). */
|
|
70
|
+
id: z.string().min(1),
|
|
71
|
+
/** Человекочитаемое название каталога. */
|
|
72
|
+
label: z.string().min(1),
|
|
73
|
+
/** Уровень доверия каталога по умолчанию (PROP-068 §4.1). */
|
|
74
|
+
trust_level: catalogTrustLevelSchema,
|
|
75
|
+
/** Включён ли каталог по умолчанию (PROP-068 §3). */
|
|
76
|
+
enabled_by_default: z.boolean().optional(),
|
|
77
|
+
/** Репозиторий-источник (`owner/repo`). */
|
|
78
|
+
repo: z.string().min(1).optional(),
|
|
79
|
+
/** Подкаталог в репозитории (внутри `repo`). */
|
|
80
|
+
subpath: z.string().min(1).optional(),
|
|
81
|
+
});
|
|
82
|
+
/** Метка времени в формате ISO-8601 (UTC или со смещением). */
|
|
83
|
+
const CATALOG_ISO_DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?(Z|[+-]\d{2}:\d{2})$/;
|
|
84
|
+
export const catalogTimestampSchema = z
|
|
85
|
+
.string()
|
|
86
|
+
.min(1)
|
|
87
|
+
.refine((value) => CATALOG_ISO_DATETIME_RE.test(value) && !Number.isNaN(Date.parse(value)), { message: 'метка времени: ISO-8601 (например, 2026-09-17T06:00:00Z)' });
|
|
88
|
+
/**
|
|
89
|
+
* Версия записи каталога в истории релизов: версия, момент публикации
|
|
90
|
+
* (unix-время, мс), источник и требования к окружению (`engines`).
|
|
91
|
+
*/
|
|
92
|
+
export const catalogVersionSchema = z.object({
|
|
93
|
+
/** Semver версии. */
|
|
94
|
+
version: packVersionSchema,
|
|
95
|
+
/** Момент публикации (unix-время, мс). */
|
|
96
|
+
publishTimestamp: z.number().int().optional(),
|
|
97
|
+
/** Источник публикации. */
|
|
98
|
+
source: catalogSourceSchema,
|
|
99
|
+
/** Требования к окружению (напр. `{ node: '>=20' }`). */
|
|
100
|
+
engines: z.record(z.string(), z.string()).optional(),
|
|
101
|
+
});
|
|
102
|
+
/**
|
|
103
|
+
* Карточка записи каталога расширений (PROP-068 §12).
|
|
104
|
+
*
|
|
105
|
+
* Инварианты, зашитые в схему:
|
|
106
|
+
* - `kind: 'pack'` **требует** `packType`; у остальных `kind` `packType`
|
|
107
|
+
* запрещён (тот же инвариант, что в манифесте `synth.pack`);
|
|
108
|
+
* - `license` обязателен (SPDX-идентификатор) — для сторонних записей;
|
|
109
|
+
* - `description` локализован (RU + EN).
|
|
110
|
+
*/
|
|
111
|
+
export const catalogEntrySchema = z
|
|
112
|
+
.object({
|
|
113
|
+
/** Имя расширения (slug или npm-имя со scope) — как в манифесте. */
|
|
114
|
+
name: packNameSchema,
|
|
115
|
+
/** Класс расширения (`plugin`/`gateway`/`addon`/`pack`/`storage`). */
|
|
116
|
+
kind: packKindSchema,
|
|
117
|
+
/** Тип контент-пака — только для `kind: 'pack'`. */
|
|
118
|
+
packType: packTypeSchema.optional(),
|
|
119
|
+
/** Semver версия записи. */
|
|
120
|
+
version: packVersionSchema,
|
|
121
|
+
/** Краткое описание (поиск, витрина): RU + EN. */
|
|
122
|
+
description: catalogLocalizedTextSchema,
|
|
123
|
+
/** Репозиторий расширения. */
|
|
124
|
+
repository: z.object({ url: z.string().url() }).optional(),
|
|
125
|
+
/** Сайт/домашняя страница проекта. */
|
|
126
|
+
homepage: z.string().url().optional(),
|
|
127
|
+
/** SPDX-идентификатор лицензии — обязателен. */
|
|
128
|
+
license: z.string().min(1),
|
|
129
|
+
/** Иконка витрины (ключ/эмодзи/URL — по решению портала). */
|
|
130
|
+
icon: z.string().optional(),
|
|
131
|
+
/** Скриншоты витрины (URL; загрузка — под SSRF-политикой PROP-068 §4.5). */
|
|
132
|
+
screenshots: z.array(z.string().url()).default([]),
|
|
133
|
+
/** Теги для поиска и фильтров. */
|
|
134
|
+
tags: z.array(z.string()).default([]),
|
|
135
|
+
/** Категория витрины (ключ из `metadata.categories`). */
|
|
136
|
+
category: z.string().min(1),
|
|
137
|
+
/** Уровень доверия записи. */
|
|
138
|
+
trust_level: catalogTrustLevelSchema,
|
|
139
|
+
/** Устойчивый id записи (`owner/repo#path`, `url/<sha>`). */
|
|
140
|
+
identifier: z.string().min(1),
|
|
141
|
+
/**
|
|
142
|
+
* Путь внутри каталога к вендоренному контенту (для `kind: 'pack'`).
|
|
143
|
+
*
|
|
144
|
+
* Контент-паки **вендорены в каталоге** (гибридная модель каталога,
|
|
145
|
+
* PROP-068 §3): запись явно указывает, где лежит её контент, чтобы
|
|
146
|
+
* загрузчику не приходилось выводить путь из `identifier`/имени.
|
|
147
|
+
* Необязателен: у записей других классов пути внутри каталога нет, а в
|
|
148
|
+
* legacy-формах (`{ skills: [...] }`) путь кладут и в это поле, и в
|
|
149
|
+
* `extra.path` (обратная совместимость).
|
|
150
|
+
*/
|
|
151
|
+
path: z.string().min(1).optional(),
|
|
152
|
+
/** Минимальная версия Synth (semver-range) — как `host` в манифесте. */
|
|
153
|
+
minSynth: packHostSchema.optional(),
|
|
154
|
+
/** Источник/адаптер происхождения записи. */
|
|
155
|
+
source: catalogSourceSchema,
|
|
156
|
+
/** История версий записи. */
|
|
157
|
+
versions: z.array(catalogVersionSchema).default([]),
|
|
158
|
+
/** Источник-специфичные поля (рейтинги, даты, автор). */
|
|
159
|
+
extra: z.record(z.string(), z.unknown()).prefault({}),
|
|
160
|
+
})
|
|
161
|
+
.superRefine(refinePackType);
|
|
162
|
+
/** Категория витрины: локализованный заголовок и порядок вывода. */
|
|
163
|
+
export const catalogCategorySchema = z.object({
|
|
164
|
+
title: catalogLocalizedTextSchema,
|
|
165
|
+
order: z.number().int().optional(),
|
|
166
|
+
});
|
|
167
|
+
/** Метка каталога (`metadata.labels`) — локализованный заголовок. */
|
|
168
|
+
export const catalogLabelSchema = z.object({
|
|
169
|
+
title: catalogLocalizedTextSchema,
|
|
170
|
+
});
|
|
171
|
+
/**
|
|
172
|
+
* Канонический документ индекса каталога расширений (`format: 1`).
|
|
173
|
+
*
|
|
174
|
+
* - `title`/`description` — локализованные (RU канонический, EN зеркало);
|
|
175
|
+
* - `generated_at` — момент сборки индекса (ISO-8601), база freshness-watchdog;
|
|
176
|
+
* - `metadata.categories` — категории витрины, `metadata.labels` — метки;
|
|
177
|
+
* - `metadata.sources` — **обязательный** перечень каталогов-адаптеров, чьи
|
|
178
|
+
* записи попали в индекс (PROP-068 §3): без него документ не является
|
|
179
|
+
* полноценным индексом (fail-closed к §3);
|
|
180
|
+
* - `plugins` — записи каталога (все классы расширений).
|
|
181
|
+
*/
|
|
182
|
+
export const catalogIndexSchema = z.object({
|
|
183
|
+
/** Версия формата индекса. */
|
|
184
|
+
format: z.literal(CATALOG_INDEX_FORMAT),
|
|
185
|
+
/** Заголовок индекса (RU + EN). */
|
|
186
|
+
title: catalogLocalizedTextSchema,
|
|
187
|
+
/** Описание индекса (RU + EN). */
|
|
188
|
+
description: catalogLocalizedTextSchema,
|
|
189
|
+
/** Момент сборки индекса (ISO-8601). */
|
|
190
|
+
generated_at: catalogTimestampSchema,
|
|
191
|
+
/** Метаданные витрины. */
|
|
192
|
+
metadata: z.object({
|
|
193
|
+
/** Категории: ключ → заголовок (+ порядок). */
|
|
194
|
+
categories: z.record(z.string(), catalogCategorySchema),
|
|
195
|
+
/** Метки: ключ → заголовок. */
|
|
196
|
+
labels: z.record(z.string(), catalogLabelSchema).optional(),
|
|
197
|
+
/**
|
|
198
|
+
* Каталоги-адаптеры, из которых собран индекс (PROP-068 §3) — обязательны.
|
|
199
|
+
*
|
|
200
|
+
* Не путать с полем записи `source` (`CatalogSource`): там — канал доставки
|
|
201
|
+
* конкретной записи, здесь — перечень каталогов верхнего уровня.
|
|
202
|
+
*/
|
|
203
|
+
sources: z.array(catalogSourceAdapterSchema),
|
|
204
|
+
}),
|
|
205
|
+
/** Записи каталога расширений. */
|
|
206
|
+
plugins: z.array(catalogEntrySchema),
|
|
207
|
+
});
|
|
208
|
+
/** Плейсхолдер лицензии для записей, у которых источник её не указал. */
|
|
209
|
+
export const CATALOG_UNKNOWN_LICENSE = 'UNKNOWN';
|
|
210
|
+
/** Категория по умолчанию для записей-скиллов без категории. */
|
|
211
|
+
export const CATALOG_DEFAULT_SKILL_CATEGORY = 'skills';
|
|
212
|
+
/** Версия по умолчанию для записей, у которых источник её не указал. */
|
|
213
|
+
export const CATALOG_UNKNOWN_VERSION = '0.0.0';
|
|
214
|
+
/** Запись каталога — скилл? (`kind: 'pack'` + `packType: 'skills'`). */
|
|
215
|
+
export function isCatalogSkillEntry(entry) {
|
|
216
|
+
return entry.kind === 'pack' && entry.packType === 'skills';
|
|
217
|
+
}
|
|
218
|
+
function isRecord(value) {
|
|
219
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
220
|
+
}
|
|
221
|
+
function trimmedString(value) {
|
|
222
|
+
if (typeof value !== 'string')
|
|
223
|
+
return undefined;
|
|
224
|
+
const trimmed = value.trim();
|
|
225
|
+
return trimmed.length > 0 ? trimmed : undefined;
|
|
226
|
+
}
|
|
227
|
+
/**
|
|
228
|
+
* Локализованный текст из произвольного значения: строка → обе локали,
|
|
229
|
+
* `{ ru, en }` — как есть (недостающая локаль — зеркалится).
|
|
230
|
+
*/
|
|
231
|
+
function localizedText(value) {
|
|
232
|
+
if (typeof value === 'string') {
|
|
233
|
+
const trimmed = value.trim();
|
|
234
|
+
return trimmed ? { ru: trimmed, en: trimmed } : undefined;
|
|
235
|
+
}
|
|
236
|
+
if (isRecord(value)) {
|
|
237
|
+
const ru = trimmedString(value.ru);
|
|
238
|
+
const en = trimmedString(value.en);
|
|
239
|
+
if (ru && en)
|
|
240
|
+
return { ru, en };
|
|
241
|
+
if (ru)
|
|
242
|
+
return { ru, en: ru };
|
|
243
|
+
if (en)
|
|
244
|
+
return { ru: en, en };
|
|
245
|
+
}
|
|
246
|
+
return undefined;
|
|
247
|
+
}
|
|
248
|
+
function stringArray(value) {
|
|
249
|
+
if (!Array.isArray(value))
|
|
250
|
+
return [];
|
|
251
|
+
return value.filter((item) => typeof item === 'string');
|
|
252
|
+
}
|
|
253
|
+
function urlArray(value) {
|
|
254
|
+
return stringArray(value).filter((item) => z.string().url().safeParse(item).success);
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* Запись «в форме скилла» (legacy-формы §3 `{ skills: [...] }` и голый массив
|
|
258
|
+
* `[{ name, path? }]`) → запись каталога.
|
|
259
|
+
*
|
|
260
|
+
* Маппинг (PROP-068 §12): `kind: 'pack'`, `packType: 'skills'`,
|
|
261
|
+
* `trust_level: 'community'`, `source: 'registry'`, `identifier` = `path`
|
|
262
|
+
* (или `name`). `license`/`category`/`minSynth` у этих форм необязательны —
|
|
263
|
+
* подставляются плейсхолдеры, парсер не падает на их отсутствии.
|
|
264
|
+
*/
|
|
265
|
+
function skillLikeEntry(raw) {
|
|
266
|
+
if (!isRecord(raw))
|
|
267
|
+
return null;
|
|
268
|
+
// Запись может быть полноценной карточкой каталога — строгий контракт важнее.
|
|
269
|
+
const strict = catalogEntrySchema.safeParse(raw);
|
|
270
|
+
if (strict.success)
|
|
271
|
+
return strict.data;
|
|
272
|
+
const name = trimmedString(raw.name);
|
|
273
|
+
if (!name)
|
|
274
|
+
return null;
|
|
275
|
+
// Явно указанный класс, отличный от контент-пака, — не скилл.
|
|
276
|
+
const kind = trimmedString(raw.kind);
|
|
277
|
+
if (kind !== undefined && !PACK_KINDS.includes(kind))
|
|
278
|
+
return null;
|
|
279
|
+
const packType = trimmedString(raw.packType);
|
|
280
|
+
if (packType !== undefined && packType !== 'skills')
|
|
281
|
+
return null;
|
|
282
|
+
if (kind !== undefined && kind !== 'pack')
|
|
283
|
+
return null;
|
|
284
|
+
const path = trimmedString(raw.path);
|
|
285
|
+
const identifier = trimmedString(raw.identifier) ?? path ?? name;
|
|
286
|
+
const description = localizedText(raw.description) ?? { ru: name, en: name };
|
|
287
|
+
const license = trimmedString(raw.license) ?? CATALOG_UNKNOWN_LICENSE;
|
|
288
|
+
const category = trimmedString(raw.category) ?? CATALOG_DEFAULT_SKILL_CATEGORY;
|
|
289
|
+
const version = packVersionSchema.safeParse(raw.version);
|
|
290
|
+
const minSynth = trimmedString(raw.minSynth);
|
|
291
|
+
const minSynthRange = minSynth ? packHostSchema.safeParse(minSynth) : undefined;
|
|
292
|
+
const extra = isRecord(raw.extra) ? { ...raw.extra } : {};
|
|
293
|
+
// Путь внутри каталога — для загрузчика скиллов (`<base>/<path>/SKILL.md`).
|
|
294
|
+
// Кладём и в поле `path` (канонический контракт), и в `extra.path`
|
|
295
|
+
// (обратная совместимость с прежним поведением загрузчика).
|
|
296
|
+
if (path)
|
|
297
|
+
extra.path = path;
|
|
298
|
+
const repositoryUrl = isRecord(raw.repository)
|
|
299
|
+
? trimmedString(raw.repository.url)
|
|
300
|
+
: trimmedString(raw.repository);
|
|
301
|
+
const homepage = trimmedString(raw.homepage);
|
|
302
|
+
const icon = trimmedString(raw.icon);
|
|
303
|
+
const versions = z.array(catalogVersionSchema).safeParse(raw.versions);
|
|
304
|
+
return {
|
|
305
|
+
name,
|
|
306
|
+
kind: 'pack',
|
|
307
|
+
packType: 'skills',
|
|
308
|
+
version: version.success ? version.data : CATALOG_UNKNOWN_VERSION,
|
|
309
|
+
description,
|
|
310
|
+
...(repositoryUrl && z.string().url().safeParse(repositoryUrl).success
|
|
311
|
+
? { repository: { url: repositoryUrl } }
|
|
312
|
+
: {}),
|
|
313
|
+
...(homepage && z.string().url().safeParse(homepage).success ? { homepage } : {}),
|
|
314
|
+
license,
|
|
315
|
+
...(icon ? { icon } : {}),
|
|
316
|
+
screenshots: urlArray(raw.screenshots),
|
|
317
|
+
tags: stringArray(raw.tags),
|
|
318
|
+
category,
|
|
319
|
+
trust_level: 'community',
|
|
320
|
+
identifier,
|
|
321
|
+
...(path ? { path } : {}),
|
|
322
|
+
...(minSynthRange && minSynthRange.success ? { minSynth: minSynthRange.data } : {}),
|
|
323
|
+
source: 'registry',
|
|
324
|
+
versions: versions.success ? versions.data : [],
|
|
325
|
+
extra,
|
|
326
|
+
};
|
|
327
|
+
}
|
|
328
|
+
/** Записи канонической формы (`plugins`) — строгий контракт, битые пропускаются. */
|
|
329
|
+
function canonicalEntries(raw) {
|
|
330
|
+
const entries = [];
|
|
331
|
+
for (const item of raw) {
|
|
332
|
+
const parsed = catalogEntrySchema.safeParse(item);
|
|
333
|
+
if (parsed.success)
|
|
334
|
+
entries.push(parsed.data);
|
|
335
|
+
}
|
|
336
|
+
return entries;
|
|
337
|
+
}
|
|
338
|
+
/** Записи форм «скиллов» (`{ skills: [...] }` и голый массив) — толерантно. */
|
|
339
|
+
function skillLikeEntries(raw) {
|
|
340
|
+
const entries = [];
|
|
341
|
+
for (const item of raw) {
|
|
342
|
+
const entry = skillLikeEntry(item);
|
|
343
|
+
if (entry)
|
|
344
|
+
entries.push(entry);
|
|
345
|
+
}
|
|
346
|
+
return entries;
|
|
347
|
+
}
|
|
348
|
+
/**
|
|
349
|
+
* Похож ли корень на документ каталога? (`format: 1`, legacy `{ skills: [...] }`
|
|
350
|
+
* или голый массив записей).
|
|
351
|
+
*
|
|
352
|
+
* Нужен потребителю, чтобы отличить «пустой каталог» от «по ссылке лежит не
|
|
353
|
+
* каталог» (HTML/мусор) — без дублирования знания о формате.
|
|
354
|
+
*/
|
|
355
|
+
export function isCatalogIndexDocument(raw) {
|
|
356
|
+
if (Array.isArray(raw))
|
|
357
|
+
return true;
|
|
358
|
+
if (!isRecord(raw))
|
|
359
|
+
return false;
|
|
360
|
+
if (raw.format !== undefined && raw.format !== CATALOG_INDEX_FORMAT)
|
|
361
|
+
return false;
|
|
362
|
+
return Array.isArray(raw.plugins) || Array.isArray(raw.skills);
|
|
363
|
+
}
|
|
364
|
+
/**
|
|
365
|
+
* Tolerant-парсер индекса каталога: три формы → `CatalogEntry[]`.
|
|
366
|
+
*
|
|
367
|
+
* 1. Каноническая: `{ format: 1, plugins: [...] }` — записи валидируются
|
|
368
|
+
* строгим контрактом `catalogEntrySchema`, невалидные пропускаются молча;
|
|
369
|
+
* 2. `{ skills: [...] }` — записи скиллов;
|
|
370
|
+
* 3. Голый массив `[{ name, path? }]` — legacy-формат внешнего каталога скиллов
|
|
371
|
+
* (ADR-046 §4.3).
|
|
372
|
+
*
|
|
373
|
+
* Формы 2 и 3 — это **скиллы**: `kind: 'pack'`, `packType: 'skills'`,
|
|
374
|
+
* `trust_level: 'community'`, `source: 'registry'`, `identifier` = `path`
|
|
375
|
+
* (или `name`).
|
|
376
|
+
*
|
|
377
|
+
* Парсер **не бросает исключений** и не сигналит: битые записи пропускаются,
|
|
378
|
+
* неизвестный формат документа → пустой список.
|
|
379
|
+
*/
|
|
380
|
+
export function parseCatalogEntries(raw) {
|
|
381
|
+
if (Array.isArray(raw))
|
|
382
|
+
return skillLikeEntries(raw);
|
|
383
|
+
if (!isRecord(raw))
|
|
384
|
+
return [];
|
|
385
|
+
// Неизвестный формат — структуру не угадываем (fail-closed к будущим версиям).
|
|
386
|
+
if (raw.format !== undefined && raw.format !== CATALOG_INDEX_FORMAT)
|
|
387
|
+
return [];
|
|
388
|
+
if (Array.isArray(raw.plugins))
|
|
389
|
+
return canonicalEntries(raw.plugins);
|
|
390
|
+
if (Array.isArray(raw.skills))
|
|
391
|
+
return skillLikeEntries(raw.skills);
|
|
392
|
+
return [];
|
|
393
|
+
}
|