@itphx/synth-storage-postgres 0.11.3 → 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 (141) 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/index.d.ts +1 -1
  62. package/dist/migrations/index.js +49 -1
  63. package/dist/pool.d.ts +6 -6
  64. package/dist/pool.js +8 -8
  65. package/dist/ports/analytics.d.ts +1 -1
  66. package/dist/ports/analytics.js +1 -1
  67. package/dist/ports/audit.d.ts +1 -1
  68. package/dist/ports/audit.js +3 -0
  69. package/dist/ports/authority.d.ts +27 -0
  70. package/dist/ports/authority.js +148 -0
  71. package/dist/ports/background-runs.d.ts +41 -0
  72. package/dist/ports/background-runs.js +179 -0
  73. package/dist/ports/blob-refs.d.ts +36 -0
  74. package/dist/ports/blob-refs.js +55 -0
  75. package/dist/ports/content.d.ts +1 -1
  76. package/dist/ports/content.js +21 -7
  77. package/dist/ports/context-files.d.ts +145 -0
  78. package/dist/ports/context-files.js +279 -0
  79. package/dist/ports/core-sync.d.ts +1 -1
  80. package/dist/ports/core-sync.js +1 -1
  81. package/dist/ports/credential-audit.d.ts +19 -0
  82. package/dist/ports/credential-audit.js +96 -0
  83. package/dist/ports/deps.d.ts +2 -2
  84. package/dist/ports/deps.js +1 -1
  85. package/dist/ports/events-bindings.d.ts +2 -2
  86. package/dist/ports/events-bindings.js +2 -2
  87. package/dist/ports/events-core.d.ts +1 -1
  88. package/dist/ports/events-core.js +1 -1
  89. package/dist/ports/events-journal.d.ts +1 -1
  90. package/dist/ports/events-journal.js +1 -1
  91. package/dist/ports/events-scheduler.d.ts +1 -1
  92. package/dist/ports/events-scheduler.js +1 -1
  93. package/dist/ports/events-webhooks.d.ts +1 -1
  94. package/dist/ports/events-webhooks.js +1 -1
  95. package/dist/ports/events.d.ts +1 -1
  96. package/dist/ports/events.js +1 -1
  97. package/dist/ports/external-credentials.d.ts +6 -0
  98. package/dist/ports/external-credentials.js +363 -0
  99. package/dist/ports/legacy-pipelines.d.ts +50 -0
  100. package/dist/ports/legacy-pipelines.js +202 -0
  101. package/dist/ports/memory.d.ts +65 -0
  102. package/dist/ports/memory.js +471 -0
  103. package/dist/ports/packs.d.ts +32 -0
  104. package/dist/ports/packs.js +117 -0
  105. package/dist/ports/pipelines.d.ts +67 -0
  106. package/dist/ports/pipelines.js +297 -0
  107. package/dist/ports/plugin-audit.d.ts +14 -0
  108. package/dist/ports/plugin-audit.js +110 -0
  109. package/dist/ports/plugin-lock.d.ts +27 -0
  110. package/dist/ports/plugin-lock.js +145 -0
  111. package/dist/ports/principals-defaults.d.ts +1 -1
  112. package/dist/ports/principals-defaults.js +1 -1
  113. package/dist/ports/principals-documents.d.ts +1 -1
  114. package/dist/ports/principals-documents.js +1 -1
  115. package/dist/ports/principals-profiles.d.ts +1 -1
  116. package/dist/ports/principals-profiles.js +1 -1
  117. package/dist/ports/principals-projects.d.ts +1 -1
  118. package/dist/ports/principals-projects.js +6 -3
  119. package/dist/ports/principals-settings.d.ts +1 -1
  120. package/dist/ports/principals-settings.js +21 -1
  121. package/dist/ports/principals-shared.d.ts +1 -1
  122. package/dist/ports/principals-shared.js +1 -1
  123. package/dist/ports/principals.d.ts +1 -1
  124. package/dist/ports/principals.js +1 -1
  125. package/dist/ports/questions.d.ts +40 -0
  126. package/dist/ports/questions.js +135 -0
  127. package/dist/ports/sessions-mapping.d.ts +20 -3
  128. package/dist/ports/sessions-mapping.js +46 -2
  129. package/dist/ports/sessions.d.ts +13 -3
  130. package/dist/ports/sessions.js +20 -5
  131. package/dist/ports/skills.d.ts +59 -0
  132. package/dist/ports/skills.js +205 -0
  133. package/dist/ports/stub.d.ts +1 -1
  134. package/dist/ports/stub.js +2 -2
  135. package/dist/ports/worktrees.d.ts +41 -0
  136. package/dist/ports/worktrees.js +85 -0
  137. package/dist/postgres-storage.d.ts +4 -5
  138. package/dist/postgres-storage.js +5 -6
  139. package/dist/storage-context.d.ts +44 -15
  140. package/dist/storage-context.js +139 -31
  141. package/package.json +4 -4
