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.
- package/CHANGELOG.md +107 -2
- package/CROSS_PLATFORM.md +107 -71
- package/LICENSE +21 -21
- package/README.md +74 -26
- package/ROADMAP-STRATEGY.md +11 -4
- package/ROADMAP.md +322 -112
- package/dist/core/analytics.d.ts +3 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +4 -0
- package/dist/core/audit.d.ts +2 -1
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +32 -1
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +21 -4
- package/dist/core/file-watcher.d.ts.map +1 -1
- package/dist/core/file-watcher.js +16 -1
- package/dist/core/git-trigger.d.ts +4 -2
- package/dist/core/git-trigger.d.ts.map +1 -1
- package/dist/core/git-trigger.js +34 -16
- package/dist/core/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +14 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +81 -4
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +3 -2
- package/dist/core/native-notify.d.ts.map +1 -1
- package/dist/core/native-notify.js +3 -0
- package/dist/core/one-shot.d.ts +7 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +15 -2
- package/dist/core/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -0
- package/dist/core/ps-wrapper.d.ts +9 -30
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +477 -108
- package/dist/core/record-history.d.ts +11 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +106 -4
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -0
- package/dist/core/schedule-gate.js +7 -3
- package/dist/core/schedule-v2.js +1 -1
- package/dist/core/scheduler/index.d.ts +13 -1
- package/dist/core/scheduler/index.d.ts.map +1 -1
- package/dist/core/scheduler/index.js +35 -4
- package/dist/core/scheduler/linux.d.ts +4 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +53 -20
- package/dist/core/scheduler/mac.d.ts +2 -1
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +24 -6
- package/dist/core/scheduler/posix.d.ts +1 -1
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +2 -2
- package/dist/core/scheduler/registry.d.ts +3 -2
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +6 -5
- package/dist/core/scheduler/windows.d.ts +49 -1
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +219 -34
- package/dist/core/secrets.d.ts +5 -3
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +86 -8
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/session.d.ts +11 -3
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +34 -5
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +10 -0
- package/dist/core/telegram.d.ts.map +1 -1
- package/dist/core/telegram.js +228 -47
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +15 -3
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +153 -120
- package/dist/db/history-repo.d.ts +1 -1
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +29 -14
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +31 -0
- package/dist/history.d.ts +2 -2
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +3 -3
- package/dist/i18n.d.ts +25 -2
- package/dist/i18n.d.ts.map +1 -1
- package/dist/i18n.js +75 -10
- package/dist/index.d.ts +66 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +527 -68
- package/dist/integrations.d.ts +9 -1
- package/dist/integrations.d.ts.map +1 -1
- package/dist/integrations.js +34 -6
- package/dist/notifications.d.ts +30 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +289 -10
- package/dist/profiles.d.ts +1 -1
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +21 -3
- package/dist/rpc.d.ts +401 -5
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +138 -5
- package/dist/server.d.ts +20 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +136 -14
- package/dist/settings.d.ts +167 -3
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +322 -3
- package/dist/task-transfer.d.ts +8 -1
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +2 -2
- package/dist/types.d.ts +8 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +23 -5
- package/dist/workspaces.d.ts +9 -0
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +25 -0
- package/docs/ARCHITECTURE.md +48 -28
- package/docs/CONCEPT.md +230 -0
- package/docs/CROSS_PLATFORM.ru.md +150 -0
- package/docs/CROSS_PLATFORM.zh.md +146 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +141 -44
- package/docs/FEATURES.zh.md +655 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +17 -0
- package/docs/README.ru.md +22 -16
- package/docs/README.zh.md +286 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +8 -8
- package/locales/en.json +85 -0
- package/locales/ru.json +85 -0
- package/locales/zh.json +780 -0
- package/package.json +31 -7
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +4 -3
- package/skills/scheduled-job-best-practices/SKILL.md +6 -3
- package/skills/scheduled-job-best-practices/references/recipes.md +40 -0
- package/src/core/analytics.ts +10 -0
- package/src/core/audit.ts +39 -1
- package/src/core/cron-to-schtasks.ts +23 -4
- package/src/core/file-watcher.ts +20 -1
- package/src/core/git-trigger.ts +34 -16
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +88 -3
- package/src/core/matrix.ts +5 -1
- package/src/core/native-notify.ts +3 -0
- package/src/core/one-shot.ts +18 -2
- package/src/core/permissions.ts +200 -0
- package/src/core/ps-wrapper.ts +492 -108
- package/src/core/record-history.ts +111 -4
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +9 -3
- package/src/core/schedule-v2.ts +1 -1
- package/src/core/scheduler/index.ts +41 -3
- package/src/core/scheduler/linux.ts +67 -22
- package/src/core/scheduler/mac.ts +24 -7
- package/src/core/scheduler/posix.ts +2 -2
- package/src/core/scheduler/registry.ts +7 -5
- package/src/core/scheduler/windows.ts +237 -32
- package/src/core/secrets.ts +101 -7
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +40 -5
- package/src/core/shutdown.ts +69 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +266 -55
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +181 -138
- package/src/db/history-repo.ts +31 -18
- package/src/db/schema.ts +31 -0
- package/src/gui.tsx +551 -14
- package/src/history.ts +7 -3
- package/src/i18n.ts +87 -13
- package/src/index.ts +649 -71
- package/src/integrations.ts +50 -6
- package/src/notifications.ts +468 -5
- package/src/profiles.ts +21 -3
- package/src/rpc.ts +143 -5
- package/src/server.ts +135 -16
- package/src/settings.ts +582 -5
- package/src/task-transfer.ts +10 -3
- package/src/types.ts +24 -5
- package/src/workspaces.ts +22 -0
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -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 (
|
|
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,
|
|
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 |
|
|
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,
|
|
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)
|
|
323
|
-
`locales/en.json`. Keys are dot-separated and grouped by surface —
|
|
324
|
-
`tool.*`, `dryRun.*`, `matrix.*`, `schedule.*` — and
|
|
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
|
|
331
|
-
|
|
332
|
-
|
|
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
|
|
349
|
-
values; `npm run test:en`
|
|
350
|
-
`OPENCODE_SCHEDULER_LOCALE` only overrides the initial locale for tests
|
|
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** (
|
|
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
|
-
- **
|
|
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` (
|
|
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.
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
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
|
-
|
|
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:
|
package/docs/CONCEPT.md
ADDED
|
@@ -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`.
|