agent-steward 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (333) hide show
  1. package/CHANGELOG.md +376 -0
  2. package/CROSS_PLATFORM.md +149 -0
  3. package/README.md +306 -15
  4. package/ROADMAP-STRATEGY.md +147 -0
  5. package/ROADMAP.md +1069 -0
  6. package/dist/core/analytics.d.ts +132 -0
  7. package/dist/core/analytics.d.ts.map +1 -0
  8. package/dist/core/analytics.js +290 -0
  9. package/dist/core/audit.d.ts +96 -0
  10. package/dist/core/audit.d.ts.map +1 -0
  11. package/dist/core/audit.js +297 -0
  12. package/dist/core/cron-to-schtasks.d.ts +20 -0
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  14. package/dist/core/cron-to-schtasks.js +250 -0
  15. package/dist/core/dry-run.d.ts +102 -0
  16. package/dist/core/dry-run.d.ts.map +1 -0
  17. package/dist/core/dry-run.js +447 -0
  18. package/dist/core/file-watcher.d.ts +31 -0
  19. package/dist/core/file-watcher.d.ts.map +1 -0
  20. package/dist/core/file-watcher.js +186 -0
  21. package/dist/core/git-trigger.d.ts +82 -0
  22. package/dist/core/git-trigger.d.ts.map +1 -0
  23. package/dist/core/git-trigger.js +312 -0
  24. package/dist/core/glob.d.ts +38 -0
  25. package/dist/core/glob.d.ts.map +1 -0
  26. package/dist/core/glob.js +233 -0
  27. package/dist/core/local-ai.d.ts +52 -0
  28. package/dist/core/local-ai.d.ts.map +1 -0
  29. package/dist/core/local-ai.js +119 -0
  30. package/dist/core/lock.d.ts +57 -0
  31. package/dist/core/lock.d.ts.map +1 -0
  32. package/dist/core/lock.js +195 -0
  33. package/dist/core/matrix.d.ts +167 -0
  34. package/dist/core/matrix.d.ts.map +1 -0
  35. package/dist/core/matrix.js +724 -0
  36. package/dist/core/native-notify.d.ts +36 -0
  37. package/dist/core/native-notify.d.ts.map +1 -0
  38. package/dist/core/native-notify.js +113 -0
  39. package/dist/core/one-shot.d.ts +68 -0
  40. package/dist/core/one-shot.d.ts.map +1 -0
  41. package/dist/core/one-shot.js +139 -0
  42. package/dist/core/otel.d.ts +4 -0
  43. package/dist/core/otel.d.ts.map +1 -0
  44. package/dist/core/otel.js +98 -0
  45. package/dist/core/permissions.d.ts +69 -0
  46. package/dist/core/permissions.d.ts.map +1 -0
  47. package/dist/core/permissions.js +143 -0
  48. package/dist/core/prometheus.d.ts +23 -0
  49. package/dist/core/prometheus.d.ts.map +1 -0
  50. package/dist/core/prometheus.js +146 -0
  51. package/dist/core/ps-wrapper.d.ts +73 -0
  52. package/dist/core/ps-wrapper.d.ts.map +1 -0
  53. package/dist/core/ps-wrapper.js +1071 -0
  54. package/dist/core/record-history.d.ts +25 -0
  55. package/dist/core/record-history.d.ts.map +1 -0
  56. package/dist/core/record-history.js +471 -0
  57. package/dist/core/retention.d.ts +29 -0
  58. package/dist/core/retention.d.ts.map +1 -0
  59. package/dist/core/retention.js +98 -0
  60. package/dist/core/savings.d.ts +70 -0
  61. package/dist/core/savings.d.ts.map +1 -0
  62. package/dist/core/savings.js +87 -0
  63. package/dist/core/schedule-gate.d.ts +2 -0
  64. package/dist/core/schedule-gate.d.ts.map +1 -0
  65. package/dist/core/schedule-gate.js +211 -0
  66. package/dist/core/schedule-v2.d.ts +116 -0
  67. package/dist/core/schedule-v2.d.ts.map +1 -0
  68. package/dist/core/schedule-v2.js +586 -0
  69. package/dist/core/scheduler/index.d.ts +32 -0
  70. package/dist/core/scheduler/index.d.ts.map +1 -0
  71. package/dist/core/scheduler/index.js +63 -0
  72. package/dist/core/scheduler/linux.d.ts +44 -0
  73. package/dist/core/scheduler/linux.d.ts.map +1 -0
  74. package/dist/core/scheduler/linux.js +225 -0
  75. package/dist/core/scheduler/logs.d.ts +11 -0
  76. package/dist/core/scheduler/logs.d.ts.map +1 -0
  77. package/dist/core/scheduler/logs.js +34 -0
  78. package/dist/core/scheduler/mac.d.ts +40 -0
  79. package/dist/core/scheduler/mac.d.ts.map +1 -0
  80. package/dist/core/scheduler/mac.js +207 -0
  81. package/dist/core/scheduler/posix.d.ts +40 -0
  82. package/dist/core/scheduler/posix.d.ts.map +1 -0
  83. package/dist/core/scheduler/posix.js +89 -0
  84. package/dist/core/scheduler/registry.d.ts +41 -0
  85. package/dist/core/scheduler/registry.d.ts.map +1 -0
  86. package/dist/core/scheduler/registry.js +57 -0
  87. package/dist/core/scheduler/types.d.ts +86 -0
  88. package/dist/core/scheduler/types.d.ts.map +1 -0
  89. package/dist/core/scheduler/types.js +1 -0
  90. package/dist/core/scheduler/windows.d.ts +99 -0
  91. package/dist/core/scheduler/windows.d.ts.map +1 -0
  92. package/dist/core/scheduler/windows.js +596 -0
  93. package/dist/core/secrets.d.ts +66 -0
  94. package/dist/core/secrets.d.ts.map +1 -0
  95. package/dist/core/secrets.js +433 -0
  96. package/dist/core/self-analysis.d.ts +117 -0
  97. package/dist/core/self-analysis.d.ts.map +1 -0
  98. package/dist/core/self-analysis.js +539 -0
  99. package/dist/core/self-analysis.test.d.ts +2 -0
  100. package/dist/core/self-analysis.test.d.ts.map +1 -0
  101. package/dist/core/self-analysis.test.js +219 -0
  102. package/dist/core/session.d.ts +42 -0
  103. package/dist/core/session.d.ts.map +1 -0
  104. package/dist/core/session.js +134 -0
  105. package/dist/core/shutdown.d.ts +26 -0
  106. package/dist/core/shutdown.d.ts.map +1 -0
  107. package/dist/core/shutdown.js +49 -0
  108. package/dist/core/structured-log.d.ts +84 -0
  109. package/dist/core/structured-log.d.ts.map +1 -0
  110. package/dist/core/structured-log.js +146 -0
  111. package/dist/core/summary.d.ts +69 -0
  112. package/dist/core/summary.d.ts.map +1 -0
  113. package/dist/core/summary.js +250 -0
  114. package/dist/core/telegram.d.ts +55 -0
  115. package/dist/core/telegram.d.ts.map +1 -0
  116. package/dist/core/telegram.js +344 -0
  117. package/dist/core/triage-chain.d.ts +40 -0
  118. package/dist/core/triage-chain.d.ts.map +1 -0
  119. package/dist/core/triage-chain.js +80 -0
  120. package/dist/core/triage-compare.d.ts +68 -0
  121. package/dist/core/triage-compare.d.ts.map +1 -0
  122. package/dist/core/triage-compare.js +184 -0
  123. package/dist/core/triage-rules.d.ts +23 -0
  124. package/dist/core/triage-rules.d.ts.map +1 -0
  125. package/dist/core/triage-rules.js +196 -0
  126. package/dist/core/triage-shadow.d.ts +91 -0
  127. package/dist/core/triage-shadow.d.ts.map +1 -0
  128. package/dist/core/triage-shadow.js +160 -0
  129. package/dist/core/triage-worker.d.ts +55 -0
  130. package/dist/core/triage-worker.d.ts.map +1 -0
  131. package/dist/core/triage-worker.js +314 -0
  132. package/dist/core/triage.d.ts +76 -0
  133. package/dist/core/triage.d.ts.map +1 -0
  134. package/dist/core/triage.js +271 -0
  135. package/dist/core/watch-paths.d.ts +6 -0
  136. package/dist/core/watch-paths.d.ts.map +1 -0
  137. package/dist/core/watch-paths.js +62 -0
  138. package/dist/core/wrappers/bash.d.ts +95 -0
  139. package/dist/core/wrappers/bash.d.ts.map +1 -0
  140. package/dist/core/wrappers/bash.js +413 -0
  141. package/dist/db/git-state-repo.d.ts +16 -0
  142. package/dist/db/git-state-repo.d.ts.map +1 -0
  143. package/dist/db/git-state-repo.js +38 -0
  144. package/dist/db/history-repo.d.ts +110 -0
  145. package/dist/db/history-repo.d.ts.map +1 -0
  146. package/dist/db/history-repo.js +300 -0
  147. package/dist/db/index.d.ts +47 -0
  148. package/dist/db/index.d.ts.map +1 -0
  149. package/dist/db/index.js +120 -0
  150. package/dist/db/metrics-repo.d.ts +46 -0
  151. package/dist/db/metrics-repo.d.ts.map +1 -0
  152. package/dist/db/metrics-repo.js +103 -0
  153. package/dist/db/migrate.d.ts +24 -0
  154. package/dist/db/migrate.d.ts.map +1 -0
  155. package/dist/db/migrate.js +244 -0
  156. package/dist/db/recovery.d.ts +11 -0
  157. package/dist/db/recovery.d.ts.map +1 -0
  158. package/dist/db/recovery.js +38 -0
  159. package/dist/db/schema.d.ts +24 -0
  160. package/dist/db/schema.d.ts.map +1 -0
  161. package/dist/db/schema.js +170 -0
  162. package/dist/db/settings-repo.d.ts +8 -0
  163. package/dist/db/settings-repo.d.ts.map +1 -0
  164. package/dist/db/settings-repo.js +27 -0
  165. package/dist/db/tasks-repo.d.ts +26 -0
  166. package/dist/db/tasks-repo.d.ts.map +1 -0
  167. package/dist/db/tasks-repo.js +120 -0
  168. package/dist/db/templates-repo.d.ts +17 -0
  169. package/dist/db/templates-repo.d.ts.map +1 -0
  170. package/dist/db/templates-repo.js +57 -0
  171. package/dist/gui-experimental.cjs +1 -0
  172. package/dist/history.d.ts +60 -0
  173. package/dist/history.d.ts.map +1 -0
  174. package/dist/history.js +70 -0
  175. package/dist/i18n.d.ts +75 -0
  176. package/dist/i18n.d.ts.map +1 -0
  177. package/dist/i18n.js +357 -0
  178. package/dist/index.d.ts +858 -0
  179. package/dist/index.d.ts.map +1 -0
  180. package/dist/index.js +5179 -0
  181. package/dist/integrations.d.ts +72 -0
  182. package/dist/integrations.d.ts.map +1 -0
  183. package/dist/integrations.js +233 -0
  184. package/dist/notifications.d.ts +199 -0
  185. package/dist/notifications.d.ts.map +1 -0
  186. package/dist/notifications.js +967 -0
  187. package/dist/profiles.d.ts +60 -0
  188. package/dist/profiles.d.ts.map +1 -0
  189. package/dist/profiles.js +227 -0
  190. package/dist/rpc.d.ts +3806 -0
  191. package/dist/rpc.d.ts.map +1 -0
  192. package/dist/rpc.js +1507 -0
  193. package/dist/schtasks.d.ts +32 -0
  194. package/dist/schtasks.d.ts.map +1 -0
  195. package/dist/schtasks.js +45 -0
  196. package/dist/server.d.ts +128 -0
  197. package/dist/server.d.ts.map +1 -0
  198. package/dist/server.js +2413 -0
  199. package/dist/settings.d.ts +389 -0
  200. package/dist/settings.d.ts.map +1 -0
  201. package/dist/settings.js +770 -0
  202. package/dist/shared/jobs-view.d.ts +59 -0
  203. package/dist/shared/jobs-view.d.ts.map +1 -0
  204. package/dist/shared/jobs-view.js +146 -0
  205. package/dist/skill.d.ts +15 -0
  206. package/dist/skill.d.ts.map +1 -0
  207. package/dist/skill.js +93 -0
  208. package/dist/task-transfer.d.ts +252 -0
  209. package/dist/task-transfer.d.ts.map +1 -0
  210. package/dist/task-transfer.js +628 -0
  211. package/dist/templates.d.ts +57 -0
  212. package/dist/templates.d.ts.map +1 -0
  213. package/dist/templates.js +16 -0
  214. package/dist/types.d.ts +96 -0
  215. package/dist/types.d.ts.map +1 -0
  216. package/dist/types.js +130 -0
  217. package/dist/version.d.ts +8 -0
  218. package/dist/version.d.ts.map +1 -0
  219. package/dist/version.js +27 -0
  220. package/dist/workspaces.d.ts +113 -0
  221. package/dist/workspaces.d.ts.map +1 -0
  222. package/dist/workspaces.js +393 -0
  223. package/docs/ARCHITECTURE.md +457 -0
  224. package/docs/COMPATIBILITY.md +233 -0
  225. package/docs/CONCEPT.md +230 -0
  226. package/docs/CROSS_PLATFORM.ru.md +150 -0
  227. package/docs/CROSS_PLATFORM.zh.md +146 -0
  228. package/docs/FAQ.md +52 -0
  229. package/docs/FAQ.ru.md +53 -0
  230. package/docs/FAQ.zh.md +43 -0
  231. package/docs/FEATURES.md +698 -0
  232. package/docs/FEATURES.zh.md +655 -0
  233. package/docs/LOCAL-AI.md +300 -0
  234. package/docs/MIGRATION.md +355 -0
  235. package/docs/README.ru.md +268 -0
  236. package/docs/README.zh.md +305 -0
  237. package/docs/SAVINGS.md +61 -0
  238. package/docs/SAVINGS.ru.md +60 -0
  239. package/docs/SAVINGS.zh.md +52 -0
  240. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  241. package/docs/ZH-LOCALE-PLAN.md +324 -0
  242. package/docs/dashboard.png +0 -0
  243. package/docs/spikes/local-model-structured-output.md +81 -0
  244. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  245. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  246. package/gui-experimental.cjs +9 -0
  247. package/index.js +1 -0
  248. package/locales/en.json +780 -0
  249. package/locales/ru.json +780 -0
  250. package/locales/zh.json +780 -0
  251. package/package.json +133 -13
  252. package/scripts/bench-local.mjs +321 -0
  253. package/scripts/check-zh-locale.mjs +218 -0
  254. package/scripts/demo-dashboard.mjs +209 -0
  255. package/scripts/run-tests.mjs +236 -0
  256. package/scripts/spike-local-structured.mjs +182 -0
  257. package/scripts/test-locale.mjs +45 -0
  258. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  259. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  260. package/src/core/analytics.ts +424 -0
  261. package/src/core/audit.ts +418 -0
  262. package/src/core/cron-to-schtasks.ts +288 -0
  263. package/src/core/dry-run.ts +601 -0
  264. package/src/core/file-watcher.ts +245 -0
  265. package/src/core/git-trigger.ts +391 -0
  266. package/src/core/glob.ts +226 -0
  267. package/src/core/local-ai.ts +173 -0
  268. package/src/core/lock.ts +219 -0
  269. package/src/core/matrix.ts +947 -0
  270. package/src/core/native-notify.ts +157 -0
  271. package/src/core/one-shot.ts +189 -0
  272. package/src/core/otel.ts +128 -0
  273. package/src/core/permissions.ts +200 -0
  274. package/src/core/prometheus.ts +215 -0
  275. package/src/core/ps-wrapper.ts +1140 -0
  276. package/src/core/record-history.ts +615 -0
  277. package/src/core/retention.ts +141 -0
  278. package/src/core/savings.ts +150 -0
  279. package/src/core/schedule-gate.ts +253 -0
  280. package/src/core/schedule-v2.ts +668 -0
  281. package/src/core/scheduler/index.ts +82 -0
  282. package/src/core/scheduler/linux.ts +257 -0
  283. package/src/core/scheduler/logs.ts +37 -0
  284. package/src/core/scheduler/mac.ts +270 -0
  285. package/src/core/scheduler/posix.ts +114 -0
  286. package/src/core/scheduler/registry.ts +99 -0
  287. package/src/core/scheduler/types.ts +90 -0
  288. package/src/core/scheduler/windows.ts +711 -0
  289. package/src/core/secrets.ts +503 -0
  290. package/src/core/self-analysis.ts +744 -0
  291. package/src/core/session.ts +150 -0
  292. package/src/core/shutdown.ts +69 -0
  293. package/src/core/structured-log.ts +214 -0
  294. package/src/core/summary.ts +318 -0
  295. package/src/core/telegram.ts +436 -0
  296. package/src/core/triage-chain.ts +125 -0
  297. package/src/core/triage-compare.ts +277 -0
  298. package/src/core/triage-rules.ts +238 -0
  299. package/src/core/triage-shadow.ts +240 -0
  300. package/src/core/triage-worker.ts +344 -0
  301. package/src/core/triage.ts +366 -0
  302. package/src/core/watch-paths.ts +70 -0
  303. package/src/core/wrappers/bash.ts +532 -0
  304. package/src/db/git-state-repo.ts +62 -0
  305. package/src/db/history-repo.ts +492 -0
  306. package/src/db/index.ts +166 -0
  307. package/src/db/metrics-repo.ts +170 -0
  308. package/src/db/migrate.ts +328 -0
  309. package/src/db/recovery.ts +46 -0
  310. package/src/db/schema.ts +188 -0
  311. package/src/db/settings-repo.ts +31 -0
  312. package/src/db/tasks-repo.ts +162 -0
  313. package/src/db/templates-repo.ts +77 -0
  314. package/src/gui.tsx +5222 -0
  315. package/src/history.ts +128 -0
  316. package/src/i18n.ts +413 -0
  317. package/src/index.ts +6605 -0
  318. package/src/integrations.ts +297 -0
  319. package/src/notifications.ts +1346 -0
  320. package/src/profiles.ts +254 -0
  321. package/src/rpc.ts +1609 -0
  322. package/src/schtasks.ts +75 -0
  323. package/src/server.ts +2662 -0
  324. package/src/settings.ts +1369 -0
  325. package/src/shared/jobs-view.ts +188 -0
  326. package/src/skill.ts +113 -0
  327. package/src/task-transfer.ts +944 -0
  328. package/src/templates.ts +67 -0
  329. package/src/tui-v1.tsx +341 -0
  330. package/src/tui.tsx +329 -0
  331. package/src/types.ts +191 -0
  332. package/src/version.ts +27 -0
  333. package/src/workspaces.ts +487 -0
