agent-steward 0.0.2 → 0.0.4

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 (263) hide show
  1. package/CHANGELOG.md +45 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +11 -10
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +148 -1017
  6. package/dist/core/cron-to-schtasks.d.ts +0 -8
  7. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  8. package/dist/core/cron-to-schtasks.js +11 -86
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +19 -2
  14. package/dist/core/file-watcher.js +9 -9
  15. package/dist/core/git-trigger.js +4 -4
  16. package/dist/core/lock.d.ts +20 -4
  17. package/dist/core/lock.d.ts.map +1 -1
  18. package/dist/core/lock.js +99 -26
  19. package/dist/core/one-shot.d.ts +31 -5
  20. package/dist/core/one-shot.d.ts.map +1 -1
  21. package/dist/core/one-shot.js +78 -10
  22. package/dist/core/opencode-cli.d.ts +28 -0
  23. package/dist/core/opencode-cli.d.ts.map +1 -0
  24. package/dist/core/opencode-cli.js +74 -0
  25. package/dist/core/opencode-models.d.ts +62 -0
  26. package/dist/core/opencode-models.d.ts.map +1 -0
  27. package/dist/core/opencode-models.js +277 -0
  28. package/dist/core/otel.js +2 -2
  29. package/dist/core/ps-wrapper.d.ts +1 -1
  30. package/dist/core/ps-wrapper.d.ts.map +1 -1
  31. package/dist/core/ps-wrapper.js +66 -36
  32. package/dist/core/record-history.d.ts +15 -0
  33. package/dist/core/record-history.d.ts.map +1 -1
  34. package/dist/core/record-history.js +78 -54
  35. package/dist/core/router/dispatch.d.ts +36 -0
  36. package/dist/core/router/dispatch.d.ts.map +1 -0
  37. package/dist/core/router/dispatch.js +59 -0
  38. package/dist/core/router/escalation.d.ts +47 -0
  39. package/dist/core/router/escalation.d.ts.map +1 -0
  40. package/dist/core/router/escalation.js +87 -0
  41. package/dist/core/router/planner.d.ts +53 -0
  42. package/dist/core/router/planner.d.ts.map +1 -0
  43. package/dist/core/router/planner.js +113 -0
  44. package/dist/core/router/rules.d.ts +46 -0
  45. package/dist/core/router/rules.d.ts.map +1 -0
  46. package/dist/core/router/rules.js +85 -0
  47. package/dist/core/run-panel-api.d.ts +94 -0
  48. package/dist/core/run-panel-api.d.ts.map +1 -0
  49. package/dist/core/run-panel-api.js +169 -0
  50. package/dist/core/schedule-gate.js +5 -1
  51. package/dist/core/schedule-v2.d.ts +36 -2
  52. package/dist/core/schedule-v2.d.ts.map +1 -1
  53. package/dist/core/schedule-v2.js +98 -12
  54. package/dist/core/scheduler/at-fallback.d.ts +95 -0
  55. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  56. package/dist/core/scheduler/at-fallback.js +200 -0
  57. package/dist/core/scheduler/linux.d.ts +13 -2
  58. package/dist/core/scheduler/linux.d.ts.map +1 -1
  59. package/dist/core/scheduler/linux.js +67 -13
  60. package/dist/core/scheduler/mac.d.ts +14 -8
  61. package/dist/core/scheduler/mac.d.ts.map +1 -1
  62. package/dist/core/scheduler/mac.js +71 -22
  63. package/dist/core/scheduler/posix.d.ts.map +1 -1
  64. package/dist/core/scheduler/posix.js +37 -2
  65. package/dist/core/scheduler/registry.d.ts +13 -0
  66. package/dist/core/scheduler/registry.d.ts.map +1 -1
  67. package/dist/core/scheduler/registry.js +83 -21
  68. package/dist/core/scheduler/run-now.d.ts +16 -0
  69. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  70. package/dist/core/scheduler/run-now.js +28 -0
  71. package/dist/core/scheduler/windows.d.ts +16 -3
  72. package/dist/core/scheduler/windows.d.ts.map +1 -1
  73. package/dist/core/scheduler/windows.js +249 -96
  74. package/dist/core/secrets.d.ts.map +1 -1
  75. package/dist/core/secrets.js +127 -30
  76. package/dist/core/self-analysis.js +55 -55
  77. package/dist/core/session.d.ts.map +1 -1
  78. package/dist/core/session.js +18 -11
  79. package/dist/core/summary.js +1 -1
  80. package/dist/core/task-name.d.ts +24 -0
  81. package/dist/core/task-name.d.ts.map +1 -0
  82. package/dist/core/task-name.js +40 -0
  83. package/dist/core/triage-chain.js +1 -1
  84. package/dist/core/triage-worker.js +2 -2
  85. package/dist/core/triage.js +1 -1
  86. package/dist/core/wrappers/bash.d.ts.map +1 -1
  87. package/dist/core/wrappers/bash.js +82 -37
  88. package/dist/db/capability-repo.d.ts +83 -0
  89. package/dist/db/capability-repo.d.ts.map +1 -0
  90. package/dist/db/capability-repo.js +182 -0
  91. package/dist/db/history-repo.d.ts +8 -0
  92. package/dist/db/history-repo.d.ts.map +1 -1
  93. package/dist/db/history-repo.js +19 -0
  94. package/dist/db/index.d.ts +6 -0
  95. package/dist/db/index.d.ts.map +1 -1
  96. package/dist/db/index.js +48 -2
  97. package/dist/db/migrate.d.ts.map +1 -1
  98. package/dist/db/migrate.js +3 -1
  99. package/dist/db/run-context.d.ts +103 -0
  100. package/dist/db/run-context.d.ts.map +1 -0
  101. package/dist/db/run-context.js +224 -0
  102. package/dist/db/run-dlq.d.ts +100 -0
  103. package/dist/db/run-dlq.d.ts.map +1 -0
  104. package/dist/db/run-dlq.js +191 -0
  105. package/dist/db/run-journal.d.ts +60 -0
  106. package/dist/db/run-journal.d.ts.map +1 -0
  107. package/dist/db/run-journal.js +143 -0
  108. package/dist/db/run-resume.d.ts +51 -0
  109. package/dist/db/run-resume.d.ts.map +1 -0
  110. package/dist/db/run-resume.js +156 -0
  111. package/dist/db/runs-repo.d.ts +128 -0
  112. package/dist/db/runs-repo.d.ts.map +1 -0
  113. package/dist/db/runs-repo.js +342 -0
  114. package/dist/db/schema.d.ts +16 -2
  115. package/dist/db/schema.d.ts.map +1 -1
  116. package/dist/db/schema.js +342 -35
  117. package/dist/db/settings-repo.d.ts +11 -0
  118. package/dist/db/settings-repo.d.ts.map +1 -1
  119. package/dist/db/settings-repo.js +25 -0
  120. package/dist/db/step-idempotency.d.ts +51 -0
  121. package/dist/db/step-idempotency.d.ts.map +1 -0
  122. package/dist/db/step-idempotency.js +136 -0
  123. package/dist/index.d.ts +5 -5
  124. package/dist/index.d.ts.map +1 -1
  125. package/dist/index.js +168 -40
  126. package/dist/notifications.js +18 -18
  127. package/dist/profiles.d.ts +7 -3
  128. package/dist/profiles.d.ts.map +1 -1
  129. package/dist/profiles.js +85 -7
  130. package/dist/rpc.d.ts +787 -0
  131. package/dist/rpc.d.ts.map +1 -1
  132. package/dist/rpc.js +324 -0
  133. package/dist/server.d.ts +33 -2
  134. package/dist/server.d.ts.map +1 -1
  135. package/dist/server.js +115 -54
  136. package/dist/shared/jobs-view.d.ts.map +1 -1
  137. package/dist/skill.js +1 -1
  138. package/dist/task-transfer.d.ts +1 -1
  139. package/dist/task-transfer.d.ts.map +1 -1
  140. package/dist/task-transfer.js +14 -10
  141. package/dist/types.d.ts +20 -4
  142. package/dist/types.d.ts.map +1 -1
  143. package/dist/types.js +44 -9
  144. package/dist/workspaces.d.ts +25 -3
  145. package/dist/workspaces.d.ts.map +1 -1
  146. package/dist/workspaces.js +44 -9
  147. package/docs/ARCHITECTURE.md +335 -9
  148. package/docs/COMPATIBILITY.md +10 -6
  149. package/docs/CONCEPT.md +183 -91
  150. package/docs/CROSS_PLATFORM.ru.md +11 -9
  151. package/docs/CROSS_PLATFORM.zh.md +11 -9
  152. package/docs/EXECUTION-LOOP.md +196 -0
  153. package/docs/FAQ.md +2 -2
  154. package/docs/FAQ.ru.md +2 -2
  155. package/docs/FAQ.zh.md +2 -2
  156. package/docs/FEATURES.md +5 -4
  157. package/docs/FEATURES.zh.md +5 -4
  158. package/docs/MIGRATION.md +34 -26
  159. package/docs/README.ru.md +27 -8
  160. package/docs/README.zh.md +11 -10
  161. package/docs/SAFETY.md +122 -0
  162. package/docs/SAVINGS.md +29 -0
  163. package/docs/SAVINGS.ru.md +29 -0
  164. package/docs/SAVINGS.zh.md +18 -0
  165. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  166. package/gui-experimental.cjs +8 -8
  167. package/index.js +1 -0
  168. package/locales/en.json +68 -0
  169. package/locales/ru.json +68 -0
  170. package/locales/zh.json +68 -0
  171. package/package.json +57 -11
  172. package/scripts/audit-bundle.mjs +215 -0
  173. package/src/core/analytics.ts +2 -2
  174. package/src/core/audit.ts +17 -17
  175. package/src/core/cron-to-schtasks.ts +14 -93
  176. package/src/core/dlq-api.ts +98 -0
  177. package/src/core/dry-run.ts +51 -27
  178. package/src/core/file-watcher.ts +17 -17
  179. package/src/core/git-trigger.ts +9 -9
  180. package/src/core/glob.ts +1 -1
  181. package/src/core/local-ai.ts +2 -2
  182. package/src/core/lock.ts +104 -31
  183. package/src/core/matrix.ts +31 -31
  184. package/src/core/native-notify.ts +2 -2
  185. package/src/core/one-shot.ts +91 -13
  186. package/src/core/opencode-cli.ts +103 -0
  187. package/src/core/opencode-models.ts +315 -0
  188. package/src/core/otel.ts +4 -4
  189. package/src/core/permissions.ts +5 -5
  190. package/src/core/prometheus.ts +17 -17
  191. package/src/core/ps-wrapper.ts +68 -38
  192. package/src/core/record-history.ts +114 -76
  193. package/src/core/retention.ts +3 -3
  194. package/src/core/router/dispatch.ts +94 -0
  195. package/src/core/router/escalation.ts +129 -0
  196. package/src/core/router/planner.ts +166 -0
  197. package/src/core/router/rules.ts +109 -0
  198. package/src/core/run-panel-api.ts +262 -0
  199. package/src/core/savings.ts +1 -1
  200. package/src/core/schedule-gate.ts +17 -13
  201. package/src/core/schedule-v2.ts +138 -29
  202. package/src/core/scheduler/at-fallback.ts +298 -0
  203. package/src/core/scheduler/index.ts +3 -3
  204. package/src/core/scheduler/linux.ts +92 -19
  205. package/src/core/scheduler/logs.ts +1 -1
  206. package/src/core/scheduler/mac.ts +112 -60
  207. package/src/core/scheduler/posix.ts +35 -2
  208. package/src/core/scheduler/registry.ts +109 -26
  209. package/src/core/scheduler/run-now.ts +32 -0
  210. package/src/core/scheduler/windows.ts +295 -125
  211. package/src/core/secrets.ts +139 -39
  212. package/src/core/self-analysis.ts +61 -61
  213. package/src/core/session.ts +26 -13
  214. package/src/core/structured-log.ts +3 -3
  215. package/src/core/summary.ts +25 -25
  216. package/src/core/task-name.ts +67 -0
  217. package/src/core/telegram.ts +16 -16
  218. package/src/core/triage-chain.ts +4 -4
  219. package/src/core/triage-compare.ts +8 -8
  220. package/src/core/triage-rules.ts +4 -4
  221. package/src/core/triage-shadow.ts +7 -7
  222. package/src/core/triage-worker.ts +6 -6
  223. package/src/core/triage.ts +23 -23
  224. package/src/core/watch-paths.ts +1 -1
  225. package/src/core/wrappers/bash.ts +90 -45
  226. package/src/db/capability-repo.ts +285 -0
  227. package/src/db/git-state-repo.ts +1 -1
  228. package/src/db/history-repo.ts +44 -22
  229. package/src/db/index.ts +53 -7
  230. package/src/db/metrics-repo.ts +10 -10
  231. package/src/db/migrate.ts +13 -11
  232. package/src/db/recovery.ts +3 -3
  233. package/src/db/run-context.ts +370 -0
  234. package/src/db/run-dlq.ts +310 -0
  235. package/src/db/run-journal.ts +212 -0
  236. package/src/db/run-resume.ts +256 -0
  237. package/src/db/runs-repo.ts +504 -0
  238. package/src/db/schema.ts +357 -44
  239. package/src/db/settings-repo.ts +33 -2
  240. package/src/db/step-idempotency.ts +185 -0
  241. package/src/db/tasks-repo.ts +10 -10
  242. package/src/db/templates-repo.ts +7 -7
  243. package/src/gui.tsx +516 -1
  244. package/src/history.ts +4 -4
  245. package/src/i18n.ts +7 -7
  246. package/src/index.ts +465 -308
  247. package/src/integrations.ts +6 -6
  248. package/src/notifications.ts +76 -76
  249. package/src/profiles.ts +98 -7
  250. package/src/rpc.ts +347 -1
  251. package/src/schtasks.ts +2 -2
  252. package/src/server.ts +155 -78
  253. package/src/settings.ts +44 -44
  254. package/src/shared/jobs-view.ts +60 -60
  255. package/src/skill.ts +1 -1
  256. package/src/task-transfer.ts +58 -56
  257. package/src/templates.ts +1 -1
  258. package/src/types.ts +54 -10
  259. package/src/workspaces.ts +73 -24
  260. package/dist/core/self-analysis.test.d.ts +0 -2
  261. package/dist/core/self-analysis.test.d.ts.map +0 -1
  262. package/dist/core/self-analysis.test.js +0 -219
  263. package/dist/gui-experimental.cjs +0 -1
