@itphx/synth-shared 0.13.8 → 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 (71) hide show
  1. package/dist/config/defaults.js +74 -2
  2. package/dist/config/env-overrides.d.ts +16 -0
  3. package/dist/config/env-overrides.js +103 -3
  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 +2 -0
  9. package/dist/config/index.js +2 -0
  10. package/dist/config/security.d.ts +77 -0
  11. package/dist/config/security.js +116 -0
  12. package/dist/config/types.d.ts +466 -34
  13. package/dist/config/types.js +317 -33
  14. package/dist/i18n/index.d.ts +1 -1
  15. package/dist/i18n/index.js +196 -13
  16. package/dist/index.d.ts +5 -4
  17. package/dist/index.js +15 -2
  18. package/dist/schemas/index.d.ts +156 -19
  19. package/dist/schemas/index.js +126 -15
  20. package/dist/skills/frontmatter.js +1 -1
  21. package/dist/types/agent.d.ts +29 -1
  22. package/dist/types/authority.d.ts +10 -0
  23. package/dist/types/authority.js +8 -0
  24. package/dist/types/bus-events.d.ts +87 -1
  25. package/dist/types/catalog.d.ts +1 -1
  26. package/dist/types/catalog.js +1 -1
  27. package/dist/types/command-audit.d.ts +91 -0
  28. package/dist/types/command-audit.js +44 -0
  29. package/dist/types/commands.d.ts +29 -11
  30. package/dist/types/commands.js +2 -2
  31. package/dist/types/egress.d.ts +18 -3
  32. package/dist/types/egress.js +18 -3
  33. package/dist/types/events.d.ts +23 -2
  34. package/dist/types/execution.d.ts +424 -0
  35. package/dist/types/execution.js +355 -0
  36. package/dist/types/file-kind.d.ts +3 -2
  37. package/dist/types/file-kind.js +11 -2
  38. package/dist/types/git.d.ts +48 -0
  39. package/dist/types/index.d.ts +6 -0
  40. package/dist/types/index.js +18 -2
  41. package/dist/types/mentions.d.ts +96 -0
  42. package/dist/types/mentions.js +9 -0
  43. package/dist/types/message.d.ts +24 -1
  44. package/dist/types/message.js +13 -0
  45. package/dist/types/pack.d.ts +21 -21
  46. package/dist/types/pack.js +4 -4
  47. package/dist/types/permission.d.ts +8 -1
  48. package/dist/types/pipeline.d.ts +2 -2
  49. package/dist/types/plugin-protocol.d.ts +203 -4
  50. package/dist/types/plugin-protocol.js +77 -4
  51. package/dist/types/project-access.d.ts +94 -0
  52. package/dist/types/project-access.js +140 -0
  53. package/dist/types/project.d.ts +59 -2
  54. package/dist/types/project.js +20 -0
  55. package/dist/types/schedules.d.ts +49 -3
  56. package/dist/types/schedules.js +50 -1
  57. package/dist/types/scripts.d.ts +98 -0
  58. package/dist/types/scripts.js +14 -0
  59. package/dist/types/service-keys.d.ts +12 -2
  60. package/dist/types/service-keys.js +13 -0
  61. package/dist/types/session.d.ts +60 -3
  62. package/dist/types/skills.d.ts +15 -11
  63. package/dist/types/skills.js +6 -6
  64. package/dist/types/timers.d.ts +402 -0
  65. package/dist/types/timers.js +166 -0
  66. package/dist/types/tools.d.ts +124 -1
  67. package/dist/types/tools.js +22 -0
  68. package/dist/types/user.d.ts +17 -0
  69. package/dist/version.d.ts +1 -1
  70. package/dist/version.js +1 -1
  71. package/package.json +2 -2
@@ -33,8 +33,39 @@
33
33
  */
34
34
  import { isLlmFilterFailMode, isLlmFilterPhase } from './llm-filters.js';
35
35
  import { ToolCapability } from './tools.js';
