agent-steward 0.0.1 → 0.0.3
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 +399 -0
- package/CROSS_PLATFORM.md +151 -0
- package/README.md +307 -15
- package/ROADMAP-STRATEGY.md +196 -0
- package/ROADMAP.md +184 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +12 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +175 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -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/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +193 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +90 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +182 -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/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -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 +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1091 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -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 +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/at-fallback.d.ts +42 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +70 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +46 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +261 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +46 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +256 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +100 -0
- package/dist/core/scheduler/registry.d.ts +43 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +112 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +749 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/session.d.ts +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -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 +146 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -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/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +49 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +128 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +48 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +137 -0
- package/dist/db/runs-repo.d.ts +120 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +319 -0
- package/dist/db/schema.d.ts +38 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +325 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5209 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +64 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +305 -0
- package/dist/rpc.d.ts +3915 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1596 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2414 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +632 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +112 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +158 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +559 -0
- package/docs/COMPATIBILITY.md +237 -0
- package/docs/CONCEPT.md +242 -0
- package/docs/CROSS_PLATFORM.ru.md +152 -0
- package/docs/CROSS_PLATFORM.zh.md +148 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +699 -0
- package/docs/FEATURES.zh.md +656 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +363 -0
- package/docs/README.ru.md +287 -0
- package/docs/README.zh.md +306 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +9 -0
- package/index.js +2 -0
- package/locales/en.json +781 -0
- package/locales/ru.json +781 -0
- package/locales/zh.json +781 -0
- package/package.json +154 -13
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +209 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +239 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1160 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +308 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +322 -0
- package/src/core/scheduler/posix.ts +128 -0
- package/src/core/scheduler/registry.ts +101 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +881 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +176 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +220 -0
- package/src/db/runs-repo.ts +481 -0
- package/src/db/schema.ts +349 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6642 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +345 -0
- package/src/rpc.ts +1704 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2663 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +946 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +226 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Нативные уведомления ОС (Спринт 25).
|
|
3
|
+
*
|
|
4
|
+
* Windows — Toast через PowerShell/WinRT, macOS — Notification Center через
|
|
5
|
+
* osascript, Linux — notify-send (libnotify). Внешних зависимостей нет:
|
|
6
|
+
* node-notifier не требуется. Все ошибки проглатываются намеренно —
|
|
7
|
+
* уведомление не должно ломать задачу.
|
|
8
|
+
*/
|
|
9
|
+
import { execFile } from "node:child_process";
|
|
10
|
+
import { promisify } from "node:util";
|
|
11
|
+
|
|
12
|
+
const execFileAsync = promisify(execFile);
|
|
13
|
+
|
|
14
|
+
/** Таймаут запуска процесса уведомления. */
|
|
15
|
+
const DEFAULT_TIMEOUT_MS = 15_000;
|
|
16
|
+
|
|
17
|
+
export interface NativeNotificationMessage {
|
|
18
|
+
/** Заголовок; по умолчанию «OpenCode Scheduler». */
|
|
19
|
+
title?: string;
|
|
20
|
+
/** Текст уведомления. */
|
|
21
|
+
body: string;
|
|
22
|
+
/** Со звуком, если платформа поддерживает. */
|
|
23
|
+
sound?: boolean;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/** Готовая команда запуска — удобно проверять в тестах. */
|
|
27
|
+
export interface NativeCommand {
|
|
28
|
+
command: string;
|
|
29
|
+
args: string[];
|
|
30
|
+
env?: Record<string, string>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** Скрипт Windows Toast: текст передаётся через env, чтобы не экранировать кавычки. */
|
|
34
|
+
const WINDOWS_TOAST_SCRIPT = `
|
|
35
|
+
$ErrorActionPreference = 'Stop'
|
|
36
|
+
$title = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_TITLE)
|
|
37
|
+
$body = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_BODY)
|
|
38
|
+
$silent = if ($env:OCS_NOTIFY_SOUND -eq '1') { '' } else { '<audio silent="true"/>' }
|
|
39
|
+
$xml = '<toast><visual><binding template="ToastGeneric"><text>' + $title + '</text><text>' + $body + '</text></binding></visual>' + $silent + '</toast>'
|
|
40
|
+
[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType=WindowsRuntime] > $null
|
|
41
|
+
[Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType=WindowsRuntime] > $null
|
|
42
|
+
$doc = [Windows.Data.Xml.Dom.XmlDocument]::new()
|
|
43
|
+
$doc.LoadXml($xml)
|
|
44
|
+
$toast = [Windows.UI.Notifications.ToastNotification]::new($doc)
|
|
45
|
+
$appId = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe'
|
|
46
|
+
[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($appId).Show($toast)
|
|
47
|
+
`.trim();
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Собирает команду нативного уведомления для платформы.
|
|
51
|
+
* Чистая функция: ничего не запускает.
|
|
52
|
+
*/
|
|
53
|
+
export function buildNativeNotificationCommand(
|
|
54
|
+
platform: NodeJS.Platform,
|
|
55
|
+
message: NativeNotificationMessage,
|
|
56
|
+
): NativeCommand {
|
|
57
|
+
const title = (message.title ?? "OpenCode Scheduler").trim() || "OpenCode Scheduler";
|
|
58
|
+
const body = String(message.body ?? "");
|
|
59
|
+
const sound = message.sound !== false;
|
|
60
|
+
|
|
61
|
+
if (platform === "win32") {
|
|
62
|
+
return {
|
|
63
|
+
command: "powershell.exe",
|
|
64
|
+
args: [
|
|
65
|
+
"-NoProfile",
|
|
66
|
+
"-NonInteractive",
|
|
67
|
+
"-ExecutionPolicy",
|
|
68
|
+
"Bypass",
|
|
69
|
+
"-Command",
|
|
70
|
+
WINDOWS_TOAST_SCRIPT,
|
|
71
|
+
],
|
|
72
|
+
env: {
|
|
73
|
+
OCS_NOTIFY_TITLE: title,
|
|
74
|
+
OCS_NOTIFY_BODY: body,
|
|
75
|
+
OCS_NOTIFY_SOUND: sound ? "1" : "0",
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
if (platform === "darwin") {
|
|
81
|
+
const script =
|
|
82
|
+
'display notification (system attribute "OCS_NOTIFY_BODY") ' +
|
|
83
|
+
'with title (system attribute "OCS_NOTIFY_TITLE")' +
|
|
84
|
+
(sound ? ' sound name "Glass"' : "");
|
|
85
|
+
return {
|
|
86
|
+
command: "osascript",
|
|
87
|
+
args: ["-e", script],
|
|
88
|
+
env: {
|
|
89
|
+
OCS_NOTIFY_TITLE: title,
|
|
90
|
+
OCS_NOTIFY_BODY: body,
|
|
91
|
+
},
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
return {
|
|
96
|
+
command: "notify-send",
|
|
97
|
+
args: [
|
|
98
|
+
"-a",
|
|
99
|
+
"OpenCode Scheduler",
|
|
100
|
+
"-u",
|
|
101
|
+
"normal",
|
|
102
|
+
"-i",
|
|
103
|
+
"dialog-information",
|
|
104
|
+
// `--` завершает разбор опций: текст уведомления может начинаться с "-"
|
|
105
|
+
// и без разделителя был бы принят за флаг notify-send.
|
|
106
|
+
"--",
|
|
107
|
+
title,
|
|
108
|
+
body,
|
|
109
|
+
],
|
|
110
|
+
};
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export interface SendNativeOptions {
|
|
114
|
+
/** Подмена платформы для тестов. */
|
|
115
|
+
platform?: NodeJS.Platform;
|
|
116
|
+
/** Подмена запуска процесса для тестов. */
|
|
117
|
+
exec?: (command: string, args: string[], env: NodeJS.ProcessEnv) => Promise<void>;
|
|
118
|
+
/** Таймаут процесса в мс. */
|
|
119
|
+
timeoutMs?: number;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
export interface NativeSendResult {
|
|
123
|
+
success: boolean;
|
|
124
|
+
error?: string;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* Показывает нативное уведомление. Никогда не бросает исключение.
|
|
129
|
+
*/
|
|
130
|
+
export async function sendNativeNotification(
|
|
131
|
+
message: NativeNotificationMessage,
|
|
132
|
+
options: SendNativeOptions = {},
|
|
133
|
+
): Promise<NativeSendResult> {
|
|
134
|
+
const platform = options.platform ?? process.platform;
|
|
135
|
+
const command = buildNativeNotificationCommand(platform, message);
|
|
136
|
+
const env = { ...process.env, ...(command.env ?? {}) };
|
|
137
|
+
const timeoutMs = Math.max(1_000, Math.floor(options.timeoutMs ?? DEFAULT_TIMEOUT_MS));
|
|
138
|
+
|
|
139
|
+
try {
|
|
140
|
+
if (options.exec) {
|
|
141
|
+
await options.exec(command.command, command.args, env);
|
|
142
|
+
} else {
|
|
143
|
+
await execFileAsync(command.command, command.args, {
|
|
144
|
+
env,
|
|
145
|
+
timeout: timeoutMs,
|
|
146
|
+
windowsHide: true,
|
|
147
|
+
maxBuffer: 1024 * 1024,
|
|
148
|
+
});
|
|
149
|
+
}
|
|
150
|
+
return { success: true };
|
|
151
|
+
} catch (err: any) {
|
|
152
|
+
return {
|
|
153
|
+
success: false,
|
|
154
|
+
error: err instanceof Error ? err.message : String(err),
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
}
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One-shot расписание (Спринт 23).
|
|
3
|
+
*
|
|
4
|
+
* Задача с triggerType "once" выполняется ровно один раз в момент runAt.
|
|
5
|
+
* Абсолютное время хранится в ISO-8601 (UTC), а delaySeconds — удобный
|
|
6
|
+
* способ задать его относительно момента создания.
|
|
7
|
+
*
|
|
8
|
+
* Модуль намеренно не зависит от планировщика ОС: здесь только нормализация
|
|
9
|
+
* времени и преобразование в родные форматы Windows/Linux/macOS. Это
|
|
10
|
+
* позволяет тестировать one-shot без создания реальных задач.
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
/** Максимальная задержка — 5 лет. Защита от опечаток вроде 999999999. */
|
|
14
|
+
export const MAX_ONESHOT_DELAY_SECONDS = 5 * 365 * 24 * 60 * 60;
|
|
15
|
+
|
|
16
|
+
/** Минимальная задержка — 1 секунда. */
|
|
17
|
+
export const MIN_ONESHOT_DELAY_SECONDS = 1;
|
|
18
|
+
|
|
19
|
+
export interface OneShotInput {
|
|
20
|
+
/** Абсолютное время запуска (ISO-8601). */
|
|
21
|
+
runAt?: unknown;
|
|
22
|
+
/** Задержка от текущего момента в секундах. */
|
|
23
|
+
delaySeconds?: unknown;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export type OneShotNormalization =
|
|
27
|
+
| {
|
|
28
|
+
ok: true;
|
|
29
|
+
/** Нормализованное абсолютное время в ISO-8601 (UTC). */
|
|
30
|
+
runAt: string;
|
|
31
|
+
/** Исходная задержка, если она была задана. */
|
|
32
|
+
delaySeconds?: number;
|
|
33
|
+
}
|
|
34
|
+
| { ok: false; error: string };
|
|
35
|
+
|
|
36
|
+
function asDelaySeconds(value: unknown): number | undefined | "invalid" {
|
|
37
|
+
if (value === undefined || value === null || value === "") return undefined;
|
|
38
|
+
if (typeof value !== "number" || !Number.isFinite(value)) return "invalid";
|
|
39
|
+
const seconds = Math.floor(value);
|
|
40
|
+
if (seconds < MIN_ONESHOT_DELAY_SECONDS || seconds > MAX_ONESHOT_DELAY_SECONDS) {
|
|
41
|
+
return "invalid";
|
|
42
|
+
}
|
|
43
|
+
return seconds;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Приводит runAt/delaySeconds к абсолютному ISO-времени.
|
|
48
|
+
*
|
|
49
|
+
* Если заданы оба поля, приоритет у runAt: delaySeconds сохраняется только
|
|
50
|
+
* как исходная подсказка. Так импорт экспортированной задачи с обоими полями
|
|
51
|
+
* не меняет момент запуска.
|
|
52
|
+
*/
|
|
53
|
+
export function normalizeOneShotRunAt(
|
|
54
|
+
input: OneShotInput,
|
|
55
|
+
nowMs: number = Date.now(),
|
|
56
|
+
): OneShotNormalization {
|
|
57
|
+
const rawRunAt =
|
|
58
|
+
typeof input.runAt === "string" ? input.runAt.trim() : undefined;
|
|
59
|
+
const delaySeconds = asDelaySeconds(input.delaySeconds);
|
|
60
|
+
|
|
61
|
+
if (delaySeconds === "invalid") {
|
|
62
|
+
return {
|
|
63
|
+
ok: false,
|
|
64
|
+
error:
|
|
65
|
+
`delaySeconds должен быть целым числом от ${MIN_ONESHOT_DELAY_SECONDS} ` +
|
|
66
|
+
`до ${MAX_ONESHOT_DELAY_SECONDS} секунд.`,
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
if (rawRunAt) {
|
|
71
|
+
const timestamp = Date.parse(rawRunAt);
|
|
72
|
+
if (!Number.isFinite(timestamp)) {
|
|
73
|
+
return {
|
|
74
|
+
ok: false,
|
|
75
|
+
error:
|
|
76
|
+
"runAt должен быть датой в формате ISO-8601, например " +
|
|
77
|
+
`2026-12-01T09:00:00Z (получено «${rawRunAt}»).`,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
if (timestamp <= nowMs) {
|
|
81
|
+
return {
|
|
82
|
+
ok: false,
|
|
83
|
+
error:
|
|
84
|
+
`runAt должен быть в будущем (получено «${rawRunAt}»). ` +
|
|
85
|
+
"Для запуска сразу используйте run_task_now.",
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
return {
|
|
89
|
+
ok: true,
|
|
90
|
+
runAt: new Date(timestamp).toISOString(),
|
|
91
|
+
...(delaySeconds !== undefined ? { delaySeconds } : {}),
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
if (delaySeconds !== undefined) {
|
|
96
|
+
return {
|
|
97
|
+
ok: true,
|
|
98
|
+
runAt: new Date(nowMs + delaySeconds * 1000).toISOString(),
|
|
99
|
+
delaySeconds,
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
return {
|
|
104
|
+
ok: false,
|
|
105
|
+
error:
|
|
106
|
+
"Для однократного запуска укажите runAt (ISO-8601) или delaySeconds.",
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
function pad(value: number): string {
|
|
111
|
+
return String(value).padStart(2, "0");
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* Формат даты/времени для schtasks /sd и /st.
|
|
116
|
+
*
|
|
117
|
+
* Windows Task Scheduler ожидает дату в формате текущей локали. На русской
|
|
118
|
+
* Windows — DD.MM.YYYY, на английской — M/d/yyyy и т.д. Жёсткий DD.MM.YYYY
|
|
119
|
+
* ломает создание one-shot и file/git/mcp-задач на не-RU Windows (P1-8).
|
|
120
|
+
* Вызывающий код (windows.ts) передаёт `dateFormat`, полученный из системной
|
|
121
|
+
* локали через PowerShell `(Get-Culture).DateTimeFormat.ShortDatePattern`.
|
|
122
|
+
*
|
|
123
|
+
* @param runAt — ISO-8601 время запуска.
|
|
124
|
+
* @param dateFormat — шаблон даты локали (например, "dd.MM.yyyy" или "M/d/yyyy").
|
|
125
|
+
* Если не задан — используется DD.MM.YYYY (по умолчанию RU).
|
|
126
|
+
*/
|
|
127
|
+
export function buildWindowsOneShotFlags(
|
|
128
|
+
runAt: string,
|
|
129
|
+
dateFormat?: string,
|
|
130
|
+
): ["/sc", "ONCE", "/sd", string, "/st", string] {
|
|
131
|
+
const date = new Date(runAt);
|
|
132
|
+
const sd = dateFormat ? formatDateByLocalePattern(date, dateFormat) : `${pad(date.getDate())}.${pad(date.getMonth() + 1)}.${date.getFullYear()}`;
|
|
133
|
+
return [
|
|
134
|
+
"/sc",
|
|
135
|
+
"ONCE",
|
|
136
|
+
"/sd",
|
|
137
|
+
sd,
|
|
138
|
+
"/st",
|
|
139
|
+
`${pad(date.getHours())}:${pad(date.getMinutes())}`,
|
|
140
|
+
];
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
|
|
145
|
+
* (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
|
|
146
|
+
* y/yy/yyyy. Неизвестные символы копируются как есть.
|
|
147
|
+
*/
|
|
148
|
+
export function formatDateByLocalePattern(date: Date, pattern: string): string {
|
|
149
|
+
const pad2 = (v: number) => String(v).padStart(2, "0");
|
|
150
|
+
return pattern
|
|
151
|
+
.replace(/yyyy/g, String(date.getFullYear()))
|
|
152
|
+
.replace(/yy/g, String(date.getFullYear()).slice(-2))
|
|
153
|
+
.replace(/MM/g, pad2(date.getMonth() + 1))
|
|
154
|
+
.replace(/M/g, String(date.getMonth() + 1))
|
|
155
|
+
.replace(/dd/g, pad2(date.getDate()))
|
|
156
|
+
.replace(/d/g, String(date.getDate()));
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
|
|
160
|
+
export function buildAtTimestamp(runAt: string): string {
|
|
161
|
+
const date = new Date(runAt);
|
|
162
|
+
return (
|
|
163
|
+
`${date.getFullYear()}` +
|
|
164
|
+
`${pad(date.getMonth() + 1)}` +
|
|
165
|
+
`${pad(date.getDate())}` +
|
|
166
|
+
`${pad(date.getHours())}` +
|
|
167
|
+
`${pad(date.getMinutes())}`
|
|
168
|
+
);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/**
|
|
172
|
+
* Bash-команда для one-shot в launchd.
|
|
173
|
+
*
|
|
174
|
+
* StartCalendarInterval не поддерживает год: без защиты задача с runAt
|
|
175
|
+
* дальше чем через год сработала бы в ближайшую годовщину, а после
|
|
176
|
+
* выполнения — повторно через год. Гейт сравнивает now с runAt и ставит
|
|
177
|
+
* маркер, привязанный ко времени запуска.
|
|
178
|
+
*/
|
|
179
|
+
export function buildOneShotGuardCommand(
|
|
180
|
+
command: string,
|
|
181
|
+
runAt: string,
|
|
182
|
+
stampPath: string,
|
|
183
|
+
): string {
|
|
184
|
+
const epoch = Math.floor(new Date(runAt).getTime() / 1000);
|
|
185
|
+
const quote = (value: string) => `'${value.replace(/'/g, "'\\''")}'`;
|
|
186
|
+
return [
|
|
187
|
+
`stamp=${quote(stampPath)}`,
|
|
188
|
+
"[ -f \"$stamp\" ] && exit 0",
|
|
189
|
+
`[ "$(date +%s)" -lt ${epoch} ] && exit 0`,
|
|
190
|
+
"mkdir -p \"$(dirname \"$stamp\")\" 2>/dev/null || true",
|
|
191
|
+
": > \"$stamp\" 2>/dev/null || true",
|
|
192
|
+
command,
|
|
193
|
+
].join("; ");
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
/**
|
|
197
|
+
* StartCalendarInterval для launchd. launchd не поддерживает год, поэтому
|
|
198
|
+
* обёртка дополнительно проверяет runAt и ставит маркер выполнения
|
|
199
|
+
* (см. buildOneShotGuardCommand).
|
|
200
|
+
*/
|
|
201
|
+
export function buildLaunchdCalendar(runAt: string): {
|
|
202
|
+
Month: number;
|
|
203
|
+
Day: number;
|
|
204
|
+
Hour: number;
|
|
205
|
+
Minute: number;
|
|
206
|
+
} {
|
|
207
|
+
const date = new Date(runAt);
|
|
208
|
+
return {
|
|
209
|
+
Month: date.getMonth() + 1,
|
|
210
|
+
Day: date.getDate(),
|
|
211
|
+
Hour: date.getHours(),
|
|
212
|
+
Minute: date.getMinutes(),
|
|
213
|
+
};
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/** Команда самоочистки launchd-агента после единственного запуска. */
|
|
217
|
+
export function buildLaunchdOneShotCleanup(
|
|
218
|
+
sanitizedName: string,
|
|
219
|
+
profile = "default",
|
|
220
|
+
): string {
|
|
221
|
+
const label = launchdLabel(sanitizedName, profile);
|
|
222
|
+
return (
|
|
223
|
+
"launchctl bootout \"gui/$(id -u)\" " +
|
|
224
|
+
`"$HOME/Library/LaunchAgents/${label}.plist" ` +
|
|
225
|
+
">/dev/null 2>&1 || true"
|
|
226
|
+
);
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/**
|
|
230
|
+
* label launchd-агента задачи. Для default сохраняется историческое имя
|
|
231
|
+
* `com.opencode.scheduler.<name>`; у не-default профиля свой префикс, чтобы
|
|
232
|
+
* одноимённые задачи разных профилей не затирали plist друг друга.
|
|
233
|
+
*/
|
|
234
|
+
export function launchdLabel(sanitizedName: string, profile = "default"): string {
|
|
235
|
+
const base = `com.opencode.scheduler.${sanitizedName}`;
|
|
236
|
+
if (profile === "default") return base;
|
|
237
|
+
const scope = profile.replace(/[^A-Za-z0-9_.-]/g, "-");
|
|
238
|
+
return `com.opencode.scheduler.profile-${scope}.${sanitizedName}`;
|
|
239
|
+
}
|
package/src/core/otel.ts
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
import { getPluginVersion } from "../version.js";
|
|
3
|
+
import { getProfileName } from "../profiles.js";
|
|
4
|
+
import { getSchedulerTitle } from "./scheduler/index.js";
|
|
5
|
+
import type { StoredHistoryRecord } from "../db/history-repo.js";
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Экспорт истории в OpenTelemetry-совместимом виде (Спринт 22).
|
|
9
|
+
*
|
|
10
|
+
* Формат — OTLP/JSON (`resourceSpans` → `scopeSpans` → `spans`), который
|
|
11
|
+
* принимают Collector, Jaeger, Tempo и большинство бэкендов после
|
|
12
|
+
* `otlp`-приёмника. Один запуск = один span.
|
|
13
|
+
*
|
|
14
|
+
* Идентификаторы детерминированы: sha256 от задачи, времени старта и id,
|
|
15
|
+
* поэтому повторный экспорт даёт стабильные traceId/spanId.
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
interface OtlpAttributeValue {
|
|
19
|
+
stringValue?: string;
|
|
20
|
+
intValue?: string;
|
|
21
|
+
doubleValue?: number;
|
|
22
|
+
boolValue?: boolean;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
interface OtlpAttribute {
|
|
26
|
+
key: string;
|
|
27
|
+
value: OtlpAttributeValue;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
function stringAttr(key: string, value: string | null | undefined): OtlpAttribute | null {
|
|
31
|
+
if (value == null || value === "") return null;
|
|
32
|
+
return { key, value: { stringValue: String(value) } };
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function intAttr(key: string, value: number | null | undefined): OtlpAttribute | null {
|
|
36
|
+
if (typeof value !== "number" || !Number.isFinite(value)) return null;
|
|
37
|
+
return { key, value: { intValue: String(Math.trunc(value)) } };
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function doubleAttr(key: string, value: number | null | undefined): OtlpAttribute | null {
|
|
41
|
+
if (typeof value !== "number" || !Number.isFinite(value)) return null;
|
|
42
|
+
return { key, value: { doubleValue: value } };
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function compact(attrs: (OtlpAttribute | null)[]): OtlpAttribute[] {
|
|
46
|
+
return attrs.filter((attr): attr is OtlpAttribute => attr != null);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function toUnixNano(value: string | null | undefined): string | null {
|
|
50
|
+
if (!value) return null;
|
|
51
|
+
const ms = new Date(value).getTime();
|
|
52
|
+
if (!Number.isFinite(ms)) return null;
|
|
53
|
+
return (BigInt(Math.trunc(ms)) * 1000000n).toString();
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
function hashIds(record: StoredHistoryRecord): { traceId: string; spanId: string } {
|
|
57
|
+
const digest = crypto
|
|
58
|
+
.createHash("sha256")
|
|
59
|
+
.update(
|
|
60
|
+
`${record.taskName}|${record.startedAt}|${record.id ?? 0}`,
|
|
61
|
+
"utf8",
|
|
62
|
+
)
|
|
63
|
+
.digest("hex");
|
|
64
|
+
return { traceId: digest.slice(0, 32), spanId: digest.slice(32, 48) };
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** Строит OTLP/JSON-документ из записей истории. */
|
|
68
|
+
export function buildOtlpExport(records: StoredHistoryRecord[]): Record<string, unknown> {
|
|
69
|
+
const version = getPluginVersion();
|
|
70
|
+
const spans = records.map((record) => {
|
|
71
|
+
const { traceId, spanId } = hashIds(record);
|
|
72
|
+
const start = toUnixNano(record.startedAt) ?? "0";
|
|
73
|
+
const end = toUnixNano(record.finishedAt) ?? start;
|
|
74
|
+
const isRunning = record.status === "running";
|
|
75
|
+
const isError = !isRunning && record.status !== "success";
|
|
76
|
+
const attributes = compact([
|
|
77
|
+
stringAttr("task.name", record.taskName),
|
|
78
|
+
intAttr("run.id", record.id),
|
|
79
|
+
stringAttr("run.status", record.status),
|
|
80
|
+
intAttr("run.duration_ms", record.durationMs),
|
|
81
|
+
intAttr("run.tokens", record.tokens),
|
|
82
|
+
doubleAttr("run.cost_usd", record.costUsd),
|
|
83
|
+
stringAttr("llm.model", record.model),
|
|
84
|
+
stringAttr("error.message", record.error),
|
|
85
|
+
stringAttr("next.task", record.nextTask),
|
|
86
|
+
stringAttr("workspace.id", record.workspaceId),
|
|
87
|
+
stringAttr("pre_flight.status", record.preFlightStatus),
|
|
88
|
+
stringAttr("post_flight.status", record.postFlightStatus),
|
|
89
|
+
]);
|
|
90
|
+
return {
|
|
91
|
+
traceId,
|
|
92
|
+
spanId,
|
|
93
|
+
name: `${record.taskName} run`,
|
|
94
|
+
kind: 1,
|
|
95
|
+
startTimeUnixNano: start,
|
|
96
|
+
endTimeUnixNano: end,
|
|
97
|
+
attributes,
|
|
98
|
+
status: {
|
|
99
|
+
code: isRunning ? 0 : isError ? 2 : 1,
|
|
100
|
+
...(isError && record.error ? { message: String(record.error) } : {}),
|
|
101
|
+
},
|
|
102
|
+
};
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
return {
|
|
106
|
+
resourceSpans: [
|
|
107
|
+
{
|
|
108
|
+
resource: {
|
|
109
|
+
attributes: compact([
|
|
110
|
+
stringAttr("service.name", "agent-steward"),
|
|
111
|
+
stringAttr("service.version", version),
|
|
112
|
+
stringAttr("scheduler.profile", getProfileName()),
|
|
113
|
+
stringAttr("scheduler.backend", getSchedulerTitle()),
|
|
114
|
+
]),
|
|
115
|
+
},
|
|
116
|
+
scopeSpans: [
|
|
117
|
+
{
|
|
118
|
+
scope: {
|
|
119
|
+
name: "agent-steward",
|
|
120
|
+
version,
|
|
121
|
+
},
|
|
122
|
+
spans,
|
|
123
|
+
},
|
|
124
|
+
],
|
|
125
|
+
},
|
|
126
|
+
],
|
|
127
|
+
};
|
|
128
|
+
}
|