opencode-windows-scheduler 1.2.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.
Files changed (111) hide show
  1. package/CHANGELOG.md +16 -1
  2. package/README.md +5 -5
  3. package/ROADMAP-STRATEGY.md +2 -2
  4. package/ROADMAP.md +31 -5
  5. package/dist/core/dry-run.d.ts +5 -1
  6. package/dist/core/dry-run.d.ts.map +1 -1
  7. package/dist/core/dry-run.js +20 -4
  8. package/dist/core/one-shot.d.ts +62 -0
  9. package/dist/core/one-shot.d.ts.map +1 -0
  10. package/dist/core/one-shot.js +126 -0
  11. package/dist/core/otel.d.ts +4 -0
  12. package/dist/core/otel.d.ts.map +1 -0
  13. package/dist/core/otel.js +98 -0
  14. package/dist/core/prometheus.d.ts +23 -0
  15. package/dist/core/prometheus.d.ts.map +1 -0
  16. package/dist/core/prometheus.js +146 -0
  17. package/dist/core/ps-wrapper.d.ts +6 -2
  18. package/dist/core/ps-wrapper.d.ts.map +1 -1
  19. package/dist/core/ps-wrapper.js +25 -3
  20. package/dist/core/record-history.d.ts.map +1 -1
  21. package/dist/core/record-history.js +9 -0
  22. package/dist/core/scheduler/linux.d.ts +12 -3
  23. package/dist/core/scheduler/linux.d.ts.map +1 -1
  24. package/dist/core/scheduler/linux.js +80 -3
  25. package/dist/core/scheduler/mac.d.ts.map +1 -1
  26. package/dist/core/scheduler/mac.js +17 -3
  27. package/dist/core/scheduler/posix.d.ts.map +1 -1
  28. package/dist/core/scheduler/posix.js +3 -0
  29. package/dist/core/scheduler/registry.d.ts +4 -0
  30. package/dist/core/scheduler/registry.d.ts.map +1 -1
  31. package/dist/core/scheduler/types.d.ts +5 -3
  32. package/dist/core/scheduler/types.d.ts.map +1 -1
  33. package/dist/core/scheduler/windows.d.ts.map +1 -1
  34. package/dist/core/scheduler/windows.js +10 -1
  35. package/dist/core/session.d.ts +34 -0
  36. package/dist/core/session.d.ts.map +1 -0
  37. package/dist/core/session.js +105 -0
  38. package/dist/core/structured-log.d.ts +84 -0
  39. package/dist/core/structured-log.d.ts.map +1 -0
  40. package/dist/core/structured-log.js +137 -0
  41. package/dist/core/wrappers/bash.d.ts +9 -0
  42. package/dist/core/wrappers/bash.d.ts.map +1 -1
  43. package/dist/core/wrappers/bash.js +27 -3
  44. package/dist/db/history-repo.d.ts.map +1 -1
  45. package/dist/db/history-repo.js +63 -6
  46. package/dist/db/metrics-repo.d.ts +3 -0
  47. package/dist/db/metrics-repo.d.ts.map +1 -1
  48. package/dist/db/metrics-repo.js +16 -8
  49. package/dist/db/migrate.d.ts.map +1 -1
  50. package/dist/db/migrate.js +8 -1
  51. package/dist/db/schema.d.ts +1 -1
  52. package/dist/db/schema.d.ts.map +1 -1
  53. package/dist/db/schema.js +8 -0
  54. package/dist/gui-experimental.cjs +1 -0
  55. package/dist/history.d.ts +7 -0
  56. package/dist/history.d.ts.map +1 -1
  57. package/dist/history.js +13 -0
  58. package/dist/index.d.ts +22 -3
  59. package/dist/index.d.ts.map +1 -1
  60. package/dist/index.js +330 -41
  61. package/dist/integrations.d.ts +64 -0
  62. package/dist/integrations.d.ts.map +1 -0
  63. package/dist/integrations.js +205 -0
  64. package/dist/rpc.d.ts +81 -4
  65. package/dist/rpc.d.ts.map +1 -1
  66. package/dist/rpc.js +43 -4
  67. package/dist/server.d.ts +2 -0
  68. package/dist/server.d.ts.map +1 -1
  69. package/dist/server.js +468 -56
  70. package/dist/settings.d.ts +38 -0
  71. package/dist/settings.d.ts.map +1 -1
  72. package/dist/settings.js +68 -0
  73. package/dist/shared/jobs-view.d.ts +43 -5
  74. package/dist/shared/jobs-view.d.ts.map +1 -1
  75. package/dist/shared/jobs-view.js +125 -7
  76. package/dist/task-transfer.d.ts +19 -3
  77. package/dist/task-transfer.d.ts.map +1 -1
  78. package/dist/task-transfer.js +75 -3
  79. package/docs/FEATURES.md +101 -4
  80. package/gui-experimental.cjs +4 -4
  81. package/package.json +11 -2
  82. package/scripts/demo-dashboard.mjs +12 -2
  83. package/src/core/dry-run.ts +24 -5
  84. package/src/core/one-shot.ts +173 -0
  85. package/src/core/otel.ts +128 -0
  86. package/src/core/prometheus.ts +215 -0
  87. package/src/core/ps-wrapper.ts +29 -3
  88. package/src/core/record-history.ts +13 -0
  89. package/src/core/scheduler/linux.ts +90 -3
  90. package/src/core/scheduler/mac.ts +35 -4
  91. package/src/core/scheduler/posix.ts +3 -0
  92. package/src/core/scheduler/registry.ts +4 -0
  93. package/src/core/scheduler/types.ts +5 -3
  94. package/src/core/scheduler/windows.ts +11 -1
  95. package/src/core/session.ts +115 -0
  96. package/src/core/structured-log.ts +205 -0
  97. package/src/core/wrappers/bash.ts +38 -2
  98. package/src/db/history-repo.ts +67 -7
  99. package/src/db/metrics-repo.ts +19 -7
  100. package/src/db/migrate.ts +7 -1
  101. package/src/db/schema.ts +11 -0
  102. package/src/gui.tsx +3832 -3613
  103. package/src/history.ts +17 -0
  104. package/src/index.ts +426 -47
  105. package/src/integrations.ts +253 -0
  106. package/src/rpc.ts +43 -4
  107. package/src/server.ts +501 -56
  108. package/src/settings.ts +122 -0
  109. package/src/shared/jobs-view.ts +158 -8
  110. package/src/task-transfer.ts +107 -5
  111. package/src/tui.tsx +290 -14