36
- /** Версия wire-протокола плагина (аналог `EXECUTOR_PROTOCOL_VERSION`). */
37
- export const PLUGIN_PROTOCOL_VERSION = 1;
36
+ /**
37
+ * Версия wire-протокола плагина (аналог `EXECUTOR_PROTOCOL_VERSION`).
38
+ *
39
+ * **v2** (PROP-138, Ф2) — добавлен runtime-контур: плагин, объявивший
40
+ * `protocol: 2` в `/capabilities`, умеет работать с `ctx.runtime` по проводу
41
+ * (`POST /runtime/*` через хост). Плагин v1 (runtime по проводу нет)
42
+ * принимается хостом как раньше — см. {@link PLUGIN_PROTOCOL_SUPPORTED_VERSIONS}.
43
+ */
44
+ export const PLUGIN_PROTOCOL_VERSION = 2;
45
+ /**
46
+ * Старшая версия протокола, которую хост принимает (v1 — без runtime).
47
+ *
48
+ * Совместимость: хост говорит и с плагином v1 (поведение прежнее), и с
49
+ * плагином v2 (runtime по проводу). Вне перечня — отказ
50
+ * `protocol_mismatch` (fail-closed).
51
+ */
52
+ export const PLUGIN_PROTOCOL_MIN_VERSION = 1;
53
+ /**
54
+ * Версии wire-протокола, которые принимает хост.
55
+ *
56
+ * Единственный источник истины для проверки ответа `/capabilities`
57
+ * ({@link checkPluginCapabilities}) — и для выбора поведения: плагин v2
58
+ * получает runtime-контур, плагин v1 — нет.
59
+ */
60
+ export const PLUGIN_PROTOCOL_SUPPORTED_VERSIONS = [
61
+ PLUGIN_PROTOCOL_MIN_VERSION,
62
+ PLUGIN_PROTOCOL_VERSION,
63
+ ];
64
+ /**
65
+ * Минимальная версия протокола, в которой есть runtime-контур
66
+ * (`ctx.runtime` по проводу, PROP-138 Ф2).
67
+ */
68
+ export const PLUGIN_PROTOCOL_RUNTIME_MIN_VERSION = 2;
38
69
  /** Пути эндпоинтов протокола (относительно базового адреса процесса). */