package/docs/CONCEPT.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # CONCEPT — Верифицируемая локально-первая оркестрация агент-задач
2
2
 
3
- > Статус: черновик цели (north star). Рабочее имя пакета — TBD (см. шаг rename).
4
- > Это документ-направление: любое решение по фиче сверяется с ним.
3
+ > Статус: north star проекта **agent-steward**. Любое решение по фиче сверяется с ним.
4
+ > Система гибридная: миссии по триггеру **или ad-hoc**, на усмотрение пользователя.
5
5
 
6
6
  ## TL;DR
7
7
 
@@ -13,7 +13,7 @@
13
13
  Со временем локальный сетап становится личной, приватной, дешёвой и всё более
14
14
  умной рабочей силой.
15
15
 
16
- Это и есть продукт. Всё остальное — обвязка.
16
+ Это и есть продукт. Всё остальное — обвязка, включая планировщик.
17
17
 
18
18
  ---
19
19
 
@@ -22,20 +22,20 @@
22
22
  Разработчику, который хочет автономной agent-работы, сегодня доступны три
23
23
  плохих варианта:
24
24
 
25
- 1. **Не автоматизировать** — рутина (починить тесты, обновить зависимости,
26
- бойлерплейт, извлечение, мелкие трансформации) остаётся ручной.
25
+ 1. **Не автоматизировать** — рутина остаётся ручной.
27
26
  2. **Автоматизировать в облаке** — токены на каждый прогон, код уходит наружу,
