@itphx/synth-storage-postgres 0.11.3 → 0.13.4

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 (147) hide show
  1. package/dist/errors.d.ts +1 -1
  2. package/dist/errors.js +2 -2
  3. package/dist/index.d.ts +15 -1
  4. package/dist/index.js +24 -2
  5. package/dist/locks.d.ts +4 -4
  6. package/dist/locks.js +4 -4
  7. package/dist/migrate.d.ts +1 -1
  8. package/dist/migrate.js +1 -1
  9. package/dist/migrations/001-init.d.ts +2 -2
  10. package/dist/migrations/001-init.js +2 -2
  11. package/dist/migrations/003-analytics-rollups.d.ts +1 -1
  12. package/dist/migrations/003-analytics-rollups.js +1 -1
  13. package/dist/migrations/004-pipeline-engine.d.ts +19 -0
  14. package/dist/migrations/004-pipeline-engine.js +74 -0
  15. package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
  16. package/dist/migrations/005-pipeline-provenance.js +15 -0
  17. package/dist/migrations/006-plugin-audit.d.ts +13 -0
  18. package/dist/migrations/006-plugin-audit.js +34 -0
  19. package/dist/migrations/007-plugin-lock.d.ts +10 -0
  20. package/dist/migrations/007-plugin-lock.js +25 -0
  21. package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
  22. package/dist/migrations/008-plugin-audit-scan.js +15 -0
  23. package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
  24. package/dist/migrations/009-plugin-lock-previous.js +16 -0
  25. package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
  26. package/dist/migrations/010-plugin-lock-mode.js +20 -0
  27. package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
  28. package/dist/migrations/011-session-steer-inbox.js +14 -0
  29. package/dist/migrations/012-external-credentials.d.ts +15 -0
  30. package/dist/migrations/012-external-credentials.js +40 -0
  31. package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
  32. package/dist/migrations/013-service-key-plugin-id.js +20 -0
  33. package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
  34. package/dist/migrations/014-session-mode-by-principal.js +15 -0
  35. package/dist/migrations/015-authority.d.ts +17 -0
  36. package/dist/migrations/015-authority.js +43 -0
  37. package/dist/migrations/016-credential-audit.d.ts +17 -0
  38. package/dist/migrations/016-credential-audit.js +32 -0
  39. package/dist/migrations/017-memory.d.ts +29 -0
  40. package/dist/migrations/017-memory.js +95 -0
  41. package/dist/migrations/018-memory-index-scope.d.ts +14 -0
  42. package/dist/migrations/018-memory-index-scope.js +18 -0
  43. package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
  44. package/dist/migrations/019-memory-index-enabled.js +14 -0
  45. package/dist/migrations/020-project-memory.d.ts +11 -0
  46. package/dist/migrations/020-project-memory.js +13 -0
  47. package/dist/migrations/021-background-runs.d.ts +17 -0
  48. package/dist/migrations/021-background-runs.js +67 -0
  49. package/dist/migrations/022-background-run-process-id.d.ts +14 -0
  50. package/dist/migrations/022-background-run-process-id.js +18 -0
  51. package/dist/migrations/023-session-worktree.d.ts +12 -0
  52. package/dist/migrations/023-session-worktree.js +16 -0
  53. package/dist/migrations/024-blob-refs.d.ts +15 -0
  54. package/dist/migrations/024-blob-refs.js +26 -0
  55. package/dist/migrations/025-packs-pipelines.d.ts +28 -0
  56. package/dist/migrations/025-packs-pipelines.js +82 -0
  57. package/dist/migrations/026-instance-skills.d.ts +17 -0
  58. package/dist/migrations/026-instance-skills.js +25 -0
  59. package/dist/migrations/027-context-files.d.ts +20 -0
  60. package/dist/migrations/027-context-files.js +30 -0
  61. package/dist/migrations/028-message-reasoning-signature.d.ts +13 -0
  62. package/dist/migrations/028-message-reasoning-signature.js +19 -0
  63. package/dist/migrations/029-message-stream-v2.d.ts +22 -0
  64. package/dist/migrations/029-message-stream-v2.js +33 -0
  65. package/dist/migrations/030-session-retry.d.ts +12 -0
  66. package/dist/migrations/030-session-retry.js +16 -0
  67. package/dist/migrations/index.d.ts +1 -1
  68. package/dist/migrations/index.js +55 -1
  69. package/dist/pool.d.ts +6 -6
  70. package/dist/pool.js +8 -8
  71. package/dist/ports/analytics.d.ts +1 -1
  72. package/dist/ports/analytics.js +1 -1
  73. package/dist/ports/audit.d.ts +1 -1
  74. package/dist/ports/audit.js +3 -0
  75. package/dist/ports/authority.d.ts +27 -0
  76. package/dist/ports/authority.js +148 -0
  77. package/dist/ports/background-runs.d.ts +41 -0
  78. package/dist/ports/background-runs.js +179 -0
  79. package/dist/ports/blob-refs.d.ts +36 -0
  80. package/dist/ports/blob-refs.js +55 -0
  81. package/dist/ports/content.d.ts +1 -1
  82. package/dist/ports/content.js +21 -7
  83. package/dist/ports/context-files.d.ts +147 -0
  84. package/dist/ports/context-files.js +285 -0
  85. package/dist/ports/core-sync.d.ts +1 -1
  86. package/dist/ports/core-sync.js +1 -1
  87. package/dist/ports/credential-audit.d.ts +19 -0
  88. package/dist/ports/credential-audit.js +96 -0
  89. package/dist/ports/deps.d.ts +2 -2
  90. package/dist/ports/deps.js +1 -1
  91. package/dist/ports/events-bindings.d.ts +2 -2
  92. package/dist/ports/events-bindings.js +2 -2
  93. package/dist/ports/events-core.d.ts +1 -1
  94. package/dist/ports/events-core.js +1 -1
  95. package/dist/ports/events-journal.d.ts +1 -1
  96. package/dist/ports/events-journal.js +1 -1
  97. package/dist/ports/events-scheduler.d.ts +1 -1
  98. package/dist/ports/events-scheduler.js +20 -12
  99. package/dist/ports/events-webhooks.d.ts +1 -1
  100. package/dist/ports/events-webhooks.js +1 -1
  101. package/dist/ports/events.d.ts +1 -1
  102. package/dist/ports/events.js +1 -1
  103. package/dist/ports/external-credentials.d.ts +6 -0
  104. package/dist/ports/external-credentials.js +363 -0
  105. package/dist/ports/legacy-pipelines.d.ts +50 -0
  106. package/dist/ports/legacy-pipelines.js +202 -0
  107. package/dist/ports/memory.d.ts +65 -0
  108. package/dist/ports/memory.js +471 -0
  109. package/dist/ports/packs.d.ts +32 -0
  110. package/dist/ports/packs.js +117 -0
  111. package/dist/ports/pipelines.d.ts +67 -0
  112. package/dist/ports/pipelines.js +297 -0
  113. package/dist/ports/plugin-audit.d.ts +14 -0
  114. package/dist/ports/plugin-audit.js +110 -0
  115. package/dist/ports/plugin-lock.d.ts +27 -0
  116. package/dist/ports/plugin-lock.js +145 -0
  117. package/dist/ports/principals-defaults.d.ts +1 -1
  118. package/dist/ports/principals-defaults.js +21 -1
  119. package/dist/ports/principals-documents.d.ts +1 -1
  120. package/dist/ports/principals-documents.js +1 -1
  121. package/dist/ports/principals-profiles.d.ts +1 -1
  122. package/dist/ports/principals-profiles.js +1 -1
  123. package/dist/ports/principals-projects.d.ts +1 -1
  124. package/dist/ports/principals-projects.js +82 -47
  125. package/dist/ports/principals-settings.d.ts +1 -1
  126. package/dist/ports/principals-settings.js +57 -1
  127. package/dist/ports/principals-shared.d.ts +1 -1
  128. package/dist/ports/principals-shared.js +1 -1
  129. package/dist/ports/principals.d.ts +1 -1
  130. package/dist/ports/principals.js +1 -1
  131. package/dist/ports/questions.d.ts +40 -0
  132. package/dist/ports/questions.js +135 -0
  133. package/dist/ports/sessions-mapping.d.ts +80 -6
  134. package/dist/ports/sessions-mapping.js +165 -8
  135. package/dist/ports/sessions.d.ts +62 -8
  136. package/dist/ports/sessions.js +96 -20
  137. package/dist/ports/skills.d.ts +59 -0
  138. package/dist/ports/skills.js +205 -0
  139. package/dist/ports/stub.d.ts +1 -1
  140. package/dist/ports/stub.js +2 -2
  141. package/dist/ports/worktrees.d.ts +41 -0
  142. package/dist/ports/worktrees.js +85 -0
  143. package/dist/postgres-storage.d.ts +4 -5
  144. package/dist/postgres-storage.js +5 -6
  145. package/dist/storage-context.d.ts +44 -15
  146. package/dist/storage-context.js +139 -31
  147. package/package.json +4 -4
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Отображение строк PostgreSQL ↔ доменных объектов порта `SessionRepository`
3
- * (PROP-032, волна 3b).
3
+ * (ADR-097, волна 3b).
4
4
  *
