@itphx/synth-shared 0.13.4 → 0.13.10

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 (89) hide show
  1. package/dist/config/defaults.js +102 -3
  2. package/dist/config/env-overrides.d.ts +39 -4
  3. package/dist/config/env-overrides.js +174 -4
  4. package/dist/config/execution-runtime.d.ts +89 -0
  5. package/dist/config/execution-runtime.js +506 -0
  6. package/dist/config/execution.d.ts +202 -1
  7. package/dist/config/execution.js +459 -3
  8. package/dist/config/index.d.ts +3 -0
  9. package/dist/config/index.js +3 -0
  10. package/dist/config/loader.d.ts +8 -0
  11. package/dist/config/loader.js +6 -1
  12. package/dist/config/redact.d.ts +22 -0
  13. package/dist/config/redact.js +53 -0
  14. package/dist/config/security.d.ts +77 -0
  15. package/dist/config/security.js +116 -0
  16. package/dist/config/tls.d.ts +7 -4
  17. package/dist/config/tls.js +10 -23
  18. package/dist/config/types.d.ts +568 -38
  19. package/dist/config/types.js +390 -33
  20. package/dist/i18n/index.d.ts +1 -1
  21. package/dist/i18n/index.js +325 -13
  22. package/dist/index.d.ts +7 -6
  23. package/dist/index.js +17 -4
  24. package/dist/model-metadata.d.ts +10 -0
  25. package/dist/model-metadata.js +10 -0
  26. package/dist/schemas/index.d.ts +444 -30
  27. package/dist/schemas/index.js +354 -17
  28. package/dist/skills/frontmatter.js +1 -1
  29. package/dist/types/agent.d.ts +29 -1
  30. package/dist/types/authority.d.ts +10 -0
  31. package/dist/types/authority.js +8 -0
  32. package/dist/types/bus-events.d.ts +88 -2
  33. package/dist/types/catalog.d.ts +1 -1
  34. package/dist/types/catalog.js +1 -1
  35. package/dist/types/command-audit.d.ts +91 -0
  36. package/dist/types/command-audit.js +44 -0
  37. package/dist/types/commands.d.ts +29 -11
  38. package/dist/types/commands.js +2 -2
  39. package/dist/types/egress.d.ts +18 -3
  40. package/dist/types/egress.js +18 -3
  41. package/dist/types/events.d.ts +23 -2
  42. package/dist/types/execution.d.ts +424 -0
  43. package/dist/types/execution.js +355 -0
  44. package/dist/types/file-kind.d.ts +3 -2
  45. package/dist/types/file-kind.js +11 -2
  46. package/dist/types/git.d.ts +131 -0
  47. package/dist/types/git.js +101 -1
  48. package/dist/types/host-pattern.d.ts +41 -0
  49. package/dist/types/host-pattern.js +143 -0
  50. package/dist/types/index.d.ts +8 -0
  51. package/dist/types/index.js +25 -3
  52. package/dist/types/maintenance.d.ts +1 -1
  53. package/dist/types/mcp.d.ts +90 -0
  54. package/dist/types/mcp.js +11 -0
  55. package/dist/types/mentions.d.ts +96 -0
  56. package/dist/types/mentions.js +9 -0
  57. package/dist/types/message-stream.d.ts +41 -0
  58. package/dist/types/message.d.ts +24 -1
  59. package/dist/types/message.js +13 -0
  60. package/dist/types/pack.d.ts +21 -21
  61. package/dist/types/pack.js +4 -4
  62. package/dist/types/permission.d.ts +20 -3
  63. package/dist/types/pipeline.d.ts +2 -2
  64. package/dist/types/plugin-protocol.d.ts +203 -4
  65. package/dist/types/plugin-protocol.js +77 -4
  66. package/dist/types/project-access.d.ts +94 -0
  67. package/dist/types/project-access.js +140 -0
  68. package/dist/types/project.d.ts +89 -2
  69. package/dist/types/project.js +36 -0
  70. package/dist/types/prompt.d.ts +4 -2
  71. package/dist/types/schedules.d.ts +49 -3
  72. package/dist/types/schedules.js +50 -1
  73. package/dist/types/scripts.d.ts +98 -0
  74. package/dist/types/scripts.js +14 -0
  75. package/dist/types/service-keys.d.ts +16 -3
  76. package/dist/types/service-keys.js +19 -1
  77. package/dist/types/session.d.ts +68 -3
  78. package/dist/types/skills.d.ts +21 -11
  79. package/dist/types/skills.js +6 -6
  80. package/dist/types/timers.d.ts +402 -0
  81. package/dist/types/timers.js +166 -0
  82. package/dist/types/tools.d.ts +160 -1
  83. package/dist/types/tools.js +70 -0
  84. package/dist/types/user.d.ts +24 -0
  85. package/dist/types/worktree.d.ts +1 -1
  86. package/dist/utils/index.js +1 -1
  87. package/dist/version.d.ts +1 -1
  88. package/dist/version.js +1 -1
  89. package/package.json +3 -2
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
- import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, STEER_MODES, DEFAULT_STEER_MODE, EFFORT_LEVELS, } from '../types/index.js';
2
+ import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, STEER_MODES, DEFAULT_STEER_MODE, EFFORT_LEVELS, SSH_KEY_USAGES, MAX_SSH_ALLOW_HOSTS, MAX_SSH_ALLOW_PORTS, isValidHostRule, HOST_RULE_FORMAT_HINT, MARKDOWN_LIMITS, TODO_STATUSES, TODO_PRIORITIES, } from '../types/index.js';
3
+ import { normalizeProjectAccessRole } from '../types/project-access.js';
3
4
  import { ToolCapability } from '../types/tools.js';
