opencode-windows-scheduler 1.4.0 → 1.5.1
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 +61 -1
- package/LICENSE +21 -21
- package/README.md +26 -4
- package/ROADMAP-STRATEGY.md +43 -24
- package/ROADMAP.md +549 -31
- package/dist/core/dry-run.d.ts +41 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +165 -16
- package/dist/core/file-watcher.d.ts.map +1 -1
- package/dist/core/file-watcher.js +53 -10
- package/dist/core/git-trigger.d.ts +80 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +294 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +48 -22
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +7 -0
- package/dist/core/schedule-gate.js +55 -30
- package/dist/core/schedule-v2.d.ts +29 -1
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +107 -17
- package/dist/core/scheduler/types.d.ts +7 -1
- package/dist/core/scheduler/types.d.ts.map +1 -1
- package/dist/core/scheduler/windows.d.ts +6 -2
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +25 -10
- package/dist/core/telegram.d.ts.map +1 -1
- package/dist/core/telegram.js +13 -10
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +4 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +8 -0
- package/dist/i18n.d.ts +52 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +292 -0
- package/dist/index.d.ts +50 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1020 -197
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +74 -40
- package/dist/rpc.d.ts +238 -2
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +79 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +89 -48
- package/dist/settings.d.ts +3 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +20 -8
- package/dist/task-transfer.d.ts +43 -3
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +94 -6
- package/dist/templates.d.ts +1 -1
- package/dist/templates.d.ts.map +1 -1
- package/dist/types.d.ts +11 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +32 -0
- package/docs/ARCHITECTURE.md +37 -1
- package/docs/FEATURES.md +70 -0
- package/docs/README.ru.md +19 -3
- package/gui-experimental.cjs +9 -4
- package/locales/en.json +695 -0
- package/locales/ru.json +695 -0
- package/package.json +9 -3
- package/scripts/test-locale.mjs +44 -0
- package/src/core/dry-run.ts +244 -19
- package/src/core/file-watcher.ts +65 -10
- package/src/core/git-trigger.ts +373 -0
- package/src/core/glob.ts +226 -0
- package/src/core/matrix.ts +52 -26
- package/src/core/ps-wrapper.ts +7 -0
- package/src/core/schedule-gate.ts +67 -33
- package/src/core/schedule-v2.ts +152 -17
- package/src/core/scheduler/types.ts +7 -1
- package/src/core/scheduler/windows.ts +25 -10
- package/src/core/telegram.ts +16 -10
- package/src/core/wrappers/bash.ts +4 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/schema.ts +8 -0
- package/src/gui.tsx +772 -456
- package/src/i18n.ts +339 -0
- package/src/index.ts +1274 -212
- package/src/notifications.ts +83 -42
- package/src/rpc.ts +79 -2
- package/src/server.ts +89 -48
- package/src/settings.ts +38 -10
- package/src/task-transfer.ts +148 -5
- package/src/templates.ts +1 -1
- package/src/types.ts +37 -0
package/dist/task-transfer.d.ts
CHANGED
|
@@ -100,10 +100,11 @@ export interface TaskDefinition {
|
|
|
100
100
|
dependsOn?: string[];
|
|
101
101
|
/**
|
|
102
102
|
* Чем запускается задача: по расписанию ("cron", по умолчанию),
|
|
103
|
-
* при изменении файла ("file"), по
|
|
104
|
-
* однократно в runAt ("once").
|
|
103
|
+
* при изменении файла ("file"), по новому коммиту в git ("git"),
|
|
104
|
+
* по MCP-событию ("mcp-event") или однократно в runAt ("once").
|
|
105
|
+
* Для file/git/mcp-event/once расписание не нужно.
|
|
105
106
|
*/
|
|
106
|
-
triggerType?: "cron" | "file" | "mcp-event" | "once";
|
|
107
|
+
triggerType?: "cron" | "file" | "git" | "mcp-event" | "once";
|
|
107
108
|
/** Абсолютное время однократного запуска (ISO-8601, triggerType "once"). */
|
|
108
109
|
runAt?: string;
|
|
109
110
|
/**
|
|
@@ -155,8 +156,47 @@ export interface TaskDefinition {
|
|
|
155
156
|
notBefore?: string;
|
|
156
157
|
/** Конец окна запуска "HH:MM"; может быть меньше notBefore (через полночь). */
|
|
157
158
|
notAfter?: string;
|
|
159
|
+
/**
|
|
160
|
+
* Разрешённые дни недели для окна и cron (Спринт 27): 0 = воскресенье … 6 = суббота.
|
|
161
|
+
* Пусто — все дни.
|
|
162
|
+
*/
|
|
163
|
+
activeDays?: number[];
|
|
164
|
+
/**
|
|
165
|
+
* Поведение вне окна запуска или в неразрешённый день (Спринт 27):
|
|
166
|
+
* "postpone" (по умолчанию) — ждать открытия окна, "skip" — пропустить,
|
|
167
|
+
* "run" — выполнить всё равно.
|
|
168
|
+
*/
|
|
169
|
+
windowPolicy?: "skip" | "postpone" | "run";
|
|
170
|
+
/**
|
|
171
|
+
* Git-триггер (Спринт 27): запускать при новых коммитах в рабочем каталоге.
|
|
172
|
+
* До первого запуска плагин запоминает текущий HEAD без запуска задачи.
|
|
173
|
+
*/
|
|
174
|
+
gitBranch?: string;
|
|
175
|
+
/** Glob-маски путей через запятую: запускать только при изменениях в них. */
|
|
176
|
+
gitPaths?: string[];
|
|
177
|
+
/** Glob-маски путей, изменения в которых не считаются триггером. */
|
|
178
|
+
gitIgnore?: string[];
|
|
179
|
+
/** Период опроса git, секунды (минимум 5, по умолчанию 60). */
|
|
180
|
+
gitPollSeconds?: number;
|
|
181
|
+
/** Glob-маски файлов для triggerType "file" (Спринт 27). */
|
|
182
|
+
watchGlobs?: string[];
|
|
183
|
+
/** Glob-маски игнорируемых файлов для triggerType "file". */
|
|
184
|
+
watchIgnore?: string[];
|
|
158
185
|
/** Пауза до даты (ISO, Спринт 19): плагин включит задачу автоматически. */
|
|
159
186
|
pausedUntil?: string;
|
|
187
|
+
/**
|
|
188
|
+
* Бессрочная пауза (Спринт 27.5.8): true — задача отключена в планировщике
|
|
189
|
+
* без даты автовозобновления. Флаг переживает update (пересоздание) и
|
|
190
|
+
* degraded-режим, когда список задач ОС недоступен.
|
|
191
|
+
*/
|
|
192
|
+
paused?: boolean;
|
|
193
|
+
/**
|
|
194
|
+
* Windows-режим входа (Спринт 27.5.4): true — задача запускается и без входа
|
|
195
|
+
* пользователя (schtasks /ru SYSTEM, session 0). По умолчанию false —
|
|
196
|
+
* интерактивная задача (Interactive only, только при активном входе).
|
|
197
|
+
* На Linux/macOS игнорируется: cron работает без входа, launchd — при входе.
|
|
198
|
+
*/
|
|
199
|
+
runWhenLoggedOff?: boolean;
|
|
160
200
|
/** Когда задача была создана — защита от ложного catch-up сразу после создания. */
|
|
161
201
|
createdAt?: string;
|
|
162
202
|
}
|
|
@@ -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":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAcpD,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACrC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,yDAAyD;IACzD,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACrC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;IAC3C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,mDAAmD;AACnD,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAErE;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED,+CAA+C;AAC/C,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EAAE,GACzB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmJ1C;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAmfzD"}
|
package/dist/task-transfer.js
CHANGED
|
@@ -3,7 +3,7 @@ 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
5
|
import { normalizeOneShotRunAt } from "./core/one-shot.js";
|
|
6
|
-
import { isValidIanaTimeZone, validateLaunchWindow } from "./core/schedule-v2.js";
|
|
6
|
+
import { isValidIanaTimeZone, normalizeActiveDays, validateLaunchWindow, } from "./core/schedule-v2.js";
|
|
7
7
|
import { isValidSessionId } from "./core/session.js";
|
|
8
8
|
const PREFIX = "\\OpenCode\\windows-scheduler\\";
|
|
9
9
|
/** Приоритет по умолчанию — «Обычный». */
|
|
@@ -108,6 +108,7 @@ export async function buildExportJson(tasks) {
|
|
|
108
108
|
? { dependsOn: definition.dependsOn }
|
|
109
109
|
: {}),
|
|
110
110
|
...(definition?.triggerType === "file" ? { triggerType: "file" } : {}),
|
|
111
|
+
...(definition?.triggerType === "git" ? { triggerType: "git" } : {}),
|
|
111
112
|
...(definition?.triggerType === "mcp-event"
|
|
112
113
|
? { triggerType: "mcp-event" }
|
|
113
114
|
: {}),
|
|
@@ -131,7 +132,31 @@ export async function buildExportJson(tasks) {
|
|
|
131
132
|
...(definition?.timezone ? { timezone: definition.timezone } : {}),
|
|
132
133
|
...(definition?.notBefore ? { notBefore: definition.notBefore } : {}),
|
|
133
134
|
...(definition?.notAfter ? { notAfter: definition.notAfter } : {}),
|
|
135
|
+
// Спринт 27: дни недели, политика окна и git/glob-триггеры.
|
|
136
|
+
...(Array.isArray(definition?.activeDays) && definition.activeDays.length > 0
|
|
137
|
+
? { activeDays: definition.activeDays }
|
|
138
|
+
: {}),
|
|
139
|
+
...(definition?.windowPolicy ? { windowPolicy: definition.windowPolicy } : {}),
|
|
140
|
+
...(definition?.gitBranch ? { gitBranch: definition.gitBranch } : {}),
|
|
141
|
+
...(Array.isArray(definition?.gitPaths) && definition.gitPaths.length > 0
|
|
142
|
+
? { gitPaths: definition.gitPaths }
|
|
143
|
+
: {}),
|
|
144
|
+
...(Array.isArray(definition?.gitIgnore) && definition.gitIgnore.length > 0
|
|
145
|
+
? { gitIgnore: definition.gitIgnore }
|
|
146
|
+
: {}),
|
|
147
|
+
...(definition?.gitPollSeconds !== undefined
|
|
148
|
+
? { gitPollSeconds: definition.gitPollSeconds }
|
|
149
|
+
: {}),
|
|
150
|
+
...(Array.isArray(definition?.watchGlobs) && definition.watchGlobs.length > 0
|
|
151
|
+
? { watchGlobs: definition.watchGlobs }
|
|
152
|
+
: {}),
|
|
153
|
+
...(Array.isArray(definition?.watchIgnore) && definition.watchIgnore.length > 0
|
|
154
|
+
? { watchIgnore: definition.watchIgnore }
|
|
155
|
+
: {}),
|
|
134
156
|
...(definition?.pausedUntil ? { pausedUntil: definition.pausedUntil } : {}),
|
|
157
|
+
...(definition?.paused === true ? { paused: true } : {}),
|
|
158
|
+
// Спринт 27.5.10: режим входа переживает перенос между профилями.
|
|
159
|
+
...(definition?.runWhenLoggedOff === true ? { runWhenLoggedOff: true } : {}),
|
|
135
160
|
...(Array.isArray(definition?.allowedTools) && definition.allowedTools.length > 0
|
|
136
161
|
? { allowedTools: definition.allowedTools }
|
|
137
162
|
: {}),
|
|
@@ -203,11 +228,13 @@ export function parseImportJson(raw) {
|
|
|
203
228
|
const prompt = typeof source.prompt === "string" ? source.prompt.trim() : "";
|
|
204
229
|
const triggerType = source.triggerType === "file"
|
|
205
230
|
? "file"
|
|
206
|
-
: source.triggerType === "
|
|
207
|
-
? "
|
|
208
|
-
: source.triggerType === "
|
|
209
|
-
? "
|
|
210
|
-
: "
|
|
231
|
+
: source.triggerType === "git"
|
|
232
|
+
? "git"
|
|
233
|
+
: source.triggerType === "mcp-event"
|
|
234
|
+
? "mcp-event"
|
|
235
|
+
: source.triggerType === "once"
|
|
236
|
+
? "once"
|
|
237
|
+
: "cron";
|
|
211
238
|
const watchPath = typeof source.watchPath === "string" ? source.watchPath.trim() : "";
|
|
212
239
|
const rawRunAt = typeof source.runAt === "string" ? source.runAt.trim() : "";
|
|
213
240
|
const rawDelaySeconds = typeof source.delaySeconds === "number" ? source.delaySeconds : undefined;
|
|
@@ -319,6 +346,51 @@ export function parseImportJson(raw) {
|
|
|
319
346
|
const model = readOptionalString(source.model);
|
|
320
347
|
const priority = normalizePriority(source.priority);
|
|
321
348
|
const workspaceId = readOptionalString(source.workspaceId);
|
|
349
|
+
// Спринт 27: git-триггер, glob-маски и временные окна.
|
|
350
|
+
if (triggerType === "git" && !workspaceId && !workingDirectory) {
|
|
351
|
+
errors.push(`Запись ${position}${name ? ` (${name})` : ""}: для git-триггера нужна рабочая директория (workingDirectory или workspaceId).`);
|
|
352
|
+
return;
|
|
353
|
+
}
|
|
354
|
+
const readStringList = (value) => {
|
|
355
|
+
if (!Array.isArray(value))
|
|
356
|
+
return undefined;
|
|
357
|
+
const items = value
|
|
358
|
+
.filter((entry) => typeof entry === "string" && Boolean(entry.trim()))
|
|
359
|
+
.map((entry) => entry.trim());
|
|
360
|
+
return items.length > 0 ? items : undefined;
|
|
361
|
+
};
|
|
362
|
+
const gitBranch = readOptionalString(source.gitBranch);
|
|
363
|
+
const gitPaths = readStringList(source.gitPaths);
|
|
364
|
+
const gitIgnore = readStringList(source.gitIgnore);
|
|
365
|
+
const watchGlobs = readStringList(source.watchGlobs);
|
|
366
|
+
const watchIgnore = readStringList(source.watchIgnore);
|
|
367
|
+
const gitPollSeconds = typeof source.gitPollSeconds === "number" &&
|
|
368
|
+
Number.isFinite(source.gitPollSeconds) &&
|
|
369
|
+
source.gitPollSeconds > 0
|
|
370
|
+
? Math.floor(source.gitPollSeconds)
|
|
371
|
+
: undefined;
|
|
372
|
+
const rawDays = Array.isArray(source.activeDays) ? source.activeDays : undefined;
|
|
373
|
+
let activeDays;
|
|
374
|
+
if (rawDays) {
|
|
375
|
+
const days = rawDays.filter((value) => typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 6);
|
|
376
|
+
if (days.length !== rawDays.length) {
|
|
377
|
+
errors.push(`Запись ${position}${name ? ` (${name})` : ""}: activeDays должен содержать числа 0..6 (0 = воскресенье).`);
|
|
378
|
+
return;
|
|
379
|
+
}
|
|
380
|
+
activeDays = normalizeActiveDays(days);
|
|
381
|
+
}
|
|
382
|
+
let windowPolicy;
|
|
383
|
+
if (source.windowPolicy !== undefined) {
|
|
384
|
+
if (source.windowPolicy === "skip" ||
|
|
385
|
+
source.windowPolicy === "postpone" ||
|
|
386
|
+
source.windowPolicy === "run") {
|
|
387
|
+
windowPolicy = source.windowPolicy;
|
|
388
|
+
}
|
|
389
|
+
else {
|
|
390
|
+
errors.push(`Запись ${position}${name ? ` (${name})` : ""}: неизвестный windowPolicy «${String(source.windowPolicy)}» (ожидается skip, postpone или run).`);
|
|
391
|
+
return;
|
|
392
|
+
}
|
|
393
|
+
}
|
|
322
394
|
// Планирование 2.0 (Спринт 19): IANA-зона, окно запуска, пауза до даты.
|
|
323
395
|
const timezone = readOptionalString(source.timezone);
|
|
324
396
|
if (timezone && !isValidIanaTimeZone(timezone)) {
|
|
@@ -336,6 +408,11 @@ export function parseImportJson(raw) {
|
|
|
336
408
|
errors.push(`Запись ${position}${name ? ` (${name})` : ""}: pausedUntil должен быть ` +
|
|
337
409
|
`датой в формате ISO (например 2026-12-01T09:00:00Z).`);
|
|
338
410
|
}
|
|
411
|
+
// Спринт 27.5.8: бессрочная пауза импортируется вместе с задачей.
|
|
412
|
+
const pausedFlag = source.paused === true;
|
|
413
|
+
// Спринт 27.5.10: режим входа. Только явный `true` делает задачу фоновой;
|
|
414
|
+
// всё остальное (false, null, строка) означает интерактивную задачу.
|
|
415
|
+
const runWhenLoggedOffFlag = source.runWhenLoggedOff === true;
|
|
339
416
|
// Ограничения инструментов (Спринт 14): массив непустых строк без дублей.
|
|
340
417
|
// Пустой allowedTools отклоняется с явной ошибкой (избегаем «запрещено всё»).
|
|
341
418
|
const readToolList = (raw, fieldLabel) => {
|
|
@@ -528,7 +605,18 @@ export function parseImportJson(raw) {
|
|
|
528
605
|
...(timezone !== undefined ? { timezone } : {}),
|
|
529
606
|
...(notBefore !== undefined ? { notBefore } : {}),
|
|
530
607
|
...(notAfter !== undefined ? { notAfter } : {}),
|
|
608
|
+
...(activeDays !== undefined ? { activeDays } : {}),
|
|
609
|
+
...(windowPolicy !== undefined ? { windowPolicy } : {}),
|
|
610
|
+
...(gitBranch !== undefined ? { gitBranch } : {}),
|
|
611
|
+
...(gitPaths !== undefined ? { gitPaths } : {}),
|
|
612
|
+
...(gitIgnore !== undefined ? { gitIgnore } : {}),
|
|
613
|
+
...(gitPollSeconds !== undefined ? { gitPollSeconds } : {}),
|
|
614
|
+
...(watchGlobs !== undefined ? { watchGlobs } : {}),
|
|
615
|
+
...(watchIgnore !== undefined ? { watchIgnore } : {}),
|
|
531
616
|
...(pausedUntil !== undefined ? { pausedUntil } : {}),
|
|
617
|
+
...(pausedFlag ? { paused: true } : {}),
|
|
618
|
+
// Спринт 27.5.10: сохраняем режим входа при переносе задачи.
|
|
619
|
+
...(runWhenLoggedOffFlag ? { runWhenLoggedOff: true } : {}),
|
|
532
620
|
...(mcpEvent ? { mcpEvent } : {}),
|
|
533
621
|
...(allowedTools !== undefined ? { allowedTools } : {}),
|
|
534
622
|
...(deniedTools !== undefined ? { deniedTools } : {}),
|
package/dist/templates.d.ts
CHANGED
|
@@ -28,7 +28,7 @@ export interface TaskTemplate {
|
|
|
28
28
|
nextTaskOnError?: string;
|
|
29
29
|
/** DAG-зависимости: задачи, которые должны успешно завершиться раньше этой. */
|
|
30
30
|
dependsOn?: string[];
|
|
31
|
-
triggerType?: "cron" | "file" | "mcp-event";
|
|
31
|
+
triggerType?: "cron" | "file" | "git" | "mcp-event";
|
|
32
32
|
/** Параметры MCP-события (для triggerType === "mcp-event"). */
|
|
33
33
|
mcpEvent?: {
|
|
34
34
|
server: string;
|
package/dist/templates.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,sDAAsD;AACtD,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAE7D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,4BAA4B;AAC5B,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D"}
|
package/dist/types.d.ts
CHANGED
|
@@ -18,6 +18,17 @@ export declare const STALE_LOCK_MAX_AGE_MS: number;
|
|
|
18
18
|
* Используется единообразно при создании задачи (index.ts) и при чтении логов (schtasks.ts).
|
|
19
19
|
*/
|
|
20
20
|
export declare function sanitizeName(name: string): string;
|
|
21
|
+
/**
|
|
22
|
+
* Проверяет имя задачи до создания файлов и записи в БД.
|
|
23
|
+
*
|
|
24
|
+
* Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».
|
|
25
|
+
* Спецсимволы оболочки (`& | < > ^ % " ' ; ( ) \``, обратный слэш, слэш)
|
|
26
|
+
* и управляющие символы запрещены: даже при безопасном вызове schtasks
|
|
27
|
+
* такие имена ломают пути файлов и переносимы между платформами.
|
|
28
|
+
*
|
|
29
|
+
* @returns текст ошибки или null, если имя допустимо.
|
|
30
|
+
*/
|
|
31
|
+
export declare function validateTaskName(raw: string): string | null;
|
|
21
32
|
/**
|
|
22
33
|
* Схема аргументов для schedule_job.
|
|
23
34
|
* schedule принимает только 5-полевые cron-выражения.
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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"}
|
|
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;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyB3D;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
|
@@ -44,6 +44,38 @@ export function sanitizeName(name) {
|
|
|
44
44
|
result = result.replace(/-+/g, "-").replace(/^-+|-+$/g, "");
|
|
45
45
|
return result || "task";
|
|
46
46
|
}
|
|
47
|
+
/**
|
|
48
|
+
* Проверяет имя задачи до создания файлов и записи в БД.
|
|
49
|
+
*
|
|
50
|
+
* Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».
|
|
51
|
+
* Спецсимволы оболочки (`& | < > ^ % " ' ; ( ) \``, обратный слэш, слэш)
|
|
52
|
+
* и управляющие символы запрещены: даже при безопасном вызове schtasks
|
|
53
|
+
* такие имена ломают пути файлов и переносимы между платформами.
|
|
54
|
+
*
|
|
55
|
+
* @returns текст ошибки или null, если имя допустимо.
|
|
56
|
+
*/
|
|
57
|
+
export function validateTaskName(raw) {
|
|
58
|
+
const name = raw.trim();
|
|
59
|
+
if (!name) {
|
|
60
|
+
return "Имя задачи не может быть пустым.";
|
|
61
|
+
}
|
|
62
|
+
if (/[\u0000-\u001f\u007f]/.test(name)) {
|
|
63
|
+
return "Имя задачи не должно содержать управляющие символы.";
|
|
64
|
+
}
|
|
65
|
+
const invalid = name.match(/[^\p{L}\p{N}_\-. ]/u);
|
|
66
|
+
if (invalid) {
|
|
67
|
+
return (`Имя задачи содержит недопустимый символ «${invalid[0]}». ` +
|
|
68
|
+
"Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».");
|
|
69
|
+
}
|
|
70
|
+
// schtasks ограничивает /tn в 237 символов вместе с папкой планировщика.
|
|
71
|
+
// Префикс "\OpenCode\windows-scheduler\" занимает 28 символов, остаётся 209 на имя задачи.
|
|
72
|
+
const MAX_TASK_NAME_LENGTH = 209;
|
|
73
|
+
if (name.length > MAX_TASK_NAME_LENGTH) {
|
|
74
|
+
return (`Имя задачи "${name}" слишком длинное (${name.length} символов, максимум ${MAX_TASK_NAME_LENGTH} ` +
|
|
75
|
+
`с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).`);
|
|
76
|
+
}
|
|
77
|
+
return null;
|
|
78
|
+
}
|
|
47
79
|
/**
|
|
48
80
|
* Схема аргументов для schedule_job.
|
|
49
81
|
* schedule принимает только 5-полевые cron-выражения.
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -16,6 +16,7 @@ model, the modules, the data model and the extension points.
|
|
|
16
16
|
- [Triggers](#triggers)
|
|
17
17
|
- [Storage](#storage)
|
|
18
18
|
- [Interfaces](#interfaces)
|
|
19
|
+
- [Localization](#localization)
|
|
19
20
|
- [Security model](#security-model)
|
|
20
21
|
- [Extension points](#extension-points)
|
|
21
22
|
|
|
@@ -129,7 +130,8 @@ from their clones instead of their own last run.
|
|
|
129
130
|
| `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
131
|
| `src/workspaces.ts` | Workspace registry and path validation; env pairs and `.env` file resolution with secret masking |
|
|
131
132
|
| `src/templates.ts` | Reusable task templates |
|
|
132
|
-
| `src/settings.ts` | Plugin settings: notifications, history retention, audit |
|
|
133
|
+
| `src/settings.ts` | Plugin settings: notifications, history retention, audit, interface locale |
|
|
134
|
+
| `src/i18n.ts` | Interface locale (`ru` default, `en`), JSON catalogs in `locales/`, ICU subset (`{param}`, `plural`) via built-in `Intl`, fallback to `ru` |
|
|
133
135
|
| `src/notifications.ts` | Multi-channel delivery (webhook, Telegram, native OS) with retries/backoff, templates, task filters, quiet hours, matrix and stuck-clone notifications, daily/weekly digest |
|
|
134
136
|
| `src/core/telegram.ts` | Telegram Bot API `sendMessage`: parse-mode escaping, dashboard link, token validation and masking |
|
|
135
137
|
| `src/core/native-notify.ts` | Native OS notifications: Windows Toast (PowerShell/WinRT), macOS `osascript`, Linux `notify-send`; no external dependency |
|
|
@@ -267,6 +269,7 @@ existing directory. Env keys must match `^[A-Za-z_][A-Za-z0-9_]*$`; max 100 pair
|
|
|
267
269
|
| --- | --- |
|
|
268
270
|
| `cron` | OS scheduler on the translated schedule |
|
|
269
271
|
| `file` | chokidar watches `watchPath`; debounced change starts the task |
|
|
272
|
+
| `git` | Polls `HEAD` in the task working directory; runs when new commits match branch/path/ignore filters |
|
|
270
273
|
| `mcp-event` | `emit_event` RPC/tool matches server + event and starts subscribers |
|
|
271
274
|
|
|
272
275
|
Cron expressions are standard 5-field. The Windows backend supports the subset that
|
|
@@ -314,6 +317,39 @@ never requires a manual migration.
|
|
|
314
317
|
| Sidebar GUI | Human | `gui-experimental.cjs` |
|
|
315
318
|
| Web dashboard | Human | `startDashboardServer` (localhost, random/fixed port) |
|
|
316
319
|
|
|
320
|
+
## Localization
|
|
321
|
+
|
|
322
|
+
User-visible text lives in flat JSON catalogs: `locales/ru.json` (default) and
|
|
323
|
+
`locales/en.json`. Keys are dot-separated and grouped by surface — `gui.*`, `notify.*`,
|
|
324
|
+
`tool.*`, `dryRun.*`, `matrix.*`, `schedule.*` — and both catalogs must have the same
|
|
325
|
+
key set with non-empty values.
|
|
326
|
+
|
|
327
|
+
`src/i18n.ts` loads the catalogs once and caches them. It exposes `t(key, params)`,
|
|
328
|
+
`setLocale(locale)`, `messageIn(locale, key)` and `hasKey(key, locale)`. Lookup order is
|
|
329
|
+
active locale → `en` → `ru` → the key itself, so a missing translation never renders as
|
|
330
|
+
an empty string. The `locale` setting (`ru` default, `en` optional) is applied
|
|
331
|
+
immediately, without restarting OpenCode. The sidebar GUI embeds the catalogs at build
|
|
332
|
+
time via `registerCatalog`, because a webview bundle cannot read package files at
|
|
333
|
+
runtime.
|
|
334
|
+
|
|
335
|
+
The template subset is deliberately small and dependency-free:
|
|
336
|
+
|
|
337
|
+
- `{name}` — interpolation; the caller formats the value (duration, money, date).
|
|
338
|
+
- `{count, plural, one {…} few {…} many {…} other {…}}` — plural forms through
|
|
339
|
+
`Intl.PluralRules` for the active locale (`ru` uses one/few/many, `en` one/other).
|
|
340
|
+
|
|
341
|
+
Rules:
|
|
342
|
+
|
|
343
|
+
- a user-visible message is a whole phrase in the catalog, including punctuation; never
|
|
344
|
+
concatenate translated fragments;
|
|
345
|
+
- store stable codes, not localized text, in the database; translate at render time;
|
|
346
|
+
- agent tool descriptions, schemas and API payloads stay English; `console.*`
|
|
347
|
+
diagnostics stay Russian;
|
|
348
|
+
- add every new key to both catalogs. `test-docs.mjs` enforces parity and non-empty
|
|
349
|
+
values; `npm run test:en` replays all suites under `en` and CI runs it on Linux.
|
|
350
|
+
`OPENCODE_SCHEDULER_LOCALE` only overrides the initial locale for tests and services —
|
|
351
|
+
it is not a user-facing setting.
|
|
352
|
+
|
|
317
353
|
## Security model
|
|
318
354
|
|
|
319
355
|
- The dashboard has **no authentication** and binds to localhost. Do not expose it.
|
package/docs/FEATURES.md
CHANGED
|
@@ -102,6 +102,11 @@ it is never accepted from user input or exported as plain text.
|
|
|
102
102
|
- `notBefore` / `notAfter` — daily launch window in `HH:MM` (may cross midnight,
|
|
103
103
|
e.g. `22:00`–`06:00`). A run that fires outside the window is **postponed**
|
|
104
104
|
until the window opens (once, via a defer-file), not skipped.
|
|
105
|
+
- `activeDays` — allowed weekdays `0`=Sunday … `6`=Saturday (Спринт 27). Empty or
|
|
106
|
+
all seven means every day. Applies to cron and event triggers.
|
|
107
|
+
- `windowPolicy` — behaviour outside the window or on a disallowed day (Спринт 27):
|
|
108
|
+
`postpone` (default) waits for the next opening (max 12 hours), `skip` drops the
|
|
109
|
+
run, `run` executes anyway.
|
|
105
110
|
- `pausedUntil` — pause a task until an ISO moment. `pause_task` accepts
|
|
106
111
|
`until`; the plugin re-enables the task automatically at startup and on a
|
|
107
112
|
5-minute timer, and `resume_task` resumes early.
|
|
@@ -120,6 +125,52 @@ it is never accepted from user input or exported as plain text.
|
|
|
120
125
|
The file is watched with chokidar in the plugin host, changes are debounced. File
|
|
121
126
|
triggers ignore `schedule`.
|
|
122
127
|
|
|
128
|
+
#### Glob-маски для файловых триггеров (Спринт 27)
|
|
129
|
+
|
|
130
|
+
`watchGlobs` и `watchIgnore` ограничивают, какие изменения считаются триггером:
|
|
131
|
+
|
|
132
|
+
```json
|
|
133
|
+
{
|
|
134
|
+
"name": "regen-docs",
|
|
135
|
+
"triggerType": "file",
|
|
136
|
+
"watchPath": "C:\\projects\\site",
|
|
137
|
+
"watchGlobs": ["**/*.md", "**/*.html"],
|
|
138
|
+
"watchIgnore": ["node_modules/**", "**/*.log"],
|
|
139
|
+
"prompt": "Rebuild the static site when docs change."
|
|
140
|
+
}
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Маски поддерживают `*` (не пересекает `/`), `**` (любые сегменты, включая ноль),
|
|
144
|
+
`?` (один символ), `[abc]` / `[a-z]` (классы), `{a,b}` (альтернативы) и `!`
|
|
145
|
+
(отрицание). Пустой `watchGlobs` означает «любое изменение». Пути нормализуются
|
|
146
|
+
к POSIX-виду (`\` → `/`), сравнение регистронезависимое на Windows.
|
|
147
|
+
|
|
148
|
+
### Git triggers (Спринт 27)
|
|
149
|
+
|
|
150
|
+
```json
|
|
151
|
+
{
|
|
152
|
+
"name": "deploy-on-push",
|
|
153
|
+
"triggerType": "git",
|
|
154
|
+
"workingDirectory": "C:\\projects\\api",
|
|
155
|
+
"gitBranch": "main, release/*",
|
|
156
|
+
"gitPaths": ["src/**", "package.json"],
|
|
157
|
+
"gitIgnore": ["**/*.md", "CHANGELOG.md"],
|
|
158
|
+
"gitPollSeconds": 60,
|
|
159
|
+
"prompt": "Deploy the changed services to staging."
|
|
160
|
+
}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Задача с `triggerType: "git"` запускается, когда в её рабочей директории появляется
|
|
164
|
+
новый коммит. Первый опрос только запоминает текущий `HEAD` (baseline) и ничего не
|
|
165
|
+
запускает. Последующие опросы сравнивают `git diff --name-only <last>..HEAD` и
|
|
166
|
+
запускают задачу, если совпадают маски `gitPaths` (пусто — любой файл) и не
|
|
167
|
+
попадают под `gitIgnore`. Фильтр `gitBranch` ограничивает ветки (через запятую,
|
|
168
|
+
поддерживает `*` и `?`).
|
|
169
|
+
|
|
170
|
+
Период опроса `gitPollSeconds` — минимум 5 секунд, по умолчанию 60. Состояние
|
|
171
|
+
(последний обработанный коммит) хранится в таблице SQLite `git_state`, поэтому
|
|
172
|
+
перезапуск плагина не приводит к повторным запускам.
|
|
173
|
+
|
|
123
174
|
### MCP event triggers
|
|
124
175
|
|
|
125
176
|
```json
|
|
@@ -140,6 +191,24 @@ Events are emitted through the `emit_event` RPC method.
|
|
|
140
191
|
- `pause_task` / `resume_task` disable and re-enable the OS entry. For a matrix parent
|
|
141
192
|
every clone is paused.
|
|
142
193
|
|
|
194
|
+
### Logon mode (Windows)
|
|
195
|
+
|
|
196
|
+
By default a task is **interactive only**: Task Scheduler runs it only while the user
|
|
197
|
+
who created it is logged on. That is the safe default — the job sees the user profile,
|
|
198
|
+
mapped drives, the project's `opencode.json` and saved credentials.
|
|
199
|
+
|
|
200
|
+
Some jobs must run outside business hours or on a locked/signed-out machine. Pass
|
|
201
|
+
`runWhenLoggedOff: true` (agent tool `schedule_task` / `update_task`, or the sidebar) to
|
|
202
|
+
register the task as `schtasks /ru SYSTEM` instead. The run then happens in session 0,
|
|
203
|
+
without the user's profile, mapped drives, network shares or saved credentials. Tasks
|
|
204
|
+
that depend on the user environment can fail with `Access is denied` or missing files,
|
|
205
|
+
so check them with `dry_run` first and prefer absolute paths.
|
|
206
|
+
|
|
207
|
+
`runWhenLoggedOff` is Windows-only: Linux crontab already runs without a logged-on user,
|
|
208
|
+
and a macOS launchd agent runs only inside a user session. `list_tasks` reports both the
|
|
209
|
+
OS value (`logonMode`) and the plugin setting (`runWhenLoggedOff`); `dry_run` shows the
|
|
210
|
+
same pair before the task is registered.
|
|
211
|
+
|
|
143
212
|
## Execution policy
|
|
144
213
|
|
|
145
214
|
### Timeout and no-overlap
|
|
@@ -503,6 +572,7 @@ plugin, no installation step required.
|
|
|
503
572
|
| File triggers | chokidar | chokidar | chokidar |
|
|
504
573
|
| History, metrics, dashboard | yes | yes | yes |
|
|
505
574
|
| Agent tools and skill | yes | yes | yes |
|
|
575
|
+
| Runs without a logged-on user | opt-in (`runWhenLoggedOff`) | always (crontab) | no (per-user agent) |
|
|
506
576
|
|
|
507
577
|
## Limits and non-goals
|
|
508
578
|
|
package/docs/README.ru.md
CHANGED
|
@@ -35,12 +35,18 @@ English version: [README.md](../README.md).
|
|
|
35
35
|
| Надёжность | lock-файл от наложения запусков, таймауты с жёстким kill, повторы с задержкой, crash recovery |
|
|
36
36
|
| Качество | команда Quality Gate, before/after hooks, allow/deny списки инструментов для задачи |
|
|
37
37
|
| Оркестрация | DAG `dependsOn`, цепочки `nextTaskOnSuccess` / `nextTaskOnError`, матричный fan-out (parallel/sequential, `continue`/`stop`, concurrency, переопределения для workspace, агрегатор) |
|
|
38
|
-
| Триггеры | cron, одноразовый запуск (`triggerType: "once"`), изменение файла (chokidar), MCP-события, входящие webhooks (`POST /api/hooks/:task` с HMAC) |
|
|
38
|
+
| Триггеры | cron, одноразовый запуск (`triggerType: "once"`), git-коммиты (`triggerType: "git"`, фильтры ветки/путей/игнорирования), изменение файла (chokidar, glob-маски `watchGlobs`/`watchIgnore`), MCP-события, входящие webhooks (`POST /api/hooks/:task` с HMAC) |
|
|
39
39
|
| Мультирепо | workspaces с валидацией путей, запуски по workspace, матрица поверх родительской задачи |
|
|
40
40
|
| Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), JSONL-логи с `/api/logs`, Prometheus `/metrics`, экспорт OTLP, логи по задачам, веб-дашборд с аналитикой за 14 дней, ретеншн истории и экспорт CSV/JSON |
|
|
41
41
|
| Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, уведомления по нескольким каналам (webhook, Telegram, нативные toast), тихие часы, дайджест, зашифрованные секреты (`${secret:NAME}`), журнал аудита, настройки |
|
|
42
42
|
| Интерфейсы | панель OpenCode GUI, веб-дашборд, 24 инструмента для агента, встроенный скилл |
|
|
43
43
|
|
|
44
|
+
### Язык интерфейса
|
|
45
|
+
|
|
46
|
+
Интерфейс доступен на русском (по умолчанию) и английском. Язык переключается в настройках сайдбара (Настройки → Язык) или инструментом `manage_settings` (`action: "update"`, `locale: "en"`). Изменение применяется сразу к панели, уведомлениям и дайджесту, дашборду и результатам инструментов агента — перезапуск не нужен. Описания и схемы инструментов агента остаются английскими, диагностика в консоли — русской.
|
|
47
|
+
|
|
48
|
+
Каталоги лежат в `locales/ru.json` и `locales/en.json`; набор ключей в них должен совпадать, иначе CI падает.
|
|
49
|
+
|
|
44
50
|
## Установка
|
|
45
51
|
|
|
46
52
|
Нужны OpenCode v2 и Node.js 20+.
|
|
@@ -84,7 +90,7 @@ npm run build && npm run build:gui
|
|
|
84
90
|
|
|
85
91
|
| Инструмент | Аргументы | Что делает |
|
|
86
92
|
|---|---|---|
|
|
87
|
-
| `schedule_task` | `name`, `prompt`, `schedule` для cron или `runAt` / `delaySeconds` для одноразового запуска, опционально `session` / `sessionMaxRuns`, `timeoutSeconds`, `model`, `priority`, `beforeScript`, `afterScript`, `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError`, `triggerType
|
|
93
|
+
| `schedule_task` | `name`, `prompt`, `schedule` для cron или `runAt` / `delaySeconds` для одноразового запуска, опционально `session` / `sessionMaxRuns`, `timeoutSeconds`, `model`, `priority`, `beforeScript`, `afterScript`, `qualityGate`, `dependsOn`, `retryCount`, `retryDelay`, `nextTaskOnSuccess`, `nextTaskOnError`, `triggerType` (`cron`/`file`/`git`/`mcp-event`/`once`), `mcpEvent`, `watchPath`, `watchGlobs`, `watchIgnore`, `gitBranch`, `gitPaths`, `gitIgnore`, `gitPollSeconds`, `activeDays`, `windowPolicy` (`skip`/`postpone`/`run`), `workingDirectory`, `workspaceId`, `allowedTools`, `deniedTools`, `matrix` | Регистрирует задачу в планировщике ОС (cron, одноразовый запуск, файл, git или MCP-событие) |
|
|
88
94
|
| `list_tasks` | — | Задачи: расписание, статус, следующее время запуска, цепочки, workspace, сводка матрицы |
|
|
89
95
|
| `update_task` | `name` + изменяемые поля | Частичное обновление: незаданные поля сохраняются, пустые — очищаются, `matrix: null` убирает матрицу |
|
|
90
96
|
| `delete_task` | `name` | Удаляет задачу (родитель матрицы — вместе с клонами и агрегатором) |
|
|
@@ -168,15 +174,22 @@ src/
|
|
|
168
174
|
|
|
169
175
|
Обёртки задач запускают `opencode run` в рабочей директории задачи, поэтому MCP-серверы проекта подхватываются автоматически.
|
|
170
176
|
|
|
177
|
+
### Режим входа (Windows)
|
|
178
|
+
|
|
179
|
+
По умолчанию задачи **интерактивные** (`Interactive only`): Планировщик Windows запускает их только при активном входе пользователя, создавшего задачу, — с обычным профилем, дисками и сохранёнными учётными данными. Передайте `runWhenLoggedOff: true`, чтобы задача работала без входа (`schtasks /ru SYSTEM`). Такая задача идёт в session 0 — без профиля пользователя, подключённых дисков, сетевых ресурсов и сохранённых паролей, поэтому задачи, которым нужно ваше окружение, могут упасть; проверяйте их через `dry_run`. На Linux crontab и так работает без входа, а launchd-агент macOS — только внутри пользовательской сессии.
|
|
180
|
+
|
|
171
181
|
## Разработка
|
|
172
182
|
|
|
173
183
|
```bash
|
|
174
184
|
npm install
|
|
175
185
|
npm run build # tsc
|
|
176
186
|
npm run build:gui # vite
|
|
177
|
-
npm test #
|
|
187
|
+
npm test # 33 сюиты, 500+ проверок
|
|
188
|
+
npm run test:en # те же сюиты с английской локалью
|
|
178
189
|
```
|
|
179
190
|
|
|
191
|
+
`npm run test:en` выставляет `OPENCODE_SCHEDULER_LOCALE=en` для каждой сюиты; переменная нужна тестам и сервисам, это не пользовательская настройка.
|
|
192
|
+
|
|
180
193
|
Подробности — в [CONTRIBUTING.md](../CONTRIBUTING.md).
|
|
181
194
|
|
|
182
195
|
## Документация
|
|
@@ -190,6 +203,9 @@ npm test # полный набор тестов, 500+ проверо
|
|
|
190
203
|
**Работает ли плагин, когда OpenCode закрыт?**
|
|
191
204
|
Да. Задачи регистрируются в нативном планировщике ОС, поэтому выполняются без открытого OpenCode.
|
|
192
205
|
|
|
206
|
+
**Выполняются ли задачи, когда никто не вошёл в систему?**
|
|
207
|
+
На Windows — только если явно включить `runWhenLoggedOff: true`: задача регистрируется как `schtasks /ru SYSTEM` и идёт в session 0 без вашего профиля, подключённых дисков и сохранённых учётных данных. По умолчанию задача интерактивная и работает при активном входе. Linux crontab выполняет задачи и без входа, а launchd-агент macOS — только внутри пользовательской сессии.
|
|
208
|
+
|
|
193
209
|
**Какие платформы поддерживаются?**
|
|
194
210
|
Windows (Планировщик Windows), macOS (launchd) и Linux (crontab). Различия описаны в [CROSS_PLATFORM.md](../CROSS_PLATFORM.md).
|
|
195
211
|
|