28
- нет контроля над тем, что именно исполняется и куда течёт.
29
- 3. **Автоматизировать локально наивно** — слабая модель молно выдаёт брак,
27
+ нет контроля над тем, что исполняется и куда течёт.
28
+ 3. **Автоматизировать локально наивно** — слабая модель молча выдаёт брак,
30
29
  падает, двоится; доверия нет, затею бросают.
31
30
 
32
31
  Корень всех трёх: **нет слоя, который делает агент-труд одновременно дешёвым,
33
32
  приватным и проверяемо надёжным.**
34
33
 
35
- - OpenCode даёт агентов, но не даёт супервизии: нет capability-роутинга,
36
- объективных гейтов, честной экономии, learning-loop.
34
+ - OpenCode даёт агентов, но не даёт супервизии: capability-роутинга, объективных
35
+ гейтов, честной экономии, learning-loop.
37
36
  - Облачные оркестраторы дают масштаб, но не приватность и не локальную экономию.
38
37
  - Swarm-фреймворки дают коллаборацию, но не надёжность и не экономию.
38
+ - Планировщики дают расписание, но не верификацию и не контроль ущерба.
39
39
 
40
40
  Ниша пуста: **локально-первая, верифицируемая, компаундящаяся оркестрация**.
41
41
 
@@ -48,104 +48,160 @@
48
48
  - **Объективный гейт** (тесты / линт / схема / diff-applies / команда) дёшев и
49
49
  не врёт. Он позволяет натравливать локаль на максимум задач: брак ловится и
50
50
  эскалируется, а не уезжает в прод.
51
- - Исходы гейта — **бесплатная разметка**: они учат роутинг («какие типы задач
52
- локаль тянет») и копят gate-passed датасет для прокачки весов.
51
+ - Исходы гейта — **бесплатная разметка**: они учат роутинг и копят gate-passed
52
+ датасет для прокачки весов.
53
53
 
54
54
  Проверка — не надзор, а **двигатель экономики и обучения**.
55
55
 
56
56
  ## 3. Что это такое
57
57
 
58
58
  **Фреймворк-супервизор поверх OpenCode**: локальный control plane, который
59
- принимает миссии (ad-hoc или по расписанию), раскладывает их на шаги с ролями,
60
- назначает каждый шаг **самому дешёвому способному исполнителю** (локаль →
61
- облако только при провале гейта), объективно верифицирует результат, честно
62
- считает экономию и компаундится — с каждой задачей дешевле и умнее под
63
- конкретного пользователя.
59
+ принимает миссии — **ad-hoc по желанию пользователя или по триггеру/расписанию** —
60
+ раскладывает их на шаги с ролями, назначает каждый шаг **самому дешёвому способному
61
+ исполнителю** (локаль → облако только при провале гейта), объективно верифицирует
62
+ результат, честно считает экономию и компаундится.
64
63
 
65
64
  Метафора: бригадир смешанной бригады. Дешёвые локальные подмастерья делают
66
65
  ограниченную работу под инспекцией; дорогие облачные специалисты вызываются,
67
66
  только когда инспекция завалила подмастерье; каждая инспекция делает
68
67
  подмастерьев лучше именно в твоих ремёслах.
69
68
 
69
+ Бригадира можно позвать руками в любой момент — он не живёт внутри календаря.
70
+
70
71
  ## 4. Цель и критерии приёмки (north star)
71
72
 
72
- Четыре столпа. Любая фича/ADR сверяется с ними; при конфликте порядок такой:
73
- **надёжно > приватно > дёшево > краткосрочные фичи**, explore — управляемая
73
+ Четыре столпа. При конфликте порядок:
74
+ **надёжно > приватно > дёшево > краткосрочные фичи**; explore — управляемая
74
75
  инвестиция «дёшево-сегодня» в «компаунд-завтра».
