opencode-windows-scheduler 1.5.4 → 1.5.5

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 (218) hide show
  1. package/CHANGELOG.md +65 -5
  2. package/CROSS_PLATFORM.md +107 -71
  3. package/README.md +72 -25
  4. package/ROADMAP-STRATEGY.md +6 -0
  5. package/ROADMAP.md +116 -85
  6. package/dist/core/analytics.d.ts +3 -0
  7. package/dist/core/analytics.d.ts.map +1 -1
  8. package/dist/core/analytics.js +4 -0
  9. package/dist/core/audit.d.ts +2 -1
  10. package/dist/core/audit.d.ts.map +1 -1
  11. package/dist/core/audit.js +32 -1
  12. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  13. package/dist/core/cron-to-schtasks.js +21 -4
  14. package/dist/core/file-watcher.d.ts.map +1 -1
  15. package/dist/core/file-watcher.js +16 -1
  16. package/dist/core/git-trigger.d.ts +4 -2
  17. package/dist/core/git-trigger.d.ts.map +1 -1
  18. package/dist/core/git-trigger.js +34 -16
  19. package/dist/core/lock.d.ts +14 -0
  20. package/dist/core/lock.d.ts.map +1 -1
  21. package/dist/core/lock.js +81 -4
  22. package/dist/core/matrix.d.ts.map +1 -1
  23. package/dist/core/matrix.js +3 -2
  24. package/dist/core/native-notify.d.ts.map +1 -1
  25. package/dist/core/native-notify.js +3 -0
  26. package/dist/core/one-shot.d.ts +7 -1
  27. package/dist/core/one-shot.d.ts.map +1 -1
  28. package/dist/core/one-shot.js +15 -2
  29. package/dist/core/permissions.d.ts +69 -0
  30. package/dist/core/permissions.d.ts.map +1 -0
  31. package/dist/core/permissions.js +143 -0
  32. package/dist/core/ps-wrapper.d.ts +9 -2
  33. package/dist/core/ps-wrapper.d.ts.map +1 -1
  34. package/dist/core/ps-wrapper.js +293 -96
  35. package/dist/core/record-history.d.ts +11 -0
  36. package/dist/core/record-history.d.ts.map +1 -1
  37. package/dist/core/record-history.js +106 -4
  38. package/dist/core/savings.d.ts +70 -0
  39. package/dist/core/savings.d.ts.map +1 -0
  40. package/dist/core/savings.js +87 -0
  41. package/dist/core/schedule-gate.js +7 -3
  42. package/dist/core/schedule-v2.js +1 -1
  43. package/dist/core/scheduler/index.d.ts +13 -1
  44. package/dist/core/scheduler/index.d.ts.map +1 -1
  45. package/dist/core/scheduler/index.js +35 -4
  46. package/dist/core/scheduler/linux.d.ts +4 -1
  47. package/dist/core/scheduler/linux.d.ts.map +1 -1
  48. package/dist/core/scheduler/linux.js +53 -20
  49. package/dist/core/scheduler/mac.d.ts +2 -1
  50. package/dist/core/scheduler/mac.d.ts.map +1 -1
  51. package/dist/core/scheduler/mac.js +24 -6
  52. package/dist/core/scheduler/posix.d.ts +1 -1
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +2 -2
  55. package/dist/core/scheduler/registry.d.ts +3 -2
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +6 -5
  58. package/dist/core/scheduler/windows.d.ts +49 -1
  59. package/dist/core/scheduler/windows.d.ts.map +1 -1
  60. package/dist/core/scheduler/windows.js +219 -34
  61. package/dist/core/secrets.d.ts +5 -3
  62. package/dist/core/secrets.d.ts.map +1 -1
  63. package/dist/core/secrets.js +86 -8
  64. package/dist/core/self-analysis.d.ts +117 -0
  65. package/dist/core/self-analysis.d.ts.map +1 -0
  66. package/dist/core/self-analysis.js +539 -0
  67. package/dist/core/session.d.ts +11 -3
  68. package/dist/core/session.d.ts.map +1 -1
  69. package/dist/core/session.js +34 -5
  70. package/dist/core/shutdown.d.ts +26 -0
  71. package/dist/core/shutdown.d.ts.map +1 -0
  72. package/dist/core/shutdown.js +49 -0
  73. package/dist/core/summary.d.ts +69 -0
  74. package/dist/core/summary.d.ts.map +1 -0
  75. package/dist/core/summary.js +250 -0
  76. package/dist/core/telegram.d.ts +10 -0
  77. package/dist/core/telegram.d.ts.map +1 -1
  78. package/dist/core/telegram.js +228 -47
  79. package/dist/core/triage-chain.d.ts +9 -3
  80. package/dist/core/triage-chain.d.ts.map +1 -1
  81. package/dist/core/triage-chain.js +15 -5
  82. package/dist/core/triage-compare.d.ts +68 -0
  83. package/dist/core/triage-compare.d.ts.map +1 -0
  84. package/dist/core/triage-compare.js +184 -0
  85. package/dist/core/triage-rules.d.ts.map +1 -1
  86. package/dist/core/triage-rules.js +22 -0
  87. package/dist/core/triage-shadow.d.ts +54 -10
  88. package/dist/core/triage-shadow.d.ts.map +1 -1
  89. package/dist/core/triage-shadow.js +138 -26
  90. package/dist/core/triage-worker.d.ts +55 -0
  91. package/dist/core/triage-worker.d.ts.map +1 -0
  92. package/dist/core/triage-worker.js +314 -0
  93. package/dist/core/triage.js +1 -1
  94. package/dist/core/watch-paths.d.ts +6 -0
  95. package/dist/core/watch-paths.d.ts.map +1 -0
  96. package/dist/core/watch-paths.js +62 -0
  97. package/dist/core/wrappers/bash.d.ts +15 -3
  98. package/dist/core/wrappers/bash.d.ts.map +1 -1
  99. package/dist/core/wrappers/bash.js +153 -120
  100. package/dist/db/history-repo.d.ts +1 -1
  101. package/dist/db/history-repo.d.ts.map +1 -1
  102. package/dist/db/history-repo.js +29 -14
  103. package/dist/db/schema.d.ts +1 -1
  104. package/dist/db/schema.d.ts.map +1 -1
  105. package/dist/db/schema.js +31 -0
  106. package/dist/history.d.ts +2 -2
  107. package/dist/history.d.ts.map +1 -1
  108. package/dist/history.js +3 -3
  109. package/dist/i18n.d.ts +25 -2
  110. package/dist/i18n.d.ts.map +1 -1
  111. package/dist/i18n.js +41 -3
  112. package/dist/index.d.ts +40 -4
  113. package/dist/index.d.ts.map +1 -1
  114. package/dist/index.js +345 -71
  115. package/dist/integrations.d.ts +9 -1
  116. package/dist/integrations.d.ts.map +1 -1
  117. package/dist/integrations.js +34 -6
  118. package/dist/notifications.d.ts +30 -2
  119. package/dist/notifications.d.ts.map +1 -1
  120. package/dist/notifications.js +287 -16
  121. package/dist/profiles.d.ts +1 -1
  122. package/dist/profiles.d.ts.map +1 -1
  123. package/dist/profiles.js +21 -3
  124. package/dist/rpc.d.ts +145 -8
  125. package/dist/rpc.d.ts.map +1 -1
  126. package/dist/rpc.js +81 -6
  127. package/dist/server.d.ts +20 -0
  128. package/dist/server.d.ts.map +1 -1
  129. package/dist/server.js +136 -14
  130. package/dist/settings.d.ts +89 -5
  131. package/dist/settings.d.ts.map +1 -1
  132. package/dist/settings.js +143 -23
  133. package/dist/task-transfer.d.ts +8 -1
  134. package/dist/task-transfer.d.ts.map +1 -1
  135. package/dist/task-transfer.js +2 -2
  136. package/dist/types.d.ts +8 -1
  137. package/dist/types.d.ts.map +1 -1
  138. package/dist/types.js +23 -5
  139. package/dist/workspaces.d.ts +9 -0
  140. package/dist/workspaces.d.ts.map +1 -1
  141. package/dist/workspaces.js +25 -0
  142. package/docs/ARCHITECTURE.md +40 -22
  143. package/docs/CONCEPT.md +230 -0
  144. package/docs/CROSS_PLATFORM.ru.md +150 -0
  145. package/docs/CROSS_PLATFORM.zh.md +146 -0
  146. package/docs/FAQ.md +52 -0
  147. package/docs/FAQ.ru.md +53 -0
  148. package/docs/FAQ.zh.md +43 -0
  149. package/docs/FEATURES.md +125 -48
  150. package/docs/FEATURES.zh.md +655 -0
  151. package/docs/LOCAL-AI.md +114 -16
  152. package/docs/README.ru.md +18 -13
  153. package/docs/README.zh.md +286 -0
  154. package/docs/SAVINGS.md +61 -0
  155. package/docs/SAVINGS.ru.md +60 -0
  156. package/docs/SAVINGS.zh.md +52 -0
  157. package/docs/ZH-LOCALE-PLAN.md +324 -0
  158. package/gui-experimental.cjs +8 -8
  159. package/locales/en.json +54 -1
  160. package/locales/ru.json +54 -1
  161. package/locales/zh.json +780 -0
  162. package/package.json +24 -7
  163. package/scripts/check-zh-locale.mjs +218 -0
  164. package/scripts/run-tests.mjs +236 -0
  165. package/scripts/test-locale.mjs +4 -3
  166. package/skills/scheduled-job-best-practices/SKILL.md +6 -3
  167. package/skills/scheduled-job-best-practices/references/recipes.md +1 -1
  168. package/src/core/analytics.ts +10 -0
  169. package/src/core/audit.ts +39 -1
  170. package/src/core/cron-to-schtasks.ts +23 -4
  171. package/src/core/file-watcher.ts +20 -1
  172. package/src/core/git-trigger.ts +34 -16
  173. package/src/core/lock.ts +88 -3
  174. package/src/core/matrix.ts +5 -1
  175. package/src/core/native-notify.ts +3 -0
  176. package/src/core/one-shot.ts +18 -2
  177. package/src/core/permissions.ts +200 -0
  178. package/src/core/ps-wrapper.ts +300 -96
  179. package/src/core/record-history.ts +111 -4
  180. package/src/core/savings.ts +150 -0
  181. package/src/core/schedule-gate.ts +9 -3
  182. package/src/core/schedule-v2.ts +1 -1
  183. package/src/core/scheduler/index.ts +41 -3
  184. package/src/core/scheduler/linux.ts +67 -22
  185. package/src/core/scheduler/mac.ts +24 -7
  186. package/src/core/scheduler/posix.ts +2 -2
  187. package/src/core/scheduler/registry.ts +7 -5
  188. package/src/core/scheduler/windows.ts +237 -32
  189. package/src/core/secrets.ts +101 -7
  190. package/src/core/self-analysis.ts +744 -0
  191. package/src/core/session.ts +40 -5
  192. package/src/core/shutdown.ts +69 -0
  193. package/src/core/summary.ts +318 -0
  194. package/src/core/telegram.ts +266 -55
  195. package/src/core/triage-chain.ts +15 -6
  196. package/src/core/triage-compare.ts +277 -0
  197. package/src/core/triage-rules.ts +23 -0
  198. package/src/core/triage-shadow.ts +176 -32
  199. package/src/core/triage-worker.ts +344 -0
  200. package/src/core/triage.ts +1 -1
  201. package/src/core/watch-paths.ts +70 -0
  202. package/src/core/wrappers/bash.ts +181 -138
  203. package/src/db/history-repo.ts +31 -18
  204. package/src/db/schema.ts +31 -0
  205. package/src/gui.tsx +5070 -4761
  206. package/src/history.ts +7 -3
  207. package/src/i18n.ts +55 -4
  208. package/src/index.ts +432 -74
  209. package/src/integrations.ts +50 -6
  210. package/src/notifications.ts +465 -18
  211. package/src/profiles.ts +21 -3
  212. package/src/rpc.ts +86 -6
  213. package/src/server.ts +135 -16
  214. package/src/settings.ts +305 -46
  215. package/src/task-transfer.ts +10 -3
  216. package/src/types.ts +24 -5
  217. package/src/workspaces.ts +22 -0
  218. package/dist/gui-experimental.cjs +0 -1
