@itphx/synth-storage-postgres 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.
package/dist/index.d.ts CHANGED
@@ -49,3 +49,5 @@ export { buildSkillPorts, PgSkillRepository } from './ports/skills.js';
49
49
  export type { SkillPorts } from './ports/skills.js';
50
50
  export { buildContextFilePorts, PgContextFileRepository } from './ports/context-files.js';
51
51
  export type { ContextFilePorts, ContextFilePortOptions, ContextOverrideSourceLike } from './ports/context-files.js';
52
+ export { buildTimerPorts, PgTimerRepository, PgTimerFiringRepository } from './ports/timers.js';
53
+ export type { TimerPorts } from './ports/timers.js';
package/dist/index.js CHANGED
@@ -54,3 +54,6 @@ export { buildSkillPorts, PgSkillRepository } from './ports/skills.js';
54
54
  // ADR-116: файлы контекста — пользовательская часть в SQL (`context_files`,
55
55
  // миграция 027), системные промпты образа остаются ФС.
56
56
  export { buildContextFilePorts, PgContextFileRepository } from './ports/context-files.js';
57
+ // PROP-141 (Часть B): реестр таймеров/будильников (`timers`) и append-only
58
+ // история их срабатываний (`timer_firings`) — миграция 037.
59
+ export { buildTimerPorts, PgTimerRepository, PgTimerFiringRepository } from './ports/timers.js';
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Миграция 026_instance_skills — instance-скиллы в SQL (ADR-116, ADR-046 §4):
2
+ * Миграция 026_instance_skills — instance-скиллы в SQL (ADR-116, ADR-126 §9):
3
3
  * метаданные (`frontmatter` из `SKILL.md`) — в таблице, **содержимое**
4
4
  * (`SKILL.md` и supporting-файлы) — в blob-сторе под `skills/<name>/…`
5
5
  * (blobs остаются файловыми по конструкции, ADR-116 §2).
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Миграция 026_instance_skills — instance-скиллы в SQL (ADR-116, ADR-046 §4):
2
+ * Миграция 026_instance_skills — instance-скиллы в SQL (ADR-116, ADR-126 §9):
3
3
  * метаданные (`frontmatter` из `SKILL.md`) — в таблице, **содержимое**
4
4
  * (`SKILL.md` и supporting-файлы) — в blob-сторе под `skills/<name>/…`
