opencode-windows-scheduler 1.1.0 → 1.2.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 +60 -1
- package/README.md +18 -8
- package/README.ru.md +13 -3
- package/ROADMAP-STRATEGY.md +2 -2
- package/ROADMAP.md +51 -18
- package/dist/core/analytics.d.ts +10 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +21 -0
- package/dist/core/dry-run.d.ts +18 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +49 -3
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +10 -0
- package/dist/core/one-shot.d.ts +62 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +126 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +36 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +124 -4
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +9 -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/linux.d.ts +12 -3
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +80 -3
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +17 -3
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +3 -0
- package/dist/core/scheduler/registry.d.ts +4 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/types.d.ts +20 -3
- 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 +23 -2
- package/dist/core/session.d.ts +34 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +105 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +137 -0
- package/dist/core/wrappers/bash.d.ts +24 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +70 -3
- 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 +76 -6
- package/dist/db/metrics-repo.d.ts +3 -0
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +16 -8
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +8 -1
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +19 -0
- package/dist/gui-experimental.cjs +1 -0
- package/dist/history.d.ts +7 -0
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +13 -0
- package/dist/index.d.ts +137 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1323 -78
- package/dist/integrations.d.ts +64 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +205 -0
- 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 +592 -4
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +233 -6
- package/dist/server.d.ts +2 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +473 -58
- package/dist/settings.d.ts +95 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +186 -8
- package/dist/shared/jobs-view.d.ts +43 -5
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +125 -7
- package/dist/task-transfer.d.ts +32 -3
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +101 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +3 -11
- 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 +32 -12
- package/docs/FEATURES.md +186 -10
- package/gui-experimental.cjs +4 -2
- package/package.json +15 -2
- package/scripts/demo-dashboard.mjs +12 -2
- package/src/core/analytics.ts +36 -0
- package/src/core/dry-run.ts +65 -4
- package/src/core/matrix.ts +10 -0
- package/src/core/one-shot.ts +173 -0
- package/src/core/otel.ts +128 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +144 -4
- package/src/core/record-history.ts +13 -0
- package/src/core/schedule-gate.ts +213 -0
- package/src/core/schedule-v2.ts +533 -0
- package/src/core/scheduler/linux.ts +90 -3
- package/src/core/scheduler/mac.ts +35 -4
- package/src/core/scheduler/posix.ts +3 -0
- package/src/core/scheduler/registry.ts +4 -0
- package/src/core/scheduler/types.ts +20 -3
- package/src/core/scheduler/windows.ts +24 -2
- package/src/core/session.ts +115 -0
- package/src/core/structured-log.ts +205 -0
- package/src/core/wrappers/bash.ts +98 -2
- package/src/db/history-repo.ts +90 -7
- package/src/db/metrics-repo.ts +19 -7
- package/src/db/migrate.ts +7 -1
- package/src/db/schema.ts +25 -0
- package/src/gui.tsx +3832 -2868
- package/src/history.ts +17 -0
- package/src/index.ts +1670 -117
- package/src/integrations.ts +253 -0
- package/src/notifications.ts +516 -40
- package/src/profiles.ts +236 -0
- package/src/rpc.ts +244 -6
- package/src/server.ts +506 -58
- package/src/settings.ts +336 -9
- package/src/shared/jobs-view.ts +158 -8
- package/src/task-transfer.ts +151 -5
- package/src/tui.tsx +290 -14
- package/src/types.ts +3 -13
- package/src/workspaces.ts +214 -8
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
import { getAllMetrics } from "../db/metrics-repo.js";
|
|
2
|
+
import { countHistory, countRunningRecords, getHistory } from "../db/history-repo.js";
|
|
3
|
+
import { getPluginVersion } from "../version.js";
|
|
4
|
+
import { getProfileName } from "../profiles.js";
|
|
5
|
+
import { getSchedulerTitle } from "./scheduler/index.js";
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Prometheus-метрики (Спринт 22).
|
|
9
|
+
*
|
|
10
|
+
* Формат — текстовый exposition format 0.0.4, отдаётся по GET /metrics.
|
|
11
|
+
* Никаких клиентских библиотек: собираем снимок из SQLite и рендерим строку.
|
|
12
|
+
*
|
|
13
|
+
* Имена метрик стабильны и документированы в docs/FEATURES.md:
|
|
14
|
+
* opencode_scheduler_info
|
|
15
|
+
* opencode_scheduler_up
|
|
16
|
+
* opencode_scheduler_queue_depth
|
|
17
|
+
* opencode_scheduler_history_records
|
|
18
|
+
* opencode_scheduler_runs_total{task,status}
|
|
19
|
+
* opencode_scheduler_errors_total{task}
|
|
20
|
+
* opencode_scheduler_tokens_total{task}
|
|
21
|
+
* opencode_scheduler_cost_usd_total{task}
|
|
22
|
+
* opencode_scheduler_run_duration_seconds{task,le} (+ _sum/_count)
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
export const PROMETHEUS_CONTENT_TYPE = "text/plain; version=0.0.4; charset=utf-8";
|
|
26
|
+
|
|
27
|
+
const DURATION_BUCKETS_SECONDS = [1, 5, 15, 30, 60, 120, 300, 600, 1800, 3600];
|
|
28
|
+
|
|
29
|
+
/** Экранирование значения label по правилам Prometheus. */
|
|
30
|
+
export function escapePrometheusLabel(value: string): string {
|
|
31
|
+
return String(value)
|
|
32
|
+
.replace(/\\/g, "\\\\")
|
|
33
|
+
.replace(/"/g, '\\"')
|
|
34
|
+
.replace(/\n/g, "\\n");
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function labels(pairs: Record<string, string | number>): string {
|
|
38
|
+
const entries = Object.entries(pairs);
|
|
39
|
+
if (entries.length === 0) return "";
|
|
40
|
+
return `{${entries
|
|
41
|
+
.map(([key, value]) => `${key}="${escapePrometheusLabel(String(value))}"`)
|
|
42
|
+
.join(",")}}`;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function formatNumber(value: number): string {
|
|
46
|
+
if (!Number.isFinite(value)) return "0";
|
|
47
|
+
if (Number.isInteger(value)) return String(value);
|
|
48
|
+
return value.toFixed(6).replace(/0+$/, "").replace(/\.$/, "");
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function metric(
|
|
52
|
+
lines: string[],
|
|
53
|
+
name: string,
|
|
54
|
+
type: "counter" | "gauge" | "histogram",
|
|
55
|
+
help: string,
|
|
56
|
+
samples: Array<{ labels?: Record<string, string | number>; value: number }>
|
|
57
|
+
): void {
|
|
58
|
+
lines.push(`# HELP ${name} ${help}`);
|
|
59
|
+
lines.push(`# TYPE ${name} ${type}`);
|
|
60
|
+
for (const sample of samples) {
|
|
61
|
+
lines.push(`${name}${labels(sample.labels ?? {})} ${formatNumber(sample.value)}`);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
interface DurationStats {
|
|
66
|
+
buckets: number[];
|
|
67
|
+
sumSeconds: number;
|
|
68
|
+
count: number;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function emptyDurationStats(): DurationStats {
|
|
72
|
+
return { buckets: new Array(DURATION_BUCKETS_SECONDS.length).fill(0), sumSeconds: 0, count: 0 };
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** Собирает и рендерит снимок метрик. Чистая функция от состояния БД. */
|
|
76
|
+
export function renderPrometheusMetrics(): string {
|
|
77
|
+
const metrics = getAllMetrics(false);
|
|
78
|
+
const history = getHistory(null, 100000);
|
|
79
|
+
const queueDepth = countRunningRecords();
|
|
80
|
+
const historyRecords = countHistory();
|
|
81
|
+
|
|
82
|
+
const durations = new Map<string, DurationStats>();
|
|
83
|
+
for (const record of history) {
|
|
84
|
+
if (record.status === "running") continue;
|
|
85
|
+
const durationMs = Number(record.durationMs ?? 0);
|
|
86
|
+
if (!Number.isFinite(durationMs) || durationMs < 0) continue;
|
|
87
|
+
const task = record.taskName;
|
|
88
|
+
const stats = durations.get(task) ?? emptyDurationStats();
|
|
89
|
+
const seconds = durationMs / 1000;
|
|
90
|
+
stats.sumSeconds += seconds;
|
|
91
|
+
stats.count += 1;
|
|
92
|
+
for (let i = 0; i < DURATION_BUCKETS_SECONDS.length; i += 1) {
|
|
93
|
+
if (seconds <= DURATION_BUCKETS_SECONDS[i]) stats.buckets[i] += 1;
|
|
94
|
+
}
|
|
95
|
+
durations.set(task, stats);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
const lines: string[] = [];
|
|
99
|
+
|
|
100
|
+
metric(lines, "opencode_scheduler_info", "gauge", "Информация о планировщике.", [
|
|
101
|
+
{
|
|
102
|
+
labels: {
|
|
103
|
+
version: getPluginVersion(),
|
|
104
|
+
profile: getProfileName(),
|
|
105
|
+
scheduler: getSchedulerTitle(),
|
|
106
|
+
},
|
|
107
|
+
value: 1,
|
|
108
|
+
},
|
|
109
|
+
]);
|
|
110
|
+
metric(lines, "opencode_scheduler_up", "gauge", "1 — HTTP-сервер метрик доступен.", [
|
|
111
|
+
{ value: 1 },
|
|
112
|
+
]);
|
|
113
|
+
metric(
|
|
114
|
+
lines,
|
|
115
|
+
"opencode_scheduler_queue_depth",
|
|
116
|
+
"gauge",
|
|
117
|
+
"Количество незавершённых запусков (глубина очереди).",
|
|
118
|
+
[{ value: queueDepth }]
|
|
119
|
+
);
|
|
120
|
+
metric(
|
|
121
|
+
lines,
|
|
122
|
+
"opencode_scheduler_history_records",
|
|
123
|
+
"gauge",
|
|
124
|
+
"Количество записей в истории запусков.",
|
|
125
|
+
[{ value: historyRecords }]
|
|
126
|
+
);
|
|
127
|
+
|
|
128
|
+
const runSamples: Array<{ labels: Record<string, string | number>; value: number }> = [];
|
|
129
|
+
const errorSamples: Array<{ labels: Record<string, string | number>; value: number }> = [];
|
|
130
|
+
const tokenSamples: Array<{ labels: Record<string, string | number>; value: number }> = [];
|
|
131
|
+
const costSamples: Array<{ labels: Record<string, string | number>; value: number }> = [];
|
|
132
|
+
for (const row of metrics) {
|
|
133
|
+
runSamples.push({
|
|
134
|
+
labels: { task: row.taskName, status: "success" },
|
|
135
|
+
value: row.success,
|
|
136
|
+
});
|
|
137
|
+
runSamples.push({
|
|
138
|
+
labels: { task: row.taskName, status: "error" },
|
|
139
|
+
value: row.error,
|
|
140
|
+
});
|
|
141
|
+
runSamples.push({
|
|
142
|
+
labels: { task: row.taskName, status: "partial" },
|
|
143
|
+
value: row.partial,
|
|
144
|
+
});
|
|
145
|
+
errorSamples.push({ labels: { task: row.taskName }, value: row.error });
|
|
146
|
+
tokenSamples.push({ labels: { task: row.taskName }, value: row.tokens });
|
|
147
|
+
costSamples.push({ labels: { task: row.taskName }, value: row.costUsd });
|
|
148
|
+
}
|
|
149
|
+
metric(
|
|
150
|
+
lines,
|
|
151
|
+
"opencode_scheduler_runs_total",
|
|
152
|
+
"counter",
|
|
153
|
+
"Количество завершённых запусков по задачам и статусам.",
|
|
154
|
+
runSamples
|
|
155
|
+
);
|
|
156
|
+
metric(
|
|
157
|
+
lines,
|
|
158
|
+
"opencode_scheduler_errors_total",
|
|
159
|
+
"counter",
|
|
160
|
+
"Количество ошибок и таймаутов по задачам (partial не входит).",
|
|
161
|
+
errorSamples
|
|
162
|
+
);
|
|
163
|
+
metric(
|
|
164
|
+
lines,
|
|
165
|
+
"opencode_scheduler_tokens_total",
|
|
166
|
+
"counter",
|
|
167
|
+
"Суммарное количество токенов по задачам.",
|
|
168
|
+
tokenSamples
|
|
169
|
+
);
|
|
170
|
+
metric(
|
|
171
|
+
lines,
|
|
172
|
+
"opencode_scheduler_cost_usd_total",
|
|
173
|
+
"counter",
|
|
174
|
+
"Суммарная стоимость запусков в USD по задачам.",
|
|
175
|
+
costSamples
|
|
176
|
+
);
|
|
177
|
+
|
|
178
|
+
lines.push(
|
|
179
|
+
"# HELP opencode_scheduler_run_duration_seconds Длительность запусков в секундах."
|
|
180
|
+
);
|
|
181
|
+
lines.push("# TYPE opencode_scheduler_run_duration_seconds histogram");
|
|
182
|
+
const taskNames = Array.from(durations.keys()).sort((a, b) => a.localeCompare(b));
|
|
183
|
+
for (const task of taskNames) {
|
|
184
|
+
const stats = durations.get(task)!;
|
|
185
|
+
let cumulative = 0;
|
|
186
|
+
for (let i = 0; i < DURATION_BUCKETS_SECONDS.length; i += 1) {
|
|
187
|
+
cumulative += stats.buckets[i];
|
|
188
|
+
lines.push(
|
|
189
|
+
`opencode_scheduler_run_duration_seconds_bucket${labels({
|
|
190
|
+
task,
|
|
191
|
+
le: DURATION_BUCKETS_SECONDS[i],
|
|
192
|
+
})} ${cumulative}`
|
|
193
|
+
);
|
|
194
|
+
}
|
|
195
|
+
lines.push(
|
|
196
|
+
`opencode_scheduler_run_duration_seconds_bucket${labels({ task, le: "+Inf" })} ${stats.count}`
|
|
197
|
+
);
|
|
198
|
+
lines.push(
|
|
199
|
+
`opencode_scheduler_run_duration_seconds_sum${labels({ task })} ${formatNumber(
|
|
200
|
+
stats.sumSeconds
|
|
201
|
+
)}`
|
|
202
|
+
);
|
|
203
|
+
lines.push(
|
|
204
|
+
`opencode_scheduler_run_duration_seconds_count${labels({ task })} ${stats.count}`
|
|
205
|
+
);
|
|
206
|
+
}
|
|
207
|
+
if (taskNames.length === 0) {
|
|
208
|
+
// Пустой histogram всё равно должен быть валидным: отдаём +Inf = 0.
|
|
209
|
+
lines.push(`opencode_scheduler_run_duration_seconds_bucket${labels({ le: "+Inf" })} 0`);
|
|
210
|
+
lines.push("opencode_scheduler_run_duration_seconds_sum 0");
|
|
211
|
+
lines.push("opencode_scheduler_run_duration_seconds_count 0");
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
return `${lines.join("\n")}\n`;
|
|
215
|
+
}
|
package/src/core/ps-wrapper.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import fs from "node:fs/promises";
|
|
2
2
|
import path from "node:path";
|
|
3
|
-
import { PLUGIN_DIR, LOG_DIR, WRAPPER_DIR } from "../types.js";
|
|
3
|
+
import { PLUGIN_DIR, LOG_DIR, LOCK_DIR, WRAPPER_DIR, sanitizeName } from "../types.js";
|
|
4
|
+
import type { ScheduleGateSpec } from "./schedule-v2.js";
|
|
4
5
|
|
|
5
6
|
/**
|
|
6
7
|
* Путь к единому generic-обёртке PowerShell, которая реализует запуск opencode run
|
|
@@ -44,7 +45,10 @@ export const WRAPPER_SCRIPT = `param(
|
|
|
44
45
|
[string]$RecorderFile,
|
|
45
46
|
[string]$QualityGate,
|
|
46
47
|
[string]$BeforeScript,
|
|
47
|
-
[string]$AfterScript
|
|
48
|
+
[string]$AfterScript,
|
|
49
|
+
[string]$EnvFile,
|
|
50
|
+
[string]$SessionMode,
|
|
51
|
+
[string]$SessionId
|
|
48
52
|
)
|
|
49
53
|
|
|
50
54
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
@@ -289,14 +293,34 @@ try {
|
|
|
289
293
|
if (-not $script:skipMainTask) {
|
|
290
294
|
$prompt = Get-Content -Path $PromptFile -Raw -Encoding UTF8
|
|
291
295
|
|
|
296
|
+
# Спринт 21: env-переменные workspace. Файл пишет плагин, значения не логируются.
|
|
297
|
+
if ($EnvFile -and (Test-Path -LiteralPath $EnvFile)) {
|
|
298
|
+
try {
|
|
299
|
+
Get-Content -Path $EnvFile -Encoding UTF8 | ForEach-Object {
|
|
300
|
+
$line = $_.Trim()
|
|
301
|
+
if ($line -and -not $line.StartsWith("#") -and $line -match "^([A-Za-z_][A-Za-z0-9_]*)=(.*)$") {
|
|
302
|
+
Set-Item -Path ("env:" + $matches[1]) -Value $matches[2]
|
|
303
|
+
}
|
|
304
|
+
}
|
|
305
|
+
Write-Log "[windows-scheduler] Переменные окружения workspace загружены."
|
|
306
|
+
} catch {
|
|
307
|
+
Write-Log "[windows-scheduler] Не удалось загрузить env-файл workspace: $($_.Exception.Message)"
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
|
|
292
311
|
# Получаем путь к скрипту opencode (.ps1 или .cmd)
|
|
293
312
|
$opencodeCmd = Get-Command opencode | Select-Object -ExpandProperty Source
|
|
294
313
|
|
|
295
|
-
# Формируем аргументы для opencode run
|
|
314
|
+
# Формируем аргументы для opencode run (Спринт 24: сессия).
|
|
296
315
|
$opencodeArgs = @("run")
|
|
297
316
|
if ($Model) {
|
|
298
317
|
$opencodeArgs += @("--model", $Model)
|
|
299
318
|
}
|
|
319
|
+
if ($SessionMode -eq 'reuse' -and $SessionId) {
|
|
320
|
+
$opencodeArgs += @("--session", $SessionId)
|
|
321
|
+
} elseif ($SessionMode -eq 'last') {
|
|
322
|
+
$opencodeArgs += @("--continue")
|
|
323
|
+
}
|
|
300
324
|
if ($prompt) {
|
|
301
325
|
$opencodeArgs += $prompt
|
|
302
326
|
}
|
|
@@ -467,6 +491,12 @@ export function lockFilePath(taskName: string): string {
|
|
|
467
491
|
* @param workspaceName имя workspace для git-контекста в логе (опционально)
|
|
468
492
|
* @param allowedTools список разрешённых инструментов (спринт 14, опционально)
|
|
469
493
|
* @param deniedTools список запрещённых инструментов (спринт 14, опционально)
|
|
494
|
+
* @param scheduleGate гейт расписания (спринт 19): проверка cron в таймзоне
|
|
495
|
+
* и окна запуска перед стартом PowerShell-обёртки.
|
|
496
|
+
* @param envFile env-файл workspace (спринт 21, опционально)
|
|
497
|
+
* @param sessionMode режим сессии OpenCode (спринт 24): "new" (по умолчанию,
|
|
498
|
+
* без флагов), "reuse" (--session $SessionId), "last" (--continue)
|
|
499
|
+
* @param sessionId идентификатор сессии для режима "reuse" (спринт 24, опционально)
|
|
470
500
|
*/
|
|
471
501
|
export async function writeWrapperCmd(
|
|
472
502
|
sanitizedName: string,
|
|
@@ -483,7 +513,16 @@ export async function writeWrapperCmd(
|
|
|
483
513
|
afterScript?: string,
|
|
484
514
|
workspaceName?: string,
|
|
485
515
|
allowedTools?: string[],
|
|
486
|
-
deniedTools?: string[]
|
|
516
|
+
deniedTools?: string[],
|
|
517
|
+
scheduleGate?: ScheduleGateSpec & {
|
|
518
|
+
gateFile: string;
|
|
519
|
+
deferFile?: string;
|
|
520
|
+
forceFile?: string;
|
|
521
|
+
forceTtlMs?: number;
|
|
522
|
+
},
|
|
523
|
+
envFile?: string,
|
|
524
|
+
sessionMode?: "new" | "reuse" | "last",
|
|
525
|
+
sessionId?: string
|
|
487
526
|
): Promise<string> {
|
|
488
527
|
await fs.mkdir(WRAPPER_DIR, { recursive: true });
|
|
489
528
|
const cmdPath = path.join(WRAPPER_DIR, `run-${sanitizedName}.cmd`);
|
|
@@ -557,6 +596,27 @@ export async function writeWrapperCmd(
|
|
|
557
596
|
}
|
|
558
597
|
}
|
|
559
598
|
|
|
599
|
+
// Спринт 21: env-файл workspace (пары KEY=VALUE). Значения не логируются.
|
|
600
|
+
if (envFile?.trim()) {
|
|
601
|
+
const safeEnvFile = envFile.replace(/[\r\n"]+/g, "").trim();
|
|
602
|
+
if (safeEnvFile) {
|
|
603
|
+
psArgs.push(`-EnvFile "${safeEnvFile}"`);
|
|
604
|
+
}
|
|
605
|
+
}
|
|
606
|
+
|
|
607
|
+
// Спринт 24: режим сессии OpenCode. sessionId передаём только для reuse.
|
|
608
|
+
const safeSessionMode =
|
|
609
|
+
sessionMode === "reuse" || sessionMode === "last" ? sessionMode : "new";
|
|
610
|
+
if (safeSessionMode !== "new") {
|
|
611
|
+
psArgs.push(`-SessionMode "${safeSessionMode}"`);
|
|
612
|
+
if (safeSessionMode === "reuse") {
|
|
613
|
+
const safeSessionId = (sessionId ?? "").replace(/[\r\n"]+/g, "").trim();
|
|
614
|
+
if (safeSessionId) {
|
|
615
|
+
psArgs.push(`-SessionId "${safeSessionId}"`);
|
|
616
|
+
}
|
|
617
|
+
}
|
|
618
|
+
}
|
|
619
|
+
|
|
560
620
|
const lines: string[] = ["@echo off", "chcp 65001 >nul"];
|
|
561
621
|
|
|
562
622
|
// Рабочая директория: всегда переходим в неё ДО запуска PowerShell.
|
|
@@ -565,8 +625,88 @@ export async function writeWrapperCmd(
|
|
|
565
625
|
const effectiveWorkdir = workdir?.trim() || process.cwd();
|
|
566
626
|
lines.push(`cd /d "${effectiveWorkdir}"`);
|
|
567
627
|
|
|
628
|
+
// Спринт 19: гейт расписания ДО PowerShell. Проверяет, что cron реально
|
|
629
|
+
// сработал сейчас (для poll-режима и чужих таймзон), и при необходимости
|
|
630
|
+
// переносит запуск до открытия окна notBefore..notAfter.
|
|
631
|
+
// Exit 3 — «не сейчас», выходим тихо, не считая это запуском задачи.
|
|
632
|
+
if (scheduleGate?.gateFile) {
|
|
633
|
+
const gateArgs = [`node "${scheduleGate.gateFile}"`];
|
|
634
|
+
if (scheduleGate.cron?.trim()) {
|
|
635
|
+
gateArgs.push(`--cron "${scheduleGate.cron.replace(/[\r\n"]+/g, " ").trim()}"`);
|
|
636
|
+
}
|
|
637
|
+
if (scheduleGate.tz?.trim()) {
|
|
638
|
+
gateArgs.push(`--tz "${scheduleGate.tz.trim()}"`);
|
|
639
|
+
}
|
|
640
|
+
if (scheduleGate.notBefore?.trim()) {
|
|
641
|
+
gateArgs.push(`--not-before ${scheduleGate.notBefore.trim()}`);
|
|
642
|
+
}
|
|
643
|
+
if (scheduleGate.notAfter?.trim()) {
|
|
644
|
+
gateArgs.push(`--not-after ${scheduleGate.notAfter.trim()}`);
|
|
645
|
+
}
|
|
646
|
+
if (scheduleGate.deferFile?.trim()) {
|
|
647
|
+
gateArgs.push(`--defer-file "${scheduleGate.deferFile.trim()}"`);
|
|
648
|
+
}
|
|
649
|
+
// Маркер ручного запуска: run_task_now/файловый триггер/MCP-событие
|
|
650
|
+
// создают его перед вызовом schtasks /run, чтобы gate не отсекал запуск
|
|
651
|
+
// по cron. Без этого run_task_now был тихим no-op для poll-режима.
|
|
652
|
+
if (scheduleGate.forceFile?.trim()) {
|
|
653
|
+
gateArgs.push(`--force-file "${scheduleGate.forceFile.trim()}"`);
|
|
654
|
+
}
|
|
655
|
+
// append к логу задачи, чтобы перенос/пропуск был виден в истории запусков
|
|
656
|
+
if (logFile?.trim()) {
|
|
657
|
+
gateArgs.push(`>> "${logFile.trim()}" 2>&1`);
|
|
658
|
+
}
|
|
659
|
+
lines.push(gateArgs.join(" "));
|
|
660
|
+
lines.push(`if "%errorlevel%"=="3" exit /b 0`);
|
|
661
|
+
}
|
|
662
|
+
|
|
568
663
|
lines.push(psArgs.join(" "));
|
|
569
664
|
|
|
570
665
|
await fs.writeFile(cmdPath, lines.join("\r\n"), "utf8");
|
|
571
666
|
return cmdPath;
|
|
572
667
|
}
|
|
668
|
+
|
|
669
|
+
// ---------------------------------------------------------------------------
|
|
670
|
+
// Маркер ручного запуска.
|
|
671
|
+
|
|
672
|
+
/** Сколько живёт маркер ручного запуска (должно совпадать с schedule-gate.ts). */
|
|
673
|
+
export const FORCE_FILE_TTL_MS = 2 * 60 * 1000;
|
|
674
|
+
|
|
675
|
+
/**
|
|
676
|
+
* Путь к маркеру немедленного запуска задачи.
|
|
677
|
+
*
|
|
678
|
+
* Лежит рядом с lock-файлом и вычисляется из того же санитизированного имени,
|
|
679
|
+
* поэтому обёртка (--force-file) и агент указывают на один и тот же файл.
|
|
680
|
+
*/
|
|
681
|
+
export function forceFilePath(taskName: string): string {
|
|
682
|
+
return `${lockFilePath(sanitizeName(taskName))}.force`;
|
|
683
|
+
}
|
|
684
|
+
|
|
685
|
+
/**
|
|
686
|
+
* Создаёт маркер «запустить сейчас» перед вызовом планировщика ОС.
|
|
687
|
+
*
|
|
688
|
+
* Зачем: для poll-режима (нестандартный cron/чужая таймзона/окно запуска)
|
|
689
|
+
* обёртка всегда прогоняет schedule-gate, и ручной запуск вне cron-окна
|
|
690
|
+
* молча завершался с exit 3 — инструмент рапортовал success, но задача не
|
|
691
|
+
* выполнялась. Gate поглощает свежий маркер и пропускает проверку расписания.
|
|
692
|
+
*
|
|
693
|
+
* Маркер самоуничтожается через FORCE_FILE_TTL_MS, если задача так и не
|
|
694
|
+
* стартовала (например, отключена в планировщике), чтобы не влиять на
|
|
695
|
+
* последующие плановые запуски.
|
|
696
|
+
*/
|
|
697
|
+
export async function requestImmediateRun(taskName: string): Promise<string> {
|
|
698
|
+
const file = forceFilePath(taskName);
|
|
699
|
+
await fs.mkdir(LOCK_DIR, { recursive: true });
|
|
700
|
+
await fs.writeFile(file, new Date().toISOString(), "utf8");
|
|
701
|
+
|
|
702
|
+
const timer = setTimeout(() => {
|
|
703
|
+
void fs.unlink(file).catch(() => {
|
|
704
|
+
/* маркер уже поглощён gate'ом или удалён вручную */
|
|
705
|
+
});
|
|
706
|
+
}, FORCE_FILE_TTL_MS);
|
|
707
|
+
// Таймер не должен удерживать процесс хоста.
|
|
708
|
+
if (typeof timer.unref === "function") timer.unref();
|
|
709
|
+
|
|
710
|
+
return file;
|
|
711
|
+
}
|
|
712
|
+
|
|
@@ -5,6 +5,7 @@ import { notifyTaskCompletion } from "../notifications.js";
|
|
|
5
5
|
import { finishRun, getHistory, recordRun, startRun } from "../db/history-repo.js";
|
|
6
6
|
import { getSetting, setSetting } from "../db/settings-repo.js";
|
|
7
7
|
import { getTask, listTasks } from "../db/tasks-repo.js";
|
|
8
|
+
import { rotateSessionIfNeeded } from "./session.js";
|
|
8
9
|
import type { TaskDefinition } from "../task-transfer.js";
|
|
9
10
|
import type { HistoryRecord } from "../history.js";
|
|
10
11
|
import {
|
|
@@ -463,6 +464,18 @@ async function handleCompletion(
|
|
|
463
464
|
}
|
|
464
465
|
}
|
|
465
466
|
}
|
|
467
|
+
|
|
468
|
+
// Спринт 24: учёт запусков сессии (sessionRunCount) и ротация reuse-сессии
|
|
469
|
+
// при достижении sessionMaxRuns. Не должна ломать завершение запуска.
|
|
470
|
+
try {
|
|
471
|
+
await rotateSessionIfNeeded(taskName);
|
|
472
|
+
} catch (err: any) {
|
|
473
|
+
console.warn(
|
|
474
|
+
`[windows-scheduler] Не удалось обновить состояние сессии "${taskName}": ${
|
|
475
|
+
err instanceof Error ? err.message : String(err)
|
|
476
|
+
}`
|
|
477
|
+
);
|
|
478
|
+
}
|
|
466
479
|
}
|
|
467
480
|
|
|
468
481
|
/**
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* schedule-gate: вызывается враппером (.cmd / bash) сразу после срабатывания
|
|
3
|
+
* планировщика, ДО запуска агента.
|
|
4
|
+
*
|
|
5
|
+
* Проверяет расширенное cron-выражение и окно запуска (notBefore/notAfter):
|
|
6
|
+
* node dist/core/schedule-gate.js --cron "0 9 * * *" [--tz "Europe/Moscow"]
|
|
7
|
+
* [--not-before 22:00 --not-after 06:00]
|
|
8
|
+
* [--defer-file "C:\...\name.lock.defer"]
|
|
9
|
+
* [--force-file "C:\...\name.lock.force"]
|
|
10
|
+
* [--now 2026-11-13T12:00:00.000Z] (для тестов)
|
|
11
|
+
*
|
|
12
|
+
* --force-file — маркер ручного запуска (run_task_now, файловый триггер,
|
|
13
|
+
* catch-up). Если файл существует и моложе FORCE_TTL_MS, проверка cron/окна
|
|
14
|
+
* пропускается, а маркер удаляется. Протухший маркер не действует — иначе
|
|
15
|
+
* забытый файл однажды обошёл бы расписание.
|
|
16
|
+
*
|
|
17
|
+
* Коды выхода:
|
|
18
|
+
* 0 — можно запускать (wrapper выполняет агента);
|
|
19
|
+
* 3 — не время (cron не совпал, уже есть отложенный запуск или не в окне),
|
|
20
|
+
* wrapper тихо завершается;
|
|
21
|
+
* 1 — некорректные аргументы (ошибка логируется; запуск разрешён, чтобы не
|
|
22
|
+
* ломать задачу из-за опечатки в конфигурации).
|
|
23
|
+
*
|
|
24
|
+
* Окно запуска реализовано как ПЕРЕНОС, а не пропуск: если cron совпал, но
|
|
25
|
+
* сейчас вне окна, gate ждёт открытия окна. Дубликаты отложенных запусков
|
|
26
|
+
* отсекаются по defer-файлу (атомарное создание); файл запись удаляет сам gate
|
|
27
|
+
* после пробуждения; если файл протух (> 25 часов) — считается stale и
|
|
28
|
+
* перезаписывается.
|
|
29
|
+
*/
|
|
30
|
+
import fs from "node:fs";
|
|
31
|
+
import {
|
|
32
|
+
cronMatches,
|
|
33
|
+
isValidIanaTimeZone,
|
|
34
|
+
isInWindow,
|
|
35
|
+
parseCron,
|
|
36
|
+
validateLaunchWindow,
|
|
37
|
+
windowDelayMs,
|
|
38
|
+
} from "./schedule-v2.js";
|
|
39
|
+
|
|
40
|
+
const STALE_DEFER_MS = 25 * 60 * 60 * 1000;
|
|
41
|
+
|
|
42
|
+
/** Сколько живёт маркер ручного запуска. */
|
|
43
|
+
const FORCE_TTL_MS = 2 * 60 * 1000;
|
|
44
|
+
|
|
45
|
+
function argValue(args: string[], name: string): string | undefined {
|
|
46
|
+
const idx = args.indexOf(name);
|
|
47
|
+
if (idx === -1 || idx + 1 >= args.length) return undefined;
|
|
48
|
+
return args[idx + 1];
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function sleepMs(ms: number): Promise<void> {
|
|
52
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** true, если defer-файл сейчас занят другим отложенным запуском. */
|
|
56
|
+
function deferFileBusy(path: string, nowMs: number): boolean {
|
|
57
|
+
try {
|
|
58
|
+
const raw = fs.readFileSync(path, "utf8").trim();
|
|
59
|
+
const ts = Date.parse(raw);
|
|
60
|
+
if (Number.isFinite(ts) && nowMs - ts < STALE_DEFER_MS) return true;
|
|
61
|
+
// Протухший файл — удаляем и занимаем сами.
|
|
62
|
+
fs.unlinkSync(path);
|
|
63
|
+
return false;
|
|
64
|
+
} catch {
|
|
65
|
+
return false;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** Атомарно занимает defer-слот; true, если занят успешно. */
|
|
70
|
+
function acquireDefer(path: string, nowMs: number): boolean {
|
|
71
|
+
try {
|
|
72
|
+
const fd = fs.openSync(path, "wx");
|
|
73
|
+
fs.writeSync(fd, new Date(nowMs).toISOString());
|
|
74
|
+
fs.closeSync(fd);
|
|
75
|
+
return true;
|
|
76
|
+
} catch {
|
|
77
|
+
return false;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
function releaseDefer(path: string): void {
|
|
82
|
+
try {
|
|
83
|
+
fs.unlinkSync(path);
|
|
84
|
+
} catch {
|
|
85
|
+
/* удалён раньше — не страшно */
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Проверяет и поглощает маркер ручного запуска.
|
|
91
|
+
*
|
|
92
|
+
* Возвращает true, если маркер свежий (значит, запуск инициирован вручную:
|
|
93
|
+
* инструментом, файловым триггером, MCP-событием или catch-up) — тогда гейт
|
|
94
|
+
* расписания не должен блокировать запуск. Маркер удаляется в любом случае.
|
|
95
|
+
*
|
|
96
|
+
* Возраст считается по реальным часам, а не по --now, иначе тестовый --now
|
|
97
|
+
* ломал бы проверку. Протухший маркер (например, задача не стартовала)
|
|
98
|
+
* просто удаляется и не влияет на расписание.
|
|
99
|
+
*/
|
|
100
|
+
function consumeForceMarker(path: string): boolean {
|
|
101
|
+
try {
|
|
102
|
+
const stat = fs.statSync(path);
|
|
103
|
+
fs.unlinkSync(path);
|
|
104
|
+
return Date.now() - stat.mtimeMs <= FORCE_TTL_MS;
|
|
105
|
+
} catch {
|
|
106
|
+
return false;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
async function main(): Promise<number> {
|
|
111
|
+
const args = process.argv.slice(2);
|
|
112
|
+
const cronExpr = argValue(args, "--cron");
|
|
113
|
+
const tz = argValue(args, "--tz");
|
|
114
|
+
const notBefore = argValue(args, "--not-before");
|
|
115
|
+
const notAfter = argValue(args, "--not-after");
|
|
116
|
+
const deferFile = argValue(args, "--defer-file");
|
|
117
|
+
const forceFile = argValue(args, "--force-file");
|
|
118
|
+
const nowArg = argValue(args, "--now");
|
|
119
|
+
|
|
120
|
+
const now = nowArg ? new Date(nowArg) : new Date();
|
|
121
|
+
if (Number.isNaN(now.getTime())) {
|
|
122
|
+
console.error(`[schedule-gate] Некорректное значение --now: ${nowArg}`);
|
|
123
|
+
return 1;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
// Ручной запуск (run_task_now, файловый триггер, MCP-событие, catch-up):
|
|
127
|
+
// маркер свежий — расписание и окно не проверяем.
|
|
128
|
+
if (forceFile && consumeForceMarker(forceFile)) {
|
|
129
|
+
console.error("[schedule-gate] Ручной запуск — проверка расписания пропущена.");
|
|
130
|
+
return 0;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
// Невалидный timezone/окно — не блокируем задачу, логируем и продолжаем.
|
|
134
|
+
const zone = tz && isValidIanaTimeZone(tz) ? tz : undefined;
|
|
135
|
+
if (tz && !zone) {
|
|
136
|
+
console.error(`[schedule-gate] Неизвестный timezone «${tz}» — игнорируем его.`);
|
|
137
|
+
}
|
|
138
|
+
const windowError = validateLaunchWindow(notBefore, notAfter);
|
|
139
|
+
if (windowError) {
|
|
140
|
+
console.error(`[schedule-gate] Окно запуска игнорируется: ${windowError}`);
|
|
141
|
+
}
|
|
142
|
+
const windowOk = !windowError && !!notBefore && !!notAfter;
|
|
143
|
+
|
|
144
|
+
let spec = null;
|
|
145
|
+
if (cronExpr) {
|
|
146
|
+
try {
|
|
147
|
+
spec = parseCron(cronExpr);
|
|
148
|
+
} catch (err: any) {
|
|
149
|
+
console.error(
|
|
150
|
+
`[schedule-gate] Невалидный cron «${cronExpr}»: ${
|
|
151
|
+
err instanceof Error ? err.message : String(err)
|
|
152
|
+
} — пропускаем проверку cron.`
|
|
153
|
+
);
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
if (spec && !cronMatches(spec, now, zone)) {
|
|
158
|
+
// По расширенному cron сейчас не время.
|
|
159
|
+
return 3;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
if (windowOk && !isInWindow(now, notBefore, notAfter, zone)) {
|
|
163
|
+
const wait = windowDelayMs(now, notBefore, notAfter, zone);
|
|
164
|
+
if (wait <= 0) return 0;
|
|
165
|
+
|
|
166
|
+
// ПЕРЕНОС: ждём открытия окна. Откладываем один запуск, остальные тики
|
|
167
|
+
// отсекаются по defer-файлу.
|
|
168
|
+
if (deferFile) {
|
|
169
|
+
if (deferFileBusy(deferFile, now.getTime())) {
|
|
170
|
+
console.error("[schedule-gate] Отложенный запуск уже ожидает открытия окна.");
|
|
171
|
+
return 3;
|
|
172
|
+
}
|
|
173
|
+
if (!acquireDefer(deferFile, now.getTime())) {
|
|
174
|
+
console.error("[schedule-gate] Не удалось захватить defer-файл — пропускаем.");
|
|
175
|
+
return 3;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
console.error(
|
|
180
|
+
`[schedule-gate] Вне окна ${notBefore}–${notAfter} — запуск перенесён на ~${Math.round(
|
|
181
|
+
wait / 60000
|
|
182
|
+
)} мин.`
|
|
183
|
+
);
|
|
184
|
+
let remaining = wait;
|
|
185
|
+
let woke = now;
|
|
186
|
+
while (remaining > 0) {
|
|
187
|
+
const chunk = Math.min(remaining, 60_000);
|
|
188
|
+
await sleepMs(chunk);
|
|
189
|
+
remaining -= chunk;
|
|
190
|
+
woke = new Date();
|
|
191
|
+
if (isInWindow(woke, notBefore, notAfter, zone)) break;
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
if (deferFile) releaseDefer(deferFile);
|
|
195
|
+
|
|
196
|
+
if (!isInWindow(woke, notBefore, notAfter, zone)) {
|
|
197
|
+
console.error("[schedule-gate] Окно не открылось за отведённое время — не запускаем.");
|
|
198
|
+
return 3;
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
return 0;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
main().then(
|
|
206
|
+
(code) => process.exit(code),
|
|
207
|
+
(err) => {
|
|
208
|
+
console.error(
|
|
209
|
+
`[schedule-gate] Непредвиденная ошибка: ${err instanceof Error ? err.message : String(err)} — запускаем.`
|
|
210
|
+
);
|
|
211
|
+
process.exit(1);
|
|
212
|
+
}
|
|
213
|
+
);
|