package/src/core/audit.ts CHANGED
@@ -1,5 +1,9 @@
1
1
  import { getDb } from "../db/index.js";
2
2
  import { redactSecretsInText } from "./secrets.js";
3
+ import {
4
+ resolvePermissions,
5
+ type PermissionPolicy,
6
+ } from "./permissions.js";
3
7
 
4
8
  /**
5
9
  * Журнал аудита мутаций (Спринт 26).
@@ -216,7 +220,9 @@ export function recordTaskToolBlocks(
216
220
  allowedTools: readonly string[] | null | undefined,
217
221
  deniedTools: readonly string[] | null | undefined,
218
222
  actor: AuditActor = "system",
219
- source = "policy"
223
+ source = "policy",
224
+ policy?: PermissionPolicy,
225
+ legacyShell?: boolean
220
226
  ): number {
221
227
  const normalizedDenied = Array.from(
222
228
  new Set(
@@ -260,6 +266,38 @@ export function recordTaskToolBlocks(
260
266
  written++;
261
267
  }
262
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
+ }
263
301
  return written;
264
302
  }
265
303
 
@@ -11,11 +11,15 @@ const UNSUPPORTED_ERROR =
11
11
  "Поддерживаемое подмножество cron (5 полей: минута час день_месяца месяц день_недели):\n" +
12
12
  " * * * * * -> MINUTE, каждую минуту (/mo 1)\n" +
13
13
  " */N * * * * -> MINUTE, каждые N минут (/mo N)\n" +
