@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
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 024_blob_refs — учёт ссылок на объекты blob-хранилища
|
|
3
|
+
* (ADR-115 §«Хранение», ADR-116 §3/«Схема БД»).
|
|
4
|
+
*
|
|
5
|
+
* Байты вложений/артефактов/скиллов/логов **не** переезжают в БД: они лежат
|
|
6
|
+
* на томе (blob-хранилище — файловый порт по конструкции, ADR-116 §2). В БД
|
|
7
|
+
* хранится только учёт ссылок — по нему дедуп (по содержимому) и
|
|
8
|
+
* детерминированный GC (ссылок не осталось → объект можно удалять).
|
|
9
|
+
*
|
|
10
|
+
* FK на таблицу блобов нет — блобов в БД нет; существование объекта проверяет
|
|
11
|
+
* порт `BlobStore`.
|
|
12
|
+
*
|
|
13
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
14
|
+
*/
|
|
15
|
+
export declare const MIGRATION_024_BLOB_REFS = "\n-- \u0423\u0447\u0451\u0442 \u0441\u0441\u044B\u043B\u043E\u043A \u043D\u0430 \u043E\u0431\u044A\u0435\u043A\u0442\u044B blob-\u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0430 (ADR-115/ADR-116).\nCREATE TABLE IF NOT EXISTS blob_refs (\n blob_path text NOT NULL,\n owner_kind text NOT NULL, -- message | pipeline-run | skill | process\n owner_id text NOT NULL,\n created_at timestamptz NOT NULL,\n PRIMARY KEY (blob_path, owner_kind, owner_id)\n);\nCREATE INDEX IF NOT EXISTS blob_refs_owner_idx ON blob_refs (owner_kind, owner_id);\nCOMMENT ON TABLE blob_refs IS '\u0421\u0441\u044B\u043B\u043A\u0438 \u043D\u0430 \u043E\u0431\u044A\u0435\u043A\u0442\u044B blob-\u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0430: \u0431\u0430\u0439\u0442\u044B \u043B\u0435\u0436\u0430\u0442 \u043D\u0430 \u0442\u043E\u043C\u0435, \u0437\u0434\u0435\u0441\u044C \u0442\u043E\u043B\u044C\u043A\u043E \u0443\u0447\u0451\u0442 \u0441\u0441\u044B\u043B\u043E\u043A (ADR-115/ADR-116)';\n";
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 024_blob_refs — учёт ссылок на объекты blob-хранилища
|
|
3
|
+
* (ADR-115 §«Хранение», ADR-116 §3/«Схема БД»).
|
|
4
|
+
*
|
|
5
|
+
* Байты вложений/артефактов/скиллов/логов **не** переезжают в БД: они лежат
|
|
6
|
+
* на томе (blob-хранилище — файловый порт по конструкции, ADR-116 §2). В БД
|
|
7
|
+
* хранится только учёт ссылок — по нему дедуп (по содержимому) и
|
|
8
|
+
* детерминированный GC (ссылок не осталось → объект можно удалять).
|
|
9
|
+
*
|
|
10
|
+
* FK на таблицу блобов нет — блобов в БД нет; существование объекта проверяет
|
|
11
|
+
* порт `BlobStore`.
|
|
12
|
+
*
|
|
13
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
14
|
+
*/
|
|
15
|
+
export const MIGRATION_024_BLOB_REFS = `
|
|
16
|
+
-- Учёт ссылок на объекты blob-хранилища (ADR-115/ADR-116).
|
|
17
|
+
CREATE TABLE IF NOT EXISTS blob_refs (
|
|
18
|
+
blob_path text NOT NULL,
|
|
19
|
+
owner_kind text NOT NULL, -- message | pipeline-run | skill | process
|
|
20
|
+
owner_id text NOT NULL,
|
|
21
|
+
created_at timestamptz NOT NULL,
|
|
22
|
+
PRIMARY KEY (blob_path, owner_kind, owner_id)
|
|
23
|
+
);
|
|
24
|
+
CREATE INDEX IF NOT EXISTS blob_refs_owner_idx ON blob_refs (owner_kind, owner_id);
|
|
25
|
+
COMMENT ON TABLE blob_refs IS 'Ссылки на объекты blob-хранилища: байты лежат на томе, здесь только учёт ссылок (ADR-115/ADR-116)';
|
|
26
|
+
`;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 025_packs_pipelines — перевод в SQL двух «переходно файловых»
|
|
3
|
+
* портов инстанса (ADR-116): реестра установок пакетов расширений
|
|
4
|
+
* (`PackRepository`, ADR-086 §5 / PROP-068) и legacy-пайплайнов
|
|
5
|
+
* (`PipelineRepository`, ADR-051/ADR-100).
|
|
6
|
+
*
|
|
7
|
+
* Таблицы повторяют доменные типы портов (`PackInstallation`,
|
|
8
|
+
* `PipelineDefinitionRecord`, `PipelineInstanceRecord`), поэтому скалярные поля
|
|
9
|
+
* определения (`on_error`/`max_attempts`/`ttl`) — колонки, а не jsonb:
|
|
10
|
+
* по ним возможны выборки, и триггеры не требуются.
|
|
11
|
+
* - `pack_installations` — ключ записи — имя пакета (уникально в инстансе);
|
|
12
|
+
* `manifest`/`files`/`provides` — `jsonb` (манифест и содержимое отложенной
|
|
13
|
+
* установки сохраняются как есть);
|
|
14
|
+
* - `pipeline_definitions` — ключ — `id`; `installed_by` — `jsonb`
|
|
15
|
+
* (`{pack, version}` — провенанс установки пакетом);
|
|
16
|
+
* - `pipeline_instances` — экземпляры прогонов: `steps`/`trigger`/`payload` —
|
|
17
|
+
* `jsonb`, `attempts` — `integer`, `status` — текст (значения — доменный
|
|
18
|
+
* перечень, CHECK не ставится: расширение перечня не должно требовать DDL).
|
|
19
|
+
*
|
|
20
|
+
* Индексы: выборка экземпляров — по определению (`pipeline_id`) и «свежие
|
|
21
|
+
* первыми» (`created_at DESC`).
|
|
22
|
+
*
|
|
23
|
+
* FK нет (паритет с файловой реализацией): удаление определения **не** трогает
|
|
24
|
+
* экземпляры — прогон самодостаточен, чистка идёт в коде порта.
|
|
25
|
+
*
|
|
26
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
27
|
+
*/
|
|
28
|
+
export declare const MIGRATION_025_PACKS_PIPELINES = "\n-- ADR-116: \u0440\u0435\u0435\u0441\u0442\u0440 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043E\u043A \u043F\u0430\u043A\u0435\u0442\u043E\u0432 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0439 (ADR-086 \u00A75 / PROP-068).\nCREATE TABLE IF NOT EXISTS pack_installations (\n name text PRIMARY KEY, -- \u0438\u043C\u044F \u043F\u0430\u043A\u0435\u0442\u0430, \u0443\u043D\u0438\u043A\u0430\u043B\u044C\u043D\u043E \u0432 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0435\n version text NOT NULL,\n kind text NOT NULL, -- plugin | gateway | addon | pack | storage\n pack_type text, -- \u0442\u0438\u043F \u043A\u043E\u043D\u0442\u0435\u043D\u0442-\u043F\u0430\u043A\u0430 (\u0442\u043E\u043B\u044C\u043A\u043E kind='pack')\n description text,\n status text NOT NULL, -- active | pending_approval | disabled\n requires_approval boolean NOT NULL DEFAULT false,\n trust_level text, -- ADR-106 \u04245: \u0444\u0430\u043A\u0442\u0438\u0447\u0435\u0441\u043A\u043E\u0435 \u0434\u043E\u0432\u0435\u0440\u0438\u0435 \u043F\u0430\u043A\u0435\u0442\u0430\n manifest jsonb, -- \u0441\u044B\u0440\u043E\u0439 \u043C\u0430\u043D\u0438\u0444\u0435\u0441\u0442 synth.pack (\u0430\u0443\u0434\u0438\u0442/\u0434\u0435\u0442\u0430\u043B\u0438 \u0432 UI)\n files jsonb, -- \u0444\u0430\u0439\u043B\u044B \u043F\u0430\u043A\u0435\u0442\u0430 \u0434\u043B\u044F \u043E\u0442\u043B\u043E\u0436\u0435\u043D\u043D\u043E\u0439 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043A\u0438\n provides jsonb NOT NULL, -- id'\u044B \u043F\u043E\u0441\u0442\u0430\u0432\u043B\u0435\u043D\u043D\u044B\u0445 \u0441\u0443\u0449\u043D\u043E\u0441\u0442\u0435\u0439 (agents/skills/mcp/pipelines)\n installed_by text,\n installed_at timestamptz NOT NULL,\n updated_at timestamptz NOT NULL\n);\nCOMMENT ON TABLE pack_installations IS '\u0423\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0435 \u043F\u0430\u043A\u0435\u0442\u044B \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0439: \u0438\u043C\u044F \u2014 \u043A\u043B\u044E\u0447 upsert, installed_at \u0438\u043C\u043C\u0443\u0442\u0430\u0431\u0435\u043B\u0435\u043D (ADR-086/ADR-116)';\n\n-- ADR-116: legacy-\u043F\u0430\u0439\u043F\u043B\u0430\u0439\u043D\u044B (ADR-051/ADR-100) \u2014 \u043E\u043F\u0440\u0435\u0434\u0435\u043B\u0435\u043D\u0438\u044F \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0430.\nCREATE TABLE IF NOT EXISTS pipeline_definitions (\n id text PRIMARY KEY,\n name text NOT NULL,\n description text,\n version text,\n steps jsonb NOT NULL,\n on_error text, -- fail | retry | rollback\n max_attempts integer,\n ttl text,\n installed_by jsonb, -- \u043F\u0440\u043E\u0432\u0435\u043D\u0430\u043D\u0441 {pack, version}\n created_at timestamptz NOT NULL,\n updated_at timestamptz NOT NULL\n);\nCOMMENT ON TABLE pipeline_definitions IS '\u041E\u043F\u0440\u0435\u0434\u0435\u043B\u0435\u043D\u0438\u044F legacy-\u043F\u0430\u0439\u043F\u043B\u0430\u0439\u043D\u043E\u0432 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0430: upsert \u043F\u043E id, created_at \u0438\u043C\u043C\u0443\u0442\u0430\u0431\u0435\u043B\u0435\u043D (ADR-051/ADR-100)';\n\n-- ADR-116: \u044D\u043A\u0437\u0435\u043C\u043F\u043B\u044F\u0440\u044B legacy-\u043F\u0430\u0439\u043F\u043B\u0430\u0439\u043D\u043E\u0432 (\u043F\u0440\u043E\u0433\u043E\u043D\u044B \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0430).\nCREATE TABLE IF NOT EXISTS pipeline_instances (\n id text PRIMARY KEY,\n pipeline_id text NOT NULL,\n pipeline_version text,\n status text NOT NULL,\n steps jsonb NOT NULL,\n current_step text,\n trigger jsonb,\n attempts integer NOT NULL DEFAULT 0,\n payload jsonb,\n error text,\n created_at timestamptz NOT NULL,\n updated_at timestamptz NOT NULL\n);\nCREATE INDEX IF NOT EXISTS pipeline_instances_pipeline_idx ON pipeline_instances (pipeline_id);\nCREATE INDEX IF NOT EXISTS pipeline_instances_created_idx ON pipeline_instances (created_at DESC);\nCOMMENT ON TABLE pipeline_instances IS '\u042D\u043A\u0437\u0435\u043C\u043F\u043B\u044F\u0440\u044B legacy-\u043F\u0430\u0439\u043F\u043B\u0430\u0439\u043D\u043E\u0432: \u0432\u044B\u0431\u043E\u0440\u043A\u0430 \u00AB\u0441\u0432\u0435\u0436\u0438\u0435 \u043F\u0435\u0440\u0432\u044B\u043C\u0438\u00BB, \u0444\u0438\u043B\u044C\u0442\u0440\u044B \u043F\u043E \u043E\u043F\u0440\u0435\u0434\u0435\u043B\u0435\u043D\u0438\u044E/\u0441\u0442\u0430\u0442\u0443\u0441\u0443 (ADR-116)';\n";
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 025_packs_pipelines — перевод в SQL двух «переходно файловых»
|
|
3
|
+
* портов инстанса (ADR-116): реестра установок пакетов расширений
|
|
4
|
+
* (`PackRepository`, ADR-086 §5 / PROP-068) и legacy-пайплайнов
|
|
5
|
+
* (`PipelineRepository`, ADR-051/ADR-100).
|
|
6
|
+
*
|
|
7
|
+
* Таблицы повторяют доменные типы портов (`PackInstallation`,
|
|
8
|
+
* `PipelineDefinitionRecord`, `PipelineInstanceRecord`), поэтому скалярные поля
|
|
9
|
+
* определения (`on_error`/`max_attempts`/`ttl`) — колонки, а не jsonb:
|
|
10
|
+
* по ним возможны выборки, и триггеры не требуются.
|
|
11
|
+
* - `pack_installations` — ключ записи — имя пакета (уникально в инстансе);
|
|
12
|
+
* `manifest`/`files`/`provides` — `jsonb` (манифест и содержимое отложенной
|
|
13
|
+
* установки сохраняются как есть);
|
|
14
|
+
* - `pipeline_definitions` — ключ — `id`; `installed_by` — `jsonb`
|
|
15
|
+
* (`{pack, version}` — провенанс установки пакетом);
|
|
16
|
+
* - `pipeline_instances` — экземпляры прогонов: `steps`/`trigger`/`payload` —
|
|
17
|
+
* `jsonb`, `attempts` — `integer`, `status` — текст (значения — доменный
|
|
18
|
+
* перечень, CHECK не ставится: расширение перечня не должно требовать DDL).
|
|
19
|
+
*
|
|
20
|
+
* Индексы: выборка экземпляров — по определению (`pipeline_id`) и «свежие
|
|
21
|
+
* первыми» (`created_at DESC`).
|
|
22
|
+
*
|
|
23
|
+
* FK нет (паритет с файловой реализацией): удаление определения **не** трогает
|
|
24
|
+
* экземпляры — прогон самодостаточен, чистка идёт в коде порта.
|
|
25
|
+
*
|
|
26
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
27
|
+
*/
|
|
28
|
+
export const MIGRATION_025_PACKS_PIPELINES = `
|
|
29
|
+
-- ADR-116: реестр установок пакетов расширений (ADR-086 §5 / PROP-068).
|
|
30
|
+
CREATE TABLE IF NOT EXISTS pack_installations (
|
|
31
|
+
name text PRIMARY KEY, -- имя пакета, уникально в инстансе
|
|
32
|
+
version text NOT NULL,
|
|
33
|
+
kind text NOT NULL, -- plugin | gateway | addon | pack | storage
|
|
34
|
+
pack_type text, -- тип контент-пака (только kind='pack')
|
|
35
|
+
description text,
|
|
36
|
+
status text NOT NULL, -- active | pending_approval | disabled
|
|
37
|
+
requires_approval boolean NOT NULL DEFAULT false,
|
|
38
|
+
trust_level text, -- ADR-106 Ф5: фактическое доверие пакета
|
|
39
|
+
manifest jsonb, -- сырой манифест synth.pack (аудит/детали в UI)
|
|
40
|
+
files jsonb, -- файлы пакета для отложенной установки
|
|
41
|
+
provides jsonb NOT NULL, -- id'ы поставленных сущностей (agents/skills/mcp/pipelines)
|
|
42
|
+
installed_by text,
|
|
43
|
+
installed_at timestamptz NOT NULL,
|
|
44
|
+
updated_at timestamptz NOT NULL
|
|
45
|
+
);
|
|
46
|
+
COMMENT ON TABLE pack_installations IS 'Установленные пакеты расширений: имя — ключ upsert, installed_at иммутабелен (ADR-086/ADR-116)';
|
|
47
|
+
|
|
48
|
+
-- ADR-116: legacy-пайплайны (ADR-051/ADR-100) — определения автомата.
|
|
49
|
+
CREATE TABLE IF NOT EXISTS pipeline_definitions (
|
|
50
|
+
id text PRIMARY KEY,
|
|
51
|
+
name text NOT NULL,
|
|
52
|
+
description text,
|
|
53
|
+
version text,
|
|
54
|
+
steps jsonb NOT NULL,
|
|
55
|
+
on_error text, -- fail | retry | rollback
|
|
56
|
+
max_attempts integer,
|
|
57
|
+
ttl text,
|
|
58
|
+
installed_by jsonb, -- провенанс {pack, version}
|
|
59
|
+
created_at timestamptz NOT NULL,
|
|
60
|
+
updated_at timestamptz NOT NULL
|
|
61
|
+
);
|
|
62
|
+
COMMENT ON TABLE pipeline_definitions IS 'Определения legacy-пайплайнов инстанса: upsert по id, created_at иммутабелен (ADR-051/ADR-100)';
|
|
63
|
+
|
|
64
|
+
-- ADR-116: экземпляры legacy-пайплайнов (прогоны автомата).
|
|
65
|
+
CREATE TABLE IF NOT EXISTS pipeline_instances (
|
|
66
|
+
id text PRIMARY KEY,
|
|
67
|
+
pipeline_id text NOT NULL,
|
|
68
|
+
pipeline_version text,
|
|
69
|
+
status text NOT NULL,
|
|
70
|
+
steps jsonb NOT NULL,
|
|
71
|
+
current_step text,
|
|
72
|
+
trigger jsonb,
|
|
73
|
+
attempts integer NOT NULL DEFAULT 0,
|
|
74
|
+
payload jsonb,
|
|
75
|
+
error text,
|
|
76
|
+
created_at timestamptz NOT NULL,
|
|
77
|
+
updated_at timestamptz NOT NULL
|
|
78
|
+
);
|
|
79
|
+
CREATE INDEX IF NOT EXISTS pipeline_instances_pipeline_idx ON pipeline_instances (pipeline_id);
|
|
80
|
+
CREATE INDEX IF NOT EXISTS pipeline_instances_created_idx ON pipeline_instances (created_at DESC);
|
|
81
|
+
COMMENT ON TABLE pipeline_instances IS 'Экземпляры legacy-пайплайнов: выборка «свежие первыми», фильтры по определению/статусу (ADR-116)';
|
|
82
|
+
`;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 026_instance_skills — instance-скиллы в SQL (ADR-116, ADR-046 §4):
|
|
3
|
+
* метаданные (`frontmatter` из `SKILL.md`) — в таблице, **содержимое**
|
|
4
|
+
* (`SKILL.md` и supporting-файлы) — в blob-сторе под `skills/<name>/…`
|
|
5
|
+
* (blobs остаются файловыми по конструкции, ADR-116 §2).
|
|
6
|
+
*
|
|
7
|
+
* Таблица — только «какие скиллы есть» и их заголовок (для листингов и
|
|
8
|
+
* дешёвой инвалидации кэша); тело и файлы читаются через `BlobStore` портом
|
|
9
|
+
* `PgSkillRepository`.
|
|
10
|
+
*
|
|
11
|
+
* `frontmatter` — разобранный заголовок `SKILL.md` (jsonb, nullable: скилл может
|
|
12
|
+
* быть создан без frontmatter — тогда `null`). `updated_at` — метка последней
|
|
13
|
+
* записи (не отдаётся домену, служебная).
|
|
14
|
+
*
|
|
15
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
16
|
+
*/
|
|
17
|
+
export declare const MIGRATION_026_INSTANCE_SKILLS = "\n-- ADR-116: instance-\u0441\u043A\u0438\u043B\u043B\u044B \u2014 \u043C\u0435\u0442\u0430\u0434\u0430\u043D\u043D\u044B\u0435 \u0432 SQL, \u0441\u043E\u0434\u0435\u0440\u0436\u0438\u043C\u043E\u0435 \u0432 blob-\u0441\u0442\u043E\u0440\u0435.\nCREATE TABLE IF NOT EXISTS instance_skills (\n name text PRIMARY KEY,\n frontmatter jsonb,\n updated_at timestamptz NOT NULL\n);\nCOMMENT ON TABLE instance_skills IS 'Instance-\u0441\u043A\u0438\u043B\u043B\u044B: \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043E\u043A SKILL.md \u0432 \u0442\u0430\u0431\u043B\u0438\u0446\u0435, \u0441\u043E\u0434\u0435\u0440\u0436\u0438\u043C\u043E\u0435 (SKILL.md + supporting) \u0432 blob-\u0441\u0442\u043E\u0440\u0435 skills/<name>/ (ADR-116)';\n";
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 026_instance_skills — instance-скиллы в SQL (ADR-116, ADR-046 §4):
|
|
3
|
+
* метаданные (`frontmatter` из `SKILL.md`) — в таблице, **содержимое**
|
|
4
|
+
* (`SKILL.md` и supporting-файлы) — в blob-сторе под `skills/<name>/…`
|
|
5
|
+
* (blobs остаются файловыми по конструкции, ADR-116 §2).
|
|
6
|
+
*
|
|
7
|
+
* Таблица — только «какие скиллы есть» и их заголовок (для листингов и
|
|
8
|
+
* дешёвой инвалидации кэша); тело и файлы читаются через `BlobStore` портом
|
|
9
|
+
* `PgSkillRepository`.
|
|
10
|
+
*
|
|
11
|
+
* `frontmatter` — разобранный заголовок `SKILL.md` (jsonb, nullable: скилл может
|
|
12
|
+
* быть создан без frontmatter — тогда `null`). `updated_at` — метка последней
|
|
13
|
+
* записи (не отдаётся домену, служебная).
|
|
14
|
+
*
|
|
15
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
16
|
+
*/
|
|
17
|
+
export const MIGRATION_026_INSTANCE_SKILLS = `
|
|
18
|
+
-- ADR-116: instance-скиллы — метаданные в SQL, содержимое в blob-сторе.
|
|
19
|
+
CREATE TABLE IF NOT EXISTS instance_skills (
|
|
20
|
+
name text PRIMARY KEY,
|
|
21
|
+
frontmatter jsonb,
|
|
22
|
+
updated_at timestamptz NOT NULL
|
|
23
|
+
);
|
|
24
|
+
COMMENT ON TABLE instance_skills IS 'Instance-скиллы: заголовок SKILL.md в таблице, содержимое (SKILL.md + supporting) в blob-сторе skills/<name>/ (ADR-116)';
|
|
25
|
+
`;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 027_context_files — пользовательские файлы контекста/промптов в SQL
|
|
3
|
+
* (ADR-069/ADR-070, ADR-116): override'ы категорий `user`/`role` и override
|
|
4
|
+
* системных промптов (`system`). Системные промпты образа остаются ФС
|
|
5
|
+
* (`{packageRoot}/prompts`) — в БД они не дублируются.
|
|
6
|
+
*
|
|
7
|
+
* Категория — доменная (`ContextCategory` порта `ContextFileRepository`):
|
|
8
|
+
* - `user` — `{context}/user/*.md` (файлы «о проекте»: SOUL/COMPANY/ABOUT);
|
|
9
|
+
* - `role` — `{context}/roles/*.md` (ролевые промпты агентов);
|
|
10
|
+
* - `system` — `{context}/user/system/**` (override промптов режимов,
|
|
11
|
+
* безопасности, планировщика; `filename` может содержать подкаталог,
|
|
12
|
+
* напр. `security/deny_path.md`).
|
|
13
|
+
*
|
|
14
|
+
* `content` — текст файла как есть (utf-8), `updated_at` — метка записи; по её
|
|
15
|
+
* максимуму PostgreSQL-порт инвалидирует процесс-локальный кэш
|
|
16
|
+
* (`PgContextFileRepository`: `SELECT max(updated_at)`).
|
|
17
|
+
*
|
|
18
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
19
|
+
*/
|
|
20
|
+
export declare const MIGRATION_027_CONTEXT_FILES = "\n-- ADR-116: \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044C\u0441\u043A\u0438\u0435 \u0444\u0430\u0439\u043B\u044B \u043A\u043E\u043D\u0442\u0435\u043A\u0441\u0442\u0430/\u043F\u0440\u043E\u043C\u043F\u0442\u043E\u0432 (override'\u044B) \u2014 \u0432 SQL.\nCREATE TABLE IF NOT EXISTS context_files (\n category text NOT NULL, -- user | role | system\n filename text NOT NULL, -- \u0438\u043C\u044F \u0438\u043B\u0438 \u043E\u0442\u043D\u043E\u0441\u0438\u0442\u0435\u043B\u044C\u043D\u044B\u0439 \u043F\u0443\u0442\u044C (system/security/*)\n content text NOT NULL,\n updated_at timestamptz NOT NULL,\n PRIMARY KEY (category, filename)\n);\nCOMMENT ON TABLE context_files IS '\u041F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044C\u0441\u043A\u0438\u0435 \u0444\u0430\u0439\u043B\u044B \u043A\u043E\u043D\u0442\u0435\u043A\u0441\u0442\u0430/\u043F\u0440\u043E\u043C\u043F\u0442\u043E\u0432: \u0441\u0438\u0441\u0442\u0435\u043C\u043D\u044B\u0435 \u043F\u0440\u043E\u043C\u043F\u0442\u044B \u043E\u0431\u0440\u0430\u0437\u0430 \u043E\u0441\u0442\u0430\u044E\u0442\u0441\u044F \u0424\u0421 (ADR-116)';\n";
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 027_context_files — пользовательские файлы контекста/промптов в SQL
|
|
3
|
+
* (ADR-069/ADR-070, ADR-116): override'ы категорий `user`/`role` и override
|
|
4
|
+
* системных промптов (`system`). Системные промпты образа остаются ФС
|
|
5
|
+
* (`{packageRoot}/prompts`) — в БД они не дублируются.
|
|
6
|
+
*
|
|
7
|
+
* Категория — доменная (`ContextCategory` порта `ContextFileRepository`):
|
|
8
|
+
* - `user` — `{context}/user/*.md` (файлы «о проекте»: SOUL/COMPANY/ABOUT);
|
|
9
|
+
* - `role` — `{context}/roles/*.md` (ролевые промпты агентов);
|
|
10
|
+
* - `system` — `{context}/user/system/**` (override промптов режимов,
|
|
11
|
+
* безопасности, планировщика; `filename` может содержать подкаталог,
|
|
12
|
+
* напр. `security/deny_path.md`).
|
|
13
|
+
*
|
|
14
|
+
* `content` — текст файла как есть (utf-8), `updated_at` — метка записи; по её
|
|
15
|
+
* максимуму PostgreSQL-порт инвалидирует процесс-локальный кэш
|
|
16
|
+
* (`PgContextFileRepository`: `SELECT max(updated_at)`).
|
|
17
|
+
*
|
|
18
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
19
|
+
*/
|
|
20
|
+
export const MIGRATION_027_CONTEXT_FILES = `
|
|
21
|
+
-- ADR-116: пользовательские файлы контекста/промптов (override'ы) — в SQL.
|
|
22
|
+
CREATE TABLE IF NOT EXISTS context_files (
|
|
23
|
+
category text NOT NULL, -- user | role | system
|
|
24
|
+
filename text NOT NULL, -- имя или относительный путь (system/security/*)
|
|
25
|
+
content text NOT NULL,
|
|
26
|
+
updated_at timestamptz NOT NULL,
|
|
27
|
+
PRIMARY KEY (category, filename)
|
|
28
|
+
);
|
|
29
|
+
COMMENT ON TABLE context_files IS 'Пользовательские файлы контекста/промптов: системные промпты образа остаются ФС (ADR-116)';
|
|
30
|
+
`;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Реестр SQL-миграций схемы PostgreSQL-драйвера (
|
|
2
|
+
* Реестр SQL-миграций схемы PostgreSQL-драйвера (ADR-097, волна 3a).
|
|
3
3
|
*
|
|
4
4
|
* Отдельный механизм от `meta.json`/file-миграций (ADR-092): версия схемы БД
|
|
5
5
|
* живёт в таблице `synth_schema_migrations` (см. `migrate.ts`). Миграции
|
package/dist/migrations/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Реестр SQL-миграций схемы PostgreSQL-драйвера (
|
|
2
|
+
* Реестр SQL-миграций схемы PostgreSQL-драйвера (ADR-097, волна 3a).
|
|
3
3
|
*
|
|
4
4
|
* Отдельный механизм от `meta.json`/file-миграций (ADR-092): версия схемы БД
|
|
5
5
|
* живёт в таблице `synth_schema_migrations` (см. `migrate.ts`). Миграции
|
|
@@ -11,11 +11,59 @@
|
|
|
11
11
|
import { MIGRATION_001_INIT } from './001-init.js';
|
|
12
12
|
import { MIGRATION_002_EGRESS_AUDIT } from './002-egress-audit.js';
|
|
13
13
|
import { MIGRATION_003_ANALYTICS_ROLLUPS } from './003-analytics-rollups.js';
|
|
14
|
+
import { MIGRATION_004_PIPELINE_ENGINE } from './004-pipeline-engine.js';
|
|
15
|
+
import { MIGRATION_005_PIPELINE_PROVENANCE } from './005-pipeline-provenance.js';
|
|
16
|
+
import { MIGRATION_006_PLUGIN_AUDIT } from './006-plugin-audit.js';
|
|
17
|
+
import { MIGRATION_007_PLUGIN_LOCK } from './007-plugin-lock.js';
|
|
18
|
+
import { MIGRATION_008_PLUGIN_AUDIT_SCAN } from './008-plugin-audit-scan.js';
|
|
19
|
+
import { MIGRATION_009_PLUGIN_LOCK_PREVIOUS } from './009-plugin-lock-previous.js';
|
|
20
|
+
import { MIGRATION_010_PLUGIN_LOCK_MODE } from './010-plugin-lock-mode.js';
|
|
21
|
+
import { MIGRATION_011_SESSION_STEER_INBOX } from './011-session-steer-inbox.js';
|
|
22
|
+
import { MIGRATION_012_EXTERNAL_CREDENTIALS } from './012-external-credentials.js';
|
|
23
|
+
import { MIGRATION_013_SERVICE_KEY_PLUGIN_ID } from './013-service-key-plugin-id.js';
|
|
24
|
+
import { MIGRATION_014_SESSION_MODE_BY_PRINCIPAL } from './014-session-mode-by-principal.js';
|
|
25
|
+
import { MIGRATION_015_AUTHORITY } from './015-authority.js';
|
|
26
|
+
import { MIGRATION_016_CREDENTIAL_AUDIT } from './016-credential-audit.js';
|
|
27
|
+
import { MIGRATION_017_MEMORY } from './017-memory.js';
|
|
28
|
+
import { MIGRATION_018_MEMORY_INDEX_SCOPE } from './018-memory-index-scope.js';
|
|
29
|
+
import { MIGRATION_019_MEMORY_INDEX_ENABLED } from './019-memory-index-enabled.js';
|
|
30
|
+
import { MIGRATION_020_PROJECT_MEMORY } from './020-project-memory.js';
|
|
31
|
+
import { MIGRATION_021_BACKGROUND_RUNS } from './021-background-runs.js';
|
|
32
|
+
import { MIGRATION_022_BACKGROUND_RUN_PROCESS_ID } from './022-background-run-process-id.js';
|
|
33
|
+
import { MIGRATION_023_SESSION_WORKTREE } from './023-session-worktree.js';
|
|
34
|
+
import { MIGRATION_024_BLOB_REFS } from './024-blob-refs.js';
|
|
35
|
+
import { MIGRATION_025_PACKS_PIPELINES } from './025-packs-pipelines.js';
|
|
36
|
+
import { MIGRATION_026_INSTANCE_SKILLS } from './026-instance-skills.js';
|
|
37
|
+
import { MIGRATION_027_CONTEXT_FILES } from './027-context-files.js';
|
|
14
38
|
/** Полный набор миграций драйвера (по возрастанию версии). */
|
|
15
39
|
export const MIGRATIONS = [
|
|
16
40
|
{ version: 1, id: '001_init', sql: MIGRATION_001_INIT },
|
|
17
41
|
{ version: 2, id: '002_egress_audit', sql: MIGRATION_002_EGRESS_AUDIT },
|
|
18
42
|
{ version: 3, id: '003_analytics_rollups', sql: MIGRATION_003_ANALYTICS_ROLLUPS },
|
|
43
|
+
{ version: 4, id: '004_pipeline_engine', sql: MIGRATION_004_PIPELINE_ENGINE },
|
|
44
|
+
{ version: 5, id: '005_pipeline_provenance', sql: MIGRATION_005_PIPELINE_PROVENANCE },
|
|
45
|
+
{ version: 6, id: '006_plugin_audit', sql: MIGRATION_006_PLUGIN_AUDIT },
|
|
46
|
+
{ version: 7, id: '007_plugin_lock', sql: MIGRATION_007_PLUGIN_LOCK },
|
|
47
|
+
{ version: 8, id: '008_plugin_audit_scan', sql: MIGRATION_008_PLUGIN_AUDIT_SCAN },
|
|
48
|
+
{ version: 9, id: '009_plugin_lock_previous', sql: MIGRATION_009_PLUGIN_LOCK_PREVIOUS },
|
|
49
|
+
{ version: 10, id: '010_plugin_lock_mode', sql: MIGRATION_010_PLUGIN_LOCK_MODE },
|
|
50
|
+
{ version: 11, id: '011_session_steer_inbox', sql: MIGRATION_011_SESSION_STEER_INBOX },
|
|
51
|
+
{ version: 12, id: '012_external_credentials', sql: MIGRATION_012_EXTERNAL_CREDENTIALS },
|
|
52
|
+
{ version: 13, id: '013_service_key_plugin_id', sql: MIGRATION_013_SERVICE_KEY_PLUGIN_ID },
|
|
53
|
+
{ version: 14, id: '014_session_mode_by_principal', sql: MIGRATION_014_SESSION_MODE_BY_PRINCIPAL },
|
|
54
|
+
{ version: 15, id: '015_authority', sql: MIGRATION_015_AUTHORITY },
|
|
55
|
+
{ version: 16, id: '016_credential_audit', sql: MIGRATION_016_CREDENTIAL_AUDIT },
|
|
56
|
+
{ version: 17, id: '017_memory', sql: MIGRATION_017_MEMORY },
|
|
57
|
+
{ version: 18, id: '018_memory_index_scope', sql: MIGRATION_018_MEMORY_INDEX_SCOPE },
|
|
58
|
+
{ version: 19, id: '019_memory_index_enabled', sql: MIGRATION_019_MEMORY_INDEX_ENABLED },
|
|
59
|
+
{ version: 20, id: '020_project_memory', sql: MIGRATION_020_PROJECT_MEMORY },
|
|
60
|
+
{ version: 21, id: '021_background_runs', sql: MIGRATION_021_BACKGROUND_RUNS },
|
|
61
|
+
{ version: 22, id: '022_background_run_process_id', sql: MIGRATION_022_BACKGROUND_RUN_PROCESS_ID },
|
|
62
|
+
{ version: 23, id: '023_session_worktree', sql: MIGRATION_023_SESSION_WORKTREE },
|
|
63
|
+
{ version: 24, id: '024_blob_refs', sql: MIGRATION_024_BLOB_REFS },
|
|
64
|
+
{ version: 25, id: '025_packs_pipelines', sql: MIGRATION_025_PACKS_PIPELINES },
|
|
65
|
+
{ version: 26, id: '026_instance_skills', sql: MIGRATION_026_INSTANCE_SKILLS },
|
|
66
|
+
{ version: 27, id: '027_context_files', sql: MIGRATION_027_CONTEXT_FILES },
|
|
19
67
|
];
|
|
20
68
|
/** Последняя (ожидаемая) версия схемы. */
|
|
21
69
|
export function latestSchemaVersion(migrations = MIGRATIONS) {
|
package/dist/pool.d.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Пул соединений и низкоуровневые хелперы PostgreSQL-драйвера (
|
|
2
|
+
* Пул соединений и низкоуровневые хелперы PostgreSQL-драйвера (ADR-097, волна 3a).
|
|
3
3
|
*
|
|
4
4
|
* Модуль **не требует** установленного `pg` на импорте: `pg` подключается лениво,
|
|
5
5
|
* внутри `createPostgresConnection`/при первом обращении к пулу (типы `pg` приходят
|
|
6
6
|
* из `@types/pg` и стираются на этапе компиляции). Это требование формы поставки
|
|
7
|
-
* (`pg` — `optionalDependencies`, ADR-097
|
|
7
|
+
* (`pg` — `optionalDependencies`, ADR-097).
|
|
8
8
|
*
|
|
9
9
|
* Публичные примитивы следующей волны (портов):
|
|
10
10
|
* - `query(text, params)` — запрос через пул (с маппингом ошибок);
|
|
@@ -38,7 +38,7 @@ export interface PostgresPoolConfig {
|
|
|
38
38
|
/** Таймаут простаивающего соединения, мс (дефолт 30000). */
|
|
39
39
|
idleTimeoutMillis?: number;
|
|
40
40
|
/**
|
|
41
|
-
* ADR-099/
|
|
41
|
+
* ADR-099/ADR-097: TLS-режим (`disable`/`require`/`verify-full`; `verify-ca` —
|
|
42
42
|
* алиас `verify-full`). Не задан — используется legacy `ssl`, иначе без TLS.
|
|
43
43
|
*/
|
|
44
44
|
sslmode?: PostgresSslMode;
|
|
@@ -89,7 +89,7 @@ export interface PostgresExecutor {
|
|
|
89
89
|
query<T extends QueryResultRow = QueryResultRow>(text: string, params?: unknown[]): Promise<T[]>;
|
|
90
90
|
}
|
|
91
91
|
/**
|
|
92
|
-
*
|
|
92
|
+
* ADR-097: выделенное соединение, удерживаемое вызывающим (напр. для
|
|
93
93
|
* session-level advisory-лока лидера). Пока оно не возвращено в пул, пул не
|
|
94
94
|
* может его переиспользовать — держите не больше одного такого соединения на
|
|
95
95
|
* процесс, если в этом нет необходимости (`poolMax` по умолчанию невелик).
|
|
@@ -107,7 +107,7 @@ export declare function advisoryLockKeyToBigInt(key: string): bigint;
|
|
|
107
107
|
/** Собирает объект конфигурации `pg.Pool` из конфига драйвера. */
|
|
108
108
|
export declare function buildPoolConfig(config: PostgresConnectionConfig, schema: string): Record<string, unknown>;
|
|
109
109
|
/**
|
|
110
|
-
* ADR-099/
|
|
110
|
+
* ADR-099/ADR-097: fail-closed проверка DSN на TLS-параметры. DSN из
|
|
111
111
|
* `storage.postgres.dsn` не должен нести `sslmode`/`sslrootcert`/`sslcert`/`sslkey`/…:
|
|
112
112
|
* `pg` накладывает DSN поверх конфига и молча перекрывает `ssl`-объект, что
|
|
113
113
|
* обнуляло бы политику CA. Задавайте TLS только в `storage.postgres.sslmode` +
|
|
@@ -159,7 +159,7 @@ export declare class PostgresConnection implements PostgresExecutor {
|
|
|
159
159
|
* Захватить выделенное соединение, удерживаемое вызывающим (не возвращается в
|
|
160
160
|
* пул до `release()`). Нужно для session-level advisory-локов: лок живёт ровно
|
|
161
161
|
* столько, сколько открыто соединение, и снимается автоматически при его
|
|
162
|
-
* разрыве/закрытии (
|
|
162
|
+
* разрыве/закрытии (ADR-097).
|
|
163
163
|
*/
|
|
164
164
|
acquireHeldClient(): Promise<HeldPostgresClient>;
|
|
165
165
|
/** Закрыть пул (идемпотентно). После закрытия запросы запрещены (не пересоздаём пул). */
|
package/dist/pool.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Пул соединений и низкоуровневые хелперы PostgreSQL-драйвера (
|
|
2
|
+
* Пул соединений и низкоуровневые хелперы PostgreSQL-драйвера (ADR-097, волна 3a).
|
|
3
3
|
*
|
|
4
4
|
* Модуль **не требует** установленного `pg` на импорте: `pg` подключается лениво,
|
|
5
5
|
* внутри `createPostgresConnection`/при первом обращении к пулу (типы `pg` приходят
|
|
6
6
|
* из `@types/pg` и стираются на этапе компиляции). Это требование формы поставки
|
|
7
|
-
* (`pg` — `optionalDependencies`, ADR-097
|
|
7
|
+
* (`pg` — `optionalDependencies`, ADR-097).
|
|
8
8
|
*
|
|
9
9
|
* Публичные примитивы следующей волны (портов):
|
|
10
10
|
* - `query(text, params)` — запрос через пул (с маппингом ошибок);
|
|
@@ -64,7 +64,7 @@ export function advisoryLockKeyToBigInt(key) {
|
|
|
64
64
|
}
|
|
65
65
|
/** Собирает объект конфигурации `pg.Pool` из конфига драйвера. */
|
|
66
66
|
export function buildPoolConfig(config, schema) {
|
|
67
|
-
// ADR-099/
|
|
67
|
+
// ADR-099/ADR-097: TLS-параметры в DSN запрещены — `pg` накладывает DSN поверх
|
|
68
68
|
// конфига (`Object.assign({}, config, parse(connectionString))`) и молча
|
|
69
69
|
// перекрывает явные ssl-опции (вплоть до отключения TLS).
|
|
70
70
|
assertNoDsnTlsParams(config.connectionString);
|
|
@@ -73,7 +73,7 @@ export function buildPoolConfig(config, schema) {
|
|
|
73
73
|
max: pool?.max ?? DEFAULT_POOL_MAX,
|
|
74
74
|
connectionTimeoutMillis: pool?.connectionTimeoutMillis ?? DEFAULT_CONNECTION_TIMEOUT_MS,
|
|
75
75
|
idleTimeoutMillis: pool?.idleTimeoutMillis ?? DEFAULT_IDLE_TIMEOUT_MS,
|
|
76
|
-
//
|
|
76
|
+
// ADR-097: незанятые соединения не удерживают event loop — CLI-команды
|
|
77
77
|
// (`synth migrate`/`doctor`/…) со `storage.backend=postgres` завершаются,
|
|
78
78
|
// а не висят вечно из-за открытых idle-клиентов пула.
|
|
79
79
|
allowExitOnIdle: true,
|
|
@@ -99,7 +99,7 @@ export function buildPoolConfig(config, schema) {
|
|
|
99
99
|
const password = config.password ?? pool?.password;
|
|
100
100
|
if (password)
|
|
101
101
|
pgConfig.password = password;
|
|
102
|
-
// ADR-099/
|
|
102
|
+
// ADR-099/ADR-097: единый источник TLS — `sslmode` (`storage.postgres.sslmode`)
|
|
103
103
|
// + `security.tls` (CA/mTLS). Не задан — прежнее поведение (legacy `ssl` либо
|
|
104
104
|
// дефолт `pg` — без TLS). Ошибки сборки (нет CA при `verify-full`) — fail-closed
|
|
105
105
|
// доменной ошибкой конфигурации.
|
|
@@ -127,7 +127,7 @@ export function buildPoolConfig(config, schema) {
|
|
|
127
127
|
return pgConfig;
|
|
128
128
|
}
|
|
129
129
|
/**
|
|
130
|
-
* ADR-099/
|
|
130
|
+
* ADR-099/ADR-097: fail-closed проверка DSN на TLS-параметры. DSN из
|
|
131
131
|
* `storage.postgres.dsn` не должен нести `sslmode`/`sslrootcert`/`sslcert`/`sslkey`/…:
|
|
132
132
|
* `pg` накладывает DSN поверх конфига и молча перекрывает `ssl`-объект, что
|
|
133
133
|
* обнуляло бы политику CA. Задавайте TLS только в `storage.postgres.sslmode` +
|
|
@@ -198,7 +198,7 @@ export class PostgresConnection {
|
|
|
198
198
|
}
|
|
199
199
|
/** Ленивое создание пула (первое обращение к БД). */
|
|
200
200
|
async getPool() {
|
|
201
|
-
//
|
|
201
|
+
// ADR-097 (W5): после `end()` пул не пересоздаётся — иначе запрос после
|
|
202
202
|
// `close()` снова поднимал бы соединение и «закрытие» было бы фиктивным.
|
|
203
203
|
if (this._closed) {
|
|
204
204
|
throw new PostgresConnectionError('Соединение с PostgreSQL закрыто (end()): пул недоступен.');
|
|
@@ -281,7 +281,7 @@ export class PostgresConnection {
|
|
|
281
281
|
* Захватить выделенное соединение, удерживаемое вызывающим (не возвращается в
|
|
282
282
|
* пул до `release()`). Нужно для session-level advisory-локов: лок живёт ровно
|
|
283
283
|
* столько, сколько открыто соединение, и снимается автоматически при его
|
|
284
|
-
* разрыве/закрытии (
|
|
284
|
+
* разрыве/закрытии (ADR-097).
|
|
285
285
|
*/
|
|
286
286
|
async acquireHeldClient() {
|
|
287
287
|
const client = await this._acquire();
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Порт роллапов аналитики PostgreSQL-драйвера (
|
|
2
|
+
* Порт роллапов аналитики PostgreSQL-драйвера (ADR-102).
|
|
3
3
|
*
|
|
4
4
|
* Таблица `analytics_rollups` (миграция 003): ключ бакета — составной первичный
|
|
5
5
|
* ключ `(family, day, dimensions)` (`jsonb` нормализует порядок ключей объекта,
|
package/dist/ports/analytics.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Порт роллапов аналитики PostgreSQL-драйвера (
|
|
2
|
+
* Порт роллапов аналитики PostgreSQL-драйвера (ADR-102).
|
|
3
3
|
*
|
|
4
4
|
* Таблица `analytics_rollups` (миграция 003): ключ бакета — составной первичный
|
|
5
5
|
* ключ `(family, day, dimensions)` (`jsonb` нормализует порядок ключей объекта,
|
package/dist/ports/audit.d.ts
CHANGED
|
@@ -10,6 +10,6 @@
|
|
|
10
10
|
import type { StorageContext } from '@itphx/synth-core';
|
|
11
11
|
import type { PortDeps } from './deps.js';
|
|
12
12
|
/** Часть `StorageContext`, которой владеет группа `audit`. */
|
|
13
|
-
export type AuditPorts = Pick<StorageContext, 'securityAudit' | 'egressRequests'>;
|
|
13
|
+
export type AuditPorts = Pick<StorageContext, 'securityAudit' | 'egressRequests' | 'pluginAudit'>;
|
|
14
14
|
/** Собрать порты журналов безопасности. */
|
|
15
15
|
export declare function buildAuditPorts(deps: PortDeps): AuditPorts;
|
package/dist/ports/audit.js
CHANGED
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
* `null`); журнал egress не содержит тел/заголовков.
|
|
9
9
|
*/
|
|
10
10
|
import { jsonbLiteral } from '../json-param.js';
|
|
11
|
+
import { buildPluginAuditPorts } from './plugin-audit.js';
|
|
11
12
|
function toISO(value) {
|
|
12
13
|
if (value instanceof Date)
|
|
13
14
|
return value.toISOString();
|
|
@@ -185,5 +186,7 @@ export function buildAuditPorts(deps) {
|
|
|
185
186
|
return {
|
|
186
187
|
securityAudit: new PostgresSecurityAuditRepository(deps),
|
|
187
188
|
egressRequests: new PostgresEgressRequestLogRepository(deps),
|
|
189
|
+
// ADR-090: журнал аудита плагинов (отдельный порт, не security-аудит).
|
|
190
|
+
...buildPluginAuditPorts(deps),
|
|
188
191
|
};
|
|
189
192
|
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Порты Authority-слоя PostgreSQL-драйвера (ADR-106 Ф0/Ф1, ADR-097).
|
|
3
|
+
*
|
|
4
|
+
* - `authority_policy` — политика полномочий **инстанса** (таблица из
|
|
5
|
+
* миграции 014): одна строка (`id = 'instance'`), документ — JSONB. «Политика
|
|
6
|
+
* не задана» (строк нет) и «политика задана и ничего не разрешает» (пустой
|
|
7
|
+
* документ) — **разные** состояния: первое означает «ось инстанса не
|
|
8
|
+
* применима», второе — «ось сужает до нуля». Чтение невалидного документа
|
|
9
|
+
* считается **отсутствием политики** (fail-closed на оси «user», а не
|
|
10
|
+
* «политика без грантов») — паритет с файловой реализацией core
|
|
11
|
+
* (`FileAuthorityPolicyStore`).
|
|
12
|
+
* - `authority_decisions` — append-only журнал решений (таблица из миграции
|
|
13
|
+
* 014; `seq bigserial` — порядок «свежие первыми», как у `security_audit`/
|
|
14
|
+
* `plugin_audit`).
|
|
15
|
+
*
|
|
16
|
+
* Политика и журнал — **отдельные** сущности: журнал фиксирует решения о
|
|
17
|
+
* правах, политика — потолок инстанса (ADR-106 §«Инварианты модели», п. 8).
|
|
18
|
+
*
|
|
19
|
+
* Драйвер не дублирует доменную валидацию: схема `authorityPolicySchema`
|
|
20
|
+
* берётся из `@itphx/synth-shared` (обычная зависимость пакета).
|
|
21
|
+
*/
|
|
22
|
+
import type { StorageContext } from '@itphx/synth-core';
|
|
23
|
+
import type { PortDeps } from './deps.js';
|
|
24
|
+
/** Часть `StorageContext`, которой владеет модуль портов Authority-слоя. */
|
|
25
|
+
export type AuthorityPorts = Pick<StorageContext, 'authorityPolicy' | 'authorityDecisions'>;
|
|
26
|
+
/** Собрать порты Authority-слоя (ADR-106 Ф0/Ф1). */
|
|
27
|
+
export declare function buildAuthorityPorts(deps: PortDeps): AuthorityPorts;
|