5
5
  * (blobs остаются файловыми по конструкции, ADR-116 §2).
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Миграция 035_project_access — состояние списка доступа к проекту (PROP-133).
3
+ *
4
+ * Добавляет к `projects` два столбца:
5
+ * - `group_members jsonb NOT NULL DEFAULT '{}'::jsonb` — гранты группам
6
+ * (имя группы → роль `owner|editor|viewer`);
7
+ * - `everyone_role text` (nullable) — роль для всех пользователей инстанса;
8
+ * `NULL` — проект не опубликован.
9
+ *
10
+ * Миграция **только аддитивная**: существующие проекты получают пустые группы и
11
+ * `NULL` в «всем» — состояние доступа остаётся «только автор» (PROP-133:
12
+ * «Совместимость»), поведение не меняется.
13
+ *
14
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
15
+ */
16
+ export declare const MIGRATION_035_PROJECT_ACCESS = "\n-- PROP-133: \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0435 \u0441\u043F\u0438\u0441\u043A\u0430 \u0434\u043E\u0441\u0442\u0443\u043F\u0430 (\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044C\u0441\u043A\u0438\u0435 \u0433\u0440\u0430\u043D\u0442\u044B, \u0433\u0440\u0443\u043F\u043F\u044B, \u00AB\u0432\u0441\u0435\u043C\u00BB).\nALTER TABLE projects ADD COLUMN IF NOT EXISTS group_members jsonb NOT NULL DEFAULT '{}'::jsonb;\nALTER TABLE projects ADD COLUMN IF NOT EXISTS everyone_role text;\nCOMMENT ON COLUMN projects.group_members IS 'PROP-133: \u0433\u0440\u0430\u043D\u0442\u044B \u0433\u0440\u0443\u043F\u043F\u0430\u043C (\u0438\u043C\u044F \u0433\u0440\u0443\u043F\u043F\u044B \u2192 \u0440\u043E\u043B\u044C owner|editor|viewer)';\nCOMMENT ON COLUMN projects.everyone_role IS 'PROP-133: \u0440\u043E\u043B\u044C \u0434\u043B\u044F \u0432\u0441\u0435\u0445 \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u0439 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0430; NULL \u2014 \u043F\u0440\u043E\u0435\u043A\u0442 \u043D\u0435 \u043E\u043F\u0443\u0431\u043B\u0438\u043A\u043E\u0432\u0430\u043D';\n";
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Миграция 035_project_access — состояние списка доступа к проекту (PROP-133).
3
+ *
4
+ * Добавляет к `projects` два столбца:
5
+ * - `group_members jsonb NOT NULL DEFAULT '{}'::jsonb` — гранты группам
6
+ * (имя группы → роль `owner|editor|viewer`);
7
+ * - `everyone_role text` (nullable) — роль для всех пользователей инстанса;
8
+ * `NULL` — проект не опубликован.
9
+ *
10
+ * Миграция **только аддитивная**: существующие проекты получают пустые группы и
11
+ * `NULL` в «всем» — состояние доступа остаётся «только автор» (PROP-133:
12
+ * «Совместимость»), поведение не меняется.
13
+ *
14
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
15
+ */
16
+ export const MIGRATION_035_PROJECT_ACCESS = `
17
+ -- PROP-133: состояние списка доступа (пользовательские гранты, группы, «всем»).
18
+ ALTER TABLE projects ADD COLUMN IF NOT EXISTS group_members jsonb NOT NULL DEFAULT '{}'::jsonb;
19
+ ALTER TABLE projects ADD COLUMN IF NOT EXISTS everyone_role text;
20
+ COMMENT ON COLUMN projects.group_members IS 'PROP-133: гранты группам (имя группы → роль owner|editor|viewer)';
21
+ COMMENT ON COLUMN projects.everyone_role IS 'PROP-133: роль для всех пользователей инстанса; NULL — проект не опубликован';
22
+ `;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Миграция 036_message_mentions — `@`-упоминания сообщения (ADR-126 §2).
3
+ *
4
+ * Добавляет к `messages` колонку `mentions jsonb` — массив
5
+ * `[{kind, id, label, span:{start,end}}]`. Аддитивная и идемпотентная:
6
+ * legacy-строки читаются как `undefined` (сообщений без упоминаний).
7
+ */
8
+ export declare const MIGRATION_036_MESSAGE_MENTIONS = "\n-- ADR-126 \u00A72: \u0443\u043F\u043E\u043C\u0438\u043D\u0430\u043D\u0438\u044F @ (\u0430\u0433\u0435\u043D\u0442/\u0444\u0430\u0439\u043B/\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044C) \u0432 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0438.\nALTER TABLE messages ADD COLUMN IF NOT EXISTS mentions jsonb;\nCOMMENT ON COLUMN messages.mentions IS 'ADR-126: @-\u0443\u043F\u043E\u043C\u0438\u043D\u0430\u043D\u0438\u044F \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F (kind/id/label/span)';\n";
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Миграция 036_message_mentions — `@`-упоминания сообщения (ADR-126 §2).
3
+ *
4
+ * Добавляет к `messages` колонку `mentions jsonb` — массив
5
+ * `[{kind, id, label, span:{start,end}}]`. Аддитивная и идемпотентная:
6
+ * legacy-строки читаются как `undefined` (сообщений без упоминаний).
7
+ */
8
+ export const MIGRATION_036_MESSAGE_MENTIONS = `
9
+ -- ADR-126 §2: упоминания @ (агент/файл/пользователь) в сообщении.
10
+ ALTER TABLE messages ADD COLUMN IF NOT EXISTS mentions jsonb;
11
+ COMMENT ON COLUMN messages.mentions IS 'ADR-126: @-упоминания сообщения (kind/id/label/span)';
12
+ `;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Миграция 037_timers — таймеры/будильники и история их срабатываний
3
+ * (PROP-141, Часть B; ADR-097 — драйвер слоя хранения).
4
+ *
5
+ * Две независимые таблицы:
6
+ * - `timers` — реестр автоматизаций: вид (`timer`/`alarm`), проект и сессия
7
+ * (оба обязательны — инстансных автоматизаций нет), владелец, режим повтора
8
+ * (`repeat jsonb`), статус и ближайшее срабатывание (`fires_at`);
9
+ * - `timer_firings` — append-only история срабатываний: плановое время
10
+ * (`scheduled_for`), фактическое (`fired_at`), задержка (`lag_ms`), итог
11
+ * (`outcome`).
12
+ *
13
+ * FK нет (паритет с файловыми реализациями): удаление сессии не чистит
14
+ * таймеры — их снимает каскад `removeBySession`; история срабатываний после
15
+ * удаления таймера остаётся (ретеншн как у Job-истории).
16
+ *
17
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
18
+ */
19
+ export declare const MIGRATION_037_TIMERS = "\n-- PROP-141 (\u0427\u0430\u0441\u0442\u044C B): \u0440\u0435\u0435\u0441\u0442\u0440 \u0442\u0430\u0439\u043C\u0435\u0440\u043E\u0432/\u0431\u0443\u0434\u0438\u043B\u044C\u043D\u0438\u043A\u043E\u0432.\nCREATE TABLE IF NOT EXISTS timers (\n id text PRIMARY KEY,\n kind text NOT NULL,\n name text,\n comment text NOT NULL,\n project_id text NOT NULL,\n session_id text NOT NULL,\n owner_id text NOT NULL,\n repeat jsonb NOT NULL,\n status text NOT NULL,\n fires_at timestamptz NOT NULL,\n created_at timestamptz NOT NULL,\n updated_at timestamptz NOT NULL,\n fired_at timestamptz,\n last_error text\n);\nCREATE INDEX IF NOT EXISTS timers_session_status_idx ON timers (session_id, status);\nCREATE INDEX IF NOT EXISTS timers_project_status_idx ON timers (project_id, status);\nCREATE INDEX IF NOT EXISTS timers_status_idx ON timers (status);\nCREATE INDEX IF NOT EXISTS timers_fires_at_idx ON timers (fires_at);\n\n-- PROP-141 (\u0427\u0430\u0441\u0442\u044C B): \u0438\u0441\u0442\u043E\u0440\u0438\u044F \u0441\u0440\u0430\u0431\u0430\u0442\u044B\u0432\u0430\u043D\u0438\u0439 (append-only).\n-- seq bigserial \u2014 \u043F\u043E\u0440\u044F\u0434\u043E\u043A \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u044F (\u043A\u0430\u043A \u0443 plugin_audit/pipeline_run_events):\n-- \u0432\u044B\u0431\u043E\u0440\u043A\u0430 \u00AB\u0432 \u043F\u043E\u0440\u044F\u0434\u043A\u0435 \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u044F\u00BB \u0434\u0435\u0442\u0435\u0440\u043C\u0438\u043D\u0438\u0440\u043E\u0432\u0430\u043D\u0430.\nCREATE TABLE IF NOT EXISTS timer_firings (\n seq bigserial PRIMARY KEY,\n id text NOT NULL UNIQUE,\n timer_id text NOT NULL,\n fired_at timestamptz NOT NULL,\n scheduled_for timestamptz NOT NULL,\n lag_ms bigint NOT NULL,\n outcome text NOT NULL,\n session_id text NOT NULL\n);\nCREATE INDEX IF NOT EXISTS timer_firings_timer_idx ON timer_firings (timer_id, seq);\nCREATE INDEX IF NOT EXISTS timer_firings_fired_at_idx ON timer_firings (fired_at);\n\nCOMMENT ON TABLE timers IS 'PROP-141: \u0440\u0435\u0435\u0441\u0442\u0440 \u0442\u0430\u0439\u043C\u0435\u0440\u043E\u0432 \u0438 \u0431\u0443\u0434\u0438\u043B\u044C\u043D\u0438\u043A\u043E\u0432 (\u043F\u0440\u0438\u0432\u044F\u0437\u0430\u043D\u044B \u043A \u043F\u0440\u043E\u0435\u043A\u0442\u0443 \u0438 \u0441\u0435\u0441\u0441\u0438\u0438)';\nCOMMENT ON TABLE timer_firings IS 'PROP-141: append-only \u0438\u0441\u0442\u043E\u0440\u0438\u044F \u0441\u0440\u0430\u0431\u0430\u0442\u044B\u0432\u0430\u043D\u0438\u0439 \u0442\u0430\u0439\u043C\u0435\u0440\u043E\u0432';\n";
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Миграция 037_timers — таймеры/будильники и история их срабатываний
3
+ * (PROP-141, Часть B; ADR-097 — драйвер слоя хранения).
4
+ *
5
+ * Две независимые таблицы:
6
+ * - `timers` — реестр автоматизаций: вид (`timer`/`alarm`), проект и сессия
7
+ * (оба обязательны — инстансных автоматизаций нет), владелец, режим повтора
8
+ * (`repeat jsonb`), статус и ближайшее срабатывание (`fires_at`);
9
+ * - `timer_firings` — append-only история срабатываний: плановое время
10
+ * (`scheduled_for`), фактическое (`fired_at`), задержка (`lag_ms`), итог
11
+ * (`outcome`).
12
+ *
13
+ * FK нет (паритет с файловыми реализациями): удаление сессии не чистит
14
+ * таймеры — их снимает каскад `removeBySession`; история срабатываний после
15
+ * удаления таймера остаётся (ретеншн как у Job-истории).
16
+ *
17
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
18
+ */
19
+ export const MIGRATION_037_TIMERS = `
20
+ -- PROP-141 (Часть B): реестр таймеров/будильников.
21
+ CREATE TABLE IF NOT EXISTS timers (
22
+ id text PRIMARY KEY,
23
+ kind text NOT NULL,
24
+ name text,
25
+ comment text NOT NULL,
26
+ project_id text NOT NULL,
27
+ session_id text NOT NULL,
28
+ owner_id text NOT NULL,
29
+ repeat jsonb NOT NULL,
30
+ status text NOT NULL,
31
+ fires_at timestamptz NOT NULL,
32
+ created_at timestamptz NOT NULL,
33
+ updated_at timestamptz NOT NULL,
34
+ fired_at timestamptz,
35
+ last_error text
36
+ );
37
+ CREATE INDEX IF NOT EXISTS timers_session_status_idx ON timers (session_id, status);
38
+ CREATE INDEX IF NOT EXISTS timers_project_status_idx ON timers (project_id, status);
39
+ CREATE INDEX IF NOT EXISTS timers_status_idx ON timers (status);
40
+ CREATE INDEX IF NOT EXISTS timers_fires_at_idx ON timers (fires_at);
41
+
42
+ -- PROP-141 (Часть B): история срабатываний (append-only).
43
+ -- seq bigserial — порядок добавления (как у plugin_audit/pipeline_run_events):
44
+ -- выборка «в порядке добавления» детерминирована.
45
+ CREATE TABLE IF NOT EXISTS timer_firings (
46
+ seq bigserial PRIMARY KEY,
47
+ id text NOT NULL UNIQUE,
48
+ timer_id text NOT NULL,
49
+ fired_at timestamptz NOT NULL,
50
+ scheduled_for timestamptz NOT NULL,
51
+ lag_ms bigint NOT NULL,
52
+ outcome text NOT NULL,
53
+ session_id text NOT NULL
54
+ );
55
+ CREATE INDEX IF NOT EXISTS timer_firings_timer_idx ON timer_firings (timer_id, seq);
56
+ CREATE INDEX IF NOT EXISTS timer_firings_fired_at_idx ON timer_firings (fired_at);
57
+
58
+ COMMENT ON TABLE timers IS 'PROP-141: реестр таймеров и будильников (привязаны к проекту и сессии)';
59
+ COMMENT ON TABLE timer_firings IS 'PROP-141: append-only история срабатываний таймеров';
60
+ `;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Миграция 038_schedule_project_id — проект расписания (PROP-141, Часть B
3
+ * «Расписания: привязка к проекту»; ADR-097 — драйвер слоя хранения).
4
+ *
5
+ * Инстансных автоматизаций нет: каждое расписание принадлежит проекту.
6
+ * Поэтому у расписания появляется колонка `project_id`, а существующие
7
+ * записи получают проект **бэкфиллом**:
8
+ * - `pipeline` → `target->>'projectId'` (проект-владелец пайплайна);
9
+ * - `ephemeral` → `target->>'project'` (проект цели);
10
+ * - `bound`/`queue` → проект сессии-цели (`sessions.project_id`).
11
+ *
12
+ * Проект вывести нельзя (легаси `ephemeral` без проекта, удалённая сессия) —
13
+ * запись **не теряется**: она остаётся в реестре, но отключается и
14
+ * помечается `last_error = 'project_required'` (не срабатывает).
15
+ *
16
+ * Миграция идемпотентна (`IF NOT EXISTS` + `WHERE project_id IS NULL`).
17
+ */
18
+ export declare const MIGRATION_038_SCHEDULE_PROJECT_ID = "\n-- PROP-141: \u043F\u0440\u043E\u0435\u043A\u0442 \u0440\u0430\u0441\u043F\u0438\u0441\u0430\u043D\u0438\u044F (\u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u0435\u043D \u2014 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u043D\u044B\u0445 \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0437\u0430\u0446\u0438\u0439 \u043D\u0435\u0442).\nALTER TABLE schedules ADD COLUMN IF NOT EXISTS project_id text;\n\n-- \u0411\u044D\u043A\u0444\u0438\u043B\u043B: \u043F\u0440\u043E\u0435\u043A\u0442 \u0432\u044B\u0432\u043E\u0434\u0438\u0442\u0441\u044F \u0438\u0437 \u0446\u0435\u043B\u0438.\nUPDATE schedules SET project_id = COALESCE(\n NULLIF(target->>'projectId', ''),\n NULLIF(target->>'project', ''),\n (SELECT s.project_id FROM sessions s WHERE s.id = target->>'sessionId')\n)\nWHERE project_id IS NULL;\n\n-- \u041F\u0440\u043E\u0435\u043A\u0442 \u0432\u044B\u0432\u0435\u0441\u0442\u0438 \u043D\u0435\u043B\u044C\u0437\u044F: \u0437\u0430\u043F\u0438\u0441\u044C \u043E\u0441\u0442\u0430\u0451\u0442\u0441\u044F, \u043D\u043E \u043D\u0435 \u0441\u0440\u0430\u0431\u0430\u0442\u044B\u0432\u0430\u0435\u0442.\nUPDATE schedules\nSET enabled = false, last_error = 'project_required'\nWHERE project_id IS NULL OR project_id = '';\n\nCREATE INDEX IF NOT EXISTS schedules_project_idx ON schedules (project_id);\n\nCOMMENT ON COLUMN schedules.project_id IS 'PROP-141: \u043F\u0440\u043E\u0435\u043A\u0442-\u0432\u043B\u0430\u0434\u0435\u043B\u0435\u0446 \u0440\u0430\u0441\u043F\u0438\u0441\u0430\u043D\u0438\u044F (\u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u0435\u043D)';\n";
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Миграция 038_schedule_project_id — проект расписания (PROP-141, Часть B
3
+ * «Расписания: привязка к проекту»; ADR-097 — драйвер слоя хранения).
4
+ *
5
+ * Инстансных автоматизаций нет: каждое расписание принадлежит проекту.
6
+ * Поэтому у расписания появляется колонка `project_id`, а существующие
7
+ * записи получают проект **бэкфиллом**:
8
+ * - `pipeline` → `target->>'projectId'` (проект-владелец пайплайна);
9
+ * - `ephemeral` → `target->>'project'` (проект цели);
10
+ * - `bound`/`queue` → проект сессии-цели (`sessions.project_id`).
11
+ *
12
+ * Проект вывести нельзя (легаси `ephemeral` без проекта, удалённая сессия) —
13
+ * запись **не теряется**: она остаётся в реестре, но отключается и
14
+ * помечается `last_error = 'project_required'` (не срабатывает).
15
+ *
16
+ * Миграция идемпотентна (`IF NOT EXISTS` + `WHERE project_id IS NULL`).
17
+ */
18
+ export const MIGRATION_038_SCHEDULE_PROJECT_ID = `
19
+ -- PROP-141: проект расписания (обязателен — инстансных автоматизаций нет).
20
+ ALTER TABLE schedules ADD COLUMN IF NOT EXISTS project_id text;
21
+
22
+ -- Бэкфилл: проект выводится из цели.
23
+ UPDATE schedules SET project_id = COALESCE(
24
+ NULLIF(target->>'projectId', ''),
25
+ NULLIF(target->>'project', ''),
26
+ (SELECT s.project_id FROM sessions s WHERE s.id = target->>'sessionId')
27
+ )
28
+ WHERE project_id IS NULL;
29
+
30
+ -- Проект вывести нельзя: запись остаётся, но не срабатывает.
31
+ UPDATE schedules
32
+ SET enabled = false, last_error = 'project_required'
33
+ WHERE project_id IS NULL OR project_id = '';
34
+
35
+ CREATE INDEX IF NOT EXISTS schedules_project_idx ON schedules (project_id);
36
+
37
+ COMMENT ON COLUMN schedules.project_id IS 'PROP-141: проект-владелец расписания (обязателен)';
38
+ `;
@@ -42,6 +42,10 @@ import { MIGRATION_031_SSH_KEY_POLICY } from './031-ssh-key-policy.js';
42
42
  import { MIGRATION_032_MCP_REMOTE_MODE } from './032-mcp-remote-mode.js';
