@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.
- package/dist/errors.d.ts +1 -1
- package/dist/errors.js +2 -2
- package/dist/index.d.ts +15 -1
- package/dist/index.js +24 -2
- package/dist/locks.d.ts +4 -4
- package/dist/locks.js +4 -4
- package/dist/migrate.d.ts +1 -1
- package/dist/migrate.js +1 -1
- package/dist/migrations/001-init.d.ts +2 -2
- package/dist/migrations/001-init.js +2 -2
- package/dist/migrations/003-analytics-rollups.d.ts +1 -1
- package/dist/migrations/003-analytics-rollups.js +1 -1
- package/dist/migrations/004-pipeline-engine.d.ts +19 -0
- package/dist/migrations/004-pipeline-engine.js +74 -0
- package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
- package/dist/migrations/005-pipeline-provenance.js +15 -0
- package/dist/migrations/006-plugin-audit.d.ts +13 -0
- package/dist/migrations/006-plugin-audit.js +34 -0
- package/dist/migrations/007-plugin-lock.d.ts +10 -0
- package/dist/migrations/007-plugin-lock.js +25 -0
- package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
- package/dist/migrations/008-plugin-audit-scan.js +15 -0
- package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
- package/dist/migrations/009-plugin-lock-previous.js +16 -0
- package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
- package/dist/migrations/010-plugin-lock-mode.js +20 -0
- package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
- package/dist/migrations/011-session-steer-inbox.js +14 -0
- package/dist/migrations/012-external-credentials.d.ts +15 -0
- package/dist/migrations/012-external-credentials.js +40 -0
- package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
- package/dist/migrations/013-service-key-plugin-id.js +20 -0
- package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
- package/dist/migrations/014-session-mode-by-principal.js +15 -0
- package/dist/migrations/015-authority.d.ts +17 -0
- package/dist/migrations/015-authority.js +43 -0
- package/dist/migrations/016-credential-audit.d.ts +17 -0
- package/dist/migrations/016-credential-audit.js +32 -0
- package/dist/migrations/017-memory.d.ts +29 -0
- package/dist/migrations/017-memory.js +95 -0
- package/dist/migrations/018-memory-index-scope.d.ts +14 -0
- package/dist/migrations/018-memory-index-scope.js +18 -0
- package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
- package/dist/migrations/019-memory-index-enabled.js +14 -0
- package/dist/migrations/020-project-memory.d.ts +11 -0
- package/dist/migrations/020-project-memory.js +13 -0
- package/dist/migrations/021-background-runs.d.ts +17 -0
- package/dist/migrations/021-background-runs.js +67 -0
- package/dist/migrations/022-background-run-process-id.d.ts +14 -0
- package/dist/migrations/022-background-run-process-id.js +18 -0
- package/dist/migrations/023-session-worktree.d.ts +12 -0
- package/dist/migrations/023-session-worktree.js +16 -0
- package/dist/migrations/024-blob-refs.d.ts +15 -0
- package/dist/migrations/024-blob-refs.js +26 -0
- package/dist/migrations/025-packs-pipelines.d.ts +28 -0
- package/dist/migrations/025-packs-pipelines.js +82 -0
- package/dist/migrations/026-instance-skills.d.ts +17 -0
- package/dist/migrations/026-instance-skills.js +25 -0
- package/dist/migrations/027-context-files.d.ts +20 -0
- package/dist/migrations/027-context-files.js +30 -0
- package/dist/migrations/index.d.ts +1 -1
- package/dist/migrations/index.js +49 -1
- package/dist/pool.d.ts +6 -6
- package/dist/pool.js +8 -8
- package/dist/ports/analytics.d.ts +1 -1
- package/dist/ports/analytics.js +1 -1
- package/dist/ports/audit.d.ts +1 -1
- package/dist/ports/audit.js +3 -0
- package/dist/ports/authority.d.ts +27 -0
- package/dist/ports/authority.js +148 -0
- package/dist/ports/background-runs.d.ts +41 -0
- package/dist/ports/background-runs.js +179 -0
- package/dist/ports/blob-refs.d.ts +36 -0
- package/dist/ports/blob-refs.js +55 -0
- package/dist/ports/content.d.ts +1 -1
- package/dist/ports/content.js +21 -7
- package/dist/ports/context-files.d.ts +145 -0
- package/dist/ports/context-files.js +279 -0
- package/dist/ports/core-sync.d.ts +1 -1
- package/dist/ports/core-sync.js +1 -1
- package/dist/ports/credential-audit.d.ts +19 -0
- package/dist/ports/credential-audit.js +96 -0
- package/dist/ports/deps.d.ts +2 -2
- package/dist/ports/deps.js +1 -1
- package/dist/ports/events-bindings.d.ts +2 -2
- package/dist/ports/events-bindings.js +2 -2
- package/dist/ports/events-core.d.ts +1 -1
- package/dist/ports/events-core.js +1 -1
- package/dist/ports/events-journal.d.ts +1 -1
- package/dist/ports/events-journal.js +1 -1
- package/dist/ports/events-scheduler.d.ts +1 -1
- package/dist/ports/events-scheduler.js +1 -1
- package/dist/ports/events-webhooks.d.ts +1 -1
- package/dist/ports/events-webhooks.js +1 -1
- package/dist/ports/events.d.ts +1 -1
- package/dist/ports/events.js +1 -1
- package/dist/ports/external-credentials.d.ts +6 -0
- package/dist/ports/external-credentials.js +363 -0
- package/dist/ports/legacy-pipelines.d.ts +50 -0
- package/dist/ports/legacy-pipelines.js +202 -0
- package/dist/ports/memory.d.ts +65 -0
- package/dist/ports/memory.js +471 -0
- package/dist/ports/packs.d.ts +32 -0
- package/dist/ports/packs.js +117 -0
- package/dist/ports/pipelines.d.ts +67 -0
- package/dist/ports/pipelines.js +297 -0
- package/dist/ports/plugin-audit.d.ts +14 -0
- package/dist/ports/plugin-audit.js +110 -0
- package/dist/ports/plugin-lock.d.ts +27 -0
- package/dist/ports/plugin-lock.js +145 -0
- package/dist/ports/principals-defaults.d.ts +1 -1
- package/dist/ports/principals-defaults.js +1 -1
- package/dist/ports/principals-documents.d.ts +1 -1
- package/dist/ports/principals-documents.js +1 -1
- package/dist/ports/principals-profiles.d.ts +1 -1
- package/dist/ports/principals-profiles.js +1 -1
- package/dist/ports/principals-projects.d.ts +1 -1
- package/dist/ports/principals-projects.js +6 -3
- package/dist/ports/principals-settings.d.ts +1 -1
- package/dist/ports/principals-settings.js +21 -1
- package/dist/ports/principals-shared.d.ts +1 -1
- package/dist/ports/principals-shared.js +1 -1
- package/dist/ports/principals.d.ts +1 -1
- package/dist/ports/principals.js +1 -1
- package/dist/ports/questions.d.ts +40 -0
- package/dist/ports/questions.js +135 -0
- package/dist/ports/sessions-mapping.d.ts +20 -3
- package/dist/ports/sessions-mapping.js +46 -2
- package/dist/ports/sessions.d.ts +13 -3
- package/dist/ports/sessions.js +20 -5
- package/dist/ports/skills.d.ts +59 -0
- package/dist/ports/skills.js +205 -0
- package/dist/ports/stub.d.ts +1 -1
- package/dist/ports/stub.js +2 -2
- package/dist/ports/worktrees.d.ts +41 -0
- package/dist/ports/worktrees.js +85 -0
- package/dist/postgres-storage.d.ts +4 -5
- package/dist/postgres-storage.js +5 -6
- package/dist/storage-context.d.ts +44 -15
- package/dist/storage-context.js +139 -31
- package/package.json +4 -4
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Драйвер слоя хранения Synth на PostgreSQL — публичная фабрика (ADR-
|
|
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
|
-
*
|
|
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
|
|
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
|
|
51
|
+
* Собрать `StorageContext` на PostgreSQL (форма — ADR-097).
|
|
53
52
|
*
|
|
54
53
|
* Валидирует конфиг, лениво подключается к БД, применяет миграции (или, при
|
|
55
54
|
* `migrate:false`, проверяет актуальность схемы — fail-closed) и возвращает
|
package/dist/postgres-storage.js
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Драйвер слоя хранения Synth на PostgreSQL — публичная фабрика (ADR-
|
|
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/
|
|
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
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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-драйвера (
|
|
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` (
|
|
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;
|
|
21
|
-
*
|
|
22
|
-
*
|
|
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
|
-
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
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
|
-
/** Корень пользовательских промптов/ролей (
|
|
69
|
+
/** Корень пользовательских промптов/ролей (композиция `contextFiles`: системные промпты — ФС образа). */
|
|
41
70
|
contextUserDataDir?: string;
|
|
42
71
|
/**
|
|
43
|
-
*
|
|
72
|
+
* ADR-097: живое соединение драйвера — удерживается в контексте, порты БД
|
|
44
73
|
* ходят через него; `close()` контекста закрывает пул.
|
|
45
74
|
*/
|
|
46
75
|
connection: PostgresConnection;
|
|
47
|
-
/** ADR-097
|
|
76
|
+
/** ADR-097: синхронные данные/хелперы core (см. `CoreSyncDeps`). */
|
|
48
77
|
coreSync: CoreSyncDeps;
|
|
49
78
|
}
|
|
50
|
-
/** Собрать `StorageContext`:
|
|
79
|
+
/** Собрать `StorageContext`: доменные порты (SQL) + blob-стор (ФС) + `close`. */
|
|
51
80
|
export declare function buildPostgresStorageContext(opts: BuildPostgresContextOptions): StorageContext;
|
package/dist/storage-context.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Сборка `StorageContext` PostgreSQL-драйвера (
|
|
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` (
|
|
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;
|
|
21
|
-
*
|
|
22
|
-
*
|
|
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
|
-
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
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 {
|
|
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`:
|
|
93
|
+
/** Собрать `StorageContext`: доменные порты (SQL) + blob-стор (ФС) + `close`. */
|
|
41
94
|
export function buildPostgresStorageContext(opts) {
|
|
42
|
-
//
|
|
43
|
-
// (
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
171
|
+
// ADR-097: удаление схемы БД — только по явному `uninstall --purge-db`.
|
|
113
172
|
purgeSchema: () => opts.connection.dropSchema(),
|
|
114
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
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.
|
|
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.
|
|
18
|
+
"@itphx/synth-shared": "0.12.4"
|
|
19
19
|
},
|
|
20
20
|
"peerDependencies": {
|
|
21
|
-
"@itphx/synth-core": "0.
|
|
21
|
+
"@itphx/synth-core": "0.12.4"
|
|
22
22
|
},
|
|
23
23
|
"devDependencies": {
|
|
24
|
-
"@itphx/synth-core": "0.
|
|
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"
|