75
76
 
76
77
  | Столп | Что значит | Метрика |
77
78
  |---|---|---|
78
- | **Дёшево** | локаль закрывает максимум gate-able задач | net-экономия $ (честная контрфактика), local share %, escalation rate, time overhead |
79
+ | **Надёжно** | ноль тихих отказов / двойных прогонов / fake-done / порчи репо | trust-инциденты = 0; гейт независим и tamper-evident; полнота аудита |
79
80
  | **Приватно** | control plane, данные, аудит, triage локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
80
- | **Надёжно** | ноль тихих отказов/двойных прогонов/fake-done/порчи репо | trust-инциденты = 0; гейт независим от self-report; полнота аудита |
81
- | **Компаундится** | success rate и экономия растут под пользователя | тренд local success_rate ↑, eval-lift адаптеров, рост scaffolding-библиотеки |
81
+ | **Дёшево** | локаль закрывает максимум gate-able задач | net-экономия (минус верификация/эскалации/overhead), local share, escalation rate |
82
+ | **Компаундится** | success rate и экономия растут под пользователя | тренд local success_rate и first_pass_rate ↑, eval-lift адаптеров, рост scaffolding |
82
83
 
83
84
  Цель одним предложением: **разработчик оставляет AI-агентам свою рутину —
84
- дёшево, приватно, надёжно — и его локальный сетап с каждой неделей работает
85
- лучше и дешевле именно под его задачи.**
85
+ дёшево, приватно, надёжно, когда сам захочет или по расписанию — и его локальный
86
+ сетап с каждой неделей работает лучше и дешевле именно под его задачи.**
86
87
 
87
88
  ## 5. Способности (что он делает)
88
89
 
89
90
  - **Миссия** = цель + scope + явный критерий приёмки (гейт). Без критерия —
90
91
  не миссия, а лотерея.
92
+ - **Гибридные входы**: ad-hoc (инструмент/CLI/GUI/RPC), внутренние (цепочка, DAG,
93
+ retry, эскалация), registered (cron, once, file, git, mcp-event, webhook).
94
+ Регистрация в планировщике ОС **опциональна**.
91
95
  - **Декомпозиция** на шаги/роли (planner → implementer → reviewer …).
92
- - **Capability-aware роутинг**: локаль по умолчанию по capability-карте;
93
- облако — эскалация; explore/exploit баланс (учимся на неопределённых,
94
- выжимаем на известных).
96
+ - **Capability-aware роутинг (3 слоя)**:
97
+ - **Слой 1 — статические правила (0 токенов, мгновенно):**
98
+ ```json
99
+ {
100
+ "read_file": { "transport": "direct", "executor": "local" },
101
+ "write_file": { "transport": "direct", "executor": "local" },
102
+ "run_tests": { "transport": "direct", "executor": "local" },
103
+ "apply_diff": { "transport": "direct", "executor": "local" },
104
+ "github_create_pr": { "transport": "mcp", "executor": "local" },
105
+ "jira_update_task": { "transport": "mcp", "executor": "cloud" }
106
+ }
107
+ ```
108
+ - **Слой 2 — Capability Map (0 токенов):** SQLite `task_type → model /
109
+ success_rate / first_pass_rate / avg_attempts / avg_cost / avg_time /
110
+ last_10_runs`. Обучается на исходах гейта, с затуханием старых данных.
111
+ Высокая надёжность → локаль; низкая → облако или ревью.
112
+ - **Слой 3 — локальная модель (только декомпозиция и неоднозначность):**
113
+ модель не маршрутизирует каждый шаг.
114
+ - **Эскалация при провале гейта — по правилу, без участия модели.**
115
+ - **Reliability вместо бинарного исхода**: «прошло с первой попытки» ≠ «с третьей»;
116
+ first_pass_rate и среднее число попыток участвуют в роутинге.
95
117
  - **Объективная верификация** (keystone): провал → эскалация / ретрай / откат;
96
- никогда «готово» на слово агента.
97
- - **Честная экономика**: savings ledger (net-контрфактика с учётом эскалаций и
98
- overhead), токены/стоимость по шагам и моделям.
118
+ никогда «готово» на слово агента. Гейт **всегда hard**.
119
+ - **Целостность гейта**: gate-файлы и команда вне write-scope агента; snapshot и
120
+ хэш gate-входов и политики фиксируются на старте и сверяются перед вердиктом.
121
+ Flake/infra-исходы не обучают карту. Shadow/canary — для маршрутов и адаптеров,
122
+ не для приёмки артефакта.
123
+ - **Отложенные внешние эффекты**: до гейта агент заявляет намерения
124
+ (`effect_intents`), а не выполняет irreversible-действия. Применение — только
125
+ после pass; при провале — отброс или компенсация.
126
+ - **Контракт безопасности миссии**: класс риска компилируется в исполняемую
127
+ политику (allow/deny, egress, обязательные гейты, бюджет) **до** исполнения.
128
+ - **Честная экономика**: savings ledger (net-контрфактика с учётом эскалаций,
129
+ верификации и overhead), токены/стоимость по шагам и моделям.
99
130
  - **Полный аудит**: кто, каким инструментом, какой файл, когда, почему
100
- эскалировали.
101
- - **Learning-loop**: capability-карта по типам задач → scaffolding/few-shot из
102
- успешных решений → eval-harness → (staged) LoRA-адаптеры на gate-passed
103
- датасете.
104
- - **Автономность**: ad-hoc или расписание; переживает ребут; не двоится; не
105
- зависает; leases/locks/таймауты.
131
+ эскалировали. Ledger — tamper-evident (хеш-цепочка), не граница безопасности.
132
+ - **Learning-loop**: capability-карта → scaffolding/few-shot из успешных решений →
133
+ eval-harness → shadow → canary → (staged) LoRA на gate-passed датасете.
134
+ - **Автономность по выбору**: ad-hoc или расписание; переживает ребут; не двоится;
135
+ не зависает; leases/locks/таймауты/бюджеты.
106
136
 
107
137
  ## 6. Исполнительный цикл (его задачи)
108
138
 