@@ -1,6 +1,5 @@
1
1
  /**
2
- * Драйвер слоя хранения Synth на PostgreSQL — публичная фабрика (ADR-096/ADR-097,
3
- * PROP-032).
2
+ * Драйвер слоя хранения Synth на PostgreSQL — публичная фабрика (ADR-097).
4
3
  *
5
4
  * Пакет `@itphx/synth-storage-postgres` — in-tree **опциональный** драйвер: он
6
5
  * реализует доменные порты `StorageContext` и подключается из
@@ -28,14 +27,14 @@ export interface PostgresStorageConfig extends StorageContextConfig, PostgresCon
28
27
  /** Применять миграции схемы при сборке контекста (по умолчанию — `true`). */
29
28
  migrate?: boolean;
30
29
  /**
31
- * PROP-032: режим работы со схемой при сборке (`apply`/`assert`/`skip`);
30
+ * ADR-097: режим работы со схемой при сборке (`apply`/`assert`/`skip`);
32
31
  * приоритетнее `migrate`. `skip` — только подключение (диагностика/CLI,
33
32
  * управляющие миграциями сами). Не задан — выводится из `migrate`
34
33
  * (`false` → `assert`, иначе `apply`).
35
34
  */
36
35
  schemaMode?: 'apply' | 'assert' | 'skip';
37
36
  /**
38
- * ADR-097/PROP-032: синхронные данные/хелперы core (`secretPatterns`/
37
+ * ADR-097: синхронные данные/хелперы core (`secretPatterns`/
39
38
  * `protectedPaths`/`dictionaries`), инъектируемые core'ом
40
39
  * (`packages/core/src/storage/storage-context.ts`). Не заданы (прямой вызов
41
40
  * фабрики) — драйвер собирает их ленивым `import('@itphx/synth-core')`.
@@ -49,7 +48,7 @@ export interface PostgresStorageConfig extends StorageContextConfig, PostgresCon
49
48
  */
50
49
  export declare function validatePostgresConfig(config: PostgresStorageConfig): void;
