@itphx/synth-storage-postgres 0.13.4 → 0.13.8

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.
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Миграция 031_ssh_key_policy — политика SSH-ключа (PROP-124).
3
+ *
4
+ * В контракт `SSHKey` добавлены поля `usages` (`git`/`ssh`), `allowHosts`
5
+ * (правила хостов) и `allowPorts` (порты). PG-порт их не писал и не читал —
6
+ * после reload ключ терял политику (тихая потеря данных).
7
+ *
8
+ * Дефолты для существующих строк — как при чтении файлового стора (fail-closed):
9
+ * `usages = {git}`, `allow_hosts = {}`, `allow_ports = {}`.
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export declare const MIGRATION_031_SSH_KEY_POLICY = "\n-- PROP-124: \u0441\u043F\u043E\u0441\u043E\u0431\u044B \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u043D\u0438\u044F \u043A\u043B\u044E\u0447\u0430 (git|ssh) \u2014 \u0434\u0435\u0444\u043E\u043B\u0442 {git}.\nALTER TABLE ssh_keys ADD COLUMN IF NOT EXISTS usages text[] NOT NULL DEFAULT ARRAY['git'];\nCOMMENT ON COLUMN ssh_keys.usages IS 'PROP-124: \u0441\u043F\u043E\u0441\u043E\u0431\u044B \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u043D\u0438\u044F \u043A\u043B\u044E\u0447\u0430 (git|ssh)';\n\n-- PROP-124: \u043F\u0440\u0430\u0432\u0438\u043B\u0430 \u0445\u043E\u0441\u0442\u043E\u0432 (\u0440\u0435\u0436\u0438\u043C tools): hostname | *.suffix | IP | CIDR.\nALTER TABLE ssh_keys ADD COLUMN IF NOT EXISTS allow_hosts text[] NOT NULL DEFAULT ARRAY[]::text[];\nCOMMENT ON COLUMN ssh_keys.allow_hosts IS 'PROP-124: \u043F\u0440\u0430\u0432\u0438\u043B\u0430 \u0445\u043E\u0441\u0442\u043E\u0432 \u043F\u043E\u043B\u0438\u0442\u0438\u043A\u0438 \u043A\u043B\u044E\u0447\u0430 (\u0440\u0435\u0436\u0438\u043C tools)';\n\n-- PROP-124: \u043F\u043E\u0440\u0442\u044B (\u0440\u0435\u0436\u0438\u043C tools): 1..65535; \u043F\u0443\u0441\u0442\u043E \u2014 22 (ssh).\nALTER TABLE ssh_keys ADD COLUMN IF NOT EXISTS allow_ports integer[] NOT NULL DEFAULT ARRAY[]::integer[];\nCOMMENT ON COLUMN ssh_keys.allow_ports IS 'PROP-124: \u043F\u043E\u0440\u0442\u044B \u043F\u043E\u043B\u0438\u0442\u0438\u043A\u0438 \u043A\u043B\u044E\u0447\u0430 (\u0440\u0435\u0436\u0438\u043C tools)';\n";
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Миграция 031_ssh_key_policy — политика SSH-ключа (PROP-124).
3
+ *
4
+ * В контракт `SSHKey` добавлены поля `usages` (`git`/`ssh`), `allowHosts`
5
+ * (правила хостов) и `allowPorts` (порты). PG-порт их не писал и не читал —
6
+ * после reload ключ терял политику (тихая потеря данных).
7
+ *
8
+ * Дефолты для существующих строк — как при чтении файлового стора (fail-closed):
9
+ * `usages = {git}`, `allow_hosts = {}`, `allow_ports = {}`.
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export const MIGRATION_031_SSH_KEY_POLICY = `
14
+ -- PROP-124: способы использования ключа (git|ssh) — дефолт {git}.
15
+ ALTER TABLE ssh_keys ADD COLUMN IF NOT EXISTS usages text[] NOT NULL DEFAULT ARRAY['git'];
16
+ COMMENT ON COLUMN ssh_keys.usages IS 'PROP-124: способы использования ключа (git|ssh)';
17
+
18
+ -- PROP-124: правила хостов (режим tools): hostname | *.suffix | IP | CIDR.
19
+ ALTER TABLE ssh_keys ADD COLUMN IF NOT EXISTS allow_hosts text[] NOT NULL DEFAULT ARRAY[]::text[];
20
+ COMMENT ON COLUMN ssh_keys.allow_hosts IS 'PROP-124: правила хостов политики ключа (режим tools)';
21
+
22
+ -- PROP-124: порты (режим tools): 1..65535; пусто — 22 (ssh).
23
+ ALTER TABLE ssh_keys ADD COLUMN IF NOT EXISTS allow_ports integer[] NOT NULL DEFAULT ARRAY[]::integer[];
24
+ COMMENT ON COLUMN ssh_keys.allow_ports IS 'PROP-124: порты политики ключа (режим tools)';
25
+ `;
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Миграция 032_mcp_remote_mode — режим доставки MCP-сервера в локальные
3
+ * сессии гибрида (PROP-125).
4
+ *
5
+ * В контракт `McpRegistryEntry` добавлено поле `remoteMode`
6
+ * (`auto`|`relay`|`tools`). PG-порт его не писал и не читал — после reload
7
+ * режим терялся (тихая потеря данных).
8
+ *
9
+ * Дефолт для существующих строк — `auto` (как при чтении файлового стора):
10
+ * `relay` для http/sse, `tools` для stdio.
11
+ *
12
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
13
+ */
14
+ export declare const MIGRATION_032_MCP_REMOTE_MODE = "\n-- PROP-125: \u0440\u0435\u0436\u0438\u043C \u0434\u043E\u0441\u0442\u0430\u0432\u043A\u0438 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u0432 \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0435 \u0441\u0435\u0441\u0441\u0438\u0438 \u0433\u0438\u0431\u0440\u0438\u0434\u0430 (auto|relay|tools).\nALTER TABLE mcp_registry ADD COLUMN IF NOT EXISTS remote_mode text NOT NULL DEFAULT 'auto';\nCOMMENT ON COLUMN mcp_registry.remote_mode IS 'PROP-125: \u0440\u0435\u0436\u0438\u043C \u0434\u043E\u0441\u0442\u0430\u0432\u043A\u0438 MCP-\u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u0432 \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0435 \u0441\u0435\u0441\u0441\u0438\u0438 \u0433\u0438\u0431\u0440\u0438\u0434\u0430 (auto|relay|tools)';\n";
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Миграция 032_mcp_remote_mode — режим доставки MCP-сервера в локальные
3
+ * сессии гибрида (PROP-125).
4
+ *
5
+ * В контракт `McpRegistryEntry` добавлено поле `remoteMode`
6
+ * (`auto`|`relay`|`tools`). PG-порт его не писал и не читал — после reload
7
+ * режим терялся (тихая потеря данных).
8
+ *
9
+ * Дефолт для существующих строк — `auto` (как при чтении файлового стора):
10
+ * `relay` для http/sse, `tools` для stdio.
11
+ *
12
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
13
+ */
14
+ export const MIGRATION_032_MCP_REMOTE_MODE = `
15
+ -- PROP-125: режим доставки сервера в локальные сессии гибрида (auto|relay|tools).
16
+ ALTER TABLE mcp_registry ADD COLUMN IF NOT EXISTS remote_mode text NOT NULL DEFAULT 'auto';
17
+ COMMENT ON COLUMN mcp_registry.remote_mode IS 'PROP-125: режим доставки MCP-сервера в локальные сессии гибрида (auto|relay|tools)';
18
+ `;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Миграция 033_session_source_id — маркер источника сессии при переносе между
3
+ * инстансами (`Session.sourceSessionId`).
4
+ *
5
+ * Поле используется как **ключ дедупликации повторного импорта**: повторная
6
+ * загрузка той же сессии в тот же проект обновляет существующую запись, а не
7
+ * создаёт дубль. PG-порт его не писал и не читал — после reload маркер терялся
8
+ * (повторный импорт создавал вторую копию).
9
+ *
10
+ * Колонка nullable: у локально созданных сессий и у записей до появления поля
11
+ * маркера нет. Индекс — по паре «проект + маркер», partial: ищется только
12
+ * непустое значение (дедуп в рамках проекта).
13
+ *
14
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
15
+ */
16
+ export declare const MIGRATION_033_SESSION_SOURCE_ID = "\n-- \u041C\u0430\u0440\u043A\u0435\u0440 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0430 \u043F\u0440\u0438 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0435 \u043C\u0435\u0436\u0434\u0443 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0430\u043C\u0438 (\u043A\u043B\u044E\u0447 \u0434\u0435\u0434\u0443\u043F\u043B\u0438\u043A\u0430\u0446\u0438\u0438 \u0438\u043C\u043F\u043E\u0440\u0442\u0430).\nALTER TABLE sessions ADD COLUMN IF NOT EXISTS source_session_id text;\nCOMMENT ON COLUMN sessions.source_session_id IS '\u041C\u0430\u0440\u043A\u0435\u0440 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0430 \u0441\u0435\u0441\u0441\u0438\u0438 \u043F\u0440\u0438 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0435 \u043C\u0435\u0436\u0434\u0443 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0430\u043C\u0438; \u043A\u043B\u044E\u0447 \u0434\u0435\u0434\u0443\u043F\u043B\u0438\u043A\u0430\u0446\u0438\u0438 \u043F\u043E\u0432\u0442\u043E\u0440\u043D\u043E\u0433\u043E \u0438\u043C\u043F\u043E\u0440\u0442\u0430';\nCREATE INDEX IF NOT EXISTS sessions_project_source_idx ON sessions (project_id, source_session_id) WHERE source_session_id IS NOT NULL;\n";
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Миграция 033_session_source_id — маркер источника сессии при переносе между
3
+ * инстансами (`Session.sourceSessionId`).
4
+ *
5
+ * Поле используется как **ключ дедупликации повторного импорта**: повторная
6
+ * загрузка той же сессии в тот же проект обновляет существующую запись, а не
7
+ * создаёт дубль. PG-порт его не писал и не читал — после reload маркер терялся
8
+ * (повторный импорт создавал вторую копию).
9
+ *
10
+ * Колонка nullable: у локально созданных сессий и у записей до появления поля
11
+ * маркера нет. Индекс — по паре «проект + маркер», partial: ищется только
12
+ * непустое значение (дедуп в рамках проекта).
13
+ *
14
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
15
+ */
16
+ export const MIGRATION_033_SESSION_SOURCE_ID = `
17
+ -- Маркер источника при переносе между инстансами (ключ дедупликации импорта).
18
+ ALTER TABLE sessions ADD COLUMN IF NOT EXISTS source_session_id text;
19
+ COMMENT ON COLUMN sessions.source_session_id IS 'Маркер источника сессии при переносе между инстансами; ключ дедупликации повторного импорта';
20
+ CREATE INDEX IF NOT EXISTS sessions_project_source_idx ON sessions (project_id, source_session_id) WHERE source_session_id IS NOT NULL;
21
+ `;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Миграция 034_pending_approvals — ожидания подтверждения прав (ADR-029).
3
+ *
4
+ * **Отдельная таблица, а не поле документа сессии**: документ сессии пишется
5
+ * полной перезаменой (`save`), а результаты параллельных тулов — точечно
6
+ * (`appendMessage`, ADR-118 §4). Запись ожидания в тот же документ затирала бы
7
+ * точечные записи → гонка lost update.
8
+ *
9
+ * Таблица `pending_approvals`: состав ожидания (тул, аргументы, причина,
10
+ * «виновник») + метаданные (сессия, владелец, момент публикации, таймаут,
11
+ * ход, принципал). Выборка — по сессии.
12
+ *
13
+ * FK нет (паритет с файловыми реализациями): удаление сессии не чистит
14
+ * ожидания — их снимает сам менеджер подтверждений.
15
+ *
16
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасо.
17
+ */
18
+ export declare const MIGRATION_034_PENDING_APPROVALS = "\n-- \u041E\u0436\u0438\u0434\u0430\u043D\u0438\u044F \u043F\u043E\u0434\u0442\u0432\u0435\u0440\u0436\u0434\u0435\u043D\u0438\u044F \u043F\u0440\u0430\u0432 (ADR-029): \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u044B\u0439 \u0441\u0442\u043E\u0440, \u043D\u0435 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442 \u0441\u0435\u0441\u0441\u0438\u0438.\nCREATE TABLE IF NOT EXISTS pending_approvals (\n approval_id text PRIMARY KEY,\n session_id text NOT NULL,\n owner_id text,\n tool_name text NOT NULL,\n arguments jsonb NOT NULL DEFAULT '{}'::jsonb,\n reason text NOT NULL DEFAULT '',\n trigger jsonb,\n asked_at timestamptz NOT NULL DEFAULT now(),\n timeout_ms integer NOT NULL DEFAULT 0,\n turn_id text,\n principal text\n);\nCREATE INDEX IF NOT EXISTS pending_approvals_session_idx ON pending_approvals (session_id);\nCOMMENT ON TABLE pending_approvals IS '\u041E\u0436\u0438\u0434\u0430\u043D\u0438\u044F \u043F\u043E\u0434\u0442\u0432\u0435\u0440\u0436\u0434\u0435\u043D\u0438\u044F \u043F\u0440\u0430\u0432 (ADR-029): \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u044B\u0439 \u0441\u0442\u043E\u0440, \u043F\u0435\u0440\u0435\u0436\u0438\u0432\u0430\u0435\u0442 \u0440\u0435\u0441\u0442\u0430\u0440\u0442 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0430';\n";
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Миграция 034_pending_approvals — ожидания подтверждения прав (ADR-029).
3
+ *
4
+ * **Отдельная таблица, а не поле документа сессии**: документ сессии пишется
5
+ * полной перезаменой (`save`), а результаты параллельных тулов — точечно
6
+ * (`appendMessage`, ADR-118 §4). Запись ожидания в тот же документ затирала бы
7
+ * точечные записи → гонка lost update.
8
+ *
9
+ * Таблица `pending_approvals`: состав ожидания (тул, аргументы, причина,
10
+ * «виновник») + метаданные (сессия, владелец, момент публикации, таймаут,
11
+ * ход, принципал). Выборка — по сессии.
12
+ *
13
+ * FK нет (паритет с файловыми реализациями): удаление сессии не чистит
14
+ * ожидания — их снимает сам менеджер подтверждений.
15
+ *
16
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасо.
17
+ */
18
+ export const MIGRATION_034_PENDING_APPROVALS = `
19
+ -- Ожидания подтверждения прав (ADR-029): отдельный стор, не документ сессии.
20
+ CREATE TABLE IF NOT EXISTS pending_approvals (
21
+ approval_id text PRIMARY KEY,
22
+ session_id text NOT NULL,
23
+ owner_id text,
24
+ tool_name text NOT NULL,
25
+ arguments jsonb NOT NULL DEFAULT '{}'::jsonb,
26
+ reason text NOT NULL DEFAULT '',
27
+ trigger jsonb,
28
+ asked_at timestamptz NOT NULL DEFAULT now(),
29
+ timeout_ms integer NOT NULL DEFAULT 0,
30
+ turn_id text,
31
+ principal text
32
+ );
33
+ CREATE INDEX IF NOT EXISTS pending_approvals_session_idx ON pending_approvals (session_id);
34
+ COMMENT ON TABLE pending_approvals IS 'Ожидания подтверждения прав (ADR-029): отдельный стор, переживает рестарт инстанса';
35
+ `;
@@ -38,6 +38,10 @@ import { MIGRATION_027_CONTEXT_FILES } from './027-context-files.js';
38
38
  import { MIGRATION_028_MESSAGE_REASONING_SIGNATURE } from './028-message-reasoning-signature.js';
