@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,179 @@
1
+ /**
2
+ * PG-реализация порта **единого реестра фоновых прогонов** (этап 1 roadmap 0.13
3
+ * — блок 1.2, ADR-097; PROP-096 — фоновые саб-агенты, PROP-097 — фоновые
4
+ * шелл-процессы).
5
+ *
6
+ * Таблица `background_runs` (миграция 021): вид, статус, владелец и параметры
7
+ * прогона; `metadata` — `jsonb`; лог процесса — относительный путь в
8
+ * BlobStore (`log_path`), сами логи остаются на диске (ФС-периметр вне портов,
9
+ * ADR-091/ADR-092). Идентификатор фонового процесса у порта исполнения
10
+ * (`process_id`, `proc_<uuid>`) — колонка миграции 022.
11
+ *
12
+ * Семантика повторяет файловые реализации core (`FileBackgroundRunStore`) и
13
+ * in-memory (`MemoryBackgroundRunRepository`):
14
+ * - upsert по `id`: `started_at` не перезаписывается, `updated_at` — метка
15
+ * вызывающего (драйвер не подставляет «сейчас» — иначе retention-очистка по
16
+ * метке записи теряла бы смысл);
17
+ * - список — «свежие первыми» (`started_at` убыв., тайбрейкер `id`), фильтры —
18
+ * по «И»;
19
+ * - `prune` — **только терминальные** статусы, метка которых строго старше
20
+ * отсечки (`updated_at < $2`); нетерминальный `running` не удаляется никогда.
21
+ *
22
+ * Драйвер не тянет core рантаймом (только `import type`), поэтому потолок
23
+ * выборки повторён здесь локально — как в `ports/pipelines.ts`.
24
+ */
25
+ import { BACKGROUND_RUN_TERMINAL_STATUSES } from '@itphx/synth-shared';
26
+ import { jsonbParam } from '../json-param.js';
27
+ import { compact, toIso, toIsoRequired } from './events-core.js';
28
+ // ── Локальные реплики core-хелперов (core рантаймом не тянем) ────────────────
29
+ /** Дефолтный потолок выборки (паритет с core `COLLECTION_LIMIT_DEFAULT`). */
30
+ const LIST_DEFAULT_LIMIT = 100;
31
+ /** Абсолютный потолок выборки (паритет с core `COLLECTION_LIMIT_MAX`). */
32
+ const LIST_MAX_LIMIT = 1000;
33
+ /** Привести `limit` к допустимому виду: дефолт 100, потолок 1000. */
34
+ function resolveLimit(limit) {
35
+ if (limit === undefined || !Number.isFinite(limit) || limit <= 0)
36
+ return LIST_DEFAULT_LIMIT;
37
+ return Math.min(Math.floor(limit), LIST_MAX_LIMIT);
38
+ }
39
+ /**
40
+ * Статусы, которые можно чистить: только терминальные. Нетерминальные статусы
41
+ * из аргумента игнорируются — `running` не удаляется никогда.
42
+ */
43
+ function prunableStatuses(statuses) {
44
+ if (statuses === undefined)
45
+ return [...BACKGROUND_RUN_TERMINAL_STATUSES];
46
+ return statuses.filter((status) => BACKGROUND_RUN_TERMINAL_STATUSES.includes(status));
47
+ }
48
+ /** Запись фонового прогона из колонок. */
49
+ function toBackgroundRun(row) {
50
+ return compact({
51
+ id: row.id,
52
+ kind: row.kind,
53
+ status: row.status,
54
+ sessionId: row.session_id,
55
+ projectId: row.project_id ?? undefined,
56
+ childSessionId: row.child_session_id ?? undefined,
57
+ agentRole: row.agent_role ?? undefined,
58
+ description: row.description ?? undefined,
59
+ command: row.command ?? undefined,
60
+ cwd: row.cwd ?? undefined,
61
+ pid: row.pid ?? undefined,
62
+ processId: row.process_id ?? undefined,
63
+ logPath: row.log_path ?? undefined,
64
+ exitCode: row.exit_code ?? undefined,
65
+ signal: row.signal ?? undefined,
66
+ startedAt: toIsoRequired(row.started_at),
67
+ finishedAt: toIso(row.finished_at),
68
+ updatedAt: toIsoRequired(row.updated_at),
69
+ summary: row.summary ?? undefined,
70
+ metadata: (row.metadata ?? undefined),
71
+ });
72
+ }
73
+ /** Порт реестра фоновых прогонов поверх таблицы `background_runs`. */
74
+ export class PgBackgroundRunRepository {
75
+ _deps;
76
+ constructor(_deps) {
77
+ this._deps = _deps;
78
+ }
79
+ async save(record) {
80
+ await this._deps.connection.query(`INSERT INTO background_runs
81
+ (id, kind, status, session_id, project_id, child_session_id, agent_role, description,
82
+ command, cwd, pid, process_id, log_path, exit_code, signal, started_at, finished_at,
83
+ updated_at, summary, metadata)
84
+ VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16::timestamptz,
85
+ $17::timestamptz, $18::timestamptz, $19, $20::jsonb)
86
+ ON CONFLICT (id) DO UPDATE SET
87
+ kind = EXCLUDED.kind,
88
+ status = EXCLUDED.status,
89
+ session_id = EXCLUDED.session_id,
90
+ project_id = EXCLUDED.project_id,
91
+ child_session_id = EXCLUDED.child_session_id,
92
+ agent_role = EXCLUDED.agent_role,
93
+ description = EXCLUDED.description,
94
+ command = EXCLUDED.command,
95
+ cwd = EXCLUDED.cwd,
96
+ pid = EXCLUDED.pid,
97
+ process_id = EXCLUDED.process_id,
98
+ log_path = EXCLUDED.log_path,
99
+ exit_code = EXCLUDED.exit_code,
100
+ signal = EXCLUDED.signal,
101
+ started_at = background_runs.started_at,
102
+ finished_at = EXCLUDED.finished_at,
103
+ updated_at = EXCLUDED.updated_at,
104
+ summary = EXCLUDED.summary,
105
+ metadata = EXCLUDED.metadata`, [
106
+ record.id,
107
+ record.kind,
108
+ record.status,
109
+ record.sessionId,
110
+ record.projectId ?? null,
111
+ record.childSessionId ?? null,
112
+ record.agentRole ?? null,
113
+ record.description ?? null,
114
+ record.command ?? null,
115
+ record.cwd ?? null,
116
+ record.pid ?? null,
117
+ record.processId ?? null,
118
+ record.logPath ?? null,
119
+ record.exitCode ?? null,
120
+ record.signal ?? null,
121
+ record.startedAt,
122
+ record.finishedAt ?? null,
123
+ record.updatedAt,
124
+ record.summary ?? null,
125
+ record.metadata !== undefined ? jsonbParam(record.metadata) : null,
126
+ ]);
127
+ }
128
+ async get(id) {
129
+ const rows = await this._deps.connection.query('SELECT * FROM background_runs WHERE id = $1 LIMIT 1', [id]);
130
+ return rows[0] ? toBackgroundRun(rows[0]) : null;
131
+ }
132
+ async list(filter) {
133
+ const params = [];
134
+ const where = [];
135
+ if (filter?.kind !== undefined) {
136
+ params.push(filter.kind);
137
+ where.push(`kind = $${params.length}`);
138
+ }
139
+ if (filter?.status !== undefined) {
140
+ params.push(filter.status);
141
+ where.push(`status = $${params.length}`);
142
+ }
143
+ if (filter?.sessionId !== undefined) {
144
+ params.push(filter.sessionId);
145
+ where.push(`session_id = $${params.length}`);
146
+ }
147
+ if (filter?.projectId !== undefined) {
148
+ params.push(filter.projectId);
149
+ where.push(`project_id = $${params.length}`);
150
+ }
151
+ params.push(resolveLimit(filter?.limit));
152
+ const sql = 'SELECT * FROM background_runs' +
153
+ (where.length ? ` WHERE ${where.join(' AND ')}` : '') +
154
+ ' ORDER BY started_at DESC, id ASC' +
155
+ ` LIMIT $${params.length}`;
156
+ const rows = await this._deps.connection.query(sql, params);
157
+ return rows.map(toBackgroundRun);
158
+ }
159
+ async remove(id) {
160
+ const rows = await this._deps.connection.query('DELETE FROM background_runs WHERE id = $1 RETURNING id', [id]);
161
+ return rows.length > 0;
162
+ }
163
+ async prune(before, statuses) {
164
+ const allowed = prunableStatuses(statuses);
165
+ // Пустой набор статусов — чистить нечего (нетерминальные игнорируются).
166
+ if (allowed.length === 0)
167
+ return 0;
168
+ const rows = await this._deps.connection.query(`DELETE FROM background_runs
169
+ WHERE status = ANY($1::text[]) AND updated_at < $2::timestamptz
170
+ RETURNING id`, [allowed, before]);
171
+ return rows.length;
172
+ }
173
+ }
174
+ /** Собрать порты группы «фоновые прогоны» (этап 1 roadmap 0.13, блок 1.2). */
175
+ export function buildBackgroundRunPorts(deps) {
176
+ return {
177
+ backgroundRuns: new PgBackgroundRunRepository(deps),
178
+ };
179
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * PG-реализация порта **учёта ссылок на объекты blob-хранилища**
3
+ * (ADR-115 §«Хранение», ADR-116 §3, ADR-097).
4
+ *
5
+ * Хранение — таблица `blob_refs` (миграция `024_blob_refs`): первичный ключ —
6
+ * тройка `(blob_path, owner_kind, owner_id)`, индекс по владельцу
7
+ * `(owner_kind, owner_id)`.
8
+ *
9
+ * Байты самих объектов в БД **не** лежат (том, ADR-116 §2) — здесь только
10
+ * учёт ссылок: по нему дедуп (по содержимому) и детерминированный GC (ссылок
11
+ * не осталось → объект можно удалять).
12
+ *
13
+ * Семантика повторяет файловую реализацию core (`FileBlobRefRepository`) и
14
+ * in-memory (`MemoryBlobRefRepository`):
15
+ * - `add` **идемпотентен** (`ON CONFLICT DO NOTHING` — дубля не создаётся);
16
+ * - `remove` снимает ровно одну ссылку; отсутствие ссылки — не ошибка;
17
+ * - `removeByOwner` снимает все ссылки владельца и возвращает их число;
18
+ * - `listByOwner` отдаёт пути в детерминированном порядке (`ORDER BY`);
19
+ * - `countRefs` считает ссылки на объект.
20
+ */
21
+ import type { BlobOwnerKind, BlobRef, BlobRefRepository, StorageContext } from '@itphx/synth-core';
22
+ import type { PortDeps } from './deps.js';
23
+ /** Часть `StorageContext`, которой владеет группа «blob-refs». */
24
+ export type BlobRefPorts = Pick<StorageContext, 'blobRefs'>;
25
+ /** Порт учёта ссылок на blob-объекты поверх таблицы `blob_refs`. */
26
+ export declare class PgBlobRefRepository implements BlobRefRepository {
27
+ private readonly _deps;
28
+ constructor(_deps: PortDeps);
29
+ add(ref: BlobRef): Promise<void>;
30
+ remove(ref: BlobRef): Promise<void>;
31
+ removeByOwner(ownerKind: BlobOwnerKind, ownerId: string): Promise<number>;
32
+ listByOwner(ownerKind: BlobOwnerKind, ownerId: string): Promise<string[]>;
33
+ countRefs(blobPath: string): Promise<number>;
34
+ }
35
+ /** Собрать порт учёта ссылок на blob-объекты (ADR-115/ADR-116). */
36
+ export declare function buildBlobRefPorts(deps: PortDeps): BlobRefPorts;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * PG-реализация порта **учёта ссылок на объекты blob-хранилища**
3
+ * (ADR-115 §«Хранение», ADR-116 §3, ADR-097).
4
+ *
5
+ * Хранение — таблица `blob_refs` (миграция `024_blob_refs`): первичный ключ —
6
+ * тройка `(blob_path, owner_kind, owner_id)`, индекс по владельцу
7
+ * `(owner_kind, owner_id)`.
8
+ *
9
+ * Байты самих объектов в БД **не** лежат (том, ADR-116 §2) — здесь только
10
+ * учёт ссылок: по нему дедуп (по содержимому) и детерминированный GC (ссылок
11
+ * не осталось → объект можно удалять).
12
+ *
13
+ * Семантика повторяет файловую реализацию core (`FileBlobRefRepository`) и
14
+ * in-memory (`MemoryBlobRefRepository`):
15
+ * - `add` **идемпотентен** (`ON CONFLICT DO NOTHING` — дубля не создаётся);
16
+ * - `remove` снимает ровно одну ссылку; отсутствие ссылки — не ошибка;
17
+ * - `removeByOwner` снимает все ссылки владельца и возвращает их число;
18
+ * - `listByOwner` отдаёт пути в детерминированном порядке (`ORDER BY`);
19
+ * - `countRefs` считает ссылки на объект.
20
+ */
21
+ /** Порт учёта ссылок на blob-объекты поверх таблицы `blob_refs`. */
22
+ export class PgBlobRefRepository {
23
+ _deps;
24
+ constructor(_deps) {
25
+ this._deps = _deps;
26
+ }
27
+ async add(ref) {
28
+ await this._deps.connection.query(`INSERT INTO blob_refs (blob_path, owner_kind, owner_id, created_at)
29
+ VALUES ($1, $2, $3, now())
30
+ ON CONFLICT (blob_path, owner_kind, owner_id) DO NOTHING`, [ref.blobPath, ref.ownerKind, ref.ownerId]);
31
+ }
32
+ async remove(ref) {
33
+ await this._deps.connection.query('DELETE FROM blob_refs WHERE blob_path = $1 AND owner_kind = $2 AND owner_id = $3', [ref.blobPath, ref.ownerKind, ref.ownerId]);
34
+ }
35
+ async removeByOwner(ownerKind, ownerId) {
36
+ const rows = await this._deps.connection.query('DELETE FROM blob_refs WHERE owner_kind = $1 AND owner_id = $2 RETURNING blob_path', [ownerKind, ownerId]);
37
+ return rows.length;
38
+ }
39
+ async listByOwner(ownerKind, ownerId) {
40
+ const rows = await this._deps.connection.query('SELECT blob_path FROM blob_refs WHERE owner_kind = $1 AND owner_id = $2 ORDER BY blob_path ASC', [ownerKind, ownerId]);
41
+ return rows.map((row) => row.blob_path);
42
+ }
43
+ async countRefs(blobPath) {
44
+ const rows = await this._deps.connection.query('SELECT count(*)::text AS count FROM blob_refs WHERE blob_path = $1', [blobPath]);
45
+ const raw = rows[0]?.count;
46
+ const count = raw !== undefined ? Number(raw) : 0;
47
+ return Number.isFinite(count) ? count : 0;
48
+ }
49
+ }
50
+ /** Собрать порт учёта ссылок на blob-объекты (ADR-115/ADR-116). */
51
+ export function buildBlobRefPorts(deps) {
52
+ return {
53
+ blobRefs: new PgBlobRefRepository(deps),
54
+ };
55
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Группа портов **контента, секретов и обслуживания** PostgreSQL-драйвера
3
+ * (ADR-097, волна 3b).
4
+ *
5
+ * Владелец файла — один агент волны реализации; правит только `content.ts`.
6
+ * Файл экспортирует единственную фабрику `buildContentPorts(deps)`, возвращающую
7
+ * свою часть `StorageContext`: `serviceKeys`, `sshKeys`, `mcpRegistry`,
8
+ * `skillBundles`, `dictionaries`, `secretPatterns`, `protectedPaths`,
9
+ * `maintenanceAudit`.
10
+ *
11
+ * ── Синхронные геттеры (кэш-фасад) ────────────────────────────────────────
12
+ * `secretPatterns`/`protectedPaths`/`dictionaries` требуют **синхронных** вызовов
13
+ * на горячем пути (сборка промпта, детекция секретов, маршрутизация). Поэтому:
14
+ * - «системный» слой (дефолтные паттерны, definitions/protected-paths.json,
15
+ * системные словари) читается **синхронно** из ассетов core либо из
16
+ * инстанс-конфигурации — он доступен сразу, без обращения к БД;
17
+ * - пользовательский override — в таблице `settings(key, value jsonb)`
18
+ * (схема `001-init` общих таблиц для словарей/паттернов/путей НЕ заводит);
19
+ * он прогревается в память асинхронно при сборке контекста (best-effort
20
+ * warm) и поддерживается **write-through** при мутациях.
21
+ *
22
+ * Известное ограничение: кэш синхронных геттеров процесс-локальный — правки
23
+ * override другим процессом/инстансом он не увидит до рестарта; короткое окно
24
+ * сразу после старта может отдать системный дефолт до завершения прогрева.
25
+ *
26
+ * ── Core на синхронном пути ───────────────────────────────────────────────
27
+ * Синхронным геттерам нужны данные/хелперы core (`DEFAULT_PATTERNS`,
28
+ * `definitions/protected-paths.json`, системные словари). Прямой доступ к core
29
+ * невозможен: core — `peerDependencies`, а статический рантайм-импорт образовал бы
30
+ * цикл. Поэтому core **инъектирует** значения в конфиг драйвера
31
+ * (`PortDeps.coreSync`, сборка — `packages/core/src/storage/storage-context.ts`);
32
+ * без инъекции (прямой вызов фабрики) они собираются ленивым
33
+ * `import('@itphx/synth-core')` в `core-sync.ts`. Асинхронные методы (шифрование
34
+ * at-rest в `sshKeys`) грузят core тем же ленивым `import()` внутри функций.
35
+ */
36
+ import type { StorageContext } from '@itphx/synth-core';
37
+ import type { PortDeps } from './deps.js';
38
+ /** Часть `StorageContext`, которой владеет группа `content`. */
39
+ export type ContentPorts = Pick<StorageContext, 'serviceKeys' | 'sshKeys' | 'mcpRegistry' | 'skillBundles' | 'dictionaries' | 'secretPatterns' | 'protectedPaths' | 'maintenanceAudit'>;
40
+ /** Собрать порты группы `content`. */
41
+ export declare function buildContentPorts(deps: PortDeps): ContentPorts;