@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,445 @@
1
+ /**
2
+ * ADR-106 Ф0: модель Authority-слоя — полномочия как контент.
3
+ *
4
+ * Модель **доменно-нейтральна**: «действие», «цель» и «роль» — данные, а не код
5
+ * ядра (ADR-106 §«Доменная нейтральность»). Ядро знает только форму записи и
6
+ * правила решения; конкретные глаголы (`sign`, `commit`), цели (`record:*`,
7
+ * `invoice:*`) и роли (`clinician`, `treasurer`) приезжают контентом
8
+ * (`provides.authority` пакета, ADR-086/ADR-090) и включаются политикой
9
+ * инстанса (ADR-106 §«Правила безопасности контента»).
10
+ *
11
+ * Ключевые инварианты (ADR-106 §«Инварианты модели»):
12
+ * 1. **Нет гранта — нет права.** `allow` не выводится из отсутствия запрета;
13
+ * неизвестное действие/цель — `deny` (fail-closed).
14
+ * 2. **Грант — всегда «действие × цель».** Цель — типизированный ресурс; текст
15
+ * команды, промпт и имя тула целью не являются.
16
+ * 3. **Права только сужаются** (пересечение осей, не объединение).
17
+ *
18
+ * Схемы — **строгие** (`.strict()`): неизвестное поле, неизвестное действие,
19
+ * неизвестная цель или неизвестная роль — ошибка разбора, а не «проскочивший»
20
+ * passthrough. Кросс-ссылки (грант → объявленное действие, агент → объявленная
21
+ * роль) проверяет `validateAuthorityContent`.
22
+ *
23
+ * Модуль browser-safe (`zod` + локальные типы + `utils/glob`): используется и в
24
+ * ядре, и (в будущем) в UI.
25
+ */
26
+ import { z } from 'zod';
27
+ import { globMatch } from '../utils/glob.js';
28
+ // --- Виды принципалов ---
29
+ /**
30
+ * Кто действует (ADR-106 §«Модель»): пользователь, агент, service-key,
31
+ * шедулер или внешний источник события.
32
+ */
33
+ export const AUTHORITY_PRINCIPAL_KINDS = ['user', 'agent', 'service', 'scheduler', 'event'];
34
+ export const authorityPrincipalKindSchema = z.enum(AUTHORITY_PRINCIPAL_KINDS);
35
+ /**
36
+ * Идентификатор принципала: `user:<id>`, `agent:<id>`, `service:<keyId>`,
37
+ * `scheduler`, `event:<source>` (ADR-106 §«Многопользовательская сессия»).
38
+ */
39
+ export const AUTHORITY_PRINCIPAL_ID_REGEX = /^[a-z][a-z0-9._-]*:[^\s]+$/;
40
+ export const authorityPrincipalRefSchema = z
41
+ .string()
42
+ .min(3)
43
+ .max(256)
44
+ .regex(AUTHORITY_PRINCIPAL_ID_REGEX, 'принципал: "<вид>:<идентификатор>" (например, user:local)');
45
+ // --- Виды целей ---
46
+ /**
47
+ * Виды целей, известные **ядру** (ADR-106 §«Модель»): проект, путь, сессия,
48
+ * MCP-сервер, внешний ресурс, рабочая область.
49
+ *
50
+ * ⚠️ Доменная нейтральность требует и других видов (`record:<patientId>`,
51
+ * `invoice:<id>`, `report:<period>` — ADR-106 §«Доменная нейтральность»), поэтому
52
+ * `kind` — идентификатор строки, а не закрытое перечисление: доменные виды
53
+ * **объявляются контентом** (`provides.authority.targets[]`) и становятся
54
+ * известными только после установки и одобрения пакета. Ядро знает базовый
55
+ * набор (`AUTHORITY_CORE_TARGET_KINDS`) и не более.
56
+ */
57
+ export const AUTHORITY_CORE_TARGET_KINDS = [
58
+ 'project',
59
+ 'path',
60
+ 'session',
61
+ 'mcp',
62
+ 'external',
63
+ 'workspace',
64
+ // ADR-106 Ф2: путь **вне** рабочего каталога проекта. Отдельный вид цели:
65
+ // правило `external_directory` и fail-closed дефолт «спросить» относятся
66
+ // именно к таким путям, а к `path:` (внутри workspace) — не относятся.
67
+ // Ссылка цели — неразличимый токен (хэш абсолютного пути): сырой путь в
68
+ // журнал решений и метрики не попадает (инвариант 25, ADR-094), а
69
+ // сопоставление с шаблоном гранта идёт по `altRefs` (абсолютный путь).
70
+ 'outside',
71
+ ];
72
+ /** Идентификатор вида цели (ядро + доменные, объявленные контентом). */
73
+ export const AUTHORITY_TARGET_KIND_REGEX = /^[a-z][a-z0-9._-]*$/;
74
+ export const authorityTargetKindSchema = z
75
+ .string()
76
+ .min(1)
77
+ .max(64)
78
+ .regex(AUTHORITY_TARGET_KIND_REGEX, 'вид цели: строчные латинские буквы/цифры (a-z0-9._-)');
79
+ /** true — вид цели известен ядру (без контента). */
80
+ export function isCoreTargetKind(kind) {
81
+ return AUTHORITY_CORE_TARGET_KINDS.includes(kind);
82
+ }
83
+ // --- Действия ---
84
+ /**
85
+ * Идентификатор доменного действия: `read`/`write`/`execute`/`publish`/
86
+ * `approve`/`sign`/`delegate`/`commit` — **данные**, а не перечисление ядра.
87
+ */
88
+ export const AUTHORITY_ACTION_ID_REGEX = /^[a-z][a-z0-9._-]*$/;
89
+ export const authorityActionIdSchema = z
90
+ .string()
91
+ .min(1)
92
+ .max(64)
93
+ .regex(AUTHORITY_ACTION_ID_REGEX, 'действие: строчные латинские буквы/цифры (a-z0-9._-)');
94
+ /**
95
+ * Действия, **не** меняющие состояние (ADR-106 Ф5, trust-floor).
96
+ *
97
+ * Мутирующим считается **всё, кроме `read`** (fail-closed): доменные действия
98
+ * по умолчанию мутирующие. Признак `mutating` в манифесте пакета —
99
+ * **информационный**: ему не доверяют, иначе пакет объявил бы своё мутирующее
100
+ * действие «безобидным» и обошёл бы trust-floor (мутирующие гранты
101
+ * активируются только при trust ≥ `trusted`).
102
+ */
103
+ export const AUTHORITY_READ_ONLY_ACTIONS = ['read'];
104
+ /** Ядровые мутирующие действия (перечислены для документации и UI). */
105
+ export const AUTHORITY_MUTATING_ACTIONS = [
106
+ 'write',
107
+ 'execute',
108
+ 'commit',
109
+ 'publish',
110
+ 'approve',
111
+ 'sign',
112
+ 'delegate',
113
+ ];
114
+ /** true — действие мутирующее (меняет состояние). */
115
+ export function isAuthorityMutatingAction(id) {
116
+ return !AUTHORITY_READ_ONLY_ACTIONS.includes(id);
117
+ }
118
+ // --- Цели и шаблоны целей ---
119
+ /**
120
+ * Шаблон цели гранта: `<вид>:<шаблон-ссылки>` (ADR-106 §«Модель»).
121
+ * Примеры: `path:src/**`, `path:*.env`, `mcp:git/*`, `record:*`,
122
+ * `external:registry/*`.
123
+ *
124
+ * Вид обязателен: цель — типизированный ресурс, а не «просто строка».
125
+ */
126
+ export const AUTHORITY_TARGET_PATTERN_REGEX = /^[a-z][a-z0-9._-]*:.+$/;
127
+ export const authorityTargetPatternSchema = z
128
+ .string()
129
+ .min(3)
130
+ .max(256)
131
+ .regex(AUTHORITY_TARGET_PATTERN_REGEX, 'шаблон цели: "<вид>:<шаблон>" (например, path:src/**)');
132
+ // --- Эффекты и ограничения гранта ---
133
+ /** Эффект гранта: разрешить / спросить / запретить. */
134
+ export const AUTHORITY_GRANT_EFFECTS = ['allow', 'ask', 'deny'];
135
+ export const authorityGrantEffectSchema = z.enum(AUTHORITY_GRANT_EFFECTS);
136
+ /**
137
+ * Ограничения гранта (ADR-106 §«Модель»): `once` (одноразовость),
138
+ * `ttlMs` (срок жизни), `maxCount` (лимит применений), `requireConfirm`
139
+ * (требовать подтверждения даже при `allow`).
140
+ */
141
+ export const authorityGrantConstraintsSchema = z
142
+ .object({
143
+ /** Грант одноразовый: повторное применение — `deny`. */
144
+ once: z.boolean().optional(),
145
+ /** Срок жизни гранта, мс. */
146
+ ttlMs: z.number().int().positive().max(31_536_000_000).optional(),
147
+ /** Предел числа применений гранта. */
148
+ maxCount: z.number().int().positive().max(1_000_000).optional(),
149
+ /** Даже `allow` требует подтверждения носителем гранта. */
150
+ requireConfirm: z.boolean().optional(),
151
+ })
152
+ .strict();
153
+ // --- Сущности модели ---
154
+ /**
155
+ * Принципал — тот, от чьего имени исполняется ход (ADR-106 §«Модель»).
156
+ * `roles[]` — роли, которые носитель принципала предъявляет (содержательные
157
+ * роли приезжают контентом; глобальные роли инстанса — отдельная ось).
158
+ */
159
+ export const authorityPrincipalSchema = z
160
+ .object({
161
+ kind: authorityPrincipalKindSchema,
162
+ id: z.string().min(1).max(256),
163
+ roles: z.array(z.string().min(1).max(128)).default([]),
164
+ })
165
+ .strict();
166
+ /**
167
+ * Действие — доменный глагол. `mutating` — признак изменения состояния;
168
+ * `requires[]` — действия, которые нужны перед этим (например, `sign`
169
+ * требует `write`).
170
+ */
171
+ export const authorityActionSchema = z
172
+ .object({
173
+ id: authorityActionIdSchema,
174
+ mutating: z.boolean(),
175
+ requires: z.array(authorityActionIdSchema).default([]),
176
+ })
177
+ .strict();
178
+ /** Цель — типизированный ресурс. */
179
+ export const authorityTargetSchema = z
180
+ .object({
181
+ kind: authorityTargetKindSchema,
182
+ ref: z.string().min(1).max(512),
183
+ /** Область действия (например, проект/схема), необязательна. */
184
+ scope: z.string().min(1).max(256).optional(),
185
+ })
186
+ .strict();
187
+ /**
188
+ * Грант — разрешение «действие × цель» с эффектом и опциональными
189
+ * ограничениями. `deny` в гранте сильнее `allow` (ADR-106 §«Резолвинг и
190
+ * решение»).
191
+ */
192
+ export const authorityGrantSchema = z
193
+ .object({
194
+ action: authorityActionIdSchema,
195
+ targetPattern: authorityTargetPatternSchema,
196
+ effect: authorityGrantEffectSchema,
197
+ constraints: authorityGrantConstraintsSchema.optional(),
198
+ })
199
+ .strict();
200
+ /** Роль — именованный набор грантов (поставляется контентом). */
201
+ export const authorityRoleSchema = z
202
+ .object({
203
+ id: z.string().min(1).max(128),
204
+ displayName: z.string().min(1).max(256).optional(),
205
+ domain: z.string().min(1).max(128),
206
+ grants: z.array(authorityGrantSchema).default([]),
207
+ })
208
+ .strict();
209
+ /** Источники потолка (верхней границы активных прав). */
210
+ export const AUTHORITY_CEILING_SOURCES = ['user', 'session', 'pack', 'instance'];
211
+ export const authorityCeilingSourceSchema = z.enum(AUTHORITY_CEILING_SOURCES);
212
+ /**
213
+ * Потолок — верхняя граница активных прав. Потолок с пустым списком грантов
214
+ * **задаёт** запрет на всё (ось применима, грантов нет → «нет гранта — нет
215
+ * права»); отсутствие потолка означает, что ось не применима.
216
+ */
217
+ export const authorityCeilingSchema = z
218
+ .object({
219
+ grants: z.array(authorityGrantSchema).default([]),
220
+ source: authorityCeilingSourceSchema,
221
+ })
222
+ .strict();
223
+ /**
224
+ * Ход — единица исполнения. Принципал фиксируется **при приёме ввода**
225
+ * (ADR-106 §«Инварианты модели», п. 4) — в Ф4; в Ф0–Ф1 это просто контракт.
226
+ */
227
+ export const authorityTurnSchema = z
228
+ .object({
229
+ id: z.string().min(1).max(128),
230
+ sessionId: z.string().min(1).max(128),
231
+ principal: authorityPrincipalSchema,
232
+ /** Агент хода (если ход исполняет агент). */
233
+ agentId: z.string().min(1).max(128).optional(),
234
+ /** Потолки хода (сессия/пакет/инстанс). */
235
+ ceiling: z.array(authorityCeilingSchema).default([]),
236
+ startedAt: z.string().min(1),
237
+ })
238
+ .strict();
239
+ /**
240
+ * Подтверждение — запрос на действие, привязанный к
241
+ * `(principal, turn, action, target, digest)`; одноразовый (`once`).
242
+ */
243
+ export const authorityApprovalSchema = z
244
+ .object({
245
+ id: z.string().min(1).max(128),
246
+ turnId: z.string().min(1).max(128),
247
+ principal: authorityPrincipalSchema,
248
+ action: authorityActionIdSchema,
249
+ target: authorityTargetSchema,
250
+ /** Отпечаток запроса (действие + цель + ход) — защита от подмены. */
251
+ digest: z.string().min(1).max(256),
252
+ once: z.boolean(),
253
+ expiresAt: z.string().min(1).optional(),
254
+ })
255
+ .strict();
256
+ /**
257
+ * Объявление вида цели контентом: `kind` + имя резолвера (резолверы целей
258
+ * регистрирует ядро или плагин — ADR-106 §«Декларация, не код»).
259
+ */
260
+ export const authorityTargetDeclarationSchema = z
261
+ .object({
262
+ kind: authorityTargetKindSchema,
263
+ resolver: z.string().min(1).max(128).optional(),
264
+ })
265
+ .strict();
266
+ /**
267
+ * Привязка агента к ролям и потолку (ADR-106 Ф5): контент пакета объявляет,
268
+ * какие роли носит агент (`roles[]`) и какие действия ему потолок
269
+ * (`ceiling[]` — идентификаторы действий).
270
+ *
271
+ * Роли — из `policy.roles` (их гранты уже прошли пересечение с политикой
272
+ * инстанса и trust-floor), потолок — **запись** о намерении пакета; принуждение
273
+ * оси `pack` по нему — остаток (ADR-106 §11).
274
+ */
275
+ export const authorityPolicyAgentSchema = z
276
+ .object({
277
+ /** id агента. */
278
+ id: z.string().min(1).max(128),
279
+ /** Роли агента (id из `policy.roles`). */
280
+ roles: z.array(z.string().min(1).max(128)).default([]),
281
+ /** Потолок агента — идентификаторы действий. */
282
+ ceiling: z.array(z.string().min(1).max(64)).default([]),
283
+ })
284
+ .strict();
285
+ /**
286
+ * Политика полномочий инстанса — верхняя граница (ADR-106 §«Точки
287
+ * принуждения», уровень 4). Хранится через порт `AuthorityPolicyRepository`
288
+ * (ADR-096).
289
+ */
290
+ export const authorityPolicySchema = z
291
+ .object({
292
+ /** Объявленные действия (доменные глаголы). */
293
+ actions: z.array(authorityActionSchema).default([]),
294
+ /** Объявленные роли. */
295
+ roles: z.array(authorityRoleSchema).default([]),
296
+ /** Виды целей, известные инстансу (ядро + объявленные контентом). */
297
+ targets: z.array(authorityTargetDeclarationSchema).default([]),
298
+ /** Потолок инстанса. */
299
+ ceilings: z.array(authorityCeilingSchema).default([]),
300
+ /** Привязки агентов к ролям и потолку (ADR-106 Ф5). */
301
+ agents: z.array(authorityPolicyAgentSchema).default([]),
302
+ })
303
+ .strict();
304
+ // --- Запись журнала решений ---
305
+ /**
306
+ * Запись append-only журнала решений Authority-слоя (ADR-106 §«Инварианты
307
+ * модели», п. 8): `principal`/`action`/`target`/`effect`/`source` — **без
308
+ * секретов и без сырых путей** (путь нормализуется до относительного внутри
309
+ * workspace, инвариант 25/ADR-094).
310
+ */
311
+ export const authorityDecisionEntrySchema = z
312
+ .object({
313
+ id: z.string().min(1).max(128),
314
+ ts: z.string().min(1),
315
+ /** Принципал в виде `<вид>:<идентификатор>`. */
316
+ principal: z.string().min(1).max(256),
317
+ action: z.string().min(1).max(64),
318
+ /** Цель в виде `<вид>:<ссылка>` (нормализованная). */
319
+ target: z.string().min(1).max(512),
320
+ effect: authorityGrantEffectSchema,
321
+ /** Ось, давшая решение (`user`/`agent`/`session`/`pack`/`instance`). */
322
+ source: z.string().min(1).max(32),
323
+ /** Причина: `unknown`/`explicit`/`no_grant`/null. */
324
+ reason: z.string().min(1).max(64).nullable(),
325
+ /** Режим: `shadow` — решение посчитано, но не применено (Ф1). */
326
+ mode: z.enum(['shadow', 'enforced']).default('shadow'),
327
+ /**
328
+ * ADR-106 Ф1: решение permission-слоя на момент shadow-записи. Нужно для
329
+ * разбора расхождений миграции («shadow-решение не совпало с текущим —
330
+ * это дефект миграции»). В enforced-режиме поле отсутствует.
331
+ */
332
+ permissionEffect: z.enum(['allow', 'ask', 'deny']).optional(),
333
+ })
334
+ .strict();
335
+ /**
336
+ * Проверка целостности контента — **список проблем строками** (как
337
+ * `validatePackManifest`), без throw.
338
+ *
339
+ * Проверяется:
340
+ * 1. дубликаты id действий и ролей;
341
+ * 2. грант ссылается на **объявленное** действие (неизвестное действие — отказ);
342
+ * 3. `action.requires[]` ссылается на объявленные действия;
343
+ * 4. вид цели в шаблоне гранта — известен ядру или объявлен в `targets[]`
344
+ * (неизвестная цель — отказ);
345
+ * 5. агент ссылается на объявленные роли и на объявленные действия в потолке.
346
+ */
347
+ export function validateAuthorityContent(content) {
348
+ const problems = [];
349
+ const actionIds = new Set();
350
+ content.actions.forEach((action, index) => {
351
+ if (actionIds.has(action.id)) {
352
+ problems.push(`actions[${index}]: дубликат id действия «${action.id}»`);
353
+ return;
354
+ }
355
+ actionIds.add(action.id);
356
+ });
357
+ const roleIds = new Set();
358
+ content.roles.forEach((role, index) => {
359
+ if (roleIds.has(role.id)) {
360
+ problems.push(`roles[${index}]: дубликат id роли «${role.id}»`);
361
+ return;
362
+ }
363
+ roleIds.add(role.id);
364
+ });
365
+ const targetKinds = new Set(AUTHORITY_CORE_TARGET_KINDS);
366
+ content.targets.forEach((target, index) => {
367
+ if (targetKinds.has(target.kind)) {
368
+ problems.push(`targets[${index}]: вид цели «${target.kind}» уже известен ядру`);
369
+ return;
370
+ }
371
+ targetKinds.add(target.kind);
372
+ });
373
+ content.actions.forEach((action, index) => {
374
+ action.requires.forEach((required, reqIndex) => {
375
+ if (!actionIds.has(required)) {
376
+ problems.push(`actions[${index}].requires[${reqIndex}]: неизвестное действие «${required}»`);
377
+ }
378
+ });
379
+ });
380
+ content.roles.forEach((role, index) => {
381
+ role.grants.forEach((grant, grantIndex) => {
382
+ if (!actionIds.has(grant.action)) {
383
+ problems.push(`roles[${index}].grants[${grantIndex}]: неизвестное действие «${grant.action}»`);
384
+ }
385
+ const kind = targetKindOfPattern(grant.targetPattern);
386
+ if (kind !== undefined && !targetKinds.has(kind)) {
387
+ problems.push(`roles[${index}].grants[${grantIndex}]: неизвестный вид цели «${kind}»`);
388
+ }
389
+ });
390
+ });
391
+ (content.agents ?? []).forEach((agent, index) => {
392
+ agent.roles.forEach((roleId, roleIndex) => {
393
+ if (!roleIds.has(roleId)) {
394
+ problems.push(`agents[${index}].roles[${roleIndex}]: неизвестная роль «${roleId}»`);
395
+ }
396
+ });
397
+ (agent.ceiling ?? []).forEach((actionId, actionIndex) => {
398
+ if (!actionIds.has(actionId)) {
399
+ problems.push(`agents[${index}].ceiling[${actionIndex}]: неизвестное действие «${actionId}»`);
400
+ }
401
+ });
402
+ });
403
+ return problems;
404
+ }
405
+ /** Вид цели из шаблона (`path:src/**` → `path`); `undefined` — шаблон без вида. */
406
+ export function targetKindOfPattern(pattern) {
407
+ const idx = pattern.indexOf(':');
408
+ if (idx <= 0)
409
+ return undefined;
410
+ return pattern.slice(0, idx);
411
+ }
412
+ // --- Матчинг целей ---
413
+ /** Строковое представление цели: `<вид>:<ссылка>`. */
414
+ export function formatAuthorityTarget(target) {
415
+ return `${target.kind}:${target.ref}`;
416
+ }
417
+ /**
418
+ * Совпадает ли шаблон гранта с целью.
419
+ *
420
+ * Шаблон разбирается на вид и шаблон ссылки: вид обязан совпасть, ссылка
421
+ * сравнивается glob'ом (`*` — сегмент, `**` — путь, ADR-029). Дополнительные
422
+ * формы ссылки (`altRefs`) проверяются тоже — так же, как permission-слой
423
+ * применяет файловый паттерн и к абсолютному, и к относительному пути.
424
+ *
425
+ * Несовпадение вида → `false` (fail-closed): грант на `path:*` не покрывает
426
+ * цель `session:*`.
427
+ */
428
+ export function matchAuthorityTargetPattern(pattern, target, altRefs) {
429
+ const idx = pattern.indexOf(':');
430
+ if (idx <= 0)
431
+ return false;
432
+ const kind = pattern.slice(0, idx);
433
+ if (kind !== target.kind)
434
+ return false;
435
+ const refPattern = pattern.slice(idx + 1);
436
+ if (refPattern === '')
437
+ return false;
438
+ if (globMatch(refPattern, target.ref))
439
+ return true;
440
+ for (const alt of altRefs ?? []) {
441
+ if (globMatch(refPattern, alt))
442
+ return true;
443
+ }
444
+ return false;
445
+ }
@@ -0,0 +1,96 @@
1
+ /**
2
+ * Контракт единого реестра фоновых прогонов (этап 1 roadmap 0.13 — блок 1.2).
3
+ *
4
+ * Реестр обслуживает два вида фоновой работы:
5
+ * - `subagent` — дочерняя сессия саб-агента, запущенная в фоне (PROP-096);
6
+ * - `process` — шелл-команда, запущенная в фоне (PROP-097).
7
+ *
8
+ * Запись — персистентная (порт `BackgroundRunRepository`, ADR-096): она
9
+ * переживает реконнект UI и рестарт сервиса, поэтому UI/родитель читают
10
+ * состояние прогона из реестра, а не из «живого» канала.
11
+ *
12
+ * Здесь только контракты (типы) — без бизнес-логики: запуск, учёт pid и
13
+ * остановка процесса живут в core.
14
+ */
15
+ /**
16
+ * Вид фоновой работы:
17
+ * - `subagent` — фоновая дочерняя сессия (родитель — `sessionId`);
18
+ * - `process` — фоновая шелл-команда (владелец — `sessionId`, запустивший команду).
19
+ */
20
+ export type BackgroundRunKind = 'subagent' | 'process';
21
+ /**
22
+ * Статус фонового прогона:
23
+ * - `running` — идёт;
24
+ * - `completed` — успешно завершён;
25
+ * - `failed` — завершён с ошибкой;
26
+ * - `cancelled` — остановлен;
27
+ * - `orphaned` — процесс пережил рестарт сервиса, но его уже не отследить.
28
+ */
29
+ export type BackgroundRunStatus = 'running' | 'completed' | 'failed' | 'cancelled' | 'orphaned';
30
+ /**
31
+ * Терминальные статусы фонового прогона — записи, которые можно чистить
32
+ * (`prune`); `running` — не терминальный.
33
+ */
34
+ export declare const BACKGROUND_RUN_TERMINAL_STATUSES: readonly BackgroundRunStatus[];
35
+ /**
36
+ * Запись фонового прогона (`bgr_<uuid>`).
37
+ *
38
+ * Единый реестр для фоновых детей-сабагентов и шелл-процессов (PROP-096/PROP-097
39
+ * рекомендуют один реестр).
40
+ */
41
+ export interface BackgroundRunRecord {
42
+ /** `bgr_<uuid>`, уникален в пределах инстанса. */
43
+ id: string;
44
+ kind: BackgroundRunKind;
45
+ status: BackgroundRunStatus;
46
+ /** Владелец-сессия: для `subagent` — родитель, для `process` — запустившая команда. */
47
+ sessionId: string;
48
+ /** Проект сессии-владельца (необязательно). */
49
+ projectId?: string;
50
+ /** `kind=subagent`: дочерняя сессия. */
51
+ childSessionId?: string;
52
+ /** Агент, выполняющий прогон (`subagent` — роль агента). */
53
+ agentRole?: string;
54
+ /** Краткое описание прогона для UI. */
55
+ description?: string;
56
+ /** `kind=process`: запущенная команда. */
57
+ command?: string;
58
+ /** `kind=process`: рабочий каталог команды. */
59
+ cwd?: string;
60
+ /** `kind=process`: pid процесса. */
61
+ pid?: number;
62
+ /**
63
+ * `kind=process`: идентификатор фонового процесса у порта исполнения
64
+ * (`proc_<uuid>`) — по нему процесс останавливается и различается в UI.
65
+ */
66
+ processId?: string;
67
+ /** Относительный путь лога в BlobStore (`processes/<id>.log`). */
68
+ logPath?: string;
69
+ /** Код завершения процесса. */
70
+ exitCode?: number;
71
+ /** Сигнал, завершивший процесс. */
72
+ signal?: string;
73
+ /** Начало прогона (ISO-8601). */
74
+ startedAt: string;
75
+ /** Момент завершения прогона (ISO-8601). */
76
+ finishedAt?: string;
77
+ /** Момент последнего изменения записи (ISO-8601). */
78
+ updatedAt: string;
79
+ /** Краткий итог/ошибка для UI и уведомления родителю. */
80
+ summary?: string;
81
+ /** Дополнительные сведения прогона. */
82
+ metadata?: Record<string, unknown>;
83
+ }
84
+ /** Фильтр выборки фоновых прогонов (все условия — по «И»). */
85
+ export interface BackgroundRunFilter {
86
+ /** Вид фоновой работы. */
87
+ kind?: BackgroundRunKind;
88
+ /** Статус прогона. */
89
+ status?: BackgroundRunStatus;
90
+ /** Сессия-владелец. */
91
+ sessionId?: string;
92
+ /** Проект сессии-владельца. */
93
+ projectId?: string;
94
+ /** Потолок выборки (свежие первыми). */
95
+ limit?: number;
96
+ }
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Контракт единого реестра фоновых прогонов (этап 1 roadmap 0.13 — блок 1.2).
3
+ *
4
+ * Реестр обслуживает два вида фоновой работы:
5
+ * - `subagent` — дочерняя сессия саб-агента, запущенная в фоне (PROP-096);
6
+ * - `process` — шелл-команда, запущенная в фоне (PROP-097).
7
+ *
8
+ * Запись — персистентная (порт `BackgroundRunRepository`, ADR-096): она
9
+ * переживает реконнект UI и рестарт сервиса, поэтому UI/родитель читают
10
+ * состояние прогона из реестра, а не из «живого» канала.
11
+ *
12
+ * Здесь только контракты (типы) — без бизнес-логики: запуск, учёт pid и
13
+ * остановка процесса живут в core.
14
+ */
15
+ /**
16
+ * Терминальные статусы фонового прогона — записи, которые можно чистить
17
+ * (`prune`); `running` — не терминальный.
18
+ */
19
+ export const BACKGROUND_RUN_TERMINAL_STATUSES = [
20
+ 'completed',
21
+ 'failed',
22
+ 'cancelled',
23
+ 'orphaned',
24
+ ];
@@ -1,7 +1,29 @@
1
- export type EventType = 'session.created' | 'session.updated' | 'session.deleted' | 'session.renamed' | 'session.forked' | 'session.fork.created' | 'session.reference.added' | 'session.reference.removed' | 'session.messages.merged' | 'session.moved' | 'project.updated' | 'fs.changed' | 'message.added' | 'message.updated' | 'child.message.added' | 'child.session.updated' | 'stream.start' | 'stream.chunk' | 'stream.usage' | 'stream.done' | 'stream.ended' | 'stream.cancelled' | 'stream.error' | 'stream.retry' | 'queue.stalled' | 'message.queued' | 'permission.asked' | 'permission.replied' | 'permission.hold' | 'question.asked' | 'question.replied' | 'context.summarization_pending' | 'context.summarized' | 'context.sliding_window_applied' | 'context.limit_warning' | 'context.sticky_note_added' | 'context.sticky_note_updated' | 'context.sticky_note_deleted' | 'context.instructions_loaded' | 'tool_call.started' | 'tool_call.result' | 'tool_call.loop' | 'subagent.progress' | 'subagent.retry' | 'subagent.resume.started' | 'subagent.resume.finished' | 'permission.asked' | 'permission.replied' | 'permission.denied' | 'message.quality_check' | 'session.routing_category' | 'plan.approved' | 'todos.updated' | 'skill.invoked' | 'command.invoked' | 'command.inline_shell' | 'event.received' | 'event.routed' | 'binding.changed' | 'error';
1
+ import type { WorktreeUpdateAction } from './worktree.js';
2
+ export type EventType = 'session.created' | 'session.updated' | 'session.deleted' | 'session.renamed' | 'session.forked' | 'session.fork.created' | 'session.reference.added' | 'session.reference.removed' | 'session.messages.merged' | 'session.moved' | 'project.updated' | 'worktree.updated' | 'fs.changed' | 'message.added' | 'message.updated' | 'message.injected' | 'steer.dropped' | 'stream.interrupted' | 'child.message.added' | 'child.session.updated' | 'stream.start' | 'stream.chunk' | 'stream.usage' | 'stream.done' | 'stream.ended' | 'stream.cancelled' | 'stream.error' | 'stream.retry' | 'queue.stalled' | 'message.queued' | 'permission.asked' | 'permission.replied' | 'permission.hold' | 'question.asked' | 'question.replied' | 'context.summarization_pending' | 'context.summarized' | 'context.sliding_window_applied' | 'context.limit_warning' | 'context.sticky_note_added' | 'context.sticky_note_updated' | 'context.sticky_note_deleted' | 'context.instructions_loaded' | 'tool_call.started' | 'tool_call.result' | 'tool_call.loop' | 'subagent.progress' | 'subagent.retry' | 'subagent.resume.started' | 'subagent.resume.finished' | 'permission.asked' | 'permission.replied' | 'permission.denied' | 'message.quality_check' | 'session.routing_category' | 'plan.approved' | 'todos.updated' | 'skill.invoked' | 'command.invoked' | 'command.inline_shell' | 'event.received' | 'event.routed' | 'binding.changed' | 'pipeline.run.started' | 'pipeline.run.node_started' | 'pipeline.run.node_finished' | 'pipeline.run.awaiting_human' | 'pipeline.run.finished' | 'pipeline.run.failed' | 'pipeline.completed' | 'user_question.asked' | 'user_question.answered' | 'user_question.cancelled' | 'process.started' | 'process.exited' | 'process.stopped' | 'process.detached' | 'child.started' | 'child.completed' | 'child.failed' | 'child.cancelled' | 'error';
2
3
  export interface BusEvent {
3
4
  type: EventType;
4
5
  sessionId: string;
5
6
  data: Record<string, unknown>;
6
7
  timestamp: string;
7
8
  }
9
+ /**
10
+ * Payload события `worktree.updated` (ADR-114 §6) — инвентарь worktree'ов
11
+ * проекта изменился.
12
+ *
13
+ * Событие идёт в **каналы сессий проекта** (инвентарь — ресурс проекта, а не
14
+ * одной сессии), поэтому подписчики соседних сессий тоже видят изменение.
15
+ * `action` позволяет отличить создание от удаления/привязки без чтения
16
+ * инвентаря; `worktree_id` — конкретная запись (нет — для prune/sweep).
17
+ *
18
+ * Объявлен **type-алиасом** (не интерфейсом): алиас получает неявную
19
+ * index-signature и потомуassignable к `Record<string, unknown>` — payload
20
+ * шины (`EventBus.publish`) именно такой тип.
21
+ */
22
+ export type WorktreeUpdatedPayload = {
23
+ /** Проект-владелец инвентаря. */
24
+ project_id: string;
25
+ /** Id записи worktree (не задан — изменение по проекту целиком). */
26
+ worktree_id?: string;
27
+ /** Что произошло (ADR-114 §6). */
28
+ action: WorktreeUpdateAction;
29
+ };