4
5
  /**
5
6
  * Экземпляр zod, которым построены **все** схемы этого пакета.
@@ -17,6 +18,26 @@ export const statusMessageTypeSchema = z.nativeEnum(StatusMessageType);
17
18
  /** Zod-схемы канонических ключей иконок/цветов (единые для project и session). */
18
19
  export const projectIconKeySchema = z.enum(PROJECT_ICON_KEYS);
19
20
  export const projectColorKeySchema = z.enum(PROJECT_COLOR_KEYS);
21
+ /**
22
+ * PROP-133: роль доступа к проекту (входной контракт записи состояния
23
+ * доступа). Неизвестная роль → `400 VALIDATION_ERROR` (fail-closed).
24
+ */
25
+ export const projectAccessRoleSchema = z.enum(['owner', 'editor', 'viewer']);
26
+ /**
27
+ * PROP-133 §3.1: роль режима «всем пользователям» (`everyone_role`).
28
+ *
29
+ * Только `viewer`/`editor`: роль `owner` всем пользователям не выдаётся
30
+ * (эскалация прав) — роут режет такое значение `400 VALIDATION_ERROR`,
31
+ * значит и схема его не принимает (контракт схемы и роута совпадает).
32
+ */
33
+ export const projectEveryoneRoleSchema = z.enum(['viewer', 'editor']);
34
+ /**
35
+ * PROP-133: производное состояние видимости проекта — **только чтение/DTO**
36
+ * (во входные схемы не входит: значение выводится из состояния списка доступа).
37
+ */
38
+ export const projectVisibilitySchema = z.enum(['author', 'selected', 'all']);
39
+ /** PROP-133: карта грантов (субъект → роль). */
40
+ export const projectMembersSchema = z.record(z.string().min(1), projectAccessRoleSchema);
20
41
  /** true, если значение — канонический ключ иконки (для записи и чтения). */