39
39
  import { MIGRATION_029_MESSAGE_STREAM_V2 } from './029-message-stream-v2.js';
40
40
  import { MIGRATION_030_SESSION_RETRY } from './030-session-retry.js';
41
+ import { MIGRATION_031_SSH_KEY_POLICY } from './031-ssh-key-policy.js';
42
+ import { MIGRATION_032_MCP_REMOTE_MODE } from './032-mcp-remote-mode.js';
43
+ import { MIGRATION_033_SESSION_SOURCE_ID } from './033-session-source-id.js';
44
+ import { MIGRATION_034_PENDING_APPROVALS } from './034-pending-approvals.js';
41
45
  /** Полный набор миграций драйвера (по возрастанию версии). */
42
46
  export const MIGRATIONS = [
43
47
  { version: 1, id: '001_init', sql: MIGRATION_001_INIT },
@@ -70,6 +74,10 @@ export const MIGRATIONS = [
70
74
  { version: 28, id: '028_message_reasoning_signature', sql: MIGRATION_028_MESSAGE_REASONING_SIGNATURE },
71
75
  { version: 29, id: '029_message_stream_v2', sql: MIGRATION_029_MESSAGE_STREAM_V2 },
72
76
  { version: 30, id: '030_session_retry', sql: MIGRATION_030_SESSION_RETRY },
77
+ { version: 31, id: '031_ssh_key_policy', sql: MIGRATION_031_SSH_KEY_POLICY },
78
+ { version: 32, id: '032_mcp_remote_mode', sql: MIGRATION_032_MCP_REMOTE_MODE },
79
+ { version: 33, id: '033_session_source_id', sql: MIGRATION_033_SESSION_SOURCE_ID },
80
+ { version: 34, id: '034_pending_approvals', sql: MIGRATION_034_PENDING_APPROVALS },
73
81
  ];
74
82
  /** Последняя (ожидаемая) версия схемы. */
75
83
  export function latestSchemaVersion(migrations = MIGRATIONS) {
@@ -35,7 +35,7 @@
35
35
  */
36
36
  import { join, normalize } from 'node:path';
37
37
  import { createHash, randomBytes } from 'node:crypto';
38
- import { GlobalRole, MCP_REGISTRY_SCHEMA_VERSION, SKILL_NAME_MAX, SKILL_NAME_REGEX, generateId, nowISO, } from '@itphx/synth-shared';
38
+ import { GlobalRole, MCP_REGISTRY_SCHEMA_VERSION, SKILL_NAME_MAX, SKILL_NAME_REGEX, SSH_KEY_USAGES, generateId, normalizeSshKeyAllowHosts, normalizeSshKeyAllowPorts, normalizeSshKeyUsages, nowISO, validateSshKeyPolicy, } from '@itphx/synth-shared';
39
39
  import { jsonbParam } from '../json-param.js';
40
40
  import { PostgresUniqueViolationError } from '../errors.js';
41
41
  import { readSchemaVersion } from '../migrate.js';
@@ -464,12 +464,32 @@ class PostgresServiceKeyRepository {
464
464
  function bufferToToken(value) {
465
465
  return Buffer.isBuffer(value) ? value.toString('utf-8') : value;
466
466
  }
467
+ /** Массив целых из `int[]`/jsonb (невалидные элементы отбрасываются). */
468
+ function asNumberArray(value) {
469
+ if (!Array.isArray(value))
470
+ return [];
471
+ return value.filter((item) => typeof item === 'number' && Number.isFinite(item));
472
+ }
473
+ /**
474
+ * PROP-124: типы использования из БД. Колонка отсутствует (строка без миграции)
475
+ * → `undefined` → нормализация даёт `['git']` (fail-closed). Явно пустой массив
476
+ * сохраняется пустым — как в файловом сторе.
477
+ */
478
+ function asSshUsages(value) {
479
+ if (!Array.isArray(value))
480
+ return undefined;
481
+ return value.filter((item) => SSH_KEY_USAGES.includes(item));
482
+ }
467
483
  function sshKeyToMeta(row, agentIds) {
468
484
  const meta = {
469
485
  id: row.id,
470
486
  name: row.name,
471
487
  type: row.type ?? 'user',
472
488
  agentIds: [...agentIds],
489
+ // PROP-124: политика ключа (нормализация — как в файловом сторе).
490
+ usages: normalizeSshKeyUsages(asSshUsages(row.usages)),
491
+ allowHosts: normalizeSshKeyAllowHosts(asStringArray(row.allow_hosts)),
492
+ allowPorts: normalizeSshKeyAllowPorts(asNumberArray(row.allow_ports)),
473
493
  createdAt: toISO(row.created_at),
474
494
  };
475
495
  const updatedAt = toISOOrUndefined(row.updated_at);
@@ -539,6 +559,10 @@ class PostgresSSHKeyRepository {
539
559
  type: row.type ?? 'user',
540
560
  privateKey: bufferToToken(row.private_enc),
541
561
  agentIds: asStringArray(row.agent_ids),
562
+ // PROP-124: политика ключа (нормализация — как в файловом сторе).
563
+ usages: normalizeSshKeyUsages(asSshUsages(row.usages)),
564
+ allowHosts: normalizeSshKeyAllowHosts(asStringArray(row.allow_hosts)),
565
+ allowPorts: normalizeSshKeyAllowPorts(asNumberArray(row.allow_ports)),
542
566
  createdAt: toISO(row.created_at),
543
567
  };
544
568
  const updatedAt = toISOOrUndefined(row.updated_at);
@@ -577,6 +601,12 @@ class PostgresSSHKeyRepository {
577
601
  const { SSHKeyStoreError } = await loadCore();
578
602
  throw new SSHKeyStoreError('invalid', 'Приватный ключ не может быть пустым');
579
603
  }
604
+ // PROP-124: политика ключа проверяется так же, как в файловом сторе.
605
+ const policy = validateSshKeyPolicy(input);
606
+ if (!policy.ok) {
607
+ const { SSHKeyStoreError } = await loadCore();
608
+ throw new SSHKeyStoreError('invalid', policy.message);
609
+ }
580
610
  await this._assertNameUnique(input.name);
581
611
  const { core, key } = await this._masterKey();
582
612
  const now = nowISO();
@@ -584,20 +614,40 @@ class PostgresSSHKeyRepository {
584
614
  const agentIds = input.agentIds ? [...input.agentIds] : [];
585
615
  const privateEnc = core.encryptSecret(input.privateKey, key);
586
616
  const passphraseEnc = input.passphrase === undefined ? null : core.encryptSecret(input.passphrase, key);
617
+ // PROP-124: политика ключа (`usages` без значения → `['git']`).
618
+ const usages = normalizeSshKeyUsages(input.usages);
619
+ const allowHosts = normalizeSshKeyAllowHosts(input.allowHosts);
620
+ const allowPorts = normalizeSshKeyAllowPorts(input.allowPorts);
587
621
  await this._deps.connection.withTransaction(async (tx) => {
588
- await tx.query(`INSERT INTO ssh_keys (id, name, type, private_enc, passphrase_enc, created_at, updated_at)
589
- VALUES ($1,$2,$3,$4::bytea,$5::bytea,$6,$7)`, [id, input.name, input.type ?? 'user', privateEnc, passphraseEnc, now, now]);
622
+ await tx.query(`INSERT INTO ssh_keys (id, name, type, private_enc, passphrase_enc, usages, allow_hosts, allow_ports, created_at, updated_at)
623
+ VALUES ($1,$2,$3,$4::bytea,$5::bytea,$6::text[],$7::text[],$8::integer[],$9,$10)`, [id, input.name, input.type ?? 'user', privateEnc, passphraseEnc, usages, allowHosts, allowPorts, now, now]);
590
624
  for (const agentId of agentIds) {
591
625
  await tx.query('INSERT INTO ssh_key_agents (key_id, agent_id) VALUES ($1,$2) ON CONFLICT DO NOTHING', [id, agentId]);
592
626
  }
593
627
  });
594
- return sshKeyToMeta({ id, name: input.name, type: input.type ?? 'user', private_enc: privateEnc, passphrase_enc: passphraseEnc, created_at: now, updated_at: now }, agentIds);
628
+ return sshKeyToMeta({
629
+ id,
630
+ name: input.name,
631
+ type: input.type ?? 'user',
632
+ private_enc: privateEnc,
633
+ passphrase_enc: passphraseEnc,
634
+ usages,
635
+ allow_hosts: allowHosts,
636
+ allow_ports: allowPorts,
637
+ created_at: now,
638
+ updated_at: now,
639
+ }, agentIds);
595
640
  }
596
641
  async update(id, patch) {
597
642
  const existing = await this._getRow(id);
598
643
  if (!existing)
599
644
  return null;
600
645
  const { core, key } = await this._masterKey();
646
+ // PROP-124: проверка политики до изменения записи.
647
+ const policy = validateSshKeyPolicy(patch);
648
+ if (!policy.ok) {
649
+ throw new core.SSHKeyStoreError('invalid', policy.message);
650
+ }
601
651
  if (patch.name !== undefined && patch.name.toLowerCase() !== existing.name.toLowerCase()) {
602
652
  await this._assertNameUnique(patch.name, id);
603
653
  }
@@ -613,11 +663,22 @@ class PostgresSSHKeyRepository {
613
663
  ? null
614
664
  : bufferToToken(existing.passphrase_enc);
615
665
  const updatedAt = nowISO();
666
+ // PROP-124: политика ключа (пустое поле в patch = «не менять»).
667
+ const nextUsages = patch.usages !== undefined
668
+ ? normalizeSshKeyUsages(patch.usages)
669
+ : normalizeSshKeyUsages(asSshUsages(existing.usages));
670
+ const nextAllowHosts = patch.allowHosts !== undefined
671
+ ? normalizeSshKeyAllowHosts(patch.allowHosts)
672
+ : normalizeSshKeyAllowHosts(asStringArray(existing.allow_hosts));
673
+ const nextAllowPorts = patch.allowPorts !== undefined
674
+ ? normalizeSshKeyAllowPorts(patch.allowPorts)
675
+ : normalizeSshKeyAllowPorts(asNumberArray(existing.allow_ports));
616
676
  const agentIds = patch.agentIds !== undefined ? [...patch.agentIds] : await this._agentIds(id);
617
677
  await this._deps.connection.withTransaction(async (tx) => {
618
678
  await tx.query(`UPDATE ssh_keys
619
- SET name = $2, type = $3, private_enc = $4::bytea, passphrase_enc = $5::bytea, updated_at = $6
620
- WHERE id = $1`, [id, nextName, nextType, nextPrivate, nextPassphrase, updatedAt]);
679
+ SET name = $2, type = $3, private_enc = $4::bytea, passphrase_enc = $5::bytea,
680
+ usages = $6::text[], allow_hosts = $7::text[], allow_ports = $8::integer[], updated_at = $9
681
+ WHERE id = $1`, [id, nextName, nextType, nextPrivate, nextPassphrase, nextUsages, nextAllowHosts, nextAllowPorts, updatedAt]);
621
682
  if (patch.agentIds !== undefined) {
622
683
  await tx.query('DELETE FROM ssh_key_agents WHERE key_id = $1', [id]);
623
684
  for (const agentId of agentIds) {
@@ -631,6 +692,9 @@ class PostgresSSHKeyRepository {
631
692
  type: nextType,
632
693
  private_enc: nextPrivate,
633
694
  passphrase_enc: nextPassphrase,
695
+ usages: nextUsages,
696
+ allow_hosts: nextAllowHosts,
697
+ allow_ports: nextAllowPorts,
634
698
  created_at: existing.created_at,
635
699
  updated_at: updatedAt,
636
700
  }, agentIds);
@@ -758,6 +822,8 @@ function mcpRowToEntry(row) {
758
822
  trust: row.trust ?? 'community',
759
823
  enabled: row.enabled !== false,
760
824
  enabledByDefault: row.enabled_by_default === true,
825
+ // PROP-125: режим доставки; колонка отсутствует/пуста — `auto`.
826
+ remoteMode: row.remote_mode ?? 'auto',
761
827
  createdAt: toISO(row.created_at),
762
828
  updatedAt: toISO(row.updated_at),
763
829
  };
@@ -801,6 +867,8 @@ class PostgresMcpRegistryRepository {
801
867
  trust: input.trust ?? (input.origin === 'instance' ? 'builtin' : 'community'),
802
868
  enabled: input.enabled ?? true,
803
869
  enabledByDefault: input.enabledByDefault ?? input.config.enabledByDefault ?? false,
870
+ // PROP-125: режим доставки в локальные сессии гибрида (дефолт `auto`).
871
+ remoteMode: input.remoteMode ?? 'auto',
804
872
  createdAt: now,
805
873
  updatedAt: now,
806
874
  };
@@ -817,8 +885,8 @@ class PostgresMcpRegistryRepository {
817
885
  }
818
886
  async _insert(entry) {
819
887
  await this._db().query(`INSERT INTO mcp_registry
820
- (id, schema_version, name, config, origin, author, trust, enabled, enabled_by_default, created_at, updated_at)
821
- VALUES ($1,$2,$3,$4::jsonb,$5,$6::jsonb,$7::jsonb,$8,$9,$10,$11)`, [
888
+ (id, schema_version, name, config, origin, author, trust, enabled, enabled_by_default, remote_mode, created_at, updated_at)
889
+ VALUES ($1,$2,$3,$4::jsonb,$5,$6::jsonb,$7::jsonb,$8,$9,$10,$11,$12)`, [
822
890
  entry.id,
823
891
  entry.schemaVersion,
824
892
  entry.name,
@@ -828,6 +896,7 @@ class PostgresMcpRegistryRepository {
828
896
  jsonParam(entry.trust),
829
897
  entry.enabled,
830
898
  entry.enabledByDefault,
899
+ entry.remoteMode ?? 'auto',
831
900
  entry.createdAt,
832
901
  entry.updatedAt,
833
902
  ]);
@@ -851,13 +920,14 @@ class PostgresMcpRegistryRepository {
851
920
  trust: patch.trust ?? entry.trust,
852
921
  enabled: patch.enabled ?? entry.enabled,
853
922
  enabledByDefault: patch.enabledByDefault ?? entry.enabledByDefault,
923
+ remoteMode: patch.remoteMode ?? entry.remoteMode ?? 'auto',
854
924
  schemaVersion: MCP_REGISTRY_SCHEMA_VERSION,
855
925
  updatedAt: nowISO(),
856
926
  };
857
927
  try {
858
928
  await this._db().query(`UPDATE mcp_registry
859
929
  SET name = $2, config = $3::jsonb, origin = $4, trust = $5::jsonb,
860
- enabled = $6, enabled_by_default = $7, schema_version = $8, updated_at = $9
930
+ enabled = $6, enabled_by_default = $7, remote_mode = $8, schema_version = $9, updated_at = $10
861
931
  WHERE id = $1`, [
862
932
  id,
863
933
  updated.name,
@@ -866,6 +936,7 @@ class PostgresMcpRegistryRepository {
866
936
  jsonParam(updated.trust),
867
937
  updated.enabled,
868
938
  updated.enabledByDefault,
939
+ updated.remoteMode ?? 'auto',
869
940
  updated.schemaVersion,
870
941
  updated.updatedAt,
871
942
  ]);
@@ -99,6 +99,7 @@ export declare class PgContextFileRepository implements ContextFileRepository, C
99
99
  getSchedulerTurnNotice(language?: string): string;
100
100
  getSubagentNotice(language?: string): string;
101
101
  getMaxStepsPrompt(language?: string): string;
102
+ getTodoFinalizePrompt(language?: string): string;
102
103
  getSummarizerPrompt(language?: string): string;
103
104
  getCompactorPrompt(language?: string): string;
104
105
  getUserContextTemplate(language?: string): string;
@@ -114,6 +114,9 @@ export class PgContextFileRepository {
114
114
  getMaxStepsPrompt(language) {
115
115
  return this._config.getMaxStepsPrompt(language);
116
116
  }
117
+ getTodoFinalizePrompt(language) {
118
+ return this._config.getTodoFinalizePrompt(language);
119
+ }
117
120
  getSummarizerPrompt(language) {
118
121
  return this._config.getSummarizerPrompt(language);
119
122
  }
@@ -0,0 +1,32 @@
1
+ /**
2
+ * PG-реализация порта **ожиданий подтверждения прав** (ADR-029, ADR-097).
3
+ *
4
+ * Таблица `pending_approvals` (миграция 035): состав ожидания (тул, аргументы,
5
+ * причина, «виновник») и метаданные (сессия, владелец, момент публикации,
6
+ * таймаут, ход, принципал). Выборка — по сессии.
7
+ *
8
+ * Почему отдельная таблица, а не поле документа сессии: `sessions` пишется
9
+ * полной перезаменой (`save`), а результаты параллельных тулов — точечно
10
+ * (`appendMessage`, ADR-118 §4). Запись ожидания в тот же документ затирала бы
11
+ * точечные записи → гонка lost update.
12
+ *
13
+ * Семантика повторяет файловые реализации core (`FilePendingApprovalStore`) и
14
+ * in-memory (`MemoryPendingApprovalRepository`): upsert по `approvalId`,
15
+ * список с фильтром по сессии, `delete` идемпотентно, `clear` — число снятых
16
+ * записей.
17
+ */
18
+ import type { PendingApprovalRecord, PendingApprovalRepository, StorageContext } from '@itphx/synth-core';
19
+ import type { PortDeps } from './deps.js';
20
+ /** Часть `StorageContext`, которой владеет группа «ожидания подтверждений». */
21
+ export type PendingApprovalPorts = Pick<StorageContext, 'pendingApprovals'>;
22
+ /** Порт ожиданий подтверждения прав поверх таблицы `pending_approvals`. */
23
+ export declare class PgPendingApprovalRepository implements PendingApprovalRepository {
24
+ private readonly _deps;
25
+ constructor(_deps: PortDeps);
26
+ save(record: PendingApprovalRecord): Promise<void>;
27
+ delete(approvalId: string): Promise<void>;
28
+ list(sessionId?: string): Promise<PendingApprovalRecord[]>;
29
+ clear(sessionId?: string): Promise<number>;
30
+ }
31
+ /** Собрать порт ожиданий подтверждения прав (ADR-029). */
32
+ export declare function buildPendingApprovalPorts(deps: PortDeps): PendingApprovalPorts;
@@ -0,0 +1,108 @@
1
+ /**
2
+ * PG-реализация порта **ожиданий подтверждения прав** (ADR-029, ADR-097).
3
+ *
4
+ * Таблица `pending_approvals` (миграция 035): состав ожидания (тул, аргументы,
5
+ * причина, «виновник») и метаданные (сессия, владелец, момент публикации,
6
+ * таймаут, ход, принципал). Выборка — по сессии.
7
+ *
8
+ * Почему отдельная таблица, а не поле документа сессии: `sessions` пишется
9
+ * полной перезаменой (`save`), а результаты параллельных тулов — точечно
10
+ * (`appendMessage`, ADR-118 §4). Запись ожидания в тот же документ затирала бы
11
+ * точечные записи → гонка lost update.
12
+ *
13
+ * Семантика повторяет файловые реализации core (`FilePendingApprovalStore`) и
14
+ * in-memory (`MemoryPendingApprovalRepository`): upsert по `approvalId`,
15
+ * список с фильтром по сессии, `delete` идемпотентно, `clear` — число снятых
16
+ * записей.
17
+ */
18
+ import { jsonbParam } from '../json-param.js';
19
+ import { toIsoRequired } from './events-core.js';
20
+ /** Запись ожидания из колонок. */
21
+ function toRecord(row) {
22
+ const trigger = row.trigger && typeof row.trigger === 'object' && !Array.isArray(row.trigger)
23
+ ? row.trigger
24
+ : undefined;
25
+ return {
26
+ approvalId: row.approval_id,
27
+ sessionId: row.session_id,
28
+ ...(row.owner_id ? { ownerId: row.owner_id } : {}),
29
+ toolName: row.tool_name,
30
+ arguments: (row.arguments && typeof row.arguments === 'object' && !Array.isArray(row.arguments))
31
+ ? row.arguments
32
+ : {},
33
+ reason: row.reason ?? '',
34
+ ...(trigger ? { trigger } : {}),
35
+ askedAt: toIsoRequired(row.asked_at),
36
+ timeoutMs: row.timeout_ms ?? 0,
37
+ ...(row.turn_id ? { turnId: row.turn_id } : {}),
38
+ ...(row.principal ? { principal: row.principal } : {}),
39
+ };
40
+ }
41
+ /** Порт ожиданий подтверждения прав поверх таблицы `pending_approvals`. */
42
+ export class PgPendingApprovalRepository {
43
+ _deps;
44
+ constructor(_deps) {
45
+ this._deps = _deps;
46
+ }
47
+ async save(record) {
48
+ await this._deps.connection.query(`INSERT INTO pending_approvals
49
+ (approval_id, session_id, owner_id, tool_name, arguments, reason, trigger,
50
+ asked_at, timeout_ms, turn_id, principal)
51
+ VALUES ($1, $2, $3, $4, $5::jsonb, $6, $7::jsonb, $8::timestamptz, $9, $10, $11)
52
+ ON CONFLICT (approval_id) DO UPDATE SET
53
+ session_id = EXCLUDED.session_id,
54
+ owner_id = EXCLUDED.owner_id,
55
+ tool_name = EXCLUDED.tool_name,
56
+ arguments = EXCLUDED.arguments,
57
+ reason = EXCLUDED.reason,
58
+ trigger = EXCLUDED.trigger,
59
+ asked_at = EXCLUDED.asked_at,
60
+ timeout_ms = EXCLUDED.timeout_ms,
61
+ turn_id = EXCLUDED.turn_id,
62
+ principal = EXCLUDED.principal`, [
63
+ record.approvalId,
64
+ record.sessionId,
65
+ record.ownerId ?? null,
66
+ record.toolName,
67
+ jsonbParam(record.arguments ?? {}),
68
+ record.reason ?? '',
69
+ record.trigger ? jsonbParam(record.trigger) : null,
70
+ record.askedAt,
71
+ record.timeoutMs ?? 0,
72
+ record.turnId ?? null,
73
+ record.principal ?? null,
74
+ ]);
75
+ }
76
+ async delete(approvalId) {
77
+ await this._deps.connection.query('DELETE FROM pending_approvals WHERE approval_id = $1', [approvalId]);
78
+ }
79
+ async list(sessionId) {
80
+ const params = [];
81
+ let sql = 'SELECT * FROM pending_approvals';
82
+ if (sessionId !== undefined) {
83
+ params.push(sessionId);
84
+ sql += ` WHERE session_id = $${params.length}`;
85
+ }
86
+ // Порядок — «сначала опубликованные» (asked_at возраст., тайбрейкер id).
87
+ sql += ' ORDER BY asked_at ASC, approval_id ASC';
88
+ const rows = await this._deps.connection.query(sql, params);
89
+ return rows.map(toRecord);
90
+ }
91
+ async clear(sessionId) {
92
+ const params = [];
93
+ let sql = 'DELETE FROM pending_approvals';
94
+ if (sessionId !== undefined) {
95
+ params.push(sessionId);
96
+ sql += ` WHERE session_id = $${params.length}`;
97
+ }
98
+ sql += ' RETURNING approval_id';
99
+ const rows = await this._deps.connection.query(sql, params);
100
+ return rows.length;
101
+ }
102
+ }
103
+ /** Собрать порт ожиданий подтверждения прав (ADR-029). */
104
+ export function buildPendingApprovalPorts(deps) {
105
+ return {
106
+ pendingApprovals: new PgPendingApprovalRepository(deps),
107
+ };
108
+ }
@@ -30,6 +30,7 @@ const SECTION_KEYS = [
30
30
  'skillsDisabled',
31
31
  'skillsDisabledForNewProjects',
32
32
  'skillsPolicy',
33
+ 'skillsTrustedProjectDirs',
33
34
  'mcpNetworkPolicy',
34
35
  'egress',
35
36
  'defaultAgent',
@@ -40,6 +41,7 @@ const SECTION_KEYS = [
40
41
  'proxy',
41
42
  'plugins',
42
43
  'attachments',
44
+ 'sessionOpsPerMinute',
43
45
  ];
44
46
  const SECTION_KEY_SET = new Set(SECTION_KEYS);
45
47
  /** Собрать порт runtime-настроек поверх SQL. */
@@ -167,6 +169,15 @@ export function createPrincipalSettingsPort(conn) {
167
169
  async clearSkillsPolicy() {
168
170
  await deleteSetting(conn, 'skillsPolicy');
169
171
  },
172
+ async getSkillsTrustedProjectDirs() {
173
+ return readSetting(conn, 'skillsTrustedProjectDirs');
174
+ },
175
+ async setSkillsTrustedProjectDirs(dirs) {
176
+ await writeSetting(conn, 'skillsTrustedProjectDirs', dirs);
177
+ },
178
+ async clearSkillsTrustedProjectDirs() {
179
+ await deleteSetting(conn, 'skillsTrustedProjectDirs');
180
+ },
170
181
  async getTokenRatio(model) {
171
182
  const rows = await conn.query('SELECT ratio FROM token_ratios WHERE model = $1', [model]);
172
183
  return rows[0]?.ratio;
@@ -264,6 +275,16 @@ export function createPrincipalSettingsPort(conn) {
264
275
  async clearMetrics() {
265
276
  await deleteSetting(conn, 'metrics');
266
277
  },
278
+ // ADR-133: runtime-тумблер автоматической проверки обновлений.
279
+ async getUpdates() {
280
+ return (await readSetting(conn, 'updates')) ?? {};
281
+ },
282
+ async setUpdates(config) {
283
+ await writeSetting(conn, 'updates', config);
284
+ },
285
+ async clearUpdates() {
286
+ await deleteSetting(conn, 'updates');
287
+ },
267
288
  async getPlugins() {
268
289
  return (await readSetting(conn, 'plugins')) ?? {};
269
290
  },
@@ -309,6 +330,15 @@ export function createPrincipalSettingsPort(conn) {
309
330
  async clearSubagentMaxInputTokens() {
310
331
  await deleteSetting(conn, 'subagentMaxInputTokens');
311
332
  },
333
+ async getSessionOpsPerMinute() {
334
+ return readSetting(conn, 'sessionOpsPerMinute');
335
+ },
336
+ async setSessionOpsPerMinute(value) {
337
+ await writeSetting(conn, 'sessionOpsPerMinute', value);
338
+ },
339
+ async clearSessionOpsPerMinute() {
340
+ await deleteSetting(conn, 'sessionOpsPerMinute');
341
+ },
312
342
  async getContextDefaults() {
313
343
  return readSetting(conn, 'contextDefaults');
314
344
  },
@@ -327,5 +357,15 @@ export function createPrincipalSettingsPort(conn) {
327
357
  async clearStickyNotesLimits() {
328
358
  await deleteSetting(conn, 'stickyNotesLimits');
329
359
  },
360
+ // PROP-124: режим инстанса для SSH-ключей (`ssh.mode`).
361
+ async getSshMode() {
362
+ return readSetting(conn, 'sshMode');
363
+ },
364
+ async setSshMode(mode) {
365
+ await writeSetting(conn, 'sshMode', mode);
366
+ },
367
+ async clearSshMode() {
368
+ await deleteSetting(conn, 'sshMode');
369
+ },
330
370
  };
331
371
  }
@@ -35,6 +35,12 @@ export interface SessionRow {
35
35
  user_id: string | null;
36
36
  owner_id: string | null;
37
37
  project_id: string | null;
38
+ /**
39
+ * Маркер источника при переносе между инстансами (`Session.sourceSessionId`),
40
+ * ключ дедупликации повторного импорта (миграция `033`). В записях, созданных
41
+ * до миграции, поля нет — чтение даёт `undefined`.
42
+ */
43
+ source_session_id?: string | null;
38
44
  /**
39
45
  * ADR-114: привязка сессии к worktree (jsonb). В записях, созданных до
40
46
  * миграции `023`, поля нет — чтение даёт `undefined`.
@@ -226,6 +232,8 @@ export declare function toIsoOrUndefined(value: unknown): string | undefined;
226
232
  export declare function toNumber(value: unknown, fallback?: number): number;
227
233
  /** Необязательное число (nullable-колонка). */
228
234
  export declare function toNumberOrUndefined(value: unknown): number | undefined;
235
+ /** Статус сообщения из колонки `status` (неизвестное значение → `undefined`). */
236
+ export declare function toMessageStatus(value: unknown): Message['status'];
229
237
  /** Сообщение → форма хранения (дословно `serializeMessage` файловой реализации). */
230
238
  export declare function serializeMessage(msg: Message): SerializedMessage;
231
239
  /**
@@ -78,7 +78,7 @@ function deserializePart(data) {
78
78
  */
79
79
  const MESSAGE_STATUSES = ['streaming', 'completed', 'cancelled', 'error'];
80
80
  /** Статус сообщения из колонки `status` (неизвестное значение → `undefined`). */
81
- function toMessageStatus(value) {
81
+ export function toMessageStatus(value) {
82
82
  return typeof value === 'string' && MESSAGE_STATUSES.includes(value)
83
83
  ? value
84
84
  : undefined;
@@ -280,6 +280,8 @@ export function serializeSession(session) {
280
280
  user_id: session.userId ?? null,
281
281
  owner_id: session.ownerId ?? null,
282
282
  project_id: session.projectId ?? null,
283
+ // Маркер источника переноса (ключ дедупликации повторного импорта).
284
+ source_session_id: session.sourceSessionId ?? null,
283
285
  // ADR-114: привязка к worktree (объект в snake_case — как в JSON-файле).
284
286
  worktree: session.worktree
285
287
  ? {
@@ -486,6 +488,8 @@ export function deserializeSession(row, children) {
486
488
  userId: row.user_id ?? undefined,
487
489
  ownerId: row.owner_id ?? undefined,
488
490
  projectId: row.project_id ?? undefined,
491
+ // Маркер источника переноса (legacy-записи без поля → undefined).
492
+ ...(row.source_session_id ? { sourceSessionId: row.source_session_id } : {}),
489
493
  // ADR-114: привязка к worktree (legacy-записи без поля → undefined).
490
494
  ...(worktree ? { worktree } : {}),
491
495
  messages: children.messages.map(deserializeMessage),
@@ -68,7 +68,7 @@ export type SessionPorts = Pick<StorageContext, 'sessions'>;
68
68
  * тест проверяет, что новая колонка (`worktree`, ADR-114) реально попадает в
69
69
  * `INSERT` и читается обратно.
70
70
  */
71
- export declare const SESSION_FIELDS: readonly ["id", "title", "icon", "color", "session_origin", "parent_id", "branch_point", "plan_approved", "mode", "mode_by_principal", "user_id", "owner_id", "project_id", "worktree", "todos", "prompt_states", "obfuscation_map", "status", "settings", "mcp_servers", "pending_messages", "steer_inbox", "current_stream", "retry", "summarization_pending", "can_summarize", "created_at", "updated_at", "expires_at", "archived_at", "input_tokens", "output_tokens", "total_tokens", "cache_read_tokens", "cache_write_tokens", "reasoning_tokens", "input_cost", "output_cost", "cache_read_cost", "cache_write_cost", "cache_hit_rate"];
71
+ export declare const SESSION_FIELDS: readonly ["id", "title", "icon", "color", "session_origin", "parent_id", "branch_point", "plan_approved", "mode", "mode_by_principal", "user_id", "owner_id", "project_id", "source_session_id", "worktree", "todos", "prompt_states", "obfuscation_map", "status", "settings", "mcp_servers", "pending_messages", "steer_inbox", "current_stream", "retry", "summarization_pending", "can_summarize", "created_at", "updated_at", "expires_at", "archived_at", "input_tokens", "output_tokens", "total_tokens", "cache_read_tokens", "cache_write_tokens", "reasoning_tokens", "input_cost", "output_cost", "cache_read_cost", "cache_write_cost", "cache_hit_rate"];
72
72
  /** jsonb-колонки `sessions` (экспортируется для unit-тестов сериализации). */
73
73
  export declare const SESSION_JSON_FIELDS: ReadonlySet<string>;
74
74
  /** Колонки `messages` (порядок — как в `001_init`; `028` — reasoning-подпись). */
@@ -174,10 +174,12 @@ export declare class PostgresSessionRepository implements SessionRepository {
174
174
  */
175
175
  private _loadChildren;
176
176
  /**
177
- * `message_uid` цели `updateMessage`: сначала по `seq` (при legacy-дублях —
178
- * первая по `seq, created_at, id`), затем fallback по доменному `id`.
177
+ * Цель `updateMessage`: `message_uid` строки + её текущий `status`
178
+ * (ADR-118 §5 — для проверки «поздняя запись черновика поверх закрытого
179
+ * шага»). Сначала по `seq` (при legacy-дублях — первая по
180
+ * `seq, created_at, id`), затем fallback по доменному `id`.
179
181
  */
180
- private _findMessageUid;
182
+ private _findMessageTarget;
181
183
  /** ADR-097: per-session сериализация записи — транзакционный advisory-лок. */
182
184
  private _lockSession;
183
185
  /** `addReference`/`removeReference` отсутствующей сессии → ошибка (как в file/memory). */
@@ -57,7 +57,7 @@
57
57
  */
58
58
  import { jsonbParam } from '../json-param.js';
59
59
  import { generateId, makeTextPart, nowISO } from '@itphx/synth-shared';
60
- import { checkpointRow, deserializeMessage, deserializeReference, deserializeSession, deserializeSessionLight, deserializeSessionMeta, emptySessionChildren, messageRow, referenceRow, serializeSession, stickyNoteRow, } from './sessions-mapping.js';
60
+ import { checkpointRow, deserializeMessage, deserializeReference, deserializeSession, deserializeSessionLight, deserializeSessionMeta, emptySessionChildren, messageRow, referenceRow, serializeSession, stickyNoteRow, toMessageStatus, } from './sessions-mapping.js';
61
61
  /**
62
62
  * Колонки `sessions` (порядок — как в `001_init`).
63
63
  *
@@ -79,6 +79,8 @@ export const SESSION_FIELDS = [
79
79
  'user_id',
80
80
  'owner_id',
81
81
  'project_id',
82
+ // Маркер источника переноса — ключ дедупликации повторного импорта (миграция 033).
83
+ 'source_session_id',
82
84
  // ADR-114: привязка сессии к worktree (jsonb, миграция 023).
83
85
  'worktree',
84
86
  'todos',
@@ -202,6 +204,36 @@ function prepareMessage(message) {
202
204
  createdAt: message.createdAt || nowISO(),
203
205
  };
204
206
  }
207
+ /**
208
+ * ADR-118 §5: запись черновика частичного стрима — статус `streaming` либо
209
+ * `metadata.streaming === true`.
210
+ *
211
+ * **Паритет с портом**: источник истины — `isDraftMessageWrite` в
212
+ * `packages/core/src/storage/message-write.ts` (file/memory используют его
213
+ * напрямую). Драйвер не тянет core рантаймом (только `import type`,
214
+ * ADR-097), поэтому предикат продублирован здесь — при правке синхронизируйте
215
+ * оба места.
216
+ */
217
+ function isDraftMessageWrite(message) {
218
+ return message.status === 'streaming' || message.metadata?.streaming === true;
219
+ }
220
+ /**
221
+ * ADR-118 §5: поздняя запись черновика поверх **закрытого** сообщения
222
+ * (терминальный статус `completed`/`cancelled`/`error`). Такая запись
223
+ * игнорируется целиком — иначе черновик откатит шаг в `streaming` и затрёт
224
+ * финальный текст.
225
+ *
226
+ * Паритет с `isStaleDraftWrite`/`isTerminalMessageStatus` из
227
+ * `packages/core/src/storage/message-write.ts` (см. комментарий выше).
228
+ * `target` принимает частичную запись (драйверу достаточно `status` из
229
+ * `SELECT`), поэтому тип — `{ status }`, а не полный `Message`.
230
+ */
231
+ function isStaleDraftWrite(target, incoming) {
232
+ const terminal = target.status === 'completed'
233
+ || target.status === 'cancelled'
234
+ || target.status === 'error';
235
+ return terminal && isDraftMessageWrite(incoming);
236
+ }
205
237
  /**
206
238
  * ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
207
239
  * сессии (выдаётся при материализации, ранее выданные значения не
@@ -414,10 +446,17 @@ export class PostgresSessionRepository {
414
446
  const setSql = setClauses.join(', ');
415
447
  return this._connection.withTransaction(async (tx) => {
416
448
  await this._lockSession(tx, sessionId);
417
- const messageUid = await this._findMessageUid(tx, sessionId, prepared);
418
- if (!messageUid)
449
+ const target = await this._findMessageTarget(tx, sessionId, prepared);
450
+ if (!target)
419
451
  return null;
420
- const updated = await tx.query(`UPDATE messages SET ${setSql} WHERE message_uid = $${params.length + 1} RETURNING *`, [...params, messageUid]);
452
+ // ADR-118 §5: поздняя запись черновика не «воскрешает» закрытый шаг —
453
+ // ни строки, ни `sessions.updated_at` не трогаем, отдаём текущую запись.
454
+ if (isStaleDraftWrite(target, prepared)) {
455
+ const current = await tx.query('SELECT * FROM messages WHERE message_uid = $1', [target.uid]);
456
+ const currentRow = current[0];
457
+ return currentRow ? deserializeMessage(currentRow) : null;
458
+ }
459
+ const updated = await tx.query(`UPDATE messages SET ${setSql} WHERE message_uid = $${params.length + 1} RETURNING *`, [...params, target.uid]);
421
460
  await tx.query('UPDATE sessions SET updated_at = now() WHERE id = $1', [sessionId]);
422
461
  const updatedRow = updated[0];
423
462
  return updatedRow ? deserializeMessage(updatedRow) : null;
@@ -541,21 +580,23 @@ export class PostgresSessionRepository {
541
580
  return buckets;
542
581
  }
543
582
  /**
544
- * `message_uid` цели `updateMessage`: сначала по `seq` (при legacy-дублях —
545
- * первая по `seq, created_at, id`), затем fallback по доменному `id`.
583
+ * Цель `updateMessage`: `message_uid` строки + её текущий `status`
584
+ * (ADR-118 §5 — для проверки «поздняя запись черновика поверх закрытого
585
+ * шага»). Сначала по `seq` (при legacy-дублях — первая по
586
+ * `seq, created_at, id`), затем fallback по доменному `id`.
546
587
  */
547
- async _findMessageUid(tx, sessionId, message) {
588
+ async _findMessageTarget(tx, sessionId, message) {
548
589
  if (Number.isFinite(message.seq)) {
549
- const rows = await tx.query('SELECT message_uid FROM messages WHERE session_id = $1 AND seq = $2 '
590
+ const rows = await tx.query('SELECT message_uid, status FROM messages WHERE session_id = $1 AND seq = $2 '
550
591
  + 'ORDER BY seq, created_at, id LIMIT 1', [sessionId, message.seq]);
551
592
  if (rows[0])
552
- return rows[0].message_uid;
593
+ return { uid: rows[0].message_uid, status: toMessageStatus(rows[0].status) ?? null };
553
594
  }
554
595
  if (message.id) {
555
- const rows = await tx.query('SELECT message_uid FROM messages WHERE session_id = $1 AND id = $2 '
596
+ const rows = await tx.query('SELECT message_uid, status FROM messages WHERE session_id = $1 AND id = $2 '
556
597
  + 'ORDER BY seq, created_at, id LIMIT 1', [sessionId, message.id]);
557
598
  if (rows[0])
558
- return rows[0].message_uid;
599
+ return { uid: rows[0].message_uid, status: toMessageStatus(rows[0].status) ?? null };
559
600
  }
560
601
  return null;
561
602
  }
@@ -1,5 +1,5 @@
1
1
  /**
2
- * PG-реализация порта **инвентаря git-worktree'ов** (ADR-114, ADR-097).
2
+ * PG-реализация порта **инвентаря git-worktree** (ADR-114, ADR-097).
3
3
  *
4
4
  * Хранение — **существующий** generic-слой `documents(kind, key, value jsonb)`
5
5
  * (миграция `001-init`): `kind = 'worktree'`, ключ документа — `id` записи,
@@ -25,7 +25,7 @@ import type { WorktreeRecord } from '@itphx/synth-shared';
25
25
  import type { PortDeps } from './deps.js';
26
26
  /** Часть `StorageContext`, которой владеет группа «worktrees». */
27
27
  export type WorktreePorts = Pick<StorageContext, 'worktrees'>;
28
- /** Порт инвентаря worktree'ов поверх таблицы `documents`. */
28
+ /** Порт инвентаря worktree поверх таблицы `documents`. */
29
29
  export declare class PgWorktreeRepository implements WorktreeRepository {
30
30
  private readonly _deps;
31
31
  constructor(_deps: PortDeps);
@@ -37,5 +37,5 @@ export declare class PgWorktreeRepository implements WorktreeRepository {
37
37
  delete(id: string): Promise<void>;
38
38
  deleteByProject(projectId: string): Promise<number>;
39
39
  }
40
- /** Собрать порт инвентаря worktree'ов (ADR-114). */
40
+ /** Собрать порт инвентаря worktree (ADR-114). */
41
41
  export declare function buildWorktreePorts(deps: PortDeps): WorktreePorts;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * PG-реализация порта **инвентаря git-worktree'ов** (ADR-114, ADR-097).
2
+ * PG-реализация порта **инвентаря git-worktree** (ADR-114, ADR-097).
3
3
  *
4
4
  * Хранение — **существующий** generic-слой `documents(kind, key, value jsonb)`
5
5
  * (миграция `001-init`): `kind = 'worktree'`, ключ документа — `id` записи,
@@ -23,7 +23,7 @@
23
23
  import { jsonbParam } from '../json-param.js';
24
24
  /** `kind` generic-таблицы `documents` для записей worktree. */
25
25
  const WORKTREE_KIND = 'worktree';
26
- /** Порт инвентаря worktree'ов поверх таблицы `documents`. */
26
+ /** Порт инвентаря worktree поверх таблицы `documents`. */
27
27
  export class PgWorktreeRepository {
28
28
  _deps;
29
29
  constructor(_deps) {
@@ -77,7 +77,7 @@ function byCreatedAtDesc(a, b) {
77
77
  return diff;
78
78
  return a.id.localeCompare(b.id);
79
79
  }
80
- /** Собрать порт инвентаря worktree'ов (ADR-114). */
80
+ /** Собрать порт инвентаря worktree (ADR-114). */
81
81
  export function buildWorktreePorts(deps) {
82
82
  return {
83
83
  worktrees: new PgWorktreeRepository(deps),
@@ -25,7 +25,7 @@
25
25
  * - `buildBackgroundRunPorts(deps)` → `backgroundRuns` (этап 1 roadmap 0.13,
26
26
  * блок 1.2 — фоновые саб-агенты и шелл-процессы);
27
27
  * - `buildWorktreePorts(deps)` → `worktrees` (ADR-114 — инвентарь
28
- * git-worktree'ов; generic-таблица `documents`, `kind='worktree'`).
28
+ * git-worktree; generic-таблица `documents`, `kind='worktree'`).
29
29
  * - `buildBlobRefPorts(deps)` → `blobRefs` (ADR-115/ADR-116 — учёт ссылок
30
30
  * на объекты blob-хранилища; таблица `blob_refs`).
31
31
  * - `buildPackPorts(deps)` → `packs` (ADR-086 §5 — реестр установок
@@ -25,7 +25,7 @@
25
25
  * - `buildBackgroundRunPorts(deps)` → `backgroundRuns` (этап 1 roadmap 0.13,
26
26
  * блок 1.2 — фоновые саб-агенты и шелл-процессы);
27
27
  * - `buildWorktreePorts(deps)` → `worktrees` (ADR-114 — инвентарь
28
- * git-worktree'ов; generic-таблица `documents`, `kind='worktree'`).
28
+ * git-worktree; generic-таблица `documents`, `kind='worktree'`).
29
29
  * - `buildBlobRefPorts(deps)` → `blobRefs` (ADR-115/ADR-116 — учёт ссылок
30
30
  * на объекты blob-хранилища; таблица `blob_refs`).
31
31
  * - `buildPackPorts(deps)` → `packs` (ADR-086 §5 — реестр установок
@@ -84,6 +84,9 @@ import { buildContextFilePorts } from './ports/context-files.js';
84
84
  import { buildQuestionPorts } from './ports/questions.js';
85
85
  import { buildBackgroundRunPorts } from './ports/background-runs.js';
86
86
  import { buildWorktreePorts } from './ports/worktrees.js';
87
+ // ADR-029: ожидания подтверждения прав — отдельный стор (таблица
88
+ // `pending_approvals`, миграция 035), а не поле документа сессии.
89
+ import { buildPendingApprovalPorts } from './ports/pending-approvals.js';
87
90
  // ADR-115/ADR-116: учёт ссылок на объекты blob-хранилища (таблица `blob_refs`).
88
91
  import { buildBlobRefPorts } from './ports/blob-refs.js';
89
92
  import { buildPluginLockPorts } from './ports/plugin-lock.js';
@@ -208,9 +211,12 @@ export function buildPostgresStorageContext(opts) {
208
211
  // реестр фоновых прогонов (таблица `background_runs`) — миграция 021.
209
212
  ...buildQuestionPorts(deps),
210
213
  ...buildBackgroundRunPorts(deps),
211
- // ADR-114: инвентарь git-worktree'ов — generic-таблица `documents`
214
+ // ADR-114: инвентарь git-worktree — generic-таблица `documents`
212
215
  // (`kind='worktree'`), без новой миграции.
213
216
  ...buildWorktreePorts(deps),
217
+ // ADR-029: ожидания подтверждения прав — отдельная таблица
218
+ // `pending_approvals` (миграция 035); документ сессии не трогаем.
219
+ ...buildPendingApprovalPorts(deps),
214
220
  // ADR-115/ADR-116: учёт ссылок на объекты blob-хранилища — таблица
215
221
  // `blob_refs` (миграция 024). Байты объектов остаются на томе (`blobs`).
216
222
  ...buildBlobRefPorts(deps),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-storage-postgres",
3
- "version": "0.13.4",
3
+ "version": "0.13.8",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -15,13 +15,13 @@
15
15
  }
16
16
  },
17
17
  "dependencies": {
18
- "@itphx/synth-shared": "0.13.4"
18
+ "@itphx/synth-shared": "0.13.8"
19
19
  },
20
20
  "peerDependencies": {
21
- "@itphx/synth-core": "0.13.4"
21
+ "@itphx/synth-core": "0.13.8"
22
22
  },
23
23
  "devDependencies": {
24
- "@itphx/synth-core": "0.13.4",
24
+ "@itphx/synth-core": "0.13.8",
25
25
  "@types/node": "^22.0.0",
26
26
  "@types/pg": "^8.15.0",
27
27
  "typescript": "^5.8.0"
@@ -35,7 +35,7 @@
35
35
  "scripts": {
36
36
  "build": "rm -rf dist && tsc -p tsconfig.build.json",
37
37
  "typecheck": "tsc --noEmit",
38
- "lint": "eslint src/",
38
+ "lint": "eslint src/ --max-warnings 0",
39
39
  "test": "vitest run",
40
40
  "test:watch": "vitest",
41
41
  "clean": "rm -rf dist"