109
- 1. Принять миссию + критерий приёмки.
110
- 2. Разложить на шаги, назначить роли.
111
- 3. Выбрать исполнителя шага (локаль first по capability-карте).
112
- 4. Выполнить шаг.
113
- 5. Прогнать объективный гейт.
114
- 6. Pass → записать экономию + пример + метку (+ training-record).
115
- Fail → эскалация / ретрай / откат + метка.
116
- 7. Собрать артефакт миссии (diff/PR, отчёт, аудит-трейл).
117
- 8. Отчитаться честно (savings, success rate, эскалации, overhead).
118
- 9. Обновить роутинг/eval; периодически — дообучить адаптер.
139
+ 1. Принять миссию: цель + scope + gate-спека + **контракт безопасности**;
140
+ скомпилировать политику (класс риска → allow/deny + egress + обязательные
141
+ гейты + бюджет); approval, если класс риска требует.
142
+ 2. Разложить на шаги, назначить роли (локальная модель — только здесь).
143
+ 3. **Роутинг шага**: статические правила → capability-карта с учётом reliability
144
+ (first_pass_rate, попытки, decay), локаль first, explore capped.
145
+ 4. **Context compilation**: собрать бандл под окно выбранной модели и бюджет
146
+ токенов — scaffolding/few-shot из ledger + repo-map. Пересборка при эскалации.
147
+ 5. Выполнить шаг: capability issuance на шаг (TTL), least privilege,
148
+ worktree/sandbox; внешние эффекты — только намерения.
149
+ 6. Прогнать **hard, независимый, tamper-evident, flake-aware** гейт.
150
+ - Pass → применить намерения → ledger (экономия + пример + provenance) → обновить карту.
151
+ - Fail → эскалация / ретрай / откат в рамках живого бюджета; эскалация возвращает к шагу 3.
152
+ 7. Собрать артефакт миссии (diff/PR из worktree, отчёт, аудит-трейл).
153
+ 8. Отчитаться честно: net-экономия, success rate, first_pass_rate, escalation rate,
154
+ overhead.
155
+ 9. Обновить роутинг/eval; периодически — дообучить адаптер (staged, opt-in).
156
+
157
+ Шаги 3–6 — внутренний цикл на каждый шаг миссии.
158
+ Сквозные слои: телеметрия (span на шаг), живой бюджет, аудит, durable state.
159
+ Human review / approval — **тип гейта**, доступен на любом шаге; пауза не потребляет compute.
119
160
 
120
161
  ## 7. Архитектура (слои)
121
162
 
122
163
  ```
123
- [ триггеры: ad-hoc CLI/RPC | scheduler | file | git | mcp-event ] ← обвязка
164
+ [ ВХОДЫ-АДАПТЕРЫ ]
165
+ ad-hoc: run_mission / CLI / GUI / RPC ← без регистрации в ОС
166
+ внутренние: chain / DAG / retry / escalation ← без регистрации в ОС
167
+ registered: cron / once / file / git / mcp / webhook
168
+ │
169
+ ▼
170
+ [ MISSION RUNTIME — ядро ]
171
+ intake: цель + scope + gate-спека + safety → компиляция политики + бюджет
124
172
  │
125
- [ mission intake: цель + scope + критерий приёмки (гейт) ]
173
+ createRun (durable, trigger_kind)
126
174
  │
127
- [ planner: декомпозиция на шаги/роли ]
175
+ planner: декомпозиция на шаги/роли
128
176
  │
129
- [ router: capability-карта → локаль first; explore/exploit ]
130
- │ │ эскалация
177
+ router: capability-карта + reliability → локаль first; explore capped
178
+ │ │ эскалация → возврат к router
131
179
  │ ▼
132
- │ [ облачные модели (fallback / тяжёлая артиллерия) ]
180
+ │ [ облачные модели (fallback) ]
133
181
  ▼
134
- [ executor: OpenCode-агенты (локальные / облачные) ]
182
+ context compilation: окно модели + бюджет токенов (scaffolding + repo-map)
135
183
  │
136
- [ GATE: объективная верификация (tests/lint/schema/diff/cmd) ] ← keystone
137
- │ pass │ fail
138
- ▼ ▼
139
- [ ledger: savings/audit/metrics ] [ escalate / retry / rollback ]
184
+ executor: OpenCode-агенты, capability issuance (TTL), worktree/sandbox
185
+ внешние эффекты → intents (не применяются)
140
186
  │
141
- [ learning: capability-карта → scaffolding → eval → LoRA (staged) ]
187
+ GATE: hard, независимый, tamper-evident, flake-aware ← keystone
188
+ │ pass │ fail
189
+ ▼ ▼
190
+ применить intents → ledger escalate / retry / rollback
142
191
  │
143
- [ control plane: локальный, приватный, аудит, dashboard ]
192
+ learning: карта → scaffolding → eval → shadow/canary → LoRA (staged)
193
+ │
194
+ control plane: локальный, приватный, аудит, dashboard
195
+
196
+ [ РЕГИСТРАЦИЯ ТРИГГЕРА — опционально ]
197
+ Task Scheduler / crontab / launchd — только для registered-входа
144
198
  ```
145
199
 
146
- Локально-первым является **control plane и роутинг**; инференс — гибрид
147
- (локаль максимум, облако эскалация). Приватность = данные/аудит/управление
148
- локальны, а не «ни одного облачного токена».
200
+ Объекты: **миссия** — единица работы; **задача** — миссия-шаблон + триггер
201
+ (опциональна); **запуск** — durable-исполнение миссии.
202
+
203
+ Локально-первым является **control plane и роутинг**; инференс — гибрид.
204
+ Приватность = данные/аудит/управление локальны, а не «ни одного облачного токена».
149
205
 
150
206
  ## 8. Границы (чем НЕ является)
151
207
 
@@ -153,17 +209,19 @@
153
209
  - Не замена способной облачной модели на сложном: облако — эскалация.
154
210
  - Не отмена человеческого ревью критичного: гейт поднимает пол, не потолок.
155
211
  - Не облачный SaaS и не multi-machine: локальный control plane, одна машина.
156
- - Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и
157
- обвязка, не ядро.
212
+ - Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и обвязка.
213
+ - **Не «только планировщик»**: ad-hoc миссия без расписания — полноправный вход.
214
+ Регистрация в планировщике ОС опциональна; его недоступность не блокирует ядро.
158
215
 
159
216
  ## 9. Душа: flywheel
160
217
 
161
218
  Больше задач → больше локальных попыток → больше исходов гейта → точнее
162
- capability-карта и больше примеров → выше local success → больше экономия и
163
- сильнее адаптеры → ещё больше задач выгодно гнать через локаль.
219
+ capability-карта и больше примеров → **примеры инжектятся в контекст** → выше
220
+ local first_pass_rate → больше экономия и сильнее адаптеры → ещё больше задач
221
+ выгодно гнать через локаль.
164
222
 
165
- Этот цикл и есть продукт. Персональная, приватная, компаундящаяся capability —
166
- ров, которого нет ни у статичного облака, ни у OpenCode core, ни у swarm-ов.
223
+ Ключевое звено: примеры не просто копятся, а **используются** (context compilation).
224
+ Без него flywheel не крутится.
167
225
 
