agent-steward 0.0.2 → 0.0.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/CHANGELOG.md +45 -2
- package/CROSS_PLATFORM.md +11 -9
- package/README.md +11 -10
- package/ROADMAP-STRATEGY.md +93 -44
- package/ROADMAP.md +148 -1017
- package/dist/core/cron-to-schtasks.d.ts +0 -8
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +11 -86
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +19 -2
- package/dist/core/file-watcher.js +9 -9
- package/dist/core/git-trigger.js +4 -4
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +99 -26
- package/dist/core/one-shot.d.ts +31 -5
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +78 -10
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/otel.js +2 -2
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +66 -36
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +78 -54
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +36 -2
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +98 -12
- package/dist/core/scheduler/at-fallback.d.ts +95 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +200 -0
- package/dist/core/scheduler/linux.d.ts +13 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +67 -13
- package/dist/core/scheduler/mac.d.ts +14 -8
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +71 -22
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +37 -2
- package/dist/core/scheduler/registry.d.ts +13 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/scheduler/windows.d.ts +16 -3
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +249 -96
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +127 -30
- package/dist/core/self-analysis.js +55 -55
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/summary.js +1 -1
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/triage-chain.js +1 -1
- package/dist/core/triage-worker.js +2 -2
- package/dist/core/triage.js +1 -1
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +82 -37
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +6 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +48 -2
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +51 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +156 -0
- package/dist/db/runs-repo.d.ts +128 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +342 -0
- package/dist/db/schema.d.ts +16 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +342 -35
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +5 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +168 -40
- package/dist/notifications.js +18 -18
- package/dist/profiles.d.ts +7 -3
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +85 -7
- package/dist/rpc.d.ts +787 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +324 -0
- package/dist/server.d.ts +33 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +115 -54
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/skill.js +1 -1
- package/dist/task-transfer.d.ts +1 -1
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +14 -10
- package/dist/types.d.ts +20 -4
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +44 -9
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +44 -9
- package/docs/ARCHITECTURE.md +335 -9
- package/docs/COMPATIBILITY.md +10 -6
- package/docs/CONCEPT.md +183 -91
- package/docs/CROSS_PLATFORM.ru.md +11 -9
- package/docs/CROSS_PLATFORM.zh.md +11 -9
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/FAQ.md +2 -2
- package/docs/FAQ.ru.md +2 -2
- package/docs/FAQ.zh.md +2 -2
- package/docs/FEATURES.md +5 -4
- package/docs/FEATURES.zh.md +5 -4
- package/docs/MIGRATION.md +34 -26
- package/docs/README.ru.md +27 -8
- package/docs/README.zh.md +11 -10
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
- package/gui-experimental.cjs +8 -8
- package/index.js +1 -0
- package/locales/en.json +68 -0
- package/locales/ru.json +68 -0
- package/locales/zh.json +68 -0
- package/package.json +57 -11
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/analytics.ts +2 -2
- package/src/core/audit.ts +17 -17
- package/src/core/cron-to-schtasks.ts +14 -93
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +51 -27
- package/src/core/file-watcher.ts +17 -17
- package/src/core/git-trigger.ts +9 -9
- package/src/core/glob.ts +1 -1
- package/src/core/local-ai.ts +2 -2
- package/src/core/lock.ts +104 -31
- package/src/core/matrix.ts +31 -31
- package/src/core/native-notify.ts +2 -2
- package/src/core/one-shot.ts +91 -13
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/otel.ts +4 -4
- package/src/core/permissions.ts +5 -5
- package/src/core/prometheus.ts +17 -17
- package/src/core/ps-wrapper.ts +68 -38
- package/src/core/record-history.ts +114 -76
- package/src/core/retention.ts +3 -3
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/savings.ts +1 -1
- package/src/core/schedule-gate.ts +17 -13
- package/src/core/schedule-v2.ts +138 -29
- package/src/core/scheduler/at-fallback.ts +298 -0
- package/src/core/scheduler/index.ts +3 -3
- package/src/core/scheduler/linux.ts +92 -19
- package/src/core/scheduler/logs.ts +1 -1
- package/src/core/scheduler/mac.ts +112 -60
- package/src/core/scheduler/posix.ts +35 -2
- package/src/core/scheduler/registry.ts +109 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/scheduler/windows.ts +295 -125
- package/src/core/secrets.ts +139 -39
- package/src/core/self-analysis.ts +61 -61
- package/src/core/session.ts +26 -13
- package/src/core/structured-log.ts +3 -3
- package/src/core/summary.ts +25 -25
- package/src/core/task-name.ts +67 -0
- package/src/core/telegram.ts +16 -16
- package/src/core/triage-chain.ts +4 -4
- package/src/core/triage-compare.ts +8 -8
- package/src/core/triage-rules.ts +4 -4
- package/src/core/triage-shadow.ts +7 -7
- package/src/core/triage-worker.ts +6 -6
- package/src/core/triage.ts +23 -23
- package/src/core/watch-paths.ts +1 -1
- package/src/core/wrappers/bash.ts +90 -45
- package/src/db/capability-repo.ts +285 -0
- package/src/db/git-state-repo.ts +1 -1
- package/src/db/history-repo.ts +44 -22
- package/src/db/index.ts +53 -7
- package/src/db/metrics-repo.ts +10 -10
- package/src/db/migrate.ts +13 -11
- package/src/db/recovery.ts +3 -3
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +256 -0
- package/src/db/runs-repo.ts +504 -0
- package/src/db/schema.ts +357 -44
- package/src/db/settings-repo.ts +33 -2
- package/src/db/step-idempotency.ts +185 -0
- package/src/db/tasks-repo.ts +10 -10
- package/src/db/templates-repo.ts +7 -7
- package/src/gui.tsx +516 -1
- package/src/history.ts +4 -4
- package/src/i18n.ts +7 -7
- package/src/index.ts +465 -308
- package/src/integrations.ts +6 -6
- package/src/notifications.ts +76 -76
- package/src/profiles.ts +98 -7
- package/src/rpc.ts +347 -1
- package/src/schtasks.ts +2 -2
- package/src/server.ts +155 -78
- package/src/settings.ts +44 -44
- package/src/shared/jobs-view.ts +60 -60
- package/src/skill.ts +1 -1
- package/src/task-transfer.ts +58 -56
- package/src/templates.ts +1 -1
- package/src/types.ts +54 -10
- package/src/workspaces.ts +73 -24
- package/dist/core/self-analysis.test.d.ts +0 -2
- package/dist/core/self-analysis.test.d.ts.map +0 -1
- package/dist/core/self-analysis.test.js +0 -219
- package/dist/gui-experimental.cjs +0 -1
package/dist/types.js
CHANGED
|
@@ -1,20 +1,27 @@
|
|
|
1
1
|
import path from "node:path";
|
|
2
2
|
import { z } from "zod";
|
|
3
3
|
import { getProfileDir, getProfileName } from "./profiles.js";
|
|
4
|
-
/** Префикс всех задач плагина (историческое имя, сохраняется для совместимости). */
|
|
5
|
-
export const TASK_PREFIX = "OpenCode\\windows-scheduler";
|
|
6
4
|
/** Папка задач плагина в планировщике ОС (Windows). */
|
|
7
5
|
export const TASK_FOLDER = "OpenCode";
|
|
8
6
|
/**
|
|
9
7
|
* Имя папки/блока задач. У нестандартного профиля своё пространство имён,
|
|
10
8
|
* иначе профили делят одну папку Планировщика Windows и один блок crontab.
|
|
11
|
-
*
|
|
12
|
-
*
|
|
9
|
+
* Новое имя — agent-steward; историческое windows-scheduler поддерживается
|
|
10
|
+
* как legacy (см. legacyTaskFolderNameForProfile).
|
|
13
11
|
*/
|
|
14
12
|
export function taskFolderNameForProfile(profile = getProfileName()) {
|
|
13
|
+
return profile === "default" ? "agent-steward" : `agent-steward-${profile}`;
|
|
14
|
+
}
|
|
15
|
+
/** Историческое имя папки/блока задач — для чтения и удаления старых задач. */
|
|
16
|
+
export function legacyTaskFolderNameForProfile(profile = getProfileName()) {
|
|
15
17
|
return profile === "default" ? "windows-scheduler" : `windows-scheduler-${profile}`;
|
|
16
18
|
}
|
|
17
19
|
export const TASK_FOLDER_NAME = taskFolderNameForProfile();
|
|
20
|
+
export const LEGACY_TASK_FOLDER_NAME = legacyTaskFolderNameForProfile();
|
|
21
|
+
/** Префикс всех задач плагина. */
|
|
22
|
+
export const TASK_PREFIX = `OpenCode\\${TASK_FOLDER_NAME}`;
|
|
23
|
+
/** Исторический префикс задач (до переименования). */
|
|
24
|
+
export const LEGACY_TASK_PREFIX = `OpenCode\\${LEGACY_TASK_FOLDER_NAME}`;
|
|
18
25
|
/**
|
|
19
26
|
* Директория для хранения файлов плагина (обёртки, логи, блокировки, история).
|
|
20
27
|
*
|
|
@@ -53,6 +60,27 @@ export function sanitizeName(name) {
|
|
|
53
60
|
result = result.replace(/-+/g, "-").replace(/^-+|-+$/g, "");
|
|
54
61
|
return result || "task";
|
|
55
62
|
}
|
|
63
|
+
/**
|
|
64
|
+
* Проверяет идентификатор LLM-модели перед подстановкой в командную строку.
|
|
65
|
+
*
|
|
66
|
+
* Формат: `provider/model` (вариант — `provider/model#variant`).
|
|
67
|
+
* Разрешены только латиница, цифры и символы `. _ : / -` (плюс `#` для
|
|
68
|
+
* варианта). Это исключает PowerShell-subexpression (`$(...)`, backtick)
|
|
69
|
+
* и прочие спецсимволы. Пустая строка — «модель не задана», это допустимо.
|
|
70
|
+
*
|
|
71
|
+
* @returns текст ошибки или null, если значение допустимо.
|
|
72
|
+
*/
|
|
73
|
+
export function validateModelId(raw) {
|
|
74
|
+
const model = raw.trim();
|
|
75
|
+
if (!model)
|
|
76
|
+
return null;
|
|
77
|
+
if (!/^[A-Za-z0-9._:/-]+(?:#[A-Za-z0-9._-]+)?$/.test(model)) {
|
|
78
|
+
return (`Недопустимый идентификатор модели «${raw}». ` +
|
|
79
|
+
"Разрешены латиница, цифры и символы «.», «_», «:», «/», «-» " +
|
|
80
|
+
"(вариант — через «#»).");
|
|
81
|
+
}
|
|
82
|
+
return null;
|
|
83
|
+
}
|
|
56
84
|
/**
|
|
57
85
|
* Проверяет имя задачи до создания файлов и записи в БД.
|
|
58
86
|
*
|
|
@@ -68,10 +96,17 @@ export function validateTaskName(raw) {
|
|
|
68
96
|
if (!name) {
|
|
69
97
|
return "Имя задачи не может быть пустым.";
|
|
70
98
|
}
|
|
99
|
+
// P1-10.T1.3: имена из одних разделителей («---», «...», «.») после
|
|
100
|
+
// sanitizeName превращаются в «task» и молча конфликтуют с реальной
|
|
101
|
+
// задачей «task». Требуем хотя бы одну букву или цифру.
|
|
102
|
+
if (!/[\p{L}\p{N}]/u.test(name)) {
|
|
103
|
+
return (`Имя задачи «${name}» не содержит букв или цифр: после нормализации ` +
|
|
104
|
+
"оно стало бы «task». Добавьте буквы или цифры.");
|
|
105
|
+
}
|
|
71
106
|
if (/[\u0000-\u001f\u007f]/.test(name)) {
|
|
72
107
|
return "Имя задачи не должно содержать управляющие символы.";
|
|
73
108
|
}
|
|
74
|
-
const invalid =
|
|
109
|
+
const invalid = /[^\p{L}\p{N}_\-. ]/u.exec(name);
|
|
75
110
|
if (invalid) {
|
|
76
111
|
return (`Имя задачи содержит недопустимый символ «${invalid[0]}». ` +
|
|
77
112
|
"Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».");
|
|
@@ -79,13 +114,13 @@ export function validateTaskName(raw) {
|
|
|
79
114
|
// schtasks ограничивает /tn в 237 символов вместе с полным путём задачи.
|
|
80
115
|
// Полный путь: \OpenCode\<TASK_FOLDER_NAME>\<taskName>
|
|
81
116
|
// leading \ + TASK_FOLDER + \ + TASK_FOLDER_NAME + \ — префикс перед именем задачи.
|
|
82
|
-
// Для default: \OpenCode\
|
|
83
|
-
// Для не-default профиля: \OpenCode\
|
|
117
|
+
// Для default: \OpenCode\agent-steward\ = 24 символа → 213 на имя.
|
|
118
|
+
// Для не-default профиля: \OpenCode\agent-steward-<profile>\ → чем длиннее профиль, тем меньше места.
|
|
84
119
|
const prefixLength = 1 + TASK_FOLDER.length + 1 + TASK_FOLDER_NAME.length + 1;
|
|
85
120
|
const MAX_TASK_NAME_LENGTH = 237 - prefixLength;
|
|
86
121
|
if (name.length > MAX_TASK_NAME_LENGTH) {
|
|
87
122
|
return (`Имя задачи "${name}" слишком длинное (${name.length} символов, максимум ${MAX_TASK_NAME_LENGTH} ` +
|
|
88
|
-
|
|
123
|
+
"с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).");
|
|
89
124
|
}
|
|
90
125
|
return null;
|
|
91
126
|
}
|
|
@@ -103,7 +138,7 @@ export const ScheduleJobArgs = z.object({
|
|
|
103
138
|
ctx.addIssue({ code: z.ZodIssueCode.custom, message: error });
|
|
104
139
|
}
|
|
105
140
|
})
|
|
106
|
-
.describe("Имя задачи (уникально в рамках префикса OpenCode\\windows-scheduler)"),
|
|
141
|
+
.describe("Имя задачи (уникально в рамках префикса OpenCode\\agent-steward; legacy OpenCode\\windows-scheduler поддерживается)"),
|
|
107
142
|
schedule: z
|
|
108
143
|
.string()
|
|
109
144
|
.min(1)
|
package/dist/workspaces.d.ts
CHANGED
|
@@ -48,11 +48,28 @@ export declare function normalizeWorkspaceEnv(value: unknown): Record<string, st
|
|
|
48
48
|
export declare function parseEnvFileContent(content: string): Record<string, string>;
|
|
49
49
|
/** Читает .env-файл workspace (если он задан и существует). */
|
|
50
50
|
export declare function readWorkspaceEnvFile(envFile?: string): Record<string, string>;
|
|
51
|
+
/** Ошибка конфигурации: в env workspace остались неразрешённые `${secret:NAME}`. */
|
|
52
|
+
export declare class MissingWorkspaceSecretsError extends Error {
|
|
53
|
+
readonly workspaceName: string;
|
|
54
|
+
readonly secrets: string[];
|
|
55
|
+
constructor(workspaceName: string, secrets: string[]);
|
|
56
|
+
}
|
|
57
|
+
interface ResolvedWorkspaceEnv {
|
|
58
|
+
env: Record<string, string>;
|
|
59
|
+
missing: string[];
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Итоговые env-переменные workspace вместе со списком отсутствующих секретов.
|
|
63
|
+
* Ссылки `${secret:NAME}` не подменяются пустой строкой: имя попадает в
|
|
64
|
+
* `missing`, а сама ссылка остаётся в env — вызывающая сторона решает,
|
|
65
|
+
* прервать запуск или только предупредить.
|
|
66
|
+
*/
|
|
67
|
+
export declare function resolveWorkspaceEnvDetailed(workspace: Workspace | undefined, allowedSecretNames?: string[]): ResolvedWorkspaceEnv;
|
|
51
68
|
/**
|
|
52
69
|
* Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
|
|
53
|
-
* (пары важнее файла).
|
|
54
|
-
*
|
|
55
|
-
*
|
|
70
|
+
* (пары важнее файла). Отсутствующий секрет даёт предупреждение с именем,
|
|
71
|
+
* но не значение. Никогда не бросает — для запуска задачи используйте
|
|
72
|
+
* writeWorkspaceEnvFile(), который в этом случае отказывает.
|
|
56
73
|
*/
|
|
57
74
|
export declare function resolveWorkspaceEnv(workspace: Workspace | undefined, allowedSecretNames?: string[]): Record<string, string>;
|
|
58
75
|
/** Маскирует значение секрета для логов. */
|
|
@@ -73,6 +90,10 @@ export declare function workspaceEnvDir(pluginDir: string): string;
|
|
|
73
90
|
*
|
|
74
91
|
* Возвращает путь к файлу или undefined, если у workspace нет переменных.
|
|
75
92
|
* Пустой env удаляет ранее созданный файл. На POSIX права 0600.
|
|
93
|
+
*
|
|
94
|
+
* Если хотя бы один `${secret:NAME}` не разрешён, старый env-файл удаляется
|
|
95
|
+
* и бросается MissingWorkspaceSecretsError: задача не должна запускаться с
|
|
96
|
+
* литералом `${secret:...}` вместо значения (P2-21).
|
|
76
97
|
*/
|
|
77
98
|
export declare function writeWorkspaceEnvFile(workspace: Workspace | undefined, pluginDir: string, sanitizedName: string, allowedSecretNames?: string[]): string | undefined;
|
|
78
99
|
/** Проверяет, что путь существует и является директорией. */
|
|
@@ -110,4 +131,5 @@ export declare function updateWorkspace(id: string, patch: UpdateWorkspacePatch)
|
|
|
110
131
|
export declare function deleteWorkspace(id: string): boolean;
|
|
111
132
|
/** Количество workspace (для сводок и тестов). */
|
|
112
133
|
export declare function countWorkspaces(): number;
|
|
134
|
+
export {};
|
|
113
135
|
//# sourceMappingURL=workspaces.d.ts.map
|
package/dist/workspaces.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,UAO5B,CAAC;AAIF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA6BpC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsB3E;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,
|
|
1
|
+
{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}
|
package/dist/workspaces.js
CHANGED
|
@@ -87,22 +87,42 @@ export function readWorkspaceEnvFile(envFile) {
|
|
|
87
87
|
return {};
|
|
88
88
|
}
|
|
89
89
|
}
|
|
90
|
+
/** Ошибка конфигурации: в env workspace остались неразрешённые `${secret:NAME}`. */
|
|
91
|
+
export class MissingWorkspaceSecretsError extends Error {
|
|
92
|
+
constructor(workspaceName, secrets) {
|
|
93
|
+
super(`Workspace "${workspaceName}": не найдены секреты: ${secrets.join(", ")}. ` +
|
|
94
|
+
"Запуск отменён, чтобы не подставлять литералы ${secret:...} в окружение задачи.");
|
|
95
|
+
this.name = "MissingWorkspaceSecretsError";
|
|
96
|
+
this.workspaceName = workspaceName;
|
|
97
|
+
this.secrets = secrets;
|
|
98
|
+
}
|
|
99
|
+
}
|
|
90
100
|
/**
|
|
91
|
-
* Итоговые env-переменные workspace
|
|
92
|
-
*
|
|
93
|
-
*
|
|
94
|
-
*
|
|
101
|
+
* Итоговые env-переменные workspace вместе со списком отсутствующих секретов.
|
|
102
|
+
* Ссылки `${secret:NAME}` не подменяются пустой строкой: имя попадает в
|
|
103
|
+
* `missing`, а сама ссылка остаётся в env — вызывающая сторона решает,
|
|
104
|
+
* прервать запуск или только предупредить.
|
|
95
105
|
*/
|
|
96
|
-
export function
|
|
106
|
+
export function resolveWorkspaceEnvDetailed(workspace, allowedSecretNames) {
|
|
97
107
|
if (!workspace)
|
|
98
|
-
return {};
|
|
108
|
+
return { env: {}, missing: [] };
|
|
99
109
|
const merged = {
|
|
100
110
|
...readWorkspaceEnvFile(workspace.envFile),
|
|
101
111
|
...(workspace.env ?? {}),
|
|
102
112
|
};
|
|
103
113
|
const resolved = resolveSecretRefs(merged, allowedSecretNames);
|
|
114
|
+
return { env: resolved.env, missing: resolved.missing };
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
|
|
118
|
+
* (пары важнее файла). Отсутствующий секрет даёт предупреждение с именем,
|
|
119
|
+
* но не значение. Никогда не бросает — для запуска задачи используйте
|
|
120
|
+
* writeWorkspaceEnvFile(), который в этом случае отказывает.
|
|
121
|
+
*/
|
|
122
|
+
export function resolveWorkspaceEnv(workspace, allowedSecretNames) {
|
|
123
|
+
const resolved = resolveWorkspaceEnvDetailed(workspace, allowedSecretNames);
|
|
104
124
|
if (resolved.missing.length > 0) {
|
|
105
|
-
console.warn(`[workspace] "${workspace
|
|
125
|
+
console.warn(`[workspace] "${workspace?.name ?? ""}": не найдены секреты: ${resolved.missing.join(", ")}`);
|
|
106
126
|
}
|
|
107
127
|
return resolved.env;
|
|
108
128
|
}
|
|
@@ -142,12 +162,27 @@ export function workspaceEnvDir(pluginDir) {
|
|
|
142
162
|
*
|
|
143
163
|
* Возвращает путь к файлу или undefined, если у workspace нет переменных.
|
|
144
164
|
* Пустой env удаляет ранее созданный файл. На POSIX права 0600.
|
|
165
|
+
*
|
|
166
|
+
* Если хотя бы один `${secret:NAME}` не разрешён, старый env-файл удаляется
|
|
167
|
+
* и бросается MissingWorkspaceSecretsError: задача не должна запускаться с
|
|
168
|
+
* литералом `${secret:...}` вместо значения (P2-21).
|
|
145
169
|
*/
|
|
146
170
|
export function writeWorkspaceEnvFile(workspace, pluginDir, sanitizedName, allowedSecretNames) {
|
|
147
171
|
if (!workspace)
|
|
148
172
|
return undefined;
|
|
149
173
|
const file = join(workspaceEnvDir(pluginDir), `${sanitizedName}.env`);
|
|
150
|
-
const env =
|
|
174
|
+
const { env, missing } = resolveWorkspaceEnvDetailed(workspace, allowedSecretNames);
|
|
175
|
+
if (missing.length > 0) {
|
|
176
|
+
// Fail closed: не оставляем старый файл, иначе обёртка продолжит
|
|
177
|
+
// подхватывать устаревшие значения секретов.
|
|
178
|
+
try {
|
|
179
|
+
rmSync(file, { force: true });
|
|
180
|
+
}
|
|
181
|
+
catch {
|
|
182
|
+
// файла нет — не ошибка
|
|
183
|
+
}
|
|
184
|
+
throw new MissingWorkspaceSecretsError(workspace.name, missing);
|
|
185
|
+
}
|
|
151
186
|
const keys = Object.keys(env);
|
|
152
187
|
if (!keys.length) {
|
|
153
188
|
try {
|
|
@@ -381,7 +416,7 @@ export function deleteWorkspace(id) {
|
|
|
381
416
|
if (affected.length > 0) {
|
|
382
417
|
console.warn(`[workspace] Удалён workspace '${workspace.name}'. ` +
|
|
383
418
|
`Отвязано задач: ${affected.length} (${affected.join(", ")}). ` +
|
|
384
|
-
|
|
419
|
+
"Задачи не удалены, workspaceId очищен.");
|
|
385
420
|
}
|
|
386
421
|
const result = getDb().prepare("DELETE FROM workspaces WHERE id = ?").run(id);
|
|
387
422
|
return Number(result.changes) > 0;
|