opencode-windows-scheduler 1.0.0 → 1.2.0
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 +58 -7
- package/README.md +14 -4
- package/README.ru.md +14 -4
- package/ROADMAP.md +30 -20
- package/dist/core/analytics.d.ts +129 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +286 -0
- package/dist/core/dry-run.d.ts +13 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +30 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +10 -0
- package/dist/core/ps-wrapper.d.ts +32 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +101 -3
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +182 -0
- package/dist/core/schedule-v2.d.ts +88 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +496 -0
- package/dist/core/scheduler/types.d.ts +15 -0
- package/dist/core/scheduler/types.d.ts.map +1 -1
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +13 -1
- package/dist/core/wrappers/bash.d.ts +15 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +44 -1
- package/dist/db/history-repo.d.ts +41 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +78 -0
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +11 -0
- package/dist/index.d.ts +117 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1094 -56
- package/dist/notifications.d.ts +112 -6
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +396 -34
- package/dist/profiles.d.ts +60 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +209 -0
- package/dist/rpc.d.ts +645 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +251 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +200 -7
- package/dist/settings.d.ts +80 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +159 -8
- package/dist/task-transfer.d.ts +13 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +26 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +3 -11
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +43 -0
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +174 -8
- package/docs/ARCHITECTURE.md +45 -13
- package/docs/FEATURES.md +103 -12
- package/gui-experimental.cjs +4 -2
- package/package.json +8 -2
- package/src/core/analytics.ts +414 -0
- package/src/core/dry-run.ts +42 -0
- package/src/core/matrix.ts +10 -0
- package/src/core/ps-wrapper.ts +117 -3
- package/src/core/retention.ts +141 -0
- package/src/core/schedule-gate.ts +213 -0
- package/src/core/schedule-v2.ts +533 -0
- package/src/core/scheduler/types.ts +15 -0
- package/src/core/scheduler/windows.ts +13 -1
- package/src/core/wrappers/bash.ts +60 -0
- package/src/db/history-repo.ts +116 -0
- package/src/db/schema.ts +14 -0
- package/src/gui.tsx +3613 -2725
- package/src/index.ts +1325 -55
- package/src/notifications.ts +516 -40
- package/src/profiles.ts +236 -0
- package/src/rpc.ts +267 -2
- package/src/server.ts +226 -7
- package/src/settings.ts +285 -9
- package/src/task-transfer.ts +44 -0
- package/src/types.ts +3 -13
- package/src/version.ts +27 -0
- package/src/workspaces.ts +214 -8
- package/dist/gui-experimental.cjs +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"task-transfer.d.ts","sourceRoot":"","sources":["../src/task-transfer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"task-transfer.d.ts","sourceRoot":"","sources":["../src/task-transfer.ts"],"names":[],"mappings":"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"}
|
package/dist/task-transfer.js
CHANGED
|
@@ -2,6 +2,7 @@ import fs from "node:fs/promises";
|
|
|
2
2
|
import path from "node:path";
|
|
3
3
|
import { PLUGIN_DIR, sanitizeName } from "./types.js";
|
|
4
4
|
import { listTasks, saveTask, deleteTask, } from "./db/tasks-repo.js";
|
|
5
|
+
import { isValidIanaTimeZone, validateLaunchWindow } from "./core/schedule-v2.js";
|
|
5
6
|
const PREFIX = "\\OpenCode\\windows-scheduler\\";
|
|
6
7
|
/** Приоритет по умолчанию — «Обычный». */
|
|
7
8
|
export const DEFAULT_PRIORITY = 5;
|
|
@@ -109,6 +110,10 @@ export async function buildExportJson(tasks) {
|
|
|
109
110
|
? { triggerType: "mcp-event" }
|
|
110
111
|
: {}),
|
|
111
112
|
...(definition?.watchPath ? { watchPath: definition.watchPath } : {}),
|
|
113
|
+
...(definition?.timezone ? { timezone: definition.timezone } : {}),
|
|
114
|
+
...(definition?.notBefore ? { notBefore: definition.notBefore } : {}),
|
|
115
|
+
...(definition?.notAfter ? { notAfter: definition.notAfter } : {}),
|
|
116
|
+
...(definition?.pausedUntil ? { pausedUntil: definition.pausedUntil } : {}),
|
|
112
117
|
...(Array.isArray(definition?.allowedTools) && definition.allowedTools.length > 0
|
|
113
118
|
? { allowedTools: definition.allowedTools }
|
|
114
119
|
: {}),
|
|
@@ -246,6 +251,23 @@ export function parseImportJson(raw) {
|
|
|
246
251
|
const model = readOptionalString(source.model);
|
|
247
252
|
const priority = normalizePriority(source.priority);
|
|
248
253
|
const workspaceId = readOptionalString(source.workspaceId);
|
|
254
|
+
// Планирование 2.0 (Спринт 19): IANA-зона, окно запуска, пауза до даты.
|
|
255
|
+
const timezone = readOptionalString(source.timezone);
|
|
256
|
+
if (timezone && !isValidIanaTimeZone(timezone)) {
|
|
257
|
+
errors.push(`Запись ${position}${name ? ` (${name})` : ""}: неизвестный часовой пояс ` +
|
|
258
|
+
`«${timezone}» (нужна IANA-зона, например Europe/Moscow).`);
|
|
259
|
+
}
|
|
260
|
+
const notBefore = readOptionalString(source.notBefore);
|
|
261
|
+
const notAfter = readOptionalString(source.notAfter);
|
|
262
|
+
const windowError = validateLaunchWindow(notBefore, notAfter);
|
|
263
|
+
if (windowError) {
|
|
264
|
+
errors.push(`Запись ${position}${name ? ` (${name})` : ""}: ${windowError}`);
|
|
265
|
+
}
|
|
266
|
+
const pausedUntil = readOptionalString(source.pausedUntil);
|
|
267
|
+
if (pausedUntil && Number.isNaN(Date.parse(pausedUntil))) {
|
|
268
|
+
errors.push(`Запись ${position}${name ? ` (${name})` : ""}: pausedUntil должен быть ` +
|
|
269
|
+
`датой в формате ISO (например 2026-12-01T09:00:00Z).`);
|
|
270
|
+
}
|
|
249
271
|
// Ограничения инструментов (Спринт 14): массив непустых строк без дублей.
|
|
250
272
|
// Пустой allowedTools отклоняется с явной ошибкой (избегаем «запрещено всё»).
|
|
251
273
|
const readToolList = (raw, fieldLabel) => {
|
|
@@ -431,6 +453,10 @@ export function parseImportJson(raw) {
|
|
|
431
453
|
...(dependsOn !== undefined ? { dependsOn } : {}),
|
|
432
454
|
...(triggerType === "cron" ? {} : { triggerType }),
|
|
433
455
|
...(watchPath ? { watchPath } : {}),
|
|
456
|
+
...(timezone !== undefined ? { timezone } : {}),
|
|
457
|
+
...(notBefore !== undefined ? { notBefore } : {}),
|
|
458
|
+
...(notAfter !== undefined ? { notAfter } : {}),
|
|
459
|
+
...(pausedUntil !== undefined ? { pausedUntil } : {}),
|
|
434
460
|
...(mcpEvent ? { mcpEvent } : {}),
|
|
435
461
|
...(allowedTools !== undefined ? { allowedTools } : {}),
|
|
436
462
|
...(deniedTools !== undefined ? { deniedTools } : {}),
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,oFAAoF;AACpF,eAAO,MAAM,WAAW,gCAAgC,CAAC;AAEzD,uDAAuD;AACvD,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAcpD,eAAO,MAAM,UAAU,QAAqB,CAAC;AAE7C,eAAO,MAAM,QAAQ,QAAiC,CAAC;AACvD,eAAO,MAAM,OAAO,QAAgC,CAAC;AACrD,eAAO,MAAM,WAAW,QAAoC,CAAC;AAE7D,4CAA4C;AAC5C,eAAO,MAAM,UAAU,SAA+B,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,QAAsB,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;iBAsB1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa;;iBAExB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,aAAa;;iBAExB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,YAAY,gCAAe,CAAC;AACzC,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,EAAE,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,sEAAsE;IACtE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}
|
package/dist/types.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import os from "node:os";
|
|
2
1
|
import path from "node:path";
|
|
3
2
|
import { z } from "zod";
|
|
3
|
+
import { getProfileDir, getProfileName } from "./profiles.js";
|
|
4
4
|
/** Префикс всех задач плагина (историческое имя, сохраняется для совместимости). */
|
|
5
5
|
export const TASK_PREFIX = "OpenCode\\windows-scheduler";
|
|
6
6
|
/** Папка задач плагина в планировщике ОС (Windows). */
|
|
@@ -12,18 +12,10 @@ export const TASK_FOLDER_NAME = "windows-scheduler";
|
|
|
12
12
|
* Windows: %APPDATA%\opencode\windows-scheduler (как раньше — без миграции).
|
|
13
13
|
* macOS/Linux: $XDG_CONFIG_HOME/opencode/windows-scheduler или
|
|
14
14
|
* ~/.config/opencode/windows-scheduler.
|
|
15
|
+
* Спринт 21: директория зависит от активного профиля (см. src/profiles.ts).
|
|
15
16
|
*/
|
|
16
17
|
function resolvePluginDir() {
|
|
17
|
-
|
|
18
|
-
const custom = process.env.OPENCODE_SCHEDULER_HOME?.trim();
|
|
19
|
-
if (custom)
|
|
20
|
-
return path.resolve(custom);
|
|
21
|
-
if (process.platform === "win32") {
|
|
22
|
-
const base = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
|
|
23
|
-
return path.join(base, "opencode", TASK_FOLDER_NAME);
|
|
24
|
-
}
|
|
25
|
-
const configHome = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
|
|
26
|
-
return path.join(configHome, "opencode", TASK_FOLDER_NAME);
|
|
18
|
+
return getProfileDir(getProfileName());
|
|
27
19
|
}
|
|
28
20
|
export const PLUGIN_DIR = resolvePluginDir();
|
|
29
21
|
export const LOCK_DIR = path.join(PLUGIN_DIR, "locks");
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Версия плагина из package.json.
|
|
3
|
+
*
|
|
4
|
+
* Читается в рантайме из корня пакета рядом со скомпилированным модулем
|
|
5
|
+
* (dist/version.js -> ../package.json). Если файл недоступен — «unknown».
|
|
6
|
+
*/
|
|
7
|
+
export declare function getPluginVersion(): string;
|
|
8
|
+
//# sourceMappingURL=version.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAczC"}
|
package/dist/version.js
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
let cached = null;
|
|
5
|
+
/**
|
|
6
|
+
* Версия плагина из package.json.
|
|
7
|
+
*
|
|
8
|
+
* Читается в рантайме из корня пакета рядом со скомпилированным модулем
|
|
9
|
+
* (dist/version.js -> ../package.json). Если файл недоступен — «unknown».
|
|
10
|
+
*/
|
|
11
|
+
export function getPluginVersion() {
|
|
12
|
+
if (cached)
|
|
13
|
+
return cached;
|
|
14
|
+
try {
|
|
15
|
+
const here = path.dirname(fileURLToPath(import.meta.url));
|
|
16
|
+
const raw = fs.readFileSync(path.join(here, "..", "package.json"), "utf8");
|
|
17
|
+
const pkg = JSON.parse(raw);
|
|
18
|
+
cached =
|
|
19
|
+
typeof pkg.version === "string" && pkg.version.trim()
|
|
20
|
+
? pkg.version.trim()
|
|
21
|
+
: "unknown";
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
cached = "unknown";
|
|
25
|
+
}
|
|
26
|
+
return cached;
|
|
27
|
+
}
|
package/dist/workspaces.d.ts
CHANGED
|
@@ -11,21 +11,64 @@ export interface Workspace {
|
|
|
11
11
|
path: string;
|
|
12
12
|
gitRemote?: string;
|
|
13
13
|
color?: string;
|
|
14
|
+
/** Env-переменные workspace (Спринт 21). Значения хранятся как есть. */
|
|
15
|
+
env?: Record<string, string>;
|
|
16
|
+
/** Путь к .env-файлу, переменные которого подмешиваются к env (Спринт 21). */
|
|
17
|
+
envFile?: string;
|
|
14
18
|
createdAt: string;
|
|
15
19
|
}
|
|
16
20
|
export interface AddWorkspaceInput {
|
|
17
21
|
name?: string;
|
|
18
22
|
path: string;
|
|
19
23
|
color?: string;
|
|
24
|
+
env?: Record<string, string> | null;
|
|
25
|
+
envFile?: string | null;
|
|
20
26
|
}
|
|
21
27
|
export interface UpdateWorkspacePatch {
|
|
22
28
|
name?: string;
|
|
23
29
|
path?: string;
|
|
24
30
|
color?: string;
|
|
25
31
|
gitRemote?: string | null;
|
|
32
|
+
env?: Record<string, string> | null;
|
|
33
|
+
envFile?: string | null;
|
|
26
34
|
}
|
|
35
|
+
/** Максимум пар env на workspace — защита от раздувания строки JSON. */
|
|
36
|
+
export declare const MAX_WORKSPACE_ENV_PAIRS = 100;
|
|
27
37
|
/** Палитра цветных маркеров для GUI/дашборда. */
|
|
28
38
|
export declare const WORKSPACE_COLORS: string[];
|
|
39
|
+
/**
|
|
40
|
+
* Нормализует пары env: ключи — валидные имена переменных, значения — строки.
|
|
41
|
+
* Бросает понятную ошибку при нарушении (её показывает GUI/RPC).
|
|
42
|
+
*/
|
|
43
|
+
export declare function normalizeWorkspaceEnv(value: unknown): Record<string, string> | undefined;
|
|
44
|
+
/**
|
|
45
|
+
* Разбирает содержимое .env: строки KEY=VALUE, комментарии `#`, пустые строки,
|
|
46
|
+
* префикс `export `, кавычки вокруг значения снимаются.
|
|
47
|
+
*/
|
|
48
|
+
export declare function parseEnvFileContent(content: string): Record<string, string>;
|
|
49
|
+
/** Читает .env-файл workspace (если он задан и существует). */
|
|
50
|
+
export declare function readWorkspaceEnvFile(envFile?: string): Record<string, string>;
|
|
51
|
+
/**
|
|
52
|
+
* Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
|
|
53
|
+
* (пары важнее файла). Никогда не бросает.
|
|
54
|
+
*/
|
|
55
|
+
export declare function resolveWorkspaceEnv(workspace: Workspace | undefined): Record<string, string>;
|
|
56
|
+
/** Маскирует значение секрета для логов. */
|
|
57
|
+
export declare function maskSecretValue(): string;
|
|
58
|
+
/** Копия env для логов: значения «секретных» ключей заменены на ***. */
|
|
59
|
+
export declare function maskEnvForLog(env: Record<string, string> | undefined): Record<string, string>;
|
|
60
|
+
/**
|
|
61
|
+
* Каталог env-файлов задач внутри каталога плагина (по одному файлу на задачу).
|
|
62
|
+
* Файлы содержат реальные значения и не попадают в git/логи.
|
|
63
|
+
*/
|
|
64
|
+
export declare function workspaceEnvDir(pluginDir: string): string;
|
|
65
|
+
/**
|
|
66
|
+
* Пишет env-файл задачи в формате KEY=VALUE (Спринт 21).
|
|
67
|
+
*
|
|
68
|
+
* Возвращает путь к файлу или undefined, если у workspace нет переменных.
|
|
69
|
+
* Пустой env удаляет ранее созданный файл. На POSIX права 0600.
|
|
70
|
+
*/
|
|
71
|
+
export declare function writeWorkspaceEnvFile(workspace: Workspace | undefined, pluginDir: string, sanitizedName: string): string | undefined;
|
|
29
72
|
/** Проверяет, что путь существует и является директорией. */
|
|
30
73
|
export declare function validateWorkspacePath(workspacePath: string): void;
|
|
31
74
|
/**
|
package/dist/workspaces.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"AAOA;;;;;;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,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;
|
|
1
|
+
{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}
|
package/dist/workspaces.js
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import { randomUUID } from "node:crypto";
|
|
2
|
-
import { statSync } from "node:fs";
|
|
3
|
-
import { basename, resolve } from "node:path";
|
|
2
|
+
import { chmodSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { basename, join, resolve } from "node:path";
|
|
4
4
|
import { spawnSync } from "node:child_process";
|
|
5
5
|
import { getDb } from "./db/index.js";
|
|
6
6
|
import { clearWorkspaceAssignments } from "./db/tasks-repo.js";
|
|
7
|
+
/** Максимум пар env на workspace — защита от раздувания строки JSON. */
|
|
8
|
+
export const MAX_WORKSPACE_ENV_PAIRS = 100;
|
|
7
9
|
/** Палитра цветных маркеров для GUI/дашборда. */
|
|
8
10
|
export const WORKSPACE_COLORS = [
|
|
9
11
|
"#5b8def",
|
|
@@ -13,13 +15,163 @@ export const WORKSPACE_COLORS = [
|
|
|
13
15
|
"#8b6fe8",
|
|
14
16
|
"#3aa8b8",
|
|
15
17
|
];
|
|
18
|
+
const ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
19
|
+
/**
|
|
20
|
+
* Нормализует пары env: ключи — валидные имена переменных, значения — строки.
|
|
21
|
+
* Бросает понятную ошибку при нарушении (её показывает GUI/RPC).
|
|
22
|
+
*/
|
|
23
|
+
export function normalizeWorkspaceEnv(value) {
|
|
24
|
+
if (value == null)
|
|
25
|
+
return undefined;
|
|
26
|
+
if (typeof value !== "object" || Array.isArray(value)) {
|
|
27
|
+
throw new Error("env должен быть объектом «ключ → значение».");
|
|
28
|
+
}
|
|
29
|
+
const entries = Object.entries(value);
|
|
30
|
+
if (entries.length > MAX_WORKSPACE_ENV_PAIRS) {
|
|
31
|
+
throw new Error(`Слишком много env-переменных: ${entries.length} (максимум ${MAX_WORKSPACE_ENV_PAIRS}).`);
|
|
32
|
+
}
|
|
33
|
+
const result = {};
|
|
34
|
+
for (const [rawKey, rawValue] of entries) {
|
|
35
|
+
const key = String(rawKey).trim();
|
|
36
|
+
if (!ENV_KEY_RE.test(key)) {
|
|
37
|
+
throw new Error(`Недопустимое имя env-переменной '${rawKey}': нужны латиница, цифры и '_', не с цифры.`);
|
|
38
|
+
}
|
|
39
|
+
if (rawValue == null) {
|
|
40
|
+
result[key] = "";
|
|
41
|
+
continue;
|
|
42
|
+
}
|
|
43
|
+
if (typeof rawValue === "object") {
|
|
44
|
+
throw new Error(`Значение env '${key}' должно быть строкой.`);
|
|
45
|
+
}
|
|
46
|
+
result[key] = String(rawValue);
|
|
47
|
+
}
|
|
48
|
+
return result;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Разбирает содержимое .env: строки KEY=VALUE, комментарии `#`, пустые строки,
|
|
52
|
+
* префикс `export `, кавычки вокруг значения снимаются.
|
|
53
|
+
*/
|
|
54
|
+
export function parseEnvFileContent(content) {
|
|
55
|
+
const result = {};
|
|
56
|
+
for (const line of String(content).split(/\r?\n/)) {
|
|
57
|
+
const trimmed = line.trim();
|
|
58
|
+
if (!trimmed || trimmed.startsWith("#"))
|
|
59
|
+
continue;
|
|
60
|
+
const withoutExport = trimmed.startsWith("export ")
|
|
61
|
+
? trimmed.slice("export ".length).trim()
|
|
62
|
+
: trimmed;
|
|
63
|
+
const eq = withoutExport.indexOf("=");
|
|
64
|
+
if (eq <= 0)
|
|
65
|
+
continue;
|
|
66
|
+
const key = withoutExport.slice(0, eq).trim();
|
|
67
|
+
if (!ENV_KEY_RE.test(key))
|
|
68
|
+
continue;
|
|
69
|
+
let value = withoutExport.slice(eq + 1).trim();
|
|
70
|
+
if ((value.startsWith('"') && value.endsWith('"') && value.length >= 2) ||
|
|
71
|
+
(value.startsWith("'") && value.endsWith("'") && value.length >= 2)) {
|
|
72
|
+
value = value.slice(1, -1);
|
|
73
|
+
}
|
|
74
|
+
result[key] = value;
|
|
75
|
+
}
|
|
76
|
+
return result;
|
|
77
|
+
}
|
|
78
|
+
/** Читает .env-файл workspace (если он задан и существует). */
|
|
79
|
+
export function readWorkspaceEnvFile(envFile) {
|
|
80
|
+
if (!envFile)
|
|
81
|
+
return {};
|
|
82
|
+
try {
|
|
83
|
+
return parseEnvFileContent(readFileSync(envFile, "utf8"));
|
|
84
|
+
}
|
|
85
|
+
catch {
|
|
86
|
+
return {};
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
|
|
91
|
+
* (пары важнее файла). Никогда не бросает.
|
|
92
|
+
*/
|
|
93
|
+
export function resolveWorkspaceEnv(workspace) {
|
|
94
|
+
if (!workspace)
|
|
95
|
+
return {};
|
|
96
|
+
return {
|
|
97
|
+
...readWorkspaceEnvFile(workspace.envFile),
|
|
98
|
+
...(workspace.env ?? {}),
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
/** Маскирует значение секрета для логов. */
|
|
102
|
+
export function maskSecretValue() {
|
|
103
|
+
return "***";
|
|
104
|
+
}
|
|
105
|
+
const SECRET_KEY_RE = /(TOKEN|SECRET|PASS|PASSWORD|KEY|CREDENTIAL|AUTH)/i;
|
|
106
|
+
/** Копия env для логов: значения «секретных» ключей заменены на ***. */
|
|
107
|
+
export function maskEnvForLog(env) {
|
|
108
|
+
if (!env)
|
|
109
|
+
return {};
|
|
110
|
+
const masked = {};
|
|
111
|
+
for (const [key, value] of Object.entries(env)) {
|
|
112
|
+
masked[key] = SECRET_KEY_RE.test(key) ? maskSecretValue() : value;
|
|
113
|
+
}
|
|
114
|
+
return masked;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Каталог env-файлов задач внутри каталога плагина (по одному файлу на задачу).
|
|
118
|
+
* Файлы содержат реальные значения и не попадают в git/логи.
|
|
119
|
+
*/
|
|
120
|
+
export function workspaceEnvDir(pluginDir) {
|
|
121
|
+
return join(pluginDir, "env");
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Пишет env-файл задачи в формате KEY=VALUE (Спринт 21).
|
|
125
|
+
*
|
|
126
|
+
* Возвращает путь к файлу или undefined, если у workspace нет переменных.
|
|
127
|
+
* Пустой env удаляет ранее созданный файл. На POSIX права 0600.
|
|
128
|
+
*/
|
|
129
|
+
export function writeWorkspaceEnvFile(workspace, pluginDir, sanitizedName) {
|
|
130
|
+
const file = join(workspaceEnvDir(pluginDir), `${sanitizedName}.env`);
|
|
131
|
+
const env = resolveWorkspaceEnv(workspace);
|
|
132
|
+
const keys = Object.keys(env);
|
|
133
|
+
if (!keys.length) {
|
|
134
|
+
try {
|
|
135
|
+
rmSync(file, { force: true });
|
|
136
|
+
}
|
|
137
|
+
catch {
|
|
138
|
+
// нечего удалять — не ошибка
|
|
139
|
+
}
|
|
140
|
+
return undefined;
|
|
141
|
+
}
|
|
142
|
+
const body = keys
|
|
143
|
+
.map((key) => `${key}=${String(env[key]).replace(/\r?\n/g, " ")}`)
|
|
144
|
+
.join("\n") + "\n";
|
|
145
|
+
mkdirSync(workspaceEnvDir(pluginDir), { recursive: true });
|
|
146
|
+
writeFileSync(file, body, { encoding: "utf8", mode: 0o600 });
|
|
147
|
+
if (process.platform !== "win32") {
|
|
148
|
+
try {
|
|
149
|
+
chmodSync(file, 0o600);
|
|
150
|
+
}
|
|
151
|
+
catch {
|
|
152
|
+
// права не критичны для работы задачи
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
return file;
|
|
156
|
+
}
|
|
16
157
|
function rowToWorkspace(row) {
|
|
158
|
+
let env;
|
|
159
|
+
if (row.env_json) {
|
|
160
|
+
try {
|
|
161
|
+
env = normalizeWorkspaceEnv(JSON.parse(String(row.env_json)));
|
|
162
|
+
}
|
|
163
|
+
catch {
|
|
164
|
+
env = undefined;
|
|
165
|
+
}
|
|
166
|
+
}
|
|
17
167
|
return {
|
|
18
168
|
id: String(row.id),
|
|
19
169
|
name: String(row.name),
|
|
20
170
|
path: String(row.path),
|
|
21
171
|
gitRemote: row.git_remote == null ? undefined : String(row.git_remote),
|
|
22
172
|
color: row.color == null ? undefined : String(row.color),
|
|
173
|
+
env,
|
|
174
|
+
envFile: row.env_file == null ? undefined : String(row.env_file),
|
|
23
175
|
createdAt: String(row.created_at),
|
|
24
176
|
};
|
|
25
177
|
}
|
|
@@ -114,11 +266,13 @@ export function addWorkspace(input) {
|
|
|
114
266
|
WORKSPACE_COLORS[listWorkspaces().length % WORKSPACE_COLORS.length];
|
|
115
267
|
const createdAt = new Date().toISOString();
|
|
116
268
|
const gitRemote = readGitRemote(workspacePath);
|
|
269
|
+
const env = normalizeWorkspaceEnv(input.env);
|
|
270
|
+
const envFile = input.envFile?.trim() || undefined;
|
|
117
271
|
getDb()
|
|
118
|
-
.prepare(`INSERT INTO workspaces (id, name, path, git_remote, color, created_at)
|
|
119
|
-
VALUES (?, ?, ?, ?, ?, ?)`)
|
|
120
|
-
.run(id, name, workspacePath, gitRemote ?? null, color, createdAt);
|
|
121
|
-
return { id, name, path: workspacePath, gitRemote, color, createdAt };
|
|
272
|
+
.prepare(`INSERT INTO workspaces (id, name, path, git_remote, color, env_json, env_file, created_at)
|
|
273
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
|
|
274
|
+
.run(id, name, workspacePath, gitRemote ?? null, color, env ? JSON.stringify(env) : null, envFile ?? null, createdAt);
|
|
275
|
+
return { id, name, path: workspacePath, gitRemote, color, env, envFile, createdAt };
|
|
122
276
|
}
|
|
123
277
|
/** Обновляет имя/путь/цвет workspace. */
|
|
124
278
|
export function updateWorkspace(id, patch) {
|
|
@@ -147,15 +301,27 @@ export function updateWorkspace(id, patch) {
|
|
|
147
301
|
: nextPath !== existing.path
|
|
148
302
|
? readGitRemote(nextPath)
|
|
149
303
|
: existing.gitRemote;
|
|
304
|
+
const nextEnv = patch.env === null
|
|
305
|
+
? undefined
|
|
306
|
+
: patch.env !== undefined
|
|
307
|
+
? normalizeWorkspaceEnv(patch.env)
|
|
308
|
+
: existing.env;
|
|
309
|
+
const nextEnvFile = patch.envFile === null
|
|
310
|
+
? undefined
|
|
311
|
+
: patch.envFile !== undefined
|
|
312
|
+
? patch.envFile.trim() || undefined
|
|
313
|
+
: existing.envFile;
|
|
150
314
|
getDb()
|
|
151
|
-
.prepare("UPDATE workspaces SET name = ?, path = ?, git_remote = ?, color = ? WHERE id = ?")
|
|
152
|
-
.run(nextName, nextPath, nextRemote ?? null, nextColor ?? null, id);
|
|
315
|
+
.prepare("UPDATE workspaces SET name = ?, path = ?, git_remote = ?, color = ?, env_json = ?, env_file = ? WHERE id = ?")
|
|
316
|
+
.run(nextName, nextPath, nextRemote ?? null, nextColor ?? null, nextEnv ? JSON.stringify(nextEnv) : null, nextEnvFile ?? null, id);
|
|
153
317
|
return {
|
|
154
318
|
id,
|
|
155
319
|
name: nextName,
|
|
156
320
|
path: nextPath,
|
|
157
321
|
gitRemote: nextRemote,
|
|
158
322
|
color: nextColor,
|
|
323
|
+
env: nextEnv,
|
|
324
|
+
envFile: nextEnvFile,
|
|
159
325
|
createdAt: existing.createdAt,
|
|
160
326
|
};
|
|
161
327
|
}
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -86,21 +86,28 @@ is read from the database or from files under the plugin directory.
|
|
|
86
86
|
|
|
87
87
|
1. Agent tool / GUI / import calls `schedulerCreateTask(...)`.
|
|
88
88
|
2. Definitions are validated (cron, workspace path, matrix rules), a prompt file and a
|
|
89
|
-
wrapper script are written under the plugin directory
|
|
89
|
+
wrapper script are written under the plugin directory; if the task's workspace has
|
|
90
|
+
env variables, `<PLUGIN_DIR>/env/<sanitized>.env` is written (mode `0600` on POSIX).
|
|
90
91
|
3. An OS entry is created through the platform backend.
|
|
91
92
|
4. The definition is stored in `tasks.definition_json`.
|
|
92
93
|
|
|
93
94
|
**Run a task**
|
|
94
95
|
|
|
95
96
|
1. The OS scheduler starts the wrapper.
|
|
96
|
-
2.
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
97
|
+
2. When the task carries a schedule gate (poll-mode cron, foreign timezone or a
|
|
98
|
+
launch window), the wrapper first runs `node dist/core/schedule-gate.js`: it
|
|
99
|
+
re-checks the extended cron in the task's zone, and if now is outside the
|
|
100
|
+
launch window it waits until the window opens (postpone, deduplicated by a
|
|
101
|
+
defer-file) or exits with code 3 so the wrapper skips silently.
|
|
102
|
+
3. The wrapper acquires the lock (`locks/<task>.lock`), writes the log
|
|
103
|
+
(`logs/<task>.log`), loads workspace env from `<PLUGIN_DIR>/env/<sanitized>.env`
|
|
104
|
+
(Windows `-EnvFile`, POSIX `set -a; . "$ENV_FILE"; set +a`) before starting
|
|
105
|
+
`opencode run` with the prompt file. Output is streamed to the log.
|
|
106
|
+
4. When the process ends, the wrapper enforces the timeout result, runs the Quality
|
|
100
107
|
Gate and the post-flight hook.
|
|
101
|
-
|
|
108
|
+
5. The wrapper calls `node dist/core/record-history.js --finish ...` with status,
|
|
102
109
|
duration, tokens, cost, model and hook results.
|
|
103
|
-
|
|
110
|
+
6. The recorder writes `history` and updates `metrics`, then evaluates retries, task
|
|
104
111
|
chains, DAG dependents and matrix continuation.
|
|
105
112
|
|
|
106
113
|
**Read state**
|
|
@@ -119,11 +126,15 @@ from their clones instead of their own last run.
|
|
|
119
126
|
| `src/server.ts` | Local web dashboard HTTP server and HTML rendering |
|
|
120
127
|
| `src/skill.ts` | Loads and registers the bundled agent skill |
|
|
121
128
|
| `src/task-transfer.ts` | Export/import, validation, `MatrixConfig` types |
|
|
122
|
-
| `src/
|
|
129
|
+
| `src/profiles.ts` | Profile directory resolution: per-profile plugin dir (base for `default`, `<base>/profiles/<name>` for named profiles); profile name, marker, port, create/delete/switch |
|
|
130
|
+
| `src/workspaces.ts` | Workspace registry and path validation; env pairs and `.env` file resolution with secret masking |
|
|
123
131
|
| `src/templates.ts` | Reusable task templates |
|
|
124
|
-
| `src/settings.ts` | Plugin settings and
|
|
125
|
-
| `src/notifications.ts` | Webhook notifications |
|
|
132
|
+
| `src/settings.ts` | Plugin settings: notifications and history retention |
|
|
133
|
+
| `src/notifications.ts` | Webhook delivery with retries/backoff, templates, task filters, matrix and stuck-clone notifications, daily/weekly digest |
|
|
126
134
|
| `src/history.ts` | History model and status types |
|
|
135
|
+
| `src/version.ts` | Runtime plugin version (reads package.json) |
|
|
136
|
+
| `src/core/retention.ts` | Daily history prune and incremental vacuum |
|
|
137
|
+
| `src/core/analytics.ts` | Pure 14-day analytics and CSV export |
|
|
127
138
|
| `src/core/scheduler/` | Platform backends, registry, logs |
|
|
128
139
|
| `src/core/ps-wrapper.ts` | PowerShell wrapper template and `.cmd` generation |
|
|
129
140
|
| `src/core/wrappers/bash.ts` | POSIX wrapper template |
|
|
@@ -133,6 +144,8 @@ from their clones instead of their own last run.
|
|
|
133
144
|
| `src/core/lock.ts` | Single-instance lock manager |
|
|
134
145
|
| `src/core/file-watcher.ts` | chokidar-based file triggers |
|
|
135
146
|
| `src/core/cron-to-schtasks.ts` | Cron → Task Scheduler translation |
|
|
147
|
+
| `src/core/schedule-v2.ts` | Extended cron parser/matcher, timezone math, launch windows, poll-mode decisions |
|
|
148
|
+
| `src/core/schedule-gate.ts` | Wrapper-side gate: cron re-check (poll mode), window postpone, defer-file |
|
|
136
149
|
| `src/db/` | SQLite access: schema, migrations, repositories, recovery |
|
|
137
150
|
| `src/shared/jobs-view.ts` | Task view shared by the GUI and dashboard |
|
|
138
151
|
|
|
@@ -163,6 +176,7 @@ enforced:
|
|
|
163
176
|
| Working directory | Task `workingDirectory`, or the workspace path, or the plugin directory |
|
|
164
177
|
| Prompt | Written to a prompt file, passed to `opencode run` |
|
|
165
178
|
| Timeout | `timeoutSeconds`; on expiry the child process tree is stopped and the run is marked `timeout` |
|
|
179
|
+
| Workspace env | Variables from the workspace's `.env` file and explicit pairs are injected before `opencode run` (wrapper `env:` / `export`); secret-looking keys are masked in logs |
|
|
166
180
|
| No overlap | Lock file per task; a second start exits immediately and records `skipped` |
|
|
167
181
|
| Pre-flight | `beforeScript`; non-zero exit marks `preFlight` as failed |
|
|
168
182
|
| Quality Gate | `qualityGate` after a successful run; non-zero exit turns the run into an error |
|
|
@@ -184,6 +198,15 @@ If the host or the machine dies mid-run, the row stays in `running`. On the next
|
|
|
184
198
|
plugin activation, `db/recovery.ts` marks stale `running` rows as `error`, so the UI
|
|
185
199
|
never shows a permanently running task.
|
|
186
200
|
|
|
201
|
+
History is bounded by retention: `settings.json` carries `history.retentionDays` and
|
|
202
|
+
`history.maxRecords` (defaults 30 / 5000, `0` disables). Cleanup runs at most once a
|
|
203
|
+
day on plugin start (`core/retention.ts`), prunes only finished rows via
|
|
204
|
+
`pruneHistory` in `db/history-repo.ts`, then `PRAGMA incremental_vacuum` frees space.
|
|
205
|
+
Aggregates in `metrics` are never pruned. Period analytics (per-day buckets, success
|
|
206
|
+
rate, tokens, cost, matrix/model breakdowns) are computed by `core/analytics.ts` and
|
|
207
|
+
exposed as `get_analytics` / `GET /api/analytics`; the dashboard renders a 14-day
|
|
208
|
+
block and `GET /api/history/export` serves CSV/JSON.
|
|
209
|
+
|
|
187
210
|
## Chains, retries and DAG
|
|
188
211
|
|
|
189
212
|
All three are evaluated by the recorder after a run finishes:
|
|
@@ -226,10 +249,13 @@ remote and color. Workspaces provide:
|
|
|
226
249
|
- the working directory for a task (`workspaceId` instead of `workingDirectory`);
|
|
227
250
|
- matrix targets (`matrix.workspaceIds`);
|
|
228
251
|
- per-workspace overrides (`matrix.overrides`);
|
|
229
|
-
- dashboard grouping
|
|
252
|
+
- dashboard grouping;
|
|
253
|
+
- env variables: explicit `KEY=VALUE` pairs plus an optional `.env` file (loaded first,
|
|
254
|
+
explicit pairs override), injected into task runs via the wrapper; secret-looking
|
|
255
|
+
keys are masked in logs.
|
|
230
256
|
|
|
231
257
|
Paths are validated on creation, update and import: a workspace must point to an
|
|
232
|
-
existing directory.
|
|
258
|
+
existing directory. Env keys must match `^[A-Za-z_][A-Za-z0-9_]*$`; max 100 pairs.
|
|
233
259
|
|
|
234
260
|
## Triggers
|
|
235
261
|
|
|
@@ -258,11 +284,17 @@ logs/ per-task run logs
|
|
|
258
284
|
locks/ lock files
|
|
259
285
|
wrappers/ generated .cmd / .sh wrappers
|
|
260
286
|
prompts/ prompt files
|
|
287
|
+
env/ per-workspace env files (<task>.env), mode 0600 on POSIX
|
|
261
288
|
```
|
|
262
289
|
|
|
290
|
+
Named profiles (Sprint 21) each own a copy of this tree under
|
|
291
|
+
`<base>/profiles/<name>` (`default` uses the base directory). Profile directory,
|
|
292
|
+
database, settings, logs, wrappers and locks all resolve per-profile.
|
|
293
|
+
|
|
263
294
|
Override the database location with `OPENCODE_SCHEDULER_DB` (used by tests). Override
|
|
264
295
|
the whole plugin directory (database, logs, locks, wrappers, prompts) with
|
|
265
|
-
`OPENCODE_SCHEDULER_HOME` on any platform.
|
|
296
|
+
`OPENCODE_SCHEDULER_HOME` on any platform. Profile selection uses
|
|
297
|
+
`OPENCODE_SCHEDULER_PROFILE` > `active-profile` marker > `default`.
|
|
266
298
|
|
|
267
299
|
Schema evolution is additive: `applySchema` runs `CREATE TABLE IF NOT EXISTS` on every
|
|
268
300
|
connection and adds missing columns after `PRAGMA table_info`, so upgrading the plugin
|