@itphx/synth-storage-postgres 0.0.0-stage → 0.12.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 (150) hide show
  1. package/LICENSE +18 -0
  2. package/LICENSE.ru.md +31 -0
  3. package/dist/errors.d.ts +71 -0
  4. package/dist/errors.js +126 -0
  5. package/dist/index.d.ts +51 -0
  6. package/dist/index.js +56 -0
  7. package/dist/json-param.d.ts +14 -0
  8. package/dist/json-param.js +22 -0
  9. package/dist/locks.d.ts +104 -0
  10. package/dist/locks.js +201 -0
  11. package/dist/migrate.d.ts +58 -0
  12. package/dist/migrate.js +125 -0
  13. package/dist/migrations/001-init.d.ts +15 -0
  14. package/dist/migrations/001-init.js +457 -0
  15. package/dist/migrations/002-egress-audit.d.ts +12 -0
  16. package/dist/migrations/002-egress-audit.js +52 -0
  17. package/dist/migrations/003-analytics-rollups.d.ts +12 -0
  18. package/dist/migrations/003-analytics-rollups.js +21 -0
  19. package/dist/migrations/004-pipeline-engine.d.ts +19 -0
  20. package/dist/migrations/004-pipeline-engine.js +74 -0
  21. package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
  22. package/dist/migrations/005-pipeline-provenance.js +15 -0
  23. package/dist/migrations/006-plugin-audit.d.ts +13 -0
  24. package/dist/migrations/006-plugin-audit.js +34 -0
  25. package/dist/migrations/007-plugin-lock.d.ts +10 -0
  26. package/dist/migrations/007-plugin-lock.js +25 -0
  27. package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
  28. package/dist/migrations/008-plugin-audit-scan.js +15 -0
  29. package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
  30. package/dist/migrations/009-plugin-lock-previous.js +16 -0
  31. package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
  32. package/dist/migrations/010-plugin-lock-mode.js +20 -0
  33. package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
  34. package/dist/migrations/011-session-steer-inbox.js +14 -0
  35. package/dist/migrations/012-external-credentials.d.ts +15 -0
  36. package/dist/migrations/012-external-credentials.js +40 -0
  37. package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
  38. package/dist/migrations/013-service-key-plugin-id.js +20 -0
  39. package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
  40. package/dist/migrations/014-session-mode-by-principal.js +15 -0
  41. package/dist/migrations/015-authority.d.ts +17 -0
  42. package/dist/migrations/015-authority.js +43 -0
  43. package/dist/migrations/016-credential-audit.d.ts +17 -0
  44. package/dist/migrations/016-credential-audit.js +32 -0
  45. package/dist/migrations/017-memory.d.ts +29 -0
  46. package/dist/migrations/017-memory.js +95 -0
  47. package/dist/migrations/018-memory-index-scope.d.ts +14 -0
  48. package/dist/migrations/018-memory-index-scope.js +18 -0
  49. package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
  50. package/dist/migrations/019-memory-index-enabled.js +14 -0
  51. package/dist/migrations/020-project-memory.d.ts +11 -0
  52. package/dist/migrations/020-project-memory.js +13 -0
  53. package/dist/migrations/021-background-runs.d.ts +17 -0
  54. package/dist/migrations/021-background-runs.js +67 -0
  55. package/dist/migrations/022-background-run-process-id.d.ts +14 -0
  56. package/dist/migrations/022-background-run-process-id.js +18 -0
  57. package/dist/migrations/023-session-worktree.d.ts +12 -0
  58. package/dist/migrations/023-session-worktree.js +16 -0
  59. package/dist/migrations/024-blob-refs.d.ts +15 -0
  60. package/dist/migrations/024-blob-refs.js +26 -0
  61. package/dist/migrations/025-packs-pipelines.d.ts +28 -0
  62. package/dist/migrations/025-packs-pipelines.js +82 -0
  63. package/dist/migrations/026-instance-skills.d.ts +17 -0
  64. package/dist/migrations/026-instance-skills.js +25 -0
  65. package/dist/migrations/027-context-files.d.ts +20 -0
  66. package/dist/migrations/027-context-files.js +30 -0
  67. package/dist/migrations/index.d.ts +23 -0
  68. package/dist/migrations/index.js +71 -0
  69. package/dist/pool.d.ts +178 -0
  70. package/dist/pool.js +382 -0
  71. package/dist/ports/analytics.d.ts +26 -0
  72. package/dist/ports/analytics.js +243 -0
  73. package/dist/ports/audit.d.ts +15 -0
  74. package/dist/ports/audit.js +192 -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 +41 -0
  82. package/dist/ports/content.js +1553 -0
  83. package/dist/ports/context-files.d.ts +145 -0
  84. package/dist/ports/context-files.js +279 -0
  85. package/dist/ports/core-sync.d.ts +31 -0
  86. package/dist/ports/core-sync.js +34 -0
  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 +63 -0
  90. package/dist/ports/deps.js +19 -0
  91. package/dist/ports/events-bindings.d.ts +77 -0
  92. package/dist/ports/events-bindings.js +356 -0
  93. package/dist/ports/events-core.d.ts +35 -0
  94. package/dist/ports/events-core.js +71 -0
  95. package/dist/ports/events-journal.d.ts +68 -0
  96. package/dist/ports/events-journal.js +211 -0
  97. package/dist/ports/events-scheduler.d.ts +49 -0
  98. package/dist/ports/events-scheduler.js +231 -0
  99. package/dist/ports/events-webhooks.d.ts +64 -0
  100. package/dist/ports/events-webhooks.js +268 -0
  101. package/dist/ports/events.d.ts +20 -0
  102. package/dist/ports/events.js +27 -0
  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 +21 -0
  118. package/dist/ports/principals-defaults.js +68 -0
  119. package/dist/ports/principals-documents.d.ts +23 -0
  120. package/dist/ports/principals-documents.js +38 -0
  121. package/dist/ports/principals-profiles.d.ts +21 -0
  122. package/dist/ports/principals-profiles.js +263 -0
  123. package/dist/ports/principals-projects.d.ts +19 -0
  124. package/dist/ports/principals-projects.js +161 -0
  125. package/dist/ports/principals-settings.d.ts +25 -0
  126. package/dist/ports/principals-settings.js +295 -0
  127. package/dist/ports/principals-shared.d.ts +33 -0
  128. package/dist/ports/principals-shared.js +44 -0
  129. package/dist/ports/principals.d.ts +27 -0
  130. package/dist/ports/principals.js +39 -0
  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 +254 -0
  134. package/dist/ports/sessions-mapping.js +449 -0
  135. package/dist/ports/sessions.d.ts +143 -0
  136. package/dist/ports/sessions.js +517 -0
  137. package/dist/ports/skills.d.ts +59 -0
  138. package/dist/ports/skills.js +205 -0
  139. package/dist/ports/stub.d.ts +14 -0
  140. package/dist/ports/stub.js +32 -0
  141. package/dist/ports/worktrees.d.ts +41 -0
  142. package/dist/ports/worktrees.js +85 -0
  143. package/dist/postgres-storage.d.ts +58 -0
  144. package/dist/postgres-storage.js +110 -0
  145. package/dist/schema.d.ts +13 -0
  146. package/dist/schema.js +22 -0
  147. package/dist/storage-context.d.ts +80 -0
  148. package/dist/storage-context.js +238 -0
  149. package/package.json +40 -3
  150. package/README.md +0 -3