51
50
  /**
52
- * Собрать `StorageContext` на PostgreSQL (форма — ADR-097/PROP-032).
51
+ * Собрать `StorageContext` на PostgreSQL (форма — ADR-097).
53
52
  *
54
53
  * Валидирует конфиг, лениво подключается к БД, применяет миграции (или, при
55
54
  * `migrate:false`, проверяет актуальность схемы — fail-closed) и возвращает
@@ -1,6 +1,5 @@
1
1
  /**
2
- * Драйвер слоя хранения Synth на PostgreSQL — публичная фабрика (ADR-096/ADR-097,
3
- * PROP-032).
2
+ * Драйвер слоя хранения Synth на PostgreSQL — публичная фабрика (ADR-097).
4
3
  *
5
4
  * Пакет `@itphx/synth-storage-postgres` — in-tree **опциональный** драйвер: он
6
5
  * реализует доменные порты `StorageContext` и подключается из
@@ -44,7 +43,7 @@ export function validatePostgresConfig(config) {
44
43
  }
45
44
  if (config.schema !== undefined)
46
45
  assertValidSchema(config.schema);
47
- // ADR-099/PROP-032: fail-closed до обращения к БД — TLS-параметры в DSN
46
+ // ADR-099/ADR-097: fail-closed до обращения к БД — TLS-параметры в DSN
48
47
  // молча перекрываются конфигом (`pg` накладывает DSN поверх `ssl`).
49
48
  assertNoDsnTlsParams(config.connectionString);
50
49
  const hasConnectionString = isNonEmptyString(config.connectionString);
@@ -54,7 +53,7 @@ export function validatePostgresConfig(config) {
54
53
  }
55
54
  }
56
55
  /**
57
- * Собрать `StorageContext` на PostgreSQL (форма — ADR-097/PROP-032).
56
+ * Собрать `StorageContext` на PostgreSQL (форма — ADR-097).
58
57
  *
59
58
  * Валидирует конфиг, лениво подключается к БД, применяет миграции (или, при
60
59
  * `migrate:false`, проверяет актуальность схемы — fail-closed) и возвращает
@@ -77,7 +76,7 @@ export async function createPostgresStorage(config) {
77
76
  applicationName: config.applicationName,
78
77
  });
79
78
  try {
80
- // PROP-032: режим схемы — `apply` (дефолт), `assert` (DBA), `skip` (диагностика).
79
+ // ADR-097: режим схемы — `apply` (дефолт), `assert` (DBA), `skip` (диагностика).
81
80
  const schemaMode = config.schemaMode ?? config.postgresSchemaMode
82
81
  ?? (config.migrate === false ? 'assert' : 'apply');
83
82
  if (schemaMode === 'assert') {
@@ -91,7 +90,7 @@ export async function createPostgresStorage(config) {
91
90
  await conn.end().catch(() => undefined);
92
91
  throw err;
93
92
  }
94
- // PROP-032: соединение удерживается в контексте (порты БД ходят через него),
93
+ // ADR-097: соединение удерживается в контексте (порты БД ходят через него),
95
94
  // `ctx.close()` закрывает пул. Незанятые соединения не удерживают event loop
96
95
  // (`allowExitOnIdle` в `pool.ts`), поэтому CLI-команды завершаются.
97
96
  return buildPostgresStorageContext({
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Сборка `StorageContext` PostgreSQL-драйвера (PROP-032, волна 3b-каркас).
2
+ * Сборка `StorageContext` PostgreSQL-драйвера (ADR-097, волна 3b-каркас).
3
3
  *
4
4
  * Контекст собирается из независимых файлов-групп портов
5
5
  * (`src/ports/{sessions,principals,events,content,audit,analytics}.ts`) — по одной
@@ -15,17 +15,46 @@
15
15
  * `skillBundles`/`dictionaries`/`secretPatterns`/`protectedPaths`/
16
16
  * `maintenanceAudit`;
17
17
  * - `buildAuditPorts(deps)` → `securityAudit`/`egressRequests`;
18
- * - `buildAnalyticsPorts(deps)` → `analyticsRollups` (PROP-102).
18
+ * - `buildAnalyticsPorts(deps)` → `analyticsRollups` (ADR-102);
19
+ * - `buildAuthorityPorts(deps)` → `authorityPolicy`/`authorityDecisions` (ADR-106 Ф0/Ф1);
20
+ * - `buildExternalCredentialPorts(deps)` → `externalCredentials` (ADR-105 Ф1);
21
+ * - `buildCredentialAuditPorts(deps)` → `credentialAudit` (ADR-105 Ф4);
22
+ * - `buildPipelinePorts(deps)` → `projectPipelines`/`pipelineRuns` (ADR-101);
23
+ * - `buildMemoryPorts(deps)` → `memoryFacts`/`memoryIndexes` (PROP-047 §2.1);
24
+ * - `buildQuestionPorts(deps)` → `questions` (этап 1 roadmap 0.13, блок 1.3);
25
+ * - `buildBackgroundRunPorts(deps)` → `backgroundRuns` (этап 1 roadmap 0.13,
26
+ * блок 1.2 — фоновые саб-агенты и шелл-процессы);
27
+ * - `buildWorktreePorts(deps)` → `worktrees` (ADR-114 — инвентарь
28
+ * git-worktree'ов; generic-таблица `documents`, `kind='worktree'`).
29
+ * - `buildBlobRefPorts(deps)` → `blobRefs` (ADR-115/ADR-116 — учёт ссылок
30
+ * на объекты blob-хранилища; таблица `blob_refs`).
31
+ * - `buildPackPorts(deps)` → `packs` (ADR-086 §5 — реестр установок
32
+ * пакетов расширений; таблица `pack_installations`).
33
+ * - `buildLegacyPipelinePorts(deps)` → `pipelines` (ADR-051/ADR-100 — реестр
34
+ * определений и экземпляров инстанса; таблицы `pipeline_definitions`/
35
+ * `pipeline_instances`). Не путать с `buildPipelinePorts` (ADR-101).
36
+ * - `buildSkillPorts(deps, blobs)` → `skills` (ADR-046 §4 / ADR-116 —
37
+ * метаданные в таблице `instance_skills`, содержимое — в blob-сторе
38
+ * `skills/<name>/…`).
39
+ * - `buildContextFilePorts(deps, opts)` → `contextFiles` (ADR-069/ADR-070 /
40
+ * ADR-116 — пользовательская часть в таблице `context_files`, системные
41
+ * промпты образа остаются ФС).
19
42
  *
20
- * Все доменные порты реализованы поверх SQL; FS/package-bound порты (`skills`,
21
- * `contextFiles`, `blobs`) — **файловые реализации** core (контент скиллов/
22
- * prompts-ролей и blob-дерево остаются на диске; ADR-091/ADR-092: ФС-периметр
23
- * вне портов).
43
+ * Все доменные порты реализованы поверх SQL; **`blobs`** остаётся файловым по
44
+ * конструкции (байты вложений/логов/содержимого скиллов — на томе, в БД только
45
+ * `blob_refs`; ADR-091/ADR-092: ФС-периметр вне портов). `packs`, legacy
46
+ * `pipelines`, `skills` и `contextFiles` — **SQL** (ADR-116): таблицы
47
+ * `pack_installations`/`pipeline_definitions`/`pipeline_instances` (миграция 025),
48
+ * `instance_skills` (миграция 026; содержимое скиллов — в blob-сторе) и
49
+ * `context_files` (миграция 027; системные промпты образа остаются ФС).
24
50
  *
25
- * Осознанное исключение: драйвер в этой части **импортирует core рантаймом**
26
- * (`createFileStorage`), чтобы переиспользовать уже проверенные файловые
27
- * реализации, а не дублировать их. Для портов БД core по-прежнему не тянется:
28
- * порты подключаются динамическим `import()` из core по `storage.backend`.
51
+ * Рантайм-импорт core сужен до трёх точечных вещей (ADR-116): `FileBlobStore` +
52
+ * `prepareBlobRoot`/`blobRootPath` (blob-порт — файловый по конструкции, корень
53
+ * `{dataDir}/blobs`) и `ContextConfig` (системные промпты образа — его резолвер;
54
+ * пользовательская часть контекста в SQL). Файловый контекст
55
+ * (`createFileStorage`) драйвер **не собирает**. Для портов БД core по-прежнему
56
+ * не тянется: порты подключаются динамическим `import()` из core по
57
+ * `storage.backend`.
29
58
  */
