agent-steward 0.0.0-stage → 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 (334) hide show
  1. package/CHANGELOG.md +376 -0
  2. package/CROSS_PLATFORM.md +149 -0
  3. package/LICENSE +21 -0
  4. package/README.md +314 -2
  5. package/ROADMAP-STRATEGY.md +147 -0
  6. package/ROADMAP.md +1069 -0
  7. package/dist/core/analytics.d.ts +132 -0
  8. package/dist/core/analytics.d.ts.map +1 -0
  9. package/dist/core/analytics.js +290 -0
  10. package/dist/core/audit.d.ts +96 -0
  11. package/dist/core/audit.d.ts.map +1 -0
  12. package/dist/core/audit.js +297 -0
  13. package/dist/core/cron-to-schtasks.d.ts +20 -0
  14. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  15. package/dist/core/cron-to-schtasks.js +250 -0
  16. package/dist/core/dry-run.d.ts +102 -0
  17. package/dist/core/dry-run.d.ts.map +1 -0
  18. package/dist/core/dry-run.js +447 -0
  19. package/dist/core/file-watcher.d.ts +31 -0
  20. package/dist/core/file-watcher.d.ts.map +1 -0
  21. package/dist/core/file-watcher.js +186 -0
  22. package/dist/core/git-trigger.d.ts +82 -0
  23. package/dist/core/git-trigger.d.ts.map +1 -0
  24. package/dist/core/git-trigger.js +312 -0
  25. package/dist/core/glob.d.ts +38 -0
  26. package/dist/core/glob.d.ts.map +1 -0
  27. package/dist/core/glob.js +233 -0
  28. package/dist/core/local-ai.d.ts +52 -0
  29. package/dist/core/local-ai.d.ts.map +1 -0
  30. package/dist/core/local-ai.js +119 -0
  31. package/dist/core/lock.d.ts +57 -0
  32. package/dist/core/lock.d.ts.map +1 -0
  33. package/dist/core/lock.js +195 -0
  34. package/dist/core/matrix.d.ts +167 -0
  35. package/dist/core/matrix.d.ts.map +1 -0
  36. package/dist/core/matrix.js +724 -0
  37. package/dist/core/native-notify.d.ts +36 -0
  38. package/dist/core/native-notify.d.ts.map +1 -0
  39. package/dist/core/native-notify.js +113 -0
  40. package/dist/core/one-shot.d.ts +68 -0
  41. package/dist/core/one-shot.d.ts.map +1 -0
  42. package/dist/core/one-shot.js +139 -0
  43. package/dist/core/otel.d.ts +4 -0
  44. package/dist/core/otel.d.ts.map +1 -0
  45. package/dist/core/otel.js +98 -0
  46. package/dist/core/permissions.d.ts +69 -0
  47. package/dist/core/permissions.d.ts.map +1 -0
  48. package/dist/core/permissions.js +143 -0
  49. package/dist/core/prometheus.d.ts +23 -0
  50. package/dist/core/prometheus.d.ts.map +1 -0
  51. package/dist/core/prometheus.js +146 -0
  52. package/dist/core/ps-wrapper.d.ts +73 -0
  53. package/dist/core/ps-wrapper.d.ts.map +1 -0
  54. package/dist/core/ps-wrapper.js +1071 -0
  55. package/dist/core/record-history.d.ts +25 -0
  56. package/dist/core/record-history.d.ts.map +1 -0
  57. package/dist/core/record-history.js +471 -0
  58. package/dist/core/retention.d.ts +29 -0
  59. package/dist/core/retention.d.ts.map +1 -0
  60. package/dist/core/retention.js +98 -0
  61. package/dist/core/savings.d.ts +70 -0
  62. package/dist/core/savings.d.ts.map +1 -0
  63. package/dist/core/savings.js +87 -0
  64. package/dist/core/schedule-gate.d.ts +2 -0
  65. package/dist/core/schedule-gate.d.ts.map +1 -0
  66. package/dist/core/schedule-gate.js +211 -0
  67. package/dist/core/schedule-v2.d.ts +116 -0
  68. package/dist/core/schedule-v2.d.ts.map +1 -0
  69. package/dist/core/schedule-v2.js +586 -0
  70. package/dist/core/scheduler/index.d.ts +32 -0
  71. package/dist/core/scheduler/index.d.ts.map +1 -0
  72. package/dist/core/scheduler/index.js +63 -0
  73. package/dist/core/scheduler/linux.d.ts +44 -0
  74. package/dist/core/scheduler/linux.d.ts.map +1 -0
  75. package/dist/core/scheduler/linux.js +225 -0
  76. package/dist/core/scheduler/logs.d.ts +11 -0
  77. package/dist/core/scheduler/logs.d.ts.map +1 -0
  78. package/dist/core/scheduler/logs.js +34 -0
  79. package/dist/core/scheduler/mac.d.ts +40 -0
  80. package/dist/core/scheduler/mac.d.ts.map +1 -0
  81. package/dist/core/scheduler/mac.js +207 -0
  82. package/dist/core/scheduler/posix.d.ts +40 -0
  83. package/dist/core/scheduler/posix.d.ts.map +1 -0
  84. package/dist/core/scheduler/posix.js +89 -0
  85. package/dist/core/scheduler/registry.d.ts +41 -0
  86. package/dist/core/scheduler/registry.d.ts.map +1 -0
  87. package/dist/core/scheduler/registry.js +57 -0
  88. package/dist/core/scheduler/types.d.ts +86 -0
  89. package/dist/core/scheduler/types.d.ts.map +1 -0
  90. package/dist/core/scheduler/types.js +1 -0
  91. package/dist/core/scheduler/windows.d.ts +99 -0
  92. package/dist/core/scheduler/windows.d.ts.map +1 -0
  93. package/dist/core/scheduler/windows.js +596 -0
  94. package/dist/core/secrets.d.ts +66 -0
  95. package/dist/core/secrets.d.ts.map +1 -0
  96. package/dist/core/secrets.js +433 -0
  97. package/dist/core/self-analysis.d.ts +117 -0
  98. package/dist/core/self-analysis.d.ts.map +1 -0
  99. package/dist/core/self-analysis.js +539 -0
  100. package/dist/core/self-analysis.test.d.ts +2 -0
  101. package/dist/core/self-analysis.test.d.ts.map +1 -0
  102. package/dist/core/self-analysis.test.js +219 -0
  103. package/dist/core/session.d.ts +42 -0
  104. package/dist/core/session.d.ts.map +1 -0
  105. package/dist/core/session.js +134 -0
  106. package/dist/core/shutdown.d.ts +26 -0
  107. package/dist/core/shutdown.d.ts.map +1 -0
  108. package/dist/core/shutdown.js +49 -0
  109. package/dist/core/structured-log.d.ts +84 -0
  110. package/dist/core/structured-log.d.ts.map +1 -0
  111. package/dist/core/structured-log.js +146 -0
  112. package/dist/core/summary.d.ts +69 -0
  113. package/dist/core/summary.d.ts.map +1 -0
  114. package/dist/core/summary.js +250 -0
  115. package/dist/core/telegram.d.ts +55 -0
  116. package/dist/core/telegram.d.ts.map +1 -0
  117. package/dist/core/telegram.js +344 -0
  118. package/dist/core/triage-chain.d.ts +40 -0
  119. package/dist/core/triage-chain.d.ts.map +1 -0
  120. package/dist/core/triage-chain.js +80 -0
  121. package/dist/core/triage-compare.d.ts +68 -0
  122. package/dist/core/triage-compare.d.ts.map +1 -0
  123. package/dist/core/triage-compare.js +184 -0
  124. package/dist/core/triage-rules.d.ts +23 -0
  125. package/dist/core/triage-rules.d.ts.map +1 -0
  126. package/dist/core/triage-rules.js +196 -0
  127. package/dist/core/triage-shadow.d.ts +91 -0
  128. package/dist/core/triage-shadow.d.ts.map +1 -0
  129. package/dist/core/triage-shadow.js +160 -0
  130. package/dist/core/triage-worker.d.ts +55 -0
  131. package/dist/core/triage-worker.d.ts.map +1 -0
  132. package/dist/core/triage-worker.js +314 -0
  133. package/dist/core/triage.d.ts +76 -0
  134. package/dist/core/triage.d.ts.map +1 -0
  135. package/dist/core/triage.js +271 -0
  136. package/dist/core/watch-paths.d.ts +6 -0
  137. package/dist/core/watch-paths.d.ts.map +1 -0
  138. package/dist/core/watch-paths.js +62 -0
  139. package/dist/core/wrappers/bash.d.ts +95 -0
  140. package/dist/core/wrappers/bash.d.ts.map +1 -0
  141. package/dist/core/wrappers/bash.js +413 -0
  142. package/dist/db/git-state-repo.d.ts +16 -0
  143. package/dist/db/git-state-repo.d.ts.map +1 -0
  144. package/dist/db/git-state-repo.js +38 -0
  145. package/dist/db/history-repo.d.ts +110 -0
  146. package/dist/db/history-repo.d.ts.map +1 -0
  147. package/dist/db/history-repo.js +300 -0
  148. package/dist/db/index.d.ts +47 -0
  149. package/dist/db/index.d.ts.map +1 -0
  150. package/dist/db/index.js +120 -0
  151. package/dist/db/metrics-repo.d.ts +46 -0
  152. package/dist/db/metrics-repo.d.ts.map +1 -0
  153. package/dist/db/metrics-repo.js +103 -0
  154. package/dist/db/migrate.d.ts +24 -0
  155. package/dist/db/migrate.d.ts.map +1 -0
  156. package/dist/db/migrate.js +244 -0
  157. package/dist/db/recovery.d.ts +11 -0
  158. package/dist/db/recovery.d.ts.map +1 -0
  159. package/dist/db/recovery.js +38 -0
  160. package/dist/db/schema.d.ts +24 -0
  161. package/dist/db/schema.d.ts.map +1 -0
  162. package/dist/db/schema.js +170 -0
  163. package/dist/db/settings-repo.d.ts +8 -0
  164. package/dist/db/settings-repo.d.ts.map +1 -0
  165. package/dist/db/settings-repo.js +27 -0
  166. package/dist/db/tasks-repo.d.ts +26 -0
  167. package/dist/db/tasks-repo.d.ts.map +1 -0
  168. package/dist/db/tasks-repo.js +120 -0
  169. package/dist/db/templates-repo.d.ts +17 -0
  170. package/dist/db/templates-repo.d.ts.map +1 -0
  171. package/dist/db/templates-repo.js +57 -0
  172. package/dist/gui-experimental.cjs +1 -0
  173. package/dist/history.d.ts +60 -0
  174. package/dist/history.d.ts.map +1 -0
  175. package/dist/history.js +70 -0
  176. package/dist/i18n.d.ts +75 -0
  177. package/dist/i18n.d.ts.map +1 -0
  178. package/dist/i18n.js +357 -0
  179. package/dist/index.d.ts +858 -0
  180. package/dist/index.d.ts.map +1 -0
  181. package/dist/index.js +5179 -0
  182. package/dist/integrations.d.ts +72 -0
  183. package/dist/integrations.d.ts.map +1 -0
  184. package/dist/integrations.js +233 -0
  185. package/dist/notifications.d.ts +199 -0
  186. package/dist/notifications.d.ts.map +1 -0
  187. package/dist/notifications.js +967 -0
  188. package/dist/profiles.d.ts +60 -0
  189. package/dist/profiles.d.ts.map +1 -0
  190. package/dist/profiles.js +227 -0
  191. package/dist/rpc.d.ts +3806 -0
  192. package/dist/rpc.d.ts.map +1 -0
  193. package/dist/rpc.js +1507 -0
  194. package/dist/schtasks.d.ts +32 -0
  195. package/dist/schtasks.d.ts.map +1 -0
  196. package/dist/schtasks.js +45 -0
  197. package/dist/server.d.ts +128 -0
  198. package/dist/server.d.ts.map +1 -0
  199. package/dist/server.js +2413 -0
  200. package/dist/settings.d.ts +389 -0
  201. package/dist/settings.d.ts.map +1 -0
  202. package/dist/settings.js +770 -0
  203. package/dist/shared/jobs-view.d.ts +59 -0
  204. package/dist/shared/jobs-view.d.ts.map +1 -0
  205. package/dist/shared/jobs-view.js +146 -0
  206. package/dist/skill.d.ts +15 -0
  207. package/dist/skill.d.ts.map +1 -0
  208. package/dist/skill.js +93 -0
  209. package/dist/task-transfer.d.ts +252 -0
  210. package/dist/task-transfer.d.ts.map +1 -0
  211. package/dist/task-transfer.js +628 -0
  212. package/dist/templates.d.ts +57 -0
  213. package/dist/templates.d.ts.map +1 -0
  214. package/dist/templates.js +16 -0
  215. package/dist/types.d.ts +96 -0
  216. package/dist/types.d.ts.map +1 -0
  217. package/dist/types.js +130 -0
  218. package/dist/version.d.ts +8 -0
  219. package/dist/version.d.ts.map +1 -0
  220. package/dist/version.js +27 -0
  221. package/dist/workspaces.d.ts +113 -0
  222. package/dist/workspaces.d.ts.map +1 -0
  223. package/dist/workspaces.js +393 -0
  224. package/docs/ARCHITECTURE.md +457 -0
  225. package/docs/COMPATIBILITY.md +233 -0
  226. package/docs/CONCEPT.md +230 -0
  227. package/docs/CROSS_PLATFORM.ru.md +150 -0
  228. package/docs/CROSS_PLATFORM.zh.md +146 -0
  229. package/docs/FAQ.md +52 -0
  230. package/docs/FAQ.ru.md +53 -0
  231. package/docs/FAQ.zh.md +43 -0
  232. package/docs/FEATURES.md +698 -0
  233. package/docs/FEATURES.zh.md +655 -0
  234. package/docs/LOCAL-AI.md +300 -0
  235. package/docs/MIGRATION.md +355 -0
  236. package/docs/README.ru.md +268 -0
  237. package/docs/README.zh.md +305 -0
  238. package/docs/SAVINGS.md +61 -0
  239. package/docs/SAVINGS.ru.md +60 -0
  240. package/docs/SAVINGS.zh.md +52 -0
  241. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  242. package/docs/ZH-LOCALE-PLAN.md +324 -0
  243. package/docs/dashboard.png +0 -0
  244. package/docs/spikes/local-model-structured-output.md +81 -0
  245. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  246. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  247. package/gui-experimental.cjs +9 -0
  248. package/index.js +1 -0
  249. package/locales/en.json +780 -0
  250. package/locales/ru.json +780 -0
  251. package/locales/zh.json +780 -0
  252. package/package.json +149 -4
  253. package/scripts/bench-local.mjs +321 -0
  254. package/scripts/check-zh-locale.mjs +218 -0
  255. package/scripts/demo-dashboard.mjs +209 -0
  256. package/scripts/run-tests.mjs +236 -0
  257. package/scripts/spike-local-structured.mjs +182 -0
  258. package/scripts/test-locale.mjs +45 -0
  259. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  260. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  261. package/src/core/analytics.ts +424 -0
  262. package/src/core/audit.ts +418 -0
  263. package/src/core/cron-to-schtasks.ts +288 -0
  264. package/src/core/dry-run.ts +601 -0
  265. package/src/core/file-watcher.ts +245 -0
  266. package/src/core/git-trigger.ts +391 -0
  267. package/src/core/glob.ts +226 -0
  268. package/src/core/local-ai.ts +173 -0
  269. package/src/core/lock.ts +219 -0
  270. package/src/core/matrix.ts +947 -0
  271. package/src/core/native-notify.ts +157 -0
  272. package/src/core/one-shot.ts +189 -0
  273. package/src/core/otel.ts +128 -0
  274. package/src/core/permissions.ts +200 -0
  275. package/src/core/prometheus.ts +215 -0
  276. package/src/core/ps-wrapper.ts +1140 -0
  277. package/src/core/record-history.ts +615 -0
  278. package/src/core/retention.ts +141 -0
  279. package/src/core/savings.ts +150 -0
  280. package/src/core/schedule-gate.ts +253 -0
  281. package/src/core/schedule-v2.ts +668 -0
  282. package/src/core/scheduler/index.ts +82 -0
  283. package/src/core/scheduler/linux.ts +257 -0
  284. package/src/core/scheduler/logs.ts +37 -0
  285. package/src/core/scheduler/mac.ts +270 -0
  286. package/src/core/scheduler/posix.ts +114 -0
  287. package/src/core/scheduler/registry.ts +99 -0
  288. package/src/core/scheduler/types.ts +90 -0
  289. package/src/core/scheduler/windows.ts +711 -0
  290. package/src/core/secrets.ts +503 -0
  291. package/src/core/self-analysis.ts +744 -0
  292. package/src/core/session.ts +150 -0
  293. package/src/core/shutdown.ts +69 -0
  294. package/src/core/structured-log.ts +214 -0
  295. package/src/core/summary.ts +318 -0
  296. package/src/core/telegram.ts +436 -0
  297. package/src/core/triage-chain.ts +125 -0
  298. package/src/core/triage-compare.ts +277 -0
  299. package/src/core/triage-rules.ts +238 -0
  300. package/src/core/triage-shadow.ts +240 -0
  301. package/src/core/triage-worker.ts +344 -0
  302. package/src/core/triage.ts +366 -0
  303. package/src/core/watch-paths.ts +70 -0
  304. package/src/core/wrappers/bash.ts +532 -0
  305. package/src/db/git-state-repo.ts +62 -0
  306. package/src/db/history-repo.ts +492 -0
  307. package/src/db/index.ts +166 -0
  308. package/src/db/metrics-repo.ts +170 -0
  309. package/src/db/migrate.ts +328 -0
  310. package/src/db/recovery.ts +46 -0
  311. package/src/db/schema.ts +188 -0
  312. package/src/db/settings-repo.ts +31 -0
  313. package/src/db/tasks-repo.ts +162 -0
  314. package/src/db/templates-repo.ts +77 -0
  315. package/src/gui.tsx +5222 -0
  316. package/src/history.ts +128 -0
  317. package/src/i18n.ts +413 -0
  318. package/src/index.ts +6605 -0
  319. package/src/integrations.ts +297 -0
  320. package/src/notifications.ts +1346 -0
  321. package/src/profiles.ts +254 -0
  322. package/src/rpc.ts +1609 -0
  323. package/src/schtasks.ts +75 -0
  324. package/src/server.ts +2662 -0
  325. package/src/settings.ts +1369 -0
  326. package/src/shared/jobs-view.ts +188 -0
  327. package/src/skill.ts +113 -0
  328. package/src/task-transfer.ts +944 -0
  329. package/src/templates.ts +67 -0
  330. package/src/tui-v1.tsx +341 -0
  331. package/src/tui.tsx +329 -0
  332. package/src/types.ts +191 -0
  333. package/src/version.ts +27 -0
  334. package/src/workspaces.ts +487 -0