14
+ " M * * * * -> HOURLY, ежечасно в MM минут (/st 00:MM)\n" +
14
15
  " M H * * * -> DAILY, ежедневно в HH:MM (/st HH:MM)\n" +
15
16
  " M H * * D -> WEEKLY, по неделям в день D в HH:MM (/d D /st HH:MM)\n" +
16
17
  "\n" +
17
18
  "Не поддерживаются: диапазоны (1-5), списки (1,2,3), комбинации месяца и дня недели,\n" +
18
- "*/N на месяце или дне недели, а также любые другие сложные выражения.\n" +
19
+ "*/N в поле дня месяца или дня недели, а также любые другие сложные выражения.\n" +
20
+ "Выражение `M H */N * *` намеренно не превращается в DAILY /mo N: cron отсчитывает\n" +
21
+ "дни от 1-го числа месяца, а /mo N — от даты создания задачи, поэтому расписания\n" +
22
+ "не совпадают. Такие задачи выполняются в режиме минутного опроса (minute-poll).\n" +
19
23
  "Пожалуйста, упростите расписание, используя одно из поддерживаемых выше выражений.";
20
24
 
21
25
  /** Дни недели для schtasks /d (0 и 7 = воскресенье). */
@@ -107,6 +111,18 @@ export function convertCronToSchTasks(cron: string): CronConversion {
107
111
  UNSUPPORTED_ERROR
108
112
  );