30
59
  import type { StorageContext } from '@itphx/synth-core';
31
60
  import type { PostgresConnection } from './pool.js';
@@ -35,17 +64,17 @@ export interface BuildPostgresContextOptions {
35
64
  dataDir: string;
36
65
  secretKey?: string;
37
66
  env?: NodeJS.ProcessEnv;
38
- /** Каталог системных словарей (пробрасывается группе `content`/файловым портам). */
67
+ /** Каталог системных словарей (пробрасывается группе `content`). */
39
68
  systemDictionariesDir?: string;
40
- /** Корень пользовательских промптов/ролей (файловый порт `contextFiles`). */
69
+ /** Корень пользовательских промптов/ролей (композиция `contextFiles`: системные промпты — ФС образа). */
41
70
  contextUserDataDir?: string;
42
71
  /**
43
- * PROP-032: живое соединение драйвера — удерживается в контексте, порты БД
72
+ * ADR-097: живое соединение драйвера — удерживается в контексте, порты БД
44
73
  * ходят через него; `close()` контекста закрывает пул.
45
74
  */
46
75
  connection: PostgresConnection;
47
- /** ADR-097/PROP-032: синхронные данные/хелперы core (см. `CoreSyncDeps`). */
76
+ /** ADR-097: синхронные данные/хелперы core (см. `CoreSyncDeps`). */
48
77
  coreSync: CoreSyncDeps;
49
78
  }
50
- /** Собрать `StorageContext`: четыре группы портов + файловые FS-порты + `close`. */
79
+ /** Собрать `StorageContext`: доменные порты (SQL) + blob-стор (ФС) + `close`. */
51
80
  export declare function buildPostgresStorageContext(opts: BuildPostgresContextOptions): StorageContext;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Сборка `StorageContext` PostgreSQL-драйвера (PROP-032, волна 3b-каркас).
2
+ * Сборка `StorageContext` PostgreSQL-драйвера (ADR-097, волна 3b-каркас).
3
3
  *
4
4
  * Контекст собирается из независимых файлов-групп портов
5
5
  * (`src/ports/{sessions,principals,events,content,audit,analytics}.ts`) — по одной
@@ -15,40 +15,99 @@
15
15
  * `skillBundles`/`dictionaries`/`secretPatterns`/`protectedPaths`/