@@ -46,7 +46,9 @@ export const WRAPPER_SCRIPT = `param(
46
46
  [string]$QualityGate,
47
47
  [string]$BeforeScript,
48
48
  [string]$AfterScript,
49
- [string]$EnvFile
49
+ [string]$EnvFile,
50
+ [string]$SessionMode,
51
+ [string]$SessionId
50
52
  )
51
53
 
52
54
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -309,11 +311,16 @@ try {
309
311
  # Получаем путь к скрипту opencode (.ps1 или .cmd)
310
312
  $opencodeCmd = Get-Command opencode | Select-Object -ExpandProperty Source
311
313
 
312
- # Формируем аргументы для opencode run
314
+ # Формируем аргументы для opencode run (Спринт 24: сессия).
313
315
  $opencodeArgs = @("run")
314
316
  if ($Model) {
315
317
  $opencodeArgs += @("--model", $Model)
316
318
  }
319
+ if ($SessionMode -eq 'reuse' -and $SessionId) {
320
+ $opencodeArgs += @("--session", $SessionId)
321
+ } elseif ($SessionMode -eq 'last') {
322
+ $opencodeArgs += @("--continue")
323
+ }
317
324
  if ($prompt) {
318
325
  $opencodeArgs += $prompt
319
326
  }
@@ -486,6 +493,10 @@ export function lockFilePath(taskName: string): string {
486
493
  * @param deniedTools список запрещённых инструментов (спринт 14, опционально)
487
494
  * @param scheduleGate гейт расписания (спринт 19): проверка cron в таймзоне
488
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, опционально)
489
500
  */
490
501
  export async function writeWrapperCmd(
491
502
  sanitizedName: string,
@@ -509,7 +520,9 @@ export async function writeWrapperCmd(
509
520
  forceFile?: string;
510
521
  forceTtlMs?: number;
511
522
  },
512
- envFile?: string
523
+ envFile?: string,
524
+ sessionMode?: "new" | "reuse" | "last",
525
+ sessionId?: string
513
526
  ): Promise<string> {
514
527
  await fs.mkdir(WRAPPER_DIR, { recursive: true });
515
528
  const cmdPath = path.join(WRAPPER_DIR, `run-${sanitizedName}.cmd`);
@@ -591,6 +604,19 @@ export async function writeWrapperCmd(
591
604
  }
592
605
  }
593
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
+
594
620
  const lines: string[] = ["@echo off", "chcp 65001 >nul"];
595
621
 
596
622
  // Рабочая директория: всегда переходим в неё ДО запуска PowerShell.
@@ -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
  /**
@@ -1,5 +1,6 @@
1
1
  import { execFile, spawn } from "node:child_process";
2
2
  import { promisify } from "node:util";
3
+ import { buildAtTimestamp } from "../one-shot.js";
3
4
  import { PosixSchedulerBase, shellQuote } from "./posix.js";
4
5
  import type { RegistryEntry } from "./registry.js";
5
6
 
@@ -111,15 +112,101 @@ export class LinuxScheduler extends PosixSchedulerBase {
111
112
  await this.writeCrontab(next);
112
113
  }
113
114
 
114
- protected async installEntry(_entry: RegistryEntry): Promise<void> {
115
+ /** Строка команды one-shot для stdin `at`. */
116
+ private atCommand(entry: RegistryEntry): string {
117
+ const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
118
+ return `/bin/bash ${shellQuote(entry.command)}${log}`;
119
+ }
120
+
121
+ /**
122
+ * Ставит one-shot в `at` и возвращает id задания.
123
+ * `at -t` принимает локальное время системы в формате YYYYMMDDHHMM.
124
+ */
125
+ private async scheduleAt(entry: RegistryEntry): Promise<string> {
126
+ if (!entry.runAt) {
127
+ throw new Error(`Задача "${entry.name}": не задано runAt для one-shot.`);
128
+ }
129
+ const timestamp = buildAtTimestamp(entry.runAt);
130
+ return new Promise<string>((resolve, reject) => {
131
+ const child = spawn("at", ["-t", timestamp], {
132
+ stdio: ["pipe", "pipe", "pipe"],
133
+ });
134
+ let stdout = "";
135
+ let stderr = "";
136
+ child.stdout.on("data", (chunk) => {
137
+ stdout += String(chunk);
138
+ });
139
+ child.stderr.on("data", (chunk) => {
140
+ stderr += String(chunk);
141
+ });
142
+ child.on("error", (err) => {
143
+ reject(
144
+ new Error(
145
+ `Не удалось вызвать at (установите пакет at): ${
146
+ err instanceof Error ? err.message : String(err)
147
+ }`
148
+ )
149
+ );
150
+ });
151
+ child.on("close", (code) => {
152
+ if (code !== 0) {
153
+ reject(
154
+ new Error(
155
+ `at завершился с кодом ${code}: ${stderr.trim() || stdout.trim()}`
156
+ )
157
+ );
158
+ return;
159
+ }
160
+ const match = /job\s+(\d+)/i.exec(stdout);
161
+ if (!match) {
162
+ reject(new Error(`at не вернул id задания: ${stdout.trim()}`));
163
+ return;
164
+ }
165
+ resolve(match[1]);
166
+ });
167
+ child.stdin.end(`${this.atCommand(entry)}\n`);
168
+ });
169
+ }
170
+
171
+ /** Отменяет задание at, если оно ещё существует. */
172
+ private async cancelAt(entry: RegistryEntry): Promise<void> {
173
+ if (!entry.atJobId) return;
174
+ try {
175
+ await execFileAsync("atrm", [entry.atJobId]);
176
+ } catch {
177
+ // Задание уже выполнилось или было удалено — это не ошибка.
178
+ }
179
+ delete entry.atJobId;
180
+ }
181
+
182
+ protected async installEntry(entry: RegistryEntry): Promise<void> {
183
+ if (entry.triggerType === "once") {
184
+ if (!entry.paused) {
185
+ entry.atJobId = await this.scheduleAt(entry);
186
+ }
187
+ return;
188
+ }
115
189
  await this.rebuildCrontab();
116
190
  }
117
191
 
118
- protected async uninstallEntry(_entry: RegistryEntry): Promise<void> {
192
+ protected async uninstallEntry(entry: RegistryEntry): Promise<void> {
193
+ if (entry.triggerType === "once") {
194
+ await this.cancelAt(entry);
195
+ return;
196
+ }
119
197
  await this.rebuildCrontab();
120
198
  }
121
199
 
122
- protected async applyPause(_entry: RegistryEntry, _paused: boolean): Promise<void> {
200
+ protected async applyPause(entry: RegistryEntry, paused: boolean): Promise<void> {
201
+ if (entry.triggerType === "once") {
202
+ if (paused) {
203
+ await this.cancelAt(entry);
204
+ } else if (entry.runAt && Date.parse(entry.runAt) > Date.now()) {
205
+ entry.atJobId = await this.scheduleAt(entry);
206
+ }
207
+ await this.registry.upsert(entry);
208
+ return;
209
+ }
123
210
  await this.rebuildCrontab();
124
211
  }
125
212
  }
@@ -4,6 +4,7 @@ import os from "node:os";
4
4
  import path from "node:path";
5
5
  import { promisify } from "node:util";
6
6
  import { sanitizeName } from "../../types.js";
7
+ import { buildLaunchdCalendar } from "../one-shot.js";
7
8
  import { PosixSchedulerBase } from "./posix.js";
8
9
  import type { RegistryEntry } from "./registry.js";
9
10
 
@@ -94,10 +95,28 @@ export function cronToLaunchdSchedule(cron: string): LaunchdSchedule {
94
95
 
95
96
  /** Собирает XML plist для задачи. */
96
97
  function buildPlist(label: string, entry: RegistryEntry): string {
97
- const schedule =
98
- entry.triggerType !== "cron"
99
- ? { interval: 315_360_000 } // file/mcp-event: 10 лет — фактически «никогда».
100
- : cronToLaunchdSchedule(entry.schedule);
98
+ const schedule: {
99
+ interval?: number;
100
+ calendar?: {
101
+ Minute?: number;
102
+ Hour?: number;
103
+ Weekday?: number;
104
+ Month?: number;
105
+ Day?: number;
106
+ };
107
+ } =
108
+ entry.triggerType === "once"
109
+ ? (() => {
110
+ if (!entry.runAt) {
111
+ throw new Error(
112
+ `Задача "${entry.name}": для one-shot не задано runAt.`
113
+ );
114
+ }
115
+ return { calendar: buildLaunchdCalendar(entry.runAt) };
116
+ })()
117
+ : entry.triggerType !== "cron"
118
+ ? { interval: 315_360_000 } // file/mcp-event: 10 лет — фактически «никогда».
119
+ : cronToLaunchdSchedule(entry.schedule);
101
120
 
102
121
  const scheduleXml: string[] = [];
103
122
  if (schedule.interval !== undefined) {
@@ -126,6 +145,18 @@ function buildPlist(label: string, entry: RegistryEntry): string {
126
145
  ` <integer>${schedule.calendar.Weekday}</integer>`
127
146
  );
128
147
  }
148
+ if (schedule.calendar.Month !== undefined) {
149
+ scheduleXml.push(
150
+ " <key>Month</key>",
151
+ ` <integer>${schedule.calendar.Month}</integer>`
152
+ );
153
+ }
154
+ if (schedule.calendar.Day !== undefined) {
155
+ scheduleXml.push(
156
+ " <key>Day</key>",
157
+ ` <integer>${schedule.calendar.Day}</integer>`
158
+ );
159
+ }
129
160
  scheduleXml.push(" </dict>");
130
161
  }
131
162
 
@@ -40,6 +40,7 @@ export abstract class PosixSchedulerBase implements SchedulerBackend {
40
40
  logFile: options.logFile,
41
41
  workingDirectory: options.workingDirectory,
42
42
  triggerType: options.triggerType ?? "cron",
43
+ ...(options.runAt ? { runAt: options.runAt } : {}),
43
44
  paused: false,
44
45
  createdAt: new Date().toISOString(),
45
46
  ...(options.model ? { model: options.model } : {}),
@@ -48,6 +49,8 @@ export abstract class PosixSchedulerBase implements SchedulerBackend {
48
49
 
49
50
  await this.registry.upsert(entry);
50
51
  await this.installEntry(entry);
52
+ // installEntry может записать atJobId для Linux one-shot.
53
+ await this.registry.upsert(entry);
51
54
  }
52
55
 
53
56
  async deleteTask(name: string): Promise<void> {
@@ -17,6 +17,10 @@ export interface RegistryEntry {
17
17
  logFile?: string;
18
18
  workingDirectory?: string;
19
19
  triggerType: TriggerType;
20
+ /** Абсолютное время однократного запуска (ISO-8601, только для once). */
21
+ runAt?: string;
22
+ /** Идентификатор задания `at` на Linux (для отмены one-shot). */
23
+ atJobId?: string;
20
24
  paused: boolean;
21
25
  createdAt: string;
22
26
  /** LLM-модель задачи (опционально). */
@@ -1,7 +1,7 @@
1
1
  import type { ScheduledTaskInfo } from "../../types.js";
2
2
 
3
3
  /** Чем запускается задача. */
4
- export type TriggerType = "cron" | "file" | "mcp-event";
4
+ export type TriggerType = "cron" | "file" | "mcp-event" | "once";
5
5
 
6
6
  /**
7
7
  * Параметры создания задачи. Бэкенд сам решает, как преобразовать cron
@@ -16,12 +16,14 @@ export interface CreateTaskOptions {
16
16
  * - Linux/macOS: .sh с вызовом `opencode run`.
17
17
  */
18
18
  command: string;
19
- /** 5-полевое cron-выражение. Игнорируется при триггерах file/mcp-event. */
19
+ /** 5-полевое cron-выражение. Игнорируется при триггерах file/mcp-event/once. */
20
20
  schedule: string;
21
21
  /** Таймаут выполнения в секундах (используется обёрткой). */
22
22
  timeoutSeconds?: number;
23
- /** "cron" (по умолчанию), "file" или "mcp-event". */
23
+ /** "cron" (по умолчанию), "file", "mcp-event" или "once". */
24
24
  triggerType?: TriggerType;
25
+ /** Абсолютное время однократного запуска (ISO-8601, только для once). */
26
+ runAt?: string;
25
27
  /** Рабочая директория задачи (для POSIX-бэкендов попадает в cron/plist). */
26
28
  workingDirectory?: string;
27
29
  /** Путь к файлу лога (для POSIX-бэкендов — перенаправление вывода). */
@@ -4,6 +4,7 @@ import iconv from "iconv-lite";
4
4
  import type { ScheduledTaskInfo } from "../../types.js";
5
5
  import { TASK_FOLDER, TASK_FOLDER_NAME } from "../../types.js";
6
6
  import { buildScheduleFlags, convertCronToSchTasks } from "../cron-to-schtasks.js";
7
+ import { buildWindowsOneShotFlags } from "../one-shot.js";
7
8
  import { needsPollMode } from "../schedule-v2.js";
8
9
  import type {
9
10
  CreateTaskOptions,
@@ -138,7 +139,16 @@ export class WindowsScheduler implements SchedulerBackend {
138
139
 
139
140
  let scheduleFlags: string[];
140
141
 
141
- if (triggerType && triggerType !== "cron") {
142
+ if (triggerType === "once") {
143
+ // Настоящий one-shot: Windows сам удалит задачу из расписания после
144
+ // единственного запуска, повторных срабатываний не будет.
145
+ if (!options.runAt) {
146
+ throw new Error(
147
+ `Задача "${name}": для triggerType=once не передано время runAt.`
148
+ );
149
+ }
150
+ scheduleFlags = buildWindowsOneShotFlags(options.runAt);
151
+ } else if (triggerType && triggerType !== "cron") {
142
152
  // Файловый или MCP-триггер: однократный запуск в далёком будущем.
143
153
  // Активация — только вручную (runTask / файловый watcher / emit_event).
144
154
  scheduleFlags = ["/sc", "ONCE", "/sd", "31.12.2099", "/st", "00:00"];
@@ -0,0 +1,115 @@
1
+ import crypto from "node:crypto";
2
+ import { execFile } from "node:child_process";
3
+ import { getTask, saveTask } from "../db/tasks-repo.js";
4
+ import { appendStructuredLog } from "./structured-log.js";
5
+
6
+ export const SESSION_MODES = ["new", "reuse", "last"] as const;
7
+ export type SessionMode = (typeof SESSION_MODES)[number];
8
+
9
+ const SESSION_ID_PATTERN = /^ses_[A-Za-z0-9]{10,64}$/;
10
+
11
+ /** Генерация id сессии в формате `ses_<26+ base36>`. */
12
+ export function generateSessionId(): string {
13
+ const alphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
14
+ const bytes = crypto.randomBytes(13);
15
+ let suffix = "";
16
+ for (const byte of bytes) {
17
+ suffix += alphabet[byte % 36];
18
+ }
19
+ // 13 байт → 20 символов base36; добавляем 6 случайных, чтобы было ≥26.
20
+ const extra = crypto.randomBytes(3).toString("hex");
21
+ return `ses_${suffix}${extra}`;
22
+ }
23
+
24
+ /** Проверка формата id сессии. */
25
+ export function isValidSessionId(value: unknown): value is string {
26
+ return typeof value === "string" && SESSION_ID_PATTERN.test(value);
27
+ }
28
+
29
+ /**
30
+ * Нормализация режима сессии. undefined → "new".
31
+ * Возвращает undefined для мусора, чтобы вызывающий мог решить, падать или нет.
32
+ */
33
+ export function normalizeSessionMode(value: unknown): SessionMode | undefined {
34
+ if (value === undefined || value === null) return "new";
35
+ if (value === "new" || value === "reuse" || value === "last") return value;
36
+ return undefined;
37
+ }
38
+
39
+ /** Аргументы для `opencode run` в зависимости от режима. */
40
+ export function buildSessionArgs(mode: SessionMode, sessionId?: string): string[] {
41
+ switch (mode) {
42
+ case "reuse":
43
+ return sessionId && isValidSessionId(sessionId) ? ["--session", sessionId] : [];
44
+ case "last":
45
+ return ["--continue"];
46
+ default:
47
+ return [];
48
+ }
49
+ }
50
+
51
+ /** Признак того, что сессию пора ротировать после N запусков. */
52
+ export function shouldRotateSession(runCount: number, maxRuns: number): boolean {
53
+ return maxRuns > 0 && runCount >= maxRuns;
54
+ }
55
+
56
+ /**
57
+ * Счётчик запусков сессии при сохранении определения задачи.
58
+ *
59
+ * Редактирование не должно обнулять прогресс к sessionMaxRuns, если сессия
60
+ * осталась прежней. При смене режима или id сессии счётчик начинается заново.
61
+ */
62
+ export function preservedSessionRunCount(
63
+ previous:
64
+ | { session?: SessionMode; sessionId?: string; sessionRunCount?: number }
65
+ | undefined,
66
+ session: SessionMode,
67
+ sessionId: string | undefined
68
+ ): number {
69
+ if (!previous) return 0;
70
+ if (previous.session !== session || previous.sessionId !== sessionId) return 0;
71
+ return previous.sessionRunCount ?? 0;
72
+ }
73
+
74
+ /**
75
+ * Best-effort ротация переиспользуемой сессии после завершения запуска.
76
+ * Удаляет сессию через opencode CLI, очищает sessionId в определении задачи
77
+ * и пишет событие в structured log. Никогда не бросает — сбой ротации
78
+ * не должен ломать историю запуска.
79
+ */
80
+ export async function rotateSessionIfNeeded(taskName: string): Promise<void> {
81
+ try {
82
+ const def = await getTask(taskName);
83
+ if (!def || def.session !== "reuse") return;
84
+
85
+ const maxRuns = def.sessionMaxRuns ?? 0;
86
+ const count = (def.sessionRunCount ?? 0) + 1;
87
+
88
+ if (shouldRotateSession(count, maxRuns)) {
89
+ const sessionId = def.sessionId;
90
+ if (sessionId && isValidSessionId(sessionId)) {
91
+ try {
92
+ await new Promise<void>((resolve) => {
93
+ execFile("opencode", ["session", "delete", sessionId], () => resolve());
94
+ });
95
+ } catch {
96
+ // Удаление не должно мешать: просто фиксируем в логе ниже.
97
+ }
98
+ }
99
+ await saveTask({
100
+ ...def,
101
+ sessionId: undefined,
102
+ sessionRunCount: 0,
103
+ });
104
+ appendStructuredLog({
105
+ event: "session.rotated",
106
+ task: taskName,
107
+ reason: `maxRuns=${maxRuns} достигнут; сессия удалена и счётчик сброшен`,
108
+ });
109
+ } else {
110
+ await saveTask({ ...def, sessionRunCount: count });
111
+ }
112
+ } catch (error) {
113
+ console.warn(`[session] Ротация сессии задачи "${taskName}" не выполнена:`, error);
114
+ }
115
+ }
@@ -0,0 +1,205 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { LOG_DIR } from "../types.js";
4
+
5
+ /**
6
+ * Машиночитаемые логи запусков (Спринт 22).
7
+ *
8
+ * Формат — JSONL: одна строка = один JSON-объект. Файл лежит рядом с
9
+ * человекочитаемыми логами задач: `<PLUGIN_DIR>/logs/runs.jsonl`.
10
+ *
11
+ * Ротация простая: при превышении лимита текущий файл переименовывается
12
+ * в `runs.jsonl.1` (предыдущий `.1` перезаписывается). Этого достаточно,
13
+ * чтобы лог не рос бесконечно, и не требуется внешних зависимостей.
14
+ *
15
+ * Любая ошибка записи логируется в console.warn и **никогда** не ломает
16
+ * запуск задачи: наблюдаемость не должна влиять на планировщик.
17
+ */
18
+
19
+ /** События структурированного лога. */
20
+ export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | string;
21
+
22
+ export interface StructuredLogRecord {
23
+ /** Время записи (ISO). */
24
+ ts: string;
25
+ event: StructuredLogEvent;
26
+ /** id записи history (для run.*). */
27
+ runId?: number;
28
+ task?: string;
29
+ status?: string;
30
+ startedAt?: string;
31
+ finishedAt?: string | null;
32
+ durationMs?: number | null;
33
+ error?: string | null;
34
+ nextTask?: string | null;
35
+ tokens?: number;
36
+ costUsd?: number;
37
+ model?: string;
38
+ workspaceId?: string | null;
39
+ preFlightStatus?: string;
40
+ postFlightStatus?: string;
41
+ /** Источник события: schedule, dashboard, hook, cli, mcp и т.п. */
42
+ source?: string;
43
+ /** HTTP-статус ответа на hook.received. */
44
+ httpStatus?: number;
45
+ /** Адрес отправителя хука (без порта). */
46
+ remote?: string | null;
47
+ /** Размер тела хука в байтах. */
48
+ payloadBytes?: number;
49
+ /** Причина отказа/пропуска. */
50
+ reason?: string;
51
+ }
52
+
53
+ export interface ReadStructuredLogsFilter {
54
+ task?: string;
55
+ status?: string;
56
+ event?: string;
57
+ /** ISO-время: записи не раньше. */
58
+ since?: string;
59
+ /** ISO-время: записи не позже. */
60
+ until?: string;
61
+ limit?: number;
62
+ }
63
+
64
+ export interface ReadStructuredLogsResult {
65
+ records: StructuredLogRecord[];
66
+ /** Сколько всего записей подошло под фильтр (до применения limit). */
67
+ total: number;
68
+ /** Сколько строк не удалось разобрать как JSON. */
69
+ malformed: number;
70
+ file: string;
71
+ }
72
+
73
+ /** Текущий файл и его архив после ротации. */
74
+ export const STRUCTURED_LOG_FILE = path.join(LOG_DIR, "runs.jsonl");
75
+ export const STRUCTURED_LOG_ARCHIVE = `${STRUCTURED_LOG_FILE}.1`;
76
+ export const STRUCTURED_LOG_MAX_BYTES = 10 * 1024 * 1024;
77
+
78
+ function warn(message: string, err: unknown): void {
79
+ try {
80
+ console.warn(
81
+ `[structured-log] ${message}: ${err instanceof Error ? err.message : String(err)}`
82
+ );
83
+ } catch {
84
+ // console может быть недоступен в урезанном окружении — молча игнорируем.
85
+ }
86
+ }
87
+
88
+ function ensureLogDir(): void {
89
+ fs.mkdirSync(LOG_DIR, { recursive: true });
90
+ }
91
+
92
+ /** Ротирует лог, если он превысил лимит. Вызывается перед append. */
93
+ function rotateIfNeeded(): void {
94
+ try {
95
+ const stat = fs.statSync(STRUCTURED_LOG_FILE);
96
+ if (stat.size < STRUCTURED_LOG_MAX_BYTES) return;
97
+ try {
98
+ fs.rmSync(STRUCTURED_LOG_ARCHIVE, { force: true });
99
+ } catch {
100
+ // Нет старого архива — не страшно.
101
+ }
102
+ fs.renameSync(STRUCTURED_LOG_FILE, STRUCTURED_LOG_ARCHIVE);
103
+ } catch (err: any) {
104
+ // ENOENT — файла ещё нет, это нормально.
105
+ if (err?.code !== "ENOENT") warn("не удалось ротировать лог", err);
106
+ }
107
+ }
108
+
109
+ /**
110
+ * Добавляет запись в JSONL-лог. Возвращает true при успешной записи.
111
+ * Не бросает исключений.
112
+ */
113
+ export function appendStructuredLog(
114
+ record: Omit<StructuredLogRecord, "ts"> & { ts?: string }
115
+ ): boolean {
116
+ try {
117
+ ensureLogDir();
118
+ rotateIfNeeded();
119
+ const payload: StructuredLogRecord = {
120
+ ...record,
121
+ ts: record.ts ?? new Date().toISOString(),
122
+ };
123
+ fs.appendFileSync(STRUCTURED_LOG_FILE, `${JSON.stringify(payload)}\n`, "utf8");
124
+ return true;
125
+ } catch (err) {
126
+ warn("не удалось записать событие", err);
127
+ return false;
128
+ }
129
+ }
130
+
131
+ function readLines(file: string): string[] {
132
+ try {
133
+ return fs
134
+ .readFileSync(file, "utf8")
135
+ .split(/\r?\n/)
136
+ .filter((line) => line.trim().length > 0);
137
+ } catch (err: any) {
138
+ if (err?.code !== "ENOENT") warn(`не удалось прочитать ${file}`, err);
139
+ return [];
140
+ }
141
+ }
142
+
143
+ /**
144
+ * Читает JSONL-лог (текущий + архив), фильтрует и сортирует новые сверху.
145
+ *
146
+ * `limit` по умолчанию 200, максимум 5000 — как у HTTP-эндпоинта.
147
+ * `total` считается до применения limit, чтобы клиент знал полный объём.
148
+ */
149
+ export function readStructuredLogs(
150
+ filter: ReadStructuredLogsFilter = {}
151
+ ): ReadStructuredLogsResult {
152
+ const limit = Math.max(1, Math.min(5000, Math.floor(filter.limit ?? 200) || 200));
153
+ const task = filter.task?.trim().toLowerCase();
154
+ const status = filter.status?.trim().toLowerCase();
155
+ const event = filter.event?.trim().toLowerCase();
156
+ const since = filter.since?.trim();
157
+ const until = filter.until?.trim();
158
+
159
+ const records: StructuredLogRecord[] = [];
160
+ let malformed = 0;
161
+
162
+ // Архив старше текущего файла; порядок не важен, ниже сортируем по ts.
163
+ for (const file of [STRUCTURED_LOG_ARCHIVE, STRUCTURED_LOG_FILE]) {
164
+ for (const line of readLines(file)) {
165
+ let parsed: any;
166
+ try {
167
+ parsed = JSON.parse(line);
168
+ } catch {
169
+ malformed += 1;
170
+ continue;
171
+ }
172
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
173
+ malformed += 1;
174
+ continue;
175
+ }
176
+ if (typeof parsed.ts !== "string") parsed.ts = "";
177
+ if (typeof parsed.event !== "string") parsed.event = "";
178
+ if (task && String(parsed.task ?? "").toLowerCase() !== task) continue;
179
+ if (status && String(parsed.status ?? "").toLowerCase() !== status) continue;
180
+ if (event && String(parsed.event).toLowerCase() !== event) continue;
181
+ if (since && String(parsed.ts) < since) continue;
182
+ if (until && String(parsed.ts) > until) continue;
183
+ records.push(parsed as StructuredLogRecord);
184
+ }
185
+ }
186
+
187
+ const total = records.length;
188
+ records.sort((a, b) => String(b.ts).localeCompare(String(a.ts)));
189
+ return {
190
+ records: records.slice(0, limit),
191
+ total,
192
+ malformed,
193
+ file: STRUCTURED_LOG_FILE,
194
+ };
195
+ }
196
+
197
+ /** Удаляет JSONL-логи (для тестов и обслуживания). */
198
+ export function clearStructuredLogs(): void {
199
+ try {
200
+ fs.rmSync(STRUCTURED_LOG_FILE, { force: true });
201
+ fs.rmSync(STRUCTURED_LOG_ARCHIVE, { force: true });
202
+ } catch (err) {
203
+ warn("не удалось очистить лог", err);
204
+ }
205
+ }