109
113
  }
114
+ // schtasks /mo N запускает задачу каждые N минут начиная с момента создания
115
+ // задачи, а cron */N — в минуты 0, N, 2N внутри каждого часа. Семантики
116
+ // совпадают только когда N делит 60 без остатка; иначе отдаём задачу в
117
+ // минутный опрос с gate во враппере (needsPollMode).
118
+ if (60 % stepN !== 0) {
119
+ throw new Error(
120
+ "Интервал */" +
121
+ stepN +
122
+ " не делит час нацело: cron и schtasks понимают его по-разному.\n\n" +
123
+ UNSUPPORTED_ERROR
124
+ );
125
+ }
110
126
  return {
111
127
  sc: "MINUTE",
112
128
  extraFlags: ["/mo", String(stepN)],
@@ -195,13 +211,16 @@ export function previousRunTime(cron: string, now: Date = new Date()): Date | nu
195
211
  return new Date(Math.floor(nowMs / 60000) * 60000);
196
212
  }
197
213
 
198
- // */N * * * * — каждые N минут (выравнивание по эпохе, как /mo N в schtasks).
214
+ // */N * * * * — каждые N минут внутри часа (минуты 0, N, 2N...).
199
215
  const step = /^\*\/(\d+)$/.exec(minute);
200
216
  if (step && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
201
217
  const n = parseInt(step[1], 10);
202
218
  if (n > 0) {
203
- const minutes = Math.floor(nowMs / 60000);
204
- return new Date((minutes - (minutes % n)) * 60000);
219
+ const result = new Date(now);
220
+ result.setSeconds(0, 0);
221
+ const minuteOfHour = result.getMinutes();
222
+ result.setMinutes(n >= 60 ? 0 : minuteOfHour - (minuteOfHour % n));
223
+ return result;
205
224
  }
206
225
  return null;
207
226
  }
@@ -1,6 +1,8 @@
1
1
  import { watch, type FSWatcher } from "chokidar";
2
+ import { isAbsolute } from "node:path";
2
3
  import { loadTaskDefinitions } from "../task-transfer.js";
3
4
  import { filterPaths, relativeTo } from "./glob.js";
5
+ import { hasPathControlChars } from "./watch-paths.js";
4
6
 
