@itphx/synth-storage-postgres 0.13.4 → 0.13.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/dist/index.d.ts +2 -0
  2. package/dist/index.js +3 -0
  3. package/dist/migrations/026-instance-skills.d.ts +1 -1
  4. package/dist/migrations/026-instance-skills.js +1 -1
  5. package/dist/migrations/031-ssh-key-policy.d.ts +13 -0
  6. package/dist/migrations/031-ssh-key-policy.js +25 -0
  7. package/dist/migrations/032-mcp-remote-mode.d.ts +14 -0
  8. package/dist/migrations/032-mcp-remote-mode.js +18 -0
  9. package/dist/migrations/033-session-source-id.d.ts +16 -0
  10. package/dist/migrations/033-session-source-id.js +21 -0
  11. package/dist/migrations/034-pending-approvals.d.ts +18 -0
  12. package/dist/migrations/034-pending-approvals.js +35 -0
  13. package/dist/migrations/035-project-access.d.ts +16 -0
  14. package/dist/migrations/035-project-access.js +22 -0
  15. package/dist/migrations/036-message-mentions.d.ts +8 -0
  16. package/dist/migrations/036-message-mentions.js +12 -0
  17. package/dist/migrations/037-timers.d.ts +19 -0
  18. package/dist/migrations/037-timers.js +60 -0
  19. package/dist/migrations/038-schedule-project-id.d.ts +18 -0
  20. package/dist/migrations/038-schedule-project-id.js +38 -0
  21. package/dist/migrations/index.js +16 -0
  22. package/dist/ports/content.js +80 -9
  23. package/dist/ports/context-files.d.ts +6 -0
  24. package/dist/ports/context-files.js +13 -0
  25. package/dist/ports/events-scheduler.js +19 -4
  26. package/dist/ports/pending-approvals.d.ts +32 -0
  27. package/dist/ports/pending-approvals.js +108 -0
  28. package/dist/ports/principals-defaults.js +10 -0
  29. package/dist/ports/principals-projects.d.ts +7 -1
  30. package/dist/ports/principals-projects.js +66 -11
  31. package/dist/ports/principals-settings.js +80 -0
  32. package/dist/ports/sessions-mapping.d.ts +36 -5
  33. package/dist/ports/sessions-mapping.js +32 -4
  34. package/dist/ports/sessions.d.ts +55 -8
  35. package/dist/ports/sessions.js +285 -37
  36. package/dist/ports/skills.d.ts +2 -2
  37. package/dist/ports/skills.js +2 -2
  38. package/dist/ports/timers.d.ts +54 -0
  39. package/dist/ports/timers.js +247 -0
  40. package/dist/ports/worktrees.d.ts +3 -3
  41. package/dist/ports/worktrees.js +3 -3
  42. package/dist/storage-context.d.ts +4 -2
  43. package/dist/storage-context.js +17 -3
  44. package/package.json +5 -5
@@ -56,8 +56,8 @@
56
56
  * `includes` файловой/memory реализаций.
57
57
  */
