agent-steward 0.0.5 → 0.0.6
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 +176 -1
- package/README.md +9 -7
- package/ROADMAP-STRATEGY.md +5 -5
- package/ROADMAP.md +107 -17
- package/dist/cli.js +5 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- package/dist/core/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +36 -0
- package/dist/core/gate-integrity.d.ts.map +1 -1
- package/dist/core/gate-integrity.js +144 -1
- package/dist/core/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +57 -2
- package/dist/core/mission.d.ts +20 -0
- package/dist/core/mission.d.ts.map +1 -1
- package/dist/core/mission.js +45 -5
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -0
- package/dist/core/pipeline-io.d.ts +1 -1
- package/dist/core/pipeline-io.d.ts.map +1 -1
- package/dist/core/pipeline-io.js +26 -12
- package/dist/core/pipeline-map.d.ts +6 -0
- package/dist/core/pipeline-map.d.ts.map +1 -1
- package/dist/core/pipeline-map.js +12 -0
- package/dist/core/ps-wrapper.d.ts +10 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +176 -5
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +76 -4
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +30 -0
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -0
- package/dist/core/wrappers/bash.d.ts +2 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +58 -6
- package/dist/db/history-repo.d.ts +32 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +85 -7
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +33 -11
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +9 -4
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +71 -56
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +70 -1
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +6 -1
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- package/dist/index.d.ts +247 -53
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +999 -211
- package/dist/notifications.d.ts +31 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +132 -13
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +66 -15
- package/dist/rpc.d.ts +108 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +28 -0
- package/dist/server.d.ts +17 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +77 -12
- package/dist/settings.d.ts +42 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +82 -0
- package/dist/task-transfer.d.ts +5 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +48 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +49 -12
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/EXECUTION-LOOP.md +6 -3
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +45 -2
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +3 -3
- package/docs/README.zh.md +2 -2
- package/gui-experimental.cjs +9 -9
- package/locales/en.json +42 -3
- package/locales/ru.json +42 -3
- package/locales/zh.json +42 -3
- package/package.json +15 -2
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +26 -2
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +5 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +233 -10
- package/src/core/feedback.ts +582 -0
- package/src/core/gate-integrity.ts +171 -1
- package/src/core/local-ai.ts +7 -3
- package/src/core/matrix.ts +63 -2
- package/src/core/mission.ts +51 -5
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-io.ts +28 -11
- package/src/core/pipeline-map.ts +19 -0
- package/src/core/ps-wrapper.ts +173 -4
- package/src/core/record-history.ts +94 -4
- package/src/core/run-mode.ts +19 -0
- package/src/core/scheduler/logs.ts +32 -1
- package/src/core/secrets.ts +18 -11
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +67 -0
- package/src/core/usage-surface.ts +70 -0
- package/src/core/wrappers/bash.ts +60 -5
- package/src/db/history-repo.ts +153 -19
- package/src/db/metrics-repo.ts +38 -11
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +10 -4
- package/src/db/runs-repo.ts +113 -61
- package/src/db/schema.ts +70 -1
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +261 -5
- package/src/history.ts +10 -3
- package/src/hook-output.ts +39 -0
- package/src/index.ts +1407 -345
- package/src/notifications.ts +189 -39
- package/src/profiles.ts +72 -16
- package/src/rpc.ts +30 -0
- package/src/server.ts +107 -23
- package/src/settings.ts +120 -0
- package/src/task-transfer.ts +59 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
package/ROADMAP.md
CHANGED
|
@@ -10,8 +10,8 @@
|
|
|
10
10
|
> **В ROADMAP только открытые задачи.** Закрытые задачи и подзадачи удаляются отсюда
|
|
11
11
|
> и фиксируются в [CHANGELOG.md](./CHANGELOG.md) — больше нигде.
|
|
12
12
|
|
|
13
|
-
Текущая версия: **agent-steward 0.0.
|
|
14
|
-
В 0.0.
|
|
13
|
+
Текущая версия: **agent-steward 0.0.6** (20.11.2026).
|
|
14
|
+
В 0.0.6 вошли исправления PL-41..PL-53, QA-CI-5 и REL-01/REL-02 — синхронизация документации, счётчики 30/57/115. Это не задачи 0.1.0.
|
|
15
15
|
Legacy: `opencode-windows-scheduler@1.5.8`.
|
|
16
16
|
|
|
17
17
|
- Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
|
|
@@ -26,17 +26,93 @@ Legacy: `opencode-windows-scheduler@1.5.8`.
|
|
|
26
26
|
|
|
27
27
|
> Все находки перепроверены по исходникам (чтение кода, grep, подсчёт счётчиков). Приоритеты снижены относительно анализа: ни одна находка не ведёт к потере данных или тихому успеху. Правило канбана не меняется: деталь → задача → подзадача, в работу берётся одна подзадача.
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
## Деталь 1.3 — Находки QA-аудита (20.11.2026, по TEST-PLAN.md)
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
> Полный аудит: `npm run build` / `npm run lint` / `npm test` зелёные, все 16 деталей D01–D16 подтверждены, i18n-паритет 870/870/870. Источник — отчёт `reports/QA_AUDIT.md`, после переноса удалён.
|
|
32
|
+
|
|
33
|
+
**Задача QA-A2 — Полная типизация плагина (эпик)** · P3 · ⬜
|
|
34
|
+
|
|
35
|
+
> Цель: **0 предупреждений** `no-explicit-any` / `no-unsafe-*` в `src/**/*.ts` при 0 ошибок `tsc` и без изменения поведения. На старте 826 предупреждений: ~200 корневых `any` и ~600 каскадных. Оценка — ~1,5–2 недели одному разработчику, знакомому с кодом. Релиз не блокируется: правила в eslint — `warn`, CI уже зелёный.
|
|
36
|
+
|
|
37
|
+
**Правила выполнения (обязательны для агента):**
|
|
38
|
+
|
|
39
|
+
1. **НЕ применять `eslint --fix`** — проверено: число предупреждений растёт до 7990 из-за каскада новых `no-unsafe-*`. Только ручная правка.
|
|
40
|
+
2. Сначала устраняется **корневой `any`**, затем перепроверяется файл: каскад `no-unsafe-*` уходит сам. Счётчик смотреть через `npx eslint src/<file>.ts --format json`.
|
|
41
|
+
3. Стратегия типов: `unknown` + type guard, `z.infer<typeof schema>` из уже объявленных Zod-схем, доменный тип в `src/types.ts` или рядом с модулем. **Запрещено:** `as any`, `@ts-ignore`, новые `eslint-disable` без обоснования. Исключение — границы внешних API (`@opencode/plugin` V1/V2, `node:sqlite`, JSON-пейлоады): disable допустим только с комментарием «почему» и ссылкой на задачу.
|
|
42
|
+
4. После каждого файла: `npm run build` + `npx eslint <file>` (счётчик строго снижается) + точечный `npm run test:<имя>` затронутой детали. В конце — полный `npm test`.
|
|
43
|
+
5. **Один файл = один коммит** `type(scope): description` латиницей. Поведение не меняется → CHANGELOG не трогать, отмечать только подзадачи здесь.
|
|
44
|
+
6. Не редактировать `dist/`, `gui-experimental.cjs`, `legacy/`.
|
|
45
|
+
|
|
46
|
+
**Подзадачи:**
|
|
47
|
+
|
|
48
|
+
- [ ] QA-A2.7 Финальная верификация: `npm run lint` → 0 ошибок и 0 предупреждений, `npm run build`, `npm test` зелёные; снять baseline-гейт, закрыть эпик.
|
|
32
49
|
|
|
33
50
|
# 2. Задачи согласно архитектуре (Execution model)
|
|
34
51
|
|
|
35
52
|
agent-steward — execution engine с опциональной регистрацией триггеров. Четыре входа ведут в один путь исполнения; планировщик ОС — только полоса A (cron/once), а не центральный маршрут. Оркестрация (цепочки, DAG, ретраи, матрицы, эскалации) выполняется ядром и рекордером прямыми запусками обёрток.
|
|
36
53
|
|
|
37
|
-
>
|
|
54
|
+
> Здесь — только открытая архитектурная очередь 0.2.0, структурированная по правилу «деталь → задача → подзадача». Реализованные части execution model перенесены в [CHANGELOG.md](./CHANGELOG.md); описание целевого кровотока — в [docs/EXECUTION-LOOP.md](./docs/EXECUTION-LOOP.md).
|
|
55
|
+
|
|
56
|
+
## Деталь 2.1 — Durable ledger и provenance
|
|
57
|
+
`src/db/runs-repo.ts`, `src/db/run-journal.ts`, `src/db/schema.ts`, `src/core/execution.ts`
|
|
58
|
+
|
|
59
|
+
> Сверка с кодом: таблицы `runs`/`run_steps` создаются только в ad-hoc пути (`runMission` → `execution.ts` → `createRun`/`finishStep`); зарегистрированные задачи идут через `record-history.ts` без durable-run. Таблицы `gate_outcomes`, полей `prev_hash`/`evidence_path` нет.
|
|
60
|
+
|
|
61
|
+
**Задача ARCH-1 — Durable ledger для всех входов** · P2 · ⬜
|
|
62
|
+
|
|
63
|
+
- [ ] ARCH-1.1 Вызвать `createRun`/`finishStep` из `record-history.ts` для зарегистрированных задач, объединив ad-hoc и registered через общий `RunContext`.
|
|
64
|
+
- [ ] ARCH-1.2 Добавить таблицу `gate_outcomes` (`verdict`, `gate_hash`, `policy_hash`, `prompt_hash`, `attempts_to_pass`, `first_pass`, `executor`, `trigger_kind`) и писать её из прохождения гейта.
|
|
65
|
+
- [ ] ARCH-1.3 Provenance: `evidence_path` и `prev_hash` (tamper-evident аудит); отчёт читает только ledger; тест на подделку цепочки.
|
|
66
|
+
|
|
67
|
+
## Деталь 2.2 — Класс риска и компиляция политики
|
|
68
|
+
`src/core/permissions.ts`, `src/core/execution.ts`, `src/core/mission.ts`
|
|
69
|
+
|
|
70
|
+
> Сверка с кодом: есть `PermissionPolicy` (`hybrid`/`secure`/`legacy`) и scoped-конфиг прав; класса риска и компилятора политики нет. OPA/Rego/Cedar отклонены в [docs/EXECUTION-LOOP.md](./docs/EXECUTION-LOOP.md) §10 — внешние зависимости не добавлять.
|
|
71
|
+
|
|
72
|
+
**Задача ARCH-2 — Класс риска и компиляция политики** · P2 · ⬜
|
|
73
|
+
|
|
74
|
+
- [ ] ARCH-2.1 Ввести risk class в `MissionSpec`/`RunContext` и классификацию по gate/tool scope.
|
|
75
|
+
- [ ] ARCH-2.2 Компилятор политики: risk class → `PermissionPolicy`, allowed/denied tools и лимиты; тест паритета ad-hoc/registered.
|
|
76
|
+
|
|
77
|
+
## Деталь 2.3 — Flake-aware вердикт и отложенные эффекты
|
|
78
|
+
`src/core/router/escalation.ts`, `src/core/gate-integrity.ts`, `src/db/capability-repo.ts`, обёртки
|
|
38
79
|
|
|
39
|
-
|
|
80
|
+
> Сверка с кодом: `escalateAfterGate()` есть; вердиктов `flake`/`infra_fail`, повтора гейта на том же артефакте, `effect_intents` и saga-компенсации нет.
|
|
81
|
+
|
|
82
|
+
**Задача ARCH-3 — Flake-aware вердикт гейта** · P2 · ⬜
|
|
83
|
+
|
|
84
|
+
- [ ] ARCH-3.1 Вердикты `pass|fail|flake|infra_fail`, повтор гейта N=2 на том же артефакте, `attempts_to_pass`/`first_pass` в ledger.
|
|
85
|
+
- [ ] ARCH-3.2 `flake`/`infra_fail` не обновляют `capability_map`; карантин стабильно флакующих гейтов и предупреждение пользователю.
|
|
86
|
+
|
|
87
|
+
**Задача ARCH-4 — Отложенные внешние эффекты** · P2 · ⬜
|
|
88
|
+
|
|
89
|
+
- [ ] ARCH-4.1 `effect_intents` пишутся до гейта; применение и `effects_applied_at` — только после `pass`.
|
|
90
|
+
- [ ] ARCH-4.2 Saga-компенсация при частичном применении; тест «irreversible не произошёл до pass».
|
|
91
|
+
|
|
92
|
+
## Деталь 2.4 — Context compilation
|
|
93
|
+
`src/db/run-context.ts`, `src/core/router/dispatch.ts`
|
|
94
|
+
|
|
95
|
+
> Сверка с кодом: базовый `run-context` есть; repo-map, отбор файлов, примеры gate-passed и пересборка при эскалации не реализованы.
|
|
96
|
+
|
|
97
|
+
**Задача ARCH-5 — Context compilation** · P3 · ⬜
|
|
98
|
+
|
|
99
|
+
- [ ] ARCH-5.1 Repo-map + отбор файлов по типу задачи, дедуп/лимит/scrub секретов и gate-passed примеры.
|
|
100
|
+
- [ ] ARCH-5.2 Пересборка контекста при эскалации (другая модель → другое окно) и тест с бюджетом токенов.
|
|
101
|
+
|
|
102
|
+
## Деталь 2.5 — Egress-контроль и approvals
|
|
103
|
+
`src/core/permissions.ts`, `src/core/audit.ts`
|
|
104
|
+
|
|
105
|
+
> Сверка с кодом: worktree-изоляция есть; egress-политики и approvals-очереди нет (пересекается с A-1 в §3).
|
|
106
|
+
|
|
107
|
+
**Задача ARCH-6 — Egress-контроль** · P2 · ⬜
|
|
108
|
+
|
|
109
|
+
- [ ] ARCH-6.1 Egress-политика (разрешённые хосты/API) в scoped-конфиге + аудит попыток выхода.
|
|
110
|
+
- [ ] ARCH-6.2 Тест «сеть закрыта → деградация без тихого успеха».
|
|
111
|
+
|
|
112
|
+
**Задача ARCH-7 — Approvals-очередь** · P2 · ⬜
|
|
113
|
+
|
|
114
|
+
- [ ] ARCH-7.1 Очередь ручных одобрений для R2/R3 и аудит решений (связь с A-1).
|
|
115
|
+
- [ ] ARCH-7.2 Вызов очереди в execution loop до `createRun`/применения эффектов.
|
|
40
116
|
|
|
41
117
|
---
|
|
42
118
|
|
|
@@ -45,15 +121,6 @@ agent-steward — execution engine с опциональной регистра
|
|
|
45
121
|
## Деталь 3.3 — Экономика v2
|
|
46
122
|
`src/core/budget*`, `src/analytics*`
|
|
47
123
|
|
|
48
|
-
**Задача E-1 — Бюджеты день/неделя** · P2 · ⬜
|
|
49
|
-
- [ ] E-1.1 Лимиты и учёт
|
|
50
|
-
- [ ] E-1.2 Авто-пауза при превышении
|
|
51
|
-
- [ ] E-1.3 Алерт
|
|
52
|
-
|
|
53
|
-
**Задача E-2 — Per-task token budgets** · P2 · ⬜
|
|
54
|
-
- [ ] E-2.1 Лимит на задачу
|
|
55
|
-
- [ ] E-2.2 Остановка при превышении
|
|
56
|
-
|
|
57
124
|
**Задача E-3 — Token efficiency score** · P3 · ⬜
|
|
58
125
|
- [ ] E-3.1 Метрика и расчёт
|
|
59
126
|
|
|
@@ -152,8 +219,31 @@ agent-steward — execution engine с опциональной регистра
|
|
|
152
219
|
**Задача X-6 — `systemd` в keywords** · P3 · ⏸️
|
|
153
220
|
- [ ] X-6.1 Убрать, бэкенда нет
|
|
154
221
|
|
|
155
|
-
|
|
156
|
-
|
|
222
|
+
## Деталь 3.8 — Обратная связь от пользователей (bug reports → GitHub Issues)
|
|
223
|
+
`src/core/feedback.ts`, `src/settings.ts`, `src/index.ts`, `infra/feedback-worker/`
|
|
224
|
+
|
|
225
|
+
### QA-находки, найденные при проверке работоспособности плагина
|
|
226
|
+
|
|
227
|
+
(клавиатурный сдвиг), 507 запусков / 197 ошибок — P2.
|
|
228
|
+
Действие: удалить или переписать промпт задачи через `update_task`.
|
|
229
|
+
Действие: посмотреть `get_task_logs`, починить `beforeScript` или саму задачу.
|
|
230
|
+
`manage_*` поддерживают — P2. Действие: добавить `list` или явно задокументировать
|
|
231
|
+
get-only контракт, чтобы агент не терял вызовы.
|
|
232
|
+
на 12 — P3. Действие: обновить справку и добавить автопроверку в `test-docs`.
|
|
233
|
+
(Free usage limit reached) — P3, окружение, не баг репозитория.
|
|
234
|
+
Действие: при доступном провайдере повторить F-2 через суб-агента и сравнить
|
|
235
|
+
результат с ручной реализацией.
|
|
236
|
+
`get_task_logs` — задача `F38-3_8-event-gate` упала через 754 мс:
|
|
237
|
+
`The process cannot access the file ... logs\\f38-3_8-event-gate.log because
|
|
238
|
+
it is being used by another process` (1/1 ошибка) — P2.
|
|
239
|
+
Действие: открывать файл лога с `FileShare.ReadWrite` и/или ретраить чтение
|
|
240
|
+
при `EBUSY`; сериализовать запуск задачи и чтение лога в планировщике.
|
|
241
|
+
- [ ] UX-3.8.2 Автоматическая отправка отчёта о повторяющейся ошибке — P3,
|
|
242
|
+
не реализовано: сейчас `report_bug` вызывается агентом/пользователем вручную,
|
|
243
|
+
фоновой телеметрии нет. Действие: если понадобится, добавить отдельный
|
|
244
|
+
opt-in-гейт (N одинаковых crash/error в час + тот же antispam + явное
|
|
245
|
+
согласие в UI), не включая его по умолчанию.
|
|
246
|
+
- [ ] PL-54 Промпт задачи с двойными кавычками проходит валидацию, но ломает запуск `opencode run`: `schedule_task` + `schtasks /Run`, ошибка `Cannot process argument because the value of argument "name" is not valid` — P1. Действие: экранировать промпт при передаче в `opencode.ps1` либо отклонять двойные кавычки при создании задачи; добавить проверку в `test-agent-tools.mjs`.
|
|
157
247
|
|
|
158
248
|
---
|
|
159
249
|
|
package/dist/cli.js
CHANGED
package/dist/core/analytics.d.ts
CHANGED
|
@@ -24,6 +24,8 @@ export interface AnalyticsRecord {
|
|
|
24
24
|
export interface AnalyticsTaskRef {
|
|
25
25
|
name: string;
|
|
26
26
|
matrixParentId?: string | null;
|
|
27
|
+
/** Экономика v2 (E-2): лимит токенов на запуск (0/undefined — без лимита). */
|
|
28
|
+
tokenBudget?: number;
|
|
27
29
|
}
|
|
28
30
|
export interface DailyBucket {
|
|
29
31
|
/** YYYY-MM-DD (UTC). */
|
|
@@ -49,6 +51,10 @@ export interface TaskAnalyticsRow {
|
|
|
49
51
|
/** Задача — клон матрицы (matrixParentId задан). */
|
|
50
52
|
isMatrixClone: boolean;
|
|
51
53
|
matrixParentId: string | null;
|
|
54
|
+
/** Экономика v2 (E-2): лимит токенов на запуск (0 — без лимита). */
|
|
55
|
+
tokenBudget?: number;
|
|
56
|
+
/** Сумма токенов за период превысила лимит на задачу. */
|
|
57
|
+
tokenBudgetExceeded?: boolean;
|
|
52
58
|
}
|
|
53
59
|
export interface MatrixAnalyticsRow {
|
|
54
60
|
parentId: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAEtB,iEAAiE;AACjE,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AAEtD,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"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"}
|
package/dist/core/analytics.js
CHANGED
|
@@ -62,10 +62,15 @@ export function buildAnalytics(records, options = {}) {
|
|
|
62
62
|
const byModel = new Map();
|
|
63
63
|
const byError = new Map();
|
|
64
64
|
const cloneParent = new Map();
|
|
65
|
+
const taskTokenBudget = new Map();
|
|
65
66
|
for (const task of options.tasks ?? []) {
|
|
66
67
|
const parentId = task.matrixParentId?.trim();
|
|
67
68
|
if (parentId)
|
|
68
69
|
cloneParent.set(task.name.toLowerCase(), parentId);
|
|
70
|
+
const budget = Number(task.tokenBudget);
|
|
71
|
+
if (Number.isFinite(budget) && budget > 0) {
|
|
72
|
+
taskTokenBudget.set(task.name.toLowerCase(), budget);
|
|
73
|
+
}
|
|
69
74
|
}
|
|
70
75
|
let totalsTotal = 0;
|
|
71
76
|
let totalsSuccess = 0;
|
|
@@ -132,7 +137,11 @@ export function buildAnalytics(records, options = {}) {
|
|
|
132
137
|
costUsd: 0,
|
|
133
138
|
isMatrixClone: cloneParent.has(taskKey),
|
|
134
139
|
matrixParentId: cloneParent.get(taskKey) ?? null,
|
|
140
|
+
tokenBudget: taskTokenBudget.get(taskKey),
|
|
141
|
+
tokenBudgetExceeded: false,
|
|
142
|
+
maxRunTokens: 0,
|
|
135
143
|
};
|
|
144
|
+
existing.maxRunTokens = Math.max(existing.maxRunTokens, tokens);
|
|
136
145
|
existing.total += 1;
|
|
137
146
|
if (status === "success")
|
|
138
147
|
existing.success += 1;
|
|
@@ -152,8 +161,11 @@ export function buildAnalytics(records, options = {}) {
|
|
|
152
161
|
byModel.set(model, modelRow);
|
|
153
162
|
// Топ ошибок: группируем по тексту, чтобы дайджест показывал частые причины.
|
|
154
163
|
if (status !== "success" && status !== "partial") {
|
|
155
|
-
|
|
156
|
-
|
|
164
|
+
// QA-P1.5: легаси-записи успешных запусков содержат "-" вместо текста
|
|
165
|
+
// ошибки. Такой маркер не является сообщением и не должен попадать в топ.
|
|
166
|
+
const rawError = typeof record.error === "string" ? record.error.trim() : "";
|
|
167
|
+
const message = rawError && rawError !== "-"
|
|
168
|
+
? rawError.slice(0, 160)
|
|
157
169
|
: "(без текста)";
|
|
158
170
|
const errorRow = byError.get(message) ?? {
|
|
159
171
|
message,
|
|
@@ -169,11 +181,16 @@ export function buildAnalytics(records, options = {}) {
|
|
|
169
181
|
}
|
|
170
182
|
}
|
|
171
183
|
const tasks = [...byTask.values()]
|
|
172
|
-
.map((row) => ({
|
|
184
|
+
.map(({ maxRunTokens, ...row }) => ({
|
|
173
185
|
...row,
|
|
174
186
|
successRate: percent(row.success, row.total),
|
|
175
187
|
avgDurationMs: Math.round(row.avgDurationMs),
|
|
176
188
|
costUsd: Math.round(row.costUsd * 1e6) / 1e6,
|
|
189
|
+
// E-2: бюджет задаётся на один запуск, поэтому флаг выставляем по
|
|
190
|
+
// максимальному расходу токенов за запуск, а не по сумме за период.
|
|
191
|
+
tokenBudgetExceeded: row.tokenBudget
|
|
192
|
+
? maxRunTokens > row.tokenBudget
|
|
193
|
+
: false,
|
|
177
194
|
}))
|
|
178
195
|
.sort((a, b) => b.total - a.total || a.taskName.localeCompare(b.taskName));
|
|
179
196
|
const matrices = new Map();
|
package/dist/core/audit.d.ts
CHANGED
|
@@ -79,6 +79,12 @@ export declare function recordToolBlocked(input: ToolBlockedInput): number | nul
|
|
|
79
79
|
* неограничен. Возвращает число записанных событий.
|
|
80
80
|
*/
|
|
81
81
|
export declare function recordTaskToolBlocks(task: string, allowedTools: readonly string[] | null | undefined, deniedTools: readonly string[] | null | undefined, actor?: AuditActor, source?: string, policy?: PermissionPolicy, legacyShell?: boolean): number;
|
|
82
|
+
/**
|
|
83
|
+
* QA-P3.1: единообразная проверка ISO-дат для фильтров аудита.
|
|
84
|
+
* Возвращает текст ошибки или null — чтобы все вызывающие (MCP, RPC, HTTP)
|
|
85
|
+
* отвечали одинаково, а не молча отдавали пустую выборку.
|
|
86
|
+
*/
|
|
87
|
+
export declare function auditDateFilterError(value: string | null | undefined, name: "since" | "until"): string | null;
|
|
82
88
|
/** Читает журнал аудита (новые сверху). */
|
|
83
89
|
export declare function readAuditLog(filter?: ReadAuditFilter): ReadAuditResult;
|
|
84
90
|
/**
|
package/dist/core/audit.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAShD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAoBrE;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAiCjE;AA0CD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CASxE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,EAClD,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,EACjD,KAAK,GAAE,UAAqB,EAC5B,MAAM,SAAW,EACjB,MAAM,CAAC,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,OAAO,GACpB,MAAM,CA4ER;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,MAAM,GAAE,eAAoB,GAAG,eAAe,
|
|
1
|
+
{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"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"}
|
package/dist/core/audit.js
CHANGED
|
@@ -199,8 +199,32 @@ export function recordTaskToolBlocks(task, allowedTools, deniedTools, actor = "s
|
|
|
199
199
|
}
|
|
200
200
|
return written;
|
|
201
201
|
}
|
|
202
|
+
/**
|
|
203
|
+
* QA-P3.1: единообразная проверка ISO-дат для фильтров аудита.
|
|
204
|
+
* Возвращает текст ошибки или null — чтобы все вызывающие (MCP, RPC, HTTP)
|
|
205
|
+
* отвечали одинаково, а не молча отдавали пустую выборку.
|
|
206
|
+
*/
|
|
207
|
+
export function auditDateFilterError(value, name) {
|
|
208
|
+
if (value === null || value === undefined)
|
|
209
|
+
return null;
|
|
210
|
+
const trimmed = String(value).trim();
|
|
211
|
+
if (!trimmed)
|
|
212
|
+
return null;
|
|
213
|
+
if (Number.isNaN(Date.parse(trimmed))) {
|
|
214
|
+
return `Некорректный параметр ${name}: ожидается ISO-дата.`;
|
|
215
|
+
}
|
|
216
|
+
return null;
|
|
217
|
+
}
|
|
202
218
|
/** Читает журнал аудита (новые сверху). */
|
|
203
219
|
export function readAuditLog(filter = {}) {
|
|
220
|
+
for (const [name, value] of [
|
|
221
|
+
["since", filter.since],
|
|
222
|
+
["until", filter.until],
|
|
223
|
+
]) {
|
|
224
|
+
const dateError = auditDateFilterError(value, name);
|
|
225
|
+
if (dateError)
|
|
226
|
+
throw new Error(dateError);
|
|
227
|
+
}
|
|
204
228
|
const limit = Math.max(1, Math.min(5000, Math.floor(filter.limit ?? 200) || 200));
|
|
205
229
|
const where = [];
|
|
206
230
|
const params = [];
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Бюджеты день/неделя (Экономика v2, E-1.1).
|
|
3
|
+
*
|
|
4
|
+
* Чистые функции без БД, HTTP и ОС: расход считается из уже загруженной
|
|
5
|
+
* истории запусков, лимиты задаются пользователем в settings.json.
|
|
6
|
+
* Fail-open по умолчанию: выключенная группа или нулевой лимит никогда
|
|
7
|
+
* не блокируют запуски — они только перестают проверяться.
|
|
8
|
+
*/
|
|
9
|
+
import { type AnalyticsRecord } from "./analytics.js";
|
|
10
|
+
export type BudgetPeriod = "day" | "week";
|
|
11
|
+
/** Лимиты в USD. 0 означает «без лимита» (fail-open). */
|
|
12
|
+
export interface BudgetSettings {
|
|
13
|
+
/** Включён ли учёт/проверка бюджетов. */
|
|
14
|
+
enabled: boolean;
|
|
15
|
+
/** Лимит на один UTC-день, USD (0 — без лимита). */
|
|
16
|
+
dailyUsd: number;
|
|
17
|
+
/** Лимит на одну UTC-неделю (с понедельника), USD (0 — без лимита). */
|
|
18
|
+
weeklyUsd: number;
|
|
19
|
+
}
|
|
20
|
+
export declare const DEFAULT_BUDGET_SETTINGS: BudgetSettings;
|
|
21
|
+
export declare function defaultBudgetSettings(): BudgetSettings;
|
|
22
|
+
/** Учёт одного периода: потрачено, осталось, достигнут ли лимит. */
|
|
23
|
+
export interface BudgetUsage {
|
|
24
|
+
period: BudgetPeriod;
|
|
25
|
+
/** Начало периода в UTC, ISO-строка. */
|
|
26
|
+
periodStart: string;
|
|
27
|
+
/** Конечный лимит, USD (0 — лимит выключен). */
|
|
28
|
+
limitUsd: number;
|
|
29
|
+
/** Потрачено завершёнными запусками в периоде, USD. */
|
|
30
|
+
spentUsd: number;
|
|
31
|
+
/** Сколько запусков попало в период. */
|
|
32
|
+
runs: number;
|
|
33
|
+
/** Остаток; 0, если лимит выключен или уже исчерпан. */
|
|
34
|
+
remainingUsd: number;
|
|
35
|
+
/** Доля расхода от лимита (0, если лимит выключен). Может быть > 1. */
|
|
36
|
+
ratio: number;
|
|
37
|
+
/** Лимит включён и расход достиг/превысил его. */
|
|
38
|
+
exceeded: boolean;
|
|
39
|
+
/**
|
|
40
|
+
* Проверка не активна: группа выключена глобально или лимит равен нулю.
|
|
41
|
+
* По умолчанию true — fail-open.
|
|
42
|
+
*/
|
|
43
|
+
disabled: boolean;
|
|
44
|
+
}
|
|
45
|
+
export interface BudgetReport {
|
|
46
|
+
generatedAt: string;
|
|
47
|
+
enabled: boolean;
|
|
48
|
+
day: BudgetUsage;
|
|
49
|
+
week: BudgetUsage;
|
|
50
|
+
/** Хотя бы один включённый лимит достигнут/превышен. */
|
|
51
|
+
exceeded: boolean;
|
|
52
|
+
}
|
|
53
|
+
/** Начало UTC-дня, в котором находится `now`. */
|
|
54
|
+
export declare function startOfUtcDay(now: Date): Date;
|
|
55
|
+
/** Начало UTC-недели (понедельник 00:00), в которой находится `now`. */
|
|
56
|
+
export declare function startOfUtcWeek(now: Date): Date;
|
|
57
|
+
/**
|
|
58
|
+
* Считает расход за текущий UTC-день и UTC-неделю (с понедельника).
|
|
59
|
+
* Запуск относится к периоду по времени завершения (`finishedAt`, при
|
|
60
|
+
* отсутствии — `startedAt`); даты вне периода и статус `running` игнорируются.
|
|
61
|
+
*/
|
|
62
|
+
export declare function buildBudgetReport(records: AnalyticsRecord[], settings?: BudgetSettings, now?: Date): BudgetReport;
|
|
63
|
+
/** Причина решения гейта запуска. */
|
|
64
|
+
export type BudgetGateReason = "disabled" | "within_limit" | "day_exceeded" | "week_exceeded";
|
|
65
|
+
/** Решение: можно ли начинать новый запуск. */
|
|
66
|
+
export interface BudgetGateDecision {
|
|
67
|
+
allowed: boolean;
|
|
68
|
+
reason: BudgetGateReason;
|
|
69
|
+
/** Какой лимит сработал (только при exceeded). */
|
|
70
|
+
period?: BudgetPeriod;
|
|
71
|
+
report: BudgetReport;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* E-1.2: авто-пауза при превышении лимита.
|
|
75
|
+
*
|
|
76
|
+
* Fail-open: если группа выключена или оба лимита нулевые, запуски не
|
|
77
|
+
* блокируются. Иначе новый запуск пропускается, как только расход за
|
|
78
|
+
* текущий день/неделю достиг лимита. Дневной лимит проверяется первым.
|
|
79
|
+
*/
|
|
80
|
+
export declare function evaluateBudgetGate(records: AnalyticsRecord[], settings?: BudgetSettings, now?: Date): BudgetGateDecision;
|
|
81
|
+
/** Человекочитаемая причина пропуска; пустая строка, если запуск разрешён. */
|
|
82
|
+
export declare function formatBudgetSkipMessage(decision: BudgetGateDecision): string;
|
|
83
|
+
/**
|
|
84
|
+
* E-1.3: текст алерта о превышении бюджета. Пустая строка, если лимит не
|
|
85
|
+
* превышен. Отличается от сообщения о пропуске запуска (E-1.2) тем, что
|
|
86
|
+
* явно сообщает об остановке всех новых запусков.
|
|
87
|
+
*/
|
|
88
|
+
export declare function formatBudgetAlertMessage(decision: BudgetGateDecision): string;
|
|
89
|
+
/**
|
|
90
|
+
* E-2.2: гейт токен-бюджета одной задачи (per-task token budget).
|
|
91
|
+
*
|
|
92
|
+
* Лимит задаётся в определении задачи (`tokenBudget`, токены на один запуск).
|
|
93
|
+
* Если какой-либо завершённый прогон задачи в текущем UTC-дне/неделе превысил
|
|
94
|
+
* лимит, новые запуски пропускаются до начала следующего периода — та же
|
|
95
|
+
* логика, что у глобального бюджетного гейта E-1.2, но в разрезе одной задачи.
|
|
96
|
+
* Fail-open: лимит 0/undefined отключает проверку, запуски не блокируются.
|
|
97
|
+
*/
|
|
98
|
+
export type TaskTokenBudgetReason = "no_budget" | "within_limit" | "day_exceeded" | "week_exceeded";
|
|
99
|
+
export interface TaskTokenBudgetDecision {
|
|
100
|
+
allowed: boolean;
|
|
101
|
+
reason: TaskTokenBudgetReason;
|
|
102
|
+
taskName: string;
|
|
103
|
+
tokenBudget: number;
|
|
104
|
+
/** Максимум токенов за один прогон в сработавшем периоде. */
|
|
105
|
+
maxRunTokens: number;
|
|
106
|
+
period?: BudgetPeriod;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* Решение гейта персонального токен-бюджета задачи.
|
|
110
|
+
*
|
|
111
|
+
* Источник данных — уже загруженная история (`getHistoryForBudget`). Как и в
|
|
112
|
+
* аналитике (QA-B.1), превышение считается по одному прогону, а не по сумме за
|
|
113
|
+
* период; дневное окно проверяется первым (как дневной лимит в E-1.2).
|
|
114
|
+
*/
|
|
115
|
+
export declare function evaluateTaskTokenBudgetGate(records: AnalyticsRecord[], taskName: string, tokenBudget: number | undefined, now?: Date): TaskTokenBudgetDecision;
|
|
116
|
+
/** Человекочитаемая причина пропуска; пустая строка, если запуск разрешён. */
|
|
117
|
+
export declare function formatTaskTokenBudgetSkipMessage(decision: TaskTokenBudgetDecision): string;
|
|
118
|
+
//# sourceMappingURL=budget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/core/budget.ts"],"names":[],"mappings":"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"}
|