21
42
  export function isProjectIconKey(value) {
22
43
  return typeof value === 'string' && PROJECT_ICON_KEYS.includes(value);
@@ -42,11 +63,12 @@ export function normalizeColorKey(value) {
42
63
  /**
43
64
  * ADR-106 Ф4: нормализация роли участника сессии. Каноническая роль → как
44
65
  * есть; всё прочее — **fail-closed** (`viewer`, только чтение).
66
+ *
67
+ * Канонический нормализатор — `normalizeProjectAccessRole` (PROP-133 §1): один
68
+ * источник истины для ролей проекта и участников сессии.
45
69
  */
46
70
  export function normalizeSessionParticipantRole(value) {
47
- if (value === 'owner' || value === 'editor' || value === 'viewer')
48
- return value;
49
- return 'viewer';
71
+ return normalizeProjectAccessRole(value);
50
72
  }
51
73
  export const tokenUsageSchema = z.object({
52
74
  inputTokens: z.number().int().min(0),
@@ -142,6 +164,17 @@ export const sessionSettingsSchema = z.object({
142
164
  debugEnabled: z.boolean().default(true),
143
165
  streamEnabled: z.boolean().default(true),
144
166
  agentRole: z.string().optional(),
167
+ /**
168
+ * PROP-135 Ф4a: имя профиля исполнения сессии (`execution.remote.profiles`).
169
+ * Порт тулов сессии выбирает роутер по этому имени; не задан — профиль по
170
+ * умолчанию (`execution.remote.defaultProfile`).
171
+ */
172
+ executorProfile: z.string().optional(),
173
+ /**
174
+ * PROP-135 (браузерный контур): профиль браузерного пула сессии. Пустая
175
+ * строка — явный сброс (наследование агент→проект→инстанс).
176
+ */
177
+ browserProfile: z.string().optional(),
145
178
  // ADR-071 §2.4: сессионный скоуп MCP (явно включённые / opt-out).
146
179
  mcpServers: z.array(z.string()).optional(),
147
180
  mcpDisabledServers: z.array(z.string()).optional(),
@@ -165,7 +198,7 @@ export const sessionSettingsSchema = z.object({
165
198
  language: z.string().optional(),
166
199
  // === Plan/Act (ADR-025) ===
167
200
  planMode: z.enum(['auto', 'strict', 'off']).optional(),
168
- // === Скиллы (ADR-046 §4.5) ===
201
+ // === Скиллы (ADR-126 §11) ===
169
202
  skills: z.array(z.string()).optional(),
170
203
  skillsDisabled: z.array(z.string()).optional(),
171
204
  // === Микро-слой (ADR-035/ADR-084) ===
@@ -229,9 +262,30 @@ export const projectCreateSchema = z.object({
229
262
  color: projectColorKeySchema.optional().nullable(),
230
263
  workspace: z.string().optional(),
231
264
  repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
265
+ // PROP-133 §3.1: состояние списка доступа. `everyone_role: null` — проект
266
+ // не опубликован; `visibility` во вход не принимается (производная величина).
267
+ members: projectMembersSchema.optional(),
268
+ group_members: projectMembersSchema.optional(),
269
+ everyone_role: z.union([projectEveryoneRoleSchema, z.null()]).optional(),
232
270
  });
233
271
  /** ADR-107: проектная политика памяти (undefined — не менять). */
234
272
  export const projectMemoryUpdateSchema = z.object({ enabled: z.boolean().optional() });
273
+ /**
274
+ * PROP-135 Ф6a: профиль исполнения проекта (`PUT /api/v2/projects/:id`).
275
+ *
276
+ * `profile`/`allowedProfiles` — `null`/`''` сбрасывают значение (потолок не
277
+ * задан), `[]` — «профилей нет» (ADR-135, аддендум: пустой список = ничего не
278
+ * разрешено). Существование профиля в `execution.remote.profiles` и его
279
+ * вхождение в список разрешённых проверяет роут (если каталог ему доступен).
280
+ */
281
+ export const projectExecutorUpdateSchema = z.object({
282
+ profile: z.string().nullable().optional(),
283
+ allowedProfiles: z.array(z.string()).nullable().optional(),
284
+ /** PROP-135 (браузерный контур): профиль браузерного пула проекта. */
285
+ browserProfile: z.string().nullable().optional(),
286
+ /** PROP-135 (браузерный контур): потолок браузерных профилей проекта. */
287
+ allowedBrowserProfiles: z.array(z.string()).nullable().optional(),
288
+ });
235
289
  export const projectUpdateSchema = z.object({
236
290
  name: z.string().min(1).max(200).optional(),
237
291
  description: z.string().optional(),
@@ -242,14 +296,65 @@ export const projectUpdateSchema = z.object({
242
296
  workspace: z.string().optional(),
243
297
  repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
244
298
  memory: projectMemoryUpdateSchema.optional(),
299
+ executor: projectExecutorUpdateSchema.optional(),
300
+ // PROP-133 §3.1: состояние списка доступа (см. `projectCreateSchema`).
301
+ members: projectMembersSchema.optional(),
302
+ group_members: projectMembersSchema.optional(),
303
+ everyone_role: z.union([projectEveryoneRoleSchema, z.null()]).optional(),
304
+ });
305
+ /**
306
+ * ADR-140 Ф3: тело передачи владения проектом
307
+ * (`POST /api/v2/projects/:id/transfer`).
308
+ *
309
+ * `user_id` — id нового владельца (обязателен, непустая строка). Тело
310
+ * **strict**: лишнее поле — ошибка валидации, а не молчаливое игнорирование
311
+ * (опечатка в теле иначе «передала бы владение не туда»).
312
+ */
313
+ export const projectTransferSchema = z.object({ user_id: z.string().min(1) }).strict();
314
+ /**
315
+ * PROP-124: правило хоста в политике SSH-ключа.
316
+ *
317
+ * Семантика — общая с ADR-099 (`matchTlsHostPattern`/`isValidHostRule`):
318
+ * точный hostname, `*.suffix` (только поддомены), IP-литерал или CIDR.
319
+ * Одиночный `*` («любой хост») недопустим — fail-closed.
320
+ */
321
+ const sshHostRuleSchema = z
322
+ .string()
323
+ .max(253)
324
+ .refine((value) => isValidHostRule(value), {
325
+ message: `невалидный шаблон хоста: ${HOST_RULE_FORMAT_HINT}`,
245
326
  });
246
- /** ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`). */
327
+ /**
328
+ * ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`).
329
+ *
330
+ * PROP-124: дополнительно принимает `usages` (`git`/`ssh`), `allowHosts`
331
+ * (правила хостов) и `allowPorts` (порты 1..65535) — политику ключа для
332
+ * режима инстанса `tools`.
333
+ */
247
334
  export const sshKeyCreateSchema = z.object({
248
335
  name: z.string().min(1).max(200),
249
336
  type: z.string().optional(),
250
337
  privateKey: z.string().min(1),
251
338
  passphrase: z.string().optional(),
252
339
  agentIds: z.array(z.string()).optional(),
340
+ /**
341
+ * PROP-124: способы использования ключа (`git`/`ssh`).
342
+ *
343
+ * Пустой список **недопустим**: ключ без назначения бесполезен (не годится
344
+ * ни для git, ни для ssh) — это тихая ловушка, в которой можно застрять,
345
+ * сняв оба флажка. Если поле передано — в нём должно быть хотя бы одно
346
+ * значение (`400 VALIDATION_ERROR`).
347
+ */
348
+ usages: z
349
+ .array(z.enum(SSH_KEY_USAGES))
350
+ .min(1, {
351
+ message: `usages: нужен хотя бы один способ использования (${SSH_KEY_USAGES.join('|')})`,
352
+ })
353
+ .optional(),
354
+ /** PROP-124: правила хостов (режим `tools`); лимит — `MAX_SSH_ALLOW_HOSTS`. */
355
+ allowHosts: z.array(sshHostRuleSchema).max(MAX_SSH_ALLOW_HOSTS).optional(),
356
+ /** PROP-124: порты (режим `tools`); лимит — `MAX_SSH_ALLOW_PORTS`. */
357
+ allowPorts: z.array(z.number().int().min(1).max(65535)).max(MAX_SSH_ALLOW_PORTS).optional(),
253
358
  });
254
359
  /** ADR-076: тело обновления SSH-ключа (без id/createdAt). */
255
360
  export const sshKeyUpdateSchema = sshKeyCreateSchema.partial();
@@ -402,6 +507,27 @@ export const gitCommitQuerySchema = z.object({
402
507
  repo_path: z.string().default(''),
403
508
  hash: z.string().min(1),
404
509
  });
510
+ /** ADR-076 (этап 1): `GET /git/status` — состояние рабочего дерева репозитория(ев). */
511
+ export const gitStatusQuerySchema = z.object({
512
+ project_id: z.string().min(1),
513
+ repo_path: z.string().default(''),
514
+ });
515
+ /**
516
+ * ADR-076 (этап 1): `GET /git/diff` — diff рабочего дерева.
517
+ *
518
+ * `staged` принимает строковые `true`/`false` (query-параметры): `z.coerce.boolean()`
519
+ * не подходит — `'false'` превратился бы в `true` (та же ловушка, что у
520
+ * `fsWorkspaceBrowseQuerySchema`).
521
+ */
522
+ export const gitDiffQuerySchema = z.object({
523
+ project_id: z.string().min(1),
524
+ repo_path: z.string().default(''),
525
+ path: z.string().min(1).optional(),
526
+ staged: z
527
+ .preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean())
528
+ .default(false),
529
+ context: z.coerce.number().int().min(0).max(10).default(3),
530
+ });
405
531
  const toolCapabilityValues = Object.values(ToolCapability);
406
532
  /**
407
533
  * ADR-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
@@ -454,12 +580,12 @@ export const sessionMcpUpdateSchema = z
454
580
  .refine((v) => v.name !== undefined
455
581
  || v.mcpServers !== undefined
456
582
  || v.mcpDisabledServers !== undefined, { message: 'Требуется name, mcpServers или mcpDisabledServers' });
457
- // --- Скиллы (ADR-046) ---
458
- /** ADR-046 §3.2: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
583
+ // --- Скиллы (ADR-126) ---
584
+ /** ADR-126 §13: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
459
585
  export const SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
460
586
  export const SKILL_NAME_MIN = 1;
461
587
  export const SKILL_NAME_MAX = 64;
462
- /** ADR-046 §3.2: длина `description`. */
588
+ /** ADR-126 §13: длина `description`. */
463
589
  export const SKILL_DESCRIPTION_MIN = 1;
464
590
  export const SKILL_DESCRIPTION_MAX = 1024;
465
591
  export const skillNameSchema = z
@@ -487,29 +613,29 @@ export const skillFileWriteSchema = z.object({
487
613
  content: z.string(),
488
614
  });
489
615
  /**
490
- * ADR-046 §4.5: per-session enable/disable скиллов (по образцу MCP-скоупа).
616
+ * ADR-126 §11: per-session enable/disable скиллов (по образцу MCP-скоупа).
491
617
  * `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
492
618
  */
493
619
  export const skillSessionOverrideSchema = z.object({
494
620
  skills: z.array(z.string()).optional(),
495
621
  skillsDisabled: z.array(z.string()).optional(),
496
622
  });
497
- // --- Slash-команды и bundles (ADR-046 §7) ---
498
- /** ADR-046 §7.3: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
623
+ // --- Slash-команды и bundles (ADR-126 §1) ---
624
+ /** ADR-126 §14: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
499
625
  export const skillBundleSchema = z.object({
500
626
  name: skillNameSchema,
501
627
  description: z.string().min(SKILL_DESCRIPTION_MIN).max(SKILL_DESCRIPTION_MAX),
502
628
  skills: z.array(skillNameSchema).min(1),
503
629
  instruction: z.string().optional(),
504
630
  });
505
- /** ADR-046 §7.4: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
631
+ /** ADR-126 §15: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
506
632
  export const skillsDisabledSchema = z.object({
507
633
  categories: z.array(z.string()).default([]),
508
634
  groups: z.array(z.string()).default([]),
509
635
  skills: z.array(z.string()).default([]),
510
636
  });
511
637
  /**
512
- * ADR-046 §4.5: тело `PUT /api/v2/settings/skills` — системные настройки:
638
+ * ADR-126 §11: тело `PUT /api/v2/settings/skills` — системные настройки:
513
639
  * - `disabled` — hard-gate: скиллы, недоступные НИГДЕ;
514
640
  * - `disabledForNewProjects` — сид для НОВЫХ проектов (снимок при создании);
515
641
  * - `policy` — политика доступности (строкой, валидируется роутом).
@@ -520,7 +646,7 @@ export const skillsSystemSettingsSchema = z.object({
520
646
  policy: z.string().optional(),
521
647
  });
522
648
  /**
523
- * ADR-046 §4.5: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
649
+ * ADR-126 §11: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
524
650
  * (`{ name, enabled }`) или полная/частичная замена (`{ skills?, skillsDisabled? }`).
525
651
  */
526
652
  export const sessionSkillUpdateSchema = z
@@ -533,7 +659,7 @@ export const sessionSkillUpdateSchema = z
533
659
  .refine((v) => v.name !== undefined
534
660
  || v.skills !== undefined
535
661
  || v.skillsDisabled !== undefined, { message: 'Требуется name, skills или skillsDisabled' });
536
- /** ADR-046 §4.5: тело `PUT /api/v2/projects/:id/skills`. */
662
+ /** ADR-126 §11: тело `PUT /api/v2/projects/:id/skills`. */
537
663
  export const projectSkillUpdateSchema = z.object({
538
664
  enabled: z.array(z.string()).optional(),
539
665
  defaultOn: z.array(z.string()).optional(),
@@ -826,7 +952,9 @@ export const scheduleTargetSchema = z.discriminatedUnion('mode', [
826
952
  z.object({
827
953
  mode: z.literal('ephemeral'),
828
954
  agentTemplate: z.string().optional(),
829
- project: z.string().optional(),
955
+ // PROP-141: проект у ephemeral-цели обязателен — инстансных
956
+ // автоматизаций нет (каждая автоматизация принадлежит проекту).
957
+ project: z.string().min(1),
830
958
  ttl: z.string().optional(),
831
959
  }),
832
960
  z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
@@ -929,6 +1057,10 @@ export const scheduleInputSchema = z
929
1057
  .object({
930
1058
  name: z.string().min(1),
931
1059
  enabled: z.boolean().default(true),
1060
+ // PROP-141: проект расписания. В теле необязателен — сервер выводит его
1061
+ // из цели расписания (и сверяет с переданным); в самой записи
1062
+ // (`scheduleSchema`) поле обязательно.
1063
+ projectId: z.string().min(1).optional(),
932
1064
  cron: z.string().optional(),
933
1065
  every: z.string().optional(),
934
1066
  target: scheduleTargetSchema,
@@ -944,6 +1076,9 @@ export const scheduleSchema = z
944
1076
  id: z.string().min(1),
945
1077
  name: z.string().min(1),
946
1078
  enabled: z.boolean(),
1079
+ // PROP-141: проект расписания обязателен (пустая строка — «проект не
1080
+ // определён», легаси-запись без проекта: отключена, `project_required`).
1081
+ projectId: z.string(),
947
1082
  cron: z.string().optional(),
948
1083
  every: z.string().optional(),
949
1084
  target: scheduleTargetSchema,
@@ -1051,3 +1186,205 @@ export const mediaPartSchema = z.object({
1051
1186
  durationMs: z.number().int().min(0).optional(),
1052
1187
  transcript: z.string().optional(),
1053
1188
  });
1189
+ // --- PROP-054: план (ADR-039), ToDo (ADR-039), журнал и инварианты проекта ---
1190
+ //
1191
+ // Контракт «план/ToDo/журнал» (PROP-054, дополнение 2026-11-07): у сущностей
1192
+ // есть Zod-схемы (в shared), а тела мутаций — **strict** (лишнее поле — ошибка
1193
+ // валидации, а не молчаливое игнорирование). При **чтении** (импорт/перенос
1194
+ // между мирами) допустим `passthrough` — старые записи могли нести поля,
1195
+ // которых больше нет в модели.
1196
+ /** Приоритет пункта плана (ADR-039). */
1197
+ export const PLAN_PRIORITIES = ['high', 'medium', 'low'];
1198
+ /** Отношение зависимости пункта плана (ADR-039). */
1199
+ export const PLAN_DEPENDENCY_RELATIONS = ['blocked_by', 'blocks', 'relates_to'];
1200
+ /** Зависимость пункта плана (ADR-039): `projectId` пуст = тот же проект. */
1201
+ export const planDependencySchema = z
1202
+ .object({
1203
+ projectId: z.string().optional(),
1204
+ itemId: z.string().min(1),
1205
+ relation: z.enum(PLAN_DEPENDENCY_RELATIONS),
1206
+ })
1207
+ .passthrough();
1208
+ /** Колонка плана (ADR-039) — статус пункта. */
1209
+ export const planColumnSchema = z
1210
+ .object({
1211
+ id: z.string().min(1),
1212
+ name: z.string().min(1).max(100),
1213
+ order: z.number().int(),
1214
+ wipLimit: z.number().int().min(0).optional(),
1215
+ })
1216
+ .passthrough();
1217
+ /** Пункт плана (ADR-039). `description` — Markdown (лимит `MARKDOWN_LIMITS`). */
1218
+ export const planItemSchema = z
1219
+ .object({
1220
+ id: z.string().min(1),
1221
+ title: z.string().min(1).max(500),
1222
+ description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
1223
+ columnId: z.string().min(1),
1224
+ priority: z.enum(PLAN_PRIORITIES),
1225
+ order: z.number().int(),
1226
+ dependsOn: z.array(planDependencySchema).default([]),
1227
+ tags: z.array(z.string()).optional(),
1228
+ createdAt: z.string(),
1229
+ updatedAt: z.string(),
1230
+ })
1231
+ .passthrough();
1232
+ /** План проекта целиком (ADR-039). */
1233
+ export const projectPlanSchema = z
1234
+ .object({
1235
+ version: z.number().int(),
1236
+ updatedAt: z.string(),
1237
+ columns: z.array(planColumnSchema),
1238
+ items: z.array(planItemSchema),
1239
+ })
1240
+ .passthrough();
1241
+ /** Пункт ToDo сессии (ADR-039). `content` — Markdown (лимит `MARKDOWN_LIMITS`). */
1242
+ export const todoItemSchema = z
1243
+ .object({
1244
+ id: z.string().min(1),
1245
+ content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent),
1246
+ status: z.enum(TODO_STATUSES),
1247
+ priority: z.enum(TODO_PRIORITIES),
1248
+ planItemId: z.string().optional(),
1249
+ })
1250
+ .passthrough();
1251
+ /** Запись журнала проекта (PROP-054): `updatedAt`/`updatedBy` — аддитивные. */
1252
+ export const projectLogEntrySchema = z
1253
+ .object({
1254
+ id: z.string().min(1),
1255
+ text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
1256
+ createdAt: z.string(),
1257
+ sessionId: z.string().optional(),
1258
+ author: z.string().optional(),
1259
+ updatedAt: z.string().optional(),
1260
+ updatedBy: z.string().optional(),
1261
+ })
1262
+ .passthrough();
1263
+ // --- Тела HTTP-мутаций плана (PROP-054) — strict ---
1264
+ /** Создание пункта плана. */
1265
+ export const planItemCreateSchema = z
1266
+ .object({
1267
+ title: z.string().min(1).max(500),
1268
+ description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
1269
+ columnId: z.string().min(1).optional(),
1270
+ priority: z.enum(PLAN_PRIORITIES).optional(),
1271
+ dependsOn: z.array(planDependencySchema).optional(),
1272
+ tags: z.array(z.string()).optional(),
1273
+ })
1274
+ .strict();
1275
+ /** Точечная правка полей пункта плана (версия не требуется). */
1276
+ export const planItemUpdateSchema = z
1277
+ .object({
1278
+ title: z.string().min(1).max(500).optional(),
1279
+ description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
1280
+ priority: z.enum(PLAN_PRIORITIES).optional(),
1281
+ tags: z.array(z.string()).optional(),
1282
+ dependsOn: z.array(planDependencySchema).optional(),
1283
+ })
1284
+ .strict();
1285
+ /**
1286
+ * Перемещение пункта плана: `beforeItemId`/`afterItemId` — соседи-ориентиры
1287
+ * (упорядочивание без ручного `order`); `version` — оптимистичная блокировка.
1288
+ */
1289
+ export const planItemMoveSchema = z
1290
+ .object({
1291
+ columnId: z.string().min(1),
1292
+ beforeItemId: z.string().min(1).optional(),
1293
+ afterItemId: z.string().min(1).optional(),
1294
+ version: z.number().int().optional(),
1295
+ })
1296
+ .strict();
1297
+ /** Создание колонки плана. */
1298
+ export const planColumnCreateSchema = z
1299
+ .object({
1300
+ name: z.string().min(1).max(100),
1301
+ wipLimit: z.number().int().min(0).optional(),
1302
+ })
1303
+ .strict();
1304
+ /** Правка колонки плана (имя/WIP-лимит). */
1305
+ export const planColumnUpdateSchema = z
1306
+ .object({
1307
+ name: z.string().min(1).max(100).optional(),
1308
+ wipLimit: z.number().int().min(0).optional(),
1309
+ })
1310
+ .strict();
1311
+ /**
1312
+ * Удаление колонки: `moveItemsTo` — куда переносятся её пункты (`null` —
1313
+ * удалить вместе с колонкой); `version` — оптимистичная блокировка.
1314
+ */
1315
+ export const planColumnDeleteSchema = z
1316
+ .object({
1317
+ moveItemsTo: z.string().min(1).nullable(),
1318
+ version: z.number().int(),
1319
+ })
1320
+ .strict();
1321
+ /** Порядок колонок плана (полный список id) + версия. */
1322
+ export const planColumnsOrderSchema = z
1323
+ .object({
1324
+ order: z.array(z.string().min(1)),
1325
+ version: z.number().int(),
1326
+ })
1327
+ .strict();
1328
+ // --- Тела HTTP-мутаций ToDo (PROP-054) — strict ---
1329
+ /** Создание пункта ToDo. */
1330
+ export const todoCreateSchema = z
1331
+ .object({
1332
+ content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent),
1333
+ status: z.enum(TODO_STATUSES).optional(),
1334
+ priority: z.enum(TODO_PRIORITIES).optional(),
1335
+ planItemId: z.string().min(1).optional(),
1336
+ })
1337
+ .strict();
1338
+ /** Точечная правка пункта ToDo (`planItemId: null` — отвязать от пункта плана). */
1339
+ export const todoUpdateSchema = z
1340
+ .object({
1341
+ content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent).optional(),
1342
+ status: z.enum(TODO_STATUSES).optional(),
1343
+ priority: z.enum(TODO_PRIORITIES).optional(),
1344
+ planItemId: z.string().min(1).nullable().optional(),
1345
+ })
1346
+ .strict();
1347
+ /** Новый порядок пунктов ToDo (только существующие id; новые — в конец). */
1348
+ export const todoOrderSchema = z
1349
+ .object({
1350
+ ids: z.array(z.string().min(1)),
1351
+ })
1352
+ .strict();
1353
+ /** Очистка пунктов ToDo по статусам (по умолчанию — `completed` + `cancelled`). */
1354
+ export const todoClearSchema = z
1355
+ .object({
1356
+ statuses: z.array(z.enum(TODO_STATUSES)).optional(),
1357
+ })
1358
+ .strict();
1359
+ // --- Тело запуска скрипта проекта (ADR-126 §5) — strict ---
1360
+ /**
1361
+ * Тело `POST /sessions/:id/scripts/:name/run`: только аргументы скрипта.
1362
+ *
1363
+ * Аргументы приходят **строкой** — их разбирает лексер скриптов
1364
+ * (`engine/scripts/args.ts`), без shell. Строгая схема: неизвестные поля →
1365
+ * 400 `VALIDATION_ERROR`.
1366
+ */
1367
+ export const scriptRunRequestSchema = z
1368
+ .object({
1369
+ arguments: z.string().max(10_000).optional(),
1370
+ })
1371
+ .strict();
1372
+ // --- Тела HTTP-мутаций журнала и инвариантов (PROP-054) — strict ---
1373
+ /** Новая запись журнала проекта (Markdown, лимит `MARKDOWN_LIMITS.journalEntry`). */
1374
+ export const projectLogCreateSchema = z
1375
+ .object({
1376
+ text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
1377
+ })
1378
+ .strict();
1379
+ /** Правка текста записи журнала. */
1380
+ export const projectLogUpdateSchema = z
1381
+ .object({
1382
+ text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
1383
+ })
1384
+ .strict();
1385
+ /** Замена текста инвариантов проекта (Markdown, лимит `MARKDOWN_LIMITS.invariants`). */
1386
+ export const projectInvariantsUpdateSchema = z
1387
+ .object({
1388
+ invariants: z.string().max(MARKDOWN_LIMITS.invariants),
1389
+ })
1390
+ .strict();
@@ -1,6 +1,6 @@
1
1
  import { load as parseYaml, dump as dumpYaml } from 'js-yaml';
2
2
  /**
3
- * ADR-046 §3.1: толерантный парсер YAML-frontmatter `SKILL.md`.
3
+ * ADR-126 §3: толерантный парсер YAML-frontmatter `SKILL.md`.
4
4
  *
5
5
  * - Неизвестные ключи — не ошибка (совместимость Anthropic/opencode/Claude Code).
6
6
  * - Невалидный YAML — фиксируется issue, но не бросает исключение.
@@ -24,12 +24,40 @@ export interface AgentDefinition {
24
24
  effort?: EffortLevel;
25
25
  agentMode?: AgentMode | AgentMode[];
26
26
  maxSteps?: number;
27
+ /**
28
+ * PROP-135 Ф6a: профиль исполнения агента (`execution.remote.profiles`).
29
+ * Приоритет выбора профиля: сессия → агент → проект → `defaultProfile`.
30
+ * Не задан — профиль берётся у проекта/инстанса.
31
+ */
32
+ executorProfile?: string;
33
+ /**
34
+ * PROP-135 Ф6a: **потолок** профилей исполнения агента: если массив задан,
35
+ * агент не может исполняться на профиле вне списка (нарушение — fail-closed:
36
+ * запрещённый профиль не выбирается, инстанс-дефолт — **не исключение**,
37
+ * вне списка профилей нет вовсе). Пустой массив — «профилей нет»; массив не
38
+ * задан (`undefined`) — потолок области не задан (ограничения нет).
39
+ */
40
+ allowedProfiles?: string[];
41
+ /**
42
+ * PROP-135 (браузерный контур): профиль браузерного пула агента
43
+ * (`execution.remote.browserProfiles`). Приоритет выбора: сессия → агент →
44
+ * проект → инстанс-дефолт (`execution.remote.browserProfile`). Не задан —
45
+ * наследуется. Отдельный контур: имя проверяется по браузерному каталогу, а
46
+ * не по exec-каталогу (`allowedProfiles`).
47
+ */
48
+ browserProfile?: string;
49
+ /**
50
+ * PROP-135 (браузерный контур): **потолок** браузерных профилей агента.
51
+ * Заданный список — профиль обязан в него входить (пустой — «профилей
52
+ * нет»); не задан — потолок не задан.
53
+ */
54
+ allowedBrowserProfiles?: string[];
27
55
  isOverridden: boolean;
28
56
  icon?: string;
29
57
  color?: string;
30
58
  description?: string;
31
59
  /**
32
- * ADR-046 §6.2: группы агентов для привязки скиллов
60
+ * ADR-126 §9: группы агентов для привязки скиллов
33
61
  * (`metadata.synth.groups`). Пусто/не задано — скилл с непустым `groups`
34
62
  * не привязан к агенту.
35
63
  */
@@ -114,6 +114,13 @@ export type AuthorityGrantConstraints = z.infer<typeof authorityGrantConstraints
114
114
  * Принципал — тот, от чьего имени исполняется ход (ADR-106 §«Модель»).
115
115
  * `roles[]` — роли, которые носитель принципала предъявляет (содержательные
116
116
  * роли приезжают контентом; глобальные роли инстанса — отдельная ось).
117
+ *
118
+ * ADR-140 Ф2: `groups[]` — группы пользователя (снимок claim'а IdP на момент
119
+ * приёма ввода, ADR-106 Ф4). Поле **аддитивное и необязательное**: старое
120
+ * сохранённое сообщение без него парсится (`undefined`), отсутствие поля =
121
+ * «групп нет» (fail-closed); потребители нормализуют `?? []`. На права влияет
122
+ * только через единый резолвер доступа (`resolveProjectAccess`,
123
+ * ADR-140/PROP-133).
117
124
  */
118
125
  export declare const authorityPrincipalSchema: z.ZodObject<{
119
126
  kind: z.ZodEnum<{
@@ -125,6 +132,7 @@ export declare const authorityPrincipalSchema: z.ZodObject<{
125
132
  }>;
126
133
  id: z.ZodString;
127
134
  roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
135
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
128
136
  }, z.core.$strict>;
129
137
  export type AuthorityPrincipal = z.infer<typeof authorityPrincipalSchema>;
130
138
  /**
@@ -243,6 +251,7 @@ export declare const authorityTurnSchema: z.ZodObject<{
243
251
  }>;
244
252
  id: z.ZodString;
245
253
  roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
254
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
246
255
  }, z.core.$strict>;
247
256
  agentId: z.ZodOptional<z.ZodString>;
248
257
  ceiling: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -288,6 +297,7 @@ export declare const authorityApprovalSchema: z.ZodObject<{
288
297
  }>;
289
298
  id: z.ZodString;
290
299
  roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
300
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
291
301
  }, z.core.$strict>;
292
302
  action: z.ZodString;
293
303
  target: z.ZodObject<{
@@ -155,12 +155,20 @@ export const authorityGrantConstraintsSchema = z
155
155
  * Принципал — тот, от чьего имени исполняется ход (ADR-106 §«Модель»).
156
156
  * `roles[]` — роли, которые носитель принципала предъявляет (содержательные
157
157
  * роли приезжают контентом; глобальные роли инстанса — отдельная ось).
158
+ *
159
+ * ADR-140 Ф2: `groups[]` — группы пользователя (снимок claim'а IdP на момент
160
+ * приёма ввода, ADR-106 Ф4). Поле **аддитивное и необязательное**: старое
161
+ * сохранённое сообщение без него парсится (`undefined`), отсутствие поля =
162
+ * «групп нет» (fail-closed); потребители нормализуют `?? []`. На права влияет
163
+ * только через единый резолвер доступа (`resolveProjectAccess`,
164
+ * ADR-140/PROP-133).
158
165
  */
159
166
  export const authorityPrincipalSchema = z
160
167
  .object({
161
168
  kind: authorityPrincipalKindSchema,
162
169
  id: z.string().min(1).max(256),
163
170
  roles: z.array(z.string().min(1).max(128)).default([]),
171
+ groups: z.array(z.string().min(1).max(128)).optional(),
164
172
  })
165
173
  .strict();
166
174
  /**