39
70
  export const PLUGIN_PROTOCOL_PATHS = {
40
71
  /** `POST` — вызов точки расширения. */
@@ -44,6 +75,27 @@ export const PLUGIN_PROTOCOL_PATHS = {
44
75
  /** `GET` — процесс жив (без токена). */
45
76
  health: '/health',
46
77
  };
78
+ /**
79
+ * Пути runtime-контура (PROP-138, Ф2).
80
+ *
81
+ * Адреса **не** на базовом адресе процесса плагина, а на адресе
82
+ * host-side прокси (`SYNTH_RUNTIME_URL` в окружении процесса): плагин
83
+ * **не ходит** к исполнителю напрямую — единственная точка — хост.
84
+ */
85
+ export const PLUGIN_RUNTIME_PATHS = {
86
+ /** `POST` — команда (argv без shell) в контуре исполнителя сессии. */
87
+ exec: '/runtime/exec',
88
+ /** `POST` — прочитать файл (base64). */
89
+ fsRead: '/runtime/fs/read',
90
+ /** `POST` — записать файл (base64). */
91
+ fsWrite: '/runtime/fs/write',
92
+ /** `POST` — сведения о файле/каталоге. */
93
+ fsStat: '/runtime/fs/stat',
94
+ /** `POST` — записи каталога. */
95
+ fsReaddir: '/runtime/fs/readdir',
96
+ /** `POST` — канонический путь. */
97
+ fsRealpath: '/runtime/fs/realpath',
98
+ };
47
99
  /**
48
100
  * Строка готовности, которую сервер плагина печатает в **stdout** при старте
49
101
  * (Ф4б-2). Хост читает stdout процесса до этой строки и берёт из неё порт.
@@ -123,6 +175,26 @@ export const PLUGIN_PROTOCOL_ERROR_STATUS = {
123
175
  export function isPluginProtocolErrorReason(value) {
124
176
  return PLUGIN_PROTOCOL_ERROR_REASONS.includes(value);
125
177
  }
178
+ /**
179
+ * Версия протокола, которую принимает хост (fail-closed вне перечня).
180
+ *
181
+ * Единственная точка проверки: и `checkPluginCapabilities`, и выбор
182
+ * runtime-контура (плагин v2) опираются на неё.
183
+ */
184
+ export function isSupportedPluginProtocolVersion(value) {
185
+ return (typeof value === 'number' &&
186
+ PLUGIN_PROTOCOL_SUPPORTED_VERSIONS.includes(value));
187
+ }
188
+ /**
189
+ * Понимает ли плагин runtime-контур (PROP-138, Ф2).
190
+ *
191
+ * `true` — плагин объявил версию протокола с runtime-контуром: хот может
192
+ * отдавать `ctx.runtime` по проводу. `false` — плагин v1: поведение прежнее
193
+ * (runtime по проводу нет).
194
+ */
195
+ export function pluginProtocolSupportsRuntime(protocol) {
196
+ return protocol >= PLUGIN_PROTOCOL_RUNTIME_MIN_VERSION;
197
+ }
126
198
  /** Значение — известная точка протокола. */
127
199
  export function isPluginProtocolPoint(value) {
128
200
  return PLUGIN_PROTOCOL_POINTS.includes(value);
@@ -162,8 +234,9 @@ export function checkPluginCapabilities(payload, expected) {
162
234
  if (typeof protocol !== 'number' || !Number.isFinite(protocol)) {
163
235
  return fail('invalid_request', 'в ответе /capabilities нет числового поля protocol');
164
236
  }
165
- if (protocol !== PLUGIN_PROTOCOL_VERSION) {
166
- return fail('protocol_mismatch', `плагин говорит по протоколу ${protocol}, а Synth — по протоколу ${PLUGIN_PROTOCOL_VERSION}`);
237
+ if (!isSupportedPluginProtocolVersion(protocol)) {
238
+ return fail('protocol_mismatch', `плагин говорит по протоколу ${protocol}, а Synth принимает ` +
239
+ `${PLUGIN_PROTOCOL_SUPPORTED_VERSIONS.join('/')}`);
167
240
  }
168
241
  const name = payload.name;
169
242
  const version = payload.version;
@@ -0,0 +1,94 @@
1
+ /**
2
+ * PROP-133 §1: единая точка истины по доступу к проекту.
3
+ *
4
+ * Модуль **browser-safe**: только типы и чистые функции, без `node:*` и без
5
+ * `zod` (читают и ядро, и UI, и драйвер PostgreSQL).
6
+ *
7
+ * Порядок резолва (первое совпадение выигрывает, дальше не идём) — PROP-133 §1:
8
+ *
9
+ * 1. владелец проекта (`ownerId === userId`) → `owner`;
10
+ * 2. глобальная роль инстанса `ADMIN`/`LEAD` → `owner` (сквозной обзор);
11
+ * 3. пользовательский грант (`members[userId]`) → эта роль;
12
+ * 4. максимальная роль по группам (`groupMembers` среди `groups`) — `owner` >
13
+ * `editor` > `viewer`;
14
+ * 5. `everyoneRole` (если задан) → эта роль;
15
+ * 6. иначе — доступа нет (`read: false`, `role: null`).
16
+ *
17
+ * `read` = `role !== null`. Неизвестное значение роли в данных (битая запись,
18
+ * легаси) — **fail-closed** в `viewer` (как `normalizeParticipantRole`,
19
+ * ADR-106 Ф4).
20
+ */
21
+ import { ProjectRole, type Project } from './project.js';
22
+ /** Каноническая роль доступа к проекту (строковое значение). */
23
+ export type ProjectAccessRoleValue = 'owner' | 'editor' | 'viewer';
24
+ /**
25
+ * PROP-133: роль доступа к проекту; `null` — доступа нет.
26
+ */
27
+ export type ProjectAccessRole = ProjectAccessRoleValue | null;
28
+ /**
29
+ * PROP-133: кто запрашивает доступ (роль инстанса + группы пользователя).
30
+ */
31
+ export interface ProjectPrincipal {
32
+ /** Идентификатор пользователя (владелец сессии/проекта). */
33
+ userId: string;
34
+ /** Глобальные роли инстанса (`ADMIN`/`LEAD` — сквозной обзор). */
35
+ roles?: readonly string[];
36
+ /** Группы пользователя (субъект грантов по группам). */
37
+ groups?: readonly string[];
38
+ }
39
+ /**
40
+ * PROP-133: читатель списка проектов — пользователь и его группы.
41
+ *
42
+ * Отдельный тип от `ProjectPrincipal`: у «просто читателя списка» нет ролей
43
+ * инстанса (`ADMIN`/`LEAD` получают весь список без аргумента — см. порт
44
+ * `ProjectRepository.list`).
45
+ */
46
+ export interface ProjectViewer {
47
+ userId: string;
48
+ groups?: readonly string[];
49
+ }
50
+ /** PROP-133: решение по доступу к проекту. */
51
+ export interface ProjectAccess {
52
+ /** Есть ли право чтения (`role !== null`). */
53
+ read: boolean;
54
+ /** Роль доступа (`null` — доступа нет). */
55
+ role: ProjectAccessRole;
56
+ }
57
+ /**
58
+ * PROP-133: нормализация роли доступа — неизвестное значение **fail-closed**
59
+ * (`viewer`, только чтение).
60
+ */
61
+ export declare function normalizeProjectAccessRole(value: unknown): ProjectAccessRoleValue;
62
+ /**
63
+ * PROP-133: нормализация карты грантов (пользователь → роль) при чтении.
64
+ *
65
+ * Не-объект → пустая карта; неизвестная роль → `viewer`; пустой ключ
66
+ * отбрасывается.
67
+ */
68
+ export declare function normalizeProjectMemberRoles(value: unknown): Record<string, ProjectRole>;
69
+ /**
70
+ * PROP-133: нормализация роли «всем пользователям» при чтении.
71
+ *
72
+ * - `undefined` — поле отсутствует (проект не опубликован);
73
+ * - `null` — явное «не опубликован»;
74
+ * - `owner`/`editor`/`viewer` — как есть;
75
+ * - нечто иное (битая запись) — `undefined` (fail-closed: проект **не**
76
+ * опубликован, доступ для всех не выдаётся).
77
+ */
78
+ export declare function normalizeProjectEveryoneRole(value: unknown): ProjectRole | null | undefined;
79
+ /**
80
+ * PROP-133 §1: единый резолвер доступа к проекту.
81
+ *
82
+ * Первое совпадение выигрывает (дальше не идём) — порядок см. в шапке модуля.
83
+ */
84
+ export declare function resolveProjectAccess(project: Pick<Project, 'ownerId' | 'members' | 'groupMembers' | 'everyoneRole'>, principal: ProjectPrincipal): ProjectAccess;
85
+ /**
86
+ * PROP-133: право изменения содержимого проекта — `owner`/`editor`.
87
+ * Грант `viewer` записи не даёт (инвариант 21).
88
+ */
89
+ export declare function canWriteWithProjectRole(role: ProjectAccessRole): boolean;
90
+ /**
91
+ * PROP-133: право управления доступом к проекту — только `owner`
92
+ * (гранты `viewer`/`editor` записи не дают).
93
+ */
94
+ export declare function canManageWithProjectRole(role: ProjectAccessRole): boolean;
@@ -0,0 +1,140 @@
1
+ /**
2
+ * PROP-133 §1: единая точка истины по доступу к проекту.
3
+ *
4
+ * Модуль **browser-safe**: только типы и чистые функции, без `node:*` и без
5
+ * `zod` (читают и ядро, и UI, и драйвер PostgreSQL).
6
+ *
7
+ * Порядок резолва (первое совпадение выигрывает, дальше не идём) — PROP-133 §1:
8
+ *
9
+ * 1. владелец проекта (`ownerId === userId`) → `owner`;
10
+ * 2. глобальная роль инстанса `ADMIN`/`LEAD` → `owner` (сквозной обзор);
11
+ * 3. пользовательский грант (`members[userId]`) → эта роль;
12
+ * 4. максимальная роль по группам (`groupMembers` среди `groups`) — `owner` >
13
+ * `editor` > `viewer`;
14
+ * 5. `everyoneRole` (если задан) → эта роль;
15
+ * 6. иначе — доступа нет (`read: false`, `role: null`).
16
+ *
17
+ * `read` = `role !== null`. Неизвестное значение роли в данных (битая запись,
18
+ * легаси) — **fail-closed** в `viewer` (как `normalizeParticipantRole`,
19
+ * ADR-106 Ф4).
20
+ */
21
+ import { ProjectRole } from './project.js';
22
+ /** Глобальные роли инстанса со сквозным обзором (PROP-133 §1, п. 2). */
23
+ const ELEVATED_INSTANCE_ROLES = ['ADMIN', 'LEAD'];
24
+ /** Вес роли для выбора максимума по группам (`owner` > `editor` > `viewer`). */
25
+ const ROLE_RANK = {
26
+ owner: 3,
27
+ editor: 2,
28
+ viewer: 1,
29
+ };
30
+ /** Канонические значения ролей → enum `ProjectRole` (для полей `Project`). */
31
+ const ROLE_BY_VALUE = {
32
+ owner: ProjectRole.OWNER,
33
+ editor: ProjectRole.EDITOR,
34
+ viewer: ProjectRole.VIEWER,
35
+ };
36
+ /**
37
+ * PROP-133: нормализация роли доступа — неизвестное значение **fail-closed**
38
+ * (`viewer`, только чтение).
39
+ */
40
+ export function normalizeProjectAccessRole(value) {
41
+ if (value === 'owner' || value === 'editor' || value === 'viewer')
42
+ return value;
43
+ return 'viewer';
44
+ }
45
+ /**
46
+ * PROP-133: нормализация карты грантов (пользователь → роль) при чтении.
47
+ *
48
+ * Не-объект → пустая карта; неизвестная роль → `viewer`; пустой ключ
49
+ * отбрасывается.
50
+ */
51
+ export function normalizeProjectMemberRoles(value) {
52
+ const out = {};
53
+ if (!value || typeof value !== 'object' || Array.isArray(value))
54
+ return out;
55
+ for (const [key, role] of Object.entries(value)) {
56
+ if (!key)
57
+ continue;
58
+ out[key] = ROLE_BY_VALUE[normalizeProjectAccessRole(role)];
59
+ }
60
+ return out;
61
+ }
62
+ /**
63
+ * PROP-133: нормализация роли «всем пользователям» при чтении.
64
+ *
65
+ * - `undefined` — поле отсутствует (проект не опубликован);
66
+ * - `null` — явное «не опубликован»;
67
+ * - `owner`/`editor`/`viewer` — как есть;
68
+ * - нечто иное (битая запись) — `undefined` (fail-closed: проект **не**
69
+ * опубликован, доступ для всех не выдаётся).
70
+ */
71
+ export function normalizeProjectEveryoneRole(value) {
72
+ if (value === undefined)
73
+ return undefined;
74
+ if (value === null)
75
+ return null;
76
+ if (value === 'owner' || value === 'editor' || value === 'viewer') {
77
+ return ROLE_BY_VALUE[value];
78
+ }
79
+ return undefined;
80
+ }
81
+ /**
82
+ * PROP-133 §1: единый резолвер доступа к проекту.
83
+ *
84
+ * Первое совпадение выигрывает (дальше не идём) — порядок см. в шапке модуля.
85
+ */
86
+ export function resolveProjectAccess(project, principal) {
87
+ // 1. Владелец проекта.
88
+ if (project.ownerId && project.ownerId === principal.userId) {
89
+ return { read: true, role: 'owner' };
90
+ }
91
+ // 2. Сквозной обзор (`ADMIN`/`LEAD`) — сравнение без учёта регистра.
92
+ const roles = principal.roles ?? [];
93
+ for (const role of roles) {
94
+ if (typeof role !== 'string')
95
+ continue;
96
+ const upper = role.trim().toUpperCase();
97
+ if (ELEVATED_INSTANCE_ROLES.includes(upper)) {
98
+ return { read: true, role: 'owner' };
99
+ }
100
+ }
101
+ // 3. Пользовательский грант.
102
+ const memberRole = project.members?.[principal.userId];
103
+ if (memberRole !== undefined) {
104
+ return { read: true, role: normalizeProjectAccessRole(memberRole) };
105
+ }
106
+ // 4. Гранты по группам — максимальная роль среди групп пользователя.
107
+ const groups = principal.groups ?? [];
108
+ let groupRole = null;
109
+ for (const group of groups) {
110
+ const granted = project.groupMembers?.[group];
111
+ if (granted === undefined)
112
+ continue;
113
+ const role = normalizeProjectAccessRole(granted);
114
+ if (groupRole === null || ROLE_RANK[role] > ROLE_RANK[groupRole])
115
+ groupRole = role;
116
+ }
117
+ if (groupRole !== null)
118
+ return { read: true, role: groupRole };
119
+ // 5. Режим «всем пользователям».
120
+ const everyone = project.everyoneRole;
121
+ if (everyone !== undefined && everyone !== null) {
122
+ return { read: true, role: normalizeProjectAccessRole(everyone) };
123
+ }
124
+ // 6. Доступа нет.
125
+ return { read: false, role: null };
126
+ }
127
+ /**
128
+ * PROP-133: право изменения содержимого проекта — `owner`/`editor`.
129
+ * Грант `viewer` записи не даёт (инвариант 21).
130
+ */
131
+ export function canWriteWithProjectRole(role) {
132
+ return role === 'owner' || role === 'editor';
133
+ }
134
+ /**
135
+ * PROP-133: право управления доступом к проекту — только `owner`
136
+ * (гранты `viewer`/`editor` записи не дают).
137
+ */
138
+ export function canManageWithProjectRole(role) {
139
+ return role === 'owner';
140
+ }
@@ -67,7 +67,7 @@ export interface ProjectMcpSettings {
67
67
  remoteSeeded?: string[];
68
68
  }
69
69
  /**
70
- * ADR-046 §4.5: проектный скоуп скиллов (owner/lead) — аналог `ProjectMcpSettings`.
70
+ * ADR-126 §11: проектный скоуп скиллов (owner/lead) — аналог `ProjectMcpSettings`.
71
71
  * - `enabled` — hard-gate: доступные проекту скиллы. Пустой массив — «всё
72
72
  * выключено» (opt-in); отсутствие `project.skills` — гейт не задан (legacy).
73
73
  * - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот
@@ -77,6 +77,35 @@ export interface ProjectSkillSettings {
77
77
  enabled: string[];
78
78
  defaultOn: string[];
79
79
  }
80
+ /**
81
+ * PROP-135 Ф6a: профиль исполнения проекта.
82
+ *
83
+ * - `profile` — имя профиля из `execution.remote.profiles` для сессий проекта
84
+ * (если сессия и агент свой профиль не задали). Не задан — наследуется
85
+ * `execution.remote.defaultProfile`;
86
+ * - `allowedProfiles` — **потолок**: если массив задан, сессия проекта не может
87
+ * исполняться на профиле вне списка (выбор сессии/агента/проекта проверяется
88
+ * при каждом ходе; нарушение — fail-closed: запрещённый профиль не
89
+ * выбирается, инстанс-дефолт — **не исключение**). Пустой массив — «профилей
90
+ * нет»; массив не задан (`undefined`) — потолок не задан (обратная
91
+ * совместимость: старые проекты не имеют поля).
92
+ */
93
+ export interface ProjectExecutorSettings {
94
+ profile?: string;
95
+ allowedProfiles?: string[];
96
+ /**
97
+ * PROP-135 (браузерный контур): профиль браузерного пула для сессий проекта
98
+ * (если сессия и агент свой профиль не задали). Отдельный каталог:
99
+ * проверяется по `execution.remote.browserProfiles`, а не по exec-профилям.
100
+ */
101
+ browserProfile?: string;
102
+ /**
103
+ * PROP-135 (браузерный контур): **потолок** браузерных профилей проекта.
104
+ * Заданный список — профиль обязан в него входить (пустой — «профилей
105
+ * нет»); не задан — потолок не задан.
106
+ */
107
+ allowedBrowserProfiles?: string[];
108
+ }
80
109
  /**
81
110
  * ADR-107: память проекта (undefined — наследует политику инстанса/включена).
82
111
  */
@@ -109,6 +138,15 @@ export interface Project {
109
138
  name: string;
110
139
  ownerId: string;
111
140
  members: Record<string, ProjectRole>;
141
+ /**
142
+ * PROP-133: гранты группам (имя группы → роль). Отсутствует — групп нет.
143
+ */
144
+ groupMembers?: Record<string, ProjectRole>;
145
+ /**
146
+ * PROP-133: роль для всех пользователей инстанса; null/undefined — проект
147
+ * не опубликован.
148
+ */
149
+ everyoneRole?: ProjectRole | null;
112
150
  description: string;
113
151
  currentTask: string;
114
152
  invariants: string;
@@ -123,10 +161,12 @@ export interface Project {
123
161
  worktreeSetupScript?: string;
124
162
  /** ADR-071 §2.4: проектный скоуп MCP (owner/lead). */
125
163
  mcp?: ProjectMcpSettings;
126
- /** ADR-046 §4.5: проектный скоуп скиллов (owner/lead). */
164
+ /** ADR-126 §11: проектный скоуп скиллов (owner/lead). */
127
165
  skills?: ProjectSkillSettings;
128
166
  /** ADR-107: память проекта (undefined — наследует политику инстанса/включена). */
129
167
  memory?: ProjectMemorySettings;
168
+ /** PROP-135 Ф6a: профиль исполнения проекта и потолок разрешённых профилей. */
169
+ executor?: ProjectExecutorSettings;
130
170
  statusMessages: StatusMessage[];
131
171
  /** Kanban-план проекта (ADR-039). Владеет проектом, а не сессией. */
132
172
  plan?: ProjectPlan;
@@ -135,6 +175,23 @@ export interface Project {
135
175
  createdAt: string;
136
176
  updatedAt: string;
137
177
  }
178
+ /**
179
+ * PROP-133: производное состояние доступа (не хранится в проекте).
180
+ *
181
+ * - `author` — проект видит только автор (плюс `ADMIN`/`LEAD` — сквозной обзор);
182
+ * - `selected` — есть пользовательский и/или групповой грант;
183
+ * - `all` — проект опубликован для всех (`everyoneRole` задан).
184
+ */
185
+ export type ProjectVisibility = 'author' | 'selected' | 'all';
186
+ /**
187
+ * PROP-133: состояние доступа по состоянию списка доступа.
188
+ *
189
+ * Порядок: `everyoneRole` задан → `all`; иначе есть грант пользователю (кроме
190
+ * владельца) или группе → `selected`; иначе → `author`. Значения ролей не
191
+ * проверяются: битая роль не должна ронять вывод (fail-closed — на резолвере
192
+ * доступа, `resolveProjectAccess`).
193
+ */
194
+ export declare function deriveProjectVisibility(project: Pick<Project, 'ownerId' | 'members' | 'groupMembers' | 'everyoneRole'>): ProjectVisibility;
138
195
  /**
139
196
  * Канонические ключи иконок проектов и сессий (единый список для server и UI).
140
197
  * Значения — только ключи реестра (загружаемые картинки не поддерживаются).
@@ -28,6 +28,26 @@ export const MARKDOWN_LIMITS = {
28
28
  planDescription: 16 * 1024,
29
29
  todoContent: 4 * 1024,
30
30
  };
31
+ /**
32
+ * PROP-133: состояние доступа по состоянию списка доступа.
33
+ *
34
+ * Порядок: `everyoneRole` задан → `all`; иначе есть грант пользователю (кроме
35
+ * владельца) или группе → `selected`; иначе → `author`. Значения ролей не
36
+ * проверяются: битая роль не должна ронять вывод (fail-closed — на резолвере
37
+ * доступа, `resolveProjectAccess`).
38
+ */
39
+ export function deriveProjectVisibility(project) {
40
+ if (project.everyoneRole !== undefined && project.everyoneRole !== null)
41
+ return 'all';
42
+ const members = project.members ?? {};
43
+ const hasUserGrant = Object.keys(members).some((userId) => userId !== project.ownerId);
44
+ if (hasUserGrant)
45
+ return 'selected';
46
+ const groupMembers = project.groupMembers ?? {};
47
+ if (Object.keys(groupMembers).length > 0)
48
+ return 'selected';
49
+ return 'author';
50
+ }
31
51
  /**
32
52
  * Канонические ключи иконок проектов и сессий (единый список для server и UI).
33
53
  * Значения — только ключи реестра (загружаемые картинки не поддерживаются).
@@ -6,10 +6,18 @@
6
6
  * маршрутизацию в сессию выполняет `EventRouter` (seam — `RouteRuleProvider`).
7
7
  * Здесь только типы без бизнес-логики; cron/interval-парсеры живут в core.
8
8
  */
9
+ /**
10
+ * PROP-141: код «проект расписания не определён».
11
+ *
12
+ * Запись без проекта **не теряется** — она остаётся в реестре, но
13
+ * отключается и помечается этой строкой в `lastError` (не срабатывает).
14
+ */
15
+ export declare const SCHEDULE_PROJECT_REQUIRED_ERROR = "project_required";
9
16
  /**
10
17
  * ADR-051/ADR-089: цель срабатывания расписания.
11
18
  * - `bound` — постоянная сессия (событие уходит в неё);
12
- * - `ephemeral` — разовая сессия с TTL и авто-архивом;
19
+ * - `ephemeral` — разовая сессия с TTL и авто-архивом; проект обязателен
20
+ * (PROP-141: инстансных автоматизаций нет);
13
21
  * - `queue` — не запускать сразу, отложить владельцу;
14
22
  * - `pipeline` — прямой запуск прогона пайплайна (ADR-101): событие в Router
15
23
  * **не** публикуется, шедулер запускает прогон сам.
@@ -20,7 +28,7 @@ export type ScheduleTarget = {
20
28
  } | {
21
29
  mode: 'ephemeral';
22
30
  agentTemplate?: string;
23
- project?: string;
31
+ project: string;
24
32
  ttl?: string;
25
33
  } | {
26
34
  mode: 'queue';
@@ -36,6 +44,16 @@ export type ScheduleTarget = {
36
44
  /** Данные входа прогона → trigger.payload.* (напр. {sessionId}). */
37
45
  payload?: Record<string, unknown>;
38
46
  };
47
+ /**
48
+ * PROP-141: проект расписания, выводимый **из цели** (без обращения к
49
+ * хранилищу).
50
+ *
51
+ * - `pipeline` → `target.projectId` (проект-владелец пайплайна);
52
+ * - `ephemeral` → `target.project`;
53
+ * - `bound`/`queue` → `undefined`: проект берётся у сессии-цели, а её
54
+ * разрешает резолвер «сессия → проект» (задаёт composition root).
55
+ */
56
+ export declare function deriveScheduleProjectId(target: ScheduleTarget): string | undefined;
39
57
  /** ADR-051/ADR-089: статус последнего запуска расписания. */
40
58
  export type ScheduleRunStatus = 'ok' | 'error' | 'skipped';
41
59
  /**
@@ -99,6 +117,15 @@ export interface Schedule {
99
117
  id: string;
100
118
  name: string;
101
119
  enabled: boolean;
120
+ /**
121
+ * PROP-141: проект-владелец расписания. **Обязателен**: инстансных
122
+ * автоматизаций нет — каждое расписание принадлежит проекту.
123
+ *
124
+ * Пустая строка — проект определить не удалось (легаси-запись, у которой
125
+ * цель без проекта): такая запись отключается, помечается
126
+ * `lastError = 'project_required'` и **не срабатывает**.
127
+ */
128
+ projectId: string;
102
129
  /** Cron-выражение из 5 полей (`minute hour day-of-month month day-of-week`), UTC. */
103
130
  cron?: string;
104
131
  /** Интервал `30s | 15m | 1h | 24h`. */
@@ -128,5 +155,24 @@ export interface Schedule {
128
155
  /**
129
156
  * ADR-051/ADR-089: вход создания/обновления расписания — без служебных полей,
130
157
  * которыми управляет хранилище/сервис (`id`, таймстемпы, статус последнего запуска).
158
+ *
159
+ * PROP-141: `projectId` — денормализованный проект расписания. Для новых
160
+ * записей он **обязателен**, но задаёт его сервер (выводит из цели расписания),
161
+ * поэтому в типе входа поле необязательное: клиент не обязан дублировать
162
+ * серверное поле. Запись без проекта стор отключает (`project_required`).
163
+ */
164
+ export type ScheduleInput = Omit<Schedule, 'id' | 'createdAt' | 'updatedAt' | 'lastRunAt' | 'nextRunAt' | 'lastStatus' | 'lastError' | 'projectId'> & {
165
+ /** PROP-141: проект расписания (см. `Schedule.projectId`). */
166
+ projectId?: string;
167
+ };
168
+ /**
169
+ * PROP-141: привести запись расписания к контракту «проект обязателен».
170
+ *
171
+ * Чистая функция (общий контракт для файлового/в-памяти/PG-сторов):
172
+ * - проект уже есть — запись не меняется;
173
+ * - проект выводится из цели (`pipeline`/`ephemeral`) — проставляется;
174
+ * - вывести нельзя (`bound`/`queue` без резолвера «сессия → проект») — запись
175
+ * **не теряется**: она отключается и помечается `project_required`
176
+ * (не срабатывает).
131
177
  */
132
- export type ScheduleInput = Omit<Schedule, 'id' | 'createdAt' | 'updatedAt' | 'lastRunAt' | 'nextRunAt' | 'lastStatus' | 'lastError'>;
178
+ export declare function normalizeScheduleProject(schedule: Schedule): Schedule;
@@ -6,4 +6,53 @@
6
6
  * маршрутизацию в сессию выполняет `EventRouter` (seam — `RouteRuleProvider`).
7
7
  * Здесь только типы без бизнес-логики; cron/interval-парсеры живут в core.
8
8
  */
9
- export {};
9
+ /**
10
+ * PROP-141: код «проект расписания не определён».
11
+ *
12
+ * Запись без проекта **не теряется** — она остаётся в реестре, но
13
+ * отключается и помечается этой строкой в `lastError` (не срабатывает).
14
+ */
15
+ export const SCHEDULE_PROJECT_REQUIRED_ERROR = 'project_required';
16
+ /**
17
+ * PROP-141: проект расписания, выводимый **из цели** (без обращения к
18
+ * хранилищу).
19
+ *
20
+ * - `pipeline` → `target.projectId` (проект-владелец пайплайна);
21
+ * - `ephemeral` → `target.project`;
22
+ * - `bound`/`queue` → `undefined`: проект берётся у сессии-цели, а её
23
+ * разрешает резолвер «сессия → проект» (задаёт composition root).
24
+ */
25
+ export function deriveScheduleProjectId(target) {
26
+ switch (target.mode) {
27
+ case 'pipeline':
28
+ return target.projectId || undefined;
29
+ case 'ephemeral':
30
+ return target.project || undefined;
31
+ case 'bound':
32
+ case 'queue':
33
+ return undefined;
34
+ }
35
+ }
36
+ /**
37
+ * PROP-141: привести запись расписания к контракту «проект обязателен».
38
+ *
39
+ * Чистая функция (общий контракт для файлового/в-памяти/PG-сторов):
40
+ * - проект уже есть — запись не меняется;
41
+ * - проект выводится из цели (`pipeline`/`ephemeral`) — проставляется;
42
+ * - вывести нельзя (`bound`/`queue` без резолвера «сессия → проект») — запись
43
+ * **не теряется**: она отключается и помечается `project_required`
44
+ * (не срабатывает).
45
+ */
46
+ export function normalizeScheduleProject(schedule) {
47
+ if (schedule.projectId)
48
+ return schedule;
49
+ const derived = deriveScheduleProjectId(schedule.target);
50
+ if (derived)
51
+ return { ...schedule, projectId: derived };
52
+ return {
53
+ ...schedule,
54
+ projectId: '',
55
+ enabled: false,
56
+ lastError: SCHEDULE_PROJECT_REQUIRED_ERROR,
57
+ };
58
+ }