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
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
# QA-A2.6 — Исключение GUI/TUI из контура типизации (явная фиксация)
|
|
2
|
+
|
|
3
|
+
Статус: **исключение зафиксировано явно** (вместо молчаливого). Ветка: `dev`.
|
|
4
|
+
Эпик: QA-A2 «Полная типизация плагина». Ссылка: `ROADMAP.md`, строка QA-A2.6.
|
|
5
|
+
|
|
6
|
+
Цель подзадачи — не «типизировать GUI/TUI прямо сейчас», а прервать статус
|
|
7
|
+
*silent-исключения*: записать, **почему** три `.tsx`-файла не попадают ни в `tsc`,
|
|
8
|
+
ни в ESLint, и дать воспроизводимый план их подключения с JSX-парсером. Настоящая
|
|
9
|
+
правка — **только документация**; `tsconfig.json`, `eslint.config.mjs` и код не
|
|
10
|
+
изменяются.
|
|
11
|
+
|
|
12
|
+
## 1. Фактическое состояние (что и где настроено)
|
|
13
|
+
|
|
14
|
+
### 1.1 `tsconfig.json`
|
|
15
|
+
|
|
16
|
+
- `include: ["src/**/*"]` — формально покрывает весь `src/`.
|
|
17
|
+
- `exclude: ["node_modules", "dist", "src/tui.tsx", "src/tui-v1.tsx", "src/gui.tsx"]`
|
|
18
|
+
— три JSX-файла исключены **явно, но без объяснения причины** (это и есть
|
|
19
|
+
«молчаливое исключение»).
|
|
20
|
+
- При этом компилятор *уже* настроен на JSX: `jsx: "preserve"`,
|
|
21
|
+
`jsxImportSource: "@opentui/solid"`, `resolveJsonModule: true`,
|
|
22
|
+
`declaration: true`, `module: "Node16"`, `outDir: "./dist"`.
|
|
23
|
+
То есть конфиг выглядит «готовым к JSX», из-за чего исключение выглядит
|
|
24
|
+
случайным — отсюда и возникла задача QA-A2.6.
|
|
25
|
+
|
|
26
|
+
### 1.2 `eslint.config.mjs`
|
|
27
|
+
|
|
28
|
+
- Глобальный `ignores`: `dist/`, `node_modules/`, `*.cjs`, `*.mjs`, `*.js`, `scripts/`.
|
|
29
|
+
- Рабочий блок: `files: ["src/**/*.ts"]` — glob матчит **только `.ts`**, но не
|
|
30
|
+
`.tsx`. Следовательно `src/gui.tsx`, `src/tui.tsx`, `src/tui-v1.tsx` не
|
|
31
|
+
попадают под линтер даже при том, что `parserOptions.project: "./tsconfig.json"`
|
|
32
|
+
и подключены `recommendedTypeChecked` + `stylisticTypeChecked`.
|
|
33
|
+
- Второй блок `files: ["src/core/**/*.ts"]` c локальным правилом
|
|
34
|
+
`no-any-in-catch` тоже `.tsx` не затрагивает.
|
|
35
|
+
|
|
36
|
+
Итог: файлы выпадают из обоих контуров **дважды** — через `exclude` в `tsconfig`
|
|
37
|
+
и через `files`-паттерн в ESLint.
|
|
38
|
+
|
|
39
|
+
### 1.3 Сборка и точки входа (dual-entry)
|
|
40
|
+
|
|
41
|
+
`package.json` задаёт три независимых пути сборки/загрузки:
|
|
42
|
+
|
|
43
|
+
| Экспорт |Цель | Инструмент |
|
|
44
|
+
|---|---|---|
|
|
45
|
+
| `.` | `dist/index.js` (основной плагин) | `tsc` (`npm run build`) |
|
|
46
|
+
| `./rpc` | `dist/rpc.js` | `tsc` |
|
|
47
|
+
| `./tui` | `src/tui.tsx` (сырой TSX, грузится OpenCode TUI-рантаймом) | OpenCode TUI loader |
|
|
48
|
+
| `./gui-experimental` | `gui-experimental.cjs` (один CJS-бандл в корне) | Vite, `npm run build:gui` |
|
|
49
|
+
|
|
50
|
+
`vite.config.ts` подключает официальный `gui()` из `@opencode/plugin/gui/vite`,
|
|
51
|
+
который сам подключает `vite-plugin-solid`, компилирует Solid JSX и пишет
|
|
52
|
+
`gui-experimental.cjs`. GUI-бандл, таким образом, **собирается не `tsc`**, а
|
|
53
|
+
отдельным Vite-проходом с `prepublishOnly: npm run build && npm run build:gui`.
|
|
54
|
+
|
|
55
|
+
## 2. Почему исключение существует и чем опасно «просто убрать exclude»
|
|
56
|
+
|
|
57
|
+
1. **Два разных JSX-рантайма в одном проекте.**
|
|
58
|
+
- `src/gui.tsx` использует Solid JSX: `solid-js`, `@opencode/plugin/gui`,
|
|
59
|
+
каталоги подключаются как JSON-импорты (`../locales/*.json`).
|
|
60
|
+
- `src/tui.tsx` использует OpenTUI/Solid: первая строка — директива
|
|
61
|
+
`/** @jsxImportSource @opentui/solid */`, JSX-примитивы `<box>`, `<text>`.
|
|
62
|
+
- `src/tui-v1.tsx` — V1-ветка TUI, тоже JSX.
|
|
63
|
+
Глобальный `jsxImportSource: "@opentui/solid"` в `tsconfig.json` корректен
|
|
64
|
+
для TUI, но **не для GUI**. Один `tsconfig` не может одновременно и корректно
|
|
65
|
+
типизировать оба рантайма без per-file `@jsxImportSource`-директив.
|
|
66
|
+
|
|
67
|
+
2. **`tsc` производит артефакты для Node16 ESM, а не для JSX-рантаймов.**
|
|
68
|
+
При `jsx: "preserve"` компиляция `.tsx` оставит JSX в `.jsx`-файлах в `dist/` —
|
|
69
|
+
такой файл не 실행ится загрузчиком Node16 ESM. Плюс `declaration: true`
|
|
70
|
+
сгенерирует `.d.ts` для GUI/TUI, которые в пакете не используются (GUI
|
|
71
|
+
потребляется как готовый CJS-бандл, TUI — как исходный TSX). Прямое удаление
|
|
72
|
+
из `exclude` меняет состав `dist/` и ломает `npm run build` / целостность
|
|
73
|
+
`exports` (`test-package-exports.mjs`).
|
|
74
|
+
|
|
75
|
+
3. **Отдельный Vite-бандл.** GUI собирается в `gui-experimental.cjs` через
|
|
76
|
+
`gui()`-плагин с внешними `solid-js`/`@opencode/plugin/gui`. Это отдельный
|
|
77
|
+
контур: типы GUI проверять можно, но *эмит* `tsc` для GUI не нужен и вреден.
|
|
78
|
+
|
|
79
|
+
4. **Dual-entry / загрузка сырого TSX.** `./tui` указывает прямо на
|
|
80
|
+
`src/tui.tsx`; OpenCode V2 подхватывает его как TUI-точку входа. Это
|
|
81
|
+
«рантайм-исходник», а не вход для `tsc`. Попытка перевести его в `dist/`
|
|
82
|
+
потребует менять `exports` и синхронизировать V1/V2-совместимость
|
|
83
|
+
(`docs/COMPATIBILITY.md`, `test-docs.mjs`).
|
|
84
|
+
|
|
85
|
+
5. **Typed ESLint требует присутствия файла в TS-программе.** Даже если просто
|
|
86
|
+
добавить `.tsx` в `files` ESLint, `recommendedTypeChecked` с
|
|
87
|
+
`parserOptions.project: "./tsconfig.json"` упадёт с ошибкой вида
|
|
88
|
+
*"file was not found by the project"*, пока файлы не включены в какую-либо
|
|
89
|
+
TS-программу. Поэтому ESLint и tsc должны подключаться **в связке**.
|
|
90
|
+
|
|
91
|
+
Вывод: текущее исключение — **осознанная техническая необходимость**, которая
|
|
92
|
+
до сих пор была не задокументирована. Настоящий документ делает её явной.
|
|
93
|
+
|
|
94
|
+
## 3. Решение QA-A2.6
|
|
95
|
+
|
|
96
|
+
Исключение GUI/TUI из `tsc`-сборки и из ESLint объявляется **явным и
|
|
97
|
+
обоснованным** (п. 2). Эпик QA-A2 считается закрытым в части GUI/TUI не через
|
|
98
|
+
«включить любой ценой», а через фиксацию причины и конкретный план
|
|
99
|
+
подключения (п. 4), который выполняется отдельной правкой с полными тестами.
|
|
100
|
+
|
|
101
|
+
> Важно: «полностью типизированный плагин» в контексте QA-A2 означает полную
|
|
102
|
+
> типизацию **серверного контура** (`src/**/*.ts`, собираемого `tsc` и
|
|
103
|
+
> проверяемого ESLint). GUI/TUI — отдельные рантайм-контуры со своей сборкой;
|
|
104
|
+
> их подключение к проверке типов желательно, но не должно ломать dual-entry и
|
|
105
|
+
> V1/V2-совместимость.
|
|
106
|
+
|
|
107
|
+
## 4. План подключения GUI/TUI с JSX-парсером (выполняется отдельной правкой)
|
|
108
|
+
|
|
109
|
+
### Шаг 1 — выделить отдельную TS-программу для JSX (без эмита)
|
|
110
|
+
|
|
111
|
+
Создать `tsconfig.jsx.json`, расширяющий базовый:
|
|
112
|
+
|
|
113
|
+
```jsonc
|
|
114
|
+
{
|
|
115
|
+
"extends": "./tsconfig.json",
|
|
116
|
+
"compilerOptions": {
|
|
117
|
+
"noEmit": true,
|
|
118
|
+
"declaration": false,
|
|
119
|
+
"declarationMap": false,
|
|
120
|
+
"jsx": "preserve",
|
|
121
|
+
"jsxImportSource": "@opentui/solid" // дефолт; GUI переопределит директивой
|
|
122
|
+
},
|
|
123
|
+
"include": ["src/gui.tsx", "src/tui.tsx", "src/tui-v1.tsx", "src/**/*.d.ts"],
|
|
124
|
+
"exclude": []
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
- `noEmit: true` гарантирует: программа используется **только для проверки типов**,
|
|
129
|
+
`dist/` не трогается, dual-entry и Vite-бандл не затрагиваются.
|
|
130
|
+
- Базовый `tsconfig.json` остаётся со своим `exclude` — именно он управляет
|
|
131
|
+
*эмитом*; `tsconfig.jsx.json` — отдельный контур *проверки*.
|
|
132
|
+
|
|
133
|
+
### Шаг 2 — переключить JSX-рантайм на уровне файлов
|
|
134
|
+
|
|
135
|
+
- `src/tui.tsx` уже содержит `/** @jsxImportSource @opentui/solid */` — оставить.
|
|
136
|
+
- `src/tui-v1.tsx` — проверить и при необходимости добавить ту же директиву.
|
|
137
|
+
- `src/gui.tsx` — добавить `/** @jsxImportSource solid-js */` в первую строку,
|
|
138
|
+
чтобы JSX-типы разрешались из Solid, а не из OpenTUI (директива файла имеет
|
|
139
|
+
приоритет над `jsxImportSource` из `compilerOptions`).
|
|
140
|
+
- Альтернатива при желании избежать директив: `jsx: "react-jsx"` + два
|
|
141
|
+
`tsconfig` (по одному на рантайм) — сложнее, рекомендуется вариант с pragma.
|
|
142
|
+
|
|
143
|
+
### Шаг 3 — подключить ESLint к JSX-программе
|
|
144
|
+
|
|
145
|
+
Добавить в `eslint.config.mjs` блок **после** базового (до блока `src/core/**` или
|
|
146
|
+
после — порядок не важен, но блок должен быть не шире базового):
|
|
147
|
+
|
|
148
|
+
```js
|
|
149
|
+
{
|
|
150
|
+
files: ["src/**/*.tsx"],
|
|
151
|
+
languageOptions: {
|
|
152
|
+
parserOptions: { project: "./tsconfig.jsx.json" }
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
- Отдельный `@typescript-eslint/parser` подключать не нужно: `typescript-eslint`
|
|
158
|
+
уже парсит TSX его собственным парсером (espree с TSX не справился бы).
|
|
159
|
+
- Наследованные правила (`recommendedTypeChecked`, `stylisticTypeChecked`,
|
|
160
|
+
`semi`, `quotes`, `indent`, `no-console`, `no-explicit-any: warn` и т.д.)
|
|
161
|
+
применятся к `.tsx` автоматически. При желании — добавить точечные
|
|
162
|
+
JSX-специфичные правила после стабилизации baseline.
|
|
163
|
+
- Убедиться, что `npm run lint` (`eslint src`) теперь действительно посещает
|
|
164
|
+
`.tsx` (проверить `--debug`/списком файлов), иначе явно перечислить их в
|
|
165
|
+
`files`.
|
|
166
|
+
|
|
167
|
+
### Шаг 4 — скрипты и CI
|
|
168
|
+
|
|
169
|
+
- Добавить в `package.json`:
|
|
170
|
+
- `"typecheck:jsx": "tsc -p tsconfig.jsx.json"`;
|
|
171
|
+
- `"lint:jsx": "eslint src --ext .ts,.tsx"` (или включить `.tsx` в общий
|
|
172
|
+
`npm run lint`).
|
|
173
|
+
- Добавить оба вызова в CI-воркфлоу рядом с `npm run lint` / `npm run build`.
|
|
174
|
+
- Обновить `test-docs.mjs`-связанные доки только при изменении счётчиков tools/RPC —
|
|
175
|
+
в данном плане они не меняются.
|
|
176
|
+
|
|
177
|
+
### Шаг 5 — проверки после подключения (обязательно)
|
|
178
|
+
|
|
179
|
+
- `npm run build` — убедиться, что состав `dist/` и `npm pack --dry-run` не
|
|
180
|
+
изменились; `node test-package-exports.mjs` — целостность `exports`.
|
|
181
|
+
- `npm run lint` и `npm run typecheck:jsx` — 0 ошибок; новые `any` в `.tsx`
|
|
182
|
+
разбираются по правилам QA-A2 (сужать через type guard / `z.infer`).
|
|
183
|
+
- GUI/RPC-контур (по правилам AGENTS.md): `npm run test:dlq-gui`,
|
|
184
|
+
`npm run test:pause-gui`, `npm run test:gui-bundle` + smoke в Playwright.
|
|
185
|
+
- V1/V2-совместимость и мета-гейт: `node test-docs.mjs`, `node test-workflows.mjs`.
|
|
186
|
+
- `npm run test:i18n` — `gui.tsx` инлайн-регистрирует `ru/en/zh`-каталоги;
|
|
187
|
+
типизация JSON-импортов не должна сломать паритет ключей.
|
|
188
|
+
|
|
189
|
+
### Риски и оговорки
|
|
190
|
+
|
|
191
|
+
- Добавление `.tsx` в линтер может вскрыть значительный легаси-долг в GUI/TUI;
|
|
192
|
+
чтобы не ронять CI, новые предупреждения временно держать в baseline
|
|
193
|
+
(по образцу QA-A2.0), затем «вылизывать» по QA-A2.1–A2.5.
|
|
194
|
+
- GUI-бандл (`gui-experimental.cjs`) и `dist/` — артефакты сборки, **не редактировать
|
|
195
|
+
вручную** (правило AGENTS.md).
|
|
196
|
+
- Любая правка `exports`/сборки GUI требует синхронизации `docs/COMPATIBILITY.md`
|
|
197
|
+
и повторного `node test-docs.mjs`.
|
|
198
|
+
|
|
199
|
+
## 5. Критерии приёмки QA-A2.6
|
|
200
|
+
|
|
201
|
+
- [x] Прочитаны `ROADMAP.md` (QA-A2.6), `tsconfig.json`, `eslint.config.mjs`.
|
|
202
|
+
- [x] Создан `docs/QA-A2-GUI-TUI.md` с объяснением причин исключения
|
|
203
|
+
(JSX-парсер/рантайм, отдельный Vite-бандл, dual-entry) и планом подключения.
|
|
204
|
+
- [x] `tsconfig.json`, `eslint.config.mjs` и код не изменены.
|
|
205
|
+
- [x] Коммит/push не выполнялись; суб-агенты не спавнились.
|
package/docs/README.ru.md
CHANGED
|
@@ -46,7 +46,7 @@ Translations: [English](../README.md) · [中文](README.zh.md).
|
|
|
46
46
|
| Мультирепо | workspaces с валидацией путей, запуски по workspace, матрица поверх родительской задачи |
|
|
47
47
|
| Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), JSONL-логи с `/api/logs`, Prometheus `/metrics`, экспорт OTLP, логи по задачам, веб-дашборд с аналитикой за 14 дней, ретеншн истории и экспорт CSV/JSON |
|
|
48
48
|
| Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, уведомления по нескольким каналам (webhook, Telegram, нативные toast), тихие часы, дайджест, локальный ассистент для триажа уведомлений (fail-open, shadow-режим), зашифрованные секреты (`${secret:NAME}`), журнал аудита, настройки |
|
|
49
|
-
| Интерфейсы | панель OpenCode GUI, веб-дашборд,
|
|
49
|
+
| Интерфейсы | панель OpenCode GUI, веб-дашборд, 30 инструментов для агента, встроенный скилл |
|
|
50
50
|
|
|
51
51
|
### Язык интерфейса
|
|
52
52
|
|
|
@@ -106,7 +106,7 @@ npm run build && npm run build:gui
|
|
|
106
106
|
|
|
107
107
|
## Инструменты для агента
|
|
108
108
|
|
|
109
|
-
Агенту доступен весь функционал —
|
|
109
|
+
Агенту доступен весь функционал — 30 инструментов: расписание, пайплайны, эксплуатация, аналитика и администрирование.
|
|
110
110
|
|
|
111
111
|
| Инструмент | Аргументы | Что делает |
|
|
112
112
|
|---|---|---|
|
|
@@ -262,7 +262,7 @@ src/
|
|
|
262
262
|
npm install
|
|
263
263
|
npm run build # tsc
|
|
264
264
|
npm run build:gui # vite
|
|
265
|
-
npm test #
|
|
265
|
+
npm test # 115 сюит, 600+ проверок
|
|
266
266
|
npm run test:en # те же сюиты с английской локалью
|
|
267
267
|
```
|
|
268
268
|
|
package/docs/README.zh.md
CHANGED
|
@@ -116,7 +116,7 @@ npm run build && npm run build:gui
|
|
|
116
116
|
|
|
117
117
|
## Agent 工具
|
|
118
118
|
|
|
119
|
-
agent 可获得完整功能 ——
|
|
119
|
+
agent 可获得完整功能 —— 30 个工具,覆盖调度、流水线、运维、可观测性与管理:
|
|
120
120
|
|
|
121
121
|
| 工具 | 参数 | 作用 |
|
|
122
122
|
|---|---|---|
|
|
@@ -270,7 +270,7 @@ src/
|
|
|
270
270
|
npm install
|
|
271
271
|
npm run build # tsc
|
|
272
272
|
npm run build:gui # vite
|
|
273
|
-
npm test #
|
|
273
|
+
npm test # 115 test suites, 600+ checks
|
|
274
274
|
npm run test:en # same suites with the English locale
|
|
275
275
|
```
|
|
276
276
|
|