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,418 @@
1
+ import { getDb } from "../db/index.js";
2
+ import { redactSecretsInText } from "./secrets.js";
3
+ import {
4
+ resolvePermissions,
5
+ type PermissionPolicy,
6
+ } from "./permissions.js";
7
+
8
+ /**
9
+ * Журнал аудита мутаций (Спринт 26).
10
+ *
11
+ * Фиксирует кто, когда и через какой интерфейс создал / изменил / запустил /
12
+ * удалил задачу или настройки. Записи лежат в SQLite рядом с историей, поэтому
13
+ * аудит не зависит от файловых логов и переживает перезапуск. Любая ошибка
14
+ * записи проглатывается: аудит не должен ломать основную операцию.
15
+ */
16
+
17
+ export type AuditActor = "mcp" | "gui" | "http" | "system" | string;
18
+
19
+ export interface AuditEntryInput {
20
+ action: string;
21
+ targetType?: string | null;
22
+ target?: string | null;
23
+ actor: AuditActor;
24
+ /** Конкретный инструмент / RPC-метод / HTTP-маршрут. */
25
+ source?: string | null;
26
+ details?: unknown;
27
+ remote?: string | null;
28
+ /** Время события (ISO). По умолчанию — сейчас. */
29
+ ts?: string;
30
+ }
31
+
32
+ export interface AuditRecord {
33
+ id: number;
34
+ ts: string;
35
+ action: string;
36
+ targetType: string | null;
37
+ target: string | null;
38
+ actor: string;
39
+ source: string | null;
40
+ details: unknown;
41
+ remote: string | null;
42
+ }
43
+
44
+ export interface ReadAuditFilter {
45
+ action?: string;
46
+ target?: string;
47
+ actor?: string;
48
+ since?: string;
49
+ until?: string;
50
+ limit?: number;
51
+ }
52
+
53
+ export interface ReadAuditResult {
54
+ records: AuditRecord[];
55
+ total: number;
56
+ }
57
+
58
+ export const DEFAULT_AUDIT_RETENTION_DAYS = 90;
59
+ export const DEFAULT_AUDIT_MAX_RECORDS = 10_000;
60
+
61
+ const SENSITIVE_KEY_RE = /(TOKEN|SECRET|PASS|PASSWORD|PASSWD|API_?KEY|CREDENTIAL|AUTH)/i;
62
+ const PURE_SECRET_REF_RE = /^\$\{secret:[A-Za-z0-9_.-]{1,64}\}$/;
63
+
64
+ function looksLikeSecretRef(value: string): boolean {
65
+ return PURE_SECRET_REF_RE.test(value.trim());
66
+ }
67
+
68
+ /** Рекурсивно вычищает секреты из произвольной структуры details. */
69
+ export function redactAuditDetails(value: unknown, depth = 0): unknown {
70
+ if (depth > 8) return "[truncated]";
71
+ if (typeof value === "string") return redactSecretsInText(value);
72
+ if (value == null || typeof value !== "object") return value;
73
+ if (Array.isArray(value)) {
74
+ return value.slice(0, 200).map((item) => redactAuditDetails(item, depth + 1));
75
+ }
76
+ const result: Record<string, unknown> = {};
77
+ for (const [key, item] of Object.entries(value as Record<string, unknown>)) {
78
+ if (
79
+ typeof item === "string" &&
80
+ SENSITIVE_KEY_RE.test(key) &&
81
+ !looksLikeSecretRef(item)
82
+ ) {
83
+ result[key] = "***";
84
+ } else {
85
+ result[key] = redactAuditDetails(item, depth + 1);
86
+ }
87
+ }
88
+ return result;
89
+ }
90
+
91
+ function safeJson(value: unknown): string | null {
92
+ if (value === undefined || value === null) return null;
93
+ try {
94
+ return JSON.stringify(redactAuditDetails(value));
95
+ } catch {
96
+ return null;
97
+ }
98
+ }
99
+
100
+ let lastCleanupAt = 0;
101
+
102
+ /**
103
+ * Записывает событие аудита. Никогда не бросает исключение.
104
+ * Возвращает id записи или null при ошибке.
105
+ */
106
+ export function recordAudit(entry: AuditEntryInput): number | null {
107
+ try {
108
+ const ts = entry.ts ?? new Date().toISOString();
109
+ const result = getDb()
110
+ .prepare(
111
+ `INSERT INTO audit_log
112
+ (ts, action, target_type, target, actor, source, details_json, remote)
113
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
114
+ )
115
+ .run(
116
+ ts,
117
+ String(entry.action || "unknown").slice(0, 128),
118
+ entry.targetType == null ? null : String(entry.targetType).slice(0, 64),
119
+ entry.target == null ? null : String(entry.target).slice(0, 256),
120
+ String(entry.actor || "system").slice(0, 32),
121
+ entry.source == null ? null : String(entry.source).slice(0, 128),
122
+ safeJson(entry.details),
123
+ entry.remote == null ? null : String(entry.remote).slice(0, 128),
124
+ );
125
+ maybeCleanup();
126
+ return Number(result.lastInsertRowid) || null;
127
+ } catch (err) {
128
+ try {
129
+ console.warn(
130
+ `[audit] не удалось записать событие: ${
131
+ err instanceof Error ? err.message : String(err)
132
+ }`,
133
+ );
134
+ } catch {
135
+ // console недоступен — молча игнорируем.
136
+ }
137
+ return null;
138
+ }
139
+ }
140
+
141
+ /**
142
+ * Ленивая ротация: не чаще раза в час, лимиты по умолчанию. Точные лимиты из
143
+ * settings применяются в cleanupHistory / manage_settings.
144
+ */
145
+ function maybeCleanup(): void {
146
+ const now = Date.now();
147
+ if (now - lastCleanupAt < 60 * 60 * 1000) return;
148
+ lastCleanupAt = now;
149
+ try {
150
+ cleanupAuditLog({
151
+ retentionDays: DEFAULT_AUDIT_RETENTION_DAYS,
152
+ maxRecords: DEFAULT_AUDIT_MAX_RECORDS,
153
+ });
154
+ } catch {
155
+ // очистка не критична
156
+ }
157
+ }
158
+
159
+ function rowToRecord(row: any): AuditRecord {
160
+ let details: unknown = null;
161
+ if (row.details_json) {
162
+ try {
163
+ details = JSON.parse(String(row.details_json));
164
+ } catch {
165
+ details = String(row.details_json);
166
+ }
167
+ }
168
+ return {
169
+ id: Number(row.id),
170
+ ts: String(row.ts),
171
+ action: String(row.action),
172
+ targetType: row.target_type == null ? null : String(row.target_type),
173
+ target: row.target == null ? null : String(row.target),
174
+ actor: String(row.actor ?? "system"),
175
+ source: row.source == null ? null : String(row.source),
176
+ details,
177
+ remote: row.remote == null ? null : String(row.remote),
178
+ };
179
+ }
180
+
181
+ export interface ToolBlockedInput {
182
+ /** Имя задачи, для которой действует запрет. */
183
+ task: string;
184
+ /** Заблокированный инструмент (например, shell или write). */
185
+ tool: string;
186
+ actor?: AuditActor;
187
+ source?: string | null;
188
+ /** Дополнительные детали события; можно переопределить/дополнить. */
189
+ details?: Record<string, unknown>;
190
+ }
191
+
192
+ /**
193
+ * Записывает событие tool.blocked для задачи и инструмента.
194
+ *
195
+ * Детали события — обычный объект, поэтому вызывающая сторона может добавить
196
+ * причину, список разрешённых инструментов и любые другие поля.
197
+ * Возвращает id записи или null, если журнал недоступен.
198
+ */
199
+ export function recordToolBlocked(input: ToolBlockedInput): number | null {
200
+ return recordAudit({
201
+ action: "tool.blocked",
202
+ targetType: "task",
203
+ target: input.task,
204
+ actor: input.actor ?? "system",
205
+ source: input.source ?? "policy",
206
+ details: { tool: input.tool, ...(input.details ?? {}) },
207
+ });
208
+ }
209
+
210
+ /**
211
+ * Фиксирует запреты задачи из её политики allowedTools/deniedTools.
212
+ *
213
+ * Явно запрещённые инструменты попадают в аудит по одному событию на
214
+ * инструмент. Для режима «только разрешённые» пишется одно событие с
215
+ * инструментом `*`, потому что список заблокированных в этом режиме
216
+ * неограничен. Возвращает число записанных событий.
217
+ */
218
+ export function recordTaskToolBlocks(
219
+ task: string,
220
+ allowedTools: readonly string[] | null | undefined,
221
+ deniedTools: readonly string[] | null | undefined,
222
+ actor: AuditActor = "system",
223
+ source = "policy",
224
+ policy?: PermissionPolicy,
225
+ legacyShell?: boolean,
226
+ ): number {
227
+ const normalizedDenied = Array.from(
228
+ new Set(
229
+ (deniedTools ?? [])
230
+ .map((tool) => String(tool).trim())
231
+ .filter(Boolean),
232
+ ),
233
+ );
234
+ const normalizedAllowed = Array.from(
235
+ new Set(
236
+ (allowedTools ?? [])
237
+ .map((tool) => String(tool).trim())
238
+ .filter(Boolean),
239
+ ),
240
+ );
241
+ const details = {
242
+ reason: "deniedTools",
243
+ allowedTools: normalizedAllowed.length > 0 ? normalizedAllowed : null,
244
+ deniedTools: normalizedDenied.length > 0 ? normalizedDenied : null,
245
+ };
246
+ let written = 0;
247
+ for (const tool of normalizedDenied) {
248
+ if (recordToolBlocked({ task, tool, actor, source, details }) != null) {
249
+ written++;
250
+ }
251
+ }
252
+ if (normalizedDenied.length === 0 && normalizedAllowed.length > 0) {
253
+ if (
254
+ recordToolBlocked({
255
+ task,
256
+ tool: "*",
257
+ actor,
258
+ source,
259
+ details: {
260
+ reason: "allowedTools",
261
+ allowedTools: normalizedAllowed,
262
+ deniedTools: null,
263
+ },
264
+ }) != null
265
+ ) {
266
+ written++;
267
+ }
268
+ }
269
+ // Спринт 32 / релиз 1.6: фиксируем инструменты, запрещённые политикой по
270
+ // умолчанию (hybrid: shell/question; secure: ещё edit/webfetch/websearch/
271
+ // subagent). Это политика на момент сохранения задачи, а не попытки вызова:
272
+ // detached-обёртка не имеет доступа к SQLite.
273
+ if (policy) {
274
+ const effective = resolvePermissions({
275
+ policy,
276
+ legacyShell,
277
+ allowedTools: normalizedAllowed,
278
+ deniedTools: normalizedDenied,
279
+ });
280
+ for (const denied of effective.deniedByPolicy) {
281
+ if (
282
+ recordToolBlocked({
283
+ task,
284
+ tool: denied.action,
285
+ actor,
286
+ source,
287
+ details: {
288
+ reason: "default-policy",
289
+ policy: effective.policy,
290
+ legacyShell: effective.legacyShell,
291
+ hint: denied.hint,
292
+ allowedTools: normalizedAllowed.length > 0 ? normalizedAllowed : null,
293
+ deniedTools: normalizedDenied.length > 0 ? normalizedDenied : null,
294
+ },
295
+ }) != null
296
+ ) {
297
+ written++;
298
+ }
299
+ }
300
+ }
301
+ return written;
302
+ }
303
+
304
+ /** Читает журнал аудита (новые сверху). */
305
+ export function readAuditLog(filter: ReadAuditFilter = {}): ReadAuditResult {
306
+ const limit = Math.max(1, Math.min(5000, Math.floor(filter.limit ?? 200) || 200));
307
+ const where: string[] = [];
308
+ const params: unknown[] = [];
309
+ if (filter.action?.trim()) {
310
+ where.push("action = ?");
311
+ params.push(filter.action.trim());
312
+ }
313
+ if (filter.target?.trim()) {
314
+ where.push("target = ?");
315
+ params.push(filter.target.trim());
316
+ }
317
+ if (filter.actor?.trim()) {
318
+ where.push("actor = ?");
319
+ params.push(filter.actor.trim());
320
+ }
321
+ if (filter.since?.trim()) {
322
+ where.push("ts >= ?");
323
+ params.push(filter.since.trim());
324
+ }
325
+ if (filter.until?.trim()) {
326
+ where.push("ts <= ?");
327
+ params.push(filter.until.trim());
328
+ }
329
+ const clause = where.length ? `WHERE ${where.join(" AND ")}` : "";
330
+ try {
331
+ const db = getDb();
332
+ const totalRow = db
333
+ .prepare(`SELECT COUNT(*) AS count FROM audit_log ${clause}`)
334
+ .get(...params);
335
+ const rows = db
336
+ .prepare(`SELECT * FROM audit_log ${clause} ORDER BY ts DESC, id DESC LIMIT ?`)
337
+ .all(...params, limit);
338
+ return { records: rows.map(rowToRecord), total: Number(totalRow?.count) || 0 };
339
+ } catch (err) {
340
+ try {
341
+ console.warn(
342
+ `[audit] не удалось прочитать журнал: ${
343
+ err instanceof Error ? err.message : String(err)
344
+ }`,
345
+ );
346
+ } catch {
347
+ // ignore
348
+ }
349
+ return { records: [], total: 0 };
350
+ }
351
+ }
352
+
353
+ /**
354
+ * Удаляет старые записи и лишние сверх maxRecords.
355
+ * Возвращает количество удалённых строк.
356
+ */
357
+ export function cleanupAuditLog(options: {
358
+ retentionDays?: number;
359
+ maxRecords?: number;
360
+ } = {}): number {
361
+ const retentionDays = Math.max(
362
+ 0,
363
+ Math.floor(options.retentionDays ?? DEFAULT_AUDIT_RETENTION_DAYS) || 0,
364
+ );
365
+ const maxRecords = Math.max(
366
+ 100,
367
+ Math.floor(options.maxRecords ?? DEFAULT_AUDIT_MAX_RECORDS) || DEFAULT_AUDIT_MAX_RECORDS,
368
+ );
369
+ let deleted = 0;
370
+ try {
371
+ const db = getDb();
372
+ if (retentionDays > 0) {
373
+ const cutoff = new Date(
374
+ Date.now() - retentionDays * 24 * 60 * 60 * 1000,
375
+ ).toISOString();
376
+ const result = db.prepare("DELETE FROM audit_log WHERE ts < ?").run(cutoff);
377
+ deleted += Number(result.changes) || 0;
378
+ }
379
+ const countRow = db.prepare("SELECT COUNT(*) AS count FROM audit_log").get();
380
+ const count = Number(countRow?.count) || 0;
381
+ if (count > maxRecords) {
382
+ const excess = count - maxRecords;
383
+ const result = db
384
+ .prepare(
385
+ `DELETE FROM audit_log WHERE id IN (
386
+ SELECT id FROM audit_log ORDER BY ts ASC, id ASC LIMIT ?
387
+ )`,
388
+ )
389
+ .run(excess);
390
+ deleted += Number(result.changes) || 0;
391
+ }
392
+ } catch (err) {
393
+ try {
394
+ console.warn(
395
+ `[audit] не удалось очистить журнал: ${
396
+ err instanceof Error ? err.message : String(err)
397
+ }`,
398
+ );
399
+ } catch {
400
+ // ignore
401
+ }
402
+ }
403
+ return deleted;
404
+ }
405
+
406
+ /** Удаляет все записи (тесты / обслуживание). */
407
+ export function clearAuditLog(): void {
408
+ try {
409
+ getDb().exec("DELETE FROM audit_log");
410
+ } catch {
411
+ // ignore
412
+ }
413
+ }
414
+
415
+ /** Сбрасывает троттлинг очистки (для тестов). */
416
+ export function resetAuditCleanupThrottle(): void {
417
+ lastCleanupAt = 0;
418
+ }
@@ -0,0 +1,209 @@
1
+ import type { CronConversion } from "../types.js";
2
+
3
+ /**
4
+ * Сообщение об ошибке, возвращаемое при встрече неподдерживаемого cron-выражения.
5
+ * Содержит описание поддерживаемого подмножества.
6
+ * Собрано конкатенацией, чтобы избежать последовательности закрывающего комментария внутри строк.
7
+ */
8
+ const UNSUPPORTED_ERROR =
9
+ "Неподдерживаемое cron-выражение.\n" +
10
+ "\n" +
11
+ "Поддерживаемое подмножество cron (5 полей: минута час день_месяца месяц день_недели):\n" +
12
+ " * * * * * -> MINUTE, каждую минуту (/mo 1)\n" +
13
+ " */N * * * * -> MINUTE, каждые N минут (/mo N)\n" +
14
+ " M * * * * -> HOURLY, ежечасно в MM минут (/st 00:MM)\n" +
15
+ " M H * * * -> DAILY, ежедневно в HH:MM (/st HH:MM)\n" +
16
+ " M H * * D -> WEEKLY, по неделям в день D в HH:MM (/d D /st HH:MM)\n" +
17
+ "\n" +
18
+ "Не поддерживаются: диапазоны (1-5), списки (1,2,3), комбинации месяца и дня недели,\n" +
19
+ "*/N в поле дня месяца или дня недели, а также любые другие сложные выражения.\n" +
20
+ "Выражение `M H */N * *` намеренно не превращается в DAILY /mo N: cron отсчитывает\n" +
21
+ "дни от 1-го числа месяца, а /mo N — от даты создания задачи, поэтому расписания\n" +
22
+ "не совпадают. Такие задачи выполняются в режиме минутного опроса (minute-poll).\n" +
23
+ "Пожалуйста, упростите расписание, используя одно из поддерживаемых выше выражений.";
24
+
25
+ /** Дни недели для schtasks /d (0 и 7 = воскресенье). */
26
+ const DAY_OF_WEEK_MAP: Record<string, string> = {
27
+ "0": "SUN",
28
+ "1": "MON",
29
+ "2": "TUE",
30
+ "3": "WED",
31
+ "4": "THU",
32
+ "5": "FRI",
33
+ "6": "SAT",
34
+ "7": "SUN",
35
+ };
36
+
37
+ /**
38
+ * Проверяет, является ли строка звездочкой "*".
39
+ */
40
+ function isStar(value: string): boolean {
41
+ return value === "*";
42
+ }
43
+
44
+ /**
45
+ * Проверяет, является ли строка шаблоном звездочка-слэш-N (N — положительное целое).
46
+ * Возвращает N или undefined.
47
+ */
48
+ function parseStep(value: string): number | undefined {
49
+ const match = /^\*\/(\d+)$/.exec(value);
50
+ if (!match) return undefined;
51
+ const n = parseInt(match[1], 10);
52
+ return n > 0 ? n : undefined;
53
+ }
54
+
55
+ /**
56
+ * Проверяет, является ли строка одиночным целым числом в диапазоне [min, max].
57
+ * Возвращает число или undefined.
58
+ */
59
+ function parseIntInRange(value: string, min: number, max: number): number | undefined {
60
+ if (!/^\d+$/.test(value)) return undefined;
61
+ const n = parseInt(value, 10);
62
+ return n >= min && n <= max ? n : undefined;
63
+ }
64
+
65
+ /**
66
+ * Валидирует и преобразует 5-полевое cron-выражение во флаги schtasks.
67
+ * Возвращает CronConversion или выбрасывает Error с понятным сообщением.
68
+ */
69
+ export function convertCronToSchTasks(cron: string): CronConversion {
70
+ const fields = cron.trim().split(/\s+/);
71
+
72
+ if (fields.length !== 5) {
73
+ throw new Error(
74
+ "Ожидалось 5 полей cron-выражения (минута час день_месяца месяц день_недели), получено " +
75
+ fields.length +
76
+ ".\n\n" +
77
+ UNSUPPORTED_ERROR,
78
+ );
79
+ }
80
+
81
+ const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
82
+
83
+ // --- ПАТТЕРН 1: * * * * * -> MINUTE /mo 1 ---
84
+ if (
85
+ isStar(minute) &&
86
+ isStar(hour) &&
87
+ isStar(dayOfMonth) &&
88
+ isStar(month) &&
89
+ isStar(dayOfWeek)
90
+ ) {
91
+ return {
92
+ sc: "MINUTE",
93
+ extraFlags: ["/mo", "1"],
94
+ };
95
+ }
96
+
97
+ // --- ПАТТЕРН 2: */N * * * * -> MINUTE /mo N ---
98
+ const stepN = parseStep(minute);
99
+ if (
100
+ stepN !== undefined &&
101
+ isStar(hour) &&
102
+ isStar(dayOfMonth) &&
103
+ isStar(month) &&
104
+ isStar(dayOfWeek)
105
+ ) {
106
+ if (stepN > 1439) {
107
+ throw new Error(
108
+ "Интервал /mo " +
109
+ stepN +
110
+ " минут превышает максимально допустимый для schtasks (1439 минут).\n\n" +
111
+ UNSUPPORTED_ERROR,
112
+ );
113
+ }
114
+ // schtasks /mo Nanchors на момент создания задачи, а cron */N означает
115
+ // минуты 0, N, 2N … внутри часа. Семантики совпадают только когда N
116
+ // делит 60 без остатка И есть выровненный старт (00:00), поэтому ниже
117
+ // добавляется startTime: "00:00". Для N, не делящих 60, выбрасывается
118
+ // ошибка — задача уходит в минутный опрос с gate во враппере
119
+ // (needsPollMode в windows.ts), а не конвертируется здесь нативно.
120
+ if (60 % stepN !== 0) {
121
+ throw new Error(
122
+ "Интервал */" +
123
+ stepN +
124
+ " не делит час нацело: cron и schtasks понимают его по-разному.\n\n" +
125
+ UNSUPPORTED_ERROR,
126
+ );
127
+ }
128
+ return {
129
+ sc: "MINUTE",
130
+ extraFlags: ["/mo", String(stepN)],
131
+ // schtasks /mo Nanchors на момент создания задачи; cron */N означает
132
+ // минуты 0, N, 2N … внутри часа. Выровненный старт 00:00 делает
133
+ // расписание идентичным cron для любого N, делящего 60.
134
+ startTime: "00:00",
135
+ };
136
+ }
137
+
138
+ // --- ПАТТЕРН 3: M * * * * -> HOURLY /mo 1 /st 00:MM (каждый час в минуту M) ---
139
+ const mHourly = parseIntInRange(minute, 0, 59);
140
+ if (
141
+ mHourly !== undefined &&
142
+ isStar(hour) &&
143
+ isStar(dayOfMonth) &&
144
+ isStar(month) &&
145
+ isStar(dayOfWeek)
146
+ ) {
147
+ return {
148
+ sc: "HOURLY",
149
+ extraFlags: ["/mo", "1"],
150
+ startTime: "00:" + String(mHourly).padStart(2, "0"),
151
+ };
152
+ }
153
+
154
+ // --- ПАТТЕРН 4: M H * * * -> DAILY /st HH:MM ---
155
+ const m = parseIntInRange(minute, 0, 59);
156
+ const h = parseIntInRange(hour, 0, 23);
157
+ if (
158
+ m !== undefined &&
159
+ h !== undefined &&
160
+ isStar(dayOfMonth) &&
161
+ isStar(month) &&
162
+ isStar(dayOfWeek)
163
+ ) {
164
+ const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
165
+ return {
166
+ sc: "DAILY",
167
+ extraFlags: [],
168
+ startTime,
169
+ };
170
+ }
171
+
172
+ // --- ПАТТЕРН 4: M H * * D -> WEEKLY /d D /st HH:MM ---
173
+ const d = parseIntInRange(dayOfWeek, 0, 7);
174
+ if (
175
+ m !== undefined &&
176
+ h !== undefined &&
177
+ isStar(dayOfMonth) &&
178
+ isStar(month) &&
179
+ d !== undefined
180
+ ) {
181
+ const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
182
+ const dayName = DAY_OF_WEEK_MAP[String(d)];
183
+ return {
184
+ sc: "WEEKLY",
185
+ extraFlags: ["/d", dayName],
186
+ startTime,
187
+ days: dayName,
188
+ };
189
+ }
190
+
191
+ // Ни один поддерживаемый паттерн не совпал.
192
+ throw new Error(UNSUPPORTED_ERROR);
193
+ }
194
+
195
+ /**
196
+ * Формирует массив флагов расписания для schtasks на основе CronConversion.
197
+ * Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
198
+ */
199
+ export function buildScheduleFlags(conversion: CronConversion): string[] {
200
+ const flags: string[] = ["/sc", conversion.sc];
201
+
202
+ if (conversion.startTime) {
203
+ flags.push("/st", conversion.startTime);
204
+ }
205
+
206
+ flags.push(...conversion.extraFlags);
207
+
208
+ return flags;
209
+ }