168
226
  ## 10. Реальность железа (ограничение, учтённое в дизайне)
169
227
 
@@ -172,59 +230,93 @@ capability-карта и больше примеров → выше local succes
172
230
  - инференс локально: QLoRA/квант 3–8B;
173
231
  - обучение: только QLoRA 3–4B, low-rank, накопленным gate-passed датасетом,
174
232
  пакетами, а не онлайн;
175
- - поэтому прокачка staged: сначала scaffolding/роутинг (дёшево, сразу),
176
- веса — когда датасет и железо позволяют.
233
+ - прокачка staged: сначала scaffolding/роутинг (дёшево, сразу), веса — когда
234
+ датасет и железо позволяют;
235
+ - context compilation обязателен: малое окно — не повод отказываться от задачи.
236
+
177
237
  Дизайн не зависит от конкретного железа: capability-карта и гейты работают и на
178
238
  слабой, и на сильной локали; меняется лишь доля задач, которую тянет локаль.
179
239
 
180
240
  ## 11. Как поймём, что пришли (definition of done концепции)
181
241
 
182
242
  Вертикальный срез работает end-to-end и измеримо:
183
- 1. ad-hoc миссия с явным гейтом принята и разложена;
184
- 2. шаги смаршрутированы локаль-first по capability-карте;
243
+
244
+ 1. **ad-hoc** миссия с явным гейтом и safety-контрактом принята, политика
245
+ скомпилирована, миссия разложена — **без регистрации в планировщике ОС**;
246
+ 2. шаги смаршрутированы локаль-first по capability-карте с учётом reliability;
185
247
  3. гейт объективно верифицировал; провал экалировался/откатился без тихих
186
- отказов;
248
+ отказов; irreversible не произошёл до pass;
187
249
  4. ledger показал честную net-экономию и escalation rate;
188
- 5. learning-loop обновил capability-карту и положил пример/scaffolding;
189
- 6. на фикс-наборе задач за N недель: local success_rate ↑ и net-экономия ↑
190
- при неизменном качестве (eval не деградировал).
250
+ 5. learning-loop обновил capability-карту, положил пример и **переиспользовал** его;
251
+ 6. паритет: та же спека через registered-вход даёт тот же маршрут и вердикт;
252
+ 7. на фикс-наборе задач за N недель: local success_rate и first_pass_rate ↑,
253
+ net-экономия ↑ при неизменном качестве (eval не деградировал).
191
254
 
192
- Когда 1–6 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб
193
- (больше типов задач, больше машин, сильнее адаптеры).
255
+ Когда 1–7 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб.
194
256
 
195
257
  ## 12. Открытые вопросы / риски (честно)
196
258
 
197
- - Качество локального вердикта на пограничных задачах → держим правила/пороги и
198
- shadow-режим, а не слепую веру модели.
199
- - Cost of verification (прогоны тестов) → учитывать в net-экономике, кэшировать.
259
+ - Качество локального вердикта на пограничных задачах → правила/пороги и
260
+ shadow-режим, а не слепая вера модели.
261
+ - Cost of verification → учитывать в net-экономике, кэшировать.
200
262
  - Explore может тратить впустую → capped explore-бюджет, bandit по типам задач.
201
263
  - Датасет для весов копится медленно → staged-прокачка, не обещать онлайн-LoRA.
202
- - Prompt-injection даже при gate → гейт + аудит + allowedTools как пол, а не
203
- потолок; критичное — человеку.
264
+ - Prompt-injection даже при гейте → гейт + аудит + allowedTools как пол;
265
+ внешний контент недоверенный по умолчанию; критичное — человеку.
266
+ - **Reward hacking**: агент правит тесты/гейт → snapshot + hash + права вне
267
+ write-scope; обязательный тест-атака в CI.
268
+ - **Irreversible до вердикта** → отложенные эффекты (intents) и компенсация.
269
+ - **Хеш-цепочка ledger** — tamper-evident аудит, **не** граница безопасности;
270
+ граница — права и изоляция.
271
+ - **Зависимости под гипотезы** → сначала переиспользуем существующее; новый
272
+ движок/БД только с доказанной необходимостью.
204
273
 
205
274
  ## 13. Стратегия развития: от плагина к фреймворку
206
275
 
207
- Наша эволюция строится на двух столпах и постепенной абстракции:
208
-
209
276
  ### 13.1 Локальный интеллект
210
277
 
211
- Максимум проверяемой работы на локальных моделях с компандингом (обучением на успешных гейтах). Локаль тянет ограниченные, хорошо сформулированные, объективно проверяемые задачи — масса реальной рутины. Объективный гейт (тесты, линт, схема, diff-applies) дёшев и не врёт, поэтому локаль направляется на максимум задач: брак ловится и эскалируется, а не уезжает в прод. Исходы гейта — бесплатная разметка, которая учит роутинг и копит gate-passed датасет.
278
+ Максимум проверяемой работы на локальных моделях с компандингом. Объективный
279
+ гейт дёшев и не врёт, поэтому локаль направляется на максимум задач: брак
280
+ ловится и эскалируется. Исходы гейта — бесплатная разметка.
212
281
 
213
282
  ### 13.2 Мультиагентная оркестрация
214
283
 
215
- Ролевая декомпозиция миссий на шаги (planner → implementer → reviewer …). Каждый шаг назначается самому дешёвому способному исполнителю — локаль first, облако только при провале гейта. Облако используется для эскалации сложных задач, обеспечивая экономию и приватность.
284
+ Ролевая декомпозиция миссий на шаги. Каждый шаг — самому дешёвому способному
285
+ исполнителю; облако только при провале гейта.
216
286
 
217
287
  ### 13.3 Непрерывное улучшение Control Plane
218
288
 
219
- Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) — это фундамент доверия, а не отдельный продукт. Он дорабатывается наравне с ядром: локальность, приватность, наблюдаемость, гарантии отсутствия тихих отказов.
289
+ Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) —
290
+ фундамент доверия, а не отдельный продукт. Дорабатывается наравне с ядром.
220
291
 
221
292
  ### 13.4 Путь к универсальности
222
293
 
