@itphx/synth-storage-postgres 0.12.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.
Files changed (33) hide show
  1. package/dist/migrations/028-message-reasoning-signature.d.ts +13 -0
  2. package/dist/migrations/028-message-reasoning-signature.js +19 -0
  3. package/dist/migrations/029-message-stream-v2.d.ts +22 -0
  4. package/dist/migrations/029-message-stream-v2.js +33 -0
  5. package/dist/migrations/030-session-retry.d.ts +12 -0
  6. package/dist/migrations/030-session-retry.js +16 -0
  7. package/dist/migrations/031-ssh-key-policy.d.ts +13 -0
  8. package/dist/migrations/031-ssh-key-policy.js +25 -0
  9. package/dist/migrations/032-mcp-remote-mode.d.ts +14 -0
  10. package/dist/migrations/032-mcp-remote-mode.js +18 -0
  11. package/dist/migrations/033-session-source-id.d.ts +16 -0
  12. package/dist/migrations/033-session-source-id.js +21 -0
  13. package/dist/migrations/034-pending-approvals.d.ts +18 -0
  14. package/dist/migrations/034-pending-approvals.js +35 -0
  15. package/dist/migrations/index.js +14 -0
  16. package/dist/ports/content.js +80 -9
  17. package/dist/ports/context-files.d.ts +3 -0
  18. package/dist/ports/context-files.js +9 -0
  19. package/dist/ports/events-scheduler.js +19 -11
  20. package/dist/ports/pending-approvals.d.ts +32 -0
  21. package/dist/ports/pending-approvals.js +108 -0
  22. package/dist/ports/principals-defaults.js +20 -0
  23. package/dist/ports/principals-projects.js +80 -48
  24. package/dist/ports/principals-settings.js +76 -0
  25. package/dist/ports/sessions-mapping.d.ts +70 -5
  26. package/dist/ports/sessions-mapping.js +124 -7
  27. package/dist/ports/sessions.d.ts +56 -10
  28. package/dist/ports/sessions.js +127 -25
  29. package/dist/ports/worktrees.d.ts +3 -3
  30. package/dist/ports/worktrees.js +3 -3
  31. package/dist/storage-context.d.ts +1 -1
  32. package/dist/storage-context.js +8 -2
  33. package/package.json +5 -5
@@ -54,18 +54,47 @@ export function toNumberOrUndefined(value) {
54
54
  return Number.isFinite(num) ? num : undefined;
55
55
  }
56
56
  function serializePart(part) {
57
- return { id: part.id, type: part.type, data: part.data };
57
+ return {
58
+ id: part.id,
59
+ type: part.type,
60
+ data: part.data,
61
+ // Anthropic thinking: подпись блока/redacted — аддитивное поле части.
62
+ ...(part.metadata ? { metadata: part.metadata } : {}),
63
+ };
58
64
  }
59
65
  function deserializePart(data) {
60
- return { id: data.id, type: data.type, data: data.data };
66
+ return {
67
+ id: data.id,
68
+ type: data.type,
69
+ data: data.data,
70
+ ...(data.metadata ? { metadata: data.metadata } : {}),
71
+ };
61
72
  }
62
73
  // ── Сообщения ───────────────────────────────────────────────────────────────
74
+ /**
75
+ * ADR-118 §5: допустимые статусы сообщения-хода. Значение приходит из
76
+ * колонки `status` (text) — неизвестное значение читается как «нет статуса»
77
+ * (fail-soft: мусор в БД не должен ломать чтение сообщения).
78
+ */
79
+ const MESSAGE_STATUSES = ['streaming', 'completed', 'cancelled', 'error'];
80
+ /** Статус сообщения из колонки `status` (неизвестное значение → `undefined`). */
81
+ export function toMessageStatus(value) {
82
+ return typeof value === 'string' && MESSAGE_STATUSES.includes(value)
83
+ ? value
84
+ : undefined;
85
+ }
63
86
  /** Сообщение → форма хранения (дословно `serializeMessage` файловой реализации). */
64
87
  export function serializeMessage(msg) {
65
88
  return {
66
89
  id: msg.id,
67
90
  role: msg.role,
68
91
  seq: msg.seq,
92
+ // ADR-118: порядок записи (`ord`) — монотонный, не перенумеровывается;
93
+ // ход (`turn_id`), шаг (`step_index`) и статус — аддитивные поля.
94
+ ord: msg.ord,
95
+ turn_id: msg.turnId,
96
+ step_index: msg.stepIndex,
97
+ status: msg.status,
69
98
  origin: msg.origin,
70
99
  source_msg_id: msg.sourceMsgId,
71
100
  parts: (msg.parts ?? []).map(serializePart),
@@ -92,6 +121,10 @@ export function serializeMessage(msg) {
92
121
  }
93
122
  : undefined,
94
123
  reasoning: msg.reasoning,
124
+ // Anthropic: подпись thinking-блока и opaque `redacted_thinking` —
125
+ // колонки `reasoning_signature`/`reasoning_redacted` (миграция `028`).
126
+ reasoning_signature: msg.reasoningSignature,
127
+ reasoning_redacted: msg.reasoningRedacted,
95
128
  source: msg.source,
96
129
  author: msg.author,
97
130
  agent_role: msg.agentRole,
@@ -165,12 +198,23 @@ export function deserializeMessage(row) {
165
198
  });
166
199
  }