5
5
  * Эталон семантики — файловая реализация (`core/src/storage/file-store.ts`):
6
6
  * `serializeSession`/`serializeMessage` и `deserializeSession`/`deserializeMessage`
@@ -18,7 +18,7 @@
18
18
  * `buildContentFromParts`, `generateId`) берутся напрямую из
19
19
  * `@itphx/synth-shared` — обычной зависимости драйвера (ADR-097).
20
20
  */
21
- import { type Checkpoint, type Message, type Session, type SessionReference, type StickyNote } from '@itphx/synth-shared';
21
+ import { type Checkpoint, type Message, type Part, type Session, type SessionReference, type SessionRetryState, type SessionWorktree, type StickyNote } from '@itphx/synth-shared';
22
22
  /** Строка `sessions` (jsonb — уже разобранные значения; `bigint` — строка). */
23
23
  export interface SessionRow {
24
24
  id: string;
@@ -30,9 +30,16 @@ export interface SessionRow {
30
30
  branch_point: string | null;
31
31
  plan_approved: boolean | null;
32
32
  mode: string | null;
33
+ /** ADR-106 Ф4 (шаг C): режим по принципалу (переопределения режима сессии). */
34
+ mode_by_principal: unknown;
33
35
  user_id: string | null;
34
36
  owner_id: string | null;
35
37
  project_id: string | null;
38
+ /**
39
+ * ADR-114: привязка сессии к worktree (jsonb). В записях, созданных до
40
+ * миграции `023`, поля нет — чтение даёт `undefined`.
41
+ */
42
+ worktree?: unknown;
36
43
  todos: unknown;
37
44
  prompt_states: unknown;
38
45
  obfuscation_map: unknown;
@@ -40,7 +47,14 @@ export interface SessionRow {
40
47
  settings: unknown;
41
48
  mcp_servers: unknown;
42
49
  pending_messages: unknown;
50
+ /** ADR-104: очередь инъекций (steering) — отдельно от `pending_messages`. */
51
+ steer_inbox: unknown;
43
52
  current_stream: unknown;
53
+ /**
54
+ * Персистентное состояние ретрая сессии (jsonb, миграция `030`). В записях,
55
+ * созданных до миграции, поля нет — чтение даёт `undefined`.
56
+ */
57
+ retry?: unknown;
44
58
  summarization_pending: boolean;
45
59
  can_summarize: boolean;
46
60
  created_at: string | Date;
@@ -64,6 +78,17 @@ export interface MessageRow {
64
78
  id: string;
65
79
  session_id?: string;
66
80
  seq: number;
81
+ /**
82
+ * ADR-118 §2: **монотонный** счётчик порядка записи в историю сессии.
83
+ * В записях до миграции `029` колонки нет — чтение даёт `undefined`.
84
+ */
85
+ ord?: number | null;
86
+ /** ADR-118 §1: идентификатор хода (`Turn`). */
87
+ turn_id?: string | null;
88
+ /** ADR-118 §1: индекс шага внутри хода (0-based). */
89
+ step_index?: number | null;
90
+ /** ADR-118 §5: статус сообщения-хода (`streaming`/`completed`/`cancelled`/`error`). */
91
+ status?: string | null;
67
92
  role: string;
68
93
  origin: string;
69
94
  source_msg_id?: string | null;
@@ -80,6 +105,10 @@ export interface MessageRow {
80
105
  provider?: string | null;
81
106
  provider_type?: string | null;
82
107
  reasoning?: string | null;
108
+ /** Anthropic: подпись thinking-блока (миграция `028`). */
109
+ reasoning_signature?: string | null;
110
+ /** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
111
+ reasoning_redacted?: unknown;
83
112
  source?: string | null;
84
113
  author?: string | null;
85
114
  agent_role?: string | null;
@@ -127,11 +156,13 @@ export interface SessionChildren {
127
156
  }
128
157
  /** Пустой набор child-данных (сессия без сообщений/ссылок/чекпоинтов). */
129
158
  export declare function emptySessionChildren(): SessionChildren;
130
- /** Часть сообщения в форме хранения (`{id, type, data}`). */
159
+ /** Часть сообщения в форме хранения (`{id, type, data}` + аддитивные `metadata`). */
131
160
  export interface SerializedPart {
132
161
  id: string;
133
162
  type: string;
134
163
  data: unknown;
164
+ /** Anthropic thinking: подпись/redacted части (аддитивное поле). */
165
+ metadata?: Part['metadata'];
135
166
  }
136
167
  /** Usage сообщения в форме хранения (snake_case — как в файловом backend). */
137
168
  export interface SerializedUsage {
@@ -147,6 +178,16 @@ export interface SerializedMessage {
147
178
  id: string;
148
179
  role: string;
149
180
  seq: number;
181
+ /**
182
+ * ADR-118 §2: монотонный порядок записи (`ord`) — **не** перенумеровывается.
183
+ */
184
+ ord?: number;
185
+ /** ADR-118 §1: ход (`turn_id`). */
186
+ turn_id?: string;
187
+ /** ADR-118 §1: шаг внутри хода (`step_index`, 0-based). */
188
+ step_index?: number;
189
+ /** ADR-118 §5: статус сообщения. */
190
+ status?: string;
150
191
  origin: string;
151
192
  source_msg_id?: string;
152
193
  parts: SerializedPart[];
@@ -164,6 +205,10 @@ export interface SerializedMessage {
164
205
  provider_type?: string;
165
206
  usage?: SerializedUsage;
166
207
  reasoning?: string;
208
+ /** Anthropic: подпись thinking-блока (миграция `028`). */
209
+ reasoning_signature?: string;
210
+ /** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
211
+ reasoning_redacted?: string[];
167
212
  source?: string;
168
213
  author?: string;
169
214
  agent_role?: string;
@@ -221,6 +266,22 @@ export declare function deserializeCheckpoint(row: CheckpointRow): Checkpoint;
221
266
  export declare function stickyNoteRow(sessionId: string, note: StickyNote): Record<string, unknown>;
222
267
  /** Строка `sticky_notes` → доменная заметка. */
223
268
  export declare function deserializeStickyNote(row: StickyNoteRow): StickyNote;
269
+ /**
270
+ * ADR-114: привязка сессии к worktree из jsonb-колонки `sessions.worktree`.
271
+ *
272
+ * Терпима к отсутствию поля (записи до миграции `023`) и к частичным
273
+ * значениям: привязка без `worktree_id`/`directory` бессмысленна — она
274
+ * игнорируется, сессия работает как прежде.
275
+ */
276
+ export declare function deserializeSessionWorktree(data: unknown): SessionWorktree | undefined;
277
+ /**
278
+ * Значение `sessions.retry` → доменное состояние ретрая.
279
+ *
280
+ * Форма хранения — snake_case (`stream_id`/`attempt`/`max_retries`/`retry_at`/
281
+ * `error`), как в JSON-файловом backend. Legacy-записи (без поля) и битые
282
+ * значения читаются как «ретрая нет» (`undefined`).
283
+ */
284
+ export declare function deserializeSessionRetry(data: unknown): SessionRetryState | undefined;
224
285
  /**
225
286
  * Строка `sessions` + child-данные → доменная сессия: дословный
226
287
  * `deserializeSession` файловой реализации (нормализация иконки/цвета,
@@ -230,8 +291,21 @@ export declare function deserializeStickyNote(row: StickyNoteRow): StickyNote;
230
291
  export declare function deserializeSession(row: SessionRow, children: SessionChildren): Session;
231
292
  /**
232
293
  * Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
233
- * PROP-032): `messages`/`pendingMessages`/`checkpoints` пусты, child-таблицы не
234
- * читаются. Метаданные (id/статус/settings/projectId/expiresAt/…) идентичны
235
- * `deserializeSession` — механика переиспользуется.
294
+ * ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
295
+ * сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
296
+ * истории не тянут, нужны recovery/автозапуску). Метаданные
297
+ * (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
298
+ * механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
236
299
  */
237
300
  export declare function deserializeSessionLight(row: SessionRow): Session;
301
+ /**
302
+ * Строка `sessions` → доменная сессия **без истории и без очереди**
303
+ * (`SessionRepository.loadLight`, ADR-097): `messages`/`checkpoints` пусты и
304
+ * `pendingMessages`/`steerInbox` **тоже** — контракт порта (`loadLight`
305
+ * возвращает только атрибуты сессии, очередь нужна лишь recovery/автозапуску
306
+ * через `listLight`). Child-таблицы не читаются.
307
+ *
308
+ * Строится поверх `deserializeSessionLight` (та же метапроекция), поэтому
309
+ * остальные поля идентичны `deserializeSession`; отличается только очередь.
310
+ */
311
+ export declare function deserializeSessionMeta(row: SessionRow): Session;
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Отображение строк PostgreSQL ↔ доменных объектов порта `SessionRepository`
3
- * (PROP-032, волна 3b).
3
+ * (ADR-097, волна 3b).
4
4
  *
5
5
  * Эталон семантики — файловая реализация (`core/src/storage/file-store.ts`):
6
6
  * `serializeSession`/`serializeMessage` и `deserializeSession`/`deserializeMessage`
@@ -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
+ 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,
@@ -225,9 +276,20 @@ export function serializeSession(session) {
225
276
  branch_point: session.branchPoint ?? null,
226
277
  plan_approved: session.planApproved ?? null,
227
278
  mode: session.mode ?? null,
279
+ mode_by_principal: session.modeByPrincipal ?? null,
228
280
  user_id: session.userId ?? null,
229
281
  owner_id: session.ownerId ?? null,
230
282
  project_id: session.projectId ?? null,
283
+ // ADR-114: привязка к worktree (объект в snake_case — как в JSON-файле).
284
+ worktree: session.worktree
285
+ ? {
286
+ worktree_id: session.worktree.worktreeId,
287
+ project_id: session.worktree.projectId,
288
+ ...(session.worktree.repoPath !== undefined ? { repo_path: session.worktree.repoPath } : {}),
289
+ directory: session.worktree.directory,
290
+ branch: session.worktree.branch,
291
+ }
292
+ : null,
231
293
  todos: session.todos ?? null,
232
294
  prompt_states: session.promptStates ?? null,
233
295
  obfuscation_map: session.obfuscationMap ?? null,
@@ -235,6 +297,7 @@ export function serializeSession(session) {
235
297
  settings: session.settings ?? {},
236
298
  mcp_servers: session.mcpServers ?? null,
237
299
  pending_messages: (session.pendingMessages ?? []).map((msg) => serializeMessage(msg)),
300
+ steer_inbox: (session.steerInbox ?? []).map((msg) => serializeMessage(msg)),
238
301
  current_stream: session.currentStream
239
302
  ? {
240
303
  stream_id: session.currentStream.streamId,
@@ -242,6 +305,23 @@ export function serializeSession(session) {
242
305
  agent_role: session.currentStream.agentRole,
243
306
  started_at: session.currentStream.startedAt,
244
307
  cancelled: session.currentStream.cancelled,
308
+ // ADR-118 §10: метка хода живого стрима — без неё теряется при
309
+ // перечитывании сессии из БД (`current_stream.turn_id` в DTO).
310
+ turn_id: session.currentStream.turnId ?? null,
311
+ // Владелец маркера хода (процесс инстанса): по нему рестарт отличает
312
+ // живой ход от маркера убитого процесса.
313
+ ...(session.currentStream.owner ? { owner: session.currentStream.owner } : {}),
314
+ }
315
+ : null,
316
+ // Персистентное состояние ретрая (переживает reload/restart): snake_case —
317
+ // как в JSON-файловом backend.
318
+ retry: session.retry
319
+ ? {
320
+ stream_id: session.retry.streamId,
321
+ attempt: session.retry.attempt,
322
+ max_retries: session.retry.maxRetries,
323
+ retry_at: session.retry.retryAt,
324
+ ...(session.retry.error ? { error: session.retry.error } : {}),
245
325
  }
246
326
  : null,
247
327
  summarization_pending: session.summarizationPending ?? false,
@@ -330,6 +410,52 @@ export function deserializeStickyNote(row) {
330
410
  disabled: row.disabled,
331
411
  };
332
412
  }
413
+ /**
414
+ * ADR-114: привязка сессии к worktree из jsonb-колонки `sessions.worktree`.
415
+ *
416
+ * Терпима к отсутствию поля (записи до миграции `023`) и к частичным
417
+ * значениям: привязка без `worktree_id`/`directory` бессмысленна — она
418
+ * игнорируется, сессия работает как прежде.
419
+ */
420
+ export function deserializeSessionWorktree(data) {
421
+ if (typeof data !== 'object' || data === null)
422
+ return undefined;
423
+ const raw = data;
424
+ const worktreeId = typeof raw.worktree_id === 'string' ? raw.worktree_id : '';
425
+ const directory = typeof raw.directory === 'string' ? raw.directory : '';
426
+ if (!worktreeId || !directory)
427
+ return undefined;
428
+ return {
429
+ worktreeId,
430
+ projectId: typeof raw.project_id === 'string' ? raw.project_id : '',
431
+ ...(typeof raw.repo_path === 'string' ? { repoPath: raw.repo_path } : {}),
432
+ directory,
433
+ branch: typeof raw.branch === 'string' ? raw.branch : '',
434
+ };
435
+ }
436
+ /**
437
+ * Значение `sessions.retry` → доменное состояние ретрая.
438
+ *
439
+ * Форма хранения — snake_case (`stream_id`/`attempt`/`max_retries`/`retry_at`/
440
+ * `error`), как в JSON-файловом backend. Legacy-записи (без поля) и битые
441
+ * значения читаются как «ретрая нет» (`undefined`).
442
+ */
443
+ export function deserializeSessionRetry(data) {
444
+ if (typeof data !== 'object' || data === null)
445
+ return undefined;
446
+ const raw = data;
447
+ const streamId = typeof raw.stream_id === 'string' ? raw.stream_id : '';
448
+ const retryAt = typeof raw.retry_at === 'string' ? raw.retry_at : '';
449
+ if (!streamId || !retryAt)
450
+ return undefined;
451
+ return {
452
+ streamId,
453
+ attempt: typeof raw.attempt === 'number' ? raw.attempt : 0,
454
+ maxRetries: typeof raw.max_retries === 'number' ? raw.max_retries : 0,
455
+ retryAt,
456
+ ...(typeof raw.error === 'string' && raw.error ? { error: raw.error } : {}),
457
+ };
458
+ }
333
459
  /**
334
460
  * Строка `sessions` + child-данные → доменная сессия: дословный
335
461
  * `deserializeSession` файловой реализации (нормализация иконки/цвета,
@@ -338,6 +464,8 @@ export function deserializeStickyNote(row) {
338
464
  */
339
465
  export function deserializeSession(row, children) {
340
466
  const currentStream = row.current_stream;
467
+ // ADR-114: привязка к worktree (legacy-записи без поля → undefined).
468
+ const worktree = deserializeSessionWorktree(row.worktree);
341
469
  return {
342
470
  id: row.id,
343
471
  title: row.title ?? undefined,
@@ -347,6 +475,10 @@ export function deserializeSession(row, children) {
347
475
  branchPoint: row.branch_point ?? undefined,
348
476
  planApproved: row.plan_approved ?? undefined,
349
477
  mode: (row.mode ?? undefined),
478
+ // ADR-106 Ф4 (шаг C): режим по принципалу.
479
+ ...(row.mode_by_principal && Object.keys(row.mode_by_principal).length > 0
480
+ ? { modeByPrincipal: row.mode_by_principal }
481
+ : {}),
350
482
  todos: (row.todos ?? undefined),
351
483
  promptStates: (row.prompt_states ?? undefined),
352
484
  obfuscationMap: (row.obfuscation_map ?? undefined),
@@ -354,8 +486,11 @@ export function deserializeSession(row, children) {
354
486
  userId: row.user_id ?? undefined,
355
487
  ownerId: row.owner_id ?? undefined,
356
488
  projectId: row.project_id ?? undefined,
489
+ // ADR-114: привязка к worktree (legacy-записи без поля → undefined).
490
+ ...(worktree ? { worktree } : {}),
357
491
  messages: children.messages.map(deserializeMessage),
358
492
  pendingMessages: (row.pending_messages ?? []).map(deserializeMessage),
493
+ steerInbox: (row.steer_inbox ?? []).map(deserializeMessage),
359
494
  status: (row.status ?? {}),
360
495
  settings: (row.settings ?? {}),
361
496
  mcpServers: (row.mcp_servers ?? undefined),
@@ -369,8 +504,13 @@ export function deserializeSession(row, children) {
369
504
  agentRole: currentStream.agent_role,
370
505
  startedAt: currentStream.started_at,
371
506
  cancelled: currentStream.cancelled,
507
+ // ADR-118 §10: метка хода живого стрима (legacy-сессии — нет).
508
+ turnId: currentStream.turn_id ?? undefined,
509
+ owner: currentStream.owner ?? undefined,
372
510
  }
373
511
  : undefined,
512
+ // Персистентное состояние ретрая (legacy-записи без поля → undefined).
513
+ retry: deserializeSessionRetry(row.retry),
374
514
  summarizationPending: row.summarization_pending ?? false,
375
515
  canSummarize: row.can_summarize ?? false,
376
516
  createdAt: toIso(row.created_at),
@@ -392,14 +532,31 @@ export function deserializeSession(row, children) {
392
532
  }
393
533
  /**
394
534
  * Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
395
- * PROP-032): `messages`/`pendingMessages`/`checkpoints` пусты, child-таблицы не
396
- * читаются. Метаданные (id/статус/settings/projectId/expiresAt/…) идентичны
397
- * `deserializeSession` — механика переиспользуется.
535
+ * ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
536
+ * сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
537
+ * истории не тянут, нужны recovery/автозапуску). Метаданные
538
+ * (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
539
+ * механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
398
540
  */
399
541
  export function deserializeSessionLight(row) {
400
542
  const session = deserializeSession(row, emptySessionChildren());
401
543
  session.messages = [];
402
- session.pendingMessages = [];
403
544
  session.checkpoints = [];
404
545
  return session;
405
546
  }
547
+ /**
548
+ * Строка `sessions` → доменная сессия **без истории и без очереди**
549
+ * (`SessionRepository.loadLight`, ADR-097): `messages`/`checkpoints` пусты и
550
+ * `pendingMessages`/`steerInbox` **тоже** — контракт порта (`loadLight`
551
+ * возвращает только атрибуты сессии, очередь нужна лишь recovery/автозапуску
552
+ * через `listLight`). Child-таблицы не читаются.
553
+ *
554
+ * Строится поверх `deserializeSessionLight` (та же метапроекция), поэтому
555
+ * остальные поля идентичны `deserializeSession`; отличается только очередь.
556
+ */
557
+ export function deserializeSessionMeta(row) {
558
+ const session = deserializeSessionLight(row);
559
+ session.pendingMessages = [];
560
+ session.steerInbox = [];
561
+ return session;
562
+ }
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Порт `SessionRepository` поверх PostgreSQL (PROP-032, волна 3b).
2
+ * Порт `SessionRepository` поверх PostgreSQL (ADR-097, волна 3b).
3
3
  *
4
4
  * Группа портов **сессий** PostgreSQL-драйвера: единственная фабрика
5
5
  * `buildSessionPorts(deps)` собирает `StorageContext['sessions']`.
@@ -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 реализаций);
@@ -50,13 +61,45 @@ import type { SessionFilter, SessionRepository, StorageContext } from '@itphx/sy
50
61
  import type { PortDeps } from './deps.js';
51
62
  /** Часть `StorageContext`, которой владеет группа `sessions`. */
52
63
  export type SessionPorts = Pick<StorageContext, 'sessions'>;
64
+ /**
65
+ * Колонки `sessions` (порядок — как в `001_init`).
66
+ *
67
+ * Экспортируется для unit-тестов сериализации (как `MESSAGE_MUTABLE_FIELDS`):
68
+ * тест проверяет, что новая колонка (`worktree`, ADR-114) реально попадает в
69
+ * `INSERT` и читается обратно.
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"];
72
+ /** jsonb-колонки `sessions` (экспортируется для unit-тестов сериализации). */
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>;
53
77
  /**
54
78
  * Колонки `messages`, которые заменяет `updateMessage`. Неизменяемые —
55
79
  * суррогатный `message_uid` (PK), доменный `id`, `session_id`, позиционный
56
80
  * `seq` и `created_at`: они сохраняются от исходной строки (цель ищется по
57
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-тестов (живая БД не нужна).
58
101
  */
59
- export declare const MESSAGE_MUTABLE_FIELDS: ("origin" | "author" | "source" | "usage" | "model" | "provider" | "ephemeral" | "role" | "reasoning" | "content" | "disabled" | "pinned" | "hidden" | "metadata" | "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;
60
103
  /** Значение для jsonb-колонки: нативный объект/массив → JSON-строка (NUL — вычищены). */
61
104
  export declare function jsonParam(value: unknown): string | null;
62
105
  /**
@@ -80,6 +123,12 @@ export declare class PostgresSessionRepository implements SessionRepository {
80
123
  * транзакция + per-session advisory-лок (как у `save`), `seq = MAX(seq)+1`
81
124
  * вычисляется в той же транзакции, `INSERT` одной строки, обновление
82
125
  * `sessions.updated_at`. Остальная история не перезаписывается.
126
+ *
127
+ * ADR-118 §2: `ord` — **монотонный** счётчик сессии (`MAX(ord)+1` по
128
+ * сессии), выдаётся в момент материализации записи в историю; ранее
129
+ * выданные значения не перенумеровываются. Если вызывающий уже проставил
130
+ * `ord` (например, перенос записи), его значение сохраняется — порт не
131
+ * перетирает выданный порядок.
83
132
  */
84
133
  appendMessage(sessionId: string, message: Message): Promise<Message | null>;
85
134
  /**
@@ -87,11 +136,16 @@ export declare class PostgresSessionRepository implements SessionRepository {
87
136
  * транзакция + per-session advisory-лок; цель — по `seq` (первая по
88
137
  * `seq, created_at, id`), fallback по `id`. `message_uid`/`id`/`seq`/
89
138
  * `created_at` исходной строки не меняются, `sessions.updated_at` обновляется.
139
+ *
140
+ * ADR-118: `ord` не перенумеровывается — уже выданное значение сохраняется
141
+ * (`COALESCE(messages.ord, …)`), а ещё не выданное (legacy-строка без
142
+ * `ord`) может быть проставлено (миграция данных ядра).
90
143
  */
91
144
  updateMessage(sessionId: string, message: Message): Promise<Message | null>;
92
145
  /**
93
- * Метаданные сессии без истории (`SessionRepository.loadLight`): одна
94
- * выборка по PK, child-таблицы не читаются.
146
+ * Метаданные сессии без истории и без очереди (`SessionRepository.loadLight`):
147
+ * одна выборка по PK, child-таблицы не читаются, `pendingMessages`/`steerInbox`
148
+ * пусты (очередь отдаёт только `listLight` — recovery/автозапуску).
95
149
  */
96
150
  loadLight(sessionId: string): Promise<Session | null>;
97
151
  delete(sessionId: string): Promise<void>;
@@ -124,7 +178,7 @@ export declare class PostgresSessionRepository implements SessionRepository {
124
178
  * первая по `seq, created_at, id`), затем fallback по доменному `id`.
125
179
  */
126
180
  private _findMessageUid;
127
- /** PROP-032: per-session сериализация записи — транзакционный advisory-лок. */
181
+ /** ADR-097: per-session сериализация записи — транзакционный advisory-лок. */
128
182
  private _lockSession;
129
183
  /** `addReference`/`removeReference` отсутствующей сессии → ошибка (как в file/memory). */
130
184
  private _assertSessionExists;