agent-steward 0.0.1 → 0.0.2

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 (333) hide show
  1. package/CHANGELOG.md +376 -0
  2. package/CROSS_PLATFORM.md +149 -0
  3. package/README.md +306 -15
  4. package/ROADMAP-STRATEGY.md +147 -0
  5. package/ROADMAP.md +1069 -0
  6. package/dist/core/analytics.d.ts +132 -0
  7. package/dist/core/analytics.d.ts.map +1 -0
  8. package/dist/core/analytics.js +290 -0
  9. package/dist/core/audit.d.ts +96 -0
  10. package/dist/core/audit.d.ts.map +1 -0
  11. package/dist/core/audit.js +297 -0
  12. package/dist/core/cron-to-schtasks.d.ts +20 -0
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  14. package/dist/core/cron-to-schtasks.js +250 -0
  15. package/dist/core/dry-run.d.ts +102 -0
  16. package/dist/core/dry-run.d.ts.map +1 -0
  17. package/dist/core/dry-run.js +447 -0
  18. package/dist/core/file-watcher.d.ts +31 -0
  19. package/dist/core/file-watcher.d.ts.map +1 -0
  20. package/dist/core/file-watcher.js +186 -0
  21. package/dist/core/git-trigger.d.ts +82 -0
  22. package/dist/core/git-trigger.d.ts.map +1 -0
  23. package/dist/core/git-trigger.js +312 -0
  24. package/dist/core/glob.d.ts +38 -0
  25. package/dist/core/glob.d.ts.map +1 -0
  26. package/dist/core/glob.js +233 -0
  27. package/dist/core/local-ai.d.ts +52 -0
  28. package/dist/core/local-ai.d.ts.map +1 -0
  29. package/dist/core/local-ai.js +119 -0
  30. package/dist/core/lock.d.ts +57 -0
  31. package/dist/core/lock.d.ts.map +1 -0
  32. package/dist/core/lock.js +195 -0
  33. package/dist/core/matrix.d.ts +167 -0
  34. package/dist/core/matrix.d.ts.map +1 -0
  35. package/dist/core/matrix.js +724 -0
  36. package/dist/core/native-notify.d.ts +36 -0
  37. package/dist/core/native-notify.d.ts.map +1 -0
  38. package/dist/core/native-notify.js +113 -0
  39. package/dist/core/one-shot.d.ts +68 -0
  40. package/dist/core/one-shot.d.ts.map +1 -0
  41. package/dist/core/one-shot.js +139 -0
  42. package/dist/core/otel.d.ts +4 -0
  43. package/dist/core/otel.d.ts.map +1 -0
  44. package/dist/core/otel.js +98 -0
  45. package/dist/core/permissions.d.ts +69 -0
  46. package/dist/core/permissions.d.ts.map +1 -0
  47. package/dist/core/permissions.js +143 -0
  48. package/dist/core/prometheus.d.ts +23 -0
  49. package/dist/core/prometheus.d.ts.map +1 -0
  50. package/dist/core/prometheus.js +146 -0
  51. package/dist/core/ps-wrapper.d.ts +73 -0
  52. package/dist/core/ps-wrapper.d.ts.map +1 -0
  53. package/dist/core/ps-wrapper.js +1071 -0
  54. package/dist/core/record-history.d.ts +25 -0
  55. package/dist/core/record-history.d.ts.map +1 -0
  56. package/dist/core/record-history.js +471 -0
  57. package/dist/core/retention.d.ts +29 -0
  58. package/dist/core/retention.d.ts.map +1 -0
  59. package/dist/core/retention.js +98 -0
  60. package/dist/core/savings.d.ts +70 -0
  61. package/dist/core/savings.d.ts.map +1 -0
  62. package/dist/core/savings.js +87 -0
  63. package/dist/core/schedule-gate.d.ts +2 -0
  64. package/dist/core/schedule-gate.d.ts.map +1 -0
  65. package/dist/core/schedule-gate.js +211 -0
  66. package/dist/core/schedule-v2.d.ts +116 -0
  67. package/dist/core/schedule-v2.d.ts.map +1 -0
  68. package/dist/core/schedule-v2.js +586 -0
  69. package/dist/core/scheduler/index.d.ts +32 -0
  70. package/dist/core/scheduler/index.d.ts.map +1 -0
  71. package/dist/core/scheduler/index.js +63 -0
  72. package/dist/core/scheduler/linux.d.ts +44 -0
  73. package/dist/core/scheduler/linux.d.ts.map +1 -0
  74. package/dist/core/scheduler/linux.js +225 -0
  75. package/dist/core/scheduler/logs.d.ts +11 -0
  76. package/dist/core/scheduler/logs.d.ts.map +1 -0
  77. package/dist/core/scheduler/logs.js +34 -0
  78. package/dist/core/scheduler/mac.d.ts +40 -0
  79. package/dist/core/scheduler/mac.d.ts.map +1 -0
  80. package/dist/core/scheduler/mac.js +207 -0
  81. package/dist/core/scheduler/posix.d.ts +40 -0
  82. package/dist/core/scheduler/posix.d.ts.map +1 -0
  83. package/dist/core/scheduler/posix.js +89 -0
  84. package/dist/core/scheduler/registry.d.ts +41 -0
  85. package/dist/core/scheduler/registry.d.ts.map +1 -0
  86. package/dist/core/scheduler/registry.js +57 -0
  87. package/dist/core/scheduler/types.d.ts +86 -0
  88. package/dist/core/scheduler/types.d.ts.map +1 -0
  89. package/dist/core/scheduler/types.js +1 -0
  90. package/dist/core/scheduler/windows.d.ts +99 -0
  91. package/dist/core/scheduler/windows.d.ts.map +1 -0
  92. package/dist/core/scheduler/windows.js +596 -0
  93. package/dist/core/secrets.d.ts +66 -0
  94. package/dist/core/secrets.d.ts.map +1 -0
  95. package/dist/core/secrets.js +433 -0
  96. package/dist/core/self-analysis.d.ts +117 -0
  97. package/dist/core/self-analysis.d.ts.map +1 -0
  98. package/dist/core/self-analysis.js +539 -0
  99. package/dist/core/self-analysis.test.d.ts +2 -0
  100. package/dist/core/self-analysis.test.d.ts.map +1 -0
  101. package/dist/core/self-analysis.test.js +219 -0
  102. package/dist/core/session.d.ts +42 -0
  103. package/dist/core/session.d.ts.map +1 -0
  104. package/dist/core/session.js +134 -0
  105. package/dist/core/shutdown.d.ts +26 -0
  106. package/dist/core/shutdown.d.ts.map +1 -0
  107. package/dist/core/shutdown.js +49 -0
  108. package/dist/core/structured-log.d.ts +84 -0
  109. package/dist/core/structured-log.d.ts.map +1 -0
  110. package/dist/core/structured-log.js +146 -0
  111. package/dist/core/summary.d.ts +69 -0
  112. package/dist/core/summary.d.ts.map +1 -0
  113. package/dist/core/summary.js +250 -0
  114. package/dist/core/telegram.d.ts +55 -0
  115. package/dist/core/telegram.d.ts.map +1 -0
  116. package/dist/core/telegram.js +344 -0
  117. package/dist/core/triage-chain.d.ts +40 -0
  118. package/dist/core/triage-chain.d.ts.map +1 -0
  119. package/dist/core/triage-chain.js +80 -0
  120. package/dist/core/triage-compare.d.ts +68 -0
  121. package/dist/core/triage-compare.d.ts.map +1 -0
  122. package/dist/core/triage-compare.js +184 -0
  123. package/dist/core/triage-rules.d.ts +23 -0
  124. package/dist/core/triage-rules.d.ts.map +1 -0
  125. package/dist/core/triage-rules.js +196 -0
  126. package/dist/core/triage-shadow.d.ts +91 -0
  127. package/dist/core/triage-shadow.d.ts.map +1 -0
  128. package/dist/core/triage-shadow.js +160 -0
  129. package/dist/core/triage-worker.d.ts +55 -0
  130. package/dist/core/triage-worker.d.ts.map +1 -0
  131. package/dist/core/triage-worker.js +314 -0
  132. package/dist/core/triage.d.ts +76 -0
  133. package/dist/core/triage.d.ts.map +1 -0
  134. package/dist/core/triage.js +271 -0
  135. package/dist/core/watch-paths.d.ts +6 -0
  136. package/dist/core/watch-paths.d.ts.map +1 -0
  137. package/dist/core/watch-paths.js +62 -0
  138. package/dist/core/wrappers/bash.d.ts +95 -0
  139. package/dist/core/wrappers/bash.d.ts.map +1 -0
  140. package/dist/core/wrappers/bash.js +413 -0
  141. package/dist/db/git-state-repo.d.ts +16 -0
  142. package/dist/db/git-state-repo.d.ts.map +1 -0
  143. package/dist/db/git-state-repo.js +38 -0
  144. package/dist/db/history-repo.d.ts +110 -0
  145. package/dist/db/history-repo.d.ts.map +1 -0
  146. package/dist/db/history-repo.js +300 -0
  147. package/dist/db/index.d.ts +47 -0
  148. package/dist/db/index.d.ts.map +1 -0
  149. package/dist/db/index.js +120 -0
  150. package/dist/db/metrics-repo.d.ts +46 -0
  151. package/dist/db/metrics-repo.d.ts.map +1 -0
  152. package/dist/db/metrics-repo.js +103 -0
  153. package/dist/db/migrate.d.ts +24 -0
  154. package/dist/db/migrate.d.ts.map +1 -0
  155. package/dist/db/migrate.js +244 -0
  156. package/dist/db/recovery.d.ts +11 -0
  157. package/dist/db/recovery.d.ts.map +1 -0
  158. package/dist/db/recovery.js +38 -0
  159. package/dist/db/schema.d.ts +24 -0
  160. package/dist/db/schema.d.ts.map +1 -0
  161. package/dist/db/schema.js +170 -0
  162. package/dist/db/settings-repo.d.ts +8 -0
  163. package/dist/db/settings-repo.d.ts.map +1 -0
  164. package/dist/db/settings-repo.js +27 -0
  165. package/dist/db/tasks-repo.d.ts +26 -0
  166. package/dist/db/tasks-repo.d.ts.map +1 -0
  167. package/dist/db/tasks-repo.js +120 -0
  168. package/dist/db/templates-repo.d.ts +17 -0
  169. package/dist/db/templates-repo.d.ts.map +1 -0
  170. package/dist/db/templates-repo.js +57 -0
  171. package/dist/gui-experimental.cjs +1 -0
  172. package/dist/history.d.ts +60 -0
  173. package/dist/history.d.ts.map +1 -0
  174. package/dist/history.js +70 -0
  175. package/dist/i18n.d.ts +75 -0
  176. package/dist/i18n.d.ts.map +1 -0
  177. package/dist/i18n.js +357 -0
  178. package/dist/index.d.ts +858 -0
  179. package/dist/index.d.ts.map +1 -0
  180. package/dist/index.js +5179 -0
  181. package/dist/integrations.d.ts +72 -0
  182. package/dist/integrations.d.ts.map +1 -0
  183. package/dist/integrations.js +233 -0
  184. package/dist/notifications.d.ts +199 -0
  185. package/dist/notifications.d.ts.map +1 -0
  186. package/dist/notifications.js +967 -0
  187. package/dist/profiles.d.ts +60 -0
  188. package/dist/profiles.d.ts.map +1 -0
  189. package/dist/profiles.js +227 -0
  190. package/dist/rpc.d.ts +3806 -0
  191. package/dist/rpc.d.ts.map +1 -0
  192. package/dist/rpc.js +1507 -0
  193. package/dist/schtasks.d.ts +32 -0
  194. package/dist/schtasks.d.ts.map +1 -0
  195. package/dist/schtasks.js +45 -0
  196. package/dist/server.d.ts +128 -0
  197. package/dist/server.d.ts.map +1 -0
  198. package/dist/server.js +2413 -0
  199. package/dist/settings.d.ts +389 -0
  200. package/dist/settings.d.ts.map +1 -0
  201. package/dist/settings.js +770 -0
  202. package/dist/shared/jobs-view.d.ts +59 -0
  203. package/dist/shared/jobs-view.d.ts.map +1 -0
  204. package/dist/shared/jobs-view.js +146 -0
  205. package/dist/skill.d.ts +15 -0
  206. package/dist/skill.d.ts.map +1 -0
  207. package/dist/skill.js +93 -0
  208. package/dist/task-transfer.d.ts +252 -0
  209. package/dist/task-transfer.d.ts.map +1 -0
  210. package/dist/task-transfer.js +628 -0
  211. package/dist/templates.d.ts +57 -0
  212. package/dist/templates.d.ts.map +1 -0
  213. package/dist/templates.js +16 -0
  214. package/dist/types.d.ts +96 -0
  215. package/dist/types.d.ts.map +1 -0
  216. package/dist/types.js +130 -0
  217. package/dist/version.d.ts +8 -0
  218. package/dist/version.d.ts.map +1 -0
  219. package/dist/version.js +27 -0
  220. package/dist/workspaces.d.ts +113 -0
  221. package/dist/workspaces.d.ts.map +1 -0
  222. package/dist/workspaces.js +393 -0
  223. package/docs/ARCHITECTURE.md +457 -0
  224. package/docs/COMPATIBILITY.md +233 -0
  225. package/docs/CONCEPT.md +230 -0
  226. package/docs/CROSS_PLATFORM.ru.md +150 -0
  227. package/docs/CROSS_PLATFORM.zh.md +146 -0
  228. package/docs/FAQ.md +52 -0
  229. package/docs/FAQ.ru.md +53 -0
  230. package/docs/FAQ.zh.md +43 -0
  231. package/docs/FEATURES.md +698 -0
  232. package/docs/FEATURES.zh.md +655 -0
  233. package/docs/LOCAL-AI.md +300 -0
  234. package/docs/MIGRATION.md +355 -0
  235. package/docs/README.ru.md +268 -0
  236. package/docs/README.zh.md +305 -0
  237. package/docs/SAVINGS.md +61 -0
  238. package/docs/SAVINGS.ru.md +60 -0
  239. package/docs/SAVINGS.zh.md +52 -0
  240. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  241. package/docs/ZH-LOCALE-PLAN.md +324 -0
  242. package/docs/dashboard.png +0 -0
  243. package/docs/spikes/local-model-structured-output.md +81 -0
  244. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  245. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  246. package/gui-experimental.cjs +9 -0
  247. package/index.js +1 -0
  248. package/locales/en.json +780 -0
  249. package/locales/ru.json +780 -0
  250. package/locales/zh.json +780 -0
  251. package/package.json +133 -13
  252. package/scripts/bench-local.mjs +321 -0
  253. package/scripts/check-zh-locale.mjs +218 -0
  254. package/scripts/demo-dashboard.mjs +209 -0
  255. package/scripts/run-tests.mjs +236 -0
  256. package/scripts/spike-local-structured.mjs +182 -0
  257. package/scripts/test-locale.mjs +45 -0
  258. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  259. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  260. package/src/core/analytics.ts +424 -0
  261. package/src/core/audit.ts +418 -0
  262. package/src/core/cron-to-schtasks.ts +288 -0
  263. package/src/core/dry-run.ts +601 -0
  264. package/src/core/file-watcher.ts +245 -0
  265. package/src/core/git-trigger.ts +391 -0
  266. package/src/core/glob.ts +226 -0
  267. package/src/core/local-ai.ts +173 -0
  268. package/src/core/lock.ts +219 -0
  269. package/src/core/matrix.ts +947 -0
  270. package/src/core/native-notify.ts +157 -0
  271. package/src/core/one-shot.ts +189 -0
  272. package/src/core/otel.ts +128 -0
  273. package/src/core/permissions.ts +200 -0
  274. package/src/core/prometheus.ts +215 -0
  275. package/src/core/ps-wrapper.ts +1140 -0
  276. package/src/core/record-history.ts +615 -0
  277. package/src/core/retention.ts +141 -0
  278. package/src/core/savings.ts +150 -0
  279. package/src/core/schedule-gate.ts +253 -0
  280. package/src/core/schedule-v2.ts +668 -0
  281. package/src/core/scheduler/index.ts +82 -0
  282. package/src/core/scheduler/linux.ts +257 -0
  283. package/src/core/scheduler/logs.ts +37 -0
  284. package/src/core/scheduler/mac.ts +270 -0
  285. package/src/core/scheduler/posix.ts +114 -0
  286. package/src/core/scheduler/registry.ts +99 -0
  287. package/src/core/scheduler/types.ts +90 -0
  288. package/src/core/scheduler/windows.ts +711 -0
  289. package/src/core/secrets.ts +503 -0
  290. package/src/core/self-analysis.ts +744 -0
  291. package/src/core/session.ts +150 -0
  292. package/src/core/shutdown.ts +69 -0
  293. package/src/core/structured-log.ts +214 -0
  294. package/src/core/summary.ts +318 -0
  295. package/src/core/telegram.ts +436 -0
  296. package/src/core/triage-chain.ts +125 -0
  297. package/src/core/triage-compare.ts +277 -0
  298. package/src/core/triage-rules.ts +238 -0
  299. package/src/core/triage-shadow.ts +240 -0
  300. package/src/core/triage-worker.ts +344 -0
  301. package/src/core/triage.ts +366 -0
  302. package/src/core/watch-paths.ts +70 -0
  303. package/src/core/wrappers/bash.ts +532 -0
  304. package/src/db/git-state-repo.ts +62 -0
  305. package/src/db/history-repo.ts +492 -0
  306. package/src/db/index.ts +166 -0
  307. package/src/db/metrics-repo.ts +170 -0
  308. package/src/db/migrate.ts +328 -0
  309. package/src/db/recovery.ts +46 -0
  310. package/src/db/schema.ts +188 -0
  311. package/src/db/settings-repo.ts +31 -0
  312. package/src/db/tasks-repo.ts +162 -0
  313. package/src/db/templates-repo.ts +77 -0
  314. package/src/gui.tsx +5222 -0
  315. package/src/history.ts +128 -0
  316. package/src/i18n.ts +413 -0
  317. package/src/index.ts +6605 -0
  318. package/src/integrations.ts +297 -0
  319. package/src/notifications.ts +1346 -0
  320. package/src/profiles.ts +254 -0
  321. package/src/rpc.ts +1609 -0
  322. package/src/schtasks.ts +75 -0
  323. package/src/server.ts +2662 -0
  324. package/src/settings.ts +1369 -0
  325. package/src/shared/jobs-view.ts +188 -0
  326. package/src/skill.ts +113 -0
  327. package/src/task-transfer.ts +944 -0
  328. package/src/templates.ts +67 -0
  329. package/src/tui-v1.tsx +341 -0
  330. package/src/tui.tsx +329 -0
  331. package/src/types.ts +191 -0
  332. package/src/version.ts +27 -0
  333. package/src/workspaces.ts +487 -0
