@itphx/synth-storage-postgres 0.0.0-stage → 0.12.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/LICENSE +18 -0
  2. package/LICENSE.ru.md +31 -0
  3. package/dist/errors.d.ts +71 -0
  4. package/dist/errors.js +126 -0
  5. package/dist/index.d.ts +51 -0
  6. package/dist/index.js +56 -0
  7. package/dist/json-param.d.ts +14 -0
  8. package/dist/json-param.js +22 -0
  9. package/dist/locks.d.ts +104 -0
  10. package/dist/locks.js +201 -0
  11. package/dist/migrate.d.ts +58 -0
  12. package/dist/migrate.js +125 -0
  13. package/dist/migrations/001-init.d.ts +15 -0
  14. package/dist/migrations/001-init.js +457 -0
  15. package/dist/migrations/002-egress-audit.d.ts +12 -0
  16. package/dist/migrations/002-egress-audit.js +52 -0
  17. package/dist/migrations/003-analytics-rollups.d.ts +12 -0
  18. package/dist/migrations/003-analytics-rollups.js +21 -0
  19. package/dist/migrations/004-pipeline-engine.d.ts +19 -0
  20. package/dist/migrations/004-pipeline-engine.js +74 -0
  21. package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
  22. package/dist/migrations/005-pipeline-provenance.js +15 -0
  23. package/dist/migrations/006-plugin-audit.d.ts +13 -0
  24. package/dist/migrations/006-plugin-audit.js +34 -0
  25. package/dist/migrations/007-plugin-lock.d.ts +10 -0
  26. package/dist/migrations/007-plugin-lock.js +25 -0
  27. package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
  28. package/dist/migrations/008-plugin-audit-scan.js +15 -0
  29. package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
  30. package/dist/migrations/009-plugin-lock-previous.js +16 -0
  31. package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
  32. package/dist/migrations/010-plugin-lock-mode.js +20 -0
  33. package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
  34. package/dist/migrations/011-session-steer-inbox.js +14 -0
  35. package/dist/migrations/012-external-credentials.d.ts +15 -0
  36. package/dist/migrations/012-external-credentials.js +40 -0
  37. package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
  38. package/dist/migrations/013-service-key-plugin-id.js +20 -0
  39. package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
  40. package/dist/migrations/014-session-mode-by-principal.js +15 -0
  41. package/dist/migrations/015-authority.d.ts +17 -0
  42. package/dist/migrations/015-authority.js +43 -0
  43. package/dist/migrations/016-credential-audit.d.ts +17 -0
  44. package/dist/migrations/016-credential-audit.js +32 -0
  45. package/dist/migrations/017-memory.d.ts +29 -0
  46. package/dist/migrations/017-memory.js +95 -0
  47. package/dist/migrations/018-memory-index-scope.d.ts +14 -0
  48. package/dist/migrations/018-memory-index-scope.js +18 -0
  49. package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
  50. package/dist/migrations/019-memory-index-enabled.js +14 -0
  51. package/dist/migrations/020-project-memory.d.ts +11 -0
  52. package/dist/migrations/020-project-memory.js +13 -0
  53. package/dist/migrations/021-background-runs.d.ts +17 -0
  54. package/dist/migrations/021-background-runs.js +67 -0
  55. package/dist/migrations/022-background-run-process-id.d.ts +14 -0
  56. package/dist/migrations/022-background-run-process-id.js +18 -0
  57. package/dist/migrations/023-session-worktree.d.ts +12 -0
  58. package/dist/migrations/023-session-worktree.js +16 -0
  59. package/dist/migrations/024-blob-refs.d.ts +15 -0
  60. package/dist/migrations/024-blob-refs.js +26 -0
  61. package/dist/migrations/025-packs-pipelines.d.ts +28 -0
  62. package/dist/migrations/025-packs-pipelines.js +82 -0
  63. package/dist/migrations/026-instance-skills.d.ts +17 -0
  64. package/dist/migrations/026-instance-skills.js +25 -0
  65. package/dist/migrations/027-context-files.d.ts +20 -0
  66. package/dist/migrations/027-context-files.js +30 -0
  67. package/dist/migrations/index.d.ts +23 -0
  68. package/dist/migrations/index.js +71 -0
  69. package/dist/pool.d.ts +178 -0
  70. package/dist/pool.js +382 -0
  71. package/dist/ports/analytics.d.ts +26 -0
  72. package/dist/ports/analytics.js +243 -0
  73. package/dist/ports/audit.d.ts +15 -0
  74. package/dist/ports/audit.js +192 -0
  75. package/dist/ports/authority.d.ts +27 -0
  76. package/dist/ports/authority.js +148 -0
  77. package/dist/ports/background-runs.d.ts +41 -0
  78. package/dist/ports/background-runs.js +179 -0
  79. package/dist/ports/blob-refs.d.ts +36 -0
  80. package/dist/ports/blob-refs.js +55 -0
  81. package/dist/ports/content.d.ts +41 -0
  82. package/dist/ports/content.js +1553 -0
  83. package/dist/ports/context-files.d.ts +145 -0
  84. package/dist/ports/context-files.js +279 -0
  85. package/dist/ports/core-sync.d.ts +31 -0
  86. package/dist/ports/core-sync.js +34 -0
  87. package/dist/ports/credential-audit.d.ts +19 -0
  88. package/dist/ports/credential-audit.js +96 -0
  89. package/dist/ports/deps.d.ts +63 -0
  90. package/dist/ports/deps.js +19 -0
  91. package/dist/ports/events-bindings.d.ts +77 -0
  92. package/dist/ports/events-bindings.js +356 -0
  93. package/dist/ports/events-core.d.ts +35 -0
  94. package/dist/ports/events-core.js +71 -0
  95. package/dist/ports/events-journal.d.ts +68 -0
  96. package/dist/ports/events-journal.js +211 -0
  97. package/dist/ports/events-scheduler.d.ts +49 -0
  98. package/dist/ports/events-scheduler.js +231 -0
  99. package/dist/ports/events-webhooks.d.ts +64 -0
  100. package/dist/ports/events-webhooks.js +268 -0
  101. package/dist/ports/events.d.ts +20 -0
  102. package/dist/ports/events.js +27 -0
  103. package/dist/ports/external-credentials.d.ts +6 -0
  104. package/dist/ports/external-credentials.js +363 -0
  105. package/dist/ports/legacy-pipelines.d.ts +50 -0
  106. package/dist/ports/legacy-pipelines.js +202 -0
  107. package/dist/ports/memory.d.ts +65 -0
  108. package/dist/ports/memory.js +471 -0
  109. package/dist/ports/packs.d.ts +32 -0
  110. package/dist/ports/packs.js +117 -0
  111. package/dist/ports/pipelines.d.ts +67 -0
  112. package/dist/ports/pipelines.js +297 -0
  113. package/dist/ports/plugin-audit.d.ts +14 -0
  114. package/dist/ports/plugin-audit.js +110 -0
  115. package/dist/ports/plugin-lock.d.ts +27 -0
  116. package/dist/ports/plugin-lock.js +145 -0
  117. package/dist/ports/principals-defaults.d.ts +21 -0
  118. package/dist/ports/principals-defaults.js +68 -0
  119. package/dist/ports/principals-documents.d.ts +23 -0
  120. package/dist/ports/principals-documents.js +38 -0
  121. package/dist/ports/principals-profiles.d.ts +21 -0
  122. package/dist/ports/principals-profiles.js +263 -0
  123. package/dist/ports/principals-projects.d.ts +19 -0
  124. package/dist/ports/principals-projects.js +161 -0
  125. package/dist/ports/principals-settings.d.ts +25 -0
  126. package/dist/ports/principals-settings.js +295 -0
  127. package/dist/ports/principals-shared.d.ts +33 -0
  128. package/dist/ports/principals-shared.js +44 -0
  129. package/dist/ports/principals.d.ts +27 -0
  130. package/dist/ports/principals.js +39 -0
  131. package/dist/ports/questions.d.ts +40 -0
  132. package/dist/ports/questions.js +135 -0
  133. package/dist/ports/sessions-mapping.d.ts +254 -0
  134. package/dist/ports/sessions-mapping.js +449 -0
  135. package/dist/ports/sessions.d.ts +143 -0
  136. package/dist/ports/sessions.js +517 -0
  137. package/dist/ports/skills.d.ts +59 -0
  138. package/dist/ports/skills.js +205 -0
  139. package/dist/ports/stub.d.ts +14 -0
  140. package/dist/ports/stub.js +32 -0
  141. package/dist/ports/worktrees.d.ts +41 -0
  142. package/dist/ports/worktrees.js +85 -0
  143. package/dist/postgres-storage.d.ts +58 -0
  144. package/dist/postgres-storage.js +110 -0
  145. package/dist/schema.d.ts +13 -0
  146. package/dist/schema.js +22 -0
  147. package/dist/storage-context.d.ts +80 -0
  148. package/dist/storage-context.js +238 -0
  149. package/package.json +40 -3
  150. package/README.md +0 -3
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Миграция 005_pipeline_provenance — провенанс установки пайплайна
3
+ * (ADR-101 §2.11): каким пакетом расширения принесён шаблон.
4
+ *
5
+ * Колонка `installed_by` в `pipeline_specs` — jsonb (`{pack, version}`),
6
+ * ровно та же форма, что у legacy-определения ADR-100
7
+ * (`PipelineDefinitionRecord.installedBy`). Значение может быть `NULL`:
8
+ * пайплайн, созданный вручную, провенанса не имеет.
9
+ *
10
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
11
+ */
12
+ export const MIGRATION_005_PIPELINE_PROVENANCE = `
13
+ -- ── Pipeline Engine: провенанс установки (ADR-101 §2.11) ──────────────────────
14
+ ALTER TABLE pipeline_specs ADD COLUMN IF NOT EXISTS installed_by jsonb;
15
+ `;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Миграция 006_plugin_audit — журнал аудита плагинов (ADR-090).
3
+ *
4
+ * Отдельная append-only таблица: журнал плагинов — **не** security-аудит
5
+ * (семантика «событие расширения» ≠ «изменение политики»), поэтому свой
6
+ * порт, своя таблица и свой набор колонок.
7
+ *
8
+ * `seq bigserial` — стабильный порядок «свежие первыми» (как у
9
+ * `maintenance_audit`/`security_audit`).
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export declare const MIGRATION_006_PLUGIN_AUDIT = "\n-- \u0416\u0443\u0440\u043D\u0430\u043B \u0430\u0443\u0434\u0438\u0442\u0430 \u043F\u043B\u0430\u0433\u0438\u043D\u043E\u0432 (ADR-090): \u0430\u043A\u0442\u0438\u0432\u0430\u0446\u0438\u044F/\u0434\u0435\u0430\u043A\u0442\u0438\u0432\u0430\u0446\u0438\u044F \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u044F.\nCREATE TABLE IF NOT EXISTS plugin_audit (\n seq bigserial PRIMARY KEY,\n id text NOT NULL,\n ts timestamptz NOT NULL,\n actor text NOT NULL,\n scope text NOT NULL,\n action text NOT NULL,\n plugin text NOT NULL,\n version text NOT NULL,\n trust_level text,\n scan_verdict text,\n content_hash text,\n mode text,\n outcome text NOT NULL,\n reason text,\n source text\n);\nCREATE INDEX IF NOT EXISTS plugin_audit_ts_idx ON plugin_audit (ts DESC);\nCREATE INDEX IF NOT EXISTS plugin_audit_plugin_ts_idx ON plugin_audit (plugin, ts DESC);\n";
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Миграция 006_plugin_audit — журнал аудита плагинов (ADR-090).
3
+ *
4
+ * Отдельная append-only таблица: журнал плагинов — **не** security-аудит
5
+ * (семантика «событие расширения» ≠ «изменение политики»), поэтому свой
6
+ * порт, своя таблица и свой набор колонок.
7
+ *
8
+ * `seq bigserial` — стабильный порядок «свежие первыми» (как у
9
+ * `maintenance_audit`/`security_audit`).
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export const MIGRATION_006_PLUGIN_AUDIT = `
14
+ -- Журнал аудита плагинов (ADR-090): активация/деактивация расширения.
15
+ CREATE TABLE IF NOT EXISTS plugin_audit (
16
+ seq bigserial PRIMARY KEY,
17
+ id text NOT NULL,
18
+ ts timestamptz NOT NULL,
19
+ actor text NOT NULL,
20
+ scope text NOT NULL,
21
+ action text NOT NULL,
22
+ plugin text NOT NULL,
23
+ version text NOT NULL,
24
+ trust_level text,
25
+ scan_verdict text,
26
+ content_hash text,
27
+ mode text,
28
+ outcome text NOT NULL,
29
+ reason text,
30
+ source text
31
+ );
32
+ CREATE INDEX IF NOT EXISTS plugin_audit_ts_idx ON plugin_audit (ts DESC);
33
+ CREATE INDEX IF NOT EXISTS plugin_audit_plugin_ts_idx ON plugin_audit (plugin, ts DESC);
34
+ `;
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Миграция 007_plugin_lock — lock-файл плагинов (PROP-068 §4.4 / ADR-090).
3
+ *
4
+ * Lock — **источник истины** для update/uninstall: по строке известны
5
+ * источник, pin (`ref`), content-hash, уровень доверия и вердикт скана.
6
+ * Ключ — имя плагина (уникально в инстансе), поэтому upsert — `ON CONFLICT`.
7
+ *
8
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
9
+ */
10
+ export declare const MIGRATION_007_PLUGIN_LOCK = "\n-- Lock-\u0444\u0430\u0439\u043B \u043F\u043B\u0430\u0433\u0438\u043D\u043E\u0432: \u043F\u0440\u043E\u0432\u0435\u043D\u0430\u043D\u0441 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043A\u0438 (\u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A \u0438\u0441\u0442\u0438\u043D\u044B \u0434\u043B\u044F update/uninstall).\nCREATE TABLE IF NOT EXISTS plugin_lock (\n name text PRIMARY KEY,\n version text NOT NULL,\n source text NOT NULL,\n identifier text,\n trust_level text NOT NULL,\n scan_verdict text NOT NULL,\n content_hash text NOT NULL,\n ref text,\n entry text,\n installed_at timestamptz NOT NULL,\n updated_at timestamptz NOT NULL\n);\n";
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Миграция 007_plugin_lock — lock-файл плагинов (PROP-068 §4.4 / ADR-090).
3
+ *
4
+ * Lock — **источник истины** для update/uninstall: по строке известны
5
+ * источник, pin (`ref`), content-hash, уровень доверия и вердикт скана.
6
+ * Ключ — имя плагина (уникально в инстансе), поэтому upsert — `ON CONFLICT`.
7
+ *
8
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
9
+ */
10
+ export const MIGRATION_007_PLUGIN_LOCK = `
11
+ -- Lock-файл плагинов: провенанс установки (источник истины для update/uninstall).
12
+ CREATE TABLE IF NOT EXISTS plugin_lock (
13
+ name text PRIMARY KEY,
14
+ version text NOT NULL,
15
+ source text NOT NULL,
16
+ identifier text,
17
+ trust_level text NOT NULL,
18
+ scan_verdict text NOT NULL,
19
+ content_hash text NOT NULL,
20
+ ref text,
21
+ entry text,
22
+ installed_at timestamptz NOT NULL,
23
+ updated_at timestamptz NOT NULL
24
+ );
25
+ `;
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Миграция 008_plugin_audit_scan — поля скана в журнале аудита плагинов
3
+ * (ADR-090, Ф2).
4
+ *
5
+ * Ф1-журнал знал только вердикт скана; Ф2 добавил действие `scan` и два поля:
6
+ * `scan_performed` (выполнялся ли скан — по нему видно, что скан был **выключен
7
+ * политикой**) и `scan_findings` (число находок).
8
+ *
9
+ * Миграция идемпотентна (`ADD COLUMN IF NOT EXISTS`).
10
+ */
11
+ export declare const MIGRATION_008_PLUGIN_AUDIT_SCAN = "\n-- \u0421\u043A\u0430\u043D \u043F\u043B\u0430\u0433\u0438\u043D\u0430: \u0432\u044B\u043F\u043E\u043B\u043D\u044F\u043B\u0441\u044F \u043B\u0438 \u0438 \u0441\u043A\u043E\u043B\u044C\u043A\u043E \u043D\u0430\u0445\u043E\u0434\u043E\u043A (ADR-090, \u04242).\nALTER TABLE plugin_audit ADD COLUMN IF NOT EXISTS scan_performed boolean;\nALTER TABLE plugin_audit ADD COLUMN IF NOT EXISTS scan_findings integer;\n";
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Миграция 008_plugin_audit_scan — поля скана в журнале аудита плагинов
3
+ * (ADR-090, Ф2).
4
+ *
5
+ * Ф1-журнал знал только вердикт скана; Ф2 добавил действие `scan` и два поля:
6
+ * `scan_performed` (выполнялся ли скан — по нему видно, что скан был **выключен
7
+ * политикой**) и `scan_findings` (число находок).
8
+ *
9
+ * Миграция идемпотентна (`ADD COLUMN IF NOT EXISTS`).
10
+ */
11
+ export const MIGRATION_008_PLUGIN_AUDIT_SCAN = `
12
+ -- Скан плагина: выполнялся ли и сколько находок (ADR-090, Ф2).
13
+ ALTER TABLE plugin_audit ADD COLUMN IF NOT EXISTS scan_performed boolean;
14
+ ALTER TABLE plugin_audit ADD COLUMN IF NOT EXISTS scan_findings integer;
15
+ `;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Миграция 009_plugin_lock_previous — ступень отката в lock-файле плагинов
3
+ * (ADR-090, долги Д2).
4
+ *
5
+ * `previous jsonb` — предыдущая установленная версия (`version`,
6
+ * `content_hash`, `entry?`, `installed_at`). Хранится **ровно одна** ступень:
7
+ * обновление перезаписывает её, откат меняет местами текущую и предыдущую.
8
+ * У записи, поставленной обычной установкой, колонка `NULL` (поле в домене
9
+ * отсутствует, а не `null`).
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export declare const MIGRATION_009_PLUGIN_LOCK_PREVIOUS = "\n-- \u0421\u0442\u0443\u043F\u0435\u043D\u044C \u043E\u0442\u043A\u0430\u0442\u0430: \u043F\u0440\u0435\u0434\u044B\u0434\u0443\u0449\u0430\u044F \u0432\u0435\u0440\u0441\u0438\u044F \u043F\u043B\u0430\u0433\u0438\u043D\u0430 (\u043E\u0434\u043D\u0430, jsonb).\nALTER TABLE plugin_lock ADD COLUMN IF NOT EXISTS previous jsonb;\n";
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Миграция 009_plugin_lock_previous — ступень отката в lock-файле плагинов
3
+ * (ADR-090, долги Д2).
4
+ *
5
+ * `previous jsonb` — предыдущая установленная версия (`version`,
6
+ * `content_hash`, `entry?`, `installed_at`). Хранится **ровно одна** ступень:
7
+ * обновление перезаписывает её, откат меняет местами текущую и предыдущую.
8
+ * У записи, поставленной обычной установкой, колонка `NULL` (поле в домене
9
+ * отсутствует, а не `null`).
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export const MIGRATION_009_PLUGIN_LOCK_PREVIOUS = `
14
+ -- Ступень отката: предыдущая версия плагина (одна, jsonb).
15
+ ALTER TABLE plugin_lock ADD COLUMN IF NOT EXISTS previous jsonb;
16
+ `;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Миграция 010_plugin_lock_mode — режим исполнения плагина в lock-файле
3
+ * (ADR-090, Ф4б-2).
4
+ *
5
+ * `mode` — объявленный режим плагина (`inline` | `remote` | `both`): хост по нему
6
+ * выбирает транспорт (код в процессе core или отдельный процесс на loopback).
7
+ * `remote_entry` — точка входа удалённого процесса внутри бандла
8
+ * (`dist/server.js`); заполняется только для режимов `remote`/`both`, если файл
9
+ * реально есть в бандле.
10
+ *
11
+ * У записи, поставленной обычной (inline) установкой, обе колонки `NULL`
12
+ * (в домене поля отсутствуют, а не `null`).
13
+ *
14
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
15
+ */
16
+ export declare const MIGRATION_010_PLUGIN_LOCK_MODE = "\n-- \u0420\u0435\u0436\u0438\u043C \u0438\u0441\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \u043F\u043B\u0430\u0433\u0438\u043D\u0430 \u0438 \u0442\u043E\u0447\u043A\u0430 \u0432\u0445\u043E\u0434\u0430 \u0443\u0434\u0430\u043B\u0451\u043D\u043D\u043E\u0433\u043E \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430.\nALTER TABLE plugin_lock ADD COLUMN IF NOT EXISTS mode text;\nALTER TABLE plugin_lock ADD COLUMN IF NOT EXISTS remote_entry text;\n";
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Миграция 010_plugin_lock_mode — режим исполнения плагина в lock-файле
3
+ * (ADR-090, Ф4б-2).
4
+ *
5
+ * `mode` — объявленный режим плагина (`inline` | `remote` | `both`): хост по нему
6
+ * выбирает транспорт (код в процессе core или отдельный процесс на loopback).
7
+ * `remote_entry` — точка входа удалённого процесса внутри бандла
8
+ * (`dist/server.js`); заполняется только для режимов `remote`/`both`, если файл
9
+ * реально есть в бандле.
10
+ *
11
+ * У записи, поставленной обычной (inline) установкой, обе колонки `NULL`
12
+ * (в домене поля отсутствуют, а не `null`).
13
+ *
14
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
15
+ */
16
+ export const MIGRATION_010_PLUGIN_LOCK_MODE = `
17
+ -- Режим исполнения плагина и точка входа удалённого процесса.
18
+ ALTER TABLE plugin_lock ADD COLUMN IF NOT EXISTS mode text;
19
+ ALTER TABLE plugin_lock ADD COLUMN IF NOT EXISTS remote_entry text;
20
+ `;
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Миграция 011_session_steer_inbox — очередь инъекций (steering) сессии
3
+ * (ADR-104, Ф1).
4
+ *
5
+ * `steer_inbox` — jsonb-массив сообщений, отправленных во время активного
6
+ * хода (`mode: 'steer'`). Хранится отдельно от `pending_messages`: оркестратор
7
+ * вычитывает очередь на границе шага и вплетает сообщения в текущий ход.
8
+ *
9
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
10
+ */
11
+ export declare const MIGRATION_011_SESSION_STEER_INBOX = "\n-- \u041E\u0447\u0435\u0440\u0435\u0434\u044C \u0438\u043D\u044A\u0435\u043A\u0446\u0438\u0439 (steering) \u0441\u0435\u0441\u0441\u0438\u0438.\nALTER TABLE sessions ADD COLUMN IF NOT EXISTS steer_inbox jsonb NOT NULL DEFAULT '[]'::jsonb;\n";
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Миграция 011_session_steer_inbox — очередь инъекций (steering) сессии
3
+ * (ADR-104, Ф1).
4
+ *
5
+ * `steer_inbox` — jsonb-массив сообщений, отправленных во время активного
6
+ * хода (`mode: 'steer'`). Хранится отдельно от `pending_messages`: оркестратор
7
+ * вычитывает очередь на границе шага и вплетает сообщения в текущий ход.
8
+ *
9
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
10
+ */
11
+ export const MIGRATION_011_SESSION_STEER_INBOX = `
12
+ -- Очередь инъекций (steering) сессии.
13
+ ALTER TABLE sessions ADD COLUMN IF NOT EXISTS steer_inbox jsonb NOT NULL DEFAULT '[]'::jsonb;
14
+ `;
@@ -0,0 +1,15 @@
1
+ /**
2
+ * ADR-105 (Ф1): миграция таблицы внешних доступов (`external_credentials`).
3
+ *
4
+ * Отдельная таблица (не `documents`/`settings`): у доступа есть собственная
5
+ * семантика — владелец, статус, срок, отзыв — и колонки с **зашифрованными**
6
+ * токенами (`secret_enc`/`refresh_enc`), которые не должны попадать в общие
7
+ * JSON-документы.
8
+ *
9
+ * Шифрование — **только** core-хелперами (`encryptSecret`/`decryptSecret`,
10
+ * формат `enc:v1:…`): драйвер не дублирует криптографию. Поэтому значения
11
+ * хранятся как `text` (готовый токен `enc:v1:…`), а не в открытом виде.
12
+ *
13
+ * Миграция идемпотентна (`IF NOT EXISTS`).
14
+ */
15
+ export declare const MIGRATION_012_EXTERNAL_CREDENTIALS = "\nCREATE TABLE IF NOT EXISTS external_credentials (\n id text PRIMARY KEY,\n provider text NOT NULL,\n connector_id text,\n client_id text NOT NULL,\n scopes jsonb NOT NULL DEFAULT '[]'::jsonb,\n owner_kind text NOT NULL,\n owner_id text NOT NULL,\n project_id text,\n secret_enc text NOT NULL,\n refresh_enc text,\n status text NOT NULL,\n expires_at timestamptz,\n revoked_at timestamptz,\n created_by text NOT NULL,\n created_at timestamptz NOT NULL,\n last_used_at timestamptz,\n scopes_granted jsonb\n);\n\nCREATE INDEX IF NOT EXISTS external_credentials_owner_idx\n ON external_credentials (owner_kind, owner_id);\nCREATE INDEX IF NOT EXISTS external_credentials_connector_idx\n ON external_credentials (connector_id);\n";
@@ -0,0 +1,40 @@
1
+ /**
2
+ * ADR-105 (Ф1): миграция таблицы внешних доступов (`external_credentials`).
3
+ *
4
+ * Отдельная таблица (не `documents`/`settings`): у доступа есть собственная
5
+ * семантика — владелец, статус, срок, отзыв — и колонки с **зашифрованными**
6
+ * токенами (`secret_enc`/`refresh_enc`), которые не должны попадать в общие
7
+ * JSON-документы.
8
+ *
9
+ * Шифрование — **только** core-хелперами (`encryptSecret`/`decryptSecret`,
10
+ * формат `enc:v1:…`): драйвер не дублирует криптографию. Поэтому значения
11
+ * хранятся как `text` (готовый токен `enc:v1:…`), а не в открытом виде.
12
+ *
13
+ * Миграция идемпотентна (`IF NOT EXISTS`).
14
+ */
15
+ export const MIGRATION_012_EXTERNAL_CREDENTIALS = `
16
+ CREATE TABLE IF NOT EXISTS external_credentials (
17
+ id text PRIMARY KEY,
18
+ provider text NOT NULL,
19
+ connector_id text,
20
+ client_id text NOT NULL,
21
+ scopes jsonb NOT NULL DEFAULT '[]'::jsonb,
22
+ owner_kind text NOT NULL,
23
+ owner_id text NOT NULL,
24
+ project_id text,
25
+ secret_enc text NOT NULL,
26
+ refresh_enc text,
27
+ status text NOT NULL,
28
+ expires_at timestamptz,
29
+ revoked_at timestamptz,
30
+ created_by text NOT NULL,
31
+ created_at timestamptz NOT NULL,
32
+ last_used_at timestamptz,
33
+ scopes_granted jsonb
34
+ );
35
+
36
+ CREATE INDEX IF NOT EXISTS external_credentials_owner_idx
37
+ ON external_credentials (owner_kind, owner_id);
38
+ CREATE INDEX IF NOT EXISTS external_credentials_connector_idx
39
+ ON external_credentials (connector_id);
40
+ `;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Миграция 013_service_key_plugin_id — привязка service-key к плагину
3
+ * (ADR-090 Ф7, Уровень 2: server-scoped токены).
4
+ *
5
+ * `plugin_id` — имя плагина, которому выдан ключ. Ключ с привязкой сервер
6
+ * принимает только с заголовком `X-Synth-Plugin-Id` и тем же значением, со
7
+ * scope `plugins:invoke` и (при `plugins.hybrid.mode='allowlist'`) с именем
8
+ * плагина в серверном allow-list.
9
+ *
10
+ * Колонка **внутренняя**: публичный контракт `/api/v2/service-keys` не
11
+ * меняется (ADR-052) — привязка видна только в enforcement-контексте.
12
+ *
13
+ * У ключа, выданного обычным путём, колонка `NULL` (в домене поля нет).
14
+ *
15
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
16
+ */
17
+ export declare const MIGRATION_013_SERVICE_KEY_PLUGIN_ID = "\n-- \u041F\u0440\u0438\u0432\u044F\u0437\u043A\u0430 service-key \u043A \u043F\u043B\u0430\u0433\u0438\u043D\u0443 (server-scoped \u0442\u043E\u043A\u0435\u043D, ADR-090 \u04247).\nALTER TABLE service_keys ADD COLUMN IF NOT EXISTS plugin_id text;\n";
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Миграция 013_service_key_plugin_id — привязка service-key к плагину
3
+ * (ADR-090 Ф7, Уровень 2: server-scoped токены).
4
+ *
5
+ * `plugin_id` — имя плагина, которому выдан ключ. Ключ с привязкой сервер
6
+ * принимает только с заголовком `X-Synth-Plugin-Id` и тем же значением, со
7
+ * scope `plugins:invoke` и (при `plugins.hybrid.mode='allowlist'`) с именем
8
+ * плагина в серверном allow-list.
9
+ *
10
+ * Колонка **внутренняя**: публичный контракт `/api/v2/service-keys` не
11
+ * меняется (ADR-052) — привязка видна только в enforcement-контексте.
12
+ *
13
+ * У ключа, выданного обычным путём, колонка `NULL` (в домене поля нет).
14
+ *
15
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
16
+ */
17
+ export const MIGRATION_013_SERVICE_KEY_PLUGIN_ID = `
18
+ -- Привязка service-key к плагину (server-scoped токен, ADR-090 Ф7).
19
+ ALTER TABLE service_keys ADD COLUMN IF NOT EXISTS plugin_id text;
20
+ `;
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Миграция 014_session_mode_by_principal — режим сессии по принципалу
3
+ * (ADR-106 Ф4, шаг C).
4
+ *
5
+ * `mode_by_principal` — jsonb-карта переопределений режима сессии по id
6
+ * участника (`{ "<userId>": "yolo" }`). Режим — свойство хода: `yolo`,
7
+ * выставленный одним участником, действует только на его ходы и не снимает
8
+ * подтверждения у других участников.
9
+ *
10
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
11
+ */
12
+ export declare const MIGRATION_014_SESSION_MODE_BY_PRINCIPAL = "\n-- ADR-106 \u04244 (\u0448\u0430\u0433 C): \u0440\u0435\u0436\u0438\u043C \u0441\u0435\u0441\u0441\u0438\u0438 \u043F\u043E \u043F\u0440\u0438\u043D\u0446\u0438\u043F\u0430\u043B\u0443.\nALTER TABLE sessions ADD COLUMN IF NOT EXISTS mode_by_principal jsonb;\n";
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Миграция 014_session_mode_by_principal — режим сессии по принципалу
3
+ * (ADR-106 Ф4, шаг C).
4
+ *
5
+ * `mode_by_principal` — jsonb-карта переопределений режима сессии по id
6
+ * участника (`{ "<userId>": "yolo" }`). Режим — свойство хода: `yolo`,
7
+ * выставленный одним участником, действует только на его ходы и не снимает
8
+ * подтверждения у других участников.
9
+ *
10
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
11
+ */
12
+ export const MIGRATION_014_SESSION_MODE_BY_PRINCIPAL = `
13
+ -- ADR-106 Ф4 (шаг C): режим сессии по принципалу.
14
+ ALTER TABLE sessions ADD COLUMN IF NOT EXISTS mode_by_principal jsonb;
15
+ `;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Миграция 015_authority — порты Authority-слоя (ADR-106 Ф0/Ф1).
3
+ *
4
+ * - `authority_policy` — политика полномочий **инстанса** (ADR-106 Ф0): одна
5
+ * строка (`id = 'instance'`), документ — JSONB (`actions`/`roles`/`targets`/
6
+ * `ceilings`/`agents`). Политика одна на инстанс, поэтому отдельная таблица
7
+ * с единственным ключом: «политика не задана» (`строк нет`) и «политика
8
+ * задана и ничего не разрешает» (пустой документ) — **разные** состояния
9
+ * (fail-closed на оси «user», а не «политика без грантов»).
10
+ * - `authority_decisions` — append-only журнал решений Authority-слоя (ADR-106
11
+ * Ф1): `seq bigserial` — стабильный порядок «свежие первыми» (как у
12
+ * `security_audit`/`plugin_audit`). Секретов и сырых путей в записи нет:
13
+ * нормализация цели — на стороне вызывающего (shadow-слой).
14
+ *
15
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
16
+ */
17
+ export declare const MIGRATION_015_AUTHORITY = "\n-- ADR-106 \u04240: \u043F\u043E\u043B\u0438\u0442\u0438\u043A\u0430 \u043F\u043E\u043B\u043D\u043E\u043C\u043E\u0447\u0438\u0439 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0430 (\u043E\u0434\u043D\u0430 \u0441\u0442\u0440\u043E\u043A\u0430 \u2014 \u043F\u043E\u043B\u0438\u0442\u0438\u043A\u0430 \u0438\u043D\u0441\u0442\u0430\u043D\u0441\u0430).\nCREATE TABLE IF NOT EXISTS authority_policy (\n id text PRIMARY KEY,\n document jsonb NOT NULL,\n updated_at timestamptz NOT NULL DEFAULT now()\n);\n\n-- ADR-106 \u04241: append-only \u0436\u0443\u0440\u043D\u0430\u043B \u0440\u0435\u0448\u0435\u043D\u0438\u0439 Authority-\u0441\u043B\u043E\u044F.\nCREATE TABLE IF NOT EXISTS authority_decisions (\n seq bigserial PRIMARY KEY,\n id text NOT NULL,\n ts timestamptz NOT NULL,\n principal text NOT NULL,\n action text NOT NULL,\n target text NOT NULL,\n effect text NOT NULL,\n source text NOT NULL,\n reason text,\n mode text NOT NULL DEFAULT 'shadow',\n permission_effect text\n);\nCREATE INDEX IF NOT EXISTS authority_decisions_ts_idx ON authority_decisions (ts DESC);\nCREATE INDEX IF NOT EXISTS authority_decisions_action_idx ON authority_decisions (action);\nCREATE INDEX IF NOT EXISTS authority_decisions_effect_idx ON authority_decisions (effect);\nCREATE INDEX IF NOT EXISTS authority_decisions_source_idx ON authority_decisions (source);\n";
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Миграция 015_authority — порты Authority-слоя (ADR-106 Ф0/Ф1).
3
+ *
4
+ * - `authority_policy` — политика полномочий **инстанса** (ADR-106 Ф0): одна
5
+ * строка (`id = 'instance'`), документ — JSONB (`actions`/`roles`/`targets`/
6
+ * `ceilings`/`agents`). Политика одна на инстанс, поэтому отдельная таблица
7
+ * с единственным ключом: «политика не задана» (`строк нет`) и «политика
8
+ * задана и ничего не разрешает» (пустой документ) — **разные** состояния
9
+ * (fail-closed на оси «user», а не «политика без грантов»).
10
+ * - `authority_decisions` — append-only журнал решений Authority-слоя (ADR-106
11
+ * Ф1): `seq bigserial` — стабильный порядок «свежие первыми» (как у
12
+ * `security_audit`/`plugin_audit`). Секретов и сырых путей в записи нет:
13
+ * нормализация цели — на стороне вызывающего (shadow-слой).
14
+ *
15
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
16
+ */
17
+ export const MIGRATION_015_AUTHORITY = `
18
+ -- ADR-106 Ф0: политика полномочий инстанса (одна строка — политика инстанса).
19
+ CREATE TABLE IF NOT EXISTS authority_policy (
20
+ id text PRIMARY KEY,
21
+ document jsonb NOT NULL,
22
+ updated_at timestamptz NOT NULL DEFAULT now()
23
+ );
24
+
25
+ -- ADR-106 Ф1: append-only журнал решений Authority-слоя.
26
+ CREATE TABLE IF NOT EXISTS authority_decisions (
27
+ seq bigserial PRIMARY KEY,
28
+ id text NOT NULL,
29
+ ts timestamptz NOT NULL,
30
+ principal text NOT NULL,
31
+ action text NOT NULL,
32
+ target text NOT NULL,
33
+ effect text NOT NULL,
34
+ source text NOT NULL,
35
+ reason text,
36
+ mode text NOT NULL DEFAULT 'shadow',
37
+ permission_effect text
38
+ );
39
+ CREATE INDEX IF NOT EXISTS authority_decisions_ts_idx ON authority_decisions (ts DESC);
40
+ CREATE INDEX IF NOT EXISTS authority_decisions_action_idx ON authority_decisions (action);
41
+ CREATE INDEX IF NOT EXISTS authority_decisions_effect_idx ON authority_decisions (effect);
42
+ CREATE INDEX IF NOT EXISTS authority_decisions_source_idx ON authority_decisions (source);
43
+ `;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Миграция 016_credential_audit — журнал операций со слоем доступов
3
+ * (ADR-105 Ф4).
4
+ *
5
+ * Отдельная append-only таблица: журнал доступа — **не** security-аудит
6
+ * (семантика «операция с OAuth-кредой» ≠ «изменение политики»), поэтому свой
7
+ * порт, своя таблица и свой набор колонок.
8
+ *
9
+ * Секретов в таблице нет: только id доступа, провайдер, операция, исход, код
10
+ * ошибки и id MCP-коннектора (ADR-105 §7).
11
+ *
12
+ * `seq bigserial` — стабильный порядок «свежие первыми» (как у
13
+ * `maintenance_audit`/`security_audit`/`plugin_audit`).
14
+ *
15
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
16
+ */
17
+ export declare const MIGRATION_016_CREDENTIAL_AUDIT = "\n-- \u0416\u0443\u0440\u043D\u0430\u043B \u043E\u043F\u0435\u0440\u0430\u0446\u0438\u0439 \u0441\u043E \u0441\u043B\u043E\u0435\u043C \u0434\u043E\u0441\u0442\u0443\u043F\u043E\u0432 (ADR-105 \u04244): issue/refresh/revoke/bind/use.\nCREATE TABLE IF NOT EXISTS credential_audit (\n seq bigserial PRIMARY KEY,\n id text NOT NULL,\n ts timestamptz NOT NULL,\n op text NOT NULL,\n credential_id text NOT NULL,\n provider text NOT NULL,\n outcome text NOT NULL,\n error_code text,\n connector_id text\n);\nCREATE INDEX IF NOT EXISTS credential_audit_ts_idx ON credential_audit (ts DESC);\nCREATE INDEX IF NOT EXISTS credential_audit_credential_ts_idx ON credential_audit (credential_id, ts DESC);\n";
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Миграция 016_credential_audit — журнал операций со слоем доступов
3
+ * (ADR-105 Ф4).
4
+ *
5
+ * Отдельная append-only таблица: журнал доступа — **не** security-аудит
6
+ * (семантика «операция с OAuth-кредой» ≠ «изменение политики»), поэтому свой
7
+ * порт, своя таблица и свой набор колонок.
8
+ *
9
+ * Секретов в таблице нет: только id доступа, провайдер, операция, исход, код
10
+ * ошибки и id MCP-коннектора (ADR-105 §7).
11
+ *
12
+ * `seq bigserial` — стабильный порядок «свежие первыми» (как у
13
+ * `maintenance_audit`/`security_audit`/`plugin_audit`).
14
+ *
15
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
16
+ */
17
+ export const MIGRATION_016_CREDENTIAL_AUDIT = `
18
+ -- Журнал операций со слоем доступов (ADR-105 Ф4): issue/refresh/revoke/bind/use.
19
+ CREATE TABLE IF NOT EXISTS credential_audit (
20
+ seq bigserial PRIMARY KEY,
21
+ id text NOT NULL,
22
+ ts timestamptz NOT NULL,
23
+ op text NOT NULL,
24
+ credential_id text NOT NULL,
25
+ provider text NOT NULL,
26
+ outcome text NOT NULL,
27
+ error_code text,
28
+ connector_id text
29
+ );
30
+ CREATE INDEX IF NOT EXISTS credential_audit_ts_idx ON credential_audit (ts DESC);
31
+ CREATE INDEX IF NOT EXISTS credential_audit_credential_ts_idx ON credential_audit (credential_id, ts DESC);
32
+ `;
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Миграция 017_memory — порты памяти: факты, индексы и чанки
3
+ * (PROP-047 §2.1 «предпосылка A», ADR-096 — слой хранения).
4
+ *
5
+ * - `memory_facts` — утверждения с провенансом и жизненным циклом
6
+ * (`candidate`/`active`/`superseded`/`retracted`). Ключ — `id`; провенанс,
7
+ * история ревизий и метаданные — `jsonb` (структура принадлежит порту, схема
8
+ * БД её не дублирует).
9
+ * - `memory_indexes` — заголовки индексов: поколение (`generation`),
10
+ * состояние (`state`), фингерпринт эмбеддинга и статистика корпуса.
11
+ * - `memory_chunks` — чанки корпуса: вектор эмбеддинга хранится **в `jsonb`**,
12
+ * а не в `pgvector`: расширение `vector` в БД не установлено, а
13
+ * `CREATE EXTENSION` требует прав администратора (в драйвере такой DDL не
14
+ * допускается — миграция должна проходить на «голой» БД). ANN-поиск в порт
15
+ * не входит (PROP-047 §3) — retrieval целиком в плагине; при переходе на
16
+ * `pgvector` меняется только представление колонки.
17
+ *
18
+ * Ключи и индексы:
19
+ * - `memory_facts.id` — первичный ключ (id факта уникален в инстансе);
20
+ * - `memory_indexes.id` — первичный ключ;
21
+ * - `memory_chunks` — составной первичный ключ `(index_id, generation, id)`:
22
+ * чанк уникален в пределах поколения индекса, а префикс ключа даёт
23
+ * уникальность в пределах `(index_id, generation)`;
24
+ * - индексы по `namespace`/`project_id`/`user_id`/`status`/`kind` — под фильтры
25
+ * порта (`list`/`count`).
26
+ *
27
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
28
+ */
29
+ export declare const MIGRATION_017_MEMORY = "\n-- PROP-047: \u0444\u0430\u043A\u0442\u044B \u043F\u0430\u043C\u044F\u0442\u0438 (\u0443\u0442\u0432\u0435\u0440\u0436\u0434\u0435\u043D\u0438\u044F \u0441 \u043F\u0440\u043E\u0432\u0435\u043D\u0430\u043D\u0441\u043E\u043C \u0438 \u0436\u0438\u0437\u043D\u0435\u043D\u043D\u044B\u043C \u0446\u0438\u043A\u043B\u043E\u043C).\nCREATE TABLE IF NOT EXISTS memory_facts (\n id text PRIMARY KEY,\n namespace text NOT NULL,\n version integer NOT NULL DEFAULT 1,\n text text NOT NULL,\n kind text NOT NULL,\n project_id text,\n user_id text,\n provenance jsonb NOT NULL,\n confidence double precision NOT NULL DEFAULT 0,\n status text NOT NULL,\n created_at timestamptz NOT NULL,\n updated_at timestamptz NOT NULL,\n valid_until timestamptz,\n superseded_by text,\n revisions jsonb,\n metadata jsonb\n);\nCREATE INDEX IF NOT EXISTS memory_facts_namespace_idx ON memory_facts (namespace);\nCREATE INDEX IF NOT EXISTS memory_facts_project_idx ON memory_facts (project_id);\nCREATE INDEX IF NOT EXISTS memory_facts_user_idx ON memory_facts (user_id);\nCREATE INDEX IF NOT EXISTS memory_facts_status_idx ON memory_facts (status);\nCREATE INDEX IF NOT EXISTS memory_facts_kind_idx ON memory_facts (kind);\nCREATE INDEX IF NOT EXISTS memory_facts_updated_idx ON memory_facts (updated_at DESC, id);\n\n-- PROP-047: \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043A\u0438 \u0438\u043D\u0434\u0435\u043A\u0441\u043E\u0432 \u043F\u0430\u043C\u044F\u0442\u0438 (\u043F\u043E\u043A\u043E\u043B\u0435\u043D\u0438\u0435, \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0435, \u0444\u0438\u043D\u0433\u0435\u0440\u043F\u0440\u0438\u043D\u0442).\nCREATE TABLE IF NOT EXISTS memory_indexes (\n id text PRIMARY KEY,\n namespace text NOT NULL,\n name text NOT NULL,\n provider_id text NOT NULL,\n project_id text,\n source jsonb NOT NULL,\n state text NOT NULL,\n generation integer NOT NULL DEFAULT 0,\n fingerprint jsonb NOT NULL,\n stats jsonb NOT NULL,\n created_at timestamptz NOT NULL,\n updated_at timestamptz NOT NULL,\n error text\n);\nCREATE INDEX IF NOT EXISTS memory_indexes_namespace_idx ON memory_indexes (namespace);\nCREATE INDEX IF NOT EXISTS memory_indexes_project_idx ON memory_indexes (project_id);\nCREATE INDEX IF NOT EXISTS memory_indexes_provider_idx ON memory_indexes (provider_id);\nCREATE INDEX IF NOT EXISTS memory_indexes_state_idx ON memory_indexes (state);\nCREATE INDEX IF NOT EXISTS memory_indexes_updated_idx ON memory_indexes (updated_at DESC, id);\n\n-- PROP-047: \u0447\u0430\u043D\u043A\u0438 \u043A\u043E\u0440\u043F\u0443\u0441\u0430 (\u0432\u0435\u043A\u0442\u043E\u0440 \u2014 jsonb, \u0431\u0435\u0437 pgvector).\nCREATE TABLE IF NOT EXISTS memory_chunks (\n index_id text NOT NULL,\n generation integer NOT NULL,\n id text NOT NULL,\n document_id text NOT NULL,\n ordinal integer NOT NULL,\n text text NOT NULL,\n vector jsonb,\n embedding_input_hash text,\n metadata jsonb,\n PRIMARY KEY (index_id, generation, id)\n);\nCREATE INDEX IF NOT EXISTS memory_chunks_generation_idx\n ON memory_chunks (index_id, generation, document_id, ordinal);\nCREATE INDEX IF NOT EXISTS memory_chunks_document_idx\n ON memory_chunks (index_id, document_id);\n";
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Миграция 017_memory — порты памяти: факты, индексы и чанки
3
+ * (PROP-047 §2.1 «предпосылка A», ADR-096 — слой хранения).
4
+ *
5
+ * - `memory_facts` — утверждения с провенансом и жизненным циклом
6
+ * (`candidate`/`active`/`superseded`/`retracted`). Ключ — `id`; провенанс,
7
+ * история ревизий и метаданные — `jsonb` (структура принадлежит порту, схема
8
+ * БД её не дублирует).
9
+ * - `memory_indexes` — заголовки индексов: поколение (`generation`),
10
+ * состояние (`state`), фингерпринт эмбеддинга и статистика корпуса.
11
+ * - `memory_chunks` — чанки корпуса: вектор эмбеддинга хранится **в `jsonb`**,
12
+ * а не в `pgvector`: расширение `vector` в БД не установлено, а
13
+ * `CREATE EXTENSION` требует прав администратора (в драйвере такой DDL не
14
+ * допускается — миграция должна проходить на «голой» БД). ANN-поиск в порт
15
+ * не входит (PROP-047 §3) — retrieval целиком в плагине; при переходе на
16
+ * `pgvector` меняется только представление колонки.
17
+ *
18
+ * Ключи и индексы:
19
+ * - `memory_facts.id` — первичный ключ (id факта уникален в инстансе);
20
+ * - `memory_indexes.id` — первичный ключ;
21
+ * - `memory_chunks` — составной первичный ключ `(index_id, generation, id)`:
22
+ * чанк уникален в пределах поколения индекса, а префикс ключа даёт
23
+ * уникальность в пределах `(index_id, generation)`;
24
+ * - индексы по `namespace`/`project_id`/`user_id`/`status`/`kind` — под фильтры
25
+ * порта (`list`/`count`).
26
+ *
27
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
28
+ */
29
+ export const MIGRATION_017_MEMORY = `
30
+ -- PROP-047: факты памяти (утверждения с провенансом и жизненным циклом).
31
+ CREATE TABLE IF NOT EXISTS memory_facts (
32
+ id text PRIMARY KEY,
33
+ namespace text NOT NULL,
34
+ version integer NOT NULL DEFAULT 1,
35
+ text text NOT NULL,
36
+ kind text NOT NULL,
37
+ project_id text,
38
+ user_id text,
39
+ provenance jsonb NOT NULL,
40
+ confidence double precision NOT NULL DEFAULT 0,
41
+ status text NOT NULL,
42
+ created_at timestamptz NOT NULL,
43
+ updated_at timestamptz NOT NULL,
44
+ valid_until timestamptz,
45
+ superseded_by text,
46
+ revisions jsonb,
47
+ metadata jsonb
48
+ );
49
+ CREATE INDEX IF NOT EXISTS memory_facts_namespace_idx ON memory_facts (namespace);
50
+ CREATE INDEX IF NOT EXISTS memory_facts_project_idx ON memory_facts (project_id);
51
+ CREATE INDEX IF NOT EXISTS memory_facts_user_idx ON memory_facts (user_id);
52
+ CREATE INDEX IF NOT EXISTS memory_facts_status_idx ON memory_facts (status);
53
+ CREATE INDEX IF NOT EXISTS memory_facts_kind_idx ON memory_facts (kind);
54
+ CREATE INDEX IF NOT EXISTS memory_facts_updated_idx ON memory_facts (updated_at DESC, id);
55
+
56
+ -- PROP-047: заголовки индексов памяти (поколение, состояние, фингерпринт).
57
+ CREATE TABLE IF NOT EXISTS memory_indexes (
58
+ id text PRIMARY KEY,
59
+ namespace text NOT NULL,
60
+ name text NOT NULL,
61
+ provider_id text NOT NULL,
62
+ project_id text,
63
+ source jsonb NOT NULL,
64
+ state text NOT NULL,
65
+ generation integer NOT NULL DEFAULT 0,
66
+ fingerprint jsonb NOT NULL,
67
+ stats jsonb NOT NULL,
68
+ created_at timestamptz NOT NULL,
69
+ updated_at timestamptz NOT NULL,
70
+ error text
71
+ );
72
+ CREATE INDEX IF NOT EXISTS memory_indexes_namespace_idx ON memory_indexes (namespace);
73
+ CREATE INDEX IF NOT EXISTS memory_indexes_project_idx ON memory_indexes (project_id);
74
+ CREATE INDEX IF NOT EXISTS memory_indexes_provider_idx ON memory_indexes (provider_id);
75
+ CREATE INDEX IF NOT EXISTS memory_indexes_state_idx ON memory_indexes (state);
76
+ CREATE INDEX IF NOT EXISTS memory_indexes_updated_idx ON memory_indexes (updated_at DESC, id);
77
+
78
+ -- PROP-047: чанки корпуса (вектор — jsonb, без pgvector).
79
+ CREATE TABLE IF NOT EXISTS memory_chunks (
80
+ index_id text NOT NULL,
81
+ generation integer NOT NULL,
82
+ id text NOT NULL,
83
+ document_id text NOT NULL,
84
+ ordinal integer NOT NULL,
85
+ text text NOT NULL,
86
+ vector jsonb,
87
+ embedding_input_hash text,
88
+ metadata jsonb,
89
+ PRIMARY KEY (index_id, generation, id)
90
+ );
91
+ CREATE INDEX IF NOT EXISTS memory_chunks_generation_idx
92
+ ON memory_chunks (index_id, generation, document_id, ordinal);
93
+ CREATE INDEX IF NOT EXISTS memory_chunks_document_idx
94
+ ON memory_chunks (index_id, document_id);
95
+ `;