@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.
- package/LICENSE +18 -0
- package/LICENSE.ru.md +31 -0
- package/dist/errors.d.ts +71 -0
- package/dist/errors.js +126 -0
- package/dist/index.d.ts +51 -0
- package/dist/index.js +56 -0
- package/dist/json-param.d.ts +14 -0
- package/dist/json-param.js +22 -0
- package/dist/locks.d.ts +104 -0
- package/dist/locks.js +201 -0
- package/dist/migrate.d.ts +58 -0
- package/dist/migrate.js +125 -0
- package/dist/migrations/001-init.d.ts +15 -0
- package/dist/migrations/001-init.js +457 -0
- package/dist/migrations/002-egress-audit.d.ts +12 -0
- package/dist/migrations/002-egress-audit.js +52 -0
- package/dist/migrations/003-analytics-rollups.d.ts +12 -0
- package/dist/migrations/003-analytics-rollups.js +21 -0
- package/dist/migrations/004-pipeline-engine.d.ts +19 -0
- package/dist/migrations/004-pipeline-engine.js +74 -0
- package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
- package/dist/migrations/005-pipeline-provenance.js +15 -0
- package/dist/migrations/006-plugin-audit.d.ts +13 -0
- package/dist/migrations/006-plugin-audit.js +34 -0
- package/dist/migrations/007-plugin-lock.d.ts +10 -0
- package/dist/migrations/007-plugin-lock.js +25 -0
- package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
- package/dist/migrations/008-plugin-audit-scan.js +15 -0
- package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
- package/dist/migrations/009-plugin-lock-previous.js +16 -0
- package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
- package/dist/migrations/010-plugin-lock-mode.js +20 -0
- package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
- package/dist/migrations/011-session-steer-inbox.js +14 -0
- package/dist/migrations/012-external-credentials.d.ts +15 -0
- package/dist/migrations/012-external-credentials.js +40 -0
- package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
- package/dist/migrations/013-service-key-plugin-id.js +20 -0
- package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
- package/dist/migrations/014-session-mode-by-principal.js +15 -0
- package/dist/migrations/015-authority.d.ts +17 -0
- package/dist/migrations/015-authority.js +43 -0
- package/dist/migrations/016-credential-audit.d.ts +17 -0
- package/dist/migrations/016-credential-audit.js +32 -0
- package/dist/migrations/017-memory.d.ts +29 -0
- package/dist/migrations/017-memory.js +95 -0
- package/dist/migrations/018-memory-index-scope.d.ts +14 -0
- package/dist/migrations/018-memory-index-scope.js +18 -0
- package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
- package/dist/migrations/019-memory-index-enabled.js +14 -0
- package/dist/migrations/020-project-memory.d.ts +11 -0
- package/dist/migrations/020-project-memory.js +13 -0
- package/dist/migrations/021-background-runs.d.ts +17 -0
- package/dist/migrations/021-background-runs.js +67 -0
- package/dist/migrations/022-background-run-process-id.d.ts +14 -0
- package/dist/migrations/022-background-run-process-id.js +18 -0
- package/dist/migrations/023-session-worktree.d.ts +12 -0
- package/dist/migrations/023-session-worktree.js +16 -0
- package/dist/migrations/024-blob-refs.d.ts +15 -0
- package/dist/migrations/024-blob-refs.js +26 -0
- package/dist/migrations/025-packs-pipelines.d.ts +28 -0
- package/dist/migrations/025-packs-pipelines.js +82 -0
- package/dist/migrations/026-instance-skills.d.ts +17 -0
- package/dist/migrations/026-instance-skills.js +25 -0
- package/dist/migrations/027-context-files.d.ts +20 -0
- package/dist/migrations/027-context-files.js +30 -0
- package/dist/migrations/index.d.ts +23 -0
- package/dist/migrations/index.js +71 -0
- package/dist/pool.d.ts +178 -0
- package/dist/pool.js +382 -0
- package/dist/ports/analytics.d.ts +26 -0
- package/dist/ports/analytics.js +243 -0
- package/dist/ports/audit.d.ts +15 -0
- package/dist/ports/audit.js +192 -0
- package/dist/ports/authority.d.ts +27 -0
- package/dist/ports/authority.js +148 -0
- package/dist/ports/background-runs.d.ts +41 -0
- package/dist/ports/background-runs.js +179 -0
- package/dist/ports/blob-refs.d.ts +36 -0
- package/dist/ports/blob-refs.js +55 -0
- package/dist/ports/content.d.ts +41 -0
- package/dist/ports/content.js +1553 -0
- package/dist/ports/context-files.d.ts +145 -0
- package/dist/ports/context-files.js +279 -0
- package/dist/ports/core-sync.d.ts +31 -0
- package/dist/ports/core-sync.js +34 -0
- package/dist/ports/credential-audit.d.ts +19 -0
- package/dist/ports/credential-audit.js +96 -0
- package/dist/ports/deps.d.ts +63 -0
- package/dist/ports/deps.js +19 -0
- package/dist/ports/events-bindings.d.ts +77 -0
- package/dist/ports/events-bindings.js +356 -0
- package/dist/ports/events-core.d.ts +35 -0
- package/dist/ports/events-core.js +71 -0
- package/dist/ports/events-journal.d.ts +68 -0
- package/dist/ports/events-journal.js +211 -0
- package/dist/ports/events-scheduler.d.ts +49 -0
- package/dist/ports/events-scheduler.js +231 -0
- package/dist/ports/events-webhooks.d.ts +64 -0
- package/dist/ports/events-webhooks.js +268 -0
- package/dist/ports/events.d.ts +20 -0
- package/dist/ports/events.js +27 -0
- package/dist/ports/external-credentials.d.ts +6 -0
- package/dist/ports/external-credentials.js +363 -0
- package/dist/ports/legacy-pipelines.d.ts +50 -0
- package/dist/ports/legacy-pipelines.js +202 -0
- package/dist/ports/memory.d.ts +65 -0
- package/dist/ports/memory.js +471 -0
- package/dist/ports/packs.d.ts +32 -0
- package/dist/ports/packs.js +117 -0
- package/dist/ports/pipelines.d.ts +67 -0
- package/dist/ports/pipelines.js +297 -0
- package/dist/ports/plugin-audit.d.ts +14 -0
- package/dist/ports/plugin-audit.js +110 -0
- package/dist/ports/plugin-lock.d.ts +27 -0
- package/dist/ports/plugin-lock.js +145 -0
- package/dist/ports/principals-defaults.d.ts +21 -0
- package/dist/ports/principals-defaults.js +68 -0
- package/dist/ports/principals-documents.d.ts +23 -0
- package/dist/ports/principals-documents.js +38 -0
- package/dist/ports/principals-profiles.d.ts +21 -0
- package/dist/ports/principals-profiles.js +263 -0
- package/dist/ports/principals-projects.d.ts +19 -0
- package/dist/ports/principals-projects.js +161 -0
- package/dist/ports/principals-settings.d.ts +25 -0
- package/dist/ports/principals-settings.js +295 -0
- package/dist/ports/principals-shared.d.ts +33 -0
- package/dist/ports/principals-shared.js +44 -0
- package/dist/ports/principals.d.ts +27 -0
- package/dist/ports/principals.js +39 -0
- package/dist/ports/questions.d.ts +40 -0
- package/dist/ports/questions.js +135 -0
- package/dist/ports/sessions-mapping.d.ts +254 -0
- package/dist/ports/sessions-mapping.js +449 -0
- package/dist/ports/sessions.d.ts +143 -0
- package/dist/ports/sessions.js +517 -0
- package/dist/ports/skills.d.ts +59 -0
- package/dist/ports/skills.js +205 -0
- package/dist/ports/stub.d.ts +14 -0
- package/dist/ports/stub.js +32 -0
- package/dist/ports/worktrees.d.ts +41 -0
- package/dist/ports/worktrees.js +85 -0
- package/dist/postgres-storage.d.ts +58 -0
- package/dist/postgres-storage.js +110 -0
- package/dist/schema.d.ts +13 -0
- package/dist/schema.js +22 -0
- package/dist/storage-context.d.ts +80 -0
- package/dist/storage-context.js +238 -0
- package/package.json +40 -3
- package/README.md +0 -3
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PG-реализация порта **файлов контекста/промптов** (ADR-069/ADR-070, ADR-116,
|
|
3
|
+
* ADR-097): пользовательская часть (`user`/`role` и override системных
|
|
4
|
+
* промптов) — строки таблицы `context_files`, системная часть (промпты образа
|
|
5
|
+
* `{packageRoot}/prompts`) остаётся ФС.
|
|
6
|
+
*
|
|
7
|
+
* Разделение:
|
|
8
|
+
* - **системные промпты** (роли, `prompts/system/**`, `prompts/security/**`)
|
|
9
|
+
* читаются файловой реализацией core (`ContextConfig`) — те же ассеты, что и
|
|
10
|
+
* раньше; они не меняются в runtime и в БД не дублируются;
|
|
11
|
+
* - **пользовательские override'ы** — строки `(category, filename)` в таблице
|
|
12
|
+
* (миграция `027_context_files`); категории — доменные
|
|
13
|
+
* (`user`/`role`/`system`), т. е. ровно те, что принимает порт. Это уточнение
|
|
14
|
+
* к наброску миграции (`'user' | 'roles'`): категория `system` — override
|
|
15
|
+
* системного промпта (`{context}/user/system/**` в файловой раскладке), без
|
|
16
|
+
* неё UI-переопределение промптов режимов/безопасности не переносится.
|
|
17
|
+
*
|
|
18
|
+
* ## Почему кэш, а не запрос на каждый геттер
|
|
19
|
+
*
|
|
20
|
+
* Порт **синхронный** (сборка промпта на горячем пути, ADR-070): геттеры не
|
|
21
|
+
* могут ждать I/O. Поэтому строки держатся в процесс-локальном кэше
|
|
22
|
+
* (`Map`), который:
|
|
23
|
+
* - прогревается при сборке контекста (`initialize()` → `warm()`);
|
|
24
|
+
* - обновляется после каждой записи (`saveFile`/`deleteFile` → `warm()`);
|
|
25
|
+
* - инвалидируется по сигнатуре **максимума `updated_at`** таблицы: синхронный
|
|
26
|
+
* геттер не чаще `signatureTtlMs` запускает **фоновую** проверку
|
|
27
|
+
* (`SELECT max(updated_at)`); при расхождении строка перечитывается целиком.
|
|
28
|
+
* Так правка, сделанная другим процессом/репликой, становится видимой без
|
|
29
|
+
* рестарта (с задержкой до TTL), а горячий путь не блокируется.
|
|
30
|
+
*
|
|
31
|
+
* Ошибки фоновой проверки не влияют на чтение: остаётся последний удачный кэш
|
|
32
|
+
* (деградация не превращается в пустой промпт).
|
|
33
|
+
*/
|
|
34
|
+
import type { ContextCategory, ContextFileContent, ContextFileInfo } from '@itphx/synth-shared';
|
|
35
|
+
import type { ContextFileRepository, StorageContext } from '@itphx/synth-core';
|
|
36
|
+
import type { PortDeps } from './deps.js';
|
|
37
|
+
/** Часть `StorageContext`, которой владеет группа «contextFiles». */
|
|
38
|
+
export type ContextFilePorts = Pick<StorageContext, 'contextFiles'>;
|
|
39
|
+
/**
|
|
40
|
+
* Источник пользовательских override-файлов для файловой реализации
|
|
41
|
+
* (`ContextConfig`): структурный контракт, чтобы драйвер не тянул core
|
|
42
|
+
* рантаймом (тип живёт в `engine/context/config.ts` core).
|
|
43
|
+
*/
|
|
44
|
+
export interface ContextOverrideSourceLike {
|
|
45
|
+
has(category: ContextCategory, filename: string): boolean;
|
|
46
|
+
read(category: ContextCategory, filename: string): string | null;
|
|
47
|
+
list(): Array<{
|
|
48
|
+
category: ContextCategory;
|
|
49
|
+
filename: string;
|
|
50
|
+
size: number;
|
|
51
|
+
modifiedAt: number;
|
|
52
|
+
}>;
|
|
53
|
+
}
|
|
54
|
+
/** Опции сборки порта. */
|
|
55
|
+
export interface ContextFilePortOptions {
|
|
56
|
+
/** Корень системных промптов (уже резолвленный файловой реализацией). */
|
|
57
|
+
systemPromptsDir?: string;
|
|
58
|
+
/**
|
|
59
|
+
* Фабрика файловой реализации (`ContextConfig`) с инъекцией
|
|
60
|
+
* пользовательского источника: кэш PG + те же системные промпты образа.
|
|
61
|
+
*/
|
|
62
|
+
createConfig: (overrides: ContextOverrideSourceLike) => ContextFileRepository;
|
|
63
|
+
/** Период фоновой проверки сигнатуры `updated_at`, мс (по умолчанию 5000). */
|
|
64
|
+
signatureTtlMs?: number;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* ADR-116: файлы контекста — системные промпты ФС, пользовательская часть в SQL.
|
|
68
|
+
*/
|
|
69
|
+
export declare class PgContextFileRepository implements ContextFileRepository, ContextOverrideSourceLike {
|
|
70
|
+
private readonly _deps;
|
|
71
|
+
readonly systemPromptsDir: string;
|
|
72
|
+
private readonly _config;
|
|
73
|
+
private readonly _cache;
|
|
74
|
+
private readonly _signatureTtlMs;
|
|
75
|
+
/** Сигнатура последнего успешного чтения (`max(updated_at)` в мс, `'0'` — пусто). */
|
|
76
|
+
private _signature;
|
|
77
|
+
/** Момент последней фоновой проверки сигнатуры, мс. */
|
|
78
|
+
private _lastCheckAt;
|
|
79
|
+
/** Текущая фоновая проверка (одна на процесс). */
|
|
80
|
+
private _refreshing;
|
|
81
|
+
constructor(_deps: PortDeps, opts: ContextFilePortOptions);
|
|
82
|
+
has(category: ContextCategory, filename: string): boolean;
|
|
83
|
+
read(category: ContextCategory, filename: string): string | null;
|
|
84
|
+
list(): Array<{
|
|
85
|
+
category: ContextCategory;
|
|
86
|
+
filename: string;
|
|
87
|
+
size: number;
|
|
88
|
+
modifiedAt: number;
|
|
89
|
+
}>;
|
|
90
|
+
listAllFiles(): ContextFileInfo[];
|
|
91
|
+
getFile(filename: string, category: ContextCategory): ContextFileContent | null;
|
|
92
|
+
getEnabledFiles(): string[];
|
|
93
|
+
setEnabledFiles(files: string[]): void;
|
|
94
|
+
getRolePrompt(agentId: string, contextFileOverride?: string, language?: string): string | null;
|
|
95
|
+
getRolesDescription(language?: string): string;
|
|
96
|
+
getInterviewTemplate(language?: string): string;
|
|
97
|
+
getParticipantsNotice(language?: string): string;
|
|
98
|
+
getSchedulerNotice(language?: string): string;
|
|
99
|
+
getSchedulerTurnNotice(language?: string): string;
|
|
100
|
+
getMaxStepsPrompt(language?: string): string;
|
|
101
|
+
getSummarizerPrompt(language?: string): string;
|
|
102
|
+
getUserContextTemplate(language?: string): string;
|
|
103
|
+
getCompressedDialogTemplate(language?: string): string;
|
|
104
|
+
getAttachmentsDroppedTemplate(language?: string): string;
|
|
105
|
+
getMediaDeriveTemplate(language?: string): string;
|
|
106
|
+
getStickyNotesTemplate(language?: string): string;
|
|
107
|
+
getRoutingInstructions(language?: string): string;
|
|
108
|
+
getRules(language?: string): string;
|
|
109
|
+
getGatewayInstructions(language?: string): string;
|
|
110
|
+
getMemoryInstructions(language?: string): string;
|
|
111
|
+
getSecurityMessage(messageId: string, language?: string, params?: Record<string, string>): string | null;
|
|
112
|
+
getModePrompt(mode: string, language?: string): string | null;
|
|
113
|
+
getPlanModePrompt(planMode: 'auto' | 'strict' | 'off', planApproved: boolean, language?: string): string | null;
|
|
114
|
+
getPlanGuide(language?: string): string | null;
|
|
115
|
+
getModePolicy(language?: string): string | null;
|
|
116
|
+
getClassificationInstructions(language?: string): string;
|
|
117
|
+
saveFile(filename: string, content: string, category: ContextCategory): Promise<boolean>;
|
|
118
|
+
deleteFile(filename: string, category: ContextCategory): Promise<boolean>;
|
|
119
|
+
/** «Восстановить системный файл» = снять пользовательский override. */
|
|
120
|
+
restoreFile(filename: string, category: ContextCategory): Promise<boolean>;
|
|
121
|
+
/**
|
|
122
|
+
* Прогрев кэша: чтение всех пользовательских файлов + фиксация сигнатуры.
|
|
123
|
+
* Вызывается при сборке контекста (`initialize`) и после каждой записи.
|
|
124
|
+
*/
|
|
125
|
+
warm(): Promise<void>;
|
|
126
|
+
/** Стартовый прогрев без падения старта: ошибка БД — пустой кэш + предупреждение. */
|
|
127
|
+
initialize(): Promise<void>;
|
|
128
|
+
/** Дождаться текущей фоновой проверки сигнатуры (graceful shutdown/тесты). */
|
|
129
|
+
pendingRefresh(): Promise<void>;
|
|
130
|
+
private _key;
|
|
131
|
+
/**
|
|
132
|
+
* Запустить фоновую проверку сигнатуры, если с прошлой прошло `signatureTtlMs`
|
|
133
|
+
* (и другая ещё не идёт). Синхронный геттер не блокируется.
|
|
134
|
+
*/
|
|
135
|
+
private _scheduleRefresh;
|
|
136
|
+
/** Перечитать строки, если `max(updated_at)` разошёлся с кэшем. */
|
|
137
|
+
private _refreshIfStale;
|
|
138
|
+
/** Сигнатура таблицы: `max(updated_at)` в миллисекундах (`0` — пусто). */
|
|
139
|
+
private _readSignature;
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
* Собрать порт файлов контекста (ADR-116): системные промпты — ФС, пользовательская
|
|
143
|
+
* часть — SQL. Кэш прогревается в фоне при сборке контекста.
|
|
144
|
+
*/
|
|
145
|
+
export declare function buildContextFilePorts(deps: PortDeps, opts: ContextFilePortOptions): ContextFilePorts;
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PG-реализация порта **файлов контекста/промптов** (ADR-069/ADR-070, ADR-116,
|
|
3
|
+
* ADR-097): пользовательская часть (`user`/`role` и override системных
|
|
4
|
+
* промптов) — строки таблицы `context_files`, системная часть (промпты образа
|
|
5
|
+
* `{packageRoot}/prompts`) остаётся ФС.
|
|
6
|
+
*
|
|
7
|
+
* Разделение:
|
|
8
|
+
* - **системные промпты** (роли, `prompts/system/**`, `prompts/security/**`)
|
|
9
|
+
* читаются файловой реализацией core (`ContextConfig`) — те же ассеты, что и
|
|
10
|
+
* раньше; они не меняются в runtime и в БД не дублируются;
|
|
11
|
+
* - **пользовательские override'ы** — строки `(category, filename)` в таблице
|
|
12
|
+
* (миграция `027_context_files`); категории — доменные
|
|
13
|
+
* (`user`/`role`/`system`), т. е. ровно те, что принимает порт. Это уточнение
|
|
14
|
+
* к наброску миграции (`'user' | 'roles'`): категория `system` — override
|
|
15
|
+
* системного промпта (`{context}/user/system/**` в файловой раскладке), без
|
|
16
|
+
* неё UI-переопределение промптов режимов/безопасности не переносится.
|
|
17
|
+
*
|
|
18
|
+
* ## Почему кэш, а не запрос на каждый геттер
|
|
19
|
+
*
|
|
20
|
+
* Порт **синхронный** (сборка промпта на горячем пути, ADR-070): геттеры не
|
|
21
|
+
* могут ждать I/O. Поэтому строки держатся в процесс-локальном кэше
|
|
22
|
+
* (`Map`), который:
|
|
23
|
+
* - прогревается при сборке контекста (`initialize()` → `warm()`);
|
|
24
|
+
* - обновляется после каждой записи (`saveFile`/`deleteFile` → `warm()`);
|
|
25
|
+
* - инвалидируется по сигнатуре **максимума `updated_at`** таблицы: синхронный
|
|
26
|
+
* геттер не чаще `signatureTtlMs` запускает **фоновую** проверку
|
|
27
|
+
* (`SELECT max(updated_at)`); при расхождении строка перечитывается целиком.
|
|
28
|
+
* Так правка, сделанная другим процессом/репликой, становится видимой без
|
|
29
|
+
* рестарта (с задержкой до TTL), а горячий путь не блокируется.
|
|
30
|
+
*
|
|
31
|
+
* Ошибки фоновой проверки не влияют на чтение: остаётся последний удачный кэш
|
|
32
|
+
* (деградация не превращается в пустой промпт).
|
|
33
|
+
*/
|
|
34
|
+
import { toIso, toIsoRequired } from './events-core.js';
|
|
35
|
+
/** Доменные категории override-файлов (значения колонки `category`). */
|
|
36
|
+
const OVERRIDE_CATEGORIES = ['user', 'role', 'system'];
|
|
37
|
+
/** Период фоновой проверки сигнатуры `updated_at` по умолчанию, мс. */
|
|
38
|
+
const DEFAULT_SIGNATURE_TTL_MS = 5_000;
|
|
39
|
+
/**
|
|
40
|
+
* ADR-116: файлы контекста — системные промпты ФС, пользовательская часть в SQL.
|
|
41
|
+
*/
|
|
42
|
+
export class PgContextFileRepository {
|
|
43
|
+
_deps;
|
|
44
|
+
systemPromptsDir;
|
|
45
|
+
_config;
|
|
46
|
+
_cache = new Map();
|
|
47
|
+
_signatureTtlMs;
|
|
48
|
+
/** Сигнатура последнего успешного чтения (`max(updated_at)` в мс, `'0'` — пусто). */
|
|
49
|
+
_signature = '';
|
|
50
|
+
/** Момент последней фоновой проверки сигнатуры, мс. */
|
|
51
|
+
_lastCheckAt = 0;
|
|
52
|
+
/** Текущая фоновая проверка (одна на процесс). */
|
|
53
|
+
_refreshing = null;
|
|
54
|
+
constructor(_deps, opts) {
|
|
55
|
+
this._deps = _deps;
|
|
56
|
+
this.systemPromptsDir = opts.systemPromptsDir ?? '';
|
|
57
|
+
this._signatureTtlMs = Math.max(0, opts.signatureTtlMs ?? DEFAULT_SIGNATURE_TTL_MS);
|
|
58
|
+
// `this` как источник override: `ContextConfig` читает пользовательские
|
|
59
|
+
// файлы из кэша, системные — из ФС.
|
|
60
|
+
this._config = opts.createConfig(this);
|
|
61
|
+
}
|
|
62
|
+
// ── Контракт `ContextOverrideSourceLike` (то, что читает `ContextConfig`) ──
|
|
63
|
+
has(category, filename) {
|
|
64
|
+
this._scheduleRefresh();
|
|
65
|
+
return this._cache.has(this._key(category, filename));
|
|
66
|
+
}
|
|
67
|
+
read(category, filename) {
|
|
68
|
+
this._scheduleRefresh();
|
|
69
|
+
return this._cache.get(this._key(category, filename))?.content ?? null;
|
|
70
|
+
}
|
|
71
|
+
list() {
|
|
72
|
+
this._scheduleRefresh();
|
|
73
|
+
return [...this._cache.values()].map((entry) => ({
|
|
74
|
+
category: entry.category,
|
|
75
|
+
filename: entry.filename,
|
|
76
|
+
size: entry.size,
|
|
77
|
+
modifiedAt: entry.modifiedAt,
|
|
78
|
+
}));
|
|
79
|
+
}
|
|
80
|
+
// ── Синхронные геттеры порта (делегируются файловой реализации) ───────────
|
|
81
|
+
listAllFiles() {
|
|
82
|
+
return this._config.listAllFiles();
|
|
83
|
+
}
|
|
84
|
+
getFile(filename, category) {
|
|
85
|
+
return this._config.getFile(filename, category);
|
|
86
|
+
}
|
|
87
|
+
getEnabledFiles() {
|
|
88
|
+
return this._config.getEnabledFiles();
|
|
89
|
+
}
|
|
90
|
+
setEnabledFiles(files) {
|
|
91
|
+
this._config.setEnabledFiles(files);
|
|
92
|
+
}
|
|
93
|
+
getRolePrompt(agentId, contextFileOverride, language) {
|
|
94
|
+
return this._config.getRolePrompt(agentId, contextFileOverride, language);
|
|
95
|
+
}
|
|
96
|
+
getRolesDescription(language) {
|
|
97
|
+
return this._config.getRolesDescription(language);
|
|
98
|
+
}
|
|
99
|
+
getInterviewTemplate(language) {
|
|
100
|
+
return this._config.getInterviewTemplate(language);
|
|
101
|
+
}
|
|
102
|
+
getParticipantsNotice(language) {
|
|
103
|
+
return this._config.getParticipantsNotice(language);
|
|
104
|
+
}
|
|
105
|
+
getSchedulerNotice(language) {
|
|
106
|
+
return this._config.getSchedulerNotice(language);
|
|
107
|
+
}
|
|
108
|
+
getSchedulerTurnNotice(language) {
|
|
109
|
+
return this._config.getSchedulerTurnNotice(language);
|
|
110
|
+
}
|
|
111
|
+
getMaxStepsPrompt(language) {
|
|
112
|
+
return this._config.getMaxStepsPrompt(language);
|
|
113
|
+
}
|
|
114
|
+
getSummarizerPrompt(language) {
|
|
115
|
+
return this._config.getSummarizerPrompt(language);
|
|
116
|
+
}
|
|
117
|
+
getUserContextTemplate(language) {
|
|
118
|
+
return this._config.getUserContextTemplate(language);
|
|
119
|
+
}
|
|
120
|
+
getCompressedDialogTemplate(language) {
|
|
121
|
+
return this._config.getCompressedDialogTemplate(language);
|
|
122
|
+
}
|
|
123
|
+
getAttachmentsDroppedTemplate(language) {
|
|
124
|
+
return this._config.getAttachmentsDroppedTemplate(language);
|
|
125
|
+
}
|
|
126
|
+
getMediaDeriveTemplate(language) {
|
|
127
|
+
return this._config.getMediaDeriveTemplate(language);
|
|
128
|
+
}
|
|
129
|
+
getStickyNotesTemplate(language) {
|
|
130
|
+
return this._config.getStickyNotesTemplate(language);
|
|
131
|
+
}
|
|
132
|
+
getRoutingInstructions(language) {
|
|
133
|
+
return this._config.getRoutingInstructions(language);
|
|
134
|
+
}
|
|
135
|
+
getRules(language) {
|
|
136
|
+
return this._config.getRules(language);
|
|
137
|
+
}
|
|
138
|
+
getGatewayInstructions(language) {
|
|
139
|
+
return this._config.getGatewayInstructions(language);
|
|
140
|
+
}
|
|
141
|
+
getMemoryInstructions(language) {
|
|
142
|
+
return this._config.getMemoryInstructions(language);
|
|
143
|
+
}
|
|
144
|
+
getSecurityMessage(messageId, language, params) {
|
|
145
|
+
return this._config.getSecurityMessage(messageId, language, params);
|
|
146
|
+
}
|
|
147
|
+
getModePrompt(mode, language) {
|
|
148
|
+
return this._config.getModePrompt(mode, language);
|
|
149
|
+
}
|
|
150
|
+
getPlanModePrompt(planMode, planApproved, language) {
|
|
151
|
+
return this._config.getPlanModePrompt(planMode, planApproved, language);
|
|
152
|
+
}
|
|
153
|
+
getPlanGuide(language) {
|
|
154
|
+
return this._config.getPlanGuide(language);
|
|
155
|
+
}
|
|
156
|
+
getModePolicy(language) {
|
|
157
|
+
return this._config.getModePolicy(language);
|
|
158
|
+
}
|
|
159
|
+
getClassificationInstructions(language) {
|
|
160
|
+
return this._config.getClassificationInstructions(language);
|
|
161
|
+
}
|
|
162
|
+
// ── Запись (пользовательская часть — SQL) ─────────────────────────────────
|
|
163
|
+
async saveFile(filename, content, category) {
|
|
164
|
+
try {
|
|
165
|
+
await this._deps.connection.query(`INSERT INTO context_files (category, filename, content, updated_at)
|
|
166
|
+
VALUES ($1, $2, $3, now())
|
|
167
|
+
ON CONFLICT (category, filename) DO UPDATE SET
|
|
168
|
+
content = EXCLUDED.content,
|
|
169
|
+
updated_at = now()`, [category, filename, content]);
|
|
170
|
+
// Кэш и сигнатура — сразу после записи: следующий синхронный геттер видит
|
|
171
|
+
// новое содержимое без ожидания TTL.
|
|
172
|
+
await this.warm();
|
|
173
|
+
return true;
|
|
174
|
+
}
|
|
175
|
+
catch {
|
|
176
|
+
return false;
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
async deleteFile(filename, category) {
|
|
180
|
+
try {
|
|
181
|
+
const rows = await this._deps.connection.query('DELETE FROM context_files WHERE category = $1 AND filename = $2 RETURNING filename', [category, filename]);
|
|
182
|
+
if (rows.length === 0)
|
|
183
|
+
return false;
|
|
184
|
+
await this.warm();
|
|
185
|
+
return true;
|
|
186
|
+
}
|
|
187
|
+
catch {
|
|
188
|
+
return false;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
/** «Восстановить системный файл» = снять пользовательский override. */
|
|
192
|
+
async restoreFile(filename, category) {
|
|
193
|
+
return this.deleteFile(filename, category);
|
|
194
|
+
}
|
|
195
|
+
// ── Кэш и инвалидация ────────────────────────────────────────────────────
|
|
196
|
+
/**
|
|
197
|
+
* Прогрев кэша: чтение всех пользовательских файлов + фиксация сигнатуры.
|
|
198
|
+
* Вызывается при сборке контекста (`initialize`) и после каждой записи.
|
|
199
|
+
*/
|
|
200
|
+
async warm() {
|
|
201
|
+
const rows = await this._deps.connection.query('SELECT category, filename, content, updated_at FROM context_files');
|
|
202
|
+
this._cache.clear();
|
|
203
|
+
let maxUpdatedAt = 0;
|
|
204
|
+
for (const row of rows) {
|
|
205
|
+
const category = row.category;
|
|
206
|
+
if (!OVERRIDE_CATEGORIES.includes(category))
|
|
207
|
+
continue;
|
|
208
|
+
const updatedAt = Date.parse(toIsoRequired(row.updated_at));
|
|
209
|
+
const modifiedAt = Number.isFinite(updatedAt) ? updatedAt : 0;
|
|
210
|
+
maxUpdatedAt = Math.max(maxUpdatedAt, modifiedAt);
|
|
211
|
+
this._cache.set(this._key(category, row.filename), {
|
|
212
|
+
category,
|
|
213
|
+
filename: row.filename,
|
|
214
|
+
content: row.content,
|
|
215
|
+
size: Buffer.byteLength(row.content, 'utf-8'),
|
|
216
|
+
modifiedAt,
|
|
217
|
+
});
|
|
218
|
+
}
|
|
219
|
+
this._signature = String(maxUpdatedAt);
|
|
220
|
+
}
|
|
221
|
+
/** Стартовый прогрев без падения старта: ошибка БД — пустой кэш + предупреждение. */
|
|
222
|
+
async initialize() {
|
|
223
|
+
try {
|
|
224
|
+
await this.warm();
|
|
225
|
+
}
|
|
226
|
+
catch (err) {
|
|
227
|
+
console.warn(`[context-files] прогрев кэша не удался: ${err instanceof Error ? err.message : String(err)}`);
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
/** Дождаться текущей фоновой проверки сигнатуры (graceful shutdown/тесты). */
|
|
231
|
+
async pendingRefresh() {
|
|
232
|
+
await this._refreshing;
|
|
233
|
+
}
|
|
234
|
+
_key(category, filename) {
|
|
235
|
+
return `${category}\0${filename}`;
|
|
236
|
+
}
|
|
237
|
+
/**
|
|
238
|
+
* Запустить фоновую проверку сигнатуры, если с прошлой прошло `signatureTtlMs`
|
|
239
|
+
* (и другая ещё не идёт). Синхронный геттер не блокируется.
|
|
240
|
+
*/
|
|
241
|
+
_scheduleRefresh() {
|
|
242
|
+
if (this._refreshing)
|
|
243
|
+
return;
|
|
244
|
+
const now = Date.now();
|
|
245
|
+
if (now - this._lastCheckAt < this._signatureTtlMs)
|
|
246
|
+
return;
|
|
247
|
+
this._lastCheckAt = now;
|
|
248
|
+
const task = this._refreshIfStale().catch(() => undefined);
|
|
249
|
+
this._refreshing = task;
|
|
250
|
+
// `close()` контекста дожидается фоновых задач до закрытия пула.
|
|
251
|
+
this._deps.trackBackground?.(task);
|
|
252
|
+
void task.finally(() => {
|
|
253
|
+
if (this._refreshing === task)
|
|
254
|
+
this._refreshing = null;
|
|
255
|
+
});
|
|
256
|
+
}
|
|
257
|
+
/** Перечитать строки, если `max(updated_at)` разошёлся с кэшем. */
|
|
258
|
+
async _refreshIfStale() {
|
|
259
|
+
const signature = await this._readSignature();
|
|
260
|
+
if (signature === this._signature)
|
|
261
|
+
return;
|
|
262
|
+
await this.warm();
|
|
263
|
+
}
|
|
264
|
+
/** Сигнатура таблицы: `max(updated_at)` в миллисекундах (`0` — пусто). */
|
|
265
|
+
async _readSignature() {
|
|
266
|
+
const rows = await this._deps.connection.query('SELECT max(updated_at) AS max FROM context_files');
|
|
267
|
+
const iso = toIso(rows[0]?.max ?? null);
|
|
268
|
+
return iso ? String(Date.parse(iso)) : '0';
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
/**
|
|
272
|
+
* Собрать порт файлов контекста (ADR-116): системные промпты — ФС, пользовательская
|
|
273
|
+
* часть — SQL. Кэш прогревается в фоне при сборке контекста.
|
|
274
|
+
*/
|
|
275
|
+
export function buildContextFilePorts(deps, opts) {
|
|
276
|
+
const port = new PgContextFileRepository(deps, opts);
|
|
277
|
+
deps.trackBackground?.(port.initialize());
|
|
278
|
+
return { contextFiles: port };
|
|
279
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Резолвинг синхронных данных/хелперов core для sync-геттеров портов
|
|
3
|
+
* (ADR-097, волна 3b).
|
|
4
|
+
*
|
|
5
|
+
* `@itphx/synth-core` — `peerDependencies` драйвера и подключается только ленивым
|
|
6
|
+
* `import()` (цикл core ↔ драйвер: core динамически грузит драйвер по
|
|
7
|
+
* `storage.backend === 'postgres'`), поэтому статический рантайм-импорт core здесь
|
|
8
|
+
* недопустим. При штатной сборке через core значения инъектируются в конфиг
|
|
9
|
+
* драйвера (`packages/core/src/storage/storage-context.ts`); при прямом вызове
|
|
10
|
+
* `createPostgresStorage` (контрактный suite, внешний потребитель) тот же набор
|
|
11
|
+
* собирается здесь — sync-геттеры иначе не получили бы доступ к данным core.
|
|
12
|
+
*/
|
|
13
|
+
import type { CoreSyncDeps } from './deps.js';
|
|
14
|
+
/**
|
|
15
|
+
* Каталог-заглушка пользовательских словарей: реальный override живёт в БД
|
|
16
|
+
* (`settings`), файловый каталог пользователя намеренно пуст.
|
|
17
|
+
*/
|
|
18
|
+
export declare const POSTGRES_EMPTY_USER_DICTIONARIES_SUBDIR = "storage-postgres/no-user-dictionaries";
|
|
19
|
+
/** Параметры сборки sync-данных core. */
|
|
20
|
+
export interface CoreSyncResolveOptions {
|
|
21
|
+
dataDir: string;
|
|
22
|
+
/** Каталог системных словарей (по умолчанию — `dictionaries/` пакета core). */
|
|
23
|
+
systemDictionariesDir?: string;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Собрать `CoreSyncDeps` ленивым `import('@itphx/synth-core')`.
|
|
27
|
+
*
|
|
28
|
+
* Используется только когда core не передал значения явно (прямой вызов фабрики);
|
|
29
|
+
* ошибки загрузки core не глушатся — без них sync-геттеры вернули бы неполные данные.
|
|
30
|
+
*/
|
|
31
|
+
export declare function resolveCoreSyncDeps(opts: CoreSyncResolveOptions): Promise<CoreSyncDeps>;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Резолвинг синхронных данных/хелперов core для sync-геттеров портов
|
|
3
|
+
* (ADR-097, волна 3b).
|
|
4
|
+
*
|
|
5
|
+
* `@itphx/synth-core` — `peerDependencies` драйвера и подключается только ленивым
|
|
6
|
+
* `import()` (цикл core ↔ драйвер: core динамически грузит драйвер по
|
|
7
|
+
* `storage.backend === 'postgres'`), поэтому статический рантайм-импорт core здесь
|
|
8
|
+
* недопустим. При штатной сборке через core значения инъектируются в конфиг
|
|
9
|
+
* драйвера (`packages/core/src/storage/storage-context.ts`); при прямом вызове
|
|
10
|
+
* `createPostgresStorage` (контрактный suite, внешний потребитель) тот же набор
|
|
11
|
+
* собирается здесь — sync-геттеры иначе не получили бы доступ к данным core.
|
|
12
|
+
*/
|
|
13
|
+
import { join } from 'node:path';
|
|
14
|
+
/**
|
|
15
|
+
* Каталог-заглушка пользовательских словарей: реальный override живёт в БД
|
|
16
|
+
* (`settings`), файловый каталог пользователя намеренно пуст.
|
|
17
|
+
*/
|
|
18
|
+
export const POSTGRES_EMPTY_USER_DICTIONARIES_SUBDIR = 'storage-postgres/no-user-dictionaries';
|
|
19
|
+
/**
|
|
20
|
+
* Собрать `CoreSyncDeps` ленивым `import('@itphx/synth-core')`.
|
|
21
|
+
*
|
|
22
|
+
* Используется только когда core не передал значения явно (прямой вызов фабрики);
|
|
23
|
+
* ошибки загрузки core не глушатся — без них sync-геттеры вернули бы неполные данные.
|
|
24
|
+
*/
|
|
25
|
+
export async function resolveCoreSyncDeps(opts) {
|
|
26
|
+
const core = await import('@itphx/synth-core');
|
|
27
|
+
const secretPatterns = core.DEFAULT_PATTERNS.map((pattern) => ({
|
|
28
|
+
type: pattern.type,
|
|
29
|
+
regex: typeof pattern.regex === 'string' ? pattern.regex : pattern.regex.source,
|
|
30
|
+
}));
|
|
31
|
+
const protectedPathsBase = core.loadProtectedPaths({ overridePath: '' });
|
|
32
|
+
const systemDictionaries = new core.DictionaryStore(join(opts.dataDir, POSTGRES_EMPTY_USER_DICTIONARIES_SUBDIR), opts.systemDictionariesDir);
|
|
33
|
+
return { secretPatterns, protectedPathsBase, systemDictionaries };
|
|
34
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Порт журнала операций со слоем доступов PostgreSQL-драйвера (ADR-105 Ф4,
|
|
3
|
+
* ADR-097).
|
|
4
|
+
*
|
|
5
|
+
* Отдельная append-only таблица `credential_audit` (`seq bigserial` — порядок
|
|
6
|
+
* «свежие первыми»). Семантика — как у файловой реализации core
|
|
7
|
+
* (`FileCredentialAuditStore`): append, выборка «свежие первыми» с фильтрами
|
|
8
|
+
* `credentialId`/`provider`/`op`/`outcome`/`limit`, очистка с числом удалённых.
|
|
9
|
+
*
|
|
10
|
+
* **Секретов в таблице нет**: ни значения токена, ни `secret_enc`/`refresh_enc`
|
|
11
|
+
* (они лежат в отдельной таблице `external_credentials`), ни сырых путей и id
|
|
12
|
+
* сессий/пользователей (ADR-105 §7).
|
|
13
|
+
*/
|
|
14
|
+
import type { StorageContext } from '@itphx/synth-core';
|
|
15
|
+
import type { PortDeps } from './deps.js';
|
|
16
|
+
/** Часть `StorageContext`, которой владеет модуль журнала доступов. */
|
|
17
|
+
export type CredentialAuditPorts = Pick<StorageContext, 'credentialAudit'>;
|
|
18
|
+
/** Собрать порт журнала операций со слоем доступов. */
|
|
19
|
+
export declare function buildCredentialAuditPorts(deps: PortDeps): CredentialAuditPorts;
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Порт журнала операций со слоем доступов PostgreSQL-драйвера (ADR-105 Ф4,
|
|
3
|
+
* ADR-097).
|
|
4
|
+
*
|
|
5
|
+
* Отдельная append-only таблица `credential_audit` (`seq bigserial` — порядок
|
|
6
|
+
* «свежие первыми»). Семантика — как у файловой реализации core
|
|
7
|
+
* (`FileCredentialAuditStore`): append, выборка «свежие первыми» с фильтрами
|
|
8
|
+
* `credentialId`/`provider`/`op`/`outcome`/`limit`, очистка с числом удалённых.
|
|
9
|
+
*
|
|
10
|
+
* **Секретов в таблице нет**: ни значения токена, ни `secret_enc`/`refresh_enc`
|
|
11
|
+
* (они лежат в отдельной таблице `external_credentials`), ни сырых путей и id
|
|
12
|
+
* сессий/пользователей (ADR-105 §7).
|
|
13
|
+
*/
|
|
14
|
+
function toISO(value) {
|
|
15
|
+
if (value instanceof Date)
|
|
16
|
+
return value.toISOString();
|
|
17
|
+
return String(value);
|
|
18
|
+
}
|
|
19
|
+
function credentialAuditRowToEntry(row) {
|
|
20
|
+
const entry = {
|
|
21
|
+
id: row.id,
|
|
22
|
+
ts: toISO(row.ts),
|
|
23
|
+
op: row.op,
|
|
24
|
+
credentialId: row.credential_id,
|
|
25
|
+
provider: row.provider,
|
|
26
|
+
outcome: row.outcome,
|
|
27
|
+
};
|
|
28
|
+
if (row.error_code !== null)
|
|
29
|
+
entry.errorCode = row.error_code;
|
|
30
|
+
if (row.connector_id !== null)
|
|
31
|
+
entry.connectorId = row.connector_id;
|
|
32
|
+
return entry;
|
|
33
|
+
}
|
|
34
|
+
/** Реализация порта `CredentialAuditRepository` поверх SQL. */
|
|
35
|
+
class PostgresCredentialAuditRepository {
|
|
36
|
+
_deps;
|
|
37
|
+
constructor(_deps) {
|
|
38
|
+
this._deps = _deps;
|
|
39
|
+
}
|
|
40
|
+
_db() {
|
|
41
|
+
return this._deps.connection;
|
|
42
|
+
}
|
|
43
|
+
async append(entry) {
|
|
44
|
+
await this._db().query(`INSERT INTO credential_audit
|
|
45
|
+
(id, ts, op, credential_id, provider, outcome, error_code, connector_id)
|
|
46
|
+
VALUES ($1,$2,$3,$4,$5,$6,$7,$8)`, [
|
|
47
|
+
entry.id,
|
|
48
|
+
entry.ts,
|
|
49
|
+
entry.op,
|
|
50
|
+
entry.credentialId,
|
|
51
|
+
entry.provider,
|
|
52
|
+
entry.outcome,
|
|
53
|
+
entry.errorCode ?? null,
|
|
54
|
+
entry.connectorId ?? null,
|
|
55
|
+
]);
|
|
56
|
+
}
|
|
57
|
+
async list(opts = {}) {
|
|
58
|
+
const params = [];
|
|
59
|
+
const clauses = [];
|
|
60
|
+
if (opts.credentialId !== undefined) {
|
|
61
|
+
params.push(opts.credentialId);
|
|
62
|
+
clauses.push(`credential_id = $${params.length}`);
|
|
63
|
+
}
|
|
64
|
+
if (opts.provider !== undefined) {
|
|
65
|
+
params.push(opts.provider);
|
|
66
|
+
clauses.push(`provider = $${params.length}`);
|
|
67
|
+
}
|
|
68
|
+
if (opts.op !== undefined) {
|
|
69
|
+
params.push(opts.op);
|
|
70
|
+
clauses.push(`op = $${params.length}`);
|
|
71
|
+
}
|
|
72
|
+
if (opts.outcome !== undefined) {
|
|
73
|
+
params.push(opts.outcome);
|
|
74
|
+
clauses.push(`outcome = $${params.length}`);
|
|
75
|
+
}
|
|
76
|
+
const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
|
|
77
|
+
let limit = '';
|
|
78
|
+
if (opts.limit !== undefined && Number.isFinite(opts.limit) && opts.limit > 0) {
|
|
79
|
+
params.push(Math.floor(opts.limit));
|
|
80
|
+
limit = `LIMIT $${params.length}::int`;
|
|
81
|
+
}
|
|
82
|
+
const rows = await this._db().query(`SELECT * FROM credential_audit ${where} ORDER BY seq DESC ${limit}`, params);
|
|
83
|
+
return rows.map(credentialAuditRowToEntry);
|
|
84
|
+
}
|
|
85
|
+
async clear() {
|
|
86
|
+
const rows = await this._db().query('WITH deleted AS (DELETE FROM credential_audit RETURNING 1) SELECT count(*)::int AS n FROM deleted');
|
|
87
|
+
const value = rows[0]?.n;
|
|
88
|
+
return typeof value === 'number' ? value : Number(value) || 0;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
/** Собрать порт журнала операций со слоем доступов. */
|
|
92
|
+
export function buildCredentialAuditPorts(deps) {
|
|
93
|
+
return {
|
|
94
|
+
credentialAudit: new PostgresCredentialAuditRepository(deps),
|
|
95
|
+
};
|
|
96
|
+
}
|