package/src/tui.tsx ADDED
@@ -0,0 +1,329 @@
1
+ /** @jsxImportSource @opentui/solid */
2
+ import { Plugin } from "@opencode/plugin/tui"
3
+ import { getSchedulerBackend } from "./core/scheduler/index"
4
+ import { getTaskLogs } from "./core/scheduler/logs"
5
+ import { tuiV1 } from "./tui-v1"
6
+ import {
7
+ formatJobLog,
8
+ getJobsView,
9
+ groupJobsForDisplay,
10
+ nextJobSelection,
11
+ statusIcon,
12
+ type JobView,
13
+ } from "./shared/jobs-view"
14
+
15
+ type JobAction = "run" | "pause" | "resume" | "log"
16
+
17
+ /**
18
+ * TUI-часть плагина: панель "Планировщик Windows" в боковой панели терминала.
19
+ * Рендеринг — @opentui/solid (JSX-примитивы <box> и <text>).
20
+ * Слот боковой панели в OpenCode v2 называется "sidebar.content".
21
+ *
22
+ * Данные читаются из реального планировщика и истории. Список хранится в
23
+ * reactive store контекста и обновляется раз в 5 секунд, поэтому панель
24
+ * не остаётся статическим снимком первого рендера.
25
+ */
26
+ export const v2Tui = Plugin.define({
27
+ id: "opencode-windows-scheduler.tui",
28
+ async setup(ctx) {
29
+ // Первый снимок загружаем до регистрации слота, чтобы не показывать
30
+ // пустую панель при старте. Ошибки чтения не должны ломать TUI.
31
+ let initialJobs: JobView[] = []
32
+ try {
33
+ initialJobs = await getJobsView(ctx)
34
+ } catch {
35
+ initialJobs = []
36
+ }
37
+
38
+ // Не используем solid-js сигналы: TUI-рантайм и локальный node_modules
39
+ // могут держать разные копии solid-js, и реактивность не свяжется.
40
+ // store из ctx.storage — штатный способ отдавать данные в render.
41
+ const [state, setState] = ctx.storage.store("jobs", {
42
+ initial: {
43
+ jobs: initialJobs,
44
+ selected: groupJobsForDisplay(initialJobs)[0]?.job.name ?? "",
45
+ },
46
+ })
47
+
48
+ let disposed = false
49
+
50
+ async function refresh(): Promise<void> {
51
+ try {
52
+ const jobs = await getJobsView(ctx)
53
+ if (disposed) return
54
+ await setState((draft) => {
55
+ draft.jobs = jobs
56
+ // Сохраняем выбор между обновлениями; если задача исчезла,
57
+ // выделяем первую строку, чтобы клавиатурные команды оставались рабочими.
58
+ const stillExists = jobs.some((job) => job.name === draft.selected)
59
+ if (!stillExists) {
60
+ draft.selected = groupJobsForDisplay(jobs)[0]?.job.name ?? ""
61
+ }
62
+ })
63
+ } catch {
64
+ // Планировщик может быть временно недоступен (например, нет прав
65
+ // на schtasks). Оставляем последний успешный список на экране.
66
+ }
67
+ }
68
+
69
+ async function showLog(job: JobView): Promise<void> {
70
+ try {
71
+ const result = await getTaskLogs(job.name, 200)
72
+ await ctx.ui.dialog.alert({
73
+ title: `Лог: ${job.name}`,
74
+ message: formatJobLog(result.logs, result.error, 40),
75
+ })
76
+ } catch (err) {
77
+ ctx.ui.toast.show({
78
+ title: "Планировщик Windows",
79
+ message: `Не удалось прочитать лог «${job.name}»: ${
80
+ err instanceof Error ? err.message : String(err)
81
+ }`,
82
+ variant: "error",
83
+ })
84
+ }
85
+ }
86
+
87
+ /** Перемещает выделение по видимому списку задач. */
88
+ async function moveSelection(delta: number): Promise<void> {
89
+ const name = nextJobSelection(
90
+ groupJobsForDisplay(state.jobs),
91
+ state.selected,
92
+ delta
93
+ )
94
+ if (!name || disposed) return
95
+ await setState((draft) => {
96
+ draft.selected = name
97
+ })
98
+ }
99
+
100
+ async function openSelected(): Promise<void> {
101
+ const job = state.jobs.find((item) => item.name === state.selected)
102
+ if (job) await openActions(job)
103
+ }
104
+
105
+ async function runAction(job: JobView, action: JobAction): Promise<void> {
106
+ try {
107
+ if (action === "log") {
108
+ await showLog(job)
109
+ return
110
+ }
111
+ const backend = getSchedulerBackend()
112
+ if (action === "run") {
113
+ const result = await backend.runTask(job.name)
114
+ ctx.ui.toast.show({
115
+ title: "Планировщик Windows",
116
+ message: result.alreadyRunning
117
+ ? `«${job.name}» уже выполняется`
118
+ : `Запущено: ${job.name}`,
119
+ variant: result.alreadyRunning ? "warning" : "success",
120
+ })
121
+ } else {
122
+ const shouldPause = action === "pause"
123
+ if (shouldPause) await backend.pauseTask(job.name)
124
+ else await backend.resumeTask(job.name)
125
+ ctx.ui.toast.show({
126
+ title: "Планировщик Windows",
127
+ message: shouldPause
128
+ ? `Пауза: ${job.name}`
129
+ : `Возобновлено: ${job.name}`,
130
+ variant: "success",
131
+ })
132
+ }
133
+ await refresh()
134
+ } catch (err) {
135
+ ctx.ui.toast.show({
136
+ title: "Планировщик Windows",
137
+ message: `Не удалось выполнить действие для «${job.name}»: ${
138
+ err instanceof Error ? err.message : String(err)
139
+ }`,
140
+ variant: "error",
141
+ })
142
+ }
143
+ }
144
+
145
+ async function openActions(job: JobView): Promise<void> {
146
+ try {
147
+ const options: Array<{
148
+ title: string
149
+ value: JobAction
150
+ description?: string
151
+ disabled?: boolean
152
+ }> = []
153
+ options.push({
154
+ title: "▶ Запустить сейчас",
155
+ value: "run",
156
+ description: job.matrixParentId
157
+ ? "Клон матрицы запускается через родительскую задачу"
158
+ : job.status === "running"
159
+ ? "Задача уже выполняется"
160
+ : "Запустить задачу немедленно",
161
+ disabled: Boolean(job.matrixParentId),
162
+ })
163
+ options.push({
164
+ title: job.paused ? "▶ Возобновить" : "⏸ Поставить на паузу",
165
+ value: job.paused ? "resume" : "pause",
166
+ description: job.paused
167
+ ? "Снять задачу с паузы в планировщике ОС"
168
+ : "Приостановить запуски в планировщике ОС",
169
+ })
170
+ options.push({
171
+ title: "📜 Показать лог",
172
+ value: "log",
173
+ description: "Последние 40 строк вывода задачи",
174
+ })
175
+
176
+ const action = await ctx.ui.dialog.select<JobAction>({
177
+ title: `Задача: ${job.name}`,
178
+ placeholder: "Выберите действие",
179
+ options,
180
+ })
181
+ if (!action || disposed) return
182
+ await runAction(job, action)
183
+ } catch (err) {
184
+ ctx.ui.toast.show({
185
+ title: "Планировщик Windows",
186
+ message: `Не удалось открыть действия: ${
187
+ err instanceof Error ? err.message : String(err)
188
+ }`,
189
+ variant: "error",
190
+ })
191
+ }
192
+ }
193
+
194
+ async function chooseJob(): Promise<void> {
195
+ try {
196
+ if (state.jobs.length === 0) {
197
+ ctx.ui.toast.show({
198
+ title: "Планировщик Windows",
199
+ message: "Задач пока нет",
200
+ variant: "warning",
201
+ })
202
+ return
203
+ }
204
+ const name = await ctx.ui.dialog.select<string>({
205
+ title: "Планировщик: выберите задачу",
206
+ placeholder: "Имя задачи",
207
+ options: groupJobsForDisplay(state.jobs).map(({ job, depth }) => ({
208
+ title: `${" ".repeat(depth)}${job.isMatrixParent ? "▣ " : depth > 0 ? "↳ " : ""}${job.name}`,
209
+ value: job.name,
210
+ description: `${statusIcon(job.status)}${
211
+ job.paused ? " пауза" : ""
212
+ }${job.nextRun ? ` · следующий запуск: ${job.nextRun}` : ""}`,
213
+ })),
214
+ })
215
+ if (!name || disposed) return
216
+ const job = state.jobs.find((item) => item.name === name)
217
+ if (job) await openActions(job)
218
+ } catch (err) {
219
+ ctx.ui.toast.show({
220
+ title: "Планировщик Windows",
221
+ message: `Не удалось открыть список задач: ${
222
+ err instanceof Error ? err.message : String(err)
223
+ }`,
224
+ variant: "error",
225
+ })
226
+ }
227
+ }
228
+
229
+ // Команда доступна из палитры команд; горячая клавиша — удобный shortcut.
230
+ ctx.keymap.layer(() => ({
231
+ commands: [
232
+ {
233
+ id: "opencode-windows-scheduler.actions",
234
+ title: "Планировщик: действия с задачей",
235
+ description: "Запустить, поставить на паузу или возобновить задачу",
236
+ group: "Планировщик Windows",
237
+ palette: true,
238
+ bind: "ctrl+shift+j",
239
+ run: () => {
240
+ void chooseJob()
241
+ },
242
+ },
243
+ {
244
+ id: "opencode-windows-scheduler.refresh",
245
+ title: "Планировщик: обновить список",
246
+ group: "Планировщик Windows",
247
+ palette: true,
248
+ run: () => {
249
+ void refresh()
250
+ },
251
+ },
252
+ {
253
+ id: "opencode-windows-scheduler.previous",
254
+ title: "Планировщик: предыдущая задача",
255
+ group: "Планировщик Windows",
256
+ palette: true,
257
+ bind: "ctrl+shift+up",
258
+ run: () => {
259
+ void moveSelection(-1)
260
+ },
261
+ },
262
+ {
263
+ id: "opencode-windows-scheduler.next",
264
+ title: "Планировщик: следующая задача",
265
+ group: "Планировщик Windows",
266
+ palette: true,
267
+ bind: "ctrl+shift+down",
268
+ run: () => {
269
+ void moveSelection(1)
270
+ },
271
+ },
272
+ {
273
+ id: "opencode-windows-scheduler.open-selected",
274
+ title: "Планировщик: действия с выбранной задачей",
275
+ group: "Планировщик Windows",
276
+ palette: true,
277
+ bind: "ctrl+shift+enter",
278
+ run: () => {
279
+ void openSelected()
280
+ },
281
+ },
282
+ ],
283
+ }))
284
+
285
+ const timer = setInterval(() => {
286
+ void refresh()
287
+ }, 5000)
288
+ // Не держим событийный цикл, если TUI закрывается между тиками.
289
+ if (typeof timer === "object" && timer !== null && "unref" in timer) {
290
+ ;(timer as { unref?: () => void }).unref?.()
291
+ }
292
+
293
+ ctx.ui.slot({
294
+ append: "sidebar.content",
295
+ render: () => (
296
+ <box flexDirection="column">
297
+ <text>Планировщик Windows</text>
298
+ {state.jobs.length === 0 ? (
299
+ <text>Задач пока нет</text>
300
+ ) : (
301
+ groupJobsForDisplay(state.jobs).map(({ job, depth }) => (
302
+ <text onMouseDown={() => void openActions(job)}>
303
+ {state.selected === job.name ? "› " : " "}
304
+ {" ".repeat(depth)}
305
+ {depth > 0 ? "↳ " : job.isMatrixParent ? "▣ " : ""}
306
+ {statusIcon(job.status)} {job.name}
307
+ {job.paused ? " (пауза)" : ""}
308
+ {job.nextRun ? ` → ${job.nextRun}` : ""}
309
+ </text>
310
+ ))
311
+ )}
312
+ <text>Клик — действия · Ctrl+Shift+J — меню</text>
313
+ <text>Ctrl+Shift+↑/↓ — выбор · Ctrl+Shift+Enter — открыть</text>
314
+ </box>
315
+ ),
316
+ })
317
+
318
+ return () => {
319
+ disposed = true
320
+ clearInterval(timer)
321
+ }
322
+ },
323
+ })
324
+
325
+ /**
326
+ * Один и тот же TUI-модуль обслуживает обе линии: V2 читает `setup`,
327
+ * V1 — `tui`. Лишнее поле каждая линия игнорирует.
328
+ */
329
+ export default { ...v2Tui, tui: tuiV1 }
package/src/types.ts ADDED
@@ -0,0 +1,191 @@
1
+ import path from "node:path";
2
+ import { z } from "zod";
3
+ import { getProfileDir, getProfileName } from "./profiles.js";
4
+
5
+ /** Префикс всех задач плагина (историческое имя, сохраняется для совместимости). */
6
+ export const TASK_PREFIX = "OpenCode\\windows-scheduler";
7
+
8
+ /** Папка задач плагина в планировщике ОС (Windows). */
9
+ export const TASK_FOLDER = "OpenCode";
10
+ /**
11
+ * Имя папки/блока задач. У нестандартного профиля своё пространство имён,
12
+ * иначе профили делят одну папку Планировщика Windows и один блок crontab.
13
+ * Для default сохраняем историческое имя (совместимость с уже созданными
14
+ * задачами и обновлением плагина).
15
+ */
16
+ export function taskFolderNameForProfile(profile: string = getProfileName()): string {
17
+ return profile === "default" ? "windows-scheduler" : `windows-scheduler-${profile}`;
18
+ }
19
+
20
+ export const TASK_FOLDER_NAME = taskFolderNameForProfile();
21
+
22
+ /**
23
+ * Директория для хранения файлов плагина (обёртки, логи, блокировки, история).
24
+ *
25
+ * Windows: %APPDATA%\opencode\windows-scheduler (как раньше — без миграции).
26
+ * macOS/Linux: $XDG_CONFIG_HOME/opencode/windows-scheduler или
27
+ * ~/.config/opencode/windows-scheduler.
28
+ * Спринт 21: директория зависит от активного профиля (см. src/profiles.ts).
29
+ */
30
+ function resolvePluginDir(): string {
31
+ return getProfileDir(getProfileName());
32
+ }
33
+
34
+ export const PLUGIN_DIR = resolvePluginDir();
35
+
36
+ export const LOCK_DIR = path.join(PLUGIN_DIR, "locks");
37
+ export const LOG_DIR = path.join(PLUGIN_DIR, "logs");
38
+ export const WRAPPER_DIR = path.join(PLUGIN_DIR, "wrappers");
39
+
40
+ /** true, если плагин запущен на Windows. */
41
+ export const IS_WINDOWS = process.platform === "win32";
42
+
43
+ /** Порог возраста lock-файла, после которого он считается зависшим (24 часа). */
44
+ export const STALE_LOCK_MAX_AGE_MS = 24 * 60 * 60 * 1000;
45
+
46
+ /**
47
+ * Приводит имя задачи к безопасному виду для имён файлов (обёртка, промпт, lock, лог).
48
+ * Кириллица транслитерируется, прочие спецсимволы заменяются на дефис.
49
+ * Используется единообразно при создании задачи (index.ts) и при чтении логов (schtasks.ts).
50
+ */
51
+ export function sanitizeName(name: string): string {
52
+ const translit: Record<string, string> = {
53
+ а: "a", б: "b", в: "v", г: "g", д: "d", е: "e", ё: "e",
54
+ ж: "zh", з: "z", и: "i", й: "y", к: "k", л: "l", м: "m",
55
+ н: "n", о: "o", п: "p", р: "r", с: "s", т: "t", у: "u",
56
+ ф: "f", х: "h", ц: "ts", ч: "ch", ш: "sh", щ: "sch",
57
+ ъ: "", ы: "y", ь: "", э: "e", ю: "yu", я: "ya",
58
+ };
59
+
60
+ let result = name.toLowerCase();
61
+ result = result.split("").map((c) => translit[c] || c).join("");
62
+ result = result.replace(/[^a-z0-9_\-]/g, "-");
63
+ result = result.replace(/-+/g, "-").replace(/^-+|-+$/g, "");
64
+ return result || "task";
65
+ }
66
+
67
+ /**
68
+ * Проверяет имя задачи до создания файлов и записи в БД.
69
+ *
70
+ * Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».
71
+ * Спецсимволы оболочки (`& | < > ^ % " ' ; ( ) \``, обратный слэш, слэш)
72
+ * и управляющие символы запрещены: даже при безопасном вызове schtasks
73
+ * такие имена ломают пути файлов и переносимы между платформами.
74
+ *
75
+ * @returns текст ошибки или null, если имя допустимо.
76
+ */
77
+ export function validateTaskName(raw: string): string | null {
78
+ const name = raw.trim();
79
+ if (!name) {
80
+ return "Имя задачи не может быть пустым.";
81
+ }
82
+ if (/[\u0000-\u001f\u007f]/.test(name)) {
83
+ return "Имя задачи не должно содержать управляющие символы.";
84
+ }
85
+ const invalid = name.match(/[^\p{L}\p{N}_\-. ]/u);
86
+ if (invalid) {
87
+ return (
88
+ `Имя задачи содержит недопустимый символ «${invalid[0]}». ` +
89
+ "Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.»."
90
+ );
91
+ }
92
+ // schtasks ограничивает /tn в 237 символов вместе с полным путём задачи.
93
+ // Полный путь: \OpenCode\<TASK_FOLDER_NAME>\<taskName>
94
+ // leading \ + TASK_FOLDER + \ + TASK_FOLDER_NAME + \ — префикс перед именем задачи.
95
+ // Для default: \OpenCode\windows-scheduler\ = 30 символов → 207 на имя.
96
+ // Для не-default профиля: \OpenCode\windows-scheduler-<profile>\ →чем длиннее профиль, тем меньше места.
97
+ const prefixLength = 1 + TASK_FOLDER.length + 1 + TASK_FOLDER_NAME.length + 1;
98
+ const MAX_TASK_NAME_LENGTH = 237 - prefixLength;
99
+ if (name.length > MAX_TASK_NAME_LENGTH) {
100
+ return (
101
+ `Имя задачи "${name}" слишком длинное (${name.length} символов, максимум ${MAX_TASK_NAME_LENGTH} ` +
102
+ `с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).`
103
+ );
104
+ }
105
+ return null;
106
+ }
107
+
108
+ /**
109
+ * Схема аргументов для schedule_job.
110
+ * schedule принимает только 5-полевые cron-выражения.
111
+ */
112
+ export const ScheduleJobArgs = z.object({
113
+ name: z
114
+ .string()
115
+ .min(1)
116
+ .superRefine((value, ctx) => {
117
+ const error = validateTaskName(value);
118
+ if (error) {
119
+ ctx.addIssue({ code: z.ZodIssueCode.custom, message: error });
120
+ }
121
+ })
122
+ .describe("Имя задачи (уникально в рамках префикса OpenCode\\windows-scheduler)"),
123
+ schedule: z
124
+ .string()
125
+ .min(1)
126
+ .describe("5-полевое cron-выражение (минута час день_месяца месяц день_недели)"),
127
+ prompt: z.string().min(1).describe("Промпт, который передаётся в opencode run при запуске задачи"),
128
+ timeoutSeconds: z
129
+ .number()
130
+ .int()
131
+ .positive()
132
+ .optional()
133
+ .default(3600)
134
+ .describe("Таймаут выполнения задачи в секундах (по умолчанию 3600)"),
135
+ workdir: z
136
+ .string()
137
+ .optional()
138
+ .describe("Рабочая директория для выполнения opencode run (по умолчанию текущая)"),
139
+ });
140
+
141
+ export type ScheduleJobArgs = z.infer<typeof ScheduleJobArgs>;
142
+
143
+ export const DeleteJobArgs = z.object({
144
+ name: z.string().min(1).describe("Имя задачи для удаления"),
145
+ });
146
+ export type DeleteJobArgs = z.infer<typeof DeleteJobArgs>;
147
+
148
+ export const RunJobNowArgs = z.object({
149
+ name: z.string().min(1).describe("Имя задачи для немедленного запуска"),
150
+ });
151
+ export type RunJobNowArgs = z.infer<typeof RunJobNowArgs>;
152
+
153
+ export const ListJobsArgs = z.object({});
154
+ export type ListJobsArgs = z.infer<typeof ListJobsArgs>;
155
+
156
+ /**
157
+ * Результат преобразования cron в флаги schtasks.
158
+ */
159
+ export interface CronConversion {
160
+ /** Тип расписания schtasks: MINUTE, DAILY или WEEKLY. */
161
+ sc: "MINUTE" | "HOURLY" | "DAILY" | "WEEKLY";
162
+ /** Дополнительные флаги командной строки (кроме /sc и /tn /tr /f). */
163
+ extraFlags: string[];
164
+ /** Время начала для /st (HH:MM) или undefined. */
165
+ startTime?: string;
166
+ /** Дни недели для /d (при WEEKLY). */
167
+ days?: string;
168
+ /** Интервал в минутах для /mo (при MINUTE). */
169
+ interval?: number;
170
+ }
171
+
172
+ /**
173
+ * Информация о задаче, полученная из schtasks /query.
174
+ */
175
+ export interface ScheduledTaskInfo {
176
+ /** Короткое имя задачи (без папки планировщика). */
177
+ taskName: string;
178
+ folder?: string;
179
+ taskNameToRun?: string;
180
+ nextRunTime?: string;
181
+ status?: string;
182
+ logonMode?: string;
183
+ lastRunTime?: string;
184
+ lastResult?: string;
185
+ author?: string;
186
+ taskToRun?: string;
187
+ comment?: string;
188
+ triggers?: string[];
189
+ /** true — задача поставлена на паузу (disabled). */
190
+ paused?: boolean;
191
+ }
package/src/version.ts ADDED
@@ -0,0 +1,27 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { fileURLToPath } from "node:url";
4
+
5
+ let cached: string | null = null;
6
+
7
+ /**
8
+ * Версия плагина из package.json.
9
+ *
10
+ * Читается в рантайме из корня пакета рядом со скомпилированным модулем
11
+ * (dist/version.js -> ../package.json). Если файл недоступен — «unknown».
12
+ */
13
+ export function getPluginVersion(): string {
14
+ if (cached) return cached;
15
+ try {
16
+ const here = path.dirname(fileURLToPath(import.meta.url));
17
+ const raw = fs.readFileSync(path.join(here, "..", "package.json"), "utf8");
18
+ const pkg = JSON.parse(raw) as { version?: unknown };
19
+ cached =
20
+ typeof pkg.version === "string" && pkg.version.trim()
21
+ ? pkg.version.trim()
22
+ : "unknown";
23
+ } catch {
24
+ cached = "unknown";
25
+ }
26
+ return cached;
27
+ }