167
200
  }
168
- const content = buildContentFromParts(parts);
201
+ // Reasoning-части — служебные данные протокола (подпись thinking-блока), а не
202
+ // текст сообщения: в `content` они не попадают (legacy-ветка без `parts`
203
+ // сохраняет прежнее восстановление content из reasoning).
204
+ const content = hasParts
205
+ ? buildContentFromParts(parts.filter((part) => part.type !== 'reasoning'))
206
+ : buildContentFromParts(parts);
169
207
  const usage = row.usage;
170
208
  return {
171
209
  id: row.id || generateId(),
172
210
  role: row.role,
173
211
  seq: row.seq ?? 0,
212
+ // ADR-118: порядок записи/ход/шаг/статус — аддитивные поля (legacy-строки
213
+ // без колонок читаются как `undefined`).
214
+ ord: toNumberOrUndefined(row.ord),
215
+ turnId: row.turn_id ?? undefined,
216
+ stepIndex: toNumberOrUndefined(row.step_index),
217
+ status: toMessageStatus(row.status),
174
218
  origin: (row.origin || 'local'),
175
219
  sourceMsgId: row.source_msg_id ?? undefined,
176
220
  parts,
@@ -197,6 +241,13 @@ export function deserializeMessage(row) {
197
241
  }
198
242
  : undefined,
199
243
  reasoning: row.reasoning ?? undefined,
244
+ // Anthropic: подпись thinking-блока и opaque `redacted_thinking` (legacy
245
+ // строки без колонок читаются как `undefined`). `reasoning`-часть выше
246
+ // восстанавливается из `row.reasoning` как и раньше.
247
+ reasoningSignature: row.reasoning_signature ?? undefined,
248
+ reasoningRedacted: Array.isArray(row.reasoning_redacted)
249
+ ? row.reasoning_redacted
250
+ : undefined,
200
251
  source: (row.source ?? undefined),
201
252
  author: row.author ?? undefined,
202
253
  agentRole: row.agent_role ?? undefined,
@@ -229,6 +280,8 @@ export function serializeSession(session) {
229
280
  user_id: session.userId ?? null,
230
281
  owner_id: session.ownerId ?? null,
231
282
  project_id: session.projectId ?? null,
283
+ // Маркер источника переноса (ключ дедупликации повторного импорта).
284
+ source_session_id: session.sourceSessionId ?? null,
232
285
  // ADR-114: привязка к worktree (объект в snake_case — как в JSON-файле).
233
286
  worktree: session.worktree
234
287
  ? {
@@ -254,6 +307,23 @@ export function serializeSession(session) {
254
307
  agent_role: session.currentStream.agentRole,
255
308
  started_at: session.currentStream.startedAt,
256
309
  cancelled: session.currentStream.cancelled,
310
+ // ADR-118 §10: метка хода живого стрима — без неё теряется при
311
+ // перечитывании сессии из БД (`current_stream.turn_id` в DTO).
312
+ turn_id: session.currentStream.turnId ?? null,
313
+ // Владелец маркера хода (процесс инстанса): по нему рестарт отличает
314
+ // живой ход от маркера убитого процесса.
315
+ ...(session.currentStream.owner ? { owner: session.currentStream.owner } : {}),
316
+ }
317
+ : null,
318
+ // Персистентное состояние ретрая (переживает reload/restart): snake_case —
319
+ // как в JSON-файловом backend.
320
+ retry: session.retry
321
+ ? {
322
+ stream_id: session.retry.streamId,
323
+ attempt: session.retry.attempt,
324
+ max_retries: session.retry.maxRetries,
325
+ retry_at: session.retry.retryAt,
326
+ ...(session.retry.error ? { error: session.retry.error } : {}),
257
327
  }
258
328
  : null,
259
329
  summarization_pending: session.summarizationPending ?? false,
@@ -365,6 +435,29 @@ export function deserializeSessionWorktree(data) {
365
435
  branch: typeof raw.branch === 'string' ? raw.branch : '',
366
436
  };
367
437
  }
438
+ /**
439
+ * Значение `sessions.retry` → доменное состояние ретрая.
440
+ *
441
+ * Форма хранения — snake_case (`stream_id`/`attempt`/`max_retries`/`retry_at`/
442
+ * `error`), как в JSON-файловом backend. Legacy-записи (без поля) и битые
443
+ * значения читаются как «ретрая нет» (`undefined`).
444
+ */
445
+ export function deserializeSessionRetry(data) {
446
+ if (typeof data !== 'object' || data === null)
447
+ return undefined;
448
+ const raw = data;
449
+ const streamId = typeof raw.stream_id === 'string' ? raw.stream_id : '';
450
+ const retryAt = typeof raw.retry_at === 'string' ? raw.retry_at : '';
451
+ if (!streamId || !retryAt)
452
+ return undefined;
453
+ return {
454
+ streamId,
455
+ attempt: typeof raw.attempt === 'number' ? raw.attempt : 0,
456
+ maxRetries: typeof raw.max_retries === 'number' ? raw.max_retries : 0,
457
+ retryAt,
458
+ ...(typeof raw.error === 'string' && raw.error ? { error: raw.error } : {}),
459
+ };
460
+ }
368
461
  /**
369
462
  * Строка `sessions` + child-данные → доменная сессия: дословный
370
463
  * `deserializeSession` файловой реализации (нормализация иконки/цвета,
@@ -395,6 +488,8 @@ export function deserializeSession(row, children) {
395
488
  userId: row.user_id ?? undefined,
396
489
  ownerId: row.owner_id ?? undefined,
397
490
  projectId: row.project_id ?? undefined,
491
+ // Маркер источника переноса (legacy-записи без поля → undefined).
492
+ ...(row.source_session_id ? { sourceSessionId: row.source_session_id } : {}),
398
493
  // ADR-114: привязка к worktree (legacy-записи без поля → undefined).
399
494
  ...(worktree ? { worktree } : {}),
400
495
  messages: children.messages.map(deserializeMessage),
@@ -413,8 +508,13 @@ export function deserializeSession(row, children) {
413
508
  agentRole: currentStream.agent_role,
414
509
  startedAt: currentStream.started_at,
415
510
  cancelled: currentStream.cancelled,
511
+ // ADR-118 §10: метка хода живого стрима (legacy-сессии — нет).
512
+ turnId: currentStream.turn_id ?? undefined,
513
+ owner: currentStream.owner ?? undefined,
416
514
  }
417
515
  : undefined,
516
+ // Персистентное состояние ретрая (legacy-записи без поля → undefined).
517
+ retry: deserializeSessionRetry(row.retry),
418
518
  summarizationPending: row.summarization_pending ?? false,
419
519
  canSummarize: row.can_summarize ?? false,
420
520
  createdAt: toIso(row.created_at),
@@ -436,14 +536,31 @@ export function deserializeSession(row, children) {
436
536
  }
437
537
  /**
438
538
  * Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
439
- * ADR-097): `messages`/`pendingMessages`/`checkpoints` пусты, child-таблицы не
440
- * читаются. Метаданные (id/статус/settings/projectId/expiresAt/…) идентичны
441
- * `deserializeSession` — механика переиспользуется.
539
+ * ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
540
+ * сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
541
+ * истории не тянут, нужны recovery/автозапуску). Метаданные
542
+ * (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
543
+ * механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
442
544
  */
443
545
  export function deserializeSessionLight(row) {
444
546
  const session = deserializeSession(row, emptySessionChildren());
445
547
  session.messages = [];
446
- session.pendingMessages = [];
447
548
  session.checkpoints = [];
448
549
  return session;
449
550
  }
551
+ /**
552
+ * Строка `sessions` → доменная сессия **без истории и без очереди**
553
+ * (`SessionRepository.loadLight`, ADR-097): `messages`/`checkpoints` пусты и
554
+ * `pendingMessages`/`steerInbox` **тоже** — контракт порта (`loadLight`
555
+ * возвращает только атрибуты сессии, очередь нужна лишь recovery/автозапуску
556
+ * через `listLight`). Child-таблицы не читаются.
557
+ *
558
+ * Строится поверх `deserializeSessionLight` (та же метапроекция), поэтому
559
+ * остальные поля идентичны `deserializeSession`; отличается только очередь.
560
+ */
561
+ export function deserializeSessionMeta(row) {
562
+ const session = deserializeSessionLight(row);
563
+ session.pendingMessages = [];
564
+ session.steerInbox = [];
565
+ return session;
566
+ }
@@ -19,6 +19,14 @@
19
19
  * (у старых сессий у всех сообщений `seq = 0`) и делает порядок однозначным;
20
20
  * домен и так переставляет `seq = i+1` при ветвлении/merge — приведение к
21
21
  * позиции смысла не меняет;
22
+ * - ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
23
+ * (выдаётся портом при материализации: `MAX(ord)+1` по сессии, под тем же
24
+ * per-session advisory-локом). Ранее выданные значения **не
25
+ * перенумеровываются**: `save()` сохраняет `ord` сообщения как есть, а
26
+ * `updateMessage` пишет `ord = COALESCE(messages.ord, …)` (уже выданное
27
+ * значение сохраняется; ещё не выданное — legacy-строка — может его
28
+ * получить: так проставляет `ord` миграция данных ядра). Рядом живут
29
+ * аддитивные поля хода/шага/статуса (`turn_id`/`step_index`/`status`);
22
30
  * - `id` сообщения **не уникален** в пределах сессии (legacy-дубликаты):
23
31
  * PK `messages` — суррогатный `message_uid`, поэтому дубликаты `id`
24
32
  * сохраняются без потерь (upsert по `id` их молча схлопывал);
@@ -28,10 +36,13 @@
28
36
  * **полную** `Session`; сообщения/child-строки подгружаются **батчем**
29
37
  * (`WHERE session_id = ANY($1)`, без N+1); порядок сообщений — по `seq` с
30
38
  * тайбрейкером `created_at`, затем `id` (детерминированное чтение);
31
- * - `listLight` — метаданные без истории (`messages`/`pendingMessages`/
32
- * `checkpoints` пусты, child-таблицы не читаются): одна выборка из `sessions`
39
+ * - `listLight` — метаданные без истории (`messages`/`checkpoints` пусты,
40
+ * child-таблицы не читаются; очередь `pendingMessages`/`steerInbox` —
41
+ * jsonb-колонки самой `sessions` — сохраняется): одна выборка из `sessions`
33
42
  * тем же `WHERE`/порядком, что у `list`; `loadLight` — та же проекция по
34
- * одному id (одна выборка по PK);
43
+ * одному id (одна выборка по PK), но **без очереди** (`pendingMessages`/
44
+ * `steerInbox` пусты) — контракт порта: очередь нужна только recovery/
45
+ * автозапуску через `listLight`;
35
46
  * - `list`/`listForUser*` сортируют `updated_at DESC`; архивированные сессии
36
47
  * **не** отфильтровываются — это ответственность менеджера
37
48
  * (`SessionManager.listSessions`, как и у файловой/memory реализаций);
@@ -57,16 +68,38 @@ export type SessionPorts = Pick<StorageContext, 'sessions'>;
57
68
  * тест проверяет, что новая колонка (`worktree`, ADR-114) реально попадает в
58
69
  * `INSERT` и читается обратно.
59
70
  */
60
- 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", "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"];
61
72
  /** jsonb-колонки `sessions` (экспортируется для unit-тестов сериализации). */
62
73
  export declare const SESSION_JSON_FIELDS: ReadonlySet<string>;
74
+ /** Колонки `messages` (порядок — как в `001_init`; `028` — reasoning-подпись). */
75
+ export declare const MESSAGE_FIELDS: readonly ["id", "session_id", "seq", "ord", "role", "origin", "source_msg_id", "content", "parts", "tool_calls", "tool_call_id", "usage", "metadata", "prompt_meta", "debug_data", "summary_of", "model", "provider", "provider_type", "reasoning", "reasoning_signature", "reasoning_redacted", "source", "author", "agent_role", "qa_pass", "qa_reason", "disabled", "pinned", "hidden", "ephemeral", "turn_id", "step_index", "status", "created_at"];
76
+ export declare const MESSAGE_JSON_FIELDS: ReadonlySet<string>;
63
77
  /**
64
78
  * Колонки `messages`, которые заменяет `updateMessage`. Неизменяемые —
65
79
  * суррогатный `message_uid` (PK), доменный `id`, `session_id`, позиционный
66
80
  * `seq` и `created_at`: они сохраняются от исходной строки (цель ищется по
67
81
  * `seq`, fallback по `id`).
82
+ *
83
+ * ADR-118: `ord` — **не** перенумеровывается обновлением (он иммутабелен
84
+ * после выдачи), поэтому в общий список изменяемых колонок он не входит:
85
+ * `updateMessage` пишет его отдельной фразой `COALESCE(messages.ord, …)` —
86
+ * уже выданное значение сохраняется, а ещё не выданное (legacy-строка) может
87
+ * получить его (так проставляет `ord` миграция данных ядра).
88
+ */
89
+ export declare const MESSAGE_MUTABLE_FIELDS: ("origin" | "author" | "status" | "source" | "usage" | "model" | "provider" | "metadata" | "ephemeral" | "disabled" | "content" | "role" | "reasoning" | "pinned" | "hidden" | "agent_role" | "turn_id" | "source_msg_id" | "parts" | "tool_calls" | "tool_call_id" | "prompt_meta" | "debug_data" | "summary_of" | "provider_type" | "reasoning_signature" | "reasoning_redacted" | "qa_pass" | "qa_reason" | "step_index")[];
90
+ /**
91
+ * ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
92
+ * сессии (выдаётся при материализации, ранее выданные значения не
93
+ * перенумеровываются).
94
+ *
95
+ * Правило выдачи: уже проставленный вызывателем `ord` **не перетирается**
96
+ * (иначе порядок записей ездил бы); иначе берётся `max(ord)+1` по сессии —
97
+ * значение вычислено в той же транзакции (per-session advisory-лок), поэтому
98
+ * два параллельных append'а не получат один `ord`.
99
+ *
100
+ * Экспортируется для unit-тестов (живая БД не нужна).
68
101
  */
69
- export declare const MESSAGE_MUTABLE_FIELDS: ("origin" | "author" | "source" | "usage" | "model" | "provider" | "metadata" | "ephemeral" | "disabled" | "content" | "role" | "reasoning" | "pinned" | "hidden" | "agent_role" | "source_msg_id" | "parts" | "tool_calls" | "tool_call_id" | "prompt_meta" | "debug_data" | "summary_of" | "provider_type" | "qa_pass" | "qa_reason")[];
102
+ export declare function resolveOrd(requested: unknown, nextOrd: number): number;
70
103
  /** Значение для jsonb-колонки: нативный объект/массив → JSON-строка (NUL — вычищены). */
71
104
  export declare function jsonParam(value: unknown): string | null;
72
105
  /**
@@ -90,6 +123,12 @@ export declare class PostgresSessionRepository implements SessionRepository {
90
123
  * транзакция + per-session advisory-лок (как у `save`), `seq = MAX(seq)+1`
91
124
  * вычисляется в той же транзакции, `INSERT` одной строки, обновление
92
125
  * `sessions.updated_at`. Остальная история не перезаписывается.
126
+ *
127
+ * ADR-118 §2: `ord` — **монотонный** счётчик сессии (`MAX(ord)+1` по
128
+ * сессии), выдаётся в момент материализации записи в историю; ранее
129
+ * выданные значения не перенумеровываются. Если вызывающий уже проставил
130
+ * `ord` (например, перенос записи), его значение сохраняется — порт не
131
+ * перетирает выданный порядок.
93
132
  */
94
133
  appendMessage(sessionId: string, message: Message): Promise<Message | null>;
95
134
  /**
@@ -97,11 +136,16 @@ export declare class PostgresSessionRepository implements SessionRepository {
97
136
  * транзакция + per-session advisory-лок; цель — по `seq` (первая по
98
137
  * `seq, created_at, id`), fallback по `id`. `message_uid`/`id`/`seq`/
99
138
  * `created_at` исходной строки не меняются, `sessions.updated_at` обновляется.
139
+ *
140
+ * ADR-118: `ord` не перенумеровывается — уже выданное значение сохраняется
141
+ * (`COALESCE(messages.ord, …)`), а ещё не выданное (legacy-строка без
142
+ * `ord`) может быть проставлено (миграция данных ядра).
100
143
  */
101
144
  updateMessage(sessionId: string, message: Message): Promise<Message | null>;
102
145
  /**
103
- * Метаданные сессии без истории (`SessionRepository.loadLight`): одна
104
- * выборка по PK, child-таблицы не читаются.
146
+ * Метаданные сессии без истории и без очереди (`SessionRepository.loadLight`):
147
+ * одна выборка по PK, child-таблицы не читаются, `pendingMessages`/`steerInbox`
148
+ * пусты (очередь отдаёт только `listLight` — recovery/автозапуску).
105
149
  */
106
150
  loadLight(sessionId: string): Promise<Session | null>;
107
151
  delete(sessionId: string): Promise<void>;
@@ -130,10 +174,12 @@ export declare class PostgresSessionRepository implements SessionRepository {
130
174
  */
131
175
  private _loadChildren;
132
176
  /**
133
- * `message_uid` цели `updateMessage`: сначала по `seq` (при legacy-дублях —
134
- * первая по `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`.
135
181
  */
136
- private _findMessageUid;
182
+ private _findMessageTarget;
137
183
  /** ADR-097: per-session сериализация записи — транзакционный advisory-лок. */
138
184
  private _lockSession;
139
185
  /** `addReference`/`removeReference` отсутствующей сессии → ошибка (как в file/memory). */
@@ -19,6 +19,14 @@
19
19
  * (у старых сессий у всех сообщений `seq = 0`) и делает порядок однозначным;
20
20
  * домен и так переставляет `seq = i+1` при ветвлении/merge — приведение к
21
21
  * позиции смысла не меняет;
22
+ * - ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
23
+ * (выдаётся портом при материализации: `MAX(ord)+1` по сессии, под тем же
24
+ * per-session advisory-локом). Ранее выданные значения **не
25
+ * перенумеровываются**: `save()` сохраняет `ord` сообщения как есть, а
26
+ * `updateMessage` пишет `ord = COALESCE(messages.ord, …)` (уже выданное
27
+ * значение сохраняется; ещё не выданное — legacy-строка — может его
28
+ * получить: так проставляет `ord` миграция данных ядра). Рядом живут
29
+ * аддитивные поля хода/шага/статуса (`turn_id`/`step_index`/`status`);
22
30
  * - `id` сообщения **не уникален** в пределах сессии (legacy-дубликаты):
23
31
  * PK `messages` — суррогатный `message_uid`, поэтому дубликаты `id`
24
32
  * сохраняются без потерь (upsert по `id` их молча схлопывал);
@@ -28,10 +36,13 @@
28
36
  * **полную** `Session`; сообщения/child-строки подгружаются **батчем**
29
37
  * (`WHERE session_id = ANY($1)`, без N+1); порядок сообщений — по `seq` с
30
38
  * тайбрейкером `created_at`, затем `id` (детерминированное чтение);
31
- * - `listLight` — метаданные без истории (`messages`/`pendingMessages`/
32
- * `checkpoints` пусты, child-таблицы не читаются): одна выборка из `sessions`
39
+ * - `listLight` — метаданные без истории (`messages`/`checkpoints` пусты,
40
+ * child-таблицы не читаются; очередь `pendingMessages`/`steerInbox` —
41
+ * jsonb-колонки самой `sessions` — сохраняется): одна выборка из `sessions`
33
42
  * тем же `WHERE`/порядком, что у `list`; `loadLight` — та же проекция по
34
- * одному id (одна выборка по PK);
43
+ * одному id (одна выборка по PK), но **без очереди** (`pendingMessages`/
44
+ * `steerInbox` пусты) — контракт порта: очередь нужна только recovery/
45
+ * автозапуску через `listLight`;
35
46
  * - `list`/`listForUser*` сортируют `updated_at DESC`; архивированные сессии
36
47
  * **не** отфильтровываются — это ответственность менеджера
37
48
  * (`SessionManager.listSessions`, как и у файловой/memory реализаций);
@@ -46,7 +57,7 @@
46
57
  */
47
58
  import { jsonbParam } from '../json-param.js';
48
59
  import { generateId, makeTextPart, nowISO } from '@itphx/synth-shared';
49
- import { checkpointRow, deserializeMessage, deserializeReference, deserializeSession, deserializeSessionLight, 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';
50
61
  /**
51
62
  * Колонки `sessions` (порядок — как в `001_init`).
52
63
  *
@@ -68,6 +79,8 @@ export const SESSION_FIELDS = [
68
79
  'user_id',
69
80
  'owner_id',
70
81
  'project_id',
82
+ // Маркер источника переноса — ключ дедупликации повторного импорта (миграция 033).
83
+ 'source_session_id',
71
84
  // ADR-114: привязка сессии к worktree (jsonb, миграция 023).
72
85
  'worktree',
73
86
  'todos',
@@ -79,6 +92,8 @@ export const SESSION_FIELDS = [
79
92
  'pending_messages',
80
93
  'steer_inbox',
81
94
  'current_stream',
95
+ // Персистентное состояние ретрая (jsonb, миграция 030).
96
+ 'retry',
82
97
  'summarization_pending',
83
98
  'can_summarize',
84
99
  'created_at',
@@ -111,12 +126,16 @@ export const SESSION_JSON_FIELDS = new Set([
111
126
  'pending_messages',
112
127
  'steer_inbox',
113
128
  'current_stream',
129
+ // Персистентное состояние ретрая (jsonb, миграция 030).
130
+ 'retry',
114
131
  ]);
115
- /** Колонки `messages` (порядок — как в `001_init`). */
116
- const MESSAGE_FIELDS = [
132
+ /** Колонки `messages` (порядок — как в `001_init`; `028` — reasoning-подпись). */
133
+ export const MESSAGE_FIELDS = [
117
134
  'id',
118
135
  'session_id',
119
136
  'seq',
137
+ // ADR-118 (миграция `029`): монотонный порядок записи, ход, шаг, статус.
138
+ 'ord',
120
139
  'role',
121
140
  'origin',
122
141
  'source_msg_id',
@@ -133,6 +152,8 @@ const MESSAGE_FIELDS = [
133
152
  'provider',
134
153
  'provider_type',
135
154
  'reasoning',
155
+ 'reasoning_signature',
156
+ 'reasoning_redacted',
136
157
  'source',
137
158
  'author',
138
159
  'agent_role',
@@ -142,9 +163,12 @@ const MESSAGE_FIELDS = [
142
163
  'pinned',
143
164
  'hidden',
144
165
  'ephemeral',
166
+ 'turn_id',
167
+ 'step_index',
168
+ 'status',
145
169
  'created_at',
146
170
  ];
147
- const MESSAGE_JSON_FIELDS = new Set([
171
+ export const MESSAGE_JSON_FIELDS = new Set([
148
172
  'parts',
149
173
  'tool_calls',
150
174
  'usage',
@@ -152,14 +176,22 @@ const MESSAGE_JSON_FIELDS = new Set([
152
176
  'prompt_meta',
153
177
  'debug_data',
154
178
  'summary_of',
179
+ 'reasoning_redacted',
155
180
  ]);
156
181
  /**
157
182
  * Колонки `messages`, которые заменяет `updateMessage`. Неизменяемые —
158
183
  * суррогатный `message_uid` (PK), доменный `id`, `session_id`, позиционный
159
184
  * `seq` и `created_at`: они сохраняются от исходной строки (цель ищется по
160
185
  * `seq`, fallback по `id`).
186
+ *
187
+ * ADR-118: `ord` — **не** перенумеровывается обновлением (он иммутабелен
188
+ * после выдачи), поэтому в общий список изменяемых колонок он не входит:
189
+ * `updateMessage` пишет его отдельной фразой `COALESCE(messages.ord, …)` —
190
+ * уже выданное значение сохраняется, а ещё не выданное (legacy-строка) может
191
+ * получить его (так проставляет `ord` миграция данных ядра).
161
192
  */
162
- export const MESSAGE_MUTABLE_FIELDS = MESSAGE_FIELDS.filter((field) => field !== 'id' && field !== 'session_id' && field !== 'seq' && field !== 'created_at');
193
+ export const MESSAGE_MUTABLE_FIELDS = MESSAGE_FIELDS.filter((field) => field !== 'id' && field !== 'session_id' && field !== 'seq'
194
+ && field !== 'created_at' && field !== 'ord');
163
195
  /** Обязательные поля сообщения: безопасные дефолты (паритет с file/memory). */
164
196
  function prepareMessage(message) {
165
197
  return {
@@ -172,6 +204,51 @@ function prepareMessage(message) {
172
204
  createdAt: message.createdAt || nowISO(),
173
205
  };
174
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
+ }
237
+ /**
238
+ * ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
239
+ * сессии (выдаётся при материализации, ранее выданные значения не
240
+ * перенумеровываются).
241
+ *
242
+ * Правило выдачи: уже проставленный вызывателем `ord` **не перетирается**
243
+ * (иначе порядок записей ездил бы); иначе берётся `max(ord)+1` по сессии —
244
+ * значение вычислено в той же транзакции (per-session advisory-лок), поэтому
245
+ * два параллельных append'а не получат один `ord`.
246
+ *
247
+ * Экспортируется для unit-тестов (живая БД не нужна).
248
+ */
249
+ export function resolveOrd(requested, nextOrd) {
250
+ return Number.isFinite(requested) ? requested : nextOrd;
251
+ }
175
252
  const REFERENCE_FIELDS = [
176
253
  'id',
177
254
  'session_id',
@@ -321,6 +398,12 @@ export class PostgresSessionRepository {
321
398
  * транзакция + per-session advisory-лок (как у `save`), `seq = MAX(seq)+1`
322
399
  * вычисляется в той же транзакции, `INSERT` одной строки, обновление
323
400
  * `sessions.updated_at`. Остальная история не перезаписывается.
401
+ *
402
+ * ADR-118 §2: `ord` — **монотонный** счётчик сессии (`MAX(ord)+1` по
403
+ * сессии), выдаётся в момент материализации записи в историю; ранее
404
+ * выданные значения не перенумеровываются. Если вызывающий уже проставил
405
+ * `ord` (например, перенос записи), его значение сохраняется — порт не
406
+ * перетирает выданный порядок.
324
407
  */
325
408
  async appendMessage(sessionId, message) {
326
409
  const prepared = prepareMessage(message);
@@ -329,8 +412,10 @@ export class PostgresSessionRepository {
329
412
  const present = await tx.query('SELECT EXISTS (SELECT 1 FROM sessions WHERE id = $1) AS present', [sessionId]);
330
413
  if (present[0]?.present !== true)
331
414
  return null;
332
- const next = await tx.query('SELECT COALESCE(MAX(seq), 0) + 1 AS seq FROM messages WHERE session_id = $1', [sessionId]);
415
+ const next = await tx.query('SELECT COALESCE(MAX(seq), 0) + 1 AS seq, COALESCE(MAX(ord), 0) + 1 AS ord '
416
+ + 'FROM messages WHERE session_id = $1', [sessionId]);
333
417
  const seq = Number(next[0]?.seq ?? 1);
418
+ prepared.ord = resolveOrd(prepared.ord, Number(next[0]?.ord ?? 1));
334
419
  const row = messageRow(prepared, sessionId, seq);
335
420
  const placeholders = MESSAGE_FIELDS.map((_, index) => `$${index + 1}`).join(', ');
336
421
  const inserted = await tx.query(`INSERT INTO messages (${MESSAGE_FIELDS.join(', ')}) VALUES (${placeholders}) RETURNING *`, rowValues(row, MESSAGE_FIELDS, MESSAGE_JSON_FIELDS));
@@ -344,33 +429,48 @@ export class PostgresSessionRepository {
344
429
  * транзакция + per-session advisory-лок; цель — по `seq` (первая по
345
430
  * `seq, created_at, id`), fallback по `id`. `message_uid`/`id`/`seq`/
346
431
  * `created_at` исходной строки не меняются, `sessions.updated_at` обновляется.
432
+ *
433
+ * ADR-118: `ord` не перенумеровывается — уже выданное значение сохраняется
434
+ * (`COALESCE(messages.ord, …)`), а ещё не выданное (legacy-строка без
435
+ * `ord`) может быть проставлено (миграция данных ядра).
347
436
  */
348
437
  async updateMessage(sessionId, message) {
349
438
  const prepared = prepareMessage(message);
350
439
  const row = messageRow(prepared, sessionId, prepared.seq);
351
- const setSql = MESSAGE_MUTABLE_FIELDS
352
- .map((field, index) => `${field} = $${index + 1}`)
353
- .join(', ');
440
+ const setClauses = MESSAGE_MUTABLE_FIELDS.map((field, index) => `${field} = $${index + 1}`);
354
441
  const params = rowValues(row, MESSAGE_MUTABLE_FIELDS, MESSAGE_JSON_FIELDS);
442
+ if (prepared.ord !== undefined && prepared.ord !== null) {
443
+ params.push(prepared.ord);
444
+ setClauses.push(`ord = COALESCE(messages.ord, $${params.length})`);
445
+ }
446
+ const setSql = setClauses.join(', ');
355
447
  return this._connection.withTransaction(async (tx) => {
356
448
  await this._lockSession(tx, sessionId);
357
- const messageUid = await this._findMessageUid(tx, sessionId, prepared);
358
- if (!messageUid)
449
+ const target = await this._findMessageTarget(tx, sessionId, prepared);
450
+ if (!target)
359
451
  return null;
360
- 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]);
361
460
  await tx.query('UPDATE sessions SET updated_at = now() WHERE id = $1', [sessionId]);
362
461
  const updatedRow = updated[0];
363
462
  return updatedRow ? deserializeMessage(updatedRow) : null;
364
463
  });
365
464
  }
366
465
  /**
367
- * Метаданные сессии без истории (`SessionRepository.loadLight`): одна
368
- * выборка по PK, child-таблицы не читаются.
466
+ * Метаданные сессии без истории и без очереди (`SessionRepository.loadLight`):
467
+ * одна выборка по PK, child-таблицы не читаются, `pendingMessages`/`steerInbox`
468
+ * пусты (очередь отдаёт только `listLight` — recovery/автозапуску).
369
469
  */
370
470
  async loadLight(sessionId) {
371
471
  const rows = await this._connection.query('SELECT * FROM sessions WHERE id = $1', [sessionId]);
372
472
  const row = rows[0];
373
- return row ? deserializeSessionLight(row) : null;
473
+ return row ? deserializeSessionMeta(row) : null;
374
474
  }
375
475
  async delete(sessionId) {
376
476
  await this._connection.withTransaction(async (tx) => {
@@ -480,21 +580,23 @@ export class PostgresSessionRepository {
480
580
  return buckets;
481
581
  }
482
582
  /**
483
- * `message_uid` цели `updateMessage`: сначала по `seq` (при legacy-дублях —
484
- * первая по `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`.
485
587
  */
486
- async _findMessageUid(tx, sessionId, message) {
588
+ async _findMessageTarget(tx, sessionId, message) {
487
589
  if (Number.isFinite(message.seq)) {
488
- 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 '
489
591
  + 'ORDER BY seq, created_at, id LIMIT 1', [sessionId, message.seq]);
490
592
  if (rows[0])
491
- return rows[0].message_uid;
593
+ return { uid: rows[0].message_uid, status: toMessageStatus(rows[0].status) ?? null };
492
594
  }
493
595
  if (message.id) {
494
- 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 '
495
597
  + 'ORDER BY seq, created_at, id LIMIT 1', [sessionId, message.id]);
496
598
  if (rows[0])
497
- return rows[0].message_uid;
599
+ return { uid: rows[0].message_uid, status: toMessageStatus(rows[0].status) ?? null };
498
600
  }
499
601
  return null;
500
602
  }