agent-steward 0.0.1 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +399 -0
- package/CROSS_PLATFORM.md +151 -0
- package/README.md +307 -15
- package/ROADMAP-STRATEGY.md +196 -0
- package/ROADMAP.md +184 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +12 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +175 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- 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 +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +193 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +90 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +182 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- 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/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1091 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- 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.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/at-fallback.d.ts +42 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +70 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +46 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +261 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +46 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +256 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +100 -0
- package/dist/core/scheduler/registry.d.ts +43 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +112 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +749 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- 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 +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- 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/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +146 -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 +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- 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 +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +49 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +128 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +48 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +137 -0
- package/dist/db/runs-repo.d.ts +120 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +319 -0
- package/dist/db/schema.d.ts +38 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +325 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5209 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +64 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +305 -0
- package/dist/rpc.d.ts +3915 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1596 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2414 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +632 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +112 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +158 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +559 -0
- package/docs/COMPATIBILITY.md +237 -0
- package/docs/CONCEPT.md +242 -0
- package/docs/CROSS_PLATFORM.ru.md +152 -0
- package/docs/CROSS_PLATFORM.zh.md +148 -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 +699 -0
- package/docs/FEATURES.zh.md +656 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +363 -0
- package/docs/README.ru.md +287 -0
- package/docs/README.zh.md +306 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -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 +9 -0
- package/index.js +2 -0
- package/locales/en.json +781 -0
- package/locales/ru.json +781 -0
- package/locales/zh.json +781 -0
- package/package.json +154 -13
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +209 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +239 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1160 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +308 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +322 -0
- package/src/core/scheduler/posix.ts +128 -0
- package/src/core/scheduler/registry.ts +101 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +881 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- 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 +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +176 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +220 -0
- package/src/db/runs-repo.ts +481 -0
- package/src/db/schema.ts +349 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6642 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +345 -0
- package/src/rpc.ts +1704 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2663 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +946 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +226 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
# 🎯 Стратегический роадмап — agent-steward
|
|
2
|
+
|
|
3
|
+
> Цель: **стать лучшим фреймворком-супервизором для OpenCode, оставаясь бесплатным и open source.**
|
|
4
|
+
> North Star: [docs/CONCEPT.md](./docs/CONCEPT.md) — верифицируемая локально-первая оркестрация агент-задач.
|
|
5
|
+
> Тактический спринт-план — в [ROADMAP.md](./ROADMAP.md), выпущенные изменения — в [CHANGELOG.md](./CHANGELOG.md).
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Позиционирование
|
|
10
|
+
|
|
11
|
+
**Мы не «cron для OpenCode». Мы не «плагин-планировщик».**
|
|
12
|
+
Scheduler, уведомления, аналитика — триггеры и обвязка, не ядро (CONCEPT §8).
|
|
13
|
+
|
|
14
|
+
Мы — **локальная платформа оркестрации AI-задач**: расписание + зависимости (DAG) + матрицы (fan-out) + политики качества + наблюдаемость + объективный гейт + learning-loop.
|
|
15
|
+
|
|
16
|
+
| Принцип | Что это значит на практике |
|
|
17
|
+
|---------|---------------------------|
|
|
18
|
+
| **Бесплатно навсегда** | MIT, без SaaS, без телеметрии, без «pro»-функций |
|
|
19
|
+
| **Локально по умолчанию** | Control plane, данные, история, логи, аудит — на машине пользователя |
|
|
20
|
+
| **Open source-first** | Публичный roadmap, CI на 3 ОС, английская документация |
|
|
21
|
+
| **Оркестрация, а не таймер** | Ров — DAG, матрицы, Quality Gates, наблюдаемость. Cron скопируют за неделю |
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Текущая точка (agent-steward 0.0.2, milestone Д7)
|
|
26
|
+
|
|
27
|
+
- Опубликован в npm, CI зелёный на Windows / macOS / Linux
|
|
28
|
+
- `plugin id` не меняется: `opencode-windows-scheduler` — имена SQLite/логов и ID действий TUI без изменений; каталог данных — `agent-steward` (legacy мигрирует автоматически)
|
|
29
|
+
- Dual-support: один пакет работает с OpenCode V1 (≥ 1.18.29) и V2 (≥ 2.2.7)
|
|
30
|
+
- 26 инструментов агента — паритет с RPC-поверхностью
|
|
31
|
+
- Локальный триаж + shadow mode, `manage_local_ai`, блок настроек в GUI — есть
|
|
32
|
+
- Одноразовые запуски, непрерывность сессий, профили, webhooks, Telegram и нативные toast, тихие часы, Prometheus и OTLP — есть
|
|
33
|
+
- Зашифрованные секреты (`${secret:NAME}`) и журнал аудита — есть
|
|
34
|
+
- Английский README и `docs/` — основные, русский синхронизирован в `docs/README.ru.md`
|
|
35
|
+
|
|
36
|
+
**Чего ещё нет:** pipeline-as-code, Docker-runner, approvals, remote runners, capability-карта с LoRA-адаптерами, durable DAG.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Стратегия развития: от плагина к фреймворку (CONCEPT §13)
|
|
41
|
+
|
|
42
|
+
Наша эволюция строится на двух столпах и постепенной абстракции.
|
|
43
|
+
|
|
44
|
+
### Этап 1: глубокая интеграция с OpenCode V1 и V2 (текущий, завершён milestone Д7)
|
|
45
|
+
|
|
46
|
+
Один пакет, dual export, общее ядро `createRuntime`. V1 и V2 работают через один и тот же пакет с разными ключами конфига (`plugin` для V1, `plugins` для V2).
|
|
47
|
+
|
|
48
|
+
Статус: ✅ завершён — `agent-steward@0.0.2` опубликован, старый пакет остаётся как `legacy/` (thin re-export на один major).
|
|
49
|
+
|
|
50
|
+
### Этап 2: абстракция слоя исполнения (Agent Executor Interface)
|
|
51
|
+
|
|
52
|
+
Вынести интерфейс исполнителя агента за пределы OpenCode-specific кода. Позволить запускать задачи не только через OpenCode, но и через других агентов / MCP / стандартные API.
|
|
53
|
+
|
|
54
|
+
Планируемые спринты: 32 (Pipeline-as-code), 36 (Durable DAG), 38 (Approvals, окружения, артефакты, 0.1.0).
|
|
55
|
+
|
|
56
|
+
### Этап 3: универсальный фреймворк оркестрации (долгосрочно, 0.2.x+)
|
|
57
|
+
|
|
58
|
+
Универсальный фреймворк, совместимый с любым агентом через MCP или стандартные API. Контекстные артефакты, роли (worker → reviewer), self-correcting retry, model fallback chain, A/B tournament, CEP, входящие внешние события, cross-run memory.
|
|
59
|
+
|
|
60
|
+
Планируемые спринты: 40–47 (Context artifacts, Crew / роли, Self-correcting retry, Model fallback, Tournament, CEP, входящие события, Cross-run memory, Smart recipes).
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Горизонт 0–1 месяц: доверие и тишина
|
|
65
|
+
|
|
66
|
+
Сделано: уведомления (1.3.0), секреты и аудит (1.4.0), git-триггеры и окна (1.5.0).
|
|
67
|
+
|
|
68
|
+
### 1. i18n-фундамент (P1) — 1.5.1 ✅ (zh/auto — 1.5.6)
|
|
69
|
+
|
|
70
|
+
Все пользовательские строки в `locales/{ru,en,zh}.json`, ICU-подмножество на `Intl.PluralRules`, паритет ключей в CI, RU по умолчанию. Закрыто: 778/778/778 ключей, `locale: auto`.
|
|
71
|
+
|
|
72
|
+
### 2. Security slice A (P1) — 1.5.2 ✅
|
|
73
|
+
|
|
74
|
+
Enforced `allowedTools` / `deniedTools` вместо advisory, scoped-инъекция `${secret:NAME}`, аудит `tool.blocked`. Закрыто: `src/core/permissions.ts`, 28 тестов политики.
|
|
75
|
+
|
|
76
|
+
### 3. Локальный помощник v1 (P1) — 1.5.3 ✅
|
|
77
|
+
|
|
78
|
+
Триаж уведомлений локальной моделью с fail-open на правила, shadow mode 14 дней, `manage_local_ai`, bench. Меньше шума без потери важного — и работает без модели.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Горизонт 1–3 месяца: verifiable orchestration
|
|
83
|
+
|
|
84
|
+
**Фактический порядок (17.11.2026):** первым идёт Durable DAG (пункт 9, `0.0.3`), затем Pipeline-as-code (`0.0.4`) и остальные P2. Номер версии присваивается по факту релиза.
|
|
85
|
+
|
|
86
|
+
### 4. Локальный помощник v2 (P2) — 1.5.5–1.5.6 ✅
|
|
87
|
+
|
|
88
|
+
Дедуп уведомлений (правила + эмбеддинги), саммари логов в 3 строки, GUI-wizard настройки триажа, счётчик «сэкономлено $» с пометкой «оценка», асинхронный триаж, persistent-аудит решений. Закрыто срезами 31.1–31.13.
|
|
89
|
+
|
|
90
|
+
### 5. Pipeline-as-code (P2) — 0.0.4
|
|
91
|
+
|
|
92
|
+
`opencode.pipeline.yaml` в репозитории + CLI `opencode pipeline validate\|run\|export`. DAG, матрицы и Quality Gates описываются файлом, который можно ревьюить в PR.
|
|
93
|
+
|
|
94
|
+
Это водораздел между «планировщиком» и «оркестратором» (CONCEPT §3: фреймворк-супервизор, а не просто таймер).
|
|
95
|
+
|
|
96
|
+
### 6. Worktree-изоляция и guard-условия (P2) — 0.0.5
|
|
97
|
+
|
|
98
|
+
Одноразовый `git worktree` на запуск, политика очистки, shell- и семантические guard-условия, статус `skipped`. 80% ценности безопасного fan-out без инфраструктуры Docker.
|
|
99
|
+
|
|
100
|
+
### 7. Экономика v2 (P2) — 0.0.6
|
|
101
|
+
|
|
102
|
+
Бюджеты на день/неделю с авто-паузой и алертом, per-task token budgets, token efficiency score, прогноз, Grafana JSON, local vs cloud.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Горизонт 3–6 месяцев: масштаб и надёжность
|
|
107
|
+
|
|
108
|
+
### 8. Docker runner (P3) — 0.0.7
|
|
109
|
+
|
|
110
|
+
Локальный процесс, Docker, SSH-хост. Задача описывает *что* делать, runner — *где*. Изоляцию не изобретаем: Docker / Landstrip. Opt-in, по умолчанию выключен.
|
|
111
|
+
|
|
112
|
+
### 9. Durable DAG (P1 для 0.1.0) — 0.0.3 ⬅️ следующий релиз
|
|
113
|
+
|
|
114
|
+
Персистентная state-машина прогона, resume после краша, идемпотентные шаги, DLQ, chaos `kill -9` в nightly.
|
|
115
|
+
|
|
116
|
+
Самое сложное изменение ядра за весь план. Смешивать с переименованием нельзя (уже сделано отдельно — milestone Д7).
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## Этап 2: Approvals, окружения, артефакты (MAJOR) — 0.1.0
|
|
121
|
+
|
|
122
|
+
Ручное подтверждение перед деплоем, dev / staging / prod, отчёты и coverage как артефакты запуска, docs-сайт и 4 локали (en/ru/zh/tr).
|
|
123
|
+
|
|
124
|
+
Это начало Этапа 2 стратегии (CONCEPT §13.2 — мультиагентная оркестрация с ролями и артефактами).
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Этап 3: универсальный фреймворк (0.2.x+)
|
|
129
|
+
|
|
130
|
+
| Спринт | Тема | Версия |
|
|
131
|
+
|--------|------|--------|
|
|
132
|
+
| 40 | Context artifacts (сквозной контекст) | 0.2.0 |
|
|
133
|
+
| 41 | Crew / роли (worker → reviewer) | 0.2.1 |
|
|
134
|
+
| 42 | Self-correcting retry + post-mortem | 0.2.2 |
|
|
135
|
+
| 43 | Model fallback + confidence | 0.2.3 |
|
|
136
|
+
| 44 | Tournament: A/B моделей и промптов | 0.2.4 |
|
|
137
|
+
| 45 | CEP и входящие события | 0.2.5 |
|
|
138
|
+
| 46 | Cross-run memory | 0.2.6 |
|
|
139
|
+
| 47 | Smart recipes / self-configuring pipelines | 0.2.7 |
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## Ров, который не скопируют за неделю
|
|
144
|
+
|
|
145
|
+
1. **Windows-супервизия.** Конкурент `opencode-scheduler` прямо предупреждает, что на Windows не гарантирует no-overlap и таймауты; у нас обёртки, lock-файлы, crash recovery и единая модель на трёх ОС.
|
|
146
|
+
2. **OpenCode v2.** Часть плагинов всё ещё на устаревшем конфиге `plugin` и не подтверждает совместимость с v2.
|
|
147
|
+
3. **Оркестрация.** DAG, матрицы, Quality Gates, `partial`-статусы, dry-run и история — этого нет ни у одного планировщика экосистемы.
|
|
148
|
+
4. **Локальность.** Никаких облаков и аккаунтов — конкуренты с SaaS-моделью сюда не пойдут.
|
|
149
|
+
5. **Learning-loop.** Capability-карта + gate-passed датасет + staged LoRA-адаптеры — персональная компандующаяся capability, которой нет ни у облака, ни у OpenCode core, ни у swarm-фреймворков.
|
|
150
|
+
|
|
151
|
+
**Чего не делаем:** свой sandbox, свою CI-платформу, хостинг агентов, платные тарифы, open-ended AGI-swarm (CONCEPT §8).
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## Метрики успеха
|
|
156
|
+
|
|
157
|
+
| Метрика | Сейчас (0.0.2) | Через 2 мес | Через 6 мес |
|
|
158
|
+
|---------|---------------|-------------|-------------|
|
|
159
|
+
| npm latest | 0.0.2 | регулярные патчи | 0.1.x |
|
|
160
|
+
| CI на 3 ОС | ✅ | ✅ | ✅ |
|
|
161
|
+
| Покрытие RPC инструментами агента | 100% | 100% | 100% |
|
|
162
|
+
| Telegram / toast | ✅ | ✅ | ✅ |
|
|
163
|
+
| Secrets / audit | ✅ | ✅ | ✅ |
|
|
164
|
+
| Git-триггеры | ✅ | ✅ | ✅ |
|
|
165
|
+
| Pipeline-as-code | ❌ | прототип | ✅ |
|
|
166
|
+
| Docker runner | ❌ | ❌ | ✅ |
|
|
167
|
+
| Загрузки npm / мес | первые | 300+ | 1500+ |
|
|
168
|
+
| GitHub stars | единицы | 100+ | 500+ |
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Риски и триггеры пересмотра
|
|
173
|
+
|
|
174
|
+
| Риск | Триггер | Ответ |
|
|
175
|
+
|------|---------|-------|
|
|
176
|
+
| Нативный scheduler OpenCode поглощает cron | Стабильный API расписаний | Режим `nativeScheduler`, акцент на DAG / матрицы / политики |
|
|
177
|
+
| Похожий плагин с GUI и CI/CD | Релиз конкурента | Ускорить pipeline-as-code и Docker runner |
|
|
178
|
+
| Bus factor = 1 | >5 issues без ответа | Сузить scope, заморозить P3, искать мейнтейнеров |
|
|
179
|
+
| API OpenCode v2 меняется | Breaking change в `@opencode/plugin` | Держать адаптер, следить за релизами, CI ловит первым |
|
|
180
|
+
| Расползание scope | Спринт длиннее 2 недель | Резать на вертикальные срезы, P3 — в бэклог |
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## Ближайшие две недели
|
|
185
|
+
|
|
186
|
+
1. Durable DAG (0.0.3) — подзадача 36.1.a: схема `runs`/`run_steps` и запись перехода; далее 36.1.b, resume 36.2, идемпотентность 36.3.
|
|
187
|
+
2. Роутер, слои 1–2 (спринт 36.5.X) — статические правила горячего пути + Capability Map в SQLite.
|
|
188
|
+
3. Pipeline-as-code (0.0.4) — спецификация формата, парсер, CLI — после P1-ядра.
|
|
189
|
+
|
|
190
|
+
**Критерий месяца:** пользователь ставит плагин одной командой, получает уведомление в Telegram о падении задачи, токены и доступы не лежат открытым текстом в `tasks.json`, а интерфейс говорит на его языке.
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## Долгосрочное видение
|
|
195
|
+
|
|
196
|
+
Путь от плагина к фреймворку описан в [docs/CONCEPT.md](./docs/CONCEPT.md) (§13): локальный интеллект + мультиагентная оркестрация + абстракция слоя исполнения. Этот тактический роадмап является реализацией Этапа 1 (глубокая интеграция с OpenCode v2) и подготовки к Этапу 2 (абстракция Agent Executor Interface).
|
package/ROADMAP.md
ADDED
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
# 🗺️ Roadmap — agent-steward
|
|
2
|
+
|
|
3
|
+
> North Star: [docs/CONCEPT.md](./docs/CONCEPT.md) — верифицируемая локально-первая оркестрация агент-задач.
|
|
4
|
+
> Это не «планировщик». Сcheduler/уведомления/аналитика — триггеры и обвязка, не ядро (§8 CONCEPT).
|
|
5
|
+
|
|
6
|
+
Текущая версия: **agent-steward 0.0.2** (milestone Д7, 17.11.2026). Пакет переименован с `opencode-windows-scheduler`, опубликован в npm, CI зелёный на Windows / macOS / Linux.
|
|
7
|
+
|
|
8
|
+
- Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
|
|
9
|
+
- Что уже выпущено — [CHANGELOG.md](./CHANGELOG.md).
|
|
10
|
+
- Устройство и возможности — [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md), [docs/FEATURES.md](./docs/FEATURES.md).
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 1. Начальная точка (milestone Д7 — agent-steward 0.0.2)
|
|
15
|
+
|
|
16
|
+
### Что сделано
|
|
17
|
+
|
|
18
|
+
- Пакет переименован: `opencode-windows-scheduler` → `agent-steward` (релиз 0.0.2), старый пакет остаётся как thin re-export (`legacy/`) на один major.
|
|
19
|
+
- `plugin id` не меняется: `opencode-windows-scheduler` — имена SQLite и логов, формат `runs.jsonl`, маркер дашборда и ID действий TUI без изменений; каталог данных переименован в `agent-steward` с автоматической миграцией legacy-данных.
|
|
20
|
+
- Dual-support: один пакет работает с OpenCode V1 (≥ 1.18.29) и V2 (≥ 2.2.7) — общий ядро `createRuntime`, 26 инструментов.
|
|
21
|
+
- GitHub-репозиторий: `DeadSno/agent-steward` с редиректами со старых URL.
|
|
22
|
+
|
|
23
|
+
### Что в приоритете прямо сейчас
|
|
24
|
+
|
|
25
|
+
Точка на 17.11.2026: **спринты 28–31 закрыты и выпущены** (1.5.1–1.5.6), **спринт 36 начат**. Подзадачи **36.1.a** и **36.1.b** выполнены: схема `runs`/`run_steps` (SCHEMA_VERSION 3, колонка `position`), журнал переходов с восстановлением после `kill -9`, resume с середины (`run-resume.ts`) и тесты `test-run-state.mjs`, `test-run-journal.mjs`, `test-run-resume.mjs`. Следующая подзадача в работу: **36.3** (идемпотентные ключи шагов).
|
|
26
|
+
|
|
27
|
+
| Приоритет | Что | Почему |
|
|
28
|
+
|-----------|-----|--------|
|
|
29
|
+
| P1 | Durable DAG (спринт 36, задача 36.1) | Персистентная state-машина — фундамент resume, идемпотентности и DLQ; без неё 0.1.0 не выпустить |
|
|
30
|
+
| P1 | Роутер, слои 1–2 (спринт 36.5.X) | 0 токенов на горячем пути, learning-loop из исходов гейта |
|
|
31
|
+
| P2 | Pipeline-as-code (спринт 32) | `opencode.pipeline.yaml` — водораздел планировщик → оркестратор |
|
|
32
|
+
| P2 | Worktree-изоляция (33), экономика v2 (34) | Идут после P1-ядра; номера версий — по факту релиза |
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 2. Четыре столпа (north star, CONCEPT §4)
|
|
37
|
+
|
|
38
|
+
Любая фича / ADR сверяется с ними. При конфликте порядок: **надёжно > приватно > дёшево > краткосрочные фичи**.
|
|
39
|
+
|
|
40
|
+
| Столп | Что значит | Метрика |
|
|
41
|
+
|-------|-----------|---------|
|
|
42
|
+
| **Дёшево** | Локаль закрывает максимум gate-able задач | net-экономия $ (контрфактика), local share %, escalation rate, time overhead |
|
|
43
|
+
| **Приватно** | Control plane, данные, аудит, triage — локальны | % инференса/данных локально; cloud-egress только explicit и залогирован |
|
|
44
|
+
| **Надёжно** | Ноль тихих отказов / двойных прогонов / fake-done / порчи репо | trust-инциденты = 0; гейт независим от self-report; полнота аудита |
|
|
45
|
+
| **Компаундится** | Success rate и экономия растут под пользователя | Тренд local success_rate ↑, eval-lift адаптеров, рост scaffolding-библиотеки |
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## 3. Исполнительный цикл (CONCEPT §6)
|
|
50
|
+
|
|
51
|
+
```
|
|
52
|
+
1. Принять миссию + критерий приёмки (гейт)
|
|
53
|
+
↓
|
|
54
|
+
2. Декомпозиция на шаги / роли
|
|
55
|
+
↓
|
|
56
|
+
3. Выбрать исполнителя (локаль first по capability-карте)
|
|
57
|
+
↓
|
|
58
|
+
4. Выполнить шаг (OpenCode-агент)
|
|
59
|
+
↓
|
|
60
|
+
5. GATE — объективная верификация (tests / lint / schema / diff / cmd)
|
|
61
|
+
├─ pass → ledger: économie + пример + training-record
|
|
62
|
+
└─ fail → эскалация / ретрай / откат
|
|
63
|
+
↓
|
|
64
|
+
6. Артефакт миссии (diff / PR / отчёт / аудит-трейл)
|
|
65
|
+
↓
|
|
66
|
+
7. Отчёт:'économie, success rate, эскалации, overhead
|
|
67
|
+
↓
|
|
68
|
+
8. Обновить роутинг / capability-карту → eval → LoRA (staged)
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
GATE — keystone (§5 CONCEPT): никогда «готово» на слово агента. Провал → эскалация / ретрай / откат.
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 4. Карта спринтов
|
|
76
|
+
|
|
77
|
+
| Спринт | Тема | Приоритет | Статус | Версия |
|
|
78
|
+
|--------|------|-----------|--------|--------|
|
|
79
|
+
| 27.5 | Hotfix после приёмки 1.5.0 | P1 | ✅ завершён | 1.5.1 |
|
|
80
|
+
| 28 | i18n-фундамент | P1 | ✅ завершён | 1.5.1 (+ zh/auto в 1.5.6) |
|
|
81
|
+
| 29 | Security slice A | P1 | ✅ завершён | 1.5.2 |
|
|
82
|
+
| 30 | Local assistant v1 (триаж + shadow) | P1 | ✅ завершён | 1.5.3 |
|
|
83
|
+
| 31 | Local assistant v2 (дедуп, эмбеддинги, саммари, wizard, экономия) | P2 | ✅ завершён (31.1–31.13) | 1.5.5–1.5.6 |
|
|
84
|
+
| 31.A | Спайк маршрутизации local/cloud | P3 | ⬜ бэклог | — |
|
|
85
|
+
| 32 | Pipeline-as-code (`opencode.pipeline.yaml`) | P2 | ⬜ запланирован | 0.0.4 |
|
|
86
|
+
| 33 | Worktree-изоляция + guard-условия | P2 | ⬜ запланирован | 0.0.5 |
|
|
87
|
+
| 34 | Экономика v2 (бюджеты, token efficiency, прогноз) | P2 | ⬜ запланирован | 0.0.6 |
|
|
88
|
+
| 35 | Docker runner (opt-in) | P3 | ⬜ запланирован | 0.0.7 |
|
|
89
|
+
| 36 | Durable DAG (resume, идемпотентность, DLQ) + роутер | P1 (для 0.1.0) | 🔄 активен (спека готова, код не начат) | 0.0.3 |
|
|
90
|
+
| 37 | Rename-only + daemon + config v2 | P2 | ✅ завершён (Д7) | 0.0.2 |
|
|
91
|
+
| 38 | Approvals, окружения, артефакты, docs-сайт | MAJOR | ⬜ запланирован | 0.1.0 |
|
|
92
|
+
| 39 | Запуск и сообщество | — | ⬜ запланирован | 0.1.x |
|
|
93
|
+
|
|
94
|
+
**Версии:** rename-релиз Д7 дал `agent-steward@0.0.2`. **Версия присваивается по факту релиза, а не заранее.** Следующий релиз — спринт 36 (`0.0.3`); 32–35 сдвигаются на `0.0.4`–`0.0.7` в порядке фактического выпуска. Переход на `0.1.0` — при спринте 38 (Approvals).
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
### Ревизия роадмапа — 17.11.2026
|
|
99
|
+
|
|
100
|
+
Сверка роадмапа с фактическим состоянием репозитория (`CHANGELOG.md` 1.5.1–1.5.6, `locales/`, `src/core/permissions.ts`, git-log):
|
|
101
|
+
|
|
102
|
+
| Находка | Решение |
|
|
103
|
+
|---------|---------|
|
|
104
|
+
| Статусы 28–31 отставали от факта: 28 висел «активен», 29/31 «запланированы», хотя выпущены в 1.5.1–1.5.6 | Статусы и версии в §4 исправлены по `CHANGELOG` |
|
|
105
|
+
| «Что в приоритете прямо сейчас» указывало на уже закрытые спринты 28/29/31 | Блок переписан под спринт 36 и подзадачу 36.1.a |
|
|
106
|
+
| Версии 32–36 были зафиксированы заранее (0.0.4–0.0.8), хотя 36 идёт первым — релиз нарушил бы порядок | Версия присваивается по факту релиза: 36 → 0.0.3, 32–35 → 0.0.4–0.0.7 |
|
|
107
|
+
| У подзадач 36.1 не было собственного критерия приёмки — закрывать итерацию было нечем | Добавлены 36.1.a / 36.1.b с проверяемым «готово, когда» и тестом |
|
|
108
|
+
| `docs/ARCHITECTURE.md` в двух местах утверждал «25 agent tools» при фактических 26 | Исправлено на 26 (схема + таблица Modules) |
|
|
109
|
+
|
|
110
|
+
**Правило итерации:** берём одну подзадачу → выполняем → отчёт; найденные улучшения/фиксы сразу дописываются в ближайший спринт этого роадмапа.
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## 5. Спринт 36 — Durable DAG + роутер (0.0.3, P1 для 0.1.0)
|
|
115
|
+
|
|
116
|
+
**Цель:** пережить крах посреди прогона + реализовать трёхслойный роутер исполнения (CONCEPT §5 capability-aware роутинг).
|
|
117
|
+
|
|
118
|
+
**Задачи:**
|
|
119
|
+
|
|
120
|
+
- [x] **36.1 Персистентная state-машина** — сложная.
|
|
121
|
+
- [x] **36.1.a** Схема шага: шаг → статус → попытка.
|
|
122
|
+
- Готово, когда: таблицы `runs`/`run_steps` создаются идемпотентно на чистой и на старой БД; шаг хранит `status`, `attempt`, `idempotency_key`, timestamps; есть `test-run-state.mjs` на переходы `pending → running → passed/failed`.
|
|
123
|
+
- [x] **36.1.b** Запись состояния на каждом переходе.
|
|
124
|
+
- Готово, когда: каждый переход пишет строку состояния до запуска шага и после него; падение процесса между записями не теряет последнюю попытку; тест покрывает повторный переход без потери `attempt`.
|
|
125
|
+
- [x] **36.2 Resume с середины** — сложная.
|
|
126
|
+
- [x] Продолжение с того же шага после краха.
|
|
127
|
+
- [x] Тест: `kill -9` посреди линейной цепочки.
|
|
128
|
+
- [ ] **36.3 Идемпотентные ключи шагов** — сложная.
|
|
129
|
+
- [ ] Ключ шага и защита от дублей побочных эффектов.
|
|
130
|
+
- [ ] Тест повторного запуска шага.
|
|
131
|
+
- [ ] **36.4 DLQ** — средняя.
|
|
132
|
+
- [ ] Очередь окончательно упавших шагов.
|
|
133
|
+
- [ ] Ручной retry из DLQ.
|
|
134
|
+
- [ ] **36.5.X Реализация роутера** — сложная.
|
|
135
|
+
- [ ] Слой 1: статические правила для горячего пути (таблица соответствий типа задачи → транспорт + исполнитель, 0 токенов, мгновенно).
|
|
136
|
+
- [ ] Слой 2: Capability Map в SQLite (тип задачи → модель / success_rate / средняя стоимость / среднее время / последние 10 запусков; обучается на исходах гейта, 0 токенов, быстро).
|
|
137
|
+
- [ ] Слой 3: локальная модель только для декомпозиции миссии и разрешения неоднозначности (не для маршрутизации каждого шага).
|
|
138
|
+
- [ ] Эскалация при провале гейта — по правилу, без участия модели.
|
|
139
|
+
- [ ] Тест: маршрутизация без вызова модели для известных типов задач.
|
|
140
|
+
- [ ] **36.5 Chaos-тест nightly** — средняя.
|
|
141
|
+
- [ ] `kill -9` посреди DAG в nightly workflow.
|
|
142
|
+
- [ ] **36.6 DLQ в GUI** — средняя.
|
|
143
|
+
- [ ] Список, причина, retry.
|
|
144
|
+
- [ ] **36.7 Пауза с инъекцией контекста** — средняя.
|
|
145
|
+
- [ ] На паузе можно оставить комментарий / файл / структурированный артефакт.
|
|
146
|
+
- [ ] При resume следующий шаг получает вставку как контекст.
|
|
147
|
+
- [ ] Комментарий и автор видны в истории; секреты маскируются.
|
|
148
|
+
- [ ] **36.8 Пауза и resume в GUI/Telegram** — средняя.
|
|
149
|
+
- [ ] Кнопки pause/resume, поле комментария, ссылка на текущий шаг.
|
|
150
|
+
- [ ] Предупреждение, если шаг уже выполняется.
|
|
151
|
+
|
|
152
|
+
**Готово, когда:** `kill -9` посреди DAG → продолжение с того же шага; повторный запуск шага не дублирует побочные эффекты; DLQ видна в GUI; роутер маршрутизирует известные типы задач без вызова модели; пауза с комментарием доходит до следующего шага.
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## 6. Что изменено относительно исходного плана и почему
|
|
157
|
+
|
|
158
|
+
| Исходный пункт | Проблема | Решение здесь |
|
|
159
|
+
|---------------|----------|---------------|
|
|
160
|
+
| «Спринт 27 — Фундамент переезда (1.5.0)» | 1.5.0 уже выпущен — это git-триггеры | Фундамент становится 1.5.1 / спринт 28 |
|
|
161
|
+
| «Локальный помощник v1» = 5 срезов в одном релизе | Риск не выпустить ничего | Разрезан на v1 (триаж + shadow) и v2 (дедуп, эмбеддинги, саммари, wizard) |
|
|
162
|
+
| Security & isolation на 1.5.4, flagship на 1.5.1 | Обещание приватности расходилось с advisory-правами | Security slice A (enforced permissions) поднят до 1.5.2, до флагмана |
|
|
163
|
+
| 1.6.0 = переименование + daemon + durable DAG + approvals + config v2 | Самое тяжёлое (durable DAG) смешано с самым рискованным (переименование) | Разрезано: Durable DAG → Rename+daemon → 0.1.0 Approvals |
|
|
164
|
+
| Переименование внутри функционального релиза | Переименование ломает установку у всех пользователей | **Rename — отдельный релиз без фич** (Д7, завершён) |
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 7. Правила планирования
|
|
169
|
+
|
|
170
|
+
1. **Одна задача за раз.** Внутри спринта не начинаем следующую, пока текущая не закрыта тестом и документацией.
|
|
171
|
+
2. **Никаких переименований и миграций внутри функциональных релизов.** Отдельный релиз = отдельный риск.
|
|
172
|
+
3. **Каждая фича — с тестом и документацией.** Без этого задача и спринт не закрыты.
|
|
173
|
+
4. **Приоритет — по боли пользователя, а не по красоте темы.** P1 = без этого нельзя рекомендовать плагин.
|
|
174
|
+
5. **Fail-open по умолчанию.** Любая необязательная подсистема при отказе деградирует, а не блокирует планировщик.
|
|
175
|
+
6. **Честность в маркетинге.** «Сэкономлено $» — оценка контрфактики, а не факт. Методика публикуется рядом с цифрой (`docs/SAVINGS.md`).
|
|
176
|
+
7. **Сверка с CONCEPT.md.** Любая фича / ADR проверяется на соответствие четырём столпам (§4 CONCEPT) и не противоречит §8 (границы).
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## 8. После 0.1.0 — мульти-агентная оркестрация (кандидаты 0.2.x+)
|
|
181
|
+
|
|
182
|
+
Оценка идей: контекстные артефакты → роли (worker → reviewer) → self-correcting retry → model fallback chain → A/B tournament → CEP → входящие внешние события → cross-run memory. Все возможности **opt-in**; планировщик и базовые задачи обязаны работать без локальной модели, без Docker и без внешних сервисов.
|
|
183
|
+
|
|
184
|
+
Подробное описание спринтов 40–47 (Context artifacts, Crew / роли, Self-correcting retry, Model fallback, Tournament, CEP, входящие события, Cross-run memory, Smart recipes) — в разделе «После 1.6.0» предыдущей версии роадмапа; перенесено в бэклог под новые номера версий 0.2.x+.
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Аналитика по истории запусков (Спринт 18).
|
|
3
|
+
*
|
|
4
|
+
* Чистые функции без БД и HTTP: дашборд и RPC отдают JSON, экспорт — CSV.
|
|
5
|
+
* Так агрегаты легко тестировать без запуска сервера.
|
|
6
|
+
*/
|
|
7
|
+
import { type SavingsReport } from "./savings.js";
|
|
8
|
+
/** Оценка стоимости, если запись истории не содержит costUsd. */
|
|
9
|
+
export declare const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
|
|
10
|
+
/** Минимальный вид записи истории, нужный аналитике. */
|
|
11
|
+
export interface AnalyticsRecord {
|
|
12
|
+
taskName: string;
|
|
13
|
+
status: string;
|
|
14
|
+
startedAt: string;
|
|
15
|
+
finishedAt?: string | null;
|
|
16
|
+
durationMs?: number | null;
|
|
17
|
+
error?: string | null;
|
|
18
|
+
tokens?: number;
|
|
19
|
+
costUsd?: number;
|
|
20
|
+
model?: string;
|
|
21
|
+
workspaceId?: string | null;
|
|
22
|
+
}
|
|
23
|
+
/** Описание задачи для группировки по матрицам. */
|
|
24
|
+
export interface AnalyticsTaskRef {
|
|
25
|
+
name: string;
|
|
26
|
+
matrixParentId?: string | null;
|
|
27
|
+
}
|
|
28
|
+
export interface DailyBucket {
|
|
29
|
+
/** YYYY-MM-DD (UTC). */
|
|
30
|
+
date: string;
|
|
31
|
+
total: number;
|
|
32
|
+
success: number;
|
|
33
|
+
error: number;
|
|
34
|
+
partial: number;
|
|
35
|
+
tokens: number;
|
|
36
|
+
costUsd: number;
|
|
37
|
+
avgDurationMs: number;
|
|
38
|
+
}
|
|
39
|
+
export interface TaskAnalyticsRow {
|
|
40
|
+
taskName: string;
|
|
41
|
+
total: number;
|
|
42
|
+
success: number;
|
|
43
|
+
error: number;
|
|
44
|
+
/** Процент успешных запусков (0..100, один знак после запятой). */
|
|
45
|
+
successRate: number;
|
|
46
|
+
avgDurationMs: number;
|
|
47
|
+
tokens: number;
|
|
48
|
+
costUsd: number;
|
|
49
|
+
/** Задача — клон матрицы (matrixParentId задан). */
|
|
50
|
+
isMatrixClone: boolean;
|
|
51
|
+
matrixParentId: string | null;
|
|
52
|
+
}
|
|
53
|
+
export interface MatrixAnalyticsRow {
|
|
54
|
+
parentId: string;
|
|
55
|
+
clones: number;
|
|
56
|
+
total: number;
|
|
57
|
+
success: number;
|
|
58
|
+
error: number;
|
|
59
|
+
successRate: number;
|
|
60
|
+
tokens: number;
|
|
61
|
+
costUsd: number;
|
|
62
|
+
}
|
|
63
|
+
export interface ModelAnalyticsRow {
|
|
64
|
+
model: string;
|
|
65
|
+
total: number;
|
|
66
|
+
costUsd: number;
|
|
67
|
+
}
|
|
68
|
+
/** Агрегат по тексту ошибки — топ ошибок для дайджеста (Спринт 20). */
|
|
69
|
+
export interface ErrorAnalyticsRow {
|
|
70
|
+
/** Текст ошибки (обрезан до 160 символов). */
|
|
71
|
+
message: string;
|
|
72
|
+
count: number;
|
|
73
|
+
/** Последнее появление (ISO). */
|
|
74
|
+
lastAt: string;
|
|
75
|
+
}
|
|
76
|
+
export interface AnalyticsReport {
|
|
77
|
+
generatedAt: string;
|
|
78
|
+
/** Окно анализа в днях. */
|
|
79
|
+
windowDays: number;
|
|
80
|
+
totals: {
|
|
81
|
+
total: number;
|
|
82
|
+
success: number;
|
|
83
|
+
error: number;
|
|
84
|
+
partial: number;
|
|
85
|
+
successRate: number;
|
|
86
|
+
avgDurationMs: number;
|
|
87
|
+
tokens: number;
|
|
88
|
+
costUsd: number;
|
|
89
|
+
};
|
|
90
|
+
daily: DailyBucket[];
|
|
91
|
+
tasks: TaskAnalyticsRow[];
|
|
92
|
+
topByCost: TaskAnalyticsRow[];
|
|
93
|
+
matrices: MatrixAnalyticsRow[];
|
|
94
|
+
byModel: ModelAnalyticsRow[];
|
|
95
|
+
/** Топ ошибок по частоте (Спринт 20). */
|
|
96
|
+
errors: ErrorAnalyticsRow[];
|
|
97
|
+
/** Оценка экономии по контрфактике (Спринт 31.6). */
|
|
98
|
+
savings: SavingsReport;
|
|
99
|
+
sources: {
|
|
100
|
+
historyRecords: number;
|
|
101
|
+
/** Сколько записей попало в окно. */
|
|
102
|
+
recordsInWindow: number;
|
|
103
|
+
/** Ограничение по количеству строк в топах. */
|
|
104
|
+
topLimit: number;
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
export interface BuildAnalyticsOptions {
|
|
108
|
+
/** Окно анализа в днях (по умолчанию 14). */
|
|
109
|
+
days?: number;
|
|
110
|
+
/** Опорный момент (для тестов). */
|
|
111
|
+
now?: Date;
|
|
112
|
+
/** Сколько строк оставлять в топах (по умолчанию 10). */
|
|
113
|
+
topLimit?: number;
|
|
114
|
+
/** Известные задачи — нужны для группировки матриц. */
|
|
115
|
+
tasks?: AnalyticsTaskRef[];
|
|
116
|
+
}
|
|
117
|
+
/** Стоимость записи: явная цена, иначе оценка по токенам. */
|
|
118
|
+
export declare function recordCost(record: AnalyticsRecord): number;
|
|
119
|
+
/** Дата записи в UTC-формате YYYY-MM-DD. */
|
|
120
|
+
export declare function recordDate(record: AnalyticsRecord): string;
|
|
121
|
+
/**
|
|
122
|
+
* Строит отчёт по истории: итоги, дневные бакеты, разбивка по задачам,
|
|
123
|
+
* матрицам и моделям.
|
|
124
|
+
*/
|
|
125
|
+
export declare function buildAnalytics(records: AnalyticsRecord[], options?: BuildAnalyticsOptions): AnalyticsReport;
|
|
126
|
+
/** Экранирование значения для CSV (RFC 4180). */
|
|
127
|
+
export declare function csvCell(value: unknown): string;
|
|
128
|
+
/** Заголовок CSV-экспорта истории. */
|
|
129
|
+
export declare const HISTORY_CSV_HEADER: readonly ["startedAt", "finishedAt", "taskName", "status", "durationMs", "tokens", "costUsd", "model", "workspaceId", "error"];
|
|
130
|
+
/** История в CSV: точки с запятой как разделитель — дружелюбно к Excel (RU). */
|
|
131
|
+
export declare function historyToCsv(records: AnalyticsRecord[]): string;
|
|
132
|
+
//# sourceMappingURL=analytics.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"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"}
|