@itphx/synth-storage-postgres 0.11.3 → 0.13.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 (147) hide show
  1. package/dist/errors.d.ts +1 -1
  2. package/dist/errors.js +2 -2
  3. package/dist/index.d.ts +15 -1
  4. package/dist/index.js +24 -2
  5. package/dist/locks.d.ts +4 -4
  6. package/dist/locks.js +4 -4
  7. package/dist/migrate.d.ts +1 -1
  8. package/dist/migrate.js +1 -1
  9. package/dist/migrations/001-init.d.ts +2 -2
  10. package/dist/migrations/001-init.js +2 -2
  11. package/dist/migrations/003-analytics-rollups.d.ts +1 -1
  12. package/dist/migrations/003-analytics-rollups.js +1 -1
  13. package/dist/migrations/004-pipeline-engine.d.ts +19 -0
  14. package/dist/migrations/004-pipeline-engine.js +74 -0
  15. package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
  16. package/dist/migrations/005-pipeline-provenance.js +15 -0
  17. package/dist/migrations/006-plugin-audit.d.ts +13 -0
  18. package/dist/migrations/006-plugin-audit.js +34 -0
  19. package/dist/migrations/007-plugin-lock.d.ts +10 -0
  20. package/dist/migrations/007-plugin-lock.js +25 -0
  21. package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
  22. package/dist/migrations/008-plugin-audit-scan.js +15 -0
  23. package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
  24. package/dist/migrations/009-plugin-lock-previous.js +16 -0
  25. package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
  26. package/dist/migrations/010-plugin-lock-mode.js +20 -0
  27. package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
  28. package/dist/migrations/011-session-steer-inbox.js +14 -0
  29. package/dist/migrations/012-external-credentials.d.ts +15 -0
  30. package/dist/migrations/012-external-credentials.js +40 -0
  31. package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
  32. package/dist/migrations/013-service-key-plugin-id.js +20 -0
  33. package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
  34. package/dist/migrations/014-session-mode-by-principal.js +15 -0
  35. package/dist/migrations/015-authority.d.ts +17 -0
  36. package/dist/migrations/015-authority.js +43 -0
  37. package/dist/migrations/016-credential-audit.d.ts +17 -0
  38. package/dist/migrations/016-credential-audit.js +32 -0
  39. package/dist/migrations/017-memory.d.ts +29 -0
  40. package/dist/migrations/017-memory.js +95 -0
  41. package/dist/migrations/018-memory-index-scope.d.ts +14 -0
  42. package/dist/migrations/018-memory-index-scope.js +18 -0
  43. package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
  44. package/dist/migrations/019-memory-index-enabled.js +14 -0
  45. package/dist/migrations/020-project-memory.d.ts +11 -0
  46. package/dist/migrations/020-project-memory.js +13 -0
  47. package/dist/migrations/021-background-runs.d.ts +17 -0
  48. package/dist/migrations/021-background-runs.js +67 -0
  49. package/dist/migrations/022-background-run-process-id.d.ts +14 -0
  50. package/dist/migrations/022-background-run-process-id.js +18 -0
  51. package/dist/migrations/023-session-worktree.d.ts +12 -0
  52. package/dist/migrations/023-session-worktree.js +16 -0
  53. package/dist/migrations/024-blob-refs.d.ts +15 -0
  54. package/dist/migrations/024-blob-refs.js +26 -0
  55. package/dist/migrations/025-packs-pipelines.d.ts +28 -0
  56. package/dist/migrations/025-packs-pipelines.js +82 -0
  57. package/dist/migrations/026-instance-skills.d.ts +17 -0
  58. package/dist/migrations/026-instance-skills.js +25 -0
  59. package/dist/migrations/027-context-files.d.ts +20 -0
  60. package/dist/migrations/027-context-files.js +30 -0
  61. package/dist/migrations/028-message-reasoning-signature.d.ts +13 -0
  62. package/dist/migrations/028-message-reasoning-signature.js +19 -0
  63. package/dist/migrations/029-message-stream-v2.d.ts +22 -0
  64. package/dist/migrations/029-message-stream-v2.js +33 -0
  65. package/dist/migrations/030-session-retry.d.ts +12 -0
  66. package/dist/migrations/030-session-retry.js +16 -0
  67. package/dist/migrations/index.d.ts +1 -1
  68. package/dist/migrations/index.js +55 -1
  69. package/dist/pool.d.ts +6 -6
  70. package/dist/pool.js +8 -8
  71. package/dist/ports/analytics.d.ts +1 -1
  72. package/dist/ports/analytics.js +1 -1
  73. package/dist/ports/audit.d.ts +1 -1
  74. package/dist/ports/audit.js +3 -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 +1 -1
  82. package/dist/ports/content.js +21 -7
  83. package/dist/ports/context-files.d.ts +147 -0
  84. package/dist/ports/context-files.js +285 -0
  85. package/dist/ports/core-sync.d.ts +1 -1
  86. package/dist/ports/core-sync.js +1 -1
  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 +2 -2
  90. package/dist/ports/deps.js +1 -1
  91. package/dist/ports/events-bindings.d.ts +2 -2
  92. package/dist/ports/events-bindings.js +2 -2
  93. package/dist/ports/events-core.d.ts +1 -1
  94. package/dist/ports/events-core.js +1 -1
  95. package/dist/ports/events-journal.d.ts +1 -1
  96. package/dist/ports/events-journal.js +1 -1
  97. package/dist/ports/events-scheduler.d.ts +1 -1
  98. package/dist/ports/events-scheduler.js +20 -12
  99. package/dist/ports/events-webhooks.d.ts +1 -1
  100. package/dist/ports/events-webhooks.js +1 -1
  101. package/dist/ports/events.d.ts +1 -1
  102. package/dist/ports/events.js +1 -1
  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 +1 -1
  118. package/dist/ports/principals-defaults.js +21 -1
  119. package/dist/ports/principals-documents.d.ts +1 -1
  120. package/dist/ports/principals-documents.js +1 -1
  121. package/dist/ports/principals-profiles.d.ts +1 -1
  122. package/dist/ports/principals-profiles.js +1 -1
  123. package/dist/ports/principals-projects.d.ts +1 -1
  124. package/dist/ports/principals-projects.js +82 -47
  125. package/dist/ports/principals-settings.d.ts +1 -1
  126. package/dist/ports/principals-settings.js +57 -1
  127. package/dist/ports/principals-shared.d.ts +1 -1
  128. package/dist/ports/principals-shared.js +1 -1
  129. package/dist/ports/principals.d.ts +1 -1
  130. package/dist/ports/principals.js +1 -1
  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 +80 -6
  134. package/dist/ports/sessions-mapping.js +165 -8
  135. package/dist/ports/sessions.d.ts +62 -8
  136. package/dist/ports/sessions.js +96 -20
  137. package/dist/ports/skills.d.ts +59 -0
  138. package/dist/ports/skills.js +205 -0
  139. package/dist/ports/stub.d.ts +1 -1
  140. package/dist/ports/stub.js +2 -2
  141. package/dist/ports/worktrees.d.ts +41 -0
  142. package/dist/ports/worktrees.js +85 -0
  143. package/dist/postgres-storage.d.ts +4 -5
  144. package/dist/postgres-storage.js +5 -6
  145. package/dist/storage-context.d.ts +44 -15
  146. package/dist/storage-context.js +139 -31
  147. 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