58
58
  import { jsonbParam } from '../json-param.js';
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';
59
+ import { generateId, makeTextPart, nowISO, stripNullBytesDeep } from '@itphx/synth-shared';
60
+ import { checkpointRow, deserializeMessage, deserializeReference, deserializeSession, deserializeSessionLight, deserializeSessionMeta, deserializeSessionMetaDocument, 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',
@@ -155,6 +157,7 @@ export const MESSAGE_FIELDS = [
155
157
  'source',
156
158
  'author',
157
159
  'agent_role',
160
+ 'mentions',
158
161
  'qa_pass',
159
162
  'qa_reason',
160
163
  'disabled',
@@ -175,6 +178,7 @@ export const MESSAGE_JSON_FIELDS = new Set([
175
178
  'debug_data',
176
179
  'summary_of',
177
180
  'reasoning_redacted',
181
+ 'mentions',
178
182
  ]);
179
183
  /**
180
184
  * Колонки `messages`, которые заменяет `updateMessage`. Неизменяемые —
@@ -202,6 +206,73 @@ function prepareMessage(message) {
202
206
  createdAt: message.createdAt || nowISO(),
203
207
  };
204
208
  }
209
+ /**
210
+ * ADR-118 §5: запись черновика частичного стрима — статус `streaming` либо
211
+ * `metadata.streaming === true`.
212
+ *
213
+ * **Паритет с портом**: источник истины — `isDraftMessageWrite` в
214
+ * `packages/core/src/storage/message-write.ts` (file/memory используют его
215
+ * напрямую). Драйвер не тянет core рантаймом (только `import type`,
216
+ * ADR-097), поэтому предикат продублирован здесь — при правке синхронизируйте
217
+ * оба места.
218
+ */
219
+ function isDraftMessageWrite(message) {
220
+ return message.status === 'streaming' || message.metadata?.streaming === true;
221
+ }
222
+ /**
223
+ * ADR-118 §5: поздняя запись черновика поверх **закрытого** сообщения
224
+ * (терминальный статус `completed`/`cancelled`/`error`). Такая запись
225
+ * игнорируется целиком — иначе черновик откатит шаг в `streaming` и затрёт
226
+ * финальный текст.
227
+ *
228
+ * Паритет с `isStaleDraftWrite`/`isTerminalMessageStatus` из
229
+ * `packages/core/src/storage/message-write.ts` (см. комментарий выше).
230
+ * `target` принимает частичную запись (драйверу достаточно `status` из
231
+ * `SELECT`), поэтому тип — `{ status }`, а не полный `Message`.
232
+ */
233
+ function isStaleDraftWrite(target, incoming) {
234
+ const terminal = target.status === 'completed'
235
+ || target.status === 'cancelled'
236
+ || target.status === 'error';
237
+ return terminal && isDraftMessageWrite(incoming);
238
+ }
239
+ /**
240
+ * Максимальный выданный `ord` в истории (`0`, если `ord` ни у кого нет).
241
+ * Нужен оптимистичной проверке `mutateHistory({ expectMaxOrd })`; считается по
242
+ * свежему снимку в той же транзакции (отдельный `MAX(ord)` не требуется).
243
+ */
244
+ function maxOrdOf(messages) {
245
+ return messages.reduce((acc, message) => {
246
+ const ord = Number.isFinite(message.ord) ? message.ord : 0;
247
+ return ord > acc ? ord : acc;
248
+ }, 0);
249
+ }
250
+ /**
251
+ * `seq` — позиционный (порядок массива истории), нормализация `1..n`.
252
+ * `ord` не трогается: монотонный и иммутабельный после выдачи (ADR-118 §2).
253
+ */
254
+ function normalizeMessageSeq(messages) {
255
+ messages.forEach((message, index) => {
256
+ message.seq = index + 1;
257
+ });
258
+ }
259
+ /**
260
+ * Выдать `ord` сообщениям без него (`mutateHistory`: добавление
261
+ * мутатором/импортом) — подряд в порядке массива, от `max(ord)+1`. Ранее
262
+ * выданные значения не перенумеровываются; иначе новые записи сортировались бы
263
+ * в начало истории. Возвращает число выданных `ord`.
264
+ */
265
+ function assignMissingOrd(messages) {
266
+ let next = maxOrdOf(messages) + 1;
267
+ let assigned = 0;
268
+ for (const message of messages) {
269
+ if (Number.isFinite(message.ord))
270
+ continue;
271
+ message.ord = next++;
272
+ assigned++;
273
+ }
274
+ return assigned;
275
+ }
205
276
  /**
206
277
  * ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
207
278
  * сессии (выдаётся при материализации, ранее выданные значения не
@@ -338,6 +409,17 @@ export class PostgresSessionRepository {
338
409
  * дубликаты `id` сохраняются как есть.
339
410
  */
340
411
  async save(session) {
412
+ await this._connection.withTransaction(async (tx) => {
413
+ await this._lockSession(tx, session.id);
414
+ await this._writeSession(tx, session);
415
+ });
416
+ }
417
+ /**
418
+ * Запись полного документа сессии под уже взятым advisory-локом: upsert
419
+ * строки `sessions` + **полная замена** child-таблиц. Общий помощник `save`
420
+ * и `mutateHistory` (одна семантика, один код).
421
+ */
422
+ async _writeSession(tx, session) {
341
423
  const sessionRow = serializeSession(session);
342
424
  // `seq` — позиция сообщения в массиве (`1..n`): снимает legacy-коллизию
343
425
  // `UNIQUE (session_id, seq)` (у старых сессий `seq = 0` у всех) и делает
@@ -346,20 +428,17 @@ export class PostgresSessionRepository {
346
428
  const referenceRows = (session.references ?? []).map((ref, index) => referenceRow(session.id, ref, index));
347
429
  const checkpointRows = (session.checkpoints ?? []).map(checkpointRow);
348
430
  const noteRows = (session.stickyNotes ?? []).map((note) => stickyNoteRow(session.id, note));
349
- await this._connection.withTransaction(async (tx) => {
350
- await this._lockSession(tx, session.id);
351
- await upsertRows(tx, 'sessions', SESSION_FIELDS, [sessionRow], SESSION_JSON_FIELDS, ['id']);
352
- // Сообщения — полная замена в той же транзакции: `DELETE` + массовый
353
- // `INSERT`. Дубликаты `id` допустимы (суррогатный PK `message_uid`);
354
- // уникальность `(session_id, seq)` выполняется по построению (позиция).
355
- await replaceRows(tx, 'messages', MESSAGE_FIELDS, messageRows, MESSAGE_JSON_FIELDS, session.id);
356
- // Ссылки — полная замена (паритет с файловой реализацией: `save`
357
- // перезаписывает `session.references` целиком); `id`/`ordinal` — свежие,
358
- // дубликаты одной `ref_session_id` допустимы (разные диапазоны).
359
- await replaceRows(tx, 'session_references', REFERENCE_FIELDS, referenceRows, REFERENCE_JSON_FIELDS, session.id);
360
- await replaceRows(tx, 'checkpoints', CHECKPOINT_FIELDS, checkpointRows, CHECKPOINT_JSON_FIELDS, session.id);
361
- await replaceRows(tx, 'sticky_notes', NOTE_FIELDS, noteRows, NOTE_JSON_FIELDS, session.id);
362
- });
431
+ await upsertRows(tx, 'sessions', SESSION_FIELDS, [sessionRow], SESSION_JSON_FIELDS, ['id']);
432
+ // Сообщения — полная замена в той же транзакции: `DELETE` + массовый
433
+ // `INSERT`. Дубликаты `id` допустимы (суррогатный PK `message_uid`);
434
+ // уникальность `(session_id, seq)` выполняется по построению (позиция).
435
+ await replaceRows(tx, 'messages', MESSAGE_FIELDS, messageRows, MESSAGE_JSON_FIELDS, session.id);
436
+ // Ссылки — полная замена (паритет с файловой реализацией: `save`
437
+ // перезаписывает `session.references` целиком); `id`/`ordinal` — свежие,
438
+ // дубликаты одной `ref_session_id` допустимы (разные диапазоны).
439
+ await replaceRows(tx, 'session_references', REFERENCE_FIELDS, referenceRows, REFERENCE_JSON_FIELDS, session.id);
440
+ await replaceRows(tx, 'checkpoints', CHECKPOINT_FIELDS, checkpointRows, CHECKPOINT_JSON_FIELDS, session.id);
441
+ await replaceRows(tx, 'sticky_notes', NOTE_FIELDS, noteRows, NOTE_JSON_FIELDS, session.id);
363
442
  }
364
443
  /**
365
444
  * Точечная дозапись сообщения (`SessionRepository.appendMessage`): одна
@@ -414,15 +493,149 @@ export class PostgresSessionRepository {
414
493
  const setSql = setClauses.join(', ');
415
494
  return this._connection.withTransaction(async (tx) => {
416
495
  await this._lockSession(tx, sessionId);
417
- const messageUid = await this._findMessageUid(tx, sessionId, prepared);
418
- if (!messageUid)
496
+ const target = await this._findMessageTarget(tx, sessionId, prepared);
497
+ if (!target)
419
498
  return null;
420
- const updated = await tx.query(`UPDATE messages SET ${setSql} WHERE message_uid = $${params.length + 1} RETURNING *`, [...params, messageUid]);
499
+ // ADR-118 §5: поздняя запись черновика не «воскрешает» закрытый шаг —
500
+ // ни строки, ни `sessions.updated_at` не трогаем, отдаём текущую запись.
501
+ if (isStaleDraftWrite(target, prepared)) {
502
+ const current = await tx.query('SELECT * FROM messages WHERE message_uid = $1', [target.uid]);
503
+ const currentRow = current[0];
504
+ return currentRow ? deserializeMessage(currentRow) : null;
505
+ }
506
+ const updated = await tx.query(`UPDATE messages SET ${setSql} WHERE message_uid = $${params.length + 1} RETURNING *`, [...params, target.uid]);
421
507
  await tx.query('UPDATE sessions SET updated_at = now() WHERE id = $1', [sessionId]);
422
508
  const updatedRow = updated[0];
423
509
  return updatedRow ? deserializeMessage(updatedRow) : null;
424
510
  });
425
511
  }
512
+ /**
513
+ * Атомарная правка метаданных (порт `SessionRepository.mutateMeta`): одна
514
+ * транзакция, `pg_advisory_xact_lock` **до** чтения строки `sessions`.
515
+ *
516
+ * Пишется только строка `sessions` (`UPDATE` по `SESSION_FIELDS`); child-таблицы
517
+ * (`messages`/`session_references`/`checkpoints`/`sticky_notes`) не трогаются —
518
+ * параллельный `appendMessage` не теряется. Очередь (`pending_messages`/
519
+ * `steer_inbox`) — колонки самой записи, читаются свежими и пишутся обратно.
520
+ */
521
+ async mutateMeta(sessionId, mutator, opts) {
522
+ return this._connection.withTransaction(async (tx) => {
523
+ await this._lockSession(tx, sessionId);
524
+ const rows = await tx.query('SELECT * FROM sessions WHERE id = $1', [sessionId]);
525
+ const row = rows[0];
526
+ if (!row)
527
+ return { found: false };
528
+ // `shouldWrite`: мутатор работает с клоном; при отказе от записи `UPDATE`
529
+ // не выполняется, а `session` — снимок **до** мутатора (без алиасинга).
530
+ const snapshot = deserializeSessionMetaDocument(row);
531
+ const baseline = opts?.shouldWrite ? structuredClone(snapshot) : undefined;
532
+ const meta = opts?.shouldWrite ? structuredClone(snapshot) : snapshot;
533
+ const value = mutator(meta);
534
+ if (opts?.shouldWrite && !opts.shouldWrite(value)) {
535
+ return { found: true, value, session: baseline };
536
+ }
537
+ // Идентичность сессии неизменяема (строку адресует `id`).
538
+ meta.id = sessionId;
539
+ if (opts?.touchUpdatedAt !== false)
540
+ meta.updatedAt = nowISO();
541
+ // Паритет с file/memory: возврат — санитизированное значение (NUL-байты
542
+ // несовместимы с PostgreSQL; так же их чистит `jsonParam` при записи).
543
+ const sanitized = stripNullBytesDeep(meta);
544
+ // `serializeSession` строит значения по колонкам `sessions`; child-наборы
545
+ // сюда не входят. `id` в SET — то же значение (строку уже заблокировали).
546
+ const values = rowValues(serializeSession(sanitized), SESSION_FIELDS, SESSION_JSON_FIELDS);
547
+ const setClauses = SESSION_FIELDS.map((field, index) => `${field} = $${index + 1}`);
548
+ await tx.query(`UPDATE sessions SET ${setClauses.join(', ')} WHERE id = $${SESSION_FIELDS.length + 1}`, [...values, sessionId]);
549
+ return { found: true, value, session: sanitized };
550
+ });
551
+ }
552
+ /**
553
+ * Атомарная правка истории (порт `SessionRepository.mutateHistory`): свежий
554
+ * полный документ читается **внутри транзакции** под advisory-локом, затем
555
+ * синхронный мутатор и полная замена child-наборов (как `save`).
556
+ *
557
+ * `seq` нормализуется позиционно `1..n`; `ord` не перенумеровывается.
558
+ * `expectMaxOrd` проверяется по свежему снимку; `shouldWrite === false` —
559
+ * запись не выполняется (транзакция завершается без изменений);
560
+ * `touchUpdatedAt === false` — запись есть, `sessions.updated_at` не меняется.
561
+ */
562
+ async mutateHistory(sessionId, mutator, opts) {
563
+ return this._connection.withTransaction(async (tx) => {
564
+ await this._lockSession(tx, sessionId);
565
+ const session = await this._loadSessionInTx(tx, sessionId);
566
+ if (!session)
567
+ return { ok: false, reason: 'not_found' };
568
+ if (opts?.expectMaxOrd !== undefined && maxOrdOf(session.messages) > opts.expectMaxOrd) {
569
+ return { ok: false, reason: 'stale' };
570
+ }
571
+ const value = mutator(session);
572
+ if (opts?.shouldWrite && !opts.shouldWrite(value))
573
+ return { ok: true, value };
574
+ session.id = sessionId;
575
+ // Новым записям (добавлены мутатором/импортом) порт выдаёт `ord` сам:
576
+ // без него сортировка по `ord` поставила бы их в начало истории.
577
+ assignMissingOrd(session.messages);
578
+ normalizeMessageSeq(session.messages);
579
+ // `touchUpdatedAt:false` — служебная запись истории не «оживляет» сессию:
580
+ // `updated_at` пишется как прочитан (паритет с file/memory).
581
+ if (opts?.touchUpdatedAt !== false)
582
+ session.updatedAt = nowISO();
583
+ await this._writeSession(tx, session);
584
+ return { ok: true, value };
585
+ });
586
+ }
587
+ /**
588
+ * Атомарная правка одного сообщения по `id` (порт
589
+ * `SessionRepository.mutateMessage`): одна транзакция + advisory-лок; цель —
590
+ * по доменному `id` (при legacy-дублях — первая по `seq, created_at, id`).
591
+ * `id`/`seq`/`created_at`/`ord` исходной строки сохраняются, поздняя запись
592
+ * черновика поверх терминального сообщения не применяется.
593
+ */
594
+ async mutateMessage(sessionId, messageId, mutator, opts) {
595
+ return this._connection.withTransaction(async (tx) => {
596
+ await this._lockSession(tx, sessionId);
597
+ const rows = await tx.query('SELECT * FROM messages WHERE session_id = $1 AND id = $2 '
598
+ + 'ORDER BY seq, created_at, id LIMIT 1', [sessionId, messageId]);
599
+ const row = rows[0];
600
+ if (!row)
601
+ return { found: false };
602
+ const original = deserializeMessage(row);
603
+ const target = structuredClone(original);
604
+ const value = mutator(target);
605
+ // ADR-118 §5: поздняя запись черновика не «воскрешает» закрытый шаг.
606
+ if (isStaleDraftWrite({ status: toMessageStatus(row.status) ?? null }, target)) {
607
+ return { found: true, value, message: original };
608
+ }
609
+ // Иммутабельные поля берутся из исходной строки, изменяются только
610
+ // `MESSAGE_MUTABLE_FIELDS`; `ord` — `COALESCE` (уже выданный не перебить).
611
+ const prepared = prepareMessage({
612
+ ...target,
613
+ id: original.id,
614
+ seq: original.seq,
615
+ createdAt: original.createdAt,
616
+ ord: original.ord,
617
+ });
618
+ const updatedRow = messageRow(prepared, sessionId, original.seq);
619
+ const setClauses = MESSAGE_MUTABLE_FIELDS.map((field, index) => `${field} = $${index + 1}`);
620
+ const params = rowValues(updatedRow, MESSAGE_MUTABLE_FIELDS, MESSAGE_JSON_FIELDS);
621
+ if (prepared.ord !== undefined && prepared.ord !== null) {
622
+ params.push(prepared.ord);
623
+ setClauses.push(`ord = COALESCE(messages.ord, $${params.length})`);
624
+ }
625
+ const updated = await tx.query(`UPDATE messages SET ${setClauses.join(', ')} WHERE message_uid = $${params.length + 1} RETURNING *`, [...params, row.message_uid]);
626
+ // `touchUpdatedAt:false` — служебные метки (`turnId`/`last_error`) не
627
+ // «оживляют» сессию: строка `sessions` не трогается.
628
+ if (opts?.touchUpdatedAt !== false) {
629
+ await tx.query('UPDATE sessions SET updated_at = now() WHERE id = $1', [sessionId]);
630
+ }
631
+ const updatedRowResult = updated[0];
632
+ return {
633
+ found: true,
634
+ value,
635
+ message: updatedRowResult ? deserializeMessage(updatedRowResult) : original,
636
+ };
637
+ });
638
+ }
426
639
  /**
427
640
  * Метаданные сессии без истории и без очереди (`SessionRepository.loadLight`):
428
641
  * одна выборка по PK, child-таблицы не читаются, `pendingMessages`/`steerInbox`
@@ -510,26 +723,59 @@ export class PostgresSessionRepository {
510
723
  const children = await this._loadChildren(rows.map((row) => row.id));
511
724
  return rows.map((row) => deserializeSession(row, children.get(row.id) ?? emptySessionChildren()));
512
725
  }
726
+ /**
727
+ * Полный документ сессии внутри готовой транзакции (для `mutateHistory`).
728
+ * Чтение — тем же кодом, что у `load`; лок уже держит вызывающий.
729
+ */
730
+ async _loadSessionInTx(tx, sessionId) {
731
+ const rows = await tx.query('SELECT * FROM sessions WHERE id = $1', [sessionId]);
732
+ const row = rows[0];
733
+ if (!row)
734
+ return null;
735
+ const children = await this._loadChildren([sessionId], tx, true);
736
+ return deserializeSession(row, children.get(sessionId) ?? emptySessionChildren());
737
+ }
513
738
  /**
514
739
  * Child-данные набора сессий — четыре запроса с `ANY($1)` (никакого N+1),
515
740
  * `ORDER BY session_id, …` для стабильного порядка внутри каждой сессии.
741
+ *
742
+ * `db` — исполнитель запросов: соединение (обычное чтение) либо транзакция
743
+ * (`mutateHistory` — читать нужно в той же транзакции, что и запись).
744
+ * `sequential` обязателен для транзакции: `pg` запрещает параллельные запросы
745
+ * на одном клиенте (пул — можно, транзакция — один клиент).
516
746
  */
517
- async _loadChildren(sessionIds) {
747
+ async _loadChildren(sessionIds, db = this._connection, sequential = false) {
518
748
  const buckets = new Map();
519
749
  for (const sessionId of sessionIds)
520
750
  buckets.set(sessionId, emptySessionChildren());
521
751
  if (sessionIds.length === 0)
522
752
  return buckets;
523
- const [messages, references, checkpoints, notes] = await Promise.all([
524
- this._connection.query('SELECT * FROM messages WHERE session_id = ANY($1::text[]) '
525
- + 'ORDER BY session_id, seq, created_at, id', [sessionIds]),
526
- this._connection.query('SELECT * FROM session_references WHERE session_id = ANY($1::text[]) '
527
- + 'ORDER BY session_id, ordinal', [sessionIds]),
528
- this._connection.query('SELECT * FROM checkpoints WHERE session_id = ANY($1::text[]) '
529
- + 'ORDER BY session_id, created_at, id', [sessionIds]),
530
- this._connection.query('SELECT * FROM sticky_notes WHERE session_id = ANY($1::text[]) '
531
- + 'ORDER BY session_id, created_at, id', [sessionIds]),
532
- ]);
753
+ const loadMessages = () => db.query('SELECT * FROM messages WHERE session_id = ANY($1::text[]) '
754
+ + 'ORDER BY session_id, seq, created_at, id', [sessionIds]);
755
+ const loadReferences = () => db.query('SELECT * FROM session_references WHERE session_id = ANY($1::text[]) '
756
+ + 'ORDER BY session_id, ordinal', [sessionIds]);
757
+ const loadCheckpoints = () => db.query('SELECT * FROM checkpoints WHERE session_id = ANY($1::text[]) '
758
+ + 'ORDER BY session_id, created_at, id', [sessionIds]);
759
+ const loadNotes = () => db.query('SELECT * FROM sticky_notes WHERE session_id = ANY($1::text[]) '
760
+ + 'ORDER BY session_id, created_at, id', [sessionIds]);
761
+ let messages;
762
+ let references;
763
+ let checkpoints;
764
+ let notes;
765
+ if (sequential) {
766
+ messages = await loadMessages();
767
+ references = await loadReferences();
768
+ checkpoints = await loadCheckpoints();
769
+ notes = await loadNotes();
770
+ }
771
+ else {
772
+ [messages, references, checkpoints, notes] = await Promise.all([
773
+ loadMessages(),
774
+ loadReferences(),
775
+ loadCheckpoints(),
776
+ loadNotes(),
777
+ ]);
778
+ }
533
779
  for (const row of messages)
534
780
  buckets.get(row.session_id ?? '')?.messages.push(row);
535
781
  for (const row of references)
@@ -541,21 +787,23 @@ export class PostgresSessionRepository {
541
787
  return buckets;
542
788
  }
543
789
  /**
544
- * `message_uid` цели `updateMessage`: сначала по `seq` (при legacy-дублях —
545
- * первая по `seq, created_at, id`), затем fallback по доменному `id`.
790
+ * Цель `updateMessage`: `message_uid` строки + её текущий `status`
791
+ * (ADR-118 §5 — для проверки «поздняя запись черновика поверх закрытого
792
+ * шага»). Сначала по `seq` (при legacy-дублях — первая по
793
+ * `seq, created_at, id`), затем fallback по доменному `id`.
546
794
  */
547
- async _findMessageUid(tx, sessionId, message) {
795
+ async _findMessageTarget(tx, sessionId, message) {
548
796
  if (Number.isFinite(message.seq)) {
549
- const rows = await tx.query('SELECT message_uid FROM messages WHERE session_id = $1 AND seq = $2 '
797
+ const rows = await tx.query('SELECT message_uid, status FROM messages WHERE session_id = $1 AND seq = $2 '
550
798
  + 'ORDER BY seq, created_at, id LIMIT 1', [sessionId, message.seq]);
551
799
  if (rows[0])
552
- return rows[0].message_uid;
800
+ return { uid: rows[0].message_uid, status: toMessageStatus(rows[0].status) ?? null };
553
801
  }
554
802
  if (message.id) {
555
- const rows = await tx.query('SELECT message_uid FROM messages WHERE session_id = $1 AND id = $2 '
803
+ const rows = await tx.query('SELECT message_uid, status FROM messages WHERE session_id = $1 AND id = $2 '
556
804
  + 'ORDER BY seq, created_at, id LIMIT 1', [sessionId, message.id]);
557
805
  if (rows[0])
558
- return rows[0].message_uid;
806
+ return { uid: rows[0].message_uid, status: toMessageStatus(rows[0].status) ?? null };
559
807
  }
560
808
  return null;
561
809
  }
@@ -1,5 +1,5 @@
1
1
  /**
2
- * PG-реализация порта **instance-скиллов** (ADR-046 §4, ADR-116, ADR-097).
2
+ * PG-реализация порта **instance-скиллов** (ADR-126 §9, ADR-116, ADR-097).
3
3
  *
4
4
  * Разделение хранения (ADR-116 §«Что переводится»):
5
5
  * - **метаданные** (заголовок `SKILL.md` — `name`/`description`/прочие ключи) —
@@ -55,5 +55,5 @@ export declare class PgSkillRepository implements SkillRepository {
55
55
  /** Upsert метаданных: заголовок скилла и служебная метка записи. */
56
56
  private _upsertMetadata;
57
57
  }
58
- /** Собрать порт instance-скиллов (ADR-046 §4, ADR-116). */
58
+ /** Собрать порт instance-скиллов (ADR-126 §9, ADR-116). */
59
59
  export declare function buildSkillPorts(deps: PortDeps, blobs: BlobStore): SkillPorts;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * PG-реализация порта **instance-скиллов** (ADR-046 §4, ADR-116, ADR-097).
2
+ * PG-реализация порта **instance-скиллов** (ADR-126 §9, ADR-116, ADR-097).
3
3
  *
4
4
  * Разделение хранения (ADR-116 §«Что переводится»):
5
5
  * - **метаданные** (заголовок `SKILL.md` — `name`/`description`/прочие ключи) —
@@ -197,7 +197,7 @@ export class PgSkillRepository {
197
197
  updated_at = now()`, [name, jsonbParam(frontmatter)]);
198
198
  }
199
199
  }
200
- /** Собрать порт instance-скиллов (ADR-046 §4, ADR-116). */
200
+ /** Собрать порт instance-скиллов (ADR-126 §9, ADR-116). */
201
201
  export function buildSkillPorts(deps, blobs) {
202
202
  return {
203
203
  skills: new PgSkillRepository(deps, blobs),
@@ -0,0 +1,54 @@
1
+ /**
2
+ * PG-реализация портов **таймеров/будильников** и **истории их срабатываний**
3
+ * (PROP-141, Часть B; ADR-097 — драйвер слоя хранения).
4
+ *
5
+ * Таблицы `timers`/`timer_firings` (миграция 037): реестр автоматизаций
6
+ * (привязка к проекту и сессии, режим повтора, статус, ближайшее
7
+ * срабатывание) и append-only журнал срабатываний.
8
+ *
9
+ * Семантика повторяет файловые реализации core (`FileTimerStore`/
10
+ * `FileTimerFiringStore`) и in-memory (`MemoryTimerRepository`):
11
+ * - `list` — фильтры по «И», порядок **по ближайшему срабатыванию**
12
+ * (`fires_at` возраст., тайбрейкер `id`), постраничный срез;
13
+ * - `listDue` — `status = 'active'` и `fires_at <= at`;
14
+ * - `countActive` — счётчик активных таймеров сессии;
15
+ * - `update`/`setStatus` — частичная правка, `updated_at` = now();
16
+ * - `remove` идемпотентно, `removeBySession` — каскад по сессии;
17
+ * - история срабатываний — порядок добавления (`seq`), `limit` — последние N,
18
+ * `prune` — записи **строго старше** отсечки.
19
+ *
20
+ * Драйвер не тянет core рантаймом (только `import type`), поэтому потолок
21
+ * выборки и правила порядка повторены здесь локально — как в
22
+ * `ports/background-runs.ts`.
23
+ */
24
+ import type { StorageContext, TimerFiringRepository, TimerRepository } from '@itphx/synth-core';
25
+ import type { Timer, TimerCreateInput, TimerFiring, TimerFilter, TimerPatch, TimerStatus } from '@itphx/synth-shared';
26
+ import type { PortDeps } from './deps.js';
27
+ /** Часть `StorageContext`, которой владеет группа «таймеры». */
28
+ export type TimerPorts = Pick<StorageContext, 'timers' | 'timerFirings'>;
29
+ /** Порт реестра таймеров поверх таблицы `timers`. */
30
+ export declare class PgTimerRepository implements TimerRepository {
31
+ private readonly _deps;
32
+ constructor(_deps: PortDeps);
33
+ list(filter?: TimerFilter): Promise<Timer[]>;
34
+ get(id: string): Promise<Timer | null>;
35
+ create(input: TimerCreateInput & {
36
+ firesAt: string;
37
+ }): Promise<Timer>;
38
+ update(id: string, patch: TimerPatch): Promise<Timer | null>;
39
+ remove(id: string): Promise<boolean>;
40
+ listDue(at: string): Promise<Timer[]>;
41
+ countActive(sessionId: string): Promise<number>;
42
+ setStatus(id: string, status: TimerStatus, patch?: TimerPatch): Promise<Timer | null>;
43
+ removeBySession(sessionId: string): Promise<number>;
44
+ }
45
+ /** Порт истории срабатываний поверх таблицы `timer_firings`. */
46
+ export declare class PgTimerFiringRepository implements TimerFiringRepository {
47
+ private readonly _deps;
48
+ constructor(_deps: PortDeps);
49
+ append(firing: TimerFiring): Promise<void>;
50
+ list(timerId: string, limit?: number): Promise<TimerFiring[]>;
51
+ prune(before: string): Promise<number>;
52
+ }
53
+ /** Собрать порты группы «таймеры» (PROP-141, Часть B). */
54
+ export declare function buildTimerPorts(deps: PortDeps): TimerPorts;