16
16
  * `maintenanceAudit`;
17
17
  * - `buildAuditPorts(deps)` → `securityAudit`/`egressRequests`;
18
- * - `buildAnalyticsPorts(deps)` → `analyticsRollups` (PROP-102).
18
+ * - `buildAnalyticsPorts(deps)` → `analyticsRollups` (ADR-102);
19
+ * - `buildAuthorityPorts(deps)` → `authorityPolicy`/`authorityDecisions` (ADR-106 Ф0/Ф1);
20
+ * - `buildExternalCredentialPorts(deps)` → `externalCredentials` (ADR-105 Ф1);
21
+ * - `buildCredentialAuditPorts(deps)` → `credentialAudit` (ADR-105 Ф4);
22
+ * - `buildPipelinePorts(deps)` → `projectPipelines`/`pipelineRuns` (ADR-101);
23
+ * - `buildMemoryPorts(deps)` → `memoryFacts`/`memoryIndexes` (PROP-047 §2.1);
24
+ * - `buildQuestionPorts(deps)` → `questions` (этап 1 roadmap 0.13, блок 1.3);
25
+ * - `buildBackgroundRunPorts(deps)` → `backgroundRuns` (этап 1 roadmap 0.13,
26
+ * блок 1.2 — фоновые саб-агенты и шелл-процессы);
27
+ * - `buildWorktreePorts(deps)` → `worktrees` (ADR-114 — инвентарь
28
+ * git-worktree'ов; generic-таблица `documents`, `kind='worktree'`).
29
+ * - `buildBlobRefPorts(deps)` → `blobRefs` (ADR-115/ADR-116 — учёт ссылок
30
+ * на объекты blob-хранилища; таблица `blob_refs`).
31
+ * - `buildPackPorts(deps)` → `packs` (ADR-086 §5 — реестр установок
32
+ * пакетов расширений; таблица `pack_installations`).
33
+ * - `buildLegacyPipelinePorts(deps)` → `pipelines` (ADR-051/ADR-100 — реестр
34
+ * определений и экземпляров инстанса; таблицы `pipeline_definitions`/
35
+ * `pipeline_instances`). Не путать с `buildPipelinePorts` (ADR-101).
36
+ * - `buildSkillPorts(deps, blobs)` → `skills` (ADR-046 §4 / ADR-116 —
37
+ * метаданные в таблице `instance_skills`, содержимое — в blob-сторе
38
+ * `skills/<name>/…`).
39
+ * - `buildContextFilePorts(deps, opts)` → `contextFiles` (ADR-069/ADR-070 /
40
+ * ADR-116 — пользовательская часть в таблице `context_files`, системные
41
+ * промпты образа остаются ФС).
19
42
  *
20
- * Все доменные порты реализованы поверх SQL; FS/package-bound порты (`skills`,
21
- * `contextFiles`, `blobs`) — **файловые реализации** core (контент скиллов/
22
- * prompts-ролей и blob-дерево остаются на диске; ADR-091/ADR-092: ФС-периметр
23
- * вне портов).
43
+ * Все доменные порты реализованы поверх SQL; **`blobs`** остаётся файловым по
44
+ * конструкции (байты вложений/логов/содержимого скиллов — на томе, в БД только
45
+ * `blob_refs`; ADR-091/ADR-092: ФС-периметр вне портов). `packs`, legacy
46
+ * `pipelines`, `skills` и `contextFiles` — **SQL** (ADR-116): таблицы
47
+ * `pack_installations`/`pipeline_definitions`/`pipeline_instances` (миграция 025),
48
+ * `instance_skills` (миграция 026; содержимое скиллов — в blob-сторе) и
49
+ * `context_files` (миграция 027; системные промпты образа остаются ФС).
24
50
  *
25
- * Осознанное исключение: драйвер в этой части **импортирует core рантаймом**
26
- * (`createFileStorage`), чтобы переиспользовать уже проверенные файловые
27
- * реализации, а не дублировать их. Для портов БД core по-прежнему не тянется:
28
- * порты подключаются динамическим `import()` из core по `storage.backend`.
51
+ * Рантайм-импорт core сужен до трёх точечных вещей (ADR-116): `FileBlobStore` +
52
+ * `prepareBlobRoot`/`blobRootPath` (blob-порт — файловый по конструкции, корень
53
+ * `{dataDir}/blobs`) и `ContextConfig` (системные промпты образа — его резолвер;
54
+ * пользовательская часть контекста в SQL). Файловый контекст
55
+ * (`createFileStorage`) драйвер **не собирает**. Для портов БД core по-прежнему
56
+ * не тянется: порты подключаются динамическим `import()` из core по
57
+ * `storage.backend`.
29
58
  */
30
- import { createFileStorage } from '@itphx/synth-core';
59
+ import { join } from 'node:path';
60
+ // ADR-116: точечный рантайм-импорт core — blob-порт (файловый по конструкции) и
61
+ // `ContextConfig` как источник каталога системных промптов образа.
62
+ import { blobRootPath, ContextConfig, FileBlobStore, prepareBlobRoot } from '@itphx/synth-core';
31
63
  import { latestSchemaVersion, MIGRATIONS } from './migrations/index.js';
32
64
  import { planMigrations, readSchemaVersion, runMigrations } from './migrate.js';
33
65
  import { buildContentPorts } from './ports/content.js';
34
66
  import { buildAuditPorts } from './ports/audit.js';
35
67
  import { buildAnalyticsPorts } from './ports/analytics.js';
68
+ import { buildAuthorityPorts } from './ports/authority.js';
69
+ import { buildExternalCredentialPorts } from './ports/external-credentials.js';
70
+ import { buildCredentialAuditPorts } from './ports/credential-audit.js';
71
+ import { buildMemoryPorts } from './ports/memory.js';
36
72
  import { buildEventPorts } from './ports/events.js';
73
+ import { buildPipelinePorts } from './ports/pipelines.js';
74
+ // ADR-116: реестр установок пакетов (ADR-086 §5) и legacy-пайплайны
75
+ // (ADR-051/ADR-100) переведены в SQL (миграция `025_packs_pipelines`).
76
+ import { buildPackPorts } from './ports/packs.js';
77
+ import { buildLegacyPipelinePorts } from './ports/legacy-pipelines.js';
78
+ // ADR-116: instance-скиллы — метаданные в SQL (`instance_skills`, миграция 026),
79
+ // содержимое — в blob-сторе (`skills/<name>/…`).
80
+ import { buildSkillPorts } from './ports/skills.js';
81
+ // ADR-116: файлы контекста — пользовательская часть в SQL (`context_files`,
82
+ // миграция 027), системные промпты образа остаются ФС.
83
+ import { buildContextFilePorts } from './ports/context-files.js';
84
+ import { buildQuestionPorts } from './ports/questions.js';
85
+ import { buildBackgroundRunPorts } from './ports/background-runs.js';
86
+ import { buildWorktreePorts } from './ports/worktrees.js';
87
+ // ADR-115/ADR-116: учёт ссылок на объекты blob-хранилища (таблица `blob_refs`).
88
+ import { buildBlobRefPorts } from './ports/blob-refs.js';
89
+ import { buildPluginLockPorts } from './ports/plugin-lock.js';
37
90
  import { buildPrincipalPorts } from './ports/principals.js';
38
91
  import { buildSessionPorts } from './ports/sessions.js';
39
92
  import { createPostgresLocks } from './locks.js';
40
- /** Собрать `StorageContext`: четыре группы портов + файловые FS-порты + `close`. */
93
+ /** Собрать `StorageContext`: доменные порты (SQL) + blob-стор (ФС) + `close`. */
41
94
  export function buildPostgresStorageContext(opts) {
42
- // Файловый контекст переиспользуется только для FS/package-bound портов
43
- // (`skills`/`contextFiles`/`blobs`); прочие его порты не задействованы.
44
- const file = createFileStorage({
45
- dataDir: opts.dataDir,
46
- secretKey: opts.secretKey,
47
- env: opts.env,
48
- systemDictionariesDir: opts.systemDictionariesDir,
49
- contextUserDataDir: opts.contextUserDataDir,
50
- });
95
+ // ADR-116: blob-стор остаётся файловым по конструкции, поэтому создаётся
96
+ // точечно (а не сборкой всего файлового контекста) с тем же корнем, что у
97
+ // файлового backend'а — `{dataDir}/blobs`. `prepareBlobRoot` идемпотентно
98
+ // создаёт каталог и переносит логи старой раскладки.
99
+ prepareBlobRoot(opts.dataDir);
100
+ const blobs = new FileBlobStore({ root: blobRootPath(opts.dataDir) });
51
101
  const background = [];
102
+ // ADR-116: пользовательская часть файлов контекста — SQL, системные промпты —
103
+ // ФС. Каталог пользовательских файлов тот же, что у файловой реализации
104
+ // (используется лишь как путь по умолчанию для композиции).
105
+ const contextUserDataDir = opts.contextUserDataDir ?? join(opts.dataDir, 'context');
106
+ // Каталог системных промптов образа резолвит сам `ContextConfig`
107
+ // (`{root}/prompts`, fallback `{root}/dist/prompts`) — берём его у класса,
108
+ // чтобы поведение не разошлось с файловой реализацией; файловый контекст ради
109
+ // этого не нужен.
110
+ const systemPromptsDir = new ContextConfig({ userDataDir: contextUserDataDir }).systemPromptsDir;
52
111
  const deps = {
53
112
  connection: opts.connection,
54
113
  dataDir: opts.dataDir,
@@ -63,7 +122,7 @@ export function buildPostgresStorageContext(opts) {
63
122
  };
64
123
  return {
65
124
  kind: 'postgres',
66
- // PROP-032: соединение живёт в контексте; `close()` закрывает пул (graceful
125
+ // ADR-097: соединение живёт в контексте; `close()` закрывает пул (graceful
67
126
  // shutdown домена). Перед закрытием дожидаемся фоновых задач сборки
68
127
  // (best-effort прогрев синхронных кэшей `content`): warm-запросы не должны
69
128
  // попадать в уже закрытый пул — иначе диагностика/`backup`/`migrate` видят
@@ -72,7 +131,7 @@ export function buildPostgresStorageContext(opts) {
72
131
  await Promise.allSettled(background);
73
132
  await opts.connection.end();
74
133
  },
75
- // PROP-032/ADR-091: диагностика backend'а — реальный probe БД + версия схемы
134
+ // ADR-097/ADR-091: диагностика backend'а — реальный probe БД + версия схемы
76
135
  // (read-only, без применения миграций) для `synth doctor`/admin-API.
77
136
  health: async () => {
78
137
  const started = Date.now();
@@ -94,7 +153,7 @@ export function buildPostgresStorageContext(opts) {
94
153
  };
95
154
  }
96
155
  },
97
- // PROP-032/ADR-092: миграции схемы БД — план (`dryRun`) или применение
156
+ // ADR-097/ADR-092: миграции схемы БД — план (`dryRun`) или применение
98
157
  // (лок/транзакции берёт `runMigrations`).
99
158
  schemaMigrations: async (migrationOpts) => {
100
159
  if (migrationOpts?.dryRun) {
@@ -109,9 +168,9 @@ export function buildPostgresStorageContext(opts) {
109
168
  applied: result.applied,
110
169
  };
111
170
  },
112
- // PROP-032: удаление схемы БД — только по явному `uninstall --purge-db`.
171
+ // ADR-097: удаление схемы БД — только по явному `uninstall --purge-db`.
113
172
  purgeSchema: () => opts.connection.dropSchema(),
114
- // PROP-032: примитивы координации БД (advisory-локи) — composition root
173
+ // ADR-097: примитивы координации БД (advisory-локи) — composition root
115
174
  // подставляет их вместо файловых `FileMutex`/`FileLeader`.
116
175
  locks: createPostgresLocks(opts.connection),
117
176
  ...buildSessionPorts(deps),
@@ -119,12 +178,61 @@ export function buildPostgresStorageContext(opts) {
119
178
  ...buildEventPorts(deps),
120
179
  ...buildContentPorts(deps),
121
180
  ...buildAuditPorts(deps),
122
- // PROP-102: порт роллапов аналитики — пред-агрегированные суточные бакеты
181
+ // ADR-106 (Ф0/Ф1): порты Authority-слоя — политика полномочий инстанса
182
+ // (`authority_policy`, миграция 014) и append-only журнал решений
183
+ // (`authority_decisions`).
184
+ ...buildAuthorityPorts(deps),
185
+ // ADR-105 (Ф1): внешние доступы к коннекторам (таблица `external_credentials`,
186
+ // миграция 011). Токены шифруются core-хелперами (ленивый `import()`), в БД
187
+ // лежит готовый `enc:v1:…`; наружу отдаются только метаданные с маской.
188
+ ...buildExternalCredentialPorts(deps),
189
+ // ADR-105 (Ф4): журнал операций со слоем доступов (таблица
190
+ // `credential_audit`, миграция 016). Секретов и id сессий/пользователей
191
+ // в записях нет.
192
+ ...buildCredentialAuditPorts(deps),
193
+ // ADR-102: порт роллапов аналитики — пред-агрегированные суточные бакеты
123
194
  // (`analytics_rollups`, миграция 003) с атомарным `ON CONFLICT … DO UPDATE`.
124
195
  ...buildAnalyticsPorts(deps),
125
- // FS/package-bound порты: остаются файловыми (см. шапку модуля).
126
- skills: file.skills,
127
- contextFiles: file.contextFiles,
128
- blobs: file.blobs,
196
+ // ADR-101: спецификации пайплайнов, прогоны и журнал выполнения
197
+ // (`pipeline_specs`/`pipeline_versions`/`pipeline_runs`/`pipeline_run_events`,
198
+ // миграция 004).
199
+ ...buildPipelinePorts(deps),
200
+ // PROP-047 §2.1 (предпосылка A): порты памяти — факты, индексы и чанки
201
+ // (`memory_facts`/`memory_indexes`/`memory_chunks`, миграция 017). Векторы
202
+ // хранятся в `jsonb` (без `pgvector` — расширение в БД не установлено).
203
+ ...buildMemoryPorts(deps),
204
+ // PROP-068 §4.4 / ADR-090: lock-файл плагинов (таблица `plugin_lock`,
205
+ // миграция 007) — источник истины для update/uninstall.
206
+ ...buildPluginLockPorts(deps),
207
+ // Этап 1 roadmap 0.13: вопросы пользователю (таблица `questions`) и единый
208
+ // реестр фоновых прогонов (таблица `background_runs`) — миграция 021.
209
+ ...buildQuestionPorts(deps),
210
+ ...buildBackgroundRunPorts(deps),
211
+ // ADR-114: инвентарь git-worktree'ов — generic-таблица `documents`
212
+ // (`kind='worktree'`), без новой миграции.
213
+ ...buildWorktreePorts(deps),
214
+ // ADR-115/ADR-116: учёт ссылок на объекты blob-хранилища — таблица
215
+ // `blob_refs` (миграция 024). Байты объектов остаются на томе (`blobs`).
216
+ ...buildBlobRefPorts(deps),
217
+ // ADR-116: blob-стор остаётся файловым по конструкции (байты вложений,
218
+ // логов, содержимого скиллов — на томе; в БД только `blob_refs`).
219
+ blobs,
220
+ // ADR-116: пользовательские файлы контекста/промптов — SQL
221
+ // (`context_files`, миграция 027); системные промпты образа — ФС по пути
222
+ // `ContextConfig.systemPromptsDir` (композиция читает их напрямую, а
223
+ // пользовательские override — из кэша таблицы).
224
+ ...buildContextFilePorts(deps, {
225
+ systemPromptsDir,
226
+ createConfig: (overrides) => new ContextConfig({ userDataDir: contextUserDataDir, systemPromptsDir, overrides }),
227
+ }),
228
+ // ADR-116: instance-скиллы — метаданные в SQL (`instance_skills`,
229
+ // миграция 026), содержимое — в том же blob-сторе (`skills/<name>/…`).
230
+ ...buildSkillPorts(deps, blobs),
231
+ // ADR-116: реестр установок пакетов (ADR-086 §5) и legacy-пайплайны
232
+ // (ADR-051/ADR-100) — SQL-реализации (таблицы `pack_installations` /
233
+ // `pipeline_definitions` / `pipeline_instances`, миграция 025). До ADR-116
234
+ // они были переходно файловыми; контрактный suite проверяет SQL.
235
+ ...buildPackPorts(deps),
236
+ ...buildLegacyPipelinePorts(deps),
129
237
  };
130
238
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-storage-postgres",
3
- "version": "0.11.3",
3
+ "version": "0.12.4",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -15,13 +15,13 @@
15
15
  }
16
16
  },
17
17
  "dependencies": {
18
- "@itphx/synth-shared": "0.11.3"
18
+ "@itphx/synth-shared": "0.12.4"
19
19
  },
20
20
  "peerDependencies": {
21
- "@itphx/synth-core": "0.11.3"
21
+ "@itphx/synth-core": "0.12.4"
22
22
  },
23
23
  "devDependencies": {
24
- "@itphx/synth-core": "0.11.3",
24
+ "@itphx/synth-core": "0.12.4",
25
25
  "@types/node": "^22.0.0",
26
26
  "@types/pg": "^8.15.0",
27
27
  "typescript": "^5.8.0"