opencode-windows-scheduler 1.5.2 → 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 (231) hide show
  1. package/CHANGELOG.md +107 -2
  2. package/CROSS_PLATFORM.md +107 -71
  3. package/LICENSE +21 -21
  4. package/README.md +74 -26
  5. package/ROADMAP-STRATEGY.md +11 -4
  6. package/ROADMAP.md +322 -112
  7. package/dist/core/analytics.d.ts +3 -0
  8. package/dist/core/analytics.d.ts.map +1 -1
  9. package/dist/core/analytics.js +4 -0
  10. package/dist/core/audit.d.ts +2 -1
  11. package/dist/core/audit.d.ts.map +1 -1
  12. package/dist/core/audit.js +32 -1
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  14. package/dist/core/cron-to-schtasks.js +21 -4
  15. package/dist/core/file-watcher.d.ts.map +1 -1
  16. package/dist/core/file-watcher.js +16 -1
  17. package/dist/core/git-trigger.d.ts +4 -2
  18. package/dist/core/git-trigger.d.ts.map +1 -1
  19. package/dist/core/git-trigger.js +34 -16
  20. package/dist/core/local-ai.d.ts +52 -0
  21. package/dist/core/local-ai.d.ts.map +1 -0
  22. package/dist/core/local-ai.js +119 -0
  23. package/dist/core/lock.d.ts +14 -0
  24. package/dist/core/lock.d.ts.map +1 -1
  25. package/dist/core/lock.js +81 -4
  26. package/dist/core/matrix.d.ts.map +1 -1
  27. package/dist/core/matrix.js +3 -2
  28. package/dist/core/native-notify.d.ts.map +1 -1
  29. package/dist/core/native-notify.js +3 -0
  30. package/dist/core/one-shot.d.ts +7 -1
  31. package/dist/core/one-shot.d.ts.map +1 -1
  32. package/dist/core/one-shot.js +15 -2
  33. package/dist/core/permissions.d.ts +69 -0
  34. package/dist/core/permissions.d.ts.map +1 -0
  35. package/dist/core/permissions.js +143 -0
  36. package/dist/core/ps-wrapper.d.ts +9 -30
  37. package/dist/core/ps-wrapper.d.ts.map +1 -1
  38. package/dist/core/ps-wrapper.js +477 -108
  39. package/dist/core/record-history.d.ts +11 -0
  40. package/dist/core/record-history.d.ts.map +1 -1
  41. package/dist/core/record-history.js +106 -4
  42. package/dist/core/savings.d.ts +70 -0
  43. package/dist/core/savings.d.ts.map +1 -0
  44. package/dist/core/savings.js +87 -0
  45. package/dist/core/schedule-gate.js +7 -3
  46. package/dist/core/schedule-v2.js +1 -1
  47. package/dist/core/scheduler/index.d.ts +13 -1
  48. package/dist/core/scheduler/index.d.ts.map +1 -1
  49. package/dist/core/scheduler/index.js +35 -4
  50. package/dist/core/scheduler/linux.d.ts +4 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +53 -20
  53. package/dist/core/scheduler/mac.d.ts +2 -1
  54. package/dist/core/scheduler/mac.d.ts.map +1 -1
  55. package/dist/core/scheduler/mac.js +24 -6
  56. package/dist/core/scheduler/posix.d.ts +1 -1
  57. package/dist/core/scheduler/posix.d.ts.map +1 -1
  58. package/dist/core/scheduler/posix.js +2 -2
  59. package/dist/core/scheduler/registry.d.ts +3 -2
  60. package/dist/core/scheduler/registry.d.ts.map +1 -1
  61. package/dist/core/scheduler/registry.js +6 -5
  62. package/dist/core/scheduler/windows.d.ts +49 -1
  63. package/dist/core/scheduler/windows.d.ts.map +1 -1
  64. package/dist/core/scheduler/windows.js +219 -34
  65. package/dist/core/secrets.d.ts +5 -3
  66. package/dist/core/secrets.d.ts.map +1 -1
  67. package/dist/core/secrets.js +86 -8
  68. package/dist/core/self-analysis.d.ts +117 -0
  69. package/dist/core/self-analysis.d.ts.map +1 -0
  70. package/dist/core/self-analysis.js +539 -0
  71. package/dist/core/session.d.ts +11 -3
  72. package/dist/core/session.d.ts.map +1 -1
  73. package/dist/core/session.js +34 -5
  74. package/dist/core/shutdown.d.ts +26 -0
  75. package/dist/core/shutdown.d.ts.map +1 -0
  76. package/dist/core/shutdown.js +49 -0
  77. package/dist/core/summary.d.ts +69 -0
  78. package/dist/core/summary.d.ts.map +1 -0
  79. package/dist/core/summary.js +250 -0
  80. package/dist/core/telegram.d.ts +10 -0
  81. package/dist/core/telegram.d.ts.map +1 -1
  82. package/dist/core/telegram.js +228 -47
  83. package/dist/core/triage-chain.d.ts +40 -0
  84. package/dist/core/triage-chain.d.ts.map +1 -0
  85. package/dist/core/triage-chain.js +80 -0
  86. package/dist/core/triage-compare.d.ts +68 -0
  87. package/dist/core/triage-compare.d.ts.map +1 -0
  88. package/dist/core/triage-compare.js +184 -0
  89. package/dist/core/triage-rules.d.ts +23 -0
  90. package/dist/core/triage-rules.d.ts.map +1 -0
  91. package/dist/core/triage-rules.js +196 -0
  92. package/dist/core/triage-shadow.d.ts +91 -0
  93. package/dist/core/triage-shadow.d.ts.map +1 -0
  94. package/dist/core/triage-shadow.js +160 -0
  95. package/dist/core/triage-worker.d.ts +55 -0
  96. package/dist/core/triage-worker.d.ts.map +1 -0
  97. package/dist/core/triage-worker.js +314 -0
  98. package/dist/core/triage.d.ts +76 -0
  99. package/dist/core/triage.d.ts.map +1 -0
  100. package/dist/core/triage.js +271 -0
  101. package/dist/core/watch-paths.d.ts +6 -0
  102. package/dist/core/watch-paths.d.ts.map +1 -0
  103. package/dist/core/watch-paths.js +62 -0
  104. package/dist/core/wrappers/bash.d.ts +15 -3
  105. package/dist/core/wrappers/bash.d.ts.map +1 -1
  106. package/dist/core/wrappers/bash.js +153 -120
  107. package/dist/db/history-repo.d.ts +1 -1
  108. package/dist/db/history-repo.d.ts.map +1 -1
  109. package/dist/db/history-repo.js +29 -14
  110. package/dist/db/schema.d.ts +1 -1
  111. package/dist/db/schema.d.ts.map +1 -1
  112. package/dist/db/schema.js +31 -0
  113. package/dist/history.d.ts +2 -2
  114. package/dist/history.d.ts.map +1 -1
  115. package/dist/history.js +3 -3
  116. package/dist/i18n.d.ts +25 -2
  117. package/dist/i18n.d.ts.map +1 -1
  118. package/dist/i18n.js +75 -10
  119. package/dist/index.d.ts +66 -3
  120. package/dist/index.d.ts.map +1 -1
  121. package/dist/index.js +527 -68
  122. package/dist/integrations.d.ts +9 -1
  123. package/dist/integrations.d.ts.map +1 -1
  124. package/dist/integrations.js +34 -6
  125. package/dist/notifications.d.ts +30 -2
  126. package/dist/notifications.d.ts.map +1 -1
  127. package/dist/notifications.js +289 -10
  128. package/dist/profiles.d.ts +1 -1
  129. package/dist/profiles.d.ts.map +1 -1
  130. package/dist/profiles.js +21 -3
  131. package/dist/rpc.d.ts +401 -5
  132. package/dist/rpc.d.ts.map +1 -1
  133. package/dist/rpc.js +138 -5
  134. package/dist/server.d.ts +20 -0
  135. package/dist/server.d.ts.map +1 -1
  136. package/dist/server.js +136 -14
  137. package/dist/settings.d.ts +167 -3
  138. package/dist/settings.d.ts.map +1 -1
  139. package/dist/settings.js +322 -3
  140. package/dist/task-transfer.d.ts +8 -1
  141. package/dist/task-transfer.d.ts.map +1 -1
  142. package/dist/task-transfer.js +2 -2
  143. package/dist/types.d.ts +8 -1
  144. package/dist/types.d.ts.map +1 -1
  145. package/dist/types.js +23 -5
  146. package/dist/workspaces.d.ts +9 -0
  147. package/dist/workspaces.d.ts.map +1 -1
  148. package/dist/workspaces.js +25 -0
  149. package/docs/ARCHITECTURE.md +48 -28
  150. package/docs/CONCEPT.md +230 -0
  151. package/docs/CROSS_PLATFORM.ru.md +150 -0
  152. package/docs/CROSS_PLATFORM.zh.md +146 -0
  153. package/docs/FAQ.md +52 -0
  154. package/docs/FAQ.ru.md +53 -0
  155. package/docs/FAQ.zh.md +43 -0
  156. package/docs/FEATURES.md +141 -44
  157. package/docs/FEATURES.zh.md +655 -0
  158. package/docs/LOCAL-AI.md +300 -0
  159. package/docs/MIGRATION.md +17 -0
  160. package/docs/README.ru.md +22 -16
  161. package/docs/README.zh.md +286 -0
  162. package/docs/SAVINGS.md +61 -0
  163. package/docs/SAVINGS.ru.md +60 -0
  164. package/docs/SAVINGS.zh.md +52 -0
  165. package/docs/ZH-LOCALE-PLAN.md +324 -0
  166. package/docs/spikes/local-model-structured-output.md +81 -0
  167. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  168. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  169. package/gui-experimental.cjs +8 -8
  170. package/locales/en.json +85 -0
  171. package/locales/ru.json +85 -0
  172. package/locales/zh.json +780 -0
  173. package/package.json +31 -7
  174. package/scripts/bench-local.mjs +321 -0
  175. package/scripts/check-zh-locale.mjs +218 -0
  176. package/scripts/run-tests.mjs +236 -0
  177. package/scripts/spike-local-structured.mjs +182 -0
  178. package/scripts/test-locale.mjs +4 -3
  179. package/skills/scheduled-job-best-practices/SKILL.md +6 -3
  180. package/skills/scheduled-job-best-practices/references/recipes.md +40 -0
  181. package/src/core/analytics.ts +10 -0
  182. package/src/core/audit.ts +39 -1
  183. package/src/core/cron-to-schtasks.ts +23 -4
  184. package/src/core/file-watcher.ts +20 -1
  185. package/src/core/git-trigger.ts +34 -16
  186. package/src/core/local-ai.ts +173 -0
  187. package/src/core/lock.ts +88 -3
  188. package/src/core/matrix.ts +5 -1
  189. package/src/core/native-notify.ts +3 -0
  190. package/src/core/one-shot.ts +18 -2
  191. package/src/core/permissions.ts +200 -0
  192. package/src/core/ps-wrapper.ts +492 -108
  193. package/src/core/record-history.ts +111 -4
  194. package/src/core/savings.ts +150 -0
  195. package/src/core/schedule-gate.ts +9 -3
  196. package/src/core/schedule-v2.ts +1 -1
  197. package/src/core/scheduler/index.ts +41 -3
  198. package/src/core/scheduler/linux.ts +67 -22
  199. package/src/core/scheduler/mac.ts +24 -7
  200. package/src/core/scheduler/posix.ts +2 -2
  201. package/src/core/scheduler/registry.ts +7 -5
  202. package/src/core/scheduler/windows.ts +237 -32
  203. package/src/core/secrets.ts +101 -7
  204. package/src/core/self-analysis.ts +744 -0
  205. package/src/core/session.ts +40 -5
  206. package/src/core/shutdown.ts +69 -0
  207. package/src/core/summary.ts +318 -0
  208. package/src/core/telegram.ts +266 -55
  209. package/src/core/triage-chain.ts +125 -0
  210. package/src/core/triage-compare.ts +277 -0
  211. package/src/core/triage-rules.ts +238 -0
  212. package/src/core/triage-shadow.ts +240 -0
  213. package/src/core/triage-worker.ts +344 -0
  214. package/src/core/triage.ts +366 -0
  215. package/src/core/watch-paths.ts +70 -0
  216. package/src/core/wrappers/bash.ts +181 -138
  217. package/src/db/history-repo.ts +31 -18
  218. package/src/db/schema.ts +31 -0
  219. package/src/gui.tsx +551 -14
  220. package/src/history.ts +7 -3
  221. package/src/i18n.ts +87 -13
  222. package/src/index.ts +649 -71
  223. package/src/integrations.ts +50 -6
  224. package/src/notifications.ts +468 -5
  225. package/src/profiles.ts +21 -3
  226. package/src/rpc.ts +143 -5
  227. package/src/server.ts +135 -16
  228. package/src/settings.ts +582 -5
  229. package/src/task-transfer.ts +10 -3
  230. package/src/types.ts +24 -5
  231. package/src/workspaces.ts +22 -0
