@itphx/synth-storage-postgres 0.11.3 → 0.12.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (141) hide show
  1. package/dist/errors.d.ts +1 -1
  2. package/dist/errors.js +2 -2
  3. package/dist/index.d.ts +15 -1
  4. package/dist/index.js +24 -2
  5. package/dist/locks.d.ts +4 -4
  6. package/dist/locks.js +4 -4
  7. package/dist/migrate.d.ts +1 -1
  8. package/dist/migrate.js +1 -1
  9. package/dist/migrations/001-init.d.ts +2 -2
  10. package/dist/migrations/001-init.js +2 -2
  11. package/dist/migrations/003-analytics-rollups.d.ts +1 -1
  12. package/dist/migrations/003-analytics-rollups.js +1 -1
  13. package/dist/migrations/004-pipeline-engine.d.ts +19 -0
  14. package/dist/migrations/004-pipeline-engine.js +74 -0
  15. package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
  16. package/dist/migrations/005-pipeline-provenance.js +15 -0
  17. package/dist/migrations/006-plugin-audit.d.ts +13 -0
  18. package/dist/migrations/006-plugin-audit.js +34 -0
  19. package/dist/migrations/007-plugin-lock.d.ts +10 -0
  20. package/dist/migrations/007-plugin-lock.js +25 -0
  21. package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
  22. package/dist/migrations/008-plugin-audit-scan.js +15 -0
  23. package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
  24. package/dist/migrations/009-plugin-lock-previous.js +16 -0
  25. package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
  26. package/dist/migrations/010-plugin-lock-mode.js +20 -0
  27. package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
  28. package/dist/migrations/011-session-steer-inbox.js +14 -0
  29. package/dist/migrations/012-external-credentials.d.ts +15 -0
  30. package/dist/migrations/012-external-credentials.js +40 -0
  31. package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
  32. package/dist/migrations/013-service-key-plugin-id.js +20 -0
  33. package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
  34. package/dist/migrations/014-session-mode-by-principal.js +15 -0
  35. package/dist/migrations/015-authority.d.ts +17 -0
  36. package/dist/migrations/015-authority.js +43 -0
  37. package/dist/migrations/016-credential-audit.d.ts +17 -0
  38. package/dist/migrations/016-credential-audit.js +32 -0
  39. package/dist/migrations/017-memory.d.ts +29 -0
  40. package/dist/migrations/017-memory.js +95 -0
  41. package/dist/migrations/018-memory-index-scope.d.ts +14 -0
  42. package/dist/migrations/018-memory-index-scope.js +18 -0
  43. package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
  44. package/dist/migrations/019-memory-index-enabled.js +14 -0
  45. package/dist/migrations/020-project-memory.d.ts +11 -0
  46. package/dist/migrations/020-project-memory.js +13 -0
  47. package/dist/migrations/021-background-runs.d.ts +17 -0
  48. package/dist/migrations/021-background-runs.js +67 -0
  49. package/dist/migrations/022-background-run-process-id.d.ts +14 -0
  50. package/dist/migrations/022-background-run-process-id.js +18 -0
  51. package/dist/migrations/023-session-worktree.d.ts +12 -0
  52. package/dist/migrations/023-session-worktree.js +16 -0
  53. package/dist/migrations/024-blob-refs.d.ts +15 -0
  54. package/dist/migrations/024-blob-refs.js +26 -0
  55. package/dist/migrations/025-packs-pipelines.d.ts +28 -0
  56. package/dist/migrations/025-packs-pipelines.js +82 -0
  57. package/dist/migrations/026-instance-skills.d.ts +17 -0
  58. package/dist/migrations/026-instance-skills.js +25 -0
  59. package/dist/migrations/027-context-files.d.ts +20 -0
  60. package/dist/migrations/027-context-files.js +30 -0
  61. package/dist/migrations/index.d.ts +1 -1
  62. package/dist/migrations/index.js +49 -1
  63. package/dist/pool.d.ts +6 -6
  64. package/dist/pool.js +8 -8
  65. package/dist/ports/analytics.d.ts +1 -1
  66. package/dist/ports/analytics.js +1 -1
  67. package/dist/ports/audit.d.ts +1 -1
  68. package/dist/ports/audit.js +3 -0
  69. package/dist/ports/authority.d.ts +27 -0
  70. package/dist/ports/authority.js +148 -0
  71. package/dist/ports/background-runs.d.ts +41 -0
  72. package/dist/ports/background-runs.js +179 -0
  73. package/dist/ports/blob-refs.d.ts +36 -0
  74. package/dist/ports/blob-refs.js +55 -0
  75. package/dist/ports/content.d.ts +1 -1
  76. package/dist/ports/content.js +21 -7
  77. package/dist/ports/context-files.d.ts +145 -0
  78. package/dist/ports/context-files.js +279 -0
  79. package/dist/ports/core-sync.d.ts +1 -1
  80. package/dist/ports/core-sync.js +1 -1
  81. package/dist/ports/credential-audit.d.ts +19 -0
  82. package/dist/ports/credential-audit.js +96 -0
  83. package/dist/ports/deps.d.ts +2 -2
  84. package/dist/ports/deps.js +1 -1
  85. package/dist/ports/events-bindings.d.ts +2 -2
  86. package/dist/ports/events-bindings.js +2 -2
  87. package/dist/ports/events-core.d.ts +1 -1
  88. package/dist/ports/events-core.js +1 -1
  89. package/dist/ports/events-journal.d.ts +1 -1
  90. package/dist/ports/events-journal.js +1 -1
  91. package/dist/ports/events-scheduler.d.ts +1 -1
  92. package/dist/ports/events-scheduler.js +1 -1
  93. package/dist/ports/events-webhooks.d.ts +1 -1
  94. package/dist/ports/events-webhooks.js +1 -1
  95. package/dist/ports/events.d.ts +1 -1
  96. package/dist/ports/events.js +1 -1
  97. package/dist/ports/external-credentials.d.ts +6 -0
  98. package/dist/ports/external-credentials.js +363 -0
  99. package/dist/ports/legacy-pipelines.d.ts +50 -0
  100. package/dist/ports/legacy-pipelines.js +202 -0
  101. package/dist/ports/memory.d.ts +65 -0
  102. package/dist/ports/memory.js +471 -0
  103. package/dist/ports/packs.d.ts +32 -0
  104. package/dist/ports/packs.js +117 -0
  105. package/dist/ports/pipelines.d.ts +67 -0
  106. package/dist/ports/pipelines.js +297 -0
  107. package/dist/ports/plugin-audit.d.ts +14 -0
  108. package/dist/ports/plugin-audit.js +110 -0
  109. package/dist/ports/plugin-lock.d.ts +27 -0
  110. package/dist/ports/plugin-lock.js +145 -0
  111. package/dist/ports/principals-defaults.d.ts +1 -1
  112. package/dist/ports/principals-defaults.js +1 -1
  113. package/dist/ports/principals-documents.d.ts +1 -1
  114. package/dist/ports/principals-documents.js +1 -1
  115. package/dist/ports/principals-profiles.d.ts +1 -1
  116. package/dist/ports/principals-profiles.js +1 -1
  117. package/dist/ports/principals-projects.d.ts +1 -1
  118. package/dist/ports/principals-projects.js +6 -3
  119. package/dist/ports/principals-settings.d.ts +1 -1
  120. package/dist/ports/principals-settings.js +21 -1
  121. package/dist/ports/principals-shared.d.ts +1 -1
  122. package/dist/ports/principals-shared.js +1 -1
  123. package/dist/ports/principals.d.ts +1 -1
  124. package/dist/ports/principals.js +1 -1
  125. package/dist/ports/questions.d.ts +40 -0
  126. package/dist/ports/questions.js +135 -0
  127. package/dist/ports/sessions-mapping.d.ts +20 -3
  128. package/dist/ports/sessions-mapping.js +46 -2
  129. package/dist/ports/sessions.d.ts +13 -3
  130. package/dist/ports/sessions.js +20 -5
  131. package/dist/ports/skills.d.ts +59 -0
  132. package/dist/ports/skills.js +205 -0
  133. package/dist/ports/stub.d.ts +1 -1
  134. package/dist/ports/stub.js +2 -2
  135. package/dist/ports/worktrees.d.ts +41 -0
  136. package/dist/ports/worktrees.js +85 -0
  137. package/dist/postgres-storage.d.ts +4 -5
  138. package/dist/postgres-storage.js +5 -6
  139. package/dist/storage-context.d.ts +44 -15
  140. package/dist/storage-context.js +139 -31
  141. package/package.json +4 -4