223
- - **Этап 1:** глубокая интеграция с OpenCode V1 и V2 (текущий): один пакет, dual export, общее ядро.
224
- - **Этап 2:** абстракция слоя исполнения (Agent Executor Interface).
225
- - **Этап 3:** универсальный фреймворк оркестрации, совместимый с любым агентом через MCP или стандартные API.
294
+ - **Этап 1 (текущий):** глубокая интеграция с OpenCode V1 и V2 — один пакет,
295
+ dual export, общее ядро.
296
+ - **Этап 2:** выделение mission runtime, независимого от планировщика ОС, и
297
+ абстракция слоя исполнения (Agent Executor Interface).
298
+ - **Этап 3:** универсальный фреймворк оркестрации, совместимый с любым агентом
299
+ через MCP или стандартные API; интероперабельность — через стабильные форматы
300
+ (pipeline YAML, SQLite ledger) и MCP, а не через соответствие чужим схемам слоёв.
301
+
302
+ ## 14. Продукт для людей (не на продажу)
303
+
304
+ - **Суверенитет пользователя.** Данные локальны и экспортируемы; роутинг
305
+ переопределяем; обучение отключаемо; без аккаунтов, SaaS и телеметрии.
306
+ - **Свобода сценария.** Можно жить без расписаний, можно на расписаниях, можно
307
+ смешивать. Одноразовая работа не требует регистрации задачи.
308
+ - **Честность.** «Сэкономлено $» — консервативная оценка с методикой рядом;
309
+ метрики воспроизводимы из ledger. Термин — tamper-evident, не tamper-proof.
310
+ - **Низкий порог.** Работает на скромном железе, безопасно по умолчанию,
311
+ понятные дефолты, документация на нескольких языках.
312
+ - **Долговечность.** Скучные технологии, мало зависимостей, стабильные форматы,
313
+ дисциплина миграций: через годы оно всё ещё запускается.
314
+ - **Открытость.** Открытые форматы pipeline и ledger, библиотека рецептов,
315
+ skill-экосистема — сообщество расширяет без maintainer'а.
316
+ - **Пол, не потолок.** Гейт и approval поднимают минимальную планку качества и
317
+ безопасности; критичные решения остаются за человеком.
226
318
 
227
319
  ---
228
320
 
229
321
  *Любое изменение в репозитории, которое не двигает хотя бы один столп из §4 и