@@ -33,15 +33,16 @@ model, the modules, the data model and the extension points.
33
33
  The wrapper reports the result back to the database, not to the plugin host.
34
34
  4. **One source of truth for definitions is SQLite.** OS entries are derived artifacts:
35
35
  they can always be recreated from the database with export/import.
36
- 5. **Local first.** No network services, no telemetry, no accounts. The dashboard binds
37
- to localhost only.
36
+ 5. **Local first.** No network services, no telemetry, no accounts by default. The dashboard binds
37
+ to localhost only. Local AI triage (Ollama) is optional and connects only when explicitly enabled
38
+ via `manage_local_ai`.
38
39
 
39
40
  ## Process model
40
41
 
41
42
  ```
42
43
  ┌─────────────────────────────┐
43
44
  │ OpenCode (plugin host) │
44
- │ • agent tools (12) │
45
+ │ • agent tools (25) │
45
46
  │ • sidebar GUI (gui.tsx) │
46
47
  │ • RPC ↔ sidebar │
47
48
  │ • dashboard HTTP server │
@@ -121,7 +122,7 @@ from their clones instead of their own last run.
121
122
 
122
123
  | Path | Role |
123
124
  | --- | --- |
124
- | `src/index.ts` | Plugin lifecycle, 24 agent tools, RPC handlers, task CRUD, view assembly |
125
+ | `src/index.ts` | Plugin lifecycle, 25 agent tools, RPC handlers, task CRUD, view assembly |
125
126
  | `src/rpc.ts` | JSON-schema contracts for every RPC method |
126
127
  | `src/gui.tsx` | OpenCode sidebar panel (SolidJS, built to `gui-experimental.cjs`) |
127
128
  | `src/server.ts` | Local web dashboard HTTP server and HTML rendering |
@@ -130,8 +131,8 @@ from their clones instead of their own last run.
130
131
  | `src/profiles.ts` | Profile directory resolution: per-profile plugin dir (base for `default`, `<base>/profiles/<name>` for named profiles); profile name, marker, port, create/delete/switch |
131
132
  | `src/workspaces.ts` | Workspace registry and path validation; env pairs and `.env` file resolution with secret masking |
132
133
  | `src/templates.ts` | Reusable task templates |
133
- | `src/settings.ts` | Plugin settings: notifications, history retention, audit, interface locale |
134
- | `src/i18n.ts` | Interface locale (`ru` default, `en`), JSON catalogs in `locales/`, ICU subset (`{param}`, `plural`) via built-in `Intl`, fallback to `ru` |
134
+ | `src/settings.ts` | Plugin settings: notifications, history retention, audit, interface locale (`auto`/`ru`/`en`/`zh`) and last known UI locale, local AI/triage |
135
+ | `src/i18n.ts` | Interface locale (`ru` default, `en`/`zh`), BCP 47 mapping, JSON catalogs in `locales/`, ICU subset (`{param}`, `plural`) via built-in `Intl`, fallback to `ru` |
135
136
  | `src/notifications.ts` | Multi-channel delivery (webhook, Telegram, native OS) with retries/backoff, templates, task filters, quiet hours, matrix and stuck-clone notifications, daily/weekly digest |
136
137
  | `src/core/telegram.ts` | Telegram Bot API `sendMessage`: parse-mode escaping, dashboard link, token validation and masking |
137
138
  | `src/core/native-notify.ts` | Native OS notifications: Windows Toast (PowerShell/WinRT), macOS `osascript`, Linux `notify-send`; no external dependency |
@@ -149,6 +150,7 @@ from their clones instead of their own last run.
149
150
  | `src/core/dry-run.ts` | Pipeline simulation (no execution) |
150
151
  | `src/core/lock.ts` | Single-instance lock manager |
151
152
  | `src/core/file-watcher.ts` | chokidar-based file triggers |
153
+ | `src/core/local-ai.ts` | Local AI triage: LLM classifier with rules fallback, shadow mode, fail-open, manage_local_ai backing |
152
154
  | `src/core/cron-to-schtasks.ts` | Cron → Task Scheduler translation |
153
155
  | `src/core/schedule-v2.ts` | Extended cron parser/matcher, timezone math, launch windows, poll-mode decisions |
154
156
  | `src/core/schedule-gate.ts` | Wrapper-side gate: cron re-check (poll mode), window postpone, defer-file |
@@ -311,32 +313,36 @@ never requires a manual migration.
311
313
 
312
314
  | Interface | Audience | Entry point |
313
315
  | --- | --- | --- |
314
- | Agent tools | AI agent | 24 tools registered via `ctx.tool.transform` |
316
+ | Agent tools | AI agent | 25 tools registered via `ctx.tool.transform` |
315
317
  | Agent skill | AI agent | `skills/scheduled-job-best-practices` |
316
- | RPC | Sidebar GUI | `src/rpc.ts` contracts, ~30 methods |
318
+ | RPC | Sidebar GUI | `src/rpc.ts` contracts, 44 methods |
317
319
  | Sidebar GUI | Human | `gui-experimental.cjs` |
318
320
  | Web dashboard | Human | `startDashboardServer` (localhost, random/fixed port) |
319
321
 
320
322
  ## Localization
321
323
 
322
- User-visible text lives in flat JSON catalogs: `locales/ru.json` (default) and
323
- `locales/en.json`. Keys are dot-separated and grouped by surface — `gui.*`, `notify.*`,
324
- `tool.*`, `dryRun.*`, `matrix.*`, `schedule.*` — and both catalogs must have the same
325
- key set with non-empty values.
324
+ User-visible text lives in flat JSON catalogs: `locales/ru.json` (default),
325
+ `locales/en.json` and `locales/zh.json`. Keys are dot-separated and grouped by surface —
326
+ `gui.*`, `notify.*`, `tool.*`, `dryRun.*`, `matrix.*`, `schedule.*` — and all catalogs
327
+ must have the same key set with non-empty values.
326
328
 
327
329
  `src/i18n.ts` loads the catalogs once and caches them. It exposes `t(key, params)`,
328
330
  `setLocale(locale)`, `messageIn(locale, key)` and `hasKey(key, locale)`. Lookup order is
329
331
  active locale → `en` → `ru` → the key itself, so a missing translation never renders as
330
- an empty string. The `locale` setting (`ru` default, `en` optional) is applied
331
- immediately, without restarting OpenCode. The sidebar GUI embeds the catalogs at build
332
- time via `registerCatalog`, because a webview bundle cannot read package files at
332
+ an empty string. The `locale` setting (`ru` default, `en`/`zh` optional, `auto` follows
333
+ the OpenCode interface language) is applied immediately, without restarting OpenCode.
334
+ `auto` is resolved in the GUI through `ctx.locale.locale()` with BCP 47 prefix mapping
335
+ (`zh-CN` → `zh`, `en-GB` → `en`); the resolved value is sent to the server as `uiLocale`,
336
+ because the server process cannot see the window. The sidebar GUI embeds the catalogs at
337
+ build time via `registerCatalog`, because a webview bundle cannot read package files at
333
338
  runtime.
334
339
 
335
340
  The template subset is deliberately small and dependency-free:
336
341
 
337
342
  - `{name}` — interpolation; the caller formats the value (duration, money, date).
338
343
  - `{count, plural, one {…} few {…} many {…} other {…}}` — plural forms through
339
- `Intl.PluralRules` for the active locale (`ru` uses one/few/many, `en` one/other).
344
+ `Intl.PluralRules` for the active locale (`ru` uses one/few/many, `en` one/other,
345
+ `zh` only `other`).
340
346
 
341
347
  Rules:
342
348
 
@@ -345,17 +351,17 @@ Rules:
345
351
  - store stable codes, not localized text, in the database; translate at render time;
346
352
  - agent tool descriptions, schemas and API payloads stay English; `console.*`
347
353
  diagnostics stay Russian;
348
- - add every new key to both catalogs. `test-docs.mjs` enforces parity and non-empty
349
- values; `npm run test:en` replays all suites under `en` and CI runs it on Linux.
350
- `OPENCODE_SCHEDULER_LOCALE` only overrides the initial locale for tests and services —
351
- it is not a user-facing setting.
354
+ - add every new key to all catalogs. `test-docs.mjs` enforces parity and non-empty
355
+ values; `npm run test:en` and `npm run test:zh` replay all suites under `en`/`zh` and
356
+ CI runs them. `OPENCODE_SCHEDULER_LOCALE` only overrides the initial locale for tests
357
+ and services — it is not a user-facing setting.
352
358
 
353
359
  ## Security model
354
360
 
355
361
  - The dashboard has **no authentication** and binds to localhost. Do not expose it.
356
362
  - A job definition is **code**: prompts, hooks, Quality Gates and wrappers all execute
357
363
  with your user privileges. Treat task creation like granting shell access.
358
- - `allowedTools` / `deniedTools` are **enforced at the run-wrapper level** (спринт 29.2).
364
+ - `allowedTools` / `deniedTools` are **enforced at the run-wrapper level** (Sprint 29.2).
359
365
  Before each `opencode run`, the wrapper passes `permissions` rules through
360
366
  `OPENCODE_CONFIG_CONTENT`: `deniedTools` are mapped to `effect: "deny"` for the
361
367
  corresponding OpenCode action (`shell`, `edit`, `glob`, `grep`, `webfetch`,
@@ -364,7 +370,14 @@ Rules:
364
370
  project-level `opencode.jsonc` is preserved and parallel tasks in one workdir do not
365
371
  race. The wrapper passes `--auto` so non-denied permissions are auto-approved.
366
372
  `allowedTools`/`deniedTools` metadata is still recorded in history for audit.
367
- - **Audit of blocked tools (спринт 29.4):** when a task definition is saved,
373
+ - **Default policy (`src/core/permissions.ts`):** the baseline is
374
+ `permissions.defaultPolicy` — `hybrid` (default) denies `shell` and `question` while
375
+ allowing read/edit/glob/grep/subagent/skill/webfetch/websearch, `secure` allows only
376
+ read/glob/grep/skill, `legacy` allows everything (1.5.x behaviour). Task `legacyShell`
377
+ re-enables `shell` under `hybrid`; `deniedTools` still wins. Policy denials are
378
+ audited as `tool.blocked` with `reason: "default-policy"`, and each wrapper logs
379
+ `policy=<name>, denied=<actions>` before the run.
380
+ - **Audit of blocked tools (Sprint 29.4):** when a task definition is saved,
368
381
  `recordTaskToolBlocks()` writes one `tool.blocked` audit event per entry in
369
382
  `deniedTools` (`target` = task name, `details.tool` = tool, plus `allowedTools`,
370
383
  `deniedTools` and `reason`). In allow-list mode one event with `tool: "*"` records
@@ -377,7 +390,9 @@ Rules:
377
390
  Workspace `env` can reference secrets as `${secret:NAME}`; values are masked in
378
391
  logs, history and audit. Treat task creation like granting shell access.
379
392
  - Secrets are stored encrypted in `<PLUGIN_DIR>/secrets.json` (AES-256-GCM) with a
380
- 32-byte key file `secrets.key` (rights 0600). Workspace `env` can reference them
393
+ 32-byte key file `secrets.key` (mode 0600 on POSIX; on Windows an ACL that removes
394
+ inheritance and grants the current user only, applied by `icacls` on create and
395
+ re-applied on read for keys created before 1.5.5). Workspace `env` can reference them
381
396
  as `${secret:NAME}`; values are substituted at run time and masked in logs,
382
397
  history and audit.
383
398
  - Workspace paths are validated, but hooks are not sandboxed: only schedule jobs from
@@ -387,12 +402,17 @@ Rules:
387
402
 
388
403
  The effective policy is resolved in this order (later wins):
389
404
 
390
- 1. Task `allowedTools` — if present, every action not listed is denied.
391
- 2. Task `deniedTools` — always denied and takes priority over `allowedTools`.
392
- 3. The generated `opencode.jsonc` — written into the task workdir for the run.
393
- 4. Project `opencode.json(c)` and system config — merged by OpenCode; a closer or
405
+ 1. `permissions.defaultPolicy` — the baseline: `hybrid` (default, no `shell`/`question`),
406
+ `secure` (read-only) or `legacy` (everything allowed, 1.5.x behaviour).
407
+ 2. Task `legacyShell` — re-enables `shell` under `hybrid` only.
408
+ 3. Task `allowedTools` — if present, every action not listed is denied; an explicitly
409
+ listed action can override a policy denial.
410
+ 4. Task `deniedTools` — always denied and takes priority over `allowedTools`.
411
+ 5. The generated `OPENCODE_CONFIG_CONTENT` — passed in the wrapper environment; no file
412
+ is written and the project config stays untouched.
413
+ 6. Project `opencode.json(c)` and system config — merged by OpenCode; a closer or
394
414
  system-level config can weaken task-scoped denies (see limitations below).
395
- 5. `--auto` — auto-approves everything that remains, so no interactive prompts block
415
+ 7. `--auto` — auto-approves everything that remains, so no interactive prompts block
396
416
  an unattended run.
397
417
 
398
418
  Tool mapping used by both wrappers:
@@ -0,0 +1,230 @@
1
+ # CONCEPT — Верифицируемая локально-первая оркестрация агент-задач
2
+
3
+ > Статус: черновик цели (north star). Рабочее имя пакета — TBD (см. шаг rename).
4
+ > Это документ-направление: любое решение по фиче сверяется с ним.
5
+
6
+ ## TL;DR
7
+
8
+ Локальные модели слабы в открытом творчестве, но компетентны в ограниченной,
9
+ проверяемой работе. Объективная проверка дёшева и надёжна. Поэтому: дешёвая
10
+ локальная модель пытается сделать **максимум проверяемой работы**; объективный
11
+ гейт решает, принято или эскалировать в дорогое облако; каждый исход учит
12
+ систему — роутинг точнее, локальные модели способнее именно под твои задачи.
13
+ Со временем локальный сетап становится личной, приватной, дешёвой и всё более
14
+ умной рабочей силой.
15
+
16
+ Это и есть продукт. Всё остальное — обвязка.
17
+
18
+ ---
19
+
20
+ ## 1. Проблема
21
+
22
+ Разработчику, который хочет автономной agent-работы, сегодня доступны три
23
+ плохих варианта:
24
+
25
+ 1. **Не автоматизировать** — рутина (починить тесты, обновить зависимости,
26
+ бойлерплейт, извлечение, мелкие трансформации) остаётся ручной.
27
+ 2. **Автоматизировать в облаке** — токены на каждый прогон, код уходит наружу,
28
+ нет контроля над тем, что именно исполняется и куда течёт.
29
+ 3. **Автоматизировать локально наивно** — слабая модель молно выдаёт брак,
30
+ падает, двоится; доверия нет, затею бросают.
31
+
32
+ Корень всех трёх: **нет слоя, который делает агент-труд одновременно дешёвым,
33
+ приватным и проверяемо надёжным.**
34
+
35
+ - OpenCode даёт агентов, но не даёт супервизии: нет capability-роутинга,
36
+ объективных гейтов, честной экономии, learning-loop.
37
+ - Облачные оркестраторы дают масштаб, но не приватность и не локальную экономию.
38
+ - Swarm-фреймворки дают коллаборацию, но не надёжность и не экономию.
39
+
40
+ Ниша пуста: **локально-первая, верифицируемая, компаундящаяся оркестрация**.
41
+
42
+ ## 2. Ключевой инсайт
43
+
44
+ Слабость локальных моделей — не приговор, а ограничение, обходимое архитектурой:
45
+
46
+ - Локаль тянет **ограниченные, хорошо scaffolding-нутые, объективно проверяемые**
47
+ задачи. Это и есть масса реальной рутины.
48
+ - **Объективный гейт** (тесты / линт / схема / diff-applies / команда) дёшев и
49
+ не врёт. Он позволяет натравливать локаль на максимум задач: брак ловится и
50
+ эскалируется, а не уезжает в прод.
51
+ - Исходы гейта — **бесплатная разметка**: они учат роутинг («какие типы задач
52
+ локаль тянет») и копят gate-passed датасет для прокачки весов.
53
+
54
+ Проверка — не надзор, а **двигатель экономики и обучения**.
55
+
56
+ ## 3. Что это такое
57
+
58
+ **Фреймворк-супервизор поверх OpenCode**: локальный control plane, который
59
+ принимает миссии (ad-hoc или по расписанию), раскладывает их на шаги с ролями,
60
+ назначает каждый шаг **самому дешёвому способному исполнителю** (локаль →
61
+ облако только при провале гейта), объективно верифицирует результат, честно
62
+ считает экономию и компаундится — с каждой задачей дешевле и умнее под
63
+ конкретного пользователя.
64
+
65
+ Метафора: бригадир смешанной бригады. Дешёвые локальные подмастерья делают
66
+ ограниченную работу под инспекцией; дорогие облачные специалисты вызываются,
67
+ только когда инспекция завалила подмастерье; каждая инспекция делает
68
+ подмастерьев лучше именно в твоих ремёслах.
69
+
70
+ ## 4. Цель и критерии приёмки (north star)
71
+
72
+ Четыре столпа. Любая фича/ADR сверяется с ними; при конфликте порядок такой:
73
+ **надёжно > приватно > дёшево > краткосрочные фичи**, explore — управляемая
74
+ инвестиция «дёшево-сегодня» в «компаунд-завтра».
75
+
76
+ | Столп | Что значит | Метрика |
77
+ |---|---|---|
78
+ | **Дёшево** | локаль закрывает максимум gate-able задач | net-экономия $ (честная контрфактика), local share %, escalation rate, time overhead |
79
+ | **Приватно** | control plane, данные, аудит, triage локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
80
+ | **Надёжно** | ноль тихих отказов/двойных прогонов/fake-done/порчи репо | trust-инциденты = 0; гейт независим от self-report; полнота аудита |
81
+ | **Компаундится** | success rate и экономия растут под пользователя | тренд local success_rate ↑, eval-lift адаптеров, рост scaffolding-библиотеки |
82
+
83
+ Цель одним предложением: **разработчик оставляет AI-агентам свою рутину —
84
+ дёшево, приватно, надёжно — и его локальный сетап с каждой неделей работает
85
+ лучше и дешевле именно под его задачи.**
86
+
87
+ ## 5. Способности (что он делает)
88
+
89
+ - **Миссия** = цель + scope + явный критерий приёмки (гейт). Без критерия —
90
+ не миссия, а лотерея.
91
+ - **Декомпозиция** на шаги/роли (planner → implementer → reviewer …).
92
+ - **Capability-aware роутинг**: локаль по умолчанию по capability-карте;
93
+ облако — эскалация; explore/exploit баланс (учимся на неопределённых,
94
+ выжимаем на известных).
95
+ - **Объективная верификация** (keystone): провал → эскалация / ретрай / откат;
96
+ никогда «готово» на слово агента.
97
+ - **Честная экономика**: savings ledger (net-контрфактика с учётом эскалаций и
98
+ overhead), токены/стоимость по шагам и моделям.
99
+ - **Полный аудит**: кто, каким инструментом, какой файл, когда, почему
100
+ эскалировали.
101
+ - **Learning-loop**: capability-карта по типам задач → scaffolding/few-shot из
102
+ успешных решений → eval-harness → (staged) LoRA-адаптеры на gate-passed
103
+ датасете.
104
+ - **Автономность**: ad-hoc или расписание; переживает ребут; не двоится; не
105
+ зависает; leases/locks/таймауты.
106
+
107
+ ## 6. Исполнительный цикл (его задачи)
108
+
109
+ 1. Принять миссию + критерий приёмки.
110
+ 2. Разложить на шаги, назначить роли.
111
+ 3. Выбрать исполнителя шага (локаль first по capability-карте).
112
+ 4. Выполнить шаг.
113
+ 5. Прогнать объективный гейт.
114
+ 6. Pass → записать экономию + пример + метку (+ training-record).
115
+ Fail → эскалация / ретрай / откат + метка.
116
+ 7. Собрать артефакт миссии (diff/PR, отчёт, аудит-трейл).
117
+ 8. Отчитаться честно (savings, success rate, эскалации, overhead).
118
+ 9. Обновить роутинг/eval; периодически — дообучить адаптер.
119
+
120
+ ## 7. Архитектура (слои)
121
+
122
+ ```
123
+ [ триггеры: ad-hoc CLI/RPC | scheduler | file | git | mcp-event ] ← обвязка
124
+ │
125
+ [ mission intake: цель + scope + критерий приёмки (гейт) ]
126
+ │
127
+ [ planner: декомпозиция на шаги/роли ]
128
+ │
129
+ [ router: capability-карта → локаль first; explore/exploit ]
130
+ │ │ эскалация
131
+ │ ▼
132
+ │ [ облачные модели (fallback / тяжёлая артиллерия) ]
133
+ ▼
134
+ [ executor: OpenCode-агенты (локальные / облачные) ]
135
+ │
136
+ [ GATE: объективная верификация (tests/lint/schema/diff/cmd) ] ← keystone
137
+ │ pass │ fail
138
+ ▼ ▼
139
+ [ ledger: savings/audit/metrics ] [ escalate / retry / rollback ]
140
+ │
141
+ [ learning: capability-карта → scaffolding → eval → LoRA (staged) ]
142
+ │
143
+ [ control plane: локальный, приватный, аудит, dashboard ]
144
+ ```
145
+
146
+ Локально-первым является **control plane и роутинг**; инференс — гибрид
147
+ (локаль максимум, облако эскалация). Приватность = данные/аудит/управление
148
+ локальны, а не «ни одного облачного токена».
149
+
150
+ ## 8. Границы (чем НЕ является)
151
+
152
+ - Не open-ended AGI-swarm: миссии ограниченные, с явным критерием приёмки.
153
+ - Не замена способной облачной модели на сложном: облако — эскалация.
154
+ - Не отмена человеческого ревью критичного: гейт поднимает пол, не потолок.
155
+ - Не облачный SaaS и не multi-machine: локальный control plane, одна машина.
156
+ - Не «плагин-планировщик»: scheduler/уведомления/аналитика — триггеры и
157
+ обвязка, не ядро.
158
+
159
+ ## 9. Душа: flywheel
160
+
161
+ Больше задач → больше локальных попыток → больше исходов гейта → точнее
162
+ capability-карта и больше примеров → выше local success → больше экономия и
163
+ сильнее адаптеры → ещё больше задач выгодно гнать через локаль.
164
+
165
+ Этот цикл и есть продукт. Персональная, приватная, компаундящаяся capability —
166
+ ров, которого нет ни у статичного облака, ни у OpenCode core, ни у swarm-ов.
167
+
168
+ ## 10. Реальность железа (ограничение, учтённое в дизайне)
169
+
170
+ Целевая стартовая конфигурация — потребительская (пример: RTX 3050 8 ГБ,
171
+ 16 ГБ RAM). Отсюда:
172
+ - инференс локально: QLoRA/квант 3–8B;
173
+ - обучение: только QLoRA 3–4B, low-rank, накопленным gate-passed датасетом,
174
+ пакетами, а не онлайн;
175
+ - поэтому прокачка staged: сначала scaffolding/роутинг (дёшево, сразу),
176
+ веса — когда датасет и железо позволяют.
177
+ Дизайн не зависит от конкретного железа: capability-карта и гейты работают и на
178
+ слабой, и на сильной локали; меняется лишь доля задач, которую тянет локаль.
179
+
180
+ ## 11. Как поймём, что пришли (definition of done концепции)
181
+
182
+ Вертикальный срез работает end-to-end и измеримо:
183
+ 1. ad-hoc миссия с явным гейтом принята и разложена;
184
+ 2. шаги смаршрутированы локаль-first по capability-карте;
185
+ 3. гейт объективно верифицировал; провал экалировался/откатился без тихих
186
+ отказов;
187
+ 4. ledger показал честную net-экономию и escalation rate;
188
+ 5. learning-loop обновил capability-карту и положил пример/scaffolding;
189
+ 6. на фикс-наборе задач за N недель: local success_rate ↑ и net-экономия ↑
190
+ при неизменном качестве (eval не деградировал).
191
+
192
+ Когда 1–6 воспроизводимо — концепция достигнута; всё дальнейшее = масштаб
193
+ (больше типов задач, больше машин, сильнее адаптеры).
194
+
195
+ ## 12. Открытые вопросы / риски (честно)
196
+
197
+ - Качество локального вердикта на пограничных задачах → держим правила/пороги и
198
+ shadow-режим, а не слепую веру модели.
199
+ - Cost of verification (прогоны тестов) → учитывать в net-экономике, кэшировать.
200
+ - Explore может тратить впустую → capped explore-бюджет, bandit по типам задач.
201
+ - Датасет для весов копится медленно → staged-прокачка, не обещать онлайн-LoRA.
202
+ - Prompt-injection даже при gate → гейт + аудит + allowedTools как пол, а не
203
+ потолок; критичное — человеку.
204
+
205
+ ## 13. Стратегия развития: от плагина к фреймворку
206
+
207
+ Наша эволюция строится на двух столпах и постепенной абстракции:
208
+
209
+ ### 13.1 Локальный интеллект
210
+
211
+ Максимум проверяемой работы на локальных моделях с компандингом (обучением на успешных гейтах). Локаль тянет ограниченные, хорошо сформулированные, объективно проверяемые задачи — масса реальной рутины. Объективный гейт (тесты, линт, схема, diff-applies) дёшев и не врёт, поэтому локаль направляется на максимум задач: брак ловится и эскалируется, а не уезжает в прод. Исходы гейта — бесплатная разметка, которая учит роутинг и копит gate-passed датасет.
212
+
213
+ ### 13.2 Мультиагентная оркестрация
214
+
215
+ Ролевая декомпозиция миссий на шаги (planner → implementer → reviewer …). Каждый шаг назначается самому дешёвому способному исполнителю — локаль first, облако только при провале гейта. Облако используется для эскалации сложных задач, обеспечивая экономию и приватность.
216
+
217
+ ### 13.3 Непрерывное улучшение Control Plane
218
+
219
+ Существующий функционал (планировщик, DAG, матрицы, Quality Gates, GUI, аудит) — это фундамент доверия, а не отдельный продукт. Он дорабатывается наравне с ядром: локальность, приватность, наблюдаемость, гарантии отсутствия тихих отказов.
220
+
221
+ ### 13.4 Путь к универсальности
222
+
223
+ - **Этап 1:** глубокая интеграция с OpenCode v2 (текущий).
224
+ - **Этап 2:** абстракция слоя исполнения (Agent Executor Interface).
225
+ - **Этап 3:** универсальный фреймворк оркестрации, совместимый с любым агентом через MCP или стандартные API.
226
+
227
+ ---
228
+
229
+ *Любое изменение в репозитории, которое не двигает хотя бы один столп из §4 и
230
+ не согласуется с §8, — не цель, а шум.*
@@ -0,0 +1,150 @@
1
+ # Кроссплатформенность: Windows → macOS → Linux
2
+
3
+ Плагин больше не привязан к `schtasks`. Планировщик вынесен в абстрактный слой с тремя реализациями,
4
+ а обёртки запуска генерируются под целевую ОС.
5
+
6
+ Translations: [English](../CROSS_PLATFORM.md) · [中文](CROSS_PLATFORM.zh.md)
7
+
8
+ ## Архитектура
9
+
10
+ ```
11
+ src/
12
+ index.ts # инструменты, RPC, жизненный цикл плагина
13
+ gui.tsx # панель GUI (заголовок берётся из RPC)
14
+ server.ts # веб-дашборд (заголовок динамический)
15
+ core/
16
+ scheduler/
17
+ types.ts # SchedulerBackend, CreateTaskOptions, RunTaskResult
18
+ index.ts # фабрика createSchedulerBackend() + getSchedulerTitle()
19
+ windows.ts # WindowsScheduler (schtasks)
20
+ linux.ts # LinuxScheduler (crontab)
21
+ mac.ts # MacScheduler (launchd / LaunchAgents)
22
+ posix.ts # общая база для Linux/macOS (реестр задач)
23
+ registry.ts # персистентный реестр задач POSIX-бэкендов
24
+ logs.ts # чтение логов задач (кроссплатформенно)
25
+ wrappers/
26
+ bash.ts # генератор .sh-обёрток для Linux/macOS
27
+ ps-wrapper.ts # .ps1/.cmd-обёртки для Windows (как раньше)
28
+ record-history.ts # метрики/история + retry/цепочки (через бэкенд)
29
+ cron-to-schtasks.ts # cron → schtasks (только Windows)
30
+ ```
31
+
32
+ ### Интерфейс
33
+
34
+ ```ts
35
+ interface SchedulerBackend {
36
+ readonly platform: NodeJS.Platform;
37
+ readonly title: string; // «Планировщик Windows» / «OpenCode Scheduler»
38
+ createTask(options: CreateTaskOptions): Promise<void>;
39
+ deleteTask(name: string): Promise<void>;
40
+ runTask(name: string): Promise<RunTaskResult>;
41
+ listTasks(): Promise<ScheduledTaskInfo[]>;
42
+ pauseTask(name: string): Promise<void>;
43
+ resumeTask(name: string): Promise<void>;
44
+ }
45
+ ```
46
+
47
+ Фабрика выбирает реализацию по `process.platform`:
48
+ `win32 → WindowsScheduler`, `darwin → MacScheduler`, остальные → `LinuxScheduler`.
49
+
50
+ ## Как работает каждая ОС
51
+
52
+ ### Windows (поведение не изменилось)
53
+ - Задачи регистрируются в Планировщике Windows через `schtasks` в папке `\OpenCode\windows-scheduler\`.
54
+ - Обёртка: `run-task.ps1` + персональный `run-<name>.cmd` в `%APPDATA%\opencode\windows-scheduler\wrapper`.
55
+ - Логи: `%APPDATA%\opencode\windows-scheduler\logs\<name>.log`.
56
+ - cron конвертируется в schtasks (`convertCronToSchTasks`) — поддерживается тот же набор шаблонов.
57
+
58
+ ### Linux
59
+ - Задачи живут в управляемом блоке `crontab`:
60
+ ```
61
+ # >>> opencode-scheduler >>>
62
+ # task: my-task
63
+ */5 * * * * /bin/bash '/…/wrapper/run-my-task.sh' >> '/…/logs/my-task.log' 2>&1
64
+ # <<< opencode-scheduler <<<
65
+ ```
66
+ - Пауза = строка с префиксом `# PAUSED: ` (блок пересобирается из реестра).
67
+ - Задачи с триггером `file` в crontab не попадают — их запускает FileWatchManager плагина.
68
+ - Обёртка: `~/.config/opencode/windows-scheduler/wrapper/run-<name>.sh` (chmod 0755).
69
+ - Полный cron-синтаксис (в отличие от Windows), т.к. crontab понимает его нативно.
70
+ - Удаление/пересборка — только своего блока, остальные строки `crontab` не трогаются.
71
+
72
+ ### macOS
73
+ - Задачи — LaunchAgent-плисты `~/Library/LaunchAgents/com.opencode.scheduler.<name>.plist`.
74
+ - Расписание: `StartInterval` для `* * * * *` и `*/N`, `StartCalendarInterval` для `M * * * *`,
75
+ `M H * * *`, `M H * * D`.
76
+ - Пауза = `launchctl unload -w`, возобновление = `launchctl load -w`.
77
+ - Обёртка — тот же `.sh`, что и на Linux; пути конфигов:
78
+ `~/.config/opencode/windows-scheduler/` (или `$XDG_CONFIG_HOME`).
79
+
80
+ ### Общая POSIX-обёртка (`.sh`)
81
+ - `cd` в рабочую директорию, `opencode run` с промптом из файла.
82
+ - Логи пишутся в файл через `>>` и дублируются метками времени.
83
+ - Блокировка через атомарный `mkdir` — защита от параллельных запусков.
84
+ - Таймаут: дочерний процесс + watchdog (`TERM`, затем `KILL`).
85
+ - Quality Gate: `bash -lc "<команда>"` (аналог `cmd.exe /c` на Windows).
86
+ - Метрики: `node "<record-history.js>" <task> <status> <started> <duration> <error> "-" "-"` —
87
+ тот же контракт, что и в PowerShell-обёртке, поэтому история/метрики/retry/цепочки работают везде.
88
+ - `PATH` дополняется `/opt/homebrew/bin`, `/usr/local/bin`, `~/.local/bin`, `~/.bun/bin`.
89
+
90
+ ## Матрица возможностей
91
+
92
+ | Возможность | Windows | Linux | macOS |
93
+ |---|---|---|---|
94
+ | Бэкенд планировщика | `schtasks` | `crontab` | `launchd` LaunchAgents |
95
+ | Нативный cron-поднабор | `* * * * *`, `*/N * * * *` (N ≤ 1439, 60 % N = 0), `M * * * *`, `M H * * *`, `M H * * D` | полный cron | тот же поднабор, что на Windows |
96
+ | Остальные cron-выражения | minute-poll + schedule gate | нативный cron | minute-poll + schedule gate |
97
+ | `*/N` в дне месяца / дне недели | не нативно → poll | нативно | не нативно → poll |
98
+ | Пауза / возобновление | `schtasks /change /disable` / `/enable` | строка `# PAUSED:` в управляемом блоке | `launchctl unload -w` / `load -w` |
99
+ | Файловые триггеры | in-process `FileWatchManager` | так же | так же |
100
+ | Обёртки задач | `.cmd` + `.ps1` | `.sh` | `.sh` |
101
+ | Логи | `%APPDATA%\opencode\windows-scheduler\logs` | `~/.config/opencode/windows-scheduler/logs` | как на Linux |
102
+ | Защита `secrets.key` | `icacls` (только владелец) + `chmod` как fallback | `chmod 0600` | `chmod 0600` |
103
+ | Дашборд | `127.0.0.1`, динамический заголовок | так же | так же |
104
+ | DAG / matrix / quality gates / уведомления | в плагине, не зависят от ОС | так же | так же |
105
+
106
+ ### Компромиссы
107
+
108
+ 1. **Minute-poll.** Cron-выражения вне нативного поднабора и задачи с чужой IANA-зоной
109
+ запускаются планировщиком ОС каждую минуту; `schedule-gate` решает, выполнять ли запуск.
110
+ Цена — один короткоживущий процесс-обёртка на задачу в минуту.
111
+ 2. **`M H */N * *` сознательно не конвертируется в `schtasks /sc DAILY /mo N`.**
112
+ Cron считает дни от 1-го числа каждого месяца и сбрасывается на границе месяца;
113
+ `/mo N` считает дни от даты создания задачи и не сбрасывается. Это не эквивалентные
114
+ расписания, поэтому выражение остаётся в poll-режиме. Нативный вариант потребовал бы
115
+ `MONTHLY` с явным списком `/d`, а не `DAILY /mo N`.
116
+ 3. **DST.** Шлюз работает с локальным настенным временем. Несуществующее время
117
+ (переход весной) пропускается; неоднозначное время (переход осенью) выполняется
118
+ в первом вхождении.
119
+ 4. **`*/N * * * *` на Windows** нативно только при `60 % N = 0` и `N ≤ 1439`.
120
+ Иначе задача уходит в poll-режим: `schtasks /mo N` считает от момента создания,
121
+ а cron — от начала часа.
122
+ 5. **POSIX-обёртки, crontab и launchd не исполнялись на реальных Linux/macOS**
123
+ (см. «Ограничения»); синтаксис и экранирование покрыты только тестами.
124
+
125
+ ## GUI и дашборд
126
+ - Заголовок динамический: на Windows — «Планировщик Windows», на macOS/Linux — «OpenCode Scheduler».
127
+ - Источник заголовка — новый RPC-метод `get_platform` → `{ platform, title }`.
128
+ - Заголовок используется и в панели GUI, и в fallback-панели ошибки, и в `<title>/<h1>` веб-дашборда.
129
+ - Кнопки, статусы, таблица, DAG и метрики не зависят от ОС.
130
+ - Описания инструментов (`schedule_task` и др.) подставляют актуальное название планировщика.
131
+
132
+ ## Сборка и проверки
133
+ - `npm run build` — OK, ошибок нет.
134
+ - `npm run build:gui` — OK (`gui-experimental.cjs`, ~47.7 kB).
135
+ - Проверено в runtime:
136
+ - заголовки для win32/darwin/linux;
137
+ - `cronToLaunchdSchedule` на нескольких выражениях;
138
+ - живой `listTasks()` на Windows — задачи возвращаются короткими именами (без префикса);
139
+ - экранирование `shellQuote` (кавычки, пробелы, кириллица);
140
+ - импорт `dist/index.js` проходит, `dist` не тянет `schtasks.js` напрямую.
141
+
142
+ ## Ограничения и что проверить на реальных машинах
143
+ 1. `.sh`-обёртки и crontab/launchd **не исполнялись** — на текущей Windows-машине нет `bash`/WSL.
144
+ Синтаксис и экранирование проверены вручную; нужен прогон на Linux и macOS.
145
+ 2. cron → launchd поддерживает тот же ограниченный набор шаблонов, что и Windows
146
+ (`* * * * *`, `*/N * * * *`, `M * * * *`, `M H * * *`, `M H * * D`).
147
+ На Linux доступен полный cron.
148
+ 3. Префикс задач Windows (`\OpenCode\windows-scheduler\`) и id плагина сохранены для обратной совместимости.
149
+ 4. `src/schtasks.ts` оставлен как тонкий shim для старых скриптов (`test-create.cjs`, `test-run.cjs`),
150
+ вся логика теперь в `core/scheduler/windows.ts`.