@@ -0,0 +1,471 @@
1
+ /**
2
+ * PG-реализация портов **памяти**: факты, индексы и чанки (PROP-047 §2.1
3
+ * «предпосылка A», ADR-097).
4
+ *
5
+ * Таблицы (миграция 017): `memory_facts`, `memory_indexes`, `memory_chunks`.
6
+ *
7
+ * Семантика повторяет файловые реализации core (`FileMemoryFactStore`,
8
+ * `FileMemoryIndexStore`) и in-memory (`MemoryFactRepository`/
9
+ * `MemoryIndexRepository`):
10
+ * - upsert по `id`: `created_at` не перезаписывается, `updated_at` монотонно
11
+ * не убывает (в SQL — `GREATEST` + сдвиг 1 мс, паритет с
12
+ * `record-timestamps.ts` core);
13
+ * - список — «свежие первыми» (`created_at` убыв., тайбрейкер `id`), фильтры —
14
+ * по «И», `limit` — дефолт 100 / потолок 1000, `offset` — пропуск;
15
+ * - `supersede` — **идемпотентно**: статус `superseded` + `superseded_by`;
16
+ * - `replaceChunks` — **атомарная замена поколения** в транзакции: чанки
17
+ * поколения удаляются и пишутся заново, другие поколения не трогаются;
18
+ * `indexId`/`generation` чанка приводятся к аргументам метода (идентичность
19
+ * поколения задаёт вызывающий — так поведение одинаково на всех backend'ах);
20
+ * - `deleteIndex` — **каскад** (чанки удаляются вместе с индексом).
21
+ *
22
+ * Векторы хранятся в `jsonb` (не `pgvector`: расширение в БД не установлено,
23
+ * `CREATE EXTENSION` требует прав администратора — миграция должна проходить на
24
+ * «голой» БД). ANN-поиск в порт не входит — retrieval в плагине (PROP-047 §3).
25
+ *
26
+ * Драйвер не тянет core рантаймом (только `import type`), поэтому потолок
27
+ * выборки и правило timestamps повторены здесь локально — как в
28
+ * `ports/pipelines.ts`.
29
+ */
30
+ import { jsonbParam } from '../json-param.js';
31
+ import { compact, toIso, toIsoRequired } from './events-core.js';
32
+ // ── Локальные реплики core-хелперов (core не тянется рантаймом) ──────────────
33
+ /** Дефолтный потолок выборки (паритет с core `COLLECTION_LIMIT_DEFAULT`). */
34
+ const LIST_DEFAULT_LIMIT = 100;
35
+ /** Абсолютный потолок выборки (паритет с core `COLLECTION_LIMIT_MAX`). */
36
+ const LIST_MAX_LIMIT = 1000;
37
+ /** Привести `limit` к допустимому виду: дефолт 100, потолок 1000. */
38
+ function resolveLimit(limit) {
39
+ if (limit === undefined || !Number.isFinite(limit) || limit <= 0)
40
+ return LIST_DEFAULT_LIMIT;
41
+ return Math.min(Math.floor(limit), LIST_MAX_LIMIT);
42
+ }
43
+ /** Смещение пагинации: неотрицательное целое (по умолчанию — 0). */
44
+ function resolveOffset(offset) {
45
+ if (offset === undefined || !Number.isFinite(offset) || offset <= 0)
46
+ return 0;
47
+ return Math.floor(offset);
48
+ }
49
+ /**
50
+ * Выражение `updated_at` при upsert: максимум из «сейчас», входящего и
51
+ * сохранённого значения; если максимум совпал с сохранённым — сдвиг на 1 мс
52
+ * (паритет с `resolveUpdatedAt` в `record-timestamps.ts` core).
53
+ */
54
+ function updatedAtExpr(table) {
55
+ return `CASE
56
+ WHEN GREATEST(EXCLUDED.updated_at, ${table}.updated_at, now()) <= ${table}.updated_at
57
+ THEN ${table}.updated_at + interval '1 millisecond'
58
+ ELSE GREATEST(EXCLUDED.updated_at, ${table}.updated_at, now())
59
+ END`;
60
+ }
61
+ /**
62
+ * То же выражение для `UPDATE` (без `EXCLUDED`): параметр — новое значение
63
+ * `updated_at`.
64
+ */
65
+ function updatedAtUpdateExpr(table, param) {
66
+ return `CASE
67
+ WHEN GREATEST(${param}::timestamptz, ${table}.updated_at, now()) <= ${table}.updated_at
68
+ THEN ${table}.updated_at + interval '1 millisecond'
69
+ ELSE GREATEST(${param}::timestamptz, ${table}.updated_at, now())
70
+ END`;
71
+ }
72
+ /** Статусы факта как список (для фильтра-«И»). */
73
+ function statusList(status) {
74
+ if (status === undefined)
75
+ return undefined;
76
+ return Array.isArray(status) ? status : [status];
77
+ }
78
+ /** Состояния индекса как список (для фильтра-«И»). */
79
+ function stateList(state) {
80
+ if (state === undefined)
81
+ return undefined;
82
+ return Array.isArray(state) ? state : [state];
83
+ }
84
+ /** Запись факта из колонок. */
85
+ function toFact(row) {
86
+ return compact({
87
+ id: row.id,
88
+ namespace: row.namespace,
89
+ version: row.version,
90
+ text: row.text,
91
+ kind: row.kind,
92
+ projectId: row.project_id ?? undefined,
93
+ userId: row.user_id ?? undefined,
94
+ provenance: row.provenance,
95
+ confidence: row.confidence,
96
+ status: row.status,
97
+ createdAt: toIsoRequired(row.created_at),
98
+ updatedAt: toIsoRequired(row.updated_at),
99
+ validUntil: toIso(row.valid_until),
100
+ supersededBy: row.superseded_by ?? undefined,
101
+ revisions: (row.revisions ?? undefined),
102
+ metadata: (row.metadata ?? undefined),
103
+ });
104
+ }
105
+ /** Порт фактов памяти поверх таблицы `memory_facts`. */
106
+ export class PgMemoryFactRepository {
107
+ _deps;
108
+ constructor(_deps) {
109
+ this._deps = _deps;
110
+ }
111
+ async save(fact) {
112
+ await this._deps.connection.query(`INSERT INTO memory_facts
113
+ (id, namespace, version, text, kind, project_id, user_id, provenance,
114
+ confidence, status, created_at, updated_at, valid_until, superseded_by,
115
+ revisions, metadata)
116
+ VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, $9, $10, $11::timestamptz,
117
+ $12::timestamptz, $13::timestamptz, $14, $15::jsonb, $16::jsonb)
118
+ ON CONFLICT (id) DO UPDATE SET
119
+ namespace = EXCLUDED.namespace,
120
+ version = EXCLUDED.version,
121
+ text = EXCLUDED.text,
122
+ kind = EXCLUDED.kind,
123
+ project_id = EXCLUDED.project_id,
124
+ user_id = EXCLUDED.user_id,
125
+ provenance = EXCLUDED.provenance,
126
+ confidence = EXCLUDED.confidence,
127
+ status = EXCLUDED.status,
128
+ created_at = memory_facts.created_at,
129
+ updated_at = ${updatedAtExpr('memory_facts')},
130
+ valid_until = EXCLUDED.valid_until,
131
+ superseded_by = EXCLUDED.superseded_by,
132
+ revisions = EXCLUDED.revisions,
133
+ metadata = EXCLUDED.metadata`, [
134
+ fact.id,
135
+ fact.namespace,
136
+ fact.version,
137
+ fact.text,
138
+ fact.kind,
139
+ fact.projectId ?? null,
140
+ fact.userId ?? null,
141
+ jsonbParam(fact.provenance),
142
+ fact.confidence,
143
+ fact.status,
144
+ fact.createdAt,
145
+ fact.updatedAt,
146
+ fact.validUntil ?? null,
147
+ fact.supersededBy ?? null,
148
+ jsonbParam(fact.revisions),
149
+ jsonbParam(fact.metadata),
150
+ ]);
151
+ }
152
+ async get(id) {
153
+ const rows = await this._deps.connection.query('SELECT * FROM memory_facts WHERE id = $1 LIMIT 1', [id]);
154
+ return rows[0] ? toFact(rows[0]) : null;
155
+ }
156
+ async list(query) {
157
+ const params = [];
158
+ const where = [];
159
+ if (query?.namespace !== undefined) {
160
+ params.push(query.namespace);
161
+ where.push(`namespace = $${params.length}`);
162
+ }
163
+ if (query?.projectId !== undefined) {
164
+ params.push(query.projectId);
165
+ where.push(`project_id = $${params.length}`);
166
+ }
167
+ if (query?.userId !== undefined) {
168
+ params.push(query.userId);
169
+ where.push(`user_id = $${params.length}`);
170
+ }
171
+ if (query?.kind !== undefined) {
172
+ params.push(query.kind);
173
+ where.push(`kind = $${params.length}`);
174
+ }
175
+ const statuses = statusList(query?.status);
176
+ if (statuses !== undefined) {
177
+ params.push(statuses);
178
+ where.push(`status = ANY($${params.length}::text[])`);
179
+ }
180
+ params.push(resolveLimit(query?.limit));
181
+ const limitParam = params.length;
182
+ params.push(resolveOffset(query?.offset));
183
+ const offsetParam = params.length;
184
+ const sql = 'SELECT * FROM memory_facts' +
185
+ (where.length > 0 ? ` WHERE ${where.join(' AND ')}` : '') +
186
+ ' ORDER BY created_at DESC, id ASC' +
187
+ ` LIMIT $${limitParam} OFFSET $${offsetParam}`;
188
+ const rows = await this._deps.connection.query(sql, params);
189
+ return rows.map(toFact);
190
+ }
191
+ async delete(id) {
192
+ const rows = await this._deps.connection.query('DELETE FROM memory_facts WHERE id = $1 RETURNING id', [id]);
193
+ return rows.length > 0;
194
+ }
195
+ async supersede(id, nextId) {
196
+ const now = new Date().toISOString();
197
+ const rows = await this._deps.connection.query(`UPDATE memory_facts
198
+ SET status = 'superseded',
199
+ superseded_by = $2,
200
+ updated_at = ${updatedAtUpdateExpr('memory_facts', '$3')}
201
+ WHERE id = $1
202
+ RETURNING id`, [id, nextId, now]);
203
+ return rows.length > 0;
204
+ }
205
+ async count(query) {
206
+ const params = [];
207
+ const where = [];
208
+ if (query?.namespace !== undefined) {
209
+ params.push(query.namespace);
210
+ where.push(`namespace = $${params.length}`);
211
+ }
212
+ if (query?.projectId !== undefined) {
213
+ params.push(query.projectId);
214
+ where.push(`project_id = $${params.length}`);
215
+ }
216
+ if (query?.userId !== undefined) {
217
+ params.push(query.userId);
218
+ where.push(`user_id = $${params.length}`);
219
+ }
220
+ if (query?.kind !== undefined) {
221
+ params.push(query.kind);
222
+ where.push(`kind = $${params.length}`);
223
+ }
224
+ const statuses = statusList(query?.status);
225
+ if (statuses !== undefined) {
226
+ params.push(statuses);
227
+ where.push(`status = ANY($${params.length}::text[])`);
228
+ }
229
+ const sql = 'SELECT count(*)::int AS n FROM memory_facts' +
230
+ (where.length > 0 ? ` WHERE ${where.join(' AND ')}` : '');
231
+ const rows = await this._deps.connection.query(sql, params);
232
+ return rows[0]?.n ?? 0;
233
+ }
234
+ }
235
+ /**
236
+ * Область видимости индекса: `instance` — как есть, всё прочее (включая
237
+ * `NULL` у строк, созданных до миграции 018) — `project`.
238
+ */
239
+ function normalizeScope(scope) {
240
+ return scope === 'instance' ? 'instance' : 'project';
241
+ }
242
+ /** Запись индекса из колонок. */
243
+ function toIndex(row) {
244
+ return compact({
245
+ id: row.id,
246
+ namespace: row.namespace,
247
+ name: row.name,
248
+ providerId: row.provider_id,
249
+ projectId: row.project_id ?? undefined,
250
+ scope: normalizeScope(row.scope),
251
+ // `enabled` — легаси-строки/`NULL` читаются как включённые (дефолт true).
252
+ enabled: row.enabled !== false,
253
+ source: row.source,
254
+ state: row.state,
255
+ generation: row.generation,
256
+ fingerprint: row.fingerprint,
257
+ stats: row.stats,
258
+ createdAt: toIsoRequired(row.created_at),
259
+ updatedAt: toIsoRequired(row.updated_at),
260
+ error: row.error ?? undefined,
261
+ });
262
+ }
263
+ /** Запись чанка из колонок. */
264
+ function toChunk(row) {
265
+ return compact({
266
+ indexId: row.index_id,
267
+ generation: row.generation,
268
+ id: row.id,
269
+ documentId: row.document_id,
270
+ ordinal: row.ordinal,
271
+ text: row.text,
272
+ vector: (row.vector ?? undefined),
273
+ embeddingInputHash: row.embedding_input_hash ?? undefined,
274
+ metadata: (row.metadata ?? undefined),
275
+ });
276
+ }
277
+ /** Порт индексов памяти и их чанков поверх `memory_indexes`/`memory_chunks`. */
278
+ export class PgMemoryIndexRepository {
279
+ _deps;
280
+ constructor(_deps) {
281
+ this._deps = _deps;
282
+ }
283
+ async saveIndex(index) {
284
+ await this._deps.connection.query(`INSERT INTO memory_indexes
285
+ (id, namespace, name, provider_id, project_id, scope, enabled, source, state, generation,
286
+ fingerprint, stats, created_at, updated_at, error)
287
+ VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, $9, $10, $11::jsonb, $12::jsonb,
288
+ $13::timestamptz, $14::timestamptz, $15)
289
+ ON CONFLICT (id) DO UPDATE SET
290
+ namespace = EXCLUDED.namespace,
291
+ name = EXCLUDED.name,
292
+ provider_id = EXCLUDED.provider_id,
293
+ project_id = EXCLUDED.project_id,
294
+ scope = EXCLUDED.scope,
295
+ enabled = EXCLUDED.enabled,
296
+ source = EXCLUDED.source,
297
+ state = EXCLUDED.state,
298
+ generation = EXCLUDED.generation,
299
+ fingerprint = EXCLUDED.fingerprint,
300
+ stats = EXCLUDED.stats,
301
+ created_at = memory_indexes.created_at,
302
+ updated_at = ${updatedAtExpr('memory_indexes')},
303
+ error = EXCLUDED.error`, [
304
+ index.id,
305
+ index.namespace,
306
+ index.name,
307
+ index.providerId,
308
+ index.projectId ?? null,
309
+ normalizeScope(index.scope),
310
+ index.enabled !== false,
311
+ jsonbParam(index.source),
312
+ index.state,
313
+ index.generation,
314
+ jsonbParam(index.fingerprint),
315
+ jsonbParam(index.stats),
316
+ index.createdAt,
317
+ index.updatedAt,
318
+ index.error ?? null,
319
+ ]);
320
+ }
321
+ async getIndex(id) {
322
+ const rows = await this._deps.connection.query('SELECT * FROM memory_indexes WHERE id = $1 LIMIT 1', [id]);
323
+ return rows[0] ? toIndex(rows[0]) : null;
324
+ }
325
+ async listIndexes(query) {
326
+ const params = [];
327
+ const where = [];
328
+ if (query?.namespace !== undefined) {
329
+ params.push(query.namespace);
330
+ where.push(`namespace = $${params.length}`);
331
+ }
332
+ if (query?.projectId !== undefined) {
333
+ params.push(query.projectId);
334
+ where.push(`project_id = $${params.length}`);
335
+ }
336
+ if (query?.scope !== undefined) {
337
+ params.push(normalizeScope(query.scope));
338
+ where.push(`scope = $${params.length}`);
339
+ }
340
+ if (query?.providerId !== undefined) {
341
+ params.push(query.providerId);
342
+ where.push(`provider_id = $${params.length}`);
343
+ }
344
+ const states = stateList(query?.state);
345
+ if (states !== undefined) {
346
+ params.push(states);
347
+ where.push(`state = ANY($${params.length}::text[])`);
348
+ }
349
+ params.push(resolveLimit(query?.limit));
350
+ const limitParam = params.length;
351
+ params.push(resolveOffset(query?.offset));
352
+ const offsetParam = params.length;
353
+ const sql = 'SELECT * FROM memory_indexes' +
354
+ (where.length > 0 ? ` WHERE ${where.join(' AND ')}` : '') +
355
+ ' ORDER BY created_at DESC, id ASC' +
356
+ ` LIMIT $${limitParam} OFFSET $${offsetParam}`;
357
+ const rows = await this._deps.connection.query(sql, params);
358
+ return rows.map(toIndex);
359
+ }
360
+ async deleteIndex(id) {
361
+ return this._deps.connection.withTransaction(async (tx) => {
362
+ const rows = await tx.query('DELETE FROM memory_indexes WHERE id = $1 RETURNING id', [id]);
363
+ if (rows.length === 0)
364
+ return false;
365
+ // Чанки индекса удаляются каскадом (все поколения).
366
+ await tx.query('DELETE FROM memory_chunks WHERE index_id = $1', [id]);
367
+ return true;
368
+ });
369
+ }
370
+ async setState(id, state, error) {
371
+ const now = new Date().toISOString();
372
+ const rows = await this._deps.connection.query(`UPDATE memory_indexes
373
+ SET state = $2,
374
+ error = $3,
375
+ updated_at = ${updatedAtUpdateExpr('memory_indexes', '$4')}
376
+ WHERE id = $1
377
+ RETURNING id`, [id, state, error ?? null, now]);
378
+ return rows.length > 0;
379
+ }
380
+ async replaceChunks(indexId, generation, chunks) {
381
+ if (chunks.length === 0) {
382
+ // Пустое поколение — тоже замена: старые чанки поколения удаляются.
383
+ await this._deps.connection.query('DELETE FROM memory_chunks WHERE index_id = $1 AND generation = $2', [indexId, generation]);
384
+ return 0;
385
+ }
386
+ return this._deps.connection.withTransaction(async (tx) => {
387
+ // Атомарная замена поколения: старые чанки поколения удаляются, новые
388
+ // пишутся в той же транзакции; другие поколения не трогаются.
389
+ await tx.query('DELETE FROM memory_chunks WHERE index_id = $1 AND generation = $2', [
390
+ indexId,
391
+ generation,
392
+ ]);
393
+ for (const batch of chunkBatches(chunks)) {
394
+ const values = [];
395
+ const params = [];
396
+ for (const chunk of batch) {
397
+ const base = params.length;
398
+ values.push(`($${base + 1}, $${base + 2}, $${base + 3}, $${base + 4}, $${base + 5}, ` +
399
+ `$${base + 6}, $${base + 7}::jsonb, $${base + 8}, $${base + 9}::jsonb)`);
400
+ params.push(indexId, generation, chunk.id, chunk.documentId, chunk.ordinal, chunk.text, jsonbParam(chunk.vector), chunk.embeddingInputHash ?? null, jsonbParam(chunk.metadata));
401
+ }
402
+ await tx.query(`INSERT INTO memory_chunks
403
+ (index_id, generation, id, document_id, ordinal, text, vector,
404
+ embedding_input_hash, metadata)
405
+ VALUES ${values.join(', ')}`, params);
406
+ }
407
+ return chunks.length;
408
+ });
409
+ }
410
+ async listChunks(indexId, opts) {
411
+ const params = [indexId];
412
+ const where = ['index_id = $1'];
413
+ if (opts?.generation !== undefined) {
414
+ params.push(opts.generation);
415
+ where.push(`generation = $${params.length}`);
416
+ }
417
+ if (opts?.documentId !== undefined) {
418
+ params.push(opts.documentId);
419
+ where.push(`document_id = $${params.length}`);
420
+ }
421
+ params.push(resolveLimit(opts?.limit));
422
+ const limitParam = params.length;
423
+ params.push(resolveOffset(opts?.offset));
424
+ const offsetParam = params.length;
425
+ const sql = 'SELECT * FROM memory_chunks' +
426
+ ` WHERE ${where.join(' AND ')}` +
427
+ ' ORDER BY generation ASC, document_id ASC, ordinal ASC, id ASC' +
428
+ ` LIMIT $${limitParam} OFFSET $${offsetParam}`;
429
+ const rows = await this._deps.connection.query(sql, params);
430
+ return rows.map(toChunk);
431
+ }
432
+ async deleteChunks(indexId, generation) {
433
+ const params = [indexId];
434
+ let sql = 'DELETE FROM memory_chunks WHERE index_id = $1';
435
+ if (generation !== undefined) {
436
+ params.push(generation);
437
+ sql += ' AND generation = $2';
438
+ }
439
+ const rows = await this._deps.connection.query(`${sql} RETURNING id`, params);
440
+ return rows.length;
441
+ }
442
+ async countChunks(indexId, generation) {
443
+ const params = [indexId];
444
+ let sql = 'SELECT count(*)::int AS n FROM memory_chunks WHERE index_id = $1';
445
+ if (generation !== undefined) {
446
+ params.push(generation);
447
+ sql += ' AND generation = $2';
448
+ }
449
+ const rows = await this._deps.connection.query(sql, params);
450
+ return rows[0]?.n ?? 0;
451
+ }
452
+ }
453
+ /**
454
+ * Разбить чанки на партии для multi-row INSERT: один запрос — одна транзакция,
455
+ * но не больше параметров, чем PostgreSQL допускает (65535).
456
+ */
457
+ function chunkBatches(chunks) {
458
+ const MAX_ROWS = 500;
459
+ const batches = [];
460
+ for (let i = 0; i < chunks.length; i += MAX_ROWS) {
461
+ batches.push(chunks.slice(i, i + MAX_ROWS));
462
+ }
463
+ return batches;
464
+ }
465
+ /** Собрать порты памяти (PROP-047 §2.1, ADR-096). */
466
+ export function buildMemoryPorts(deps) {
467
+ return {
468
+ memoryFacts: new PgMemoryFactRepository(deps),
469
+ memoryIndexes: new PgMemoryIndexRepository(deps),
470
+ };
471
+ }
@@ -0,0 +1,32 @@
1
+ /**
2
+ * PG-реализация порта **реестра установок пакетов расширений**
3
+ * (ADR-086 §5 / PROP-068, ADR-116, ADR-097).
4
+ *
5
+ * Хранение — таблица `pack_installations` (миграция `025_packs_pipelines`):
6
+ * ключ записи — **имя пакета** (уникально в инстансе), `manifest`/`files`/
7
+ * `provides` — `jsonb`.
8
+ *
9
+ * Семантика повторяет файловую реализацию core (`FilePackStore`) и in-memory
10
+ * (`MemoryPackRepository`):
11
+ * - `save` — upsert по `name`: `installed_at` не перезаписывается, `updated_at`
12
+ * монотонно не убывает (в SQL — `GREATEST` + сдвиг 1 мс, паритет с
13
+ * `record-timestamps.ts` core);
14
+ * - `get` — `null` для неизвестного имени;
15
+ * - `list` — детерминированный порядок (`ORDER BY name ASC`);
16
+ * - `delete` — `true`, если запись была удалена (снятие установки), иначе `false`.
17
+ */
18
+ import type { PackInstallation, PackRepository, StorageContext } from '@itphx/synth-core';
19
+ import type { PortDeps } from './deps.js';
20
+ /** Часть `StorageContext`, которой владеет группа «packs». */
21
+ export type PackPorts = Pick<StorageContext, 'packs'>;
22
+ /** Реестр установок пакетов поверх таблицы `pack_installations`. */
23
+ export declare class PgPackRepository implements PackRepository {
24
+ private readonly _deps;
25
+ constructor(_deps: PortDeps);
26
+ save(pack: PackInstallation): Promise<void>;
27
+ get(name: string): Promise<PackInstallation | null>;
28
+ list(): Promise<PackInstallation[]>;
29
+ delete(name: string): Promise<boolean>;
30
+ }
31
+ /** Собрать порт реестра установок пакетов (ADR-086 §5). */
32
+ export declare function buildPackPorts(deps: PortDeps): PackPorts;
@@ -0,0 +1,117 @@
1
+ /**
2
+ * PG-реализация порта **реестра установок пакетов расширений**
3
+ * (ADR-086 §5 / PROP-068, ADR-116, ADR-097).
4
+ *
5
+ * Хранение — таблица `pack_installations` (миграция `025_packs_pipelines`):
6
+ * ключ записи — **имя пакета** (уникально в инстансе), `manifest`/`files`/
7
+ * `provides` — `jsonb`.
8
+ *
9
+ * Семантика повторяет файловую реализацию core (`FilePackStore`) и in-memory
10
+ * (`MemoryPackRepository`):
11
+ * - `save` — upsert по `name`: `installed_at` не перезаписывается, `updated_at`
12
+ * монотонно не убывает (в SQL — `GREATEST` + сдвиг 1 мс, паритет с
13
+ * `record-timestamps.ts` core);
14
+ * - `get` — `null` для неизвестного имени;
15
+ * - `list` — детерминированный порядок (`ORDER BY name ASC`);
16
+ * - `delete` — `true`, если запись была удалена (снятие установки), иначе `false`.
17
+ */
18
+ import { jsonbParam } from '../json-param.js';
19
+ import { compact, toIsoRequired } from './events-core.js';
20
+ /**
21
+ * Выражение `updated_at` при upsert: максимум из «сейчас», входящего и
22
+ * сохранённого значения; если максимум совпал с сохранённым — сдвиг на 1 мс
23
+ * (паритет с `resolveUpdatedAt` в `record-timestamps.ts` core: метка не
24
+ * откатывается и всегда наблюдаема). Локальная реплика — как в
25
+ * `ports/pipelines.ts`: драйвер не тянет core рантаймом.
26
+ */
27
+ function updatedAtExpr(table) {
28
+ return `CASE
29
+ WHEN GREATEST(EXCLUDED.updated_at, ${table}.updated_at, now()) <= ${table}.updated_at
30
+ THEN ${table}.updated_at + interval '1 millisecond'
31
+ ELSE GREATEST(EXCLUDED.updated_at, ${table}.updated_at, now())
32
+ END`;
33
+ }
34
+ /** Пустой набор вкладов (страховка для чтения битой/пустой записи `provides`). */
35
+ function emptyProvides() {
36
+ return { agents: [], skills: [], mcp: [], pipelines: [] };
37
+ }
38
+ /** Запись реестра из колонок: `null` → отсутствие необязательного поля. */
39
+ function toPack(row) {
40
+ return compact({
41
+ name: row.name,
42
+ version: row.version,
43
+ kind: row.kind,
44
+ packType: row.pack_type ?? undefined,
45
+ description: row.description ?? undefined,
46
+ status: row.status,
47
+ requiresApproval: row.requires_approval,
48
+ trustLevel: (row.trust_level ?? undefined),
49
+ provides: (row.provides ?? emptyProvides()),
50
+ manifest: row.manifest ?? undefined,
51
+ files: (row.files ?? undefined),
52
+ installedAt: toIsoRequired(row.installed_at),
53
+ updatedAt: toIsoRequired(row.updated_at),
54
+ installedBy: row.installed_by ?? undefined,
55
+ });
56
+ }
57
+ /** Реестр установок пакетов поверх таблицы `pack_installations`. */
58
+ export class PgPackRepository {
59
+ _deps;
60
+ constructor(_deps) {
61
+ this._deps = _deps;
62
+ }
63
+ async save(pack) {
64
+ await this._deps.connection.query(`INSERT INTO pack_installations
65
+ (name, version, kind, pack_type, description, status, requires_approval,
66
+ trust_level, manifest, files, provides, installed_by, installed_at, updated_at)
67
+ VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9::jsonb, $10::jsonb, $11::jsonb, $12,
68
+ $13::timestamptz, GREATEST($14::timestamptz, now()))
69
+ ON CONFLICT (name) DO UPDATE SET
70
+ version = EXCLUDED.version,
71
+ kind = EXCLUDED.kind,
72
+ pack_type = EXCLUDED.pack_type,
73
+ description = EXCLUDED.description,
74
+ status = EXCLUDED.status,
75
+ requires_approval = EXCLUDED.requires_approval,
76
+ trust_level = EXCLUDED.trust_level,
77
+ manifest = EXCLUDED.manifest,
78
+ files = EXCLUDED.files,
79
+ provides = EXCLUDED.provides,
80
+ installed_by = EXCLUDED.installed_by,
81
+ installed_at = pack_installations.installed_at,
82
+ updated_at = ${updatedAtExpr('pack_installations')}`, [
83
+ pack.name,
84
+ pack.version,
85
+ pack.kind,
86
+ pack.packType ?? null,
87
+ pack.description ?? null,
88
+ pack.status,
89
+ pack.requiresApproval,
90
+ pack.trustLevel ?? null,
91
+ pack.manifest !== undefined ? jsonbParam(pack.manifest) : null,
92
+ pack.files !== undefined ? jsonbParam(pack.files) : null,
93
+ jsonbParam(pack.provides ?? emptyProvides()),
94
+ pack.installedBy ?? null,
95
+ pack.installedAt,
96
+ pack.updatedAt,
97
+ ]);
98
+ }
99
+ async get(name) {
100
+ const rows = await this._deps.connection.query('SELECT * FROM pack_installations WHERE name = $1 LIMIT 1', [name]);
101
+ return rows[0] ? toPack(rows[0]) : null;
102
+ }
103
+ async list() {
104
+ const rows = await this._deps.connection.query('SELECT * FROM pack_installations ORDER BY name ASC');
105
+ return rows.map(toPack);
106
+ }
107
+ async delete(name) {
108
+ const rows = await this._deps.connection.query('DELETE FROM pack_installations WHERE name = $1 RETURNING name', [name]);
109
+ return rows.length > 0;
110
+ }
111
+ }
112
+ /** Собрать порт реестра установок пакетов (ADR-086 §5). */
113
+ export function buildPackPorts(deps) {
114
+ return {
115
+ packs: new PgPackRepository(deps),
116
+ };
117
+ }