5
7
  /**
6
8
  * Задержка между последним изменением файла и запуском задачи.
@@ -71,7 +73,24 @@ export class FileWatchManager {
71
73
  ? d.watchIgnore.filter((g): g is string => typeof g === "string" && g.trim().length > 0)
72
74
  : [],
73
75
  }))
74
- .filter((d) => d.name.length > 0);
76
+ .filter((d) => d.name.length > 0)
77
+ .filter((d) => {
78
+ // Защита от legacy-записей и ручного редактирования БД: не запускаем
79
+ // watcher на путях с управляющими символами или выходом через `..`.
80
+ if (hasPathControlChars(d.path)) {
81
+ console.error(
82
+ `[windows-scheduler] Задача "${d.name}": путь наблюдения содержит управляющие символы — пропущен.`
83
+ );
84
+ return false;
85
+ }
86
+ if (!isAbsolute(d.path) && d.path.split(/[\\/]/).includes("..")) {
87
+ console.error(
88
+ `[windows-scheduler] Задача "${d.name}": относительный путь наблюдения выходит за рабочую директорию — пропущен.`
89
+ );
90
+ return false;
91
+ }
92
+ return true;
93
+ });
75
94
 
76
95
  const wantedKeys = new Set(wanted.map((d) => d.name.toLowerCase()));
77
96
 
@@ -45,7 +45,8 @@ export type GitCheckStatus =
45
45
  | "no-changes"
46
46
  | "branch-mismatch"
47
47
  | "ignored"
48
- | "changed";
48
+ | "changed"
49
+ | "error";
49
50
 
50
51
  export interface GitCheckResult {
51
52
  status: GitCheckStatus;
@@ -105,7 +106,9 @@ export async function probeGit(cwd: string, run: GitRunner = defaultRunner): Pro
105
106
  }
106
107
  }
107
108
 
108
- /** Файлы, изменённые между коммитами (или в самом коммите, если from пуст). */
109
+ /** Файлы, изменённые между коммитами (или в самом коммите, если from пуст).
110
+ * Ошибка git НЕ превращается в пустой список: иначе state продвигается и
111
+ * коммиты молча теряются. Вызывающий код обязан обработать исключение. */
109
112
  export async function gitChangedFiles(
110
113
  cwd: string,
111
114
  from: string | null,
@@ -115,15 +118,11 @@ export async function gitChangedFiles(
115
118
  const args = from
116
119
  ? ["diff", "--name-only", `${from}..${to}`]
117
120
  : ["diff-tree", "--no-commit-id", "--name-only", "-r", to];
118
- try {
119
- const out = await run(cwd, args);
120
- return out
121
- .split(/\r?\n/)
122
- .map((line) => line.trim())
123
- .filter(Boolean);
124
- } catch {
125
- return [];
126
- }
121
+ const out = await run(cwd, args);
122
+ return out
123
+ .split(/\r?\n/)
124
+ .map((line) => line.trim())
125
+ .filter(Boolean);
127
126
  }
128
127
 
129
128
  function branchMatches(branch: string | null, pattern?: string): boolean {
@@ -138,10 +137,10 @@ function branchMatches(branch: string | null, pattern?: string): boolean {
138
137
  .filter(Boolean);
139
138
  if (patterns.length === 0) return true;
140
139
  return patterns.some((item) => {
141
- const source = normalize(item)
142
- .replace(/[.+^${}()|\\]/g, "\\$&")
143
- .replace(/\*/g, ".*")
144
- .replace(/\?/g, ".");
140
+ // Экранируем все regex-метасимволы, включая [ и ] (раньше они ломали
141
+ // шаблон ветки), затем превращаем glob-символы * и ? в regex.
142
+ const escaped = normalize(item).replace(/[.+^${}()|[\]\\]/g, "\\$&");
143
+ const source = escaped.replace(/\*/g, ".*").replace(/\?/g, ".");
145
144
  return new RegExp(`^${source}$`).test(target);
146
145
  });
147
146
  }
@@ -206,7 +205,24 @@ export async function checkGitTrigger(
206
205
  };
207
206
  }
208
207
 
209
- const files = await gitChangedFiles(task.cwd, state.commitSha, probe.head, run);
208
+ let files: string[];
209
+ try {
210
+ files = await gitChangedFiles(task.cwd, state.commitSha, probe.head, run);
211
+ } catch (err: any) {
212
+ // Не двигаем state: следующий опрос повторит сравнение с тем же коммитом,
213
+ // и пропущенные изменения не потеряются.
214
+ return {
215
+ status: "error",
216
+ head: probe.head,
217
+ branch: probe.branch,
218
+ from: state.commitSha,
219
+ files: [],
220
+ matched: [],
221
+ message: t("gitTrigger.diffFailed", {
222
+ error: err?.message ? String(err.message) : String(err),
223
+ }),
224
+ };
225
+ }
210
226
  const matched = filterPaths(files, task.paths, task.ignore);
211
227
 
212
228
  if (matched.length === 0) {
@@ -337,6 +353,8 @@ export class GitTriggerManager {
337
353
  const result = await checkGitTrigger(this.taskSpec(managed.def), { run: this.run });
338
354
  if (result.status === "changed") {
339
355
  await this.handler(managed.def.name, { ...result, cwd: cwdOf(managed.def) });
356
+ } else if (result.status === "error") {
357
+ console.error(`[windows-scheduler] git-триггер «${managed.def.name}»: ${result.message}`);
340
358
  }
341
359
  } catch (err: any) {
342
360
  console.error(
package/src/core/lock.ts CHANGED
@@ -27,6 +27,11 @@ export class LockManager {
27
27
  return path.join(this.lockDir, this.lockFileName(taskName));
28
28
  }
29
29
 
30
+ /** Публичный путь к lock-файлу (для ожидания/вытеснения зависших lock). */
31
+ pathFor(taskName: string): string {
32
+ return this.lockFilePath(taskName);
33
+ }
34
+
30
35
  /**
31
36
  * Инициализация директории блокировок и очистка зависших (старых) файлов.
32
37
  * Вызывается при старте плагина.
@@ -38,16 +43,38 @@ export class LockManager {
38
43
  const now = Date.now();
39
44
 
40
45
  for (const file of files) {
41
- if (!file.endsWith(".lock")) continue;
42
46
  const fullPath = path.join(this.lockDir, file);
47
+ // Каталог <task>.lock.d держит POSIX-обёртка (mkdir-блокировка).
48
+ // После kill -9 он остаётся навсегда, поэтому чистим его так же, как .lock.
49
+ const isLockFile = file.endsWith(".lock");
50
+ const isLockDir = file.endsWith(".lock.d");
51
+ const isStaleArtifact = /\.lock(\.d)?\.stale-/.test(file);
52
+ if (!isLockFile && !isLockDir && !isStaleArtifact) continue;
43
53
  try {
54
+ // Артефакт предыдущего вытеснения валидным lock быть не может,
55
+ // поэтому убираем его независимо от возраста.
56
+ if (isStaleArtifact) {
57
+ await fs.rm(fullPath, { recursive: true, force: true }).catch(() => {});
58
+ continue;
59
+ }
44
60
  const stat = await fs.stat(fullPath);
45
61
  const age = now - stat.mtimeMs;
46
62
  if (age > STALE_LOCK_MAX_AGE_MS) {
47
- await fs.unlink(fullPath).catch(() => {});
63
+ // T-03: не удаляем lock напрямую. Два воркера могли одновременно
64
+ // снести один и тот же файл, после чего один из них удалял свежий
65
+ // lock, созданный другим, и задача запускалась повторно. Атомарный
66
+ // rename в уникальное имя выигрывает только один процесс; второй
67
+ // получает ENOENT и не трогает чужой lock.
68
+ const stalePath = `${fullPath}.stale-${process.pid}-${Date.now()}`;
69
+ try {
70
+ await fs.rename(fullPath, stalePath);
71
+ } catch {
72
+ continue;
73
+ }
74
+ await fs.rm(stalePath, { recursive: true, force: true }).catch(() => {});
48
75
  // eslint-disable-next-line no-console
49
76
  console.log(
50
- `[windows-scheduler] Удалён зависший lock-файл: ${file} (возраст ${Math.round(
77
+ `[windows-scheduler] Вытеснен зависший lock: ${file} (возраст ${Math.round(
51
78
  age / 1000
52
79
  )} с)`
53
80
  );
@@ -132,3 +159,61 @@ export async function withLock<T>(
132
159
  await lockManager.release(taskName);
133
160
  }
134
161
  }
162
+
163
+ /**
164
+ * Выполняет функцию с ожиданием освобождения файловой блокировки.
165
+ * В отличие от withLock не пропускает выполнение, а ждёт: критично для
166
+ * read-modify-write операций (crontab), где пропуск ломает состояние.
167
+ * Если lock удерживается дольше staleMs — считается осиротевшим и вытесняется
168
+ * атомарным rename (как в T-03), чтобы зависший процесс не блокировал навсегда.
169
+ */
170
+ export async function withLockWait<T>(
171
+ lockManager: LockManager,
172
+ taskName: string,
173
+ fn: () => Promise<T>,
174
+ options: { timeoutMs?: number; retryDelayMs?: number; staleMs?: number } = {}
175
+ ): Promise<T> {
176
+ const timeoutMs = options.timeoutMs ?? 15000;
177
+ const retryDelayMs = options.retryDelayMs ?? 50;
178
+ const staleMs = options.staleMs ?? 60000;
179
+ const deadline = Date.now() + timeoutMs;
180
+ const lockPath = lockManager.pathFor(taskName);
181
+
182
+ for (;;) {
183
+ if (await lockManager.acquire(taskName)) break;
184
+
185
+ // Осиротевший lock: короткая операция не может длиться дольше staleMs.
186
+ if (staleMs > 0) {
187
+ try {
188
+ const stat = await fs.stat(lockPath);
189
+ if (Date.now() - stat.mtimeMs > staleMs) {
190
+ // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
191
+ // один процесс, остальные получают ENOENT и повторяют попытку.
192
+ const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
193
+ try {
194
+ await fs.rename(lockPath, stalePath);
195
+ await fs.rm(stalePath, { force: true }).catch(() => {});
196
+ } catch {
197
+ // Кто-то успел раньше — просто повторяем acquire.
198
+ }
199
+ continue;
200
+ }
201
+ } catch {
202
+ // lock исчез — сразу пробуем acquire снова.
203
+ }
204
+ }
205
+
206
+ if (Date.now() >= deadline) {
207
+ throw new Error(
208
+ `Не удалось получить блокировку "${taskName}" за ${timeoutMs} мс.`
209
+ );
210
+ }
211
+ await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
212
+ }
213
+
214
+ try {
215
+ return await fn();
216
+ } finally {
217
+ await lockManager.release(taskName);
218
+ }
219
+ }
@@ -74,7 +74,11 @@ export function expandMatrixTask(task: TaskDefinition): TaskDefinition[] {
74
74
  );
75
75
  }
76
76
  const name = matrixCloneName(task.name, workspace.name);
77
- if (usedNames.has(name.toLowerCase())) continue;
77
+ if (usedNames.has(name.toLowerCase())) {
78
+ throw new Error(
79
+ t("matrix.error.duplicateCloneName", { task: task.name, name })
80
+ );
81
+ }
78
82
  usedNames.add(name.toLowerCase());
79
83
 
80
84
  // Клон наследует промпт, модель, хуки, Quality Gate, role-scoped tools.
@@ -101,6 +101,9 @@ export function buildNativeNotificationCommand(
101
101
  "normal",
102
102
  "-i",
103
103
  "dialog-information",
104
+ // `--` завершает разбор опций: текст уведомления может начинаться с "-"
105
+ // и без разделителя был бы принят за флаг notify-send.
106
+ "--",
104
107
  title,
105
108
  body,
106
109
  ],
@@ -164,10 +164,26 @@ export function buildLaunchdCalendar(runAt: string): {
164
164
  }
165
165
 
166
166
  /** Команда самоочистки launchd-агента после единственного запуска. */
167
- export function buildLaunchdOneShotCleanup(sanitizedName: string): string {
167
+ export function buildLaunchdOneShotCleanup(
168
+ sanitizedName: string,
169
+ profile: string = "default"
170
+ ): string {
171
+ const label = launchdLabel(sanitizedName, profile);
168
172
  return (
169
173
  `launchctl bootout "gui/$(id -u)" ` +
170
- `"$HOME/Library/LaunchAgents/com.opencode.scheduler.${sanitizedName}.plist" ` +
174
+ `"$HOME/Library/LaunchAgents/${label}.plist" ` +
171
175
  `>/dev/null 2>&1 || true`
172
176
  );
173
177
  }
178
+
179
+ /**
180
+ * label launchd-агента задачи. Для default сохраняется историческое имя
181
+ * `com.opencode.scheduler.<name>`; у не-default профиля свой префикс, чтобы
182
+ * одноимённые задачи разных профилей не затирали plist друг друга.
183
+ */
184
+ export function launchdLabel(sanitizedName: string, profile: string = "default"): string {
185
+ const base = `com.opencode.scheduler.${sanitizedName}`;
186
+ if (profile === "default") return base;
187
+ const scope = profile.replace(/[^A-Za-z0-9_.-]/g, "-");
188
+ return `com.opencode.scheduler.profile-${scope}.${sanitizedName}`;
189
+ }
@@ -0,0 +1,200 @@
1
+ /**
2
+ * Политика прав фоновых задач (Спринт 32 / релиз 1.6).
3
+ *
4
+ * OpenCode запускается с `--auto`, поэтому единственный барьер между
5
+ * автономной задачей и файловой системой/шеллом — сгенерированный
6
+ * OPENCODE_CONFIG_CONTENT. Здесь находится единый источник истины для
7
+ * PowerShell- и bash-обёрток, чтобы они не расходились в трактовке
8
+ * allowedTools/deniedTools.
9
+ *
10
+ * Важно: это политика на момент СОЗДАНИЯ/ОБНОВЛЕНИЯ задачи. Отдельный
11
+ * процесс обёртки не имеет доступа к SQLite, поэтому аудит фиксирует
12
+ * сгенерированную политику, а не попытки вызова инструментов.
13
+ */
14
+
15
+ /** Действия OpenCode v2, которые понимает permissions. */
16
+ export const PERMISSION_ACTIONS = [
17
+ "read",
18
+ "edit",
19
+ "glob",
20
+ "grep",
21
+ "shell",
22
+ "subagent",
23
+ "skill",
24
+ "question",
25
+ "webfetch",
26
+ "websearch",
27
+ ] as const;
28
+
29
+ export type PermissionAction = (typeof PERMISSION_ACTIONS)[number];
30
+
31
+ /** Имена инструментов, которые OpenCode отображает на действия. */
32
+ export const ACTION_ALIASES: Record<PermissionAction, readonly string[]> = {
33
+ read: ["read"],
34
+ edit: ["write", "edit", "apply_patch", "remove"],
35
+ glob: ["glob"],
36
+ grep: ["grep"],
37
+ shell: ["bash", "shell"],
38
+ subagent: ["subagent"],
39
+ skill: ["skill"],
40
+ question: ["question"],
41
+ webfetch: ["webfetch"],
42
+ websearch: ["websearch"],
43
+ };
44
+
45
+ export const PERMISSION_POLICIES = ["hybrid", "secure", "legacy"] as const;
46
+ export type PermissionPolicy = (typeof PERMISSION_POLICIES)[number];
47
+ export const DEFAULT_PERMISSION_POLICY: PermissionPolicy = "hybrid";
48
+
49
+ /** Базовые политики: какие действия разрешены без учёта списков задачи. */
50
+ const POLICY_BASE: Record<PermissionPolicy, readonly PermissionAction[]> = {
51
+ // Гибрид: агенту можно менять файлы, но не выполнять команды и не задавать
52
+ // вопросы (автономная задача всё равно некому на них ответить).
53
+ hybrid: ["read", "edit", "glob", "grep", "subagent", "skill", "webfetch", "websearch"],
54
+ // Строгий режим: только чтение и анализ исходников.
55
+ secure: ["read", "glob", "grep", "skill"],
56
+ // Прежнее поведение 1.5.x: разрешено всё.
57
+ legacy: [...PERMISSION_ACTIONS],
58
+ };
59
+
60
+ export interface PermissionInput {
61
+ /** Глобальная политика из SchedulerSettings.permissions.defaultPolicy. */
62
+ policy?: PermissionPolicy | string | null;
63
+ /** Переходный флаг задачи: вернуть shell в гибридной политике. */
64
+ legacyShell?: boolean;
65
+ /** Явный allowlist задачи (уже нормализованный или сырой). */
66
+ allowedTools?: readonly string[] | null;
67
+ /** Явный denylist задачи. */
68
+ deniedTools?: readonly string[] | null;
69
+ }
70
+
71
+ export interface EffectivePermission {
72
+ action: PermissionAction;
73
+ resource: "*";
74
+ effect: "allow" | "deny";
75
+ }
76
+
77
+ export interface DeniedByPolicy {
78
+ action: PermissionAction;
79
+ hint: string;
80
+ }
81
+
82
+ export interface EffectivePermissions {
83
+ policy: PermissionPolicy;
84
+ legacyShell: boolean;
85
+ permissions: EffectivePermission[];
86
+ /**
87
+ * Действия, запрещённые именно политикой по умолчанию (а не списками
88
+ * задачи). Используется для аудита и подсказок в логе.
89
+ */
90
+ deniedByPolicy: DeniedByPolicy[];
91
+ }
92
+
93
+ /** Приводит произвольное значение к известной политике. */
94
+ export function normalizePolicy(
95
+ value: unknown,
96
+ fallback: PermissionPolicy = DEFAULT_PERMISSION_POLICY
97
+ ): PermissionPolicy {
98
+ return typeof value === "string" &&
99
+ (PERMISSION_POLICIES as readonly string[]).includes(value)
100
+ ? (value as PermissionPolicy)
101
+ : fallback;
102
+ }
103
+
104
+ /** Нормализует список инструментов: trim, lower-case, без пустых и дублей. */
105
+ export function normalizeToolList(
106
+ value: readonly string[] | null | undefined
107
+ ): string[] {
108
+ return Array.from(
109
+ new Set(
110
+ (value ?? [])
111
+ .map((tool) => String(tool).trim().toLowerCase())
112
+ .filter(Boolean)
113
+ )
114
+ );
115
+ }
116
+
117
+ function actionsForTools(tools: Iterable<string>): Set<PermissionAction> {
118
+ const result = new Set<PermissionAction>();
119
+ for (const tool of tools) {
120
+ for (const action of PERMISSION_ACTIONS) {
121
+ if (ACTION_ALIASES[action].includes(tool)) result.add(action);
122
+ }
123
+ }
124
+ return result;
125
+ }
126
+
127
+ function hintFor(action: PermissionAction): string {
128
+ switch (action) {
129
+ case "shell":
130
+ return "shell запрещён политикой: добавьте shell в allowedTools задачи либо вынесите команду в qualityGate/afterScript.";
131
+ case "question":
132
+ return "question запрещён политикой: автономная задача не может ответить на вопрос; уберите интерактивный шаг или добавьте question в allowedTools.";
133
+ case "edit":
134
+ return "edit запрещён политикой secure: добавьте edit/write в allowedTools или выберите политику hybrid/legacy.";
135
+ default:
136
+ return `${action} запрещён политикой secure: добавьте ${action} в allowedTools или выберите политику hybrid/legacy.`;
137
+ }
138
+ }
139
+
140
+ /**
141
+ * Вычисляет эффективные права задачи.
142
+ *
143
+ * Порядок:
144
+ * 1. базовая политика (hybrid/secure/legacy), legacyShell возвращает shell;
145
+ * 2. deniedTools переводит действие в deny (выигрывает всегда);
146
+ * 3. непустой allowedTools превращается в allowlist и может явно вернуть
147
+ * действие, запрещённое политикой (кроме явно запрещённых deniedTools).
148
+ */
149
+ export function resolvePermissions(input: PermissionInput = {}): EffectivePermissions {
150
+ const policy = normalizePolicy(input.policy);
151
+ const legacyShell = input.legacyShell === true;
152
+ const allowed = actionsForTools(normalizeToolList(input.allowedTools));
153
+ const denied = actionsForTools(normalizeToolList(input.deniedTools));
154
+
155
+ const base = new Set<PermissionAction>(POLICY_BASE[policy]);
156
+ if (policy === "hybrid" && legacyShell) base.add("shell");
157
+
158
+ const permissions: EffectivePermission[] = PERMISSION_ACTIONS.map((action) => {
159
+ let effect: "allow" | "deny" = base.has(action) ? "allow" : "deny";
160
+ if (denied.has(action)) effect = "deny";
161
+ else if (allowed.size > 0) effect = allowed.has(action) ? "allow" : "deny";
162
+ return { action, resource: "*", effect };
163
+ });
164
+
165
+ const deniedByPolicy: DeniedByPolicy[] = [];
166
+ for (const entry of permissions) {
167
+ if (entry.effect !== "deny") continue;
168
+ if (denied.has(entry.action)) continue;
169
+ // Если список allowedTools непустой, запрет мог быть вызван им.
170
+ if (allowed.size > 0) continue;
171
+ deniedByPolicy.push({
172
+ action: entry.action,
173
+ hint: hintFor(entry.action),
174
+ });
175
+ }
176
+
177
+ return { policy, legacyShell, permissions, deniedByPolicy };
178
+ }
179
+
180
+ /** Готовый OPENCODE_CONFIG_CONTENT для обёрток. */
181
+ export function buildOpencodeConfig(input: PermissionInput = {}): string {
182
+ const effective = resolvePermissions(input);
183
+ return JSON.stringify(
184
+ {
185
+ $schema: "https://opencode.ai/config.json",
186
+ permissions: effective.permissions,
187
+ },
188
+ null,
189
+ 2
190
+ );
191
+ }
192
+
193
+ /** Краткое описание политики для лога задачи. */
194
+ export function formatPolicyLog(effective: EffectivePermissions): string {
195
+ const denied = effective.permissions
196
+ .filter((p) => p.effect === "deny")
197
+ .map((p) => p.action);
198
+ const legacyShell = effective.legacyShell ? ", legacyShell=true" : "";
199
+ return `policy=${effective.policy}${legacyShell}, denied=${denied.length > 0 ? denied.join(",") : "none"}`;
200
+ }