230
- не согласуется с §8, — не цель, а шум.*
322
+ не согласуется с §8, — не цель, а шум.*
@@ -50,23 +50,25 @@ interface SchedulerBackend {
50
50
  ## Как работает каждая ОС
51
51
 
52
52
  ### Windows (поведение не изменилось)
53
- - Задачи регистрируются в Планировщике Windows через `schtasks` в папке `\OpenCode\windows-scheduler\`.
54
- - Обёртка: `run-task.ps1` + персональный `run-<name>.cmd` в `%APPDATA%\opencode\windows-scheduler\wrapper`.
55
- - Логи: `%APPDATA%\opencode\windows-scheduler\logs\<name>.log`.
53
+ - Задачи регистрируются в Планировщике Windows через `schtasks` в папке `\OpenCode\agent-steward\` (профили — `\OpenCode\agent-steward-<profile>\`). Legacy-папка `\OpenCode\windows-scheduler\` по-прежнему читается, переименовывается и удаляется по требованию.
54
+ - Обёртка: `run-task.ps1` + персональный `run-<name>.cmd` в `%APPDATA%\opencode\agent-steward\wrapper`. Legacy-каталог `%APPDATA%\opencode\windows-scheduler` переносится при первом запуске.
55
+ - Логи: `%APPDATA%\opencode\agent-steward\logs\<name>.log`.
56
56
  - cron конвертируется в schtasks (`convertCronToSchTasks`) — поддерживается тот же набор шаблонов.
57
57
 
58
58
  ### Linux
59
59
  - Задачи живут в управляемом блоке `crontab`:
60
60
  ```
61
- # >>> opencode-scheduler >>>
61
+ # >>> opencode-scheduler:agent-steward >>>
62
62
  # task: my-task
63
63
  */5 * * * * /bin/bash '/…/wrapper/run-my-task.sh' >> '/…/logs/my-task.log' 2>&1
64
- # <<< opencode-scheduler <<<
64
+ # <<< opencode-scheduler:agent-steward <<<
65
65
  ```
66
+ Блоки без суффикса `:<folder>` (legacy) по-прежнему читаются и удаляются.
66
67
  - Пауза = строка с префиксом `# PAUSED: ` (блок пересобирается из реестра).
67
68
  - Задачи с триггером `file` в crontab не попадают — их запускает FileWatchManager плагина.
68
- - Обёртка: `~/.config/opencode/windows-scheduler/wrapper/run-<name>.sh` (chmod 0755).
69
+ - Обёртка: `~/.config/opencode/agent-steward/wrapper/run-<name>.sh` (chmod 0755).
69
70
  - Полный cron-синтаксис (в отличие от Windows), т.к. crontab понимает его нативно.
71
+ - Разовый запуск (`once`): `at -t`; если `at` не установлен, плагин ставит отвязанный процесс `sleep && команда` (`pid:<pid>` в реестре). Fallback не переживает перезагрузку — для надёжности установите пакет `at`.
70
72
  - Удаление/пересборка — только своего блока, остальные строки `crontab` не трогаются.
71
73
 
72
74
  ### macOS
@@ -75,7 +77,7 @@ interface SchedulerBackend {
75
77
  `M H * * *`, `M H * * D`.
76
78
  - Пауза = `launchctl unload -w`, возобновление = `launchctl load -w`.
77
79
  - Обёртка — тот же `.sh`, что и на Linux; пути конфигов:
78
- `~/.config/opencode/windows-scheduler/` (или `$XDG_CONFIG_HOME`).
80
+ `~/.config/opencode/agent-steward/` (или `$XDG_CONFIG_HOME`).
79
81
 
80
82
  ### Общая POSIX-обёртка (`.sh`)
81
83
  - `cd` в рабочую директорию, `opencode run` с промптом из файла.
@@ -98,7 +100,7 @@ interface SchedulerBackend {
98
100
  | Пауза / возобновление | `schtasks /change /disable` / `/enable` | строка `# PAUSED:` в управляемом блоке | `launchctl unload -w` / `load -w` |
99
101
  | Файловые триггеры | in-process `FileWatchManager` | так же | так же |
100
102
  | Обёртки задач | `.cmd` + `.ps1` | `.sh` | `.sh` |
101
- | Логи | `%APPDATA%\opencode\windows-scheduler\logs` | `~/.config/opencode/windows-scheduler/logs` | как на Linux |
103
+ | Логи | `%APPDATA%\opencode\agent-steward\logs` | `~/.config/opencode/agent-steward/logs` | как на Linux |
102
104
  | Защита `secrets.key` | `icacls` (только владелец) + `chmod` как fallback | `chmod 0600` | `chmod 0600` |
103
105
  | Дашборд | `127.0.0.1`, динамический заголовок | так же | так же |
104
106
  | DAG / matrix / quality gates / уведомления | в плагине, не зависят от ОС | так же | так же |
@@ -145,6 +147,6 @@ interface SchedulerBackend {
145
147
  2. cron → launchd поддерживает тот же ограниченный набор шаблонов, что и Windows
146
148
  (`* * * * *`, `*/N * * * *`, `M * * * *`, `M H * * *`, `M H * * D`).
147
149
  На Linux доступен полный cron.
148
- 3. Префикс задач Windows (`\OpenCode\windows-scheduler\`) и id плагина сохранены для обратной совместимости.
150
+ 3. Префикс задач Windows теперь `\OpenCode\agent-steward\` (legacy `\OpenCode\windows-scheduler\` по-прежнему распознаётся); id плагина сохранён для обратной совместимости.
149
151
  4. `src/schtasks.ts` оставлен как тонкий shim для старых скриптов (`test-create.cjs`, `test-run.cjs`),
150
152
  вся логика теперь в `core/scheduler/windows.ts`.
@@ -49,23 +49,25 @@ interface SchedulerBackend {
49
49
  ## 各操作系统的运行方式
50
50
 
51
51
  ### Windows(行为未变)
52
- - 任务通过 `schtasks` 注册到 Windows 任务计划程序的 `\OpenCode\windows-scheduler\` 文件夹。
53
- - 包装脚本:`run-task.ps1` 加每个任务专属的 `run-<name>.cmd`,位于 `%APPDATA%\opencode\windows-scheduler\wrapper`。
54
- - 日志:`%APPDATA%\opencode\windows-scheduler\logs\<name>.log`。
52
+ - 任务通过 `schtasks` 注册到 Windows 任务计划程序的 `\OpenCode\agent-steward\` 文件夹(配置文件使用 `\OpenCode\agent-steward-<profile>\`)。旧的 `\OpenCode\windows-scheduler\` 文件夹仍会被读取、重命名和按需删除。
53
+ - 包装脚本:`run-task.ps1` 加每个任务专属的 `run-<name>.cmd`,位于 `%APPDATA%\opencode\agent-steward\wrapper`。旧的 `%APPDATA%\opencode\windows-scheduler` 目录会在首次启动时迁移。
54
+ - 日志:`%APPDATA%\opencode\agent-steward\logs\<name>.log`。
55
55
  - cron 会转换成 schtasks(`convertCronToSchTasks`)——支持与之前相同的模板集合。
56
56
 
57
57
  ### Linux
58
58
  - 任务保存在受管 `crontab` 块中:
59
59
  ```
60
- # >>> opencode-scheduler >>>
60
+ # >>> opencode-scheduler:agent-steward >>>
61
61
  # task: my-task
62
62
  */5 * * * * /bin/bash '/…/wrapper/run-my-task.sh' >> '/…/logs/my-task.log' 2>&1
63
- # <<< opencode-scheduler <<<
63
+ # <<< opencode-scheduler:agent-steward <<<
64
64
  ```
65
+ 不带 `:<folder>` 后缀的旧块仍会被读取和删除。
65
66
  - 暂停 = 带 `# PAUSED: ` 前缀的行(块会从注册表重建)。
66
67
  - `file` 触发器的任务不会进入 crontab——由插件的 FileWatchManager 启动。
67
- - 包装脚本:`~/.config/opencode/windows-scheduler/wrapper/run-<name>.sh`(chmod 0755)。
68
+ - 包装脚本:`~/.config/opencode/agent-steward/wrapper/run-<name>.sh`(chmod 0755)。
68
69
  - 支持完整 cron 语法(与 Windows 不同),因为 crontab 原生支持。
70
+ - 一次性任务(`once`):使用 `at -t`;如果未安装 `at`,插件会退回到分离的 `sleep && 命令` 进程(注册表中为 `pid:<pid>`)。回退方案无法在重启后保留,建议安装 `at` 包。
69
71
  - 删除/重建只触及自己的块,`crontab` 的其他行不受影响。
70
72
 
71
73
  ### macOS
@@ -74,7 +76,7 @@ interface SchedulerBackend {
74
76
  使用 `StartCalendarInterval`。
75
77
  - 暂停 = `launchctl unload -w`,恢复 = `launchctl load -w`。
76
78
  - 包装脚本与 Linux 相同的 `.sh`;配置路径:
77
- `~/.config/opencode/windows-scheduler/`(或 `$XDG_CONFIG_HOME`)。
79
+ `~/.config/opencode/agent-steward/`(或 `$XDG_CONFIG_HOME`)。
78
80
 
79
81
  ### 共享 POSIX 包装脚本(`.sh`)
80
82
  - `cd` 到工作目录,用文件中的提示词执行 `opencode run`。
@@ -97,7 +99,7 @@ interface SchedulerBackend {
97
99
  | 暂停 / 恢复 | `schtasks /change /disable` / `/enable` | 托管块中的 `# PAUSED:` 行 | `launchctl unload -w` / `load -w` |
98
100
  | 文件触发器 | 进程内 `FileWatchManager` | 相同 | 相同 |
99
101
  | 任务包装脚本 | `.cmd` + `.ps1` | `.sh` | `.sh` |
100
- | 日志 | `%APPDATA%\opencode\windows-scheduler\logs` | `~/.config/opencode/windows-scheduler/logs` | 与 Linux 相同 |
102
+ | 日志 | `%APPDATA%\opencode\agent-steward\logs` | `~/.config/opencode/agent-steward/logs` | 与 Linux 相同 |
101
103
  | `secrets.key` 保护 | `icacls`(仅所有者)+ `chmod` 回退 | `chmod 0600` | `chmod 0600` |
102
104
  | 仪表盘 | `127.0.0.1`,动态标题 | 相同 | 相同 |
103
105
  | DAG / matrix / quality gates / 通知 | 插件内,与操作系统无关 | 相同 | 相同 |
@@ -141,6 +143,6 @@ interface SchedulerBackend {
141
143
  2. cron → launchd 支持与 Windows 相同的有限模板集合
142
144
  (`* * * * *`、`*/N * * * *`、`M * * * *`、`M H * * *`、`M H * * D`)。
143
145
  Linux 上支持完整 cron。
144
- 3. Windows 任务前缀(`\OpenCode\windows-scheduler\`)和插件 id 为向后兼容而保留。
146
+ 3. Windows 任务前缀现为 `\OpenCode\agent-steward\`(旧的 `\OpenCode\windows-scheduler\` 仍会被识别);插件 id 为向后兼容而保留。
145
147
  4. `src/schtasks.ts` 保留为旧脚本(`test-create.cjs`、`test-run.cjs`)的薄垫片;
146
148
  所有逻辑现在都在 `core/scheduler/windows.ts`。