agent-steward 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (345) hide show
  1. package/CHANGELOG.md +399 -0
  2. package/CROSS_PLATFORM.md +151 -0
  3. package/README.md +307 -15
  4. package/ROADMAP-STRATEGY.md +196 -0
  5. package/ROADMAP.md +184 -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 +12 -0
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  14. package/dist/core/cron-to-schtasks.js +175 -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 +193 -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 +90 -0
  40. package/dist/core/one-shot.d.ts.map +1 -0
  41. package/dist/core/one-shot.js +182 -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 +1091 -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/at-fallback.d.ts +42 -0
  70. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  71. package/dist/core/scheduler/at-fallback.js +70 -0
  72. package/dist/core/scheduler/index.d.ts +32 -0
  73. package/dist/core/scheduler/index.d.ts.map +1 -0
  74. package/dist/core/scheduler/index.js +63 -0
  75. package/dist/core/scheduler/linux.d.ts +46 -0
  76. package/dist/core/scheduler/linux.d.ts.map +1 -0
  77. package/dist/core/scheduler/linux.js +261 -0
  78. package/dist/core/scheduler/logs.d.ts +11 -0
  79. package/dist/core/scheduler/logs.d.ts.map +1 -0
  80. package/dist/core/scheduler/logs.js +34 -0
  81. package/dist/core/scheduler/mac.d.ts +46 -0
  82. package/dist/core/scheduler/mac.d.ts.map +1 -0
  83. package/dist/core/scheduler/mac.js +256 -0
  84. package/dist/core/scheduler/posix.d.ts +40 -0
  85. package/dist/core/scheduler/posix.d.ts.map +1 -0
  86. package/dist/core/scheduler/posix.js +100 -0
  87. package/dist/core/scheduler/registry.d.ts +43 -0
  88. package/dist/core/scheduler/registry.d.ts.map +1 -0
  89. package/dist/core/scheduler/registry.js +57 -0
  90. package/dist/core/scheduler/types.d.ts +86 -0
  91. package/dist/core/scheduler/types.d.ts.map +1 -0
  92. package/dist/core/scheduler/types.js +1 -0
  93. package/dist/core/scheduler/windows.d.ts +112 -0
  94. package/dist/core/scheduler/windows.d.ts.map +1 -0
  95. package/dist/core/scheduler/windows.js +749 -0
  96. package/dist/core/secrets.d.ts +66 -0
  97. package/dist/core/secrets.d.ts.map +1 -0
  98. package/dist/core/secrets.js +433 -0
  99. package/dist/core/self-analysis.d.ts +117 -0
  100. package/dist/core/self-analysis.d.ts.map +1 -0
  101. package/dist/core/self-analysis.js +539 -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 +49 -0
  148. package/dist/db/index.d.ts.map +1 -0
  149. package/dist/db/index.js +128 -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/run-journal.d.ts +60 -0
  160. package/dist/db/run-journal.d.ts.map +1 -0
  161. package/dist/db/run-journal.js +143 -0
  162. package/dist/db/run-resume.d.ts +48 -0
  163. package/dist/db/run-resume.d.ts.map +1 -0
  164. package/dist/db/run-resume.js +137 -0
  165. package/dist/db/runs-repo.d.ts +120 -0
  166. package/dist/db/runs-repo.d.ts.map +1 -0
  167. package/dist/db/runs-repo.js +319 -0
  168. package/dist/db/schema.d.ts +38 -0
  169. package/dist/db/schema.d.ts.map +1 -0
  170. package/dist/db/schema.js +325 -0
  171. package/dist/db/settings-repo.d.ts +8 -0
  172. package/dist/db/settings-repo.d.ts.map +1 -0
  173. package/dist/db/settings-repo.js +27 -0
  174. package/dist/db/tasks-repo.d.ts +26 -0
  175. package/dist/db/tasks-repo.d.ts.map +1 -0
  176. package/dist/db/tasks-repo.js +120 -0
  177. package/dist/db/templates-repo.d.ts +17 -0
  178. package/dist/db/templates-repo.d.ts.map +1 -0
  179. package/dist/db/templates-repo.js +57 -0
  180. package/dist/history.d.ts +60 -0
  181. package/dist/history.d.ts.map +1 -0
  182. package/dist/history.js +70 -0
  183. package/dist/i18n.d.ts +75 -0
  184. package/dist/i18n.d.ts.map +1 -0
  185. package/dist/i18n.js +357 -0
  186. package/dist/index.d.ts +858 -0
  187. package/dist/index.d.ts.map +1 -0
  188. package/dist/index.js +5209 -0
  189. package/dist/integrations.d.ts +72 -0
  190. package/dist/integrations.d.ts.map +1 -0
  191. package/dist/integrations.js +233 -0
  192. package/dist/notifications.d.ts +199 -0
  193. package/dist/notifications.d.ts.map +1 -0
  194. package/dist/notifications.js +967 -0
  195. package/dist/profiles.d.ts +64 -0
  196. package/dist/profiles.d.ts.map +1 -0
  197. package/dist/profiles.js +305 -0
  198. package/dist/rpc.d.ts +3915 -0
  199. package/dist/rpc.d.ts.map +1 -0
  200. package/dist/rpc.js +1596 -0
  201. package/dist/schtasks.d.ts +32 -0
  202. package/dist/schtasks.d.ts.map +1 -0
  203. package/dist/schtasks.js +45 -0
  204. package/dist/server.d.ts +128 -0
  205. package/dist/server.d.ts.map +1 -0
  206. package/dist/server.js +2414 -0
  207. package/dist/settings.d.ts +389 -0
  208. package/dist/settings.d.ts.map +1 -0
  209. package/dist/settings.js +770 -0
  210. package/dist/shared/jobs-view.d.ts +59 -0
  211. package/dist/shared/jobs-view.d.ts.map +1 -0
  212. package/dist/shared/jobs-view.js +146 -0
  213. package/dist/skill.d.ts +15 -0
  214. package/dist/skill.d.ts.map +1 -0
  215. package/dist/skill.js +93 -0
  216. package/dist/task-transfer.d.ts +252 -0
  217. package/dist/task-transfer.d.ts.map +1 -0
  218. package/dist/task-transfer.js +632 -0
  219. package/dist/templates.d.ts +57 -0
  220. package/dist/templates.d.ts.map +1 -0
  221. package/dist/templates.js +16 -0
  222. package/dist/types.d.ts +112 -0
  223. package/dist/types.d.ts.map +1 -0
  224. package/dist/types.js +158 -0
  225. package/dist/version.d.ts +8 -0
  226. package/dist/version.d.ts.map +1 -0
  227. package/dist/version.js +27 -0
  228. package/dist/workspaces.d.ts +113 -0
  229. package/dist/workspaces.d.ts.map +1 -0
  230. package/dist/workspaces.js +393 -0
  231. package/docs/ARCHITECTURE.md +559 -0
  232. package/docs/COMPATIBILITY.md +237 -0
  233. package/docs/CONCEPT.md +242 -0
  234. package/docs/CROSS_PLATFORM.ru.md +152 -0
  235. package/docs/CROSS_PLATFORM.zh.md +148 -0
  236. package/docs/FAQ.md +52 -0
  237. package/docs/FAQ.ru.md +53 -0
  238. package/docs/FAQ.zh.md +43 -0
  239. package/docs/FEATURES.md +699 -0
  240. package/docs/FEATURES.zh.md +656 -0
  241. package/docs/LOCAL-AI.md +300 -0
  242. package/docs/MIGRATION.md +363 -0
  243. package/docs/README.ru.md +287 -0
  244. package/docs/README.zh.md +306 -0
  245. package/docs/SAVINGS.md +61 -0
  246. package/docs/SAVINGS.ru.md +60 -0
  247. package/docs/SAVINGS.zh.md +52 -0
  248. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  249. package/docs/ZH-LOCALE-PLAN.md +324 -0
  250. package/docs/dashboard.png +0 -0
  251. package/docs/spikes/local-model-structured-output.md +81 -0
  252. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  253. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  254. package/gui-experimental.cjs +9 -0
  255. package/index.js +2 -0
  256. package/locales/en.json +781 -0
  257. package/locales/ru.json +781 -0
  258. package/locales/zh.json +781 -0
  259. package/package.json +154 -13
  260. package/scripts/bench-local.mjs +321 -0
  261. package/scripts/check-zh-locale.mjs +218 -0
  262. package/scripts/demo-dashboard.mjs +209 -0
  263. package/scripts/run-tests.mjs +236 -0
  264. package/scripts/spike-local-structured.mjs +182 -0
  265. package/scripts/test-locale.mjs +45 -0
  266. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  267. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  268. package/src/core/analytics.ts +424 -0
  269. package/src/core/audit.ts +418 -0
  270. package/src/core/cron-to-schtasks.ts +209 -0
  271. package/src/core/dry-run.ts +601 -0
  272. package/src/core/file-watcher.ts +245 -0
  273. package/src/core/git-trigger.ts +391 -0
  274. package/src/core/glob.ts +226 -0
  275. package/src/core/local-ai.ts +173 -0
  276. package/src/core/lock.ts +219 -0
  277. package/src/core/matrix.ts +947 -0
  278. package/src/core/native-notify.ts +157 -0
  279. package/src/core/one-shot.ts +239 -0
  280. package/src/core/otel.ts +128 -0
  281. package/src/core/permissions.ts +200 -0
  282. package/src/core/prometheus.ts +215 -0
  283. package/src/core/ps-wrapper.ts +1160 -0
  284. package/src/core/record-history.ts +615 -0
  285. package/src/core/retention.ts +141 -0
  286. package/src/core/savings.ts +150 -0
  287. package/src/core/schedule-gate.ts +253 -0
  288. package/src/core/schedule-v2.ts +668 -0
  289. package/src/core/scheduler/at-fallback.ts +113 -0
  290. package/src/core/scheduler/index.ts +82 -0
  291. package/src/core/scheduler/linux.ts +308 -0
  292. package/src/core/scheduler/logs.ts +37 -0
  293. package/src/core/scheduler/mac.ts +322 -0
  294. package/src/core/scheduler/posix.ts +128 -0
  295. package/src/core/scheduler/registry.ts +101 -0
  296. package/src/core/scheduler/types.ts +90 -0
  297. package/src/core/scheduler/windows.ts +881 -0
  298. package/src/core/secrets.ts +503 -0
  299. package/src/core/self-analysis.ts +744 -0
  300. package/src/core/session.ts +150 -0
  301. package/src/core/shutdown.ts +69 -0
  302. package/src/core/structured-log.ts +214 -0
  303. package/src/core/summary.ts +318 -0
  304. package/src/core/telegram.ts +436 -0
  305. package/src/core/triage-chain.ts +125 -0
  306. package/src/core/triage-compare.ts +277 -0
  307. package/src/core/triage-rules.ts +238 -0
  308. package/src/core/triage-shadow.ts +240 -0
  309. package/src/core/triage-worker.ts +344 -0
  310. package/src/core/triage.ts +366 -0
  311. package/src/core/watch-paths.ts +70 -0
  312. package/src/core/wrappers/bash.ts +532 -0
  313. package/src/db/git-state-repo.ts +62 -0
  314. package/src/db/history-repo.ts +492 -0
  315. package/src/db/index.ts +176 -0
  316. package/src/db/metrics-repo.ts +170 -0
  317. package/src/db/migrate.ts +328 -0
  318. package/src/db/recovery.ts +46 -0
  319. package/src/db/run-journal.ts +212 -0
  320. package/src/db/run-resume.ts +220 -0
  321. package/src/db/runs-repo.ts +481 -0
  322. package/src/db/schema.ts +349 -0
  323. package/src/db/settings-repo.ts +31 -0
  324. package/src/db/tasks-repo.ts +162 -0
  325. package/src/db/templates-repo.ts +77 -0
  326. package/src/gui.tsx +5222 -0
  327. package/src/history.ts +128 -0
  328. package/src/i18n.ts +413 -0
  329. package/src/index.ts +6642 -0
  330. package/src/integrations.ts +297 -0
  331. package/src/notifications.ts +1346 -0
  332. package/src/profiles.ts +345 -0
  333. package/src/rpc.ts +1704 -0
  334. package/src/schtasks.ts +75 -0
  335. package/src/server.ts +2663 -0
  336. package/src/settings.ts +1369 -0
  337. package/src/shared/jobs-view.ts +188 -0
  338. package/src/skill.ts +113 -0
  339. package/src/task-transfer.ts +946 -0
  340. package/src/templates.ts +67 -0
  341. package/src/tui-v1.tsx +341 -0
  342. package/src/tui.tsx +329 -0
  343. package/src/types.ts +226 -0
  344. package/src/version.ts +27 -0
  345. package/src/workspaces.ts +487 -0
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Пользовательский шаблон задачи.
3
+ *
4
+ * В отличие от встроенных шаблонов промптов, хранит не только текст промпта,
5
+ * но и все настройки формы: расписание, ретраи, Quality Gate, цепочки задач
6
+ * и файловый триггер. Это позволяет одной командой воспроизвести задачу.
7
+ */
8
+ export interface TaskTemplate {
9
+ /** Уникальный идентификатор (uuid). */
10
+ id: string;
11
+ /** Название шаблона, которое видит пользователь. */
12
+ name: string;
13
+ prompt: string;
14
+ schedule?: string;
15
+ timeoutSeconds?: number;
16
+ /** LLM-модель задачи (если не задана — модель OpenCode по умолчанию). */
17
+ model?: string;
18
+ /** Приоритет задачи 0..10 (10 — наивысший). */
19
+ priority?: number;
20
+ retryCount?: number;
21
+ retryDelay?: number;
22
+ qualityGate?: string;
23
+ /** Команда перед запуском (pre-flight). */
24
+ beforeScript?: string;
25
+ /** Команда после запуска (post-flight). */
26
+ afterScript?: string;
27
+ nextTaskOnSuccess?: string;
28
+ nextTaskOnError?: string;
29
+ /** DAG-зависимости: задачи, которые должны успешно завершиться раньше этой. */
30
+ dependsOn?: string[];
31
+ triggerType?: "cron" | "file" | "git" | "mcp-event";
32
+ /** Параметры MCP-события (для triggerType === "mcp-event"). */
33
+ mcpEvent?: {
34
+ server: string;
35
+ event: string;
36
+ filter?: string;
37
+ };
38
+ watchPath?: string;
39
+ /** Рабочая директория задачи (если не задана — папка проекта). */
40
+ workingDirectory?: string;
41
+ /** Ограничения инструментов: белый список (пустой массив запрещён). */
42
+ allowedTools?: string[];
43
+ /** Ограничения инструментов: чёрный список (denied wins при конфликте). */
44
+ deniedTools?: string[];
45
+ }
46
+ /** Читает шаблоны из БД (раньше — templates.json). */
47
+ export declare function loadTemplates(): Promise<TaskTemplate[]>;
48
+ /**
49
+ * Добавляет или обновляет шаблон.
50
+ * Если id не передан — генерируется новый. Возвращает сохранённый шаблон.
51
+ */
52
+ export declare function saveTemplate(template: Omit<TaskTemplate, "id"> & {
53
+ id?: string;
54
+ }): Promise<TaskTemplate>;
55
+ /** Удаляет шаблон по id. */
56
+ export declare function deleteTemplate(id: string): Promise<void>;
57
+ //# sourceMappingURL=templates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,sDAAsD;AACtD,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAE7D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,4BAA4B;AAC5B,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D"}
@@ -0,0 +1,16 @@
1
+ import { listTemplates, saveTemplate as saveTemplateRow, deleteTemplate as deleteTemplateRow, } from "./db/templates-repo.js";
2
+ /** Читает шаблоны из БД (раньше — templates.json). */
3
+ export async function loadTemplates() {
4
+ return listTemplates();
5
+ }
6
+ /**
7
+ * Добавляет или обновляет шаблон.
8
+ * Если id не передан — генерируется новый. Возвращает сохранённый шаблон.
9
+ */
10
+ export async function saveTemplate(template) {
11
+ return saveTemplateRow(template);
12
+ }
13
+ /** Удаляет шаблон по id. */
14
+ export async function deleteTemplate(id) {
15
+ deleteTemplateRow(id);
16
+ }
@@ -0,0 +1,112 @@
1
+ import { z } from "zod";
2
+ /** Папка задач плагина в планировщике ОС (Windows). */
3
+ export declare const TASK_FOLDER = "OpenCode";
4
+ /**
5
+ * Имя папки/блока задач. У нестандартного профиля своё пространство имён,
6
+ * иначе профили делят одну папку Планировщика Windows и один блок crontab.
7
+ * Новое имя — agent-steward; историческое windows-scheduler поддерживается
8
+ * как legacy (см. legacyTaskFolderNameForProfile).
9
+ */
10
+ export declare function taskFolderNameForProfile(profile?: string): string;
11
+ /** Историческое имя папки/блока задач — для чтения и удаления старых задач. */
12
+ export declare function legacyTaskFolderNameForProfile(profile?: string): string;
13
+ export declare const TASK_FOLDER_NAME: string;
14
+ export declare const LEGACY_TASK_FOLDER_NAME: string;
15
+ /** Префикс всех задач плагина. */
16
+ export declare const TASK_PREFIX: string;
17
+ /** Исторический префикс задач (до переименования). */
18
+ export declare const LEGACY_TASK_PREFIX: string;
19
+ export declare const PLUGIN_DIR: string;
20
+ export declare const LOCK_DIR: string;
21
+ export declare const LOG_DIR: string;
22
+ export declare const WRAPPER_DIR: string;
23
+ /** true, если плагин запущен на Windows. */
24
+ export declare const IS_WINDOWS: boolean;
25
+ /** Порог возраста lock-файла, после которого он считается зависшим (24 часа). */
26
+ export declare const STALE_LOCK_MAX_AGE_MS: number;
27
+ /**
28
+ * Приводит имя задачи к безопасному виду для имён файлов (обёртка, промпт, lock, лог).
29
+ * Кириллица транслитерируется, прочие спецсимволы заменяются на дефис.
30
+ * Используется единообразно при создании задачи (index.ts) и при чтении логов (schtasks.ts).
31
+ */
32
+ export declare function sanitizeName(name: string): string;
33
+ /**
34
+ * Проверяет идентификатор LLM-модели перед подстановкой в командную строку.
35
+ *
36
+ * Формат: `provider/model` (вариант — `provider/model#variant`).
37
+ * Разрешены только латиница, цифры и символы `. _ : / -` (плюс `#` для
38
+ * варианта). Это исключает PowerShell-subexpression (`$(...)`, backtick)
39
+ * и прочие спецсимволы. Пустая строка — «модель не задана», это допустимо.
40
+ *
41
+ * @returns текст ошибки или null, если значение допустимо.
42
+ */
43
+ export declare function validateModelId(raw: string): string | null;
44
+ /**
45
+ * Проверяет имя задачи до создания файлов и записи в БД.
46
+ *
47
+ * Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».
48
+ * Спецсимволы оболочки (`& | < > ^ % " ' ; ( ) \``, обратный слэш, слэш)
49
+ * и управляющие символы запрещены: даже при безопасном вызове schtasks
50
+ * такие имена ломают пути файлов и переносимы между платформами.
51
+ *
52
+ * @returns текст ошибки или null, если имя допустимо.
53
+ */
54
+ export declare function validateTaskName(raw: string): string | null;
55
+ /**
56
+ * Схема аргументов для schedule_job.
57
+ * schedule принимает только 5-полевые cron-выражения.
58
+ */
59
+ export declare const ScheduleJobArgs: z.ZodObject<{
60
+ name: z.ZodString;
61
+ schedule: z.ZodString;
62
+ prompt: z.ZodString;
63
+ timeoutSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
64
+ workdir: z.ZodOptional<z.ZodString>;
65
+ }, z.core.$strip>;
66
+ export type ScheduleJobArgs = z.infer<typeof ScheduleJobArgs>;
67
+ export declare const DeleteJobArgs: z.ZodObject<{
68
+ name: z.ZodString;
69
+ }, z.core.$strip>;
70
+ export type DeleteJobArgs = z.infer<typeof DeleteJobArgs>;
71
+ export declare const RunJobNowArgs: z.ZodObject<{
72
+ name: z.ZodString;
73
+ }, z.core.$strip>;
74
+ export type RunJobNowArgs = z.infer<typeof RunJobNowArgs>;
75
+ export declare const ListJobsArgs: z.ZodObject<{}, z.core.$strip>;
76
+ export type ListJobsArgs = z.infer<typeof ListJobsArgs>;
77
+ /**
78
+ * Результат преобразования cron в флаги schtasks.
79
+ */
80
+ export interface CronConversion {
81
+ /** Тип расписания schtasks: MINUTE, DAILY или WEEKLY. */
82
+ sc: "MINUTE" | "HOURLY" | "DAILY" | "WEEKLY";
83
+ /** Дополнительные флаги командной строки (кроме /sc и /tn /tr /f). */
84
+ extraFlags: string[];
85
+ /** Время начала для /st (HH:MM) или undefined. */
86
+ startTime?: string;
87
+ /** Дни недели для /d (при WEEKLY). */
88
+ days?: string;
89
+ /** Интервал в минутах для /mo (при MINUTE). */
90
+ interval?: number;
91
+ }
92
+ /**
93
+ * Информация о задаче, полученная из schtasks /query.
94
+ */
95
+ export interface ScheduledTaskInfo {
96
+ /** Короткое имя задачи (без папки планировщика). */
97
+ taskName: string;
98
+ folder?: string;
99
+ taskNameToRun?: string;
100
+ nextRunTime?: string;
101
+ status?: string;
102
+ logonMode?: string;
103
+ lastRunTime?: string;
104
+ lastResult?: string;
105
+ author?: string;
106
+ taskToRun?: string;
107
+ comment?: string;
108
+ triggers?: string[];
109
+ /** true — задача поставлена на паузу (disabled). */
110
+ paused?: boolean;
111
+ }
112
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,uDAAuD;AACvD,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAEnF;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,MAAyB,GACjC,MAAM,CAER;AAED,eAAO,MAAM,gBAAgB,QAA6B,CAAC;AAC3D,eAAO,MAAM,uBAAuB,QAAmC,CAAC;AAExE,kCAAkC;AAClC,eAAO,MAAM,WAAW,QAAkC,CAAC;AAC3D,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,QAAyC,CAAC;AAczE,eAAO,MAAM,UAAU,QAAqB,CAAC;AAE7C,eAAO,MAAM,QAAQ,QAAiC,CAAC;AACvD,eAAO,MAAM,OAAO,QAAgC,CAAC;AACrD,eAAO,MAAM,WAAW,QAAoC,CAAC;AAE7D,4CAA4C;AAC5C,eAAO,MAAM,UAAU,SAA+B,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,QAAsB,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6B3D;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;iBA6B1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa;;iBAExB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,aAAa;;iBAExB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,YAAY,gCAAe,CAAC;AACzC,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,EAAE,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,sEAAsE;IACtE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}
package/dist/types.js ADDED
@@ -0,0 +1,158 @@
1
+ import path from "node:path";
2
+ import { z } from "zod";
3
+ import { getProfileDir, getProfileName } from "./profiles.js";
4
+ /** Папка задач плагина в планировщике ОС (Windows). */
5
+ export const TASK_FOLDER = "OpenCode";
6
+ /**
7
+ * Имя папки/блока задач. У нестандартного профиля своё пространство имён,
8
+ * иначе профили делят одну папку Планировщика Windows и один блок crontab.
9
+ * Новое имя — agent-steward; историческое windows-scheduler поддерживается
10
+ * как legacy (см. legacyTaskFolderNameForProfile).
11
+ */
12
+ export function taskFolderNameForProfile(profile = getProfileName()) {
13
+ return profile === "default" ? "agent-steward" : `agent-steward-${profile}`;
14
+ }
15
+ /** Историческое имя папки/блока задач — для чтения и удаления старых задач. */
16
+ export function legacyTaskFolderNameForProfile(profile = getProfileName()) {
17
+ return profile === "default" ? "windows-scheduler" : `windows-scheduler-${profile}`;
18
+ }
19
+ export const TASK_FOLDER_NAME = taskFolderNameForProfile();
20
+ export const LEGACY_TASK_FOLDER_NAME = legacyTaskFolderNameForProfile();
21
+ /** Префикс всех задач плагина. */
22
+ export const TASK_PREFIX = `OpenCode\\${TASK_FOLDER_NAME}`;
23
+ /** Исторический префикс задач (до переименования). */
24
+ export const LEGACY_TASK_PREFIX = `OpenCode\\${LEGACY_TASK_FOLDER_NAME}`;
25
+ /**
26
+ * Директория для хранения файлов плагина (обёртки, логи, блокировки, история).
27
+ *
28
+ * Windows: %APPDATA%\opencode\windows-scheduler (как раньше — без миграции).
29
+ * macOS/Linux: $XDG_CONFIG_HOME/opencode/windows-scheduler или
30
+ * ~/.config/opencode/windows-scheduler.
31
+ * Спринт 21: директория зависит от активного профиля (см. src/profiles.ts).
32
+ */
33
+ function resolvePluginDir() {
34
+ return getProfileDir(getProfileName());
35
+ }
36
+ export const PLUGIN_DIR = resolvePluginDir();
37
+ export const LOCK_DIR = path.join(PLUGIN_DIR, "locks");
38
+ export const LOG_DIR = path.join(PLUGIN_DIR, "logs");
39
+ export const WRAPPER_DIR = path.join(PLUGIN_DIR, "wrappers");
40
+ /** true, если плагин запущен на Windows. */
41
+ export const IS_WINDOWS = process.platform === "win32";
42
+ /** Порог возраста lock-файла, после которого он считается зависшим (24 часа). */
43
+ export const STALE_LOCK_MAX_AGE_MS = 24 * 60 * 60 * 1000;
44
+ /**
45
+ * Приводит имя задачи к безопасному виду для имён файлов (обёртка, промпт, lock, лог).
46
+ * Кириллица транслитерируется, прочие спецсимволы заменяются на дефис.
47
+ * Используется единообразно при создании задачи (index.ts) и при чтении логов (schtasks.ts).
48
+ */
49
+ export function sanitizeName(name) {
50
+ const translit = {
51
+ а: "a", б: "b", в: "v", г: "g", д: "d", е: "e", ё: "e",
52
+ ж: "zh", з: "z", и: "i", й: "y", к: "k", л: "l", м: "m",
53
+ н: "n", о: "o", п: "p", р: "r", с: "s", т: "t", у: "u",
54
+ ф: "f", х: "h", ц: "ts", ч: "ch", ш: "sh", щ: "sch",
55
+ ъ: "", ы: "y", ь: "", э: "e", ю: "yu", я: "ya",
56
+ };
57
+ let result = name.toLowerCase();
58
+ result = result.split("").map((c) => translit[c] || c).join("");
59
+ result = result.replace(/[^a-z0-9_\-]/g, "-");
60
+ result = result.replace(/-+/g, "-").replace(/^-+|-+$/g, "");
61
+ return result || "task";
62
+ }
63
+ /**
64
+ * Проверяет идентификатор LLM-модели перед подстановкой в командную строку.
65
+ *
66
+ * Формат: `provider/model` (вариант — `provider/model#variant`).
67
+ * Разрешены только латиница, цифры и символы `. _ : / -` (плюс `#` для
68
+ * варианта). Это исключает PowerShell-subexpression (`$(...)`, backtick)
69
+ * и прочие спецсимволы. Пустая строка — «модель не задана», это допустимо.
70
+ *
71
+ * @returns текст ошибки или null, если значение допустимо.
72
+ */
73
+ export function validateModelId(raw) {
74
+ const model = raw.trim();
75
+ if (!model)
76
+ return null;
77
+ if (!/^[A-Za-z0-9._:/-]+(?:#[A-Za-z0-9._-]+)?$/.test(model)) {
78
+ return (`Недопустимый идентификатор модели «${raw}». ` +
79
+ "Разрешены латиница, цифры и символы «.», «_», «:», «/», «-» " +
80
+ "(вариант — через «#»).");
81
+ }
82
+ return null;
83
+ }
84
+ /**
85
+ * Проверяет имя задачи до создания файлов и записи в БД.
86
+ *
87
+ * Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».
88
+ * Спецсимволы оболочки (`& | < > ^ % " ' ; ( ) \``, обратный слэш, слэш)
89
+ * и управляющие символы запрещены: даже при безопасном вызове schtasks
90
+ * такие имена ломают пути файлов и переносимы между платформами.
91
+ *
92
+ * @returns текст ошибки или null, если имя допустимо.
93
+ */
94
+ export function validateTaskName(raw) {
95
+ const name = raw.trim();
96
+ if (!name) {
97
+ return "Имя задачи не может быть пустым.";
98
+ }
99
+ if (/[\u0000-\u001f\u007f]/.test(name)) {
100
+ return "Имя задачи не должно содержать управляющие символы.";
101
+ }
102
+ const invalid = /[^\p{L}\p{N}_\-. ]/u.exec(name);
103
+ if (invalid) {
104
+ return (`Имя задачи содержит недопустимый символ «${invalid[0]}». ` +
105
+ "Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».");
106
+ }
107
+ // schtasks ограничивает /tn в 237 символов вместе с полным путём задачи.
108
+ // Полный путь: \OpenCode\<TASK_FOLDER_NAME>\<taskName>
109
+ // leading \ + TASK_FOLDER + \ + TASK_FOLDER_NAME + \ — префикс перед именем задачи.
110
+ // Для default: \OpenCode\agent-steward\ = 24 символа → 213 на имя.
111
+ // Для не-default профиля: \OpenCode\agent-steward-<profile>\ → чем длиннее профиль, тем меньше места.
112
+ const prefixLength = 1 + TASK_FOLDER.length + 1 + TASK_FOLDER_NAME.length + 1;
113
+ const MAX_TASK_NAME_LENGTH = 237 - prefixLength;
114
+ if (name.length > MAX_TASK_NAME_LENGTH) {
115
+ return (`Имя задачи "${name}" слишком длинное (${name.length} символов, максимум ${MAX_TASK_NAME_LENGTH} ` +
116
+ "с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).");
117
+ }
118
+ return null;
119
+ }
120
+ /**
121
+ * Схема аргументов для schedule_job.
122
+ * schedule принимает только 5-полевые cron-выражения.
123
+ */
124
+ export const ScheduleJobArgs = z.object({
125
+ name: z
126
+ .string()
127
+ .min(1)
128
+ .superRefine((value, ctx) => {
129
+ const error = validateTaskName(value);
130
+ if (error) {
131
+ ctx.addIssue({ code: z.ZodIssueCode.custom, message: error });
132
+ }
133
+ })
134
+ .describe("Имя задачи (уникально в рамках префикса OpenCode\\agent-steward; legacy OpenCode\\windows-scheduler поддерживается)"),
135
+ schedule: z
136
+ .string()
137
+ .min(1)
138
+ .describe("5-полевое cron-выражение (минута час день_месяца месяц день_недели)"),
139
+ prompt: z.string().min(1).describe("Промпт, который передаётся в opencode run при запуске задачи"),
140
+ timeoutSeconds: z
141
+ .number()
142
+ .int()
143
+ .positive()
144
+ .optional()
145
+ .default(3600)
146
+ .describe("Таймаут выполнения задачи в секундах (по умолчанию 3600)"),
147
+ workdir: z
148
+ .string()
149
+ .optional()
150
+ .describe("Рабочая директория для выполнения opencode run (по умолчанию текущая)"),
151
+ });
152
+ export const DeleteJobArgs = z.object({
153
+ name: z.string().min(1).describe("Имя задачи для удаления"),
154
+ });
155
+ export const RunJobNowArgs = z.object({
156
+ name: z.string().min(1).describe("Имя задачи для немедленного запуска"),
157
+ });
158
+ export const ListJobsArgs = z.object({});
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Версия плагина из package.json.
3
+ *
4
+ * Читается в рантайме из корня пакета рядом со скомпилированным модулем
5
+ * (dist/version.js -> ../package.json). Если файл недоступен — «unknown».
6
+ */
7
+ export declare function getPluginVersion(): string;
8
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAczC"}
@@ -0,0 +1,27 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { fileURLToPath } from "node:url";
4
+ let cached = null;
5
+ /**
6
+ * Версия плагина из package.json.
7
+ *
8
+ * Читается в рантайме из корня пакета рядом со скомпилированным модулем
9
+ * (dist/version.js -> ../package.json). Если файл недоступен — «unknown».
10
+ */
11
+ export function getPluginVersion() {
12
+ if (cached)
13
+ return cached;
14
+ try {
15
+ const here = path.dirname(fileURLToPath(import.meta.url));
16
+ const raw = fs.readFileSync(path.join(here, "..", "package.json"), "utf8");
17
+ const pkg = JSON.parse(raw);
18
+ cached =
19
+ typeof pkg.version === "string" && pkg.version.trim()
20
+ ? pkg.version.trim()
21
+ : "unknown";
22
+ }
23
+ catch {
24
+ cached = "unknown";
25
+ }
26
+ return cached;
27
+ }
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Multi-repo workspaces.
3
+ *
4
+ * Одна задача = один workspace = один cwd. Workspace — это просто
5
+ * зарегистрированный путь к репозиторию; плагин никогда не «угадывает»,
6
+ * куда мержить и не выполняет cross-repo операции самостоятельно.
7
+ */
8
+ export interface Workspace {
9
+ id: string;
10
+ name: string;
11
+ path: string;
12
+ gitRemote?: string;
13
+ color?: string;
14
+ /** Env-переменные workspace (Спринт 21). Значения хранятся как есть. */
15
+ env?: Record<string, string>;
16
+ /** Путь к .env-файлу, переменные которого подмешиваются к env (Спринт 21). */
17
+ envFile?: string;
18
+ createdAt: string;
19
+ }
20
+ export interface AddWorkspaceInput {
21
+ name?: string;
22
+ path: string;
23
+ color?: string;
24
+ env?: Record<string, string> | null;
25
+ envFile?: string | null;
26
+ }
27
+ export interface UpdateWorkspacePatch {
28
+ name?: string;
29
+ path?: string;
30
+ color?: string;
31
+ gitRemote?: string | null;
32
+ env?: Record<string, string> | null;
33
+ envFile?: string | null;
34
+ }
35
+ /** Максимум пар env на workspace — защита от раздувания строки JSON. */
36
+ export declare const MAX_WORKSPACE_ENV_PAIRS = 100;
37
+ /** Палитра цветных маркеров для GUI/дашборда. */
38
+ export declare const WORKSPACE_COLORS: string[];
39
+ /**
40
+ * Нормализует пары env: ключи — валидные имена переменных, значения — строки.
41
+ * Бросает понятную ошибку при нарушении (её показывает GUI/RPC).
42
+ */
43
+ export declare function normalizeWorkspaceEnv(value: unknown): Record<string, string> | undefined;
44
+ /**
45
+ * Разбирает содержимое .env: строки KEY=VALUE, комментарии `#`, пустые строки,
46
+ * префикс `export `, кавычки вокруг значения снимаются.
47
+ */
48
+ export declare function parseEnvFileContent(content: string): Record<string, string>;
49
+ /** Читает .env-файл workspace (если он задан и существует). */
50
+ export declare function readWorkspaceEnvFile(envFile?: string): Record<string, string>;
51
+ /**
52
+ * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
53
+ * (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
54
+ * зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
55
+ * строку и предупреждение с именем — без значения. Никогда не бросает.
56
+ */
57
+ export declare function resolveWorkspaceEnv(workspace: Workspace | undefined, allowedSecretNames?: string[]): Record<string, string>;
58
+ /** Маскирует значение секрета для логов. */
59
+ export declare function maskSecretValue(): string;
60
+ /**
61
+ * Копия env для логов: значения «секретных» ключей заменены на ***.
62
+ * Чистые ссылки `${secret:NAME}` сохраняются как есть — это не секрет,
63
+ * а указатель, и он помогает диагностике (Спринт 26).
64
+ */
65
+ export declare function maskEnvForLog(env: Record<string, string> | undefined): Record<string, string>;
66
+ /**
67
+ * Каталог env-файлов задач внутри каталога плагина (по одному файлу на задачу).
68
+ * Файлы содержат реальные значения и не попадают в git/логи.
69
+ */
70
+ export declare function workspaceEnvDir(pluginDir: string): string;
71
+ /**
72
+ * Пишет env-файл задачи в формате KEY=VALUE (Спринт 21).
73
+ *
74
+ * Возвращает путь к файлу или undefined, если у workspace нет переменных.
75
+ * Пустой env удаляет ранее созданный файл. На POSIX права 0600.
76
+ */
77
+ export declare function writeWorkspaceEnvFile(workspace: Workspace | undefined, pluginDir: string, sanitizedName: string, allowedSecretNames?: string[]): string | undefined;
78
+ /** Проверяет, что путь существует и является директорией. */
79
+ export declare function validateWorkspacePath(workspacePath: string): void;
80
+ /**
81
+ * Валидация отображаемого имени workspace.
82
+ *
83
+ * Имя не участвует в путях напрямую (для клонов matrix используется
84
+ * sanitizeName), но попадает в логи и dashboard, поэтому запрещаем
85
+ * управляющие символы, переводы строк и слишком длинные значения.
86
+ * Кириллица разрешена.
87
+ */
88
+ export declare function validateWorkspaceName(value: string): string | null;
89
+ /**
90
+ * Читает git remote origin. Если путь не git-репозиторий или remote не
91
+ * настроен — возвращает undefined (это не ошибка).
92
+ */
93
+ export declare function readGitRemote(workspacePath: string): string | undefined;
94
+ /** Текущая git-ветка (для dry-run preview); undefined вне git-репозитория. */
95
+ export declare function readGitBranch(workspacePath: string): string | undefined;
96
+ /** Все workspace (по имени). */
97
+ export declare function listWorkspaces(): Workspace[];
98
+ /** Workspace по id. */
99
+ export declare function getWorkspace(id: string): Workspace | undefined;
100
+ /** Workspace по пути (без учёта регистра, как в Windows). */
101
+ export declare function getWorkspaceByPath(workspacePath: string): Workspace | undefined;
102
+ /** Регистрирует новый workspace. Путь должен существовать. */
103
+ export declare function addWorkspace(input: AddWorkspaceInput): Workspace;
104
+ /** Обновляет имя/путь/цвет workspace. */
105
+ export declare function updateWorkspace(id: string, patch: UpdateWorkspacePatch): Workspace;
106
+ /**
107
+ * Удаляет workspace. Задачи не удаляются — у них просто очищается
108
+ * workspaceId (с предупреждением в логе).
109
+ */
110
+ export declare function deleteWorkspace(id: string): boolean;
111
+ /** Количество workspace (для сводок и тестов). */
112
+ export declare function countWorkspaces(): number;
113
+ //# sourceMappingURL=workspaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}