@@ -0,0 +1,393 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { chmodSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
3
+ import { basename, join, resolve } from "node:path";
4
+ import { spawnSync } from "node:child_process";
5
+ import { getDb } from "./db/index.js";
6
+ import { clearWorkspaceAssignments } from "./db/tasks-repo.js";
7
+ import { hasSecretRef, resolveSecretRefs } from "./core/secrets.js";
8
+ /** Максимум пар env на workspace — защита от раздувания строки JSON. */
9
+ export const MAX_WORKSPACE_ENV_PAIRS = 100;
10
+ /** Палитра цветных маркеров для GUI/дашборда. */
11
+ export const WORKSPACE_COLORS = [
12
+ "#5b8def",
13
+ "#2fb67c",
14
+ "#e0a03a",
15
+ "#d15c8a",
16
+ "#8b6fe8",
17
+ "#3aa8b8",
18
+ ];
19
+ const ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
20
+ /**
21
+ * Нормализует пары env: ключи — валидные имена переменных, значения — строки.
22
+ * Бросает понятную ошибку при нарушении (её показывает GUI/RPC).
23
+ */
24
+ export function normalizeWorkspaceEnv(value) {
25
+ if (value == null)
26
+ return undefined;
27
+ if (typeof value !== "object" || Array.isArray(value)) {
28
+ throw new Error("env должен быть объектом «ключ → значение».");
29
+ }
30
+ const entries = Object.entries(value);
31
+ if (entries.length > MAX_WORKSPACE_ENV_PAIRS) {
32
+ throw new Error(`Слишком много env-переменных: ${entries.length} (максимум ${MAX_WORKSPACE_ENV_PAIRS}).`);
33
+ }
34
+ const result = {};
35
+ for (const [rawKey, rawValue] of entries) {
36
+ const key = String(rawKey).trim();
37
+ if (!ENV_KEY_RE.test(key)) {
38
+ throw new Error(`Недопустимое имя env-переменной '${rawKey}': нужны латиница, цифры и '_', не с цифры.`);
39
+ }
40
+ if (rawValue == null) {
41
+ result[key] = "";
42
+ continue;
43
+ }
44
+ if (typeof rawValue === "object") {
45
+ throw new Error(`Значение env '${key}' должно быть строкой.`);
46
+ }
47
+ result[key] = String(rawValue);
48
+ }
49
+ return result;
50
+ }
51
+ /**
52
+ * Разбирает содержимое .env: строки KEY=VALUE, комментарии `#`, пустые строки,
53
+ * префикс `export `, кавычки вокруг значения снимаются.
54
+ */
55
+ export function parseEnvFileContent(content) {
56
+ const result = {};
57
+ for (const line of String(content).split(/\r?\n/)) {
58
+ const trimmed = line.trim();
59
+ if (!trimmed || trimmed.startsWith("#"))
60
+ continue;
61
+ const withoutExport = trimmed.startsWith("export ")
62
+ ? trimmed.slice("export ".length).trim()
63
+ : trimmed;
64
+ const eq = withoutExport.indexOf("=");
65
+ if (eq <= 0)
66
+ continue;
67
+ const key = withoutExport.slice(0, eq).trim();
68
+ if (!ENV_KEY_RE.test(key))
69
+ continue;
70
+ let value = withoutExport.slice(eq + 1).trim();
71
+ if ((value.startsWith('"') && value.endsWith('"') && value.length >= 2) ||
72
+ (value.startsWith("'") && value.endsWith("'") && value.length >= 2)) {
73
+ value = value.slice(1, -1);
74
+ }
75
+ result[key] = value;
76
+ }
77
+ return result;
78
+ }
79
+ /** Читает .env-файл workspace (если он задан и существует). */
80
+ export function readWorkspaceEnvFile(envFile) {
81
+ if (!envFile)
82
+ return {};
83
+ try {
84
+ return parseEnvFileContent(readFileSync(envFile, "utf8"));
85
+ }
86
+ catch {
87
+ return {};
88
+ }
89
+ }
90
+ /**
91
+ * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
92
+ * (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
93
+ * зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
94
+ * строку и предупреждение с именем — без значения. Никогда не бросает.
95
+ */
96
+ export function resolveWorkspaceEnv(workspace, allowedSecretNames) {
97
+ if (!workspace)
98
+ return {};
99
+ const merged = {
100
+ ...readWorkspaceEnvFile(workspace.envFile),
101
+ ...(workspace.env ?? {}),
102
+ };
103
+ const resolved = resolveSecretRefs(merged, allowedSecretNames);
104
+ if (resolved.missing.length > 0) {
105
+ console.warn(`[workspace] "${workspace.name}": не найдены секреты: ${resolved.missing.join(", ")}`);
106
+ }
107
+ return resolved.env;
108
+ }
109
+ /** Маскирует значение секрета для логов. */
110
+ export function maskSecretValue() {
111
+ return "***";
112
+ }
113
+ const SECRET_KEY_RE = /(TOKEN|SECRET|PASS|PASSWORD|KEY|CREDENTIAL|AUTH)/i;
114
+ /**
115
+ * Копия env для логов: значения «секретных» ключей заменены на ***.
116
+ * Чистые ссылки `${secret:NAME}` сохраняются как есть — это не секрет,
117
+ * а указатель, и он помогает диагностике (Спринт 26).
118
+ */
119
+ export function maskEnvForLog(env) {
120
+ if (!env)
121
+ return {};
122
+ const masked = {};
123
+ for (const [key, value] of Object.entries(env)) {
124
+ if (hasSecretRef(value)) {
125
+ masked[key] = String(value);
126
+ }
127
+ else {
128
+ masked[key] = SECRET_KEY_RE.test(key) ? maskSecretValue() : value;
129
+ }
130
+ }
131
+ return masked;
132
+ }
133
+ /**
134
+ * Каталог env-файлов задач внутри каталога плагина (по одному файлу на задачу).
135
+ * Файлы содержат реальные значения и не попадают в git/логи.
136
+ */
137
+ export function workspaceEnvDir(pluginDir) {
138
+ return join(pluginDir, "env");
139
+ }
140
+ /**
141
+ * Пишет env-файл задачи в формате KEY=VALUE (Спринт 21).
142
+ *
143
+ * Возвращает путь к файлу или undefined, если у workspace нет переменных.
144
+ * Пустой env удаляет ранее созданный файл. На POSIX права 0600.
145
+ */
146
+ export function writeWorkspaceEnvFile(workspace, pluginDir, sanitizedName, allowedSecretNames) {
147
+ if (!workspace)
148
+ return undefined;
149
+ const file = join(workspaceEnvDir(pluginDir), `${sanitizedName}.env`);
150
+ const env = resolveWorkspaceEnv(workspace, allowedSecretNames);
151
+ const keys = Object.keys(env);
152
+ if (!keys.length) {
153
+ try {
154
+ rmSync(file, { force: true });
155
+ }
156
+ catch {
157
+ // нечего удалять — не ошибка
158
+ }
159
+ return undefined;
160
+ }
161
+ const body = keys
162
+ .map((key) => `${key}=${String(env[key]).replace(/\r?\n/g, " ")}`)
163
+ .join("\n") + "\n";
164
+ mkdirSync(workspaceEnvDir(pluginDir), { recursive: true });
165
+ writeFileSync(file, body, { encoding: "utf8", mode: 0o600 });
166
+ if (process.platform !== "win32") {
167
+ try {
168
+ chmodSync(file, 0o600);
169
+ }
170
+ catch {
171
+ // права не критичны для работы задачи
172
+ }
173
+ }
174
+ return file;
175
+ }
176
+ function rowToWorkspace(row) {
177
+ let env;
178
+ if (row.env_json) {
179
+ try {
180
+ env = normalizeWorkspaceEnv(JSON.parse(String(row.env_json)));
181
+ }
182
+ catch {
183
+ env = undefined;
184
+ }
185
+ }
186
+ return {
187
+ id: String(row.id),
188
+ name: String(row.name),
189
+ path: String(row.path),
190
+ gitRemote: row.git_remote == null ? undefined : String(row.git_remote),
191
+ color: row.color == null ? undefined : String(row.color),
192
+ env,
193
+ envFile: row.env_file == null ? undefined : String(row.env_file),
194
+ createdAt: String(row.created_at),
195
+ };
196
+ }
197
+ function normalizePath(value) {
198
+ return resolve(value.trim());
199
+ }
200
+ /** Проверяет, что путь существует и является директорией. */
201
+ export function validateWorkspacePath(workspacePath) {
202
+ try {
203
+ const stat = statSync(workspacePath);
204
+ if (!stat.isDirectory())
205
+ throw new Error("not a directory");
206
+ }
207
+ catch {
208
+ throw new Error(`Путь workspace недоступен: ${workspacePath}`);
209
+ }
210
+ }
211
+ /**
212
+ * Валидация отображаемого имени workspace.
213
+ *
214
+ * Имя не участвует в путях напрямую (для клонов matrix используется
215
+ * sanitizeName), но попадает в логи и dashboard, поэтому запрещаем
216
+ * управляющие символы, переводы строк и слишком длинные значения.
217
+ * Кириллица разрешена.
218
+ */
219
+ export function validateWorkspaceName(value) {
220
+ const trimmed = (value ?? "").trim();
221
+ if (!trimmed)
222
+ return "Имя workspace не может быть пустым.";
223
+ if (trimmed.length > 64)
224
+ return "Имя workspace: не более 64 символов.";
225
+ if (/[\u0000-\u001f\u007f]/.test(trimmed)) {
226
+ return "Имя workspace не должно содержать управляющих символов и переводов строк.";
227
+ }
228
+ return null;
229
+ }
230
+ /**
231
+ * Читает git remote origin. Если путь не git-репозиторий или remote не
232
+ * настроен — возвращает undefined (это не ошибка).
233
+ */
234
+ export function readGitRemote(workspacePath) {
235
+ try {
236
+ const result = spawnSync("git", ["-C", workspacePath, "remote", "get-url", "origin"], {
237
+ encoding: "utf8",
238
+ timeout: 5000,
239
+ windowsHide: true,
240
+ });
241
+ if (result.status !== 0)
242
+ return undefined;
243
+ const remote = String(result.stdout || "").trim();
244
+ return remote || undefined;
245
+ }
246
+ catch {
247
+ return undefined;
248
+ }
249
+ }
250
+ /** Текущая git-ветка (для dry-run preview); undefined вне git-репозитория. */
251
+ export function readGitBranch(workspacePath) {
252
+ try {
253
+ const result = spawnSync("git", ["-C", workspacePath, "rev-parse", "--abbrev-ref", "HEAD"], { encoding: "utf8", timeout: 5000, windowsHide: true });
254
+ if (result.status !== 0)
255
+ return undefined;
256
+ const branch = String(result.stdout || "").trim();
257
+ return branch || undefined;
258
+ }
259
+ catch {
260
+ return undefined;
261
+ }
262
+ }
263
+ /** Все workspace (по имени). */
264
+ export function listWorkspaces() {
265
+ const rows = getDb()
266
+ .prepare("SELECT * FROM workspaces ORDER BY name COLLATE NOCASE ASC")
267
+ .all();
268
+ return rows.map(rowToWorkspace);
269
+ }
270
+ /** Workspace по id. */
271
+ export function getWorkspace(id) {
272
+ if (!id)
273
+ return undefined;
274
+ const row = getDb().prepare("SELECT * FROM workspaces WHERE id = ?").get(id);
275
+ return row ? rowToWorkspace(row) : undefined;
276
+ }
277
+ /** Workspace по пути (без учёта регистра, как в Windows). */
278
+ export function getWorkspaceByPath(workspacePath) {
279
+ const normalized = normalizePath(workspacePath);
280
+ const row = getDb()
281
+ .prepare("SELECT * FROM workspaces WHERE lower(path) = lower(?) LIMIT 1")
282
+ .get(normalized);
283
+ return row ? rowToWorkspace(row) : undefined;
284
+ }
285
+ /** Регистрирует новый workspace. Путь должен существовать. */
286
+ export function addWorkspace(input) {
287
+ const workspacePath = normalizePath(input.path || "");
288
+ if (!workspacePath) {
289
+ throw new Error("Путь workspace не может быть пустым.");
290
+ }
291
+ const name = (input.name || basename(workspacePath) || workspacePath).trim();
292
+ const nameError = validateWorkspaceName(name);
293
+ if (nameError)
294
+ throw new Error(nameError);
295
+ try {
296
+ validateWorkspacePath(workspacePath);
297
+ }
298
+ catch {
299
+ throw new Error(`Workspace '${name}' недоступен по пути '${workspacePath}'`);
300
+ }
301
+ const existing = getWorkspaceByPath(workspacePath);
302
+ if (existing) {
303
+ throw new Error(`Workspace с путём '${workspacePath}' уже существует.`);
304
+ }
305
+ const id = randomUUID();
306
+ const color = input.color?.trim() ||
307
+ WORKSPACE_COLORS[listWorkspaces().length % WORKSPACE_COLORS.length];
308
+ const createdAt = new Date().toISOString();
309
+ const gitRemote = readGitRemote(workspacePath);
310
+ const env = normalizeWorkspaceEnv(input.env);
311
+ const envFile = input.envFile?.trim() || undefined;
312
+ getDb()
313
+ .prepare(`INSERT INTO workspaces (id, name, path, git_remote, color, env_json, env_file, created_at)
314
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
315
+ .run(id, name, workspacePath, gitRemote ?? null, color, env ? JSON.stringify(env) : null, envFile ?? null, createdAt);
316
+ return { id, name, path: workspacePath, gitRemote, color, env, envFile, createdAt };
317
+ }
318
+ /** Обновляет имя/путь/цвет workspace. */
319
+ export function updateWorkspace(id, patch) {
320
+ const existing = getWorkspace(id);
321
+ if (!existing)
322
+ throw new Error(`Workspace '${id}' не найден.`);
323
+ const nextName = patch.name?.trim() || existing.name;
324
+ const nameError = validateWorkspaceName(nextName);
325
+ if (nameError)
326
+ throw new Error(nameError);
327
+ const nextPath = patch.path?.trim() ? normalizePath(patch.path) : existing.path;
328
+ if (nextPath !== existing.path) {
329
+ try {
330
+ validateWorkspacePath(nextPath);
331
+ }
332
+ catch {
333
+ throw new Error(`Workspace '${nextName}' недоступен по пути '${nextPath}'`);
334
+ }
335
+ const duplicate = getWorkspaceByPath(nextPath);
336
+ if (duplicate && duplicate.id !== id) {
337
+ throw new Error(`Workspace с путём '${nextPath}' уже существует.`);
338
+ }
339
+ }
340
+ const nextColor = patch.color?.trim() || existing.color;
341
+ const nextRemote = patch.gitRemote === null
342
+ ? undefined
343
+ : patch.gitRemote !== undefined
344
+ ? patch.gitRemote.trim() || undefined
345
+ : nextPath !== existing.path
346
+ ? readGitRemote(nextPath)
347
+ : existing.gitRemote;
348
+ const nextEnv = patch.env === null
349
+ ? undefined
350
+ : patch.env !== undefined
351
+ ? normalizeWorkspaceEnv(patch.env)
352
+ : existing.env;
353
+ const nextEnvFile = patch.envFile === null
354
+ ? undefined
355
+ : patch.envFile !== undefined
356
+ ? patch.envFile.trim() || undefined
357
+ : existing.envFile;
358
+ getDb()
359
+ .prepare("UPDATE workspaces SET name = ?, path = ?, git_remote = ?, color = ?, env_json = ?, env_file = ? WHERE id = ?")
360
+ .run(nextName, nextPath, nextRemote ?? null, nextColor ?? null, nextEnv ? JSON.stringify(nextEnv) : null, nextEnvFile ?? null, id);
361
+ return {
362
+ id,
363
+ name: nextName,
364
+ path: nextPath,
365
+ gitRemote: nextRemote,
366
+ color: nextColor,
367
+ env: nextEnv,
368
+ envFile: nextEnvFile,
369
+ createdAt: existing.createdAt,
370
+ };
371
+ }
372
+ /**
373
+ * Удаляет workspace. Задачи не удаляются — у них просто очищается
374
+ * workspaceId (с предупреждением в логе).
375
+ */
376
+ export function deleteWorkspace(id) {
377
+ const workspace = getWorkspace(id);
378
+ if (!workspace)
379
+ return false;
380
+ const affected = clearWorkspaceAssignments(id);
381
+ if (affected.length > 0) {
382
+ console.warn(`[workspace] Удалён workspace '${workspace.name}'. ` +
383
+ `Отвязано задач: ${affected.length} (${affected.join(", ")}). ` +
384
+ `Задачи не удалены, workspaceId очищен.`);
385
+ }
386
+ const result = getDb().prepare("DELETE FROM workspaces WHERE id = ?").run(id);
387
+ return Number(result.changes) > 0;
388
+ }
389
+ /** Количество workspace (для сводок и тестов). */
390
+ export function countWorkspaces() {
391
+ const row = getDb().prepare("SELECT COUNT(*) AS count FROM workspaces").get();
392
+ return Number(row?.count) || 0;
393
+ }