+ `;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Миграция 028_message_reasoning_signature — подпись thinking-блока Anthropic
3
+ * в истории сообщений.
4
+ *
5
+ * `reasoning_signature text` — подпись блока `thinking` (`signature`), пустая
6
+ * строка валидна; `reasoning_redacted jsonb` — массив opaque-данных блоков
7
+ * `redacted_thinking` (реплеятся в историю verbatim). Без этих полей
8
+ * tool-loop при включённом thinking отвергается API («thinking не возвращён в
9
+ * историю»): PG-порт их не писал и не читал, и подпись терялась после рестарта.
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export declare const MIGRATION_028_MESSAGE_REASONING_SIGNATURE = "\n-- Anthropic: \u043F\u043E\u0434\u043F\u0438\u0441\u044C thinking-\u0431\u043B\u043E\u043A\u0430 \u0438 opaque-\u0434\u0430\u043D\u043D\u044B\u0435 redacted-\u0431\u043B\u043E\u043A\u043E\u0432 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F.\nALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_signature text;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_redacted jsonb;\nCOMMENT ON COLUMN messages.reasoning_signature IS 'Anthropic: \u043F\u043E\u0434\u043F\u0438\u0441\u044C thinking-\u0431\u043B\u043E\u043A\u0430 (\u043F\u0443\u0441\u0442\u0430\u044F \u0441\u0442\u0440\u043E\u043A\u0430 \u0432\u0430\u043B\u0438\u0434\u043D\u0430)';\nCOMMENT ON COLUMN messages.reasoning_redacted IS 'Anthropic: opaque-\u0434\u0430\u043D\u043D\u044B\u0435 \u0431\u043B\u043E\u043A\u043E\u0432 redacted_thinking (verbatim data)';\n";
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Миграция 028_message_reasoning_signature — подпись thinking-блока Anthropic
3
+ * в истории сообщений.
4
+ *
5
+ * `reasoning_signature text` — подпись блока `thinking` (`signature`), пустая
6
+ * строка валидна; `reasoning_redacted jsonb` — массив opaque-данных блоков
7
+ * `redacted_thinking` (реплеятся в историю verbatim). Без этих полей
8
+ * tool-loop при включённом thinking отвергается API («thinking не возвращён в
9
+ * историю»): PG-порт их не писал и не читал, и подпись терялась после рестарта.
10
+ *
11
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
12
+ */
13
+ export const MIGRATION_028_MESSAGE_REASONING_SIGNATURE = `
14
+ -- Anthropic: подпись thinking-блока и opaque-данные redacted-блоков сообщения.
15
+ ALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_signature text;
16
+ ALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_redacted jsonb;
17
+ COMMENT ON COLUMN messages.reasoning_signature IS 'Anthropic: подпись thinking-блока (пустая строка валидна)';
18
+ COMMENT ON COLUMN messages.reasoning_redacted IS 'Anthropic: opaque-данные блоков redacted_thinking (verbatim data)';
19
+ `;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Миграция 029_message_stream_v2 — модель «ход как последовательность шагов»
3
+ * (ADR-118).
4
+ *
5
+ * В таблице `messages` появляются четыре аддитивные колонки:
6
+ * - `ord integer` — **монотонный** счётчик порядка записи в историю
7
+ * сессии (выдаётся при материализации, никогда не перенумеровывается);
8
+ * - `turn_id text` — идентификатор хода (`Turn`);
9
+ * - `step_index integer` — индекс шага внутри хода (0-based; шаг = один
10
+ * вызов LLM = одно assistant-сообщение);
11
+ * - `status text` — статус сообщения-хода
12
+ * (`streaming`/`completed`/`cancelled`/`error`).
13
+ *
14
+ * `seq` **не трогается**: он остаётся позиционным, а `UNIQUE (session_id, seq)`
15
+ * сохраняется (ADR-118 §2 «Альтернативы (а)»).
16
+ *
17
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
18
+ * Данные (проставка `ord`/`turn_id`/`step_index` старым сообщениям) миграцией
19
+ * **не** делается: она построчная и живёт в ядре
20
+ * (`packages/core/src/storage/migrations.ts`, ADR-118 §9).
21
+ */
22
+ export declare const MIGRATION_029_MESSAGE_STREAM_V2 = "\n-- ADR-118: \u043F\u043E\u0440\u044F\u0434\u043E\u043A \u0437\u0430\u043F\u0438\u0441\u0438 (ord), \u0445\u043E\u0434 (turn_id), \u0448\u0430\u0433 (step_index), \u0441\u0442\u0430\u0442\u0443\u0441.\nALTER TABLE messages ADD COLUMN IF NOT EXISTS ord integer;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS turn_id text;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS step_index integer;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS status text;\nCREATE INDEX IF NOT EXISTS messages_session_ord_idx ON messages (session_id, ord);\nCOMMENT ON COLUMN messages.ord IS 'ADR-118: \u043C\u043E\u043D\u043E\u0442\u043E\u043D\u043D\u044B\u0439 \u0441\u0447\u0451\u0442\u0447\u0438\u043A \u043F\u043E\u0440\u044F\u0434\u043A\u0430 \u0437\u0430\u043F\u0438\u0441\u0438 \u0432 \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u0441\u0435\u0441\u0441\u0438\u0438 (\u043D\u0435 \u043F\u0435\u0440\u0435\u043D\u0443\u043C\u0435\u0440\u043E\u0432\u044B\u0432\u0430\u0435\u0442\u0441\u044F)';\nCOMMENT ON COLUMN messages.turn_id IS 'ADR-118: \u0438\u0434\u0435\u043D\u0442\u0438\u0444\u0438\u043A\u0430\u0442\u043E\u0440 \u0445\u043E\u0434\u0430 (Turn)';\nCOMMENT ON COLUMN messages.step_index IS 'ADR-118: \u0438\u043D\u0434\u0435\u043A\u0441 \u0448\u0430\u0433\u0430 \u0432\u043D\u0443\u0442\u0440\u0438 \u0445\u043E\u0434\u0430 (0-based)';\nCOMMENT ON COLUMN messages.status IS 'ADR-118: \u0441\u0442\u0430\u0442\u0443\u0441 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F (streaming/completed/cancelled/error)';\n";
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Миграция 029_message_stream_v2 — модель «ход как последовательность шагов»
3
+ * (ADR-118).
4
+ *
5
+ * В таблице `messages` появляются четыре аддитивные колонки:
6
+ * - `ord integer` — **монотонный** счётчик порядка записи в историю
7
+ * сессии (выдаётся при материализации, никогда не перенумеровывается);
8
+ * - `turn_id text` — идентификатор хода (`Turn`);
9
+ * - `step_index integer` — индекс шага внутри хода (0-based; шаг = один
10
+ * вызов LLM = одно assistant-сообщение);
11
+ * - `status text` — статус сообщения-хода
12
+ * (`streaming`/`completed`/`cancelled`/`error`).
13
+ *
14
+ * `seq` **не трогается**: он остаётся позиционным, а `UNIQUE (session_id, seq)`
15
+ * сохраняется (ADR-118 §2 «Альтернативы (а)»).
16
+ *
17
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
18
+ * Данные (проставка `ord`/`turn_id`/`step_index` старым сообщениям) миграцией
19
+ * **не** делается: она построчная и живёт в ядре
20
+ * (`packages/core/src/storage/migrations.ts`, ADR-118 §9).
21
+ */
22
+ export const MIGRATION_029_MESSAGE_STREAM_V2 = `
23
+ -- ADR-118: порядок записи (ord), ход (turn_id), шаг (step_index), статус.
24
+ ALTER TABLE messages ADD COLUMN IF NOT EXISTS ord integer;
25
+ ALTER TABLE messages ADD COLUMN IF NOT EXISTS turn_id text;
26
+ ALTER TABLE messages ADD COLUMN IF NOT EXISTS step_index integer;
27
+ ALTER TABLE messages ADD COLUMN IF NOT EXISTS status text;
28
+ CREATE INDEX IF NOT EXISTS messages_session_ord_idx ON messages (session_id, ord);
29
+ COMMENT ON COLUMN messages.ord IS 'ADR-118: монотонный счётчик порядка записи в историю сессии (не перенумеровывается)';
30
+ COMMENT ON COLUMN messages.turn_id IS 'ADR-118: идентификатор хода (Turn)';
31
+ COMMENT ON COLUMN messages.step_index IS 'ADR-118: индекс шага внутри хода (0-based)';
32
+ COMMENT ON COLUMN messages.status IS 'ADR-118: статус сообщения (streaming/completed/cancelled/error)';
33
+ `;
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Миграция 030_session_retry — персистентное состояние ретрая сессии.
3
+ *
4
+ * `retry jsonb` — снимок состояния повторной попытки LLM-вызова
5
+ * (`stream_id`/`attempt`/`max_retries`/`retry_at`/`error`). Поле появилось в
6
+ * контракте `Session.retry` после миграции `029`, поэтому колонки в таблице
7
+ * `sessions` не было — PG-порт её не писал и не читал, и после reload/restart
8
+ * клиент не видел, что ход повторяется (в отличие от файлового backend).
9
+ *
10
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
11
+ */
12
+ export declare const MIGRATION_030_SESSION_RETRY = "\n-- \u0421\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0435 \u0440\u0435\u0442\u0440\u0430\u044F \u0441\u0435\u0441\u0441\u0438\u0438 (\u043F\u0435\u0440\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0435): stream_id/attempt/max_retries/retry_at/error.\nALTER TABLE sessions ADD COLUMN IF NOT EXISTS retry jsonb;\nCOMMENT ON COLUMN sessions.retry IS '\u041F\u0435\u0440\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0435 \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0435 \u0440\u0435\u0442\u0440\u0430\u044F \u0441\u0435\u0441\u0441\u0438\u0438: stream_id/attempt/max_retries/retry_at/error';\n";
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Миграция 030_session_retry — персистентное состояние ретрая сессии.
3
+ *
4
+ * `retry jsonb` — снимок состояния повторной попытки LLM-вызова
5
+ * (`stream_id`/`attempt`/`max_retries`/`retry_at`/`error`). Поле появилось в
6
+ * контракте `Session.retry` после миграции `029`, поэтому колонки в таблице
7
+ * `sessions` не было — PG-порт её не писал и не читал, и после reload/restart
8
+ * клиент не видел, что ход повторяется (в отличие от файлового backend).
9
+ *
10
+ * Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
11
+ */
12
+ export const MIGRATION_030_SESSION_RETRY = `
13
+ -- Состояние ретрая сессии (персистентное): stream_id/attempt/max_retries/retry_at/error.
14
+ ALTER TABLE sessions ADD COLUMN IF NOT EXISTS retry jsonb;
15
+ COMMENT ON COLUMN sessions.retry IS 'Персистентное состояние ретрая сессии: stream_id/attempt/max_retries/retry_at/error';
16
+ `;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Реестр SQL-миграций схемы PostgreSQL-драйвера (PROP-032, волна 3a).
2
+ * Реестр SQL-миграций схемы PostgreSQL-драйвера (ADR-097, волна 3a).
3
3
  *
4
4
  * Отдельный механизм от `meta.json`/file-миграций (ADR-092): версия схемы БД
5
5
  * живёт в таблице `synth_schema_migrations` (см. `migrate.ts`). Миграции
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Реестр SQL-миграций схемы PostgreSQL-драйвера (PROP-032, волна 3a).
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,65 @@
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';
38
+ import { MIGRATION_028_MESSAGE_REASONING_SIGNATURE } from './028-message-reasoning-signature.js';
39
+ import { MIGRATION_029_MESSAGE_STREAM_V2 } from './029-message-stream-v2.js';
40
+ import { MIGRATION_030_SESSION_RETRY } from './030-session-retry.js';
14
41
  /** Полный набор миграций драйвера (по возрастанию версии). */
15
42
  export const MIGRATIONS = [
16
43
  { version: 1, id: '001_init', sql: MIGRATION_001_INIT },
17
44
  { version: 2, id: '002_egress_audit', sql: MIGRATION_002_EGRESS_AUDIT },
18
45
  { version: 3, id: '003_analytics_rollups', sql: MIGRATION_003_ANALYTICS_ROLLUPS },
46
+ { version: 4, id: '004_pipeline_engine', sql: MIGRATION_004_PIPELINE_ENGINE },
47
+ { version: 5, id: '005_pipeline_provenance', sql: MIGRATION_005_PIPELINE_PROVENANCE },
48
+ { version: 6, id: '006_plugin_audit', sql: MIGRATION_006_PLUGIN_AUDIT },
49
+ { version: 7, id: '007_plugin_lock', sql: MIGRATION_007_PLUGIN_LOCK },
50
+ { version: 8, id: '008_plugin_audit_scan', sql: MIGRATION_008_PLUGIN_AUDIT_SCAN },
51
+ { version: 9, id: '009_plugin_lock_previous', sql: MIGRATION_009_PLUGIN_LOCK_PREVIOUS },
52
+ { version: 10, id: '010_plugin_lock_mode', sql: MIGRATION_010_PLUGIN_LOCK_MODE },
53
+ { version: 11, id: '011_session_steer_inbox', sql: MIGRATION_011_SESSION_STEER_INBOX },
54
+ { version: 12, id: '012_external_credentials', sql: MIGRATION_012_EXTERNAL_CREDENTIALS },
55
+ { version: 13, id: '013_service_key_plugin_id', sql: MIGRATION_013_SERVICE_KEY_PLUGIN_ID },
56
+ { version: 14, id: '014_session_mode_by_principal', sql: MIGRATION_014_SESSION_MODE_BY_PRINCIPAL },
57
+ { version: 15, id: '015_authority', sql: MIGRATION_015_AUTHORITY },
58
+ { version: 16, id: '016_credential_audit', sql: MIGRATION_016_CREDENTIAL_AUDIT },
59
+ { version: 17, id: '017_memory', sql: MIGRATION_017_MEMORY },
60
+ { version: 18, id: '018_memory_index_scope', sql: MIGRATION_018_MEMORY_INDEX_SCOPE },
61
+ { version: 19, id: '019_memory_index_enabled', sql: MIGRATION_019_MEMORY_INDEX_ENABLED },
62
+ { version: 20, id: '020_project_memory', sql: MIGRATION_020_PROJECT_MEMORY },
63
+ { version: 21, id: '021_background_runs', sql: MIGRATION_021_BACKGROUND_RUNS },
64
+ { version: 22, id: '022_background_run_process_id', sql: MIGRATION_022_BACKGROUND_RUN_PROCESS_ID },
65
+ { version: 23, id: '023_session_worktree', sql: MIGRATION_023_SESSION_WORKTREE },
66
+ { version: 24, id: '024_blob_refs', sql: MIGRATION_024_BLOB_REFS },
67
+ { version: 25, id: '025_packs_pipelines', sql: MIGRATION_025_PACKS_PIPELINES },
68
+ { version: 26, id: '026_instance_skills', sql: MIGRATION_026_INSTANCE_SKILLS },
69
+ { version: 27, id: '027_context_files', sql: MIGRATION_027_CONTEXT_FILES },
70
+ { version: 28, id: '028_message_reasoning_signature', sql: MIGRATION_028_MESSAGE_REASONING_SIGNATURE },
71
+ { version: 29, id: '029_message_stream_v2', sql: MIGRATION_029_MESSAGE_STREAM_V2 },
72
+ { version: 30, id: '030_session_retry', sql: MIGRATION_030_SESSION_RETRY },
19
73
  ];
20
74
  /** Последняя (ожидаемая) версия схемы. */
21
75
  export function latestSchemaVersion(migrations = MIGRATIONS) {
package/dist/pool.d.ts CHANGED
@@ -1,10 +1,10 @@
1
1
  /**
2
- * Пул соединений и низкоуровневые хелперы PostgreSQL-драйвера (PROP-032, волна 3a).
2
+ * Пул соединений и низкоуровневые хелперы PostgreSQL-драйвера (ADR-097, волна 3a).
3
3
  *
4
4
  * Модуль **не требует** установленного `pg` на импорте: `pg` подключается лениво,
5
5
  * внутри `createPostgresConnection`/при первом обращении к пулу (типы `pg` приходят
6
6
  * из `@types/pg` и стираются на этапе компиляции). Это требование формы поставки
7
- * (`pg` — `optionalDependencies`, ADR-097/PROP-032).
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/PROP-032: TLS-режим (`disable`/`require`/`verify-full`; `verify-ca` —
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
- * PROP-032: выделенное соединение, удерживаемое вызывающим (напр. для
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/PROP-032: fail-closed проверка DSN на TLS-параметры. DSN из
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
- * разрыве/закрытии (PROP-032).
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-драйвера (PROP-032, волна 3a).
2
+ * Пул соединений и низкоуровневые хелперы PostgreSQL-драйвера (ADR-097, волна 3a).
3
3
  *
4
4
  * Модуль **не требует** установленного `pg` на импорте: `pg` подключается лениво,
5
5
  * внутри `createPostgresConnection`/при первом обращении к пулу (типы `pg` приходят
6
6
  * из `@types/pg` и стираются на этапе компиляции). Это требование формы поставки
7
- * (`pg` — `optionalDependencies`, ADR-097/PROP-032).
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/PROP-032: TLS-параметры в DSN запрещены — `pg` накладывает DSN поверх
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
- // PROP-032: незанятые соединения не удерживают event loop — CLI-команды
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/PROP-032: единый источник TLS — `sslmode` (`storage.postgres.sslmode`)
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/PROP-032: fail-closed проверка DSN на TLS-параметры. DSN из
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
- // PROP-032 (W5): после `end()` пул не пересоздаётся — иначе запрос после
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
- * разрыве/закрытии (PROP-032).
284
+ * разрыве/закрытии (ADR-097).
285
285
  */
286
286
  async acquireHeldClient() {
287
287
  const client = await this._acquire();
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Порт роллапов аналитики PostgreSQL-драйвера (PROP-102).
2
+ * Порт роллапов аналитики PostgreSQL-драйвера (ADR-102).
3
3
  *
4
4
  * Таблица `analytics_rollups` (миграция 003): ключ бакета — составной первичный
5
5
  * ключ `(family, day, dimensions)` (`jsonb` нормализует порядок ключей объекта,
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Порт роллапов аналитики PostgreSQL-драйвера (PROP-102).
2
+ * Порт роллапов аналитики PostgreSQL-драйвера (ADR-102).
3
3
  *
4
4
  * Таблица `analytics_rollups` (миграция 003): ключ бакета — составной первичный
5
5
  * ключ `(family, day, dimensions)` (`jsonb` нормализует порядок ключей объекта,