@@ -0,0 +1,188 @@
1
+ import { getSchedulerBackend } from "../core/scheduler/index.js"
2
+ import { latestHistoryByTask, loadHistory, type HistoryRecord } from "../history.js"
3
+ import {
4
+ loadTaskDefinitions,
5
+ type TaskDefinition,
6
+ } from "../task-transfer.js"
7
+ import type { ScheduledTaskInfo } from "../types.js"
8
+
9
+ export type JobStatus = "running" | "success" | "error" | "partial" | "idle" | "unknown"
10
+
11
+ export interface JobView {
12
+ name: string
13
+ status: JobStatus
14
+ /** Задача поставлена на паузу в планировщике ОС. */
15
+ paused?: boolean
16
+ nextRun?: string
17
+ lastRun?: string
18
+ /** Для клона матрицы — имя родительской задачи. */
19
+ matrixParentId?: string
20
+ /** true — задача является родителем матрицы (шаблоном fan-out). */
21
+ isMatrixParent?: boolean
22
+ }
23
+
24
+ /** Строка панели: задача и её отступ в дереве матрицы. */
25
+ export interface JobDisplayRow {
26
+ job: JobView
27
+ /** 0 — корневая задача, 1 — клон матрицы. */
28
+ depth: number
29
+ }
30
+
31
+ /**
32
+ * Упорядочивает задачи для TUI: родитель матрицы идёт первым, сразу за ним —
33
+ * его клоны с отступом. Клоны без родителя (осиротевшие) остаются корневыми,
34
+ * чтобы задача не исчезла из панели.
35
+ */
36
+ export function groupJobsForDisplay(jobs: readonly JobView[]): JobDisplayRow[] {
37
+ const byName = new Map<string, JobView[]>()
38
+ for (const job of jobs) {
39
+ const key = job.name.toLowerCase()
40
+ const list = byName.get(key) ?? []
41
+ list.push(job)
42
+ byName.set(key, list)
43
+ }
44
+
45
+ const children = new Map<string, JobView[]>()
46
+ const roots: JobView[] = []
47
+ for (const job of jobs) {
48
+ const parent = job.matrixParentId?.trim().toLowerCase()
49
+ if (parent && byName.has(parent) && parent !== job.name.toLowerCase()) {
50
+ const list = children.get(parent) ?? []
51
+ list.push(job)
52
+ children.set(parent, list)
53
+ } else {
54
+ roots.push(job)
55
+ }
56
+ }
57
+
58
+ const byNameAsc = (a: JobView, b: JobView) => a.name.localeCompare(b.name)
59
+ roots.sort(byNameAsc)
60
+ for (const list of children.values()) list.sort(byNameAsc)
61
+
62
+ const rows: JobDisplayRow[] = []
63
+ for (const root of roots) {
64
+ rows.push({ job: root, depth: 0 })
65
+ for (const child of children.get(root.name.toLowerCase()) ?? []) {
66
+ rows.push({ job: child, depth: 1 })
67
+ }
68
+ }
69
+ return rows
70
+ }
71
+
72
+ /**
73
+ * Перемещает выбор по строкам панели с зацикливанием.
74
+ * Возвращает имя задачи, которое нужно выделить, либо undefined для пустого списка.
75
+ */
76
+ export function nextJobSelection(
77
+ rows: readonly JobDisplayRow[],
78
+ currentName: string | undefined,
79
+ delta: number
80
+ ): string | undefined {
81
+ if (rows.length === 0) return undefined
82
+ const current = currentName?.trim().toLowerCase()
83
+ let index = rows.findIndex((row) => row.job.name.toLowerCase() === current)
84
+ if (index === -1) index = delta > 0 ? -1 : 0
85
+ const step = delta === 0 ? 1 : delta
86
+ index = ((index + step) % rows.length + rows.length) % rows.length
87
+ return rows[index]?.job.name
88
+ }
89
+
90
+ /**
91
+ * Готовит текст лога для диалога TUI: оставляет последние строки и
92
+ * подставляет пояснение, если лога ещё нет.
93
+ */
94
+ export function formatJobLog(
95
+ logs: string | undefined,
96
+ error: string | undefined,
97
+ maxLines = 40
98
+ ): string {
99
+ const source = logs?.trim() ? logs : error?.trim()
100
+ if (!source) return "Лог пуст."
101
+ const limit = Math.max(1, Math.min(Math.floor(maxLines), 200))
102
+ const lines = source.replace(/\r\n/g, "\n").split("\n")
103
+ return lines.slice(-limit).join("\n")
104
+ }
105
+
106
+ /**
107
+ * Возвращает символ статуса задачи для отображения в панелях TUI и GUI.
108
+ * Общая логика для обоих рантаймов.
109
+ */
110
+ export function statusIcon(status: JobStatus): string {
111
+ switch (status) {
112
+ case "running":
113
+ return "●"
114
+ case "error":
115
+ return "✗"
116
+ case "success":
117
+ return "✓"
118
+ case "partial":
119
+ return "◐"
120
+ case "idle":
121
+ // Задача создана, но ещё ни разу не запускалась.
122
+ return "○"
123
+ default:
124
+ return "?"
125
+ }
126
+ }
127
+
128
+ /** Переводит запись истории в статус панели (timeout считаем ошибкой). */
129
+ function historyStatus(record: HistoryRecord | undefined): JobStatus {
130
+ if (!record) return "idle"
131
+ if (record.status === "timeout") return "error"
132
+ return record.status
133
+ }
134
+
135
+ /**
136
+ * Собирает панельное представление из уже прочитанных данных.
137
+ * Вынесено отдельно, чтобы логику статусов и матричных связей можно было
138
+ * проверить без реального планировщика.
139
+ */
140
+ export function buildJobsView(
141
+ tasks: readonly ScheduledTaskInfo[],
142
+ history: readonly HistoryRecord[],
143
+ definitions: readonly TaskDefinition[]
144
+ ): JobView[] {
145
+ const latest = latestHistoryByTask(history)
146
+ const defs = new Map(
147
+ definitions.map((definition) => [definition.name.toLowerCase(), definition])
148
+ )
149
+ return tasks.map((task) => {
150
+ const name = task.taskName
151
+ const record = latest.get(name.toLowerCase())
152
+ const definition = defs.get(name.toLowerCase())
153
+ const matrixParentId = definition?.matrixParentId?.trim()
154
+ return {
155
+ name,
156
+ status: historyStatus(record),
157
+ paused: Boolean(task.paused),
158
+ nextRun: task.nextRunTime,
159
+ lastRun: task.lastRunTime,
160
+ ...(matrixParentId ? { matrixParentId } : {}),
161
+ ...(definition?.matrix || definition?.isMatrixParent
162
+ ? { isMatrixParent: true }
163
+ : {}),
164
+ }
165
+ })
166
+ }
167
+
168
+ /**
169
+ * Возвращает список задач планировщика в едином формате для TUI и GUI.
170
+ *
171
+ * Читает реальные задачи из бэкенда планировщика и последнюю запись истории
172
+ * по каждой задаче. Если бэкенд недоступен (например, нет прав на schtasks),
173
+ * возвращает пустой список — панель покажет честное «нет данных», а не
174
+ * выдуманные задачи.
175
+ */
176
+ export async function getJobsView(_context: unknown): Promise<JobView[]> {
177
+ try {
178
+ const backend = getSchedulerBackend()
179
+ const [tasks, history, definitions] = await Promise.all([
180
+ backend.listTasks(),
181
+ loadHistory(),
182
+ loadTaskDefinitions(),
183
+ ])
184
+ return buildJobsView(tasks, history, definitions)
185
+ } catch {
186
+ return []
187
+ }
188
+ }
package/src/skill.ts ADDED
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Скилл плагина: `scheduled-job-best-practices`.
3
+ *
4
+ * Скилл — это markdown-инструкция, которую OpenCode показывает агенту и подгружает
5
+ * по требованию через инструмент `skill`. Мы не полагаемся на ручную установку в
6
+ * `.opencode/skills`: плагин сам регистрирует скилл в контексте сессии, поэтому он
7
+ * доступен сразу после `opencode plugin add opencode-windows-scheduler`.
8
+ *
9
+ * Источник правды — каталог `skills/scheduled-job-best-practices` в пакете:
10
+ * - `SKILL.md` — тело инструкции;
11
+ * - `references/recipes.md` — готовые примеры, которые агент читает по ссылке.
12
+ * Это даёт агенту базовую директорию с вспомогательными файлами.
13
+ */
14
+ import fs from "node:fs";
15
+ import path from "node:path";
16
+ import { fileURLToPath } from "node:url";
17
+
18
+ export const SCHEDULER_SKILL_ID = "scheduled-job-best-practices";
19
+ export const SCHEDULER_SKILL_NAME = "Scheduled Job Best Practices";
20
+
21
+ const FALLBACK_DESCRIPTION =
22
+ "Use when the user wants recurring or event-driven automation (cron, file changes, MCP events), multi-repository fan-out, or agent pipelines. Covers safe defaults, prompt design, Quality Gates, matrix builds, DAG dependencies and post-incident diagnosis with the scheduler tools.";
23
+
24
+ const FALLBACK_CONTENT = [
25
+ "# Scheduled Job Best Practices",
26
+ "",
27
+ "Use `list_tasks` before creating anything and prefer `update_task` over delete + create.",
28
+ "Write self-contained prompts (goal, scope, constraints, verification, output).",
29
+ "Always set `timeoutSeconds`, set `qualityGate` when success is machine-checkable, and",
30
+ "limit tools with `allowedTools`/`deniedTools`. Validate with `dry_run`, then `run_task_now`,",
31
+ "then inspect `get_history` and `get_task_logs`. For multi-repository work use `matrix` with",
32
+ "a small `concurrency`; a matrix parent never runs itself and dependencies wait for all clones.",
33
+ ].join("\n");
34
+
35
+ export interface SchedulerSkill {
36
+ id: string;
37
+ name: string;
38
+ description: string;
39
+ path: string;
40
+ content: string;
41
+ }
42
+
43
+ /** Корень пакета: `dist/skill.js` → `..`, `src/skill.ts` → `..`. */
44
+ function packageRoot(): string {
45
+ return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
46
+ }
47
+
48
+ /**
49
+ * Разбирает YAML-frontmatter простого вида (`key: value`).
50
+ * Полноценный YAML не нужен: поддерживаем ровно те поля, которые пишем сами.
51
+ */
52
+ function parseFrontmatter(raw: string): {
53
+ meta: Record<string, string>;
54
+ body: string;
55
+ } {
56
+ const normalized = raw.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n");
57
+ if (!normalized.startsWith("---\n")) {
58
+ return { meta: {}, body: normalized };
59
+ }
60
+ const end = normalized.indexOf("\n---", 4);
61
+ if (end === -1) return { meta: {}, body: normalized };
62
+
63
+ const header = normalized.slice(4, end);
64
+ const body = normalized.slice(end + 4).replace(/^\n+/, "");
65
+ const meta: Record<string, string> = {};
66
+
67
+ for (const line of header.split("\n")) {
68
+ const match = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line.trim());
69
+ if (!match) continue;
70
+ const value = match[2].trim().replace(/^["']|["']$/g, "");
71
+ if (value) meta[match[1]] = value;
72
+ }
73
+
74
+ return { meta, body };
75
+ }
76
+
77
+ /**
78
+ * Загружает скилл из пакета. Возвращает `undefined`, если файл недоступен —
79
+ * плагин в этом случае просто не регистрирует скилл и продолжает работать.
80
+ */
81
+ export function loadSchedulerSkill(): SchedulerSkill | undefined {
82
+ const skillPath = path.join(packageRoot(), "skills", SCHEDULER_SKILL_ID, "SKILL.md");
83
+
84
+ let raw: string;
85
+ try {
86
+ raw = fs.readFileSync(skillPath, "utf8");
87
+ } catch {
88
+ if (process.env.OPENCODE_SCHEDULER_DEBUG_SKILL) {
89
+ console.error(`[windows-scheduler] Скилл не найден: ${skillPath}`);
90
+ }
91
+ return undefined;
92
+ }
93
+
94
+ const { meta, body } = parseFrontmatter(raw);
95
+ const content = body.trim();
96
+ if (!content) {
97
+ return {
98
+ id: SCHEDULER_SKILL_ID,
99
+ name: meta.name || SCHEDULER_SKILL_NAME,
100
+ description: meta.description || FALLBACK_DESCRIPTION,
101
+ path: skillPath,
102
+ content: FALLBACK_CONTENT,
103
+ };
104
+ }
105
+
106
+ return {
107
+ id: SCHEDULER_SKILL_ID,
108
+ name: meta.name || SCHEDULER_SKILL_NAME,
109
+ description: meta.description || FALLBACK_DESCRIPTION,
110
+ path: skillPath,
111
+ content,
112
+ };
113
+ }