@@ -0,0 +1,148 @@
1
+ /**
2
+ * Порты Authority-слоя PostgreSQL-драйвера (ADR-106 Ф0/Ф1, ADR-097).
3
+ *
4
+ * - `authority_policy` — политика полномочий **инстанса** (таблица из
5
+ * миграции 014): одна строка (`id = 'instance'`), документ — JSONB. «Политика
6
+ * не задана» (строк нет) и «политика задана и ничего не разрешает» (пустой
7
+ * документ) — **разные** состояния: первое означает «ось инстанса не
8
+ * применима», второе — «ось сужает до нуля». Чтение невалидного документа
9
+ * считается **отсутствием политики** (fail-closed на оси «user», а не
10
+ * «политика без грантов») — паритет с файловой реализацией core
11
+ * (`FileAuthorityPolicyStore`).
12
+ * - `authority_decisions` — append-only журнал решений (таблица из миграции
13
+ * 014; `seq bigserial` — порядок «свежие первыми», как у `security_audit`/
14
+ * `plugin_audit`).
15
+ *
16
+ * Политика и журнал — **отдельные** сущности: журнал фиксирует решения о
17
+ * правах, политика — потолок инстанса (ADR-106 §«Инварианты модели», п. 8).
18
+ *
19
+ * Драйвер не дублирует доменную валидацию: схема `authorityPolicySchema`
20
+ * берётся из `@itphx/synth-shared` (обычная зависимость пакета).
21
+ */
22
+ import { authorityPolicySchema, nowISO } from '@itphx/synth-shared';
23
+ import { jsonbLiteral } from '../json-param.js';
24
+ /** Ключ единственной строки политики инстанца. */
25
+ const AUTHORITY_POLICY_ROW_ID = 'instance';
26
+ /** ISO-строка из `timestamptz` (pg отдаёт `Date`) либо строки. */
27
+ function toISO(value) {
28
+ if (value instanceof Date)
29
+ return value.toISOString();
30
+ return String(value);
31
+ }
32
+ /** Порт политики полномочий инстанса поверх таблицы `authority_policy`. */
33
+ class PostgresAuthorityPolicyRepository {
34
+ _deps;
35
+ constructor(_deps) {
36
+ this._deps = _deps;
37
+ }
38
+ _db() {
39
+ return this._deps.connection;
40
+ }
41
+ /** Политика инстанца; `null` — документа нет или он невалиден. */
42
+ async getPolicy() {
43
+ const rows = await this._db().query('SELECT * FROM authority_policy WHERE id = $1', [AUTHORITY_POLICY_ROW_ID]);
44
+ const row = rows[0];
45
+ if (!row)
46
+ return null;
47
+ const parsed = authorityPolicySchema.safeParse(row.document);
48
+ if (!parsed.success) {
49
+ // Документ невалиден — политика считается незаданной (fail-closed на
50
+ // оси «user», а не «политика без грантов»).
51
+ console.warn(`[PostgresAuthorityPolicyRepository] документ политики Authority невалиден — считается отсутствующим: ${parsed.error.issues
52
+ .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
53
+ .join('; ')}`);
54
+ return null;
55
+ }
56
+ return parsed.data;
57
+ }
58
+ /** Полная замена политики (атомарная upsert по ключу `instance`). */
59
+ async savePolicy(policy) {
60
+ const validated = authorityPolicySchema.parse(policy);
61
+ await this._db().query(`INSERT INTO authority_policy (id, document, updated_at)
62
+ VALUES ($1,$2::jsonb,$3)
63
+ ON CONFLICT (id) DO UPDATE
64
+ SET document = EXCLUDED.document, updated_at = EXCLUDED.updated_at`, [AUTHORITY_POLICY_ROW_ID, jsonbLiteral(validated), nowISO()]);
65
+ }
66
+ }
67
+ function rowToDecision(row) {
68
+ const entry = {
69
+ id: row.id,
70
+ ts: toISO(row.ts),
71
+ principal: row.principal,
72
+ action: row.action,
73
+ target: row.target,
74
+ effect: row.effect,
75
+ source: row.source,
76
+ reason: row.reason,
77
+ mode: (row.mode ?? 'shadow'),
78
+ };
79
+ // `permissionEffect` — только в shadow-режиме (в enforced — отсутствует).
80
+ if (row.permission_effect !== null && row.permission_effect !== undefined) {
81
+ entry.permissionEffect = row.permission_effect;
82
+ }
83
+ return entry;
84
+ }
85
+ /** Порт append-only журнала решений Authority-слоя поверх `authority_decisions`. */
86
+ class PostgresAuthorityDecisionJournal {
87
+ _deps;
88
+ constructor(_deps) {
89
+ this._deps = _deps;
90
+ }
91
+ _db() {
92
+ return this._deps.connection;
93
+ }
94
+ async append(entry) {
95
+ await this._db().query(`INSERT INTO authority_decisions
96
+ (id, ts, principal, action, target, effect, source, reason, mode, permission_effect)
97
+ VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10)`, [
98
+ entry.id,
99
+ entry.ts,
100
+ entry.principal,
101
+ entry.action,
102
+ entry.target,
103
+ entry.effect,
104
+ entry.source,
105
+ entry.reason ?? null,
106
+ entry.mode ?? 'shadow',
107
+ entry.permissionEffect ?? null,
108
+ ]);
109
+ }
110
+ /** Решения «свежие первыми»; фильтры `action`/`effect`/`source`, `limit` — последние N. */
111
+ async list(opts = {}) {
112
+ const params = [];
113
+ const clauses = [];
114
+ if (opts.action !== undefined) {
115
+ params.push(opts.action);
116
+ clauses.push(`action = $${params.length}`);
117
+ }
118
+ if (opts.effect !== undefined) {
119
+ params.push(opts.effect);
120
+ clauses.push(`effect = $${params.length}`);
121
+ }
122
+ if (opts.source !== undefined) {
123
+ params.push(opts.source);
124
+ clauses.push(`source = $${params.length}`);
125
+ }
126
+ const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
127
+ let limit = '';
128
+ const { limit: requested } = opts;
129
+ if (requested !== undefined && Number.isFinite(requested) && requested > 0) {
130
+ params.push(Math.floor(requested));
131
+ limit = `LIMIT $${params.length}::int`;
132
+ }
133
+ const rows = await this._db().query(`SELECT * FROM authority_decisions ${where} ORDER BY seq DESC ${limit}`, params);
134
+ return rows.map(rowToDecision);
135
+ }
136
+ async clear() {
137
+ const rows = await this._db().query('WITH deleted AS (DELETE FROM authority_decisions RETURNING 1) SELECT count(*)::int AS n FROM deleted');
138
+ const value = rows[0]?.n;
139
+ return typeof value === 'number' ? value : Number(value) || 0;
140
+ }
141
+ }
142
+ /** Собрать порты Authority-слоя (ADR-106 Ф0/Ф1). */
143
+ export function buildAuthorityPorts(deps) {
144
+ return {
145
+ authorityPolicy: new PostgresAuthorityPolicyRepository(deps),
146
+ authorityDecisions: new PostgresAuthorityDecisionJournal(deps),
147
+ };
148
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * PG-реализация порта **единого реестра фоновых прогонов** (этап 1 roadmap 0.13
3
+ * — блок 1.2, ADR-097; PROP-096 — фоновые саб-агенты, PROP-097 — фоновые
4
+ * шелл-процессы).
5
+ *
6
+ * Таблица `background_runs` (миграция 021): вид, статус, владелец и параметры
7
+ * прогона; `metadata` — `jsonb`; лог процесса — относительный путь в
8
+ * BlobStore (`log_path`), сами логи остаются на диске (ФС-периметр вне портов,
9
+ * ADR-091/ADR-092). Идентификатор фонового процесса у порта исполнения
10
+ * (`process_id`, `proc_<uuid>`) — колонка миграции 022.
11
+ *
12
+ * Семантика повторяет файловые реализации core (`FileBackgroundRunStore`) и
13
+ * in-memory (`MemoryBackgroundRunRepository`):
14
+ * - upsert по `id`: `started_at` не перезаписывается, `updated_at` — метка
15
+ * вызывающего (драйвер не подставляет «сейчас» — иначе retention-очистка по
16
+ * метке записи теряла бы смысл);
17
+ * - список — «свежие первыми» (`started_at` убыв., тайбрейкер `id`), фильтры —
18
+ * по «И»;
19
+ * - `prune` — **только терминальные** статусы, метка которых строго старше
20
+ * отсечки (`updated_at < $2`); нетерминальный `running` не удаляется никогда.
21
+ *
22
+ * Драйвер не тянет core рантаймом (только `import type`), поэтому потолок
23
+ * выборки повторён здесь локально — как в `ports/pipelines.ts`.
24
+ */
25
+ import type { BackgroundRunRepository, StorageContext } from '@itphx/synth-core';
26
+ import type { BackgroundRunFilter, BackgroundRunRecord, BackgroundRunStatus } from '@itphx/synth-shared';
27
+ import type { PortDeps } from './deps.js';
28
+ /** Часть `StorageContext`, которой владеет группа «фоновые прогоны». */
29
+ export type BackgroundRunPorts = Pick<StorageContext, 'backgroundRuns'>;
30
+ /** Порт реестра фоновых прогонов поверх таблицы `background_runs`. */
31
+ export declare class PgBackgroundRunRepository implements BackgroundRunRepository {
32
+ private readonly _deps;
33
+ constructor(_deps: PortDeps);
34
+ save(record: BackgroundRunRecord): Promise<void>;
35
+ get(id: string): Promise<BackgroundRunRecord | null>;
36
+ list(filter?: BackgroundRunFilter): Promise<BackgroundRunRecord[]>;
37
+ remove(id: string): Promise<boolean>;
38
+ prune(before: string, statuses?: BackgroundRunStatus[]): Promise<number>;
39
+ }
40
+ /** Собрать порты группы «фоновые прогоны» (этап 1 roadmap 0.13, блок 1.2). */
41
+ export declare function buildBackgroundRunPorts(deps: PortDeps): BackgroundRunPorts;
@@ -0,0 +1,179 @@
1
+ /**
2
+ * PG-реализация порта **единого реестра фоновых прогонов** (этап 1 roadmap 0.13
3
+ * — блок 1.2, ADR-097; PROP-096 — фоновые саб-агенты, PROP-097 — фоновые
4
+ * шелл-процессы).
5
+ *
6
+ * Таблица `background_runs` (миграция 021): вид, статус, владелец и параметры
7
+ * прогона; `metadata` — `jsonb`; лог процесса — относительный путь в
8
+ * BlobStore (`log_path`), сами логи остаются на диске (ФС-периметр вне портов,
9
+ * ADR-091/ADR-092). Идентификатор фонового процесса у порта исполнения
10
+ * (`process_id`, `proc_<uuid>`) — колонка миграции 022.
11
+ *
12
+ * Семантика повторяет файловые реализации core (`FileBackgroundRunStore`) и
13
+ * in-memory (`MemoryBackgroundRunRepository`):
14
+ * - upsert по `id`: `started_at` не перезаписывается, `updated_at` — метка
15
+ * вызывающего (драйвер не подставляет «сейчас» — иначе retention-очистка по
16
+ * метке записи теряла бы смысл);
17
+ * - список — «свежие первыми» (`started_at` убыв., тайбрейкер `id`), фильтры —
18
+ * по «И»;
19
+ * - `prune` — **только терминальные** статусы, метка которых строго старше
20
+ * отсечки (`updated_at < $2`); нетерминальный `running` не удаляется никогда.
21
+ *
22
+ * Драйвер не тянет core рантаймом (только `import type`), поэтому потолок
23
+ * выборки повторён здесь локально — как в `ports/pipelines.ts`.
24
+ */
25
+ import { BACKGROUND_RUN_TERMINAL_STATUSES } from '@itphx/synth-shared';
26
+ import { jsonbParam } from '../json-param.js';
27
+ import { compact, toIso, toIsoRequired } from './events-core.js';
28
+ // ── Локальные реплики core-хелперов (core рантаймом не тянем) ────────────────
29
+ /** Дефолтный потолок выборки (паритет с core `COLLECTION_LIMIT_DEFAULT`). */
30
+ const LIST_DEFAULT_LIMIT = 100;
31
+ /** Абсолютный потолок выборки (паритет с core `COLLECTION_LIMIT_MAX`). */
32
+ const LIST_MAX_LIMIT = 1000;
33
+ /** Привести `limit` к допустимому виду: дефолт 100, потолок 1000. */
34
+ function resolveLimit(limit) {
35
+ if (limit === undefined || !Number.isFinite(limit) || limit <= 0)
36
+ return LIST_DEFAULT_LIMIT;
37
+ return Math.min(Math.floor(limit), LIST_MAX_LIMIT);
38
+ }
39
+ /**
40
+ * Статусы, которые можно чистить: только терминальные. Нетерминальные статусы
41
+ * из аргумента игнорируются — `running` не удаляется никогда.
42
+ */
43
+ function prunableStatuses(statuses) {
44
+ if (statuses === undefined)
45
+ return [...BACKGROUND_RUN_TERMINAL_STATUSES];
46
+ return statuses.filter((status) => BACKGROUND_RUN_TERMINAL_STATUSES.includes(status));
47
+ }
48
+ /** Запись фонового прогона из колонок. */
49
+ function toBackgroundRun(row) {
50
+ return compact({
51
+ id: row.id,
52
+ kind: row.kind,
53
+ status: row.status,
54
+ sessionId: row.session_id,
55
+ projectId: row.project_id ?? undefined,
56
+ childSessionId: row.child_session_id ?? undefined,
57
+ agentRole: row.agent_role ?? undefined,
58
+ description: row.description ?? undefined,
59
+ command: row.command ?? undefined,
60
+ cwd: row.cwd ?? undefined,
61
+ pid: row.pid ?? undefined,
62
+ processId: row.process_id ?? undefined,
63
+ logPath: row.log_path ?? undefined,
64
+ exitCode: row.exit_code ?? undefined,
65
+ signal: row.signal ?? undefined,
66
+ startedAt: toIsoRequired(row.started_at),
67
+ finishedAt: toIso(row.finished_at),
68
+ updatedAt: toIsoRequired(row.updated_at),
69
+ summary: row.summary ?? undefined,
70
+ metadata: (row.metadata ?? undefined),
71
+ });
72
+ }
73
+ /** Порт реестра фоновых прогонов поверх таблицы `background_runs`. */
74
+ export class PgBackgroundRunRepository {
75
+ _deps;
76
+ constructor(_deps) {
77
+ this._deps = _deps;
78
+ }
79
+ async save(record) {
80
+ await this._deps.connection.query(`INSERT INTO background_runs
81
+ (id, kind, status, session_id, project_id, child_session_id, agent_role, description,
82
+ command, cwd, pid, process_id, log_path, exit_code, signal, started_at, finished_at,
83
+ updated_at, summary, metadata)
84
+ VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16::timestamptz,
85
+ $17::timestamptz, $18::timestamptz, $19, $20::jsonb)
86
+ ON CONFLICT (id) DO UPDATE SET
87
+ kind = EXCLUDED.kind,
88
+ status = EXCLUDED.status,
89
+ session_id = EXCLUDED.session_id,
90
+ project_id = EXCLUDED.project_id,
91
+ child_session_id = EXCLUDED.child_session_id,
92
+ agent_role = EXCLUDED.agent_role,
93
+ description = EXCLUDED.description,
94
+ command = EXCLUDED.command,
95
+ cwd = EXCLUDED.cwd,
96
+ pid = EXCLUDED.pid,
97
+ process_id = EXCLUDED.process_id,
98
+ log_path = EXCLUDED.log_path,
99
+ exit_code = EXCLUDED.exit_code,
100
+ signal = EXCLUDED.signal,
101
+ started_at = background_runs.started_at,
102
+ finished_at = EXCLUDED.finished_at,
103
+ updated_at = EXCLUDED.updated_at,
104
+ summary = EXCLUDED.summary,
105
+ metadata = EXCLUDED.metadata`, [
106
+ record.id,
107
+ record.kind,
108
+ record.status,
109
+ record.sessionId,
110
+ record.projectId ?? null,
111
+ record.childSessionId ?? null,
112
+ record.agentRole ?? null,
113
+ record.description ?? null,
114
+ record.command ?? null,
115
+ record.cwd ?? null,
116
+ record.pid ?? null,
117
+ record.processId ?? null,
118
+ record.logPath ?? null,
119
+ record.exitCode ?? null,
120
+ record.signal ?? null,
121
+ record.startedAt,
122
+ record.finishedAt ?? null,
123
+ record.updatedAt,
124
+ record.summary ?? null,
125
+ record.metadata !== undefined ? jsonbParam(record.metadata) : null,
126
+ ]);
127
+ }
128
+ async get(id) {
129
+ const rows = await this._deps.connection.query('SELECT * FROM background_runs WHERE id = $1 LIMIT 1', [id]);
130
+ return rows[0] ? toBackgroundRun(rows[0]) : null;
131
+ }
132
+ async list(filter) {
133
+ const params = [];
134
+ const where = [];
135
+ if (filter?.kind !== undefined) {
136
+ params.push(filter.kind);
137
+ where.push(`kind = $${params.length}`);
138
+ }
139
+ if (filter?.status !== undefined) {
140
+ params.push(filter.status);
141
+ where.push(`status = $${params.length}`);
142
+ }
143
+ if (filter?.sessionId !== undefined) {
144
+ params.push(filter.sessionId);
145
+ where.push(`session_id = $${params.length}`);
146
+ }
147
+ if (filter?.projectId !== undefined) {
148
+ params.push(filter.projectId);
149
+ where.push(`project_id = $${params.length}`);
150
+ }
151
+ params.push(resolveLimit(filter?.limit));
152
+ const sql = 'SELECT * FROM background_runs' +
153
+ (where.length ? ` WHERE ${where.join(' AND ')}` : '') +
154
+ ' ORDER BY started_at DESC, id ASC' +
155
+ ` LIMIT $${params.length}`;
156
+ const rows = await this._deps.connection.query(sql, params);
157
+ return rows.map(toBackgroundRun);
158
+ }
159
+ async remove(id) {
160
+ const rows = await this._deps.connection.query('DELETE FROM background_runs WHERE id = $1 RETURNING id', [id]);
161
+ return rows.length > 0;
162
+ }
163
+ async prune(before, statuses) {
164
+ const allowed = prunableStatuses(statuses);
165
+ // Пустой набор статусов — чистить нечего (нетерминальные игнорируются).
166
+ if (allowed.length === 0)
167
+ return 0;
168
+ const rows = await this._deps.connection.query(`DELETE FROM background_runs
169
+ WHERE status = ANY($1::text[]) AND updated_at < $2::timestamptz
170
+ RETURNING id`, [allowed, before]);
171
+ return rows.length;
172
+ }
173
+ }
174
+ /** Собрать порты группы «фоновые прогоны» (этап 1 roadmap 0.13, блок 1.2). */
175
+ export function buildBackgroundRunPorts(deps) {
176
+ return {
177
+ backgroundRuns: new PgBackgroundRunRepository(deps),
178
+ };
179
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * PG-реализация порта **учёта ссылок на объекты blob-хранилища**
3
+ * (ADR-115 §«Хранение», ADR-116 §3, ADR-097).
4
+ *
5
+ * Хранение — таблица `blob_refs` (миграция `024_blob_refs`): первичный ключ —
6
+ * тройка `(blob_path, owner_kind, owner_id)`, индекс по владельцу
7
+ * `(owner_kind, owner_id)`.
8
+ *
9
+ * Байты самих объектов в БД **не** лежат (том, ADR-116 §2) — здесь только
10
+ * учёт ссылок: по нему дедуп (по содержимому) и детерминированный GC (ссылок
11
+ * не осталось → объект можно удалять).
12
+ *
13
+ * Семантика повторяет файловую реализацию core (`FileBlobRefRepository`) и
14
+ * in-memory (`MemoryBlobRefRepository`):
15
+ * - `add` **идемпотентен** (`ON CONFLICT DO NOTHING` — дубля не создаётся);
16
+ * - `remove` снимает ровно одну ссылку; отсутствие ссылки — не ошибка;
17
+ * - `removeByOwner` снимает все ссылки владельца и возвращает их число;
18
+ * - `listByOwner` отдаёт пути в детерминированном порядке (`ORDER BY`);
19
+ * - `countRefs` считает ссылки на объект.
20
+ */
21
+ import type { BlobOwnerKind, BlobRef, BlobRefRepository, StorageContext } from '@itphx/synth-core';
22
+ import type { PortDeps } from './deps.js';
23
+ /** Часть `StorageContext`, которой владеет группа «blob-refs». */
24
+ export type BlobRefPorts = Pick<StorageContext, 'blobRefs'>;
25
+ /** Порт учёта ссылок на blob-объекты поверх таблицы `blob_refs`. */
26
+ export declare class PgBlobRefRepository implements BlobRefRepository {
27
+ private readonly _deps;
28
+ constructor(_deps: PortDeps);
29
+ add(ref: BlobRef): Promise<void>;
30
+ remove(ref: BlobRef): Promise<void>;
31
+ removeByOwner(ownerKind: BlobOwnerKind, ownerId: string): Promise<number>;
32
+ listByOwner(ownerKind: BlobOwnerKind, ownerId: string): Promise<string[]>;
33
+ countRefs(blobPath: string): Promise<number>;
34
+ }
35
+ /** Собрать порт учёта ссылок на blob-объекты (ADR-115/ADR-116). */
36
+ export declare function buildBlobRefPorts(deps: PortDeps): BlobRefPorts;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * PG-реализация порта **учёта ссылок на объекты blob-хранилища**
3
+ * (ADR-115 §«Хранение», ADR-116 §3, ADR-097).
4
+ *
5
+ * Хранение — таблица `blob_refs` (миграция `024_blob_refs`): первичный ключ —
6
+ * тройка `(blob_path, owner_kind, owner_id)`, индекс по владельцу
7
+ * `(owner_kind, owner_id)`.
8
+ *
9
+ * Байты самих объектов в БД **не** лежат (том, ADR-116 §2) — здесь только
10
+ * учёт ссылок: по нему дедуп (по содержимому) и детерминированный GC (ссылок
11
+ * не осталось → объект можно удалять).
12
+ *
13
+ * Семантика повторяет файловую реализацию core (`FileBlobRefRepository`) и
14
+ * in-memory (`MemoryBlobRefRepository`):
15
+ * - `add` **идемпотентен** (`ON CONFLICT DO NOTHING` — дубля не создаётся);
16
+ * - `remove` снимает ровно одну ссылку; отсутствие ссылки — не ошибка;
17
+ * - `removeByOwner` снимает все ссылки владельца и возвращает их число;
18
+ * - `listByOwner` отдаёт пути в детерминированном порядке (`ORDER BY`);
19
+ * - `countRefs` считает ссылки на объект.
20
+ */
21
+ /** Порт учёта ссылок на blob-объекты поверх таблицы `blob_refs`. */
22
+ export class PgBlobRefRepository {
23
+ _deps;
24
+ constructor(_deps) {
25
+ this._deps = _deps;
26
+ }
27
+ async add(ref) {
28
+ await this._deps.connection.query(`INSERT INTO blob_refs (blob_path, owner_kind, owner_id, created_at)
29
+ VALUES ($1, $2, $3, now())
30
+ ON CONFLICT (blob_path, owner_kind, owner_id) DO NOTHING`, [ref.blobPath, ref.ownerKind, ref.ownerId]);
31
+ }
32
+ async remove(ref) {
33
+ await this._deps.connection.query('DELETE FROM blob_refs WHERE blob_path = $1 AND owner_kind = $2 AND owner_id = $3', [ref.blobPath, ref.ownerKind, ref.ownerId]);
34
+ }
35
+ async removeByOwner(ownerKind, ownerId) {
36
+ const rows = await this._deps.connection.query('DELETE FROM blob_refs WHERE owner_kind = $1 AND owner_id = $2 RETURNING blob_path', [ownerKind, ownerId]);
37
+ return rows.length;
38
+ }
39
+ async listByOwner(ownerKind, ownerId) {
40
+ const rows = await this._deps.connection.query('SELECT blob_path FROM blob_refs WHERE owner_kind = $1 AND owner_id = $2 ORDER BY blob_path ASC', [ownerKind, ownerId]);
41
+ return rows.map((row) => row.blob_path);
42
+ }
43
+ async countRefs(blobPath) {
44
+ const rows = await this._deps.connection.query('SELECT count(*)::text AS count FROM blob_refs WHERE blob_path = $1', [blobPath]);
45
+ const raw = rows[0]?.count;
46
+ const count = raw !== undefined ? Number(raw) : 0;
47
+ return Number.isFinite(count) ? count : 0;
48
+ }
49
+ }
50
+ /** Собрать порт учёта ссылок на blob-объекты (ADR-115/ADR-116). */
51
+ export function buildBlobRefPorts(deps) {
52
+ return {
53
+ blobRefs: new PgBlobRefRepository(deps),
54
+ };
55
+ }
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Группа портов **контента, секретов и обслуживания** PostgreSQL-драйвера
3
- * (PROP-032, волна 3b).
3
+ * (ADR-097, волна 3b).
4
4
  *
5
5
  * Владелец файла — один агент волны реализации; правит только `content.ts`.
6
6
  * Файл экспортирует единственную фабрику `buildContentPorts(deps)`, возвращающую
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Группа портов **контента, секретов и обслуживания** PostgreSQL-драйвера
3
- * (PROP-032, волна 3b).
3
+ * (ADR-097, волна 3b).
4
4
  *
5
5
  * Владелец файла — один агент волны реализации; правит только `content.ts`.
6
6
  * Файл экспортирует единственную фабрику `buildContentPorts(deps)`, возвращающую
@@ -169,7 +169,12 @@ function serviceKeyToPublic(row) {
169
169
  }
170
170
  /** Внутренняя запись для переноса между backend'ами: публичные поля + sha256-хеш. */
171
171
  function serviceKeyToRecord(row) {
172
- return { ...serviceKeyToPublic(row), hash: row.secret_hash };
172
+ const record = { ...serviceKeyToPublic(row), hash: row.secret_hash };
173
+ // Ф7 (ADR-090): привязка к плагину переносится вместе с записью — иначе
174
+ // ключ потерял бы привязку и стал бы обычным service-key (fail-open).
175
+ if (row.plugin_id)
176
+ record.pluginId = row.plugin_id;
177
+ return record;
173
178
  }
174
179
  /** Порт реестра service-key инстанса поверх таблицы `service_keys`. */
175
180
  class PostgresServiceKeyRepository {
@@ -195,7 +200,7 @@ class PostgresServiceKeyRepository {
195
200
  return rows.map(serviceKeyToRecord);
196
201
  }
197
202
  /**
198
- * Импорт готовой записи как есть (PROP-032): `id`/`prefix`/`secret_hash`
203
+ * Импорт готовой записи как есть (ADR-097): `id`/`prefix`/`secret_hash`
199
204
  * сохраняются. `ON CONFLICT DO NOTHING` — идемпотентно; при конфликте
200
205
  * возвращается существующая строка (по `id`, метке или хешу).
201
206
  */
@@ -209,8 +214,9 @@ class PostgresServiceKeyRepository {
209
214
  throw new Error('hash обязателен');
210
215
  const inserted = await this._db().query(`INSERT INTO service_keys
211
216
  (id, label, description, roles, scopes, allowed_projects, rate_limit_per_minute,
212
- secret_hash, prefix, created_by, created_at, last_used_at, expires_at, revoked_at)
213
- VALUES ($1,$2,$3,$4::jsonb,$5::jsonb,$6::jsonb,$7,$8,$9,$10,$11,$12,$13,$14)
217
+ secret_hash, prefix, created_by, created_at, last_used_at, expires_at, revoked_at,
218
+ plugin_id)
219
+ VALUES ($1,$2,$3,$4::jsonb,$5::jsonb,$6::jsonb,$7,$8,$9,$10,$11,$12,$13,$14,$15)
214
220
  ON CONFLICT DO NOTHING
215
221
  RETURNING *`, [
216
222
  record.id,
@@ -227,6 +233,8 @@ class PostgresServiceKeyRepository {
227
233
  record.lastUsedAt ?? null,
228
234
  record.expiresAt ?? null,
229
235
  record.revokedAt ?? null,
236
+ // Ф7 (ADR-090): привязка к плагину переносится вместе с записью.
237
+ record.pluginId ?? null,
230
238
  ]);
231
239
  if (inserted[0])
232
240
  return serviceKeyToPublic(inserted[0]);
@@ -272,8 +280,8 @@ class PostgresServiceKeyRepository {
272
280
  try {
273
281
  await this._db().query(`INSERT INTO service_keys
274
282
  (id, label, description, roles, scopes, allowed_projects, rate_limit_per_minute,
275
- secret_hash, prefix, created_by, created_at, expires_at)
276
- VALUES ($1,$2,$3,$4::jsonb,$5::jsonb,$6::jsonb,$7,$8,$9,$10,$11,$12)`, [
283
+ secret_hash, prefix, created_by, created_at, expires_at, plugin_id)
284
+ VALUES ($1,$2,$3,$4::jsonb,$5::jsonb,$6::jsonb,$7,$8,$9,$10,$11,$12,$13)`, [
277
285
  record.id,
278
286
  record.label,
279
287
  record.description ?? null,
@@ -286,6 +294,8 @@ class PostgresServiceKeyRepository {
286
294
  record.createdBy,
287
295
  record.createdAt,
288
296
  record.expiresAt ?? null,
297
+ // Ф7 (ADR-090): привязка к плагину (server-scoped токен).
298
+ input.pluginId ?? null,
289
299
  ]);
290
300
  }
291
301
  catch (err) {
@@ -441,6 +451,10 @@ class PostgresServiceKeyRepository {
441
451
  credential.allowedProjects = [...key.allowedProjects];
442
452
  if (key.rateLimitPerMinute !== undefined)
443
453
  credential.rateLimitPerMinute = key.rateLimitPerMinute;
454
+ // Ф7 (ADR-090): привязка к плагину — по ней сервер проверяет заголовок
455
+ // `X-Synth-Plugin-Id` и серверный allow-list (fail-closed).
456
+ if (row.plugin_id)
457
+ credential.pluginId = row.plugin_id;
444
458
  return { key, credential };
445
459
  }
446
460
  async touch(id) {