43
43
  import { MIGRATION_033_SESSION_SOURCE_ID } from './033-session-source-id.js';
44
44
  import { MIGRATION_034_PENDING_APPROVALS } from './034-pending-approvals.js';
45
+ import { MIGRATION_035_PROJECT_ACCESS } from './035-project-access.js';
46
+ import { MIGRATION_036_MESSAGE_MENTIONS } from './036-message-mentions.js';
47
+ import { MIGRATION_037_TIMERS } from './037-timers.js';
48
+ import { MIGRATION_038_SCHEDULE_PROJECT_ID } from './038-schedule-project-id.js';
45
49
  /** Полный набор миграций драйвера (по возрастанию версии). */
46
50
  export const MIGRATIONS = [
47
51
  { version: 1, id: '001_init', sql: MIGRATION_001_INIT },
@@ -78,6 +82,10 @@ export const MIGRATIONS = [
78
82
  { version: 32, id: '032_mcp_remote_mode', sql: MIGRATION_032_MCP_REMOTE_MODE },
79
83
  { version: 33, id: '033_session_source_id', sql: MIGRATION_033_SESSION_SOURCE_ID },
80
84
  { version: 34, id: '034_pending_approvals', sql: MIGRATION_034_PENDING_APPROVALS },
85
+ { version: 35, id: '035_project_access', sql: MIGRATION_035_PROJECT_ACCESS },
86
+ { version: 36, id: '036_message_mentions', sql: MIGRATION_036_MESSAGE_MENTIONS },
87
+ { version: 37, id: '037_timers', sql: MIGRATION_037_TIMERS },
88
+ { version: 38, id: '038_schedule_project_id', sql: MIGRATION_038_SCHEDULE_PROJECT_ID },
81
89
  ];
82
90
  /** Последняя (ожидаемая) версия схемы. */
83
91
  export function latestSchemaVersion(migrations = MIGRATIONS) {
@@ -33,6 +33,7 @@
33
33
  */
34
34
  import type { ContextCategory, ContextFileContent, ContextFileInfo } from '@itphx/synth-shared';
35
35
  import type { ContextFileRepository, StorageContext } from '@itphx/synth-core';
36
+ import type { ExecutionEnvironmentKind } from '@itphx/synth-core';
36
37
  import type { PortDeps } from './deps.js';
37
38
  /** Часть `StorageContext`, которой владеет группа «contextFiles». */
38
39
  export type ContextFilePorts = Pick<StorageContext, 'contextFiles'>;
@@ -98,9 +99,11 @@ export declare class PgContextFileRepository implements ContextFileRepository, C
98
99
  getSchedulerNotice(language?: string): string;
99
100
  getSchedulerTurnNotice(language?: string): string;
100
101
  getSubagentNotice(language?: string): string;
102
+ getBackgroundNotice(language?: string): string;
101
103
  getMaxStepsPrompt(language?: string): string;
102
104
  getTodoFinalizePrompt(language?: string): string;
103
105
  getSummarizerPrompt(language?: string): string;
106
+ getEnvironment(kind: ExecutionEnvironmentKind, language?: string): string;
104
107
  getCompactorPrompt(language?: string): string;
105
108
  getUserContextTemplate(language?: string): string;
106
109
  getCompressedDialogTemplate(language?: string): string;
@@ -108,6 +111,8 @@ export declare class PgContextFileRepository implements ContextFileRepository, C
108
111
  getMediaDeriveTemplate(language?: string): string;
109
112
  getStickyNotesTemplate(language?: string): string;
110
113
  getRoutingInstructions(language?: string): string;
114
+ getContentRules(language?: string): string;
115
+ /** @deprecated Алиас `getContentRules` (порт: обратная совместимость). */
111
116
  getRules(language?: string): string;
112
117
  getGatewayInstructions(language?: string): string;
113
118
  getMemoryInstructions(language?: string): string;
@@ -111,6 +111,9 @@ export class PgContextFileRepository {
111
111
  getSubagentNotice(language) {
112
112
  return this._config.getSubagentNotice(language);
113
113
  }
114
+ getBackgroundNotice(language) {
115
+ return this._config.getBackgroundNotice(language);
116
+ }
114
117
  getMaxStepsPrompt(language) {
115
118
  return this._config.getMaxStepsPrompt(language);
116
119
  }
@@ -120,6 +123,9 @@ export class PgContextFileRepository {
120
123
  getSummarizerPrompt(language) {
121
124
  return this._config.getSummarizerPrompt(language);
122
125
  }
126
+ getEnvironment(kind, language) {
127
+ return this._config.getEnvironment(kind, language);
128
+ }
123
129
  getCompactorPrompt(language) {
124
130
  return this._config.getCompactorPrompt(language);
125
131
  }
@@ -141,6 +147,10 @@ export class PgContextFileRepository {
141
147
  getRoutingInstructions(language) {
142
148
  return this._config.getRoutingInstructions(language);
143
149
  }
150
+ getContentRules(language) {
151
+ return this._config.getContentRules(language);
152
+ }
153
+ /** @deprecated Алиас `getContentRules` (порт: обратная совместимость). */
144
154
  getRules(language) {
145
155
  return this._config.getRules(language);
146
156
  }
@@ -6,7 +6,7 @@
6
6
  * `enabled` и `target.mode !== 'ephemeral'` (SQL `EXISTS` по `target->>'sessionId'`);
7
7
  * Job-история — append-only (`jobs.seq`), `list` — последние N в порядке добавления.
8
8
  */
9
- import { generateId } from '@itphx/synth-shared';
9
+ import { generateId, SCHEDULE_PROJECT_REQUIRED_ERROR, } from '@itphx/synth-shared';
10
10
  import { jsonbParam } from '../json-param.js';
11
11
  import { compact, toInt, toIso, toIsoRequired } from './events-core.js';
12
12
  function toSchedule(row) {
@@ -14,6 +14,8 @@ function toSchedule(row) {
14
14
  id: row.id,
15
15
  name: row.name,
16
16
  enabled: row.enabled,
17
+ // PROP-141: пустая строка — «проект не определён» (легаси-запись).
18
+ projectId: row.project_id ?? '',
17
19
  cron: row.cron ?? undefined,
18
20
  every: row.every ?? undefined,
19
21
  target: (row.target ?? { mode: 'ephemeral' }),
@@ -60,14 +62,18 @@ export class PgScheduleRepository {
60
62
  async create(input) {
61
63
  const id = `sch_${generateId()}`;
62
64
  const now = new Date().toISOString();
65
+ // PROP-141: проект расписания обязателен — запись без проекта не
66
+ // срабатывает (отключается и помечается `project_required`).
67
+ const projectId = input.projectId ?? '';
68
+ const needsProject = !projectId;
63
69
  const rows = await this._deps.connection.query(`INSERT INTO schedules
64
70
  (id, name, enabled, cron, every, target, prompt, payload, owner_id, catch_up,
65
- created_at, updated_at)
66
- VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7, $8::jsonb, $9, $10, $11, $11)
71
+ project_id, created_at, updated_at, last_error)
72
+ VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7, $8::jsonb, $9, $10, $11, $12, $12, $13)
67
73
  RETURNING *`, [
68
74
  id,
69
75
  input.name,
70
- input.enabled,
76
+ needsProject ? false : input.enabled,
71
77
  input.cron ?? null,
72
78
  input.every ?? null,
73
79
  jsonbParam(input.target ?? {}),
@@ -75,7 +81,9 @@ export class PgScheduleRepository {
75
81
  input.payload !== undefined ? jsonbParam(input.payload) : null,
76
82
  input.ownerId ?? null,
77
83
  input.catchUp ?? null,
84
+ projectId || null,
78
85
  now,
86
+ needsProject ? SCHEDULE_PROJECT_REQUIRED_ERROR : null,
79
87
  ]);
80
88
  return toSchedule(rows[0]);
81
89
  }
@@ -105,6 +113,13 @@ export class PgScheduleRepository {
105
113
  params.push(jsonbParam(patch.target));
106
114
  sets.push(`target = $${params.length}::jsonb`);
107
115
  }
116
+ // PROP-141: проект расписания — обязательное денормализованное поле:
117
+ // собственным ключом с `undefined` он не очищается (иначе расписание
118
+ // осталось бы без проекта и перестало бы срабатывать).
119
+ if (patch.projectId !== undefined) {
120
+ params.push(patch.projectId || null);
121
+ sets.push(`project_id = $${params.length}`);
122
+ }
108
123
  // Nullable-поля — own-property семантика: собственный ключ со значением
109
124
  // `undefined` очищает колонку (`NULL`), отсутствие ключа — не трогает.
110
125
  if (Object.hasOwn(patch, 'prompt')) {
@@ -57,6 +57,16 @@ function sanitize(raw) {
57
57
  out.chatViewMode = src.chatViewMode;
58
58
  if (src.chatDensity === 'normal' || src.chatDensity === 'compact')
59
59
  out.chatDensity = src.chatDensity;
60
+ // Рендер сообщений пользователя и диаграмм Mermaid — только известные
61
+ // значения (паритет `DefaultsStore.sanitize`).
62
+ if (src.userMessageMarkdown === 'markdown' || src.userMessageMarkdown === 'plain') {
63
+ out.userMessageMarkdown = src.userMessageMarkdown;
64
+ }
65
+ if (src.mermaidRenderingMode === 'svg' ||
66
+ src.mermaidRenderingMode === 'ascii' ||
67
+ src.mermaidRenderingMode === 'off') {
68
+ out.mermaidRenderingMode = src.mermaidRenderingMode;
69
+ }
60
70
  const chatMobile = sanitizeChatScale(src.chatScaleMobile);
61
71
  if (chatMobile !== undefined)
62
72
  out.chatScaleMobile = chatMobile;
@@ -4,12 +4,18 @@
4
4
  * Эталон семантики — `ProjectStore`/`MemoryProjectRepository`:
5
5
  * - `create()` — синхронная чистая фабрика (id, `members`, 4 дефолтные колонки
6
6
  * плана, пустые `statusMessages`/`log`, `version: 1`, таймстемпы);
7
- * - `list(userId)` — владелец **или** участник, сортировка `updated_at DESC`;
7
+ * - `list(viewer)` — владелец, участник, грант по группе или режим «всем
8
+ * пользователям» (PROP-133); без `viewer` — все проекты, сортировка
9
+ * `updated_at DESC`;
8
10
  * - `delete` отсутствующего — не ошибка; `load` отсутствующего — `null`.
9
11
  *
10
12
  * `members` — child-таблица `project_members` (PK `(project_id,user_id)`,
11
13
  * индекс `(user_id)`): `save` заменяет набор участий в той же транзакции, что и
12
14
  * строку проекта. `plan`/`log`/`status_messages`/`repos`/`mcp`/`skills` — `jsonb`.
15
+ * PROP-133: `group_members` (`jsonb`) и `everyone_role` (`text`) — состояние
16
+ * списка доступа; `list` сначала сужает выборку SQL'ем (оптимизация), затем
17
+ * **обязательно** проверяет каждую строку резолвером `resolveProjectAccess`
18
+ * (истина — резолвер, не SQL).
13
19
  */
14
20
  import type { StorageContext } from '@itphx/synth-core';
15
21
  import type { PostgresConnection } from '../pool.js';
@@ -4,15 +4,21 @@
4
4
  * Эталон семантики — `ProjectStore`/`MemoryProjectRepository`:
5
5
  * - `create()` — синхронная чистая фабрика (id, `members`, 4 дефолтные колонки
6
6
  * плана, пустые `statusMessages`/`log`, `version: 1`, таймстемпы);
7
- * - `list(userId)` — владелец **или** участник, сортировка `updated_at DESC`;
7
+ * - `list(viewer)` — владелец, участник, грант по группе или режим «всем
8
+ * пользователям» (PROP-133); без `viewer` — все проекты, сортировка
9
+ * `updated_at DESC`;
8
10
  * - `delete` отсутствующего — не ошибка; `load` отсутствующего — `null`.
9
11
  *
10
12
  * `members` — child-таблица `project_members` (PK `(project_id,user_id)`,
11
13
  * индекс `(user_id)`): `save` заменяет набор участий в той же транзакции, что и
12
14
  * строку проекта. `plan`/`log`/`status_messages`/`repos`/`mcp`/`skills` — `jsonb`.
15
+ * PROP-133: `group_members` (`jsonb`) и `everyone_role` (`text`) — состояние
16
+ * списка доступа; `list` сначала сужает выборку SQL'ем (оптимизация), затем
17
+ * **обязательно** проверяет каждую строку резолвером `resolveProjectAccess`
18
+ * (истина — резолвер, не SQL).
13
19
  */
14
20
  import { randomUUID } from 'node:crypto';
15
- import { normalizeColorKey, normalizeIconKey } from '@itphx/synth-shared';
21
+ import { ProjectRole, normalizeColorKey, normalizeIconKey, normalizeProjectEveryoneRole, normalizeProjectMemberRoles, resolveProjectAccess, } from '@itphx/synth-shared';
16
22
  import { jsonbParam, requiredIso } from './principals-shared.js';
17
23
  /** Проекции проекта + json-агрегация участий одним запросом (без N+1). */
18
24
  const SELECT_PROJECT = `
@@ -24,11 +30,27 @@ const SELECT_PROJECT = `
24
30
  WHERE pm.project_id = p.id
25
31
  ) m ON true`;
26
32
  function rowToProject(row) {
33
+ // PROP-133: нормализация состояния доступа при чтении (битые роли →
34
+ // `viewer`, `everyone_role` — только `owner|editor|viewer`/`null`).
35
+ //
36
+ // Паритет с `ProjectStore`/`MemoryProjectRepository`: «нет грантов» — это
37
+ // **отсутствие поля**, а не пустой объект/`null`:
38
+ // - `group_members` в БД — `jsonb`, «нет грантов» записан как `{}`
39
+ // (нормальное представление в БД) → наружу поле не отдаём;
40
+ // - `everyone_role` в БД — `text`, «не опубликован» записан как `NULL` →
41
+ // `null` → `undefined` (поле отсутствует), потому что в БД `NULL` и
42
+ // «явный `null`» неразличимы, а эталон (file/memory) при создании
43
+ // оставляет поле **отсутствующим**;
44
+ // - DTO всё равно отдаёт `?? null`, поэтому наружу контракт не меняется.
45
+ const groupMembers = normalizeProjectMemberRoles(row.group_members);
46
+ const everyoneRole = normalizeProjectEveryoneRole(row.everyone_role ?? undefined);
27
47
  return {
28
48
  id: row.id,
29
49
  name: row.name,
30
50
  ownerId: row.owner_id,
31
- members: (row.members ?? {}),
51
+ members: normalizeProjectMemberRoles(row.members),
52
+ ...(Object.keys(groupMembers).length > 0 ? { groupMembers } : {}),
53
+ ...(everyoneRole !== undefined && everyoneRole !== null ? { everyoneRole } : {}),
32
54
  description: row.description ?? '',
33
55
  currentTask: row.current_task ?? '',
34
56
  invariants: row.invariants ?? '',
@@ -56,10 +78,12 @@ function rowToProject(row) {
56
78
  async function writeProject(tx, project) {
57
79
  await tx.query(`INSERT INTO projects (
58
80
  id, name, owner_id, description, current_task, invariants, icon, color,
59
- workspace, plan, log, status_messages, repos, mcp, skills, memory, created_at, updated_at
81
+ workspace, plan, log, status_messages, repos, mcp, skills, memory,
82
+ group_members, everyone_role, created_at, updated_at
60
83
  ) VALUES (
61
84
  $1, $2, $3, $4, $5, $6, $7, $8,
62
- $9, $10::jsonb, $11::jsonb, $12::jsonb, $13::jsonb, $14::jsonb, $15::jsonb, $16::jsonb, $17, $18
85
+ $9, $10::jsonb, $11::jsonb, $12::jsonb, $13::jsonb, $14::jsonb, $15::jsonb, $16::jsonb,
86
+ $17::jsonb, $18, $19, $20
63
87
  )
64
88
  ON CONFLICT (id) DO UPDATE SET
65
89
  name = EXCLUDED.name,
@@ -77,6 +101,8 @@ async function writeProject(tx, project) {
77
101
  mcp = EXCLUDED.mcp,
78
102
  skills = EXCLUDED.skills,
79
103
  memory = EXCLUDED.memory,
104
+ group_members = EXCLUDED.group_members,
105
+ everyone_role = EXCLUDED.everyone_role,
80
106
  updated_at = EXCLUDED.updated_at`, [
81
107
  project.id,
82
108
  project.name,
@@ -94,6 +120,9 @@ async function writeProject(tx, project) {
94
120
  jsonbParam(project.mcp ?? null),
95
121
  jsonbParam(project.skills ?? null),
96
122
  jsonbParam(project.memory ?? null),
123
+ // PROP-133: состояние списка доступа (гранты группам, режим «всем»).
124
+ jsonbParam(project.groupMembers ?? {}),
125
+ project.everyoneRole ?? null,
97
126
  project.createdAt,
98
127
  project.updatedAt,
99
128
  ]);
@@ -143,25 +172,51 @@ export function createPrincipalProjectsPort(conn) {
143
172
  async delete(id) {
144
173
  await conn.query('DELETE FROM projects WHERE id = $1', [id]);
145
174
  },
146
- async list(userId) {
147
- const rows = userId
175
+ /**
176
+ * Список проектов (PROP-133).
177
+ *
178
+ * Без `viewer` — все проекты (ADMIN/LEAD и внутренние задачи). С
179
+ * `viewer` — SQL сужает выборку (владелец/участник/«всем»/грант по
180
+ * группе) — это **оптимизация**; истина — резолвер `resolveProjectAccess`,
181
+ * поэтому каждая загруженная строка проверяется им (битая роль в данных не
182
+ * выдаёт лишний доступ).
183
+ */
184
+ async list(viewer) {
185
+ const rows = viewer
148
186
  ? await conn.query(`${SELECT_PROJECT}
149
187
  WHERE p.owner_id = $1
150
188
  OR EXISTS (
151
189
  SELECT 1 FROM project_members pm2
152
190
  WHERE pm2.project_id = p.id AND pm2.user_id = $1
153
191
  )
154
- ORDER BY p.updated_at DESC`, [userId])
192
+ OR p.everyone_role IS NOT NULL
193
+ OR (
194
+ jsonb_typeof(p.group_members) = 'object'
195
+ AND p.group_members ?| $2::text[]
196
+ )
197
+ ORDER BY p.updated_at DESC`, [viewer.userId, viewer.groups ?? []])
155
198
  : await conn.query(`${SELECT_PROJECT} ORDER BY p.updated_at DESC`);
156
- return rows.map(rowToProject);
199
+ const projects = rows.map(rowToProject);
200
+ if (!viewer)
201
+ return projects;
202
+ return projects.filter((project) => resolveProjectAccess(project, viewer).read);
157
203
  },
158
204
  create(name, ownerId, data) {
159
205
  const now = new Date().toISOString();
206
+ // PROP-133: роль владельца всегда `owner` (понизить её нельзя).
207
+ const members = normalizeProjectMemberRoles(data?.members);
208
+ members[ownerId] = ProjectRole.OWNER;
209
+ const groupMembers = data?.groupMembers
210
+ ? normalizeProjectMemberRoles(data.groupMembers)
211
+ : undefined;
212
+ const everyoneRole = normalizeProjectEveryoneRole(data?.everyoneRole);
160
213
  return {
161
214
  id: randomUUID(),
162
215
  name,
163
216
  ownerId,
164
- members: { [ownerId]: 'owner' },
217
+ members,
218
+ ...(groupMembers ? { groupMembers } : {}),
219
+ ...(everyoneRole !== undefined ? { everyoneRole } : {}),
165
220
  description: data?.description || '',
166
221
  currentTask: '',
167
222
  invariants: '',
@@ -169,7 +224,7 @@ export function createPrincipalProjectsPort(conn) {
169
224
  color: data?.color,
170
225
  workspace: data?.workspace,
171
226
  repos: data?.repos,
172
- // ADR-071 §2.4 / ADR-046 §4.5: сид скоупа новых проектов (снимок системных дефолтов).
227
+ // ADR-071 §2.4 / ADR-126 §11: сид скоупа новых проектов (снимок системных дефолтов).
173
228
  ...(data?.mcp ? { mcp: data.mcp } : {}),
174
229
  ...(data?.skills ? { skills: data.skills } : {}),
175
230
  statusMessages: [],