devcontour-harness 0.1.0-alpha.35 → 0.1.0-alpha.42
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/README.md +56 -2
- package/docs/architecture.md +28 -4
- package/docs/contracts.md +294 -51
- package/docs/release-notes/0.1.0-alpha.36.md +26 -0
- package/docs/release-notes/0.1.0-alpha.37.md +40 -0
- package/docs/release-notes/0.1.0-alpha.38.md +31 -0
- package/docs/release-notes/0.1.0-alpha.39.md +38 -0
- package/docs/release-notes/0.1.0-alpha.40.md +27 -0
- package/docs/release-notes/0.1.0-alpha.41.md +49 -0
- package/docs/release-notes/0.1.0-alpha.42.md +44 -0
- package/docs/standalone.md +20 -0
- package/docs/toolchains.md +57 -2
- package/docs/upgrade.md +240 -0
- package/lib/agents/review-probe.d.ts +3 -1
- package/lib/agents/review-probe.js +8 -4
- package/lib/agents/schemas.d.ts +84 -2
- package/lib/agents/schemas.js +49 -1
- package/lib/cli.js +149 -1
- package/lib/contracts/cli.d.ts +1495 -170
- package/lib/contracts/cli.js +232 -2
- package/lib/contracts/diagnosis.d.ts +8 -4
- package/lib/contracts/diagnosis.js +3 -0
- package/lib/contracts/errors.d.ts +7 -1
- package/lib/contracts/errors.js +6 -0
- package/lib/contracts/events.d.ts +453 -60
- package/lib/contracts/events.js +79 -0
- package/lib/contracts/execution.d.ts +270 -50
- package/lib/contracts/execution.js +45 -3
- package/lib/contracts/failure.d.ts +14 -1
- package/lib/contracts/failure.js +9 -1
- package/lib/contracts/handoff.d.ts +70 -20
- package/lib/contracts/handoff.js +42 -1
- package/lib/contracts/index.d.ts +1 -0
- package/lib/contracts/index.js +1 -0
- package/lib/contracts/input-state.d.ts +13 -0
- package/lib/contracts/input-state.js +32 -0
- package/lib/contracts/input.d.ts +442 -0
- package/lib/contracts/input.js +321 -0
- package/lib/contracts/planning.d.ts +2 -0
- package/lib/contracts/policy.d.ts +36 -2
- package/lib/contracts/policy.js +61 -2
- package/lib/contracts/ports.d.ts +54 -0
- package/lib/contracts/project.d.ts +127 -0
- package/lib/contracts/project.js +99 -0
- package/lib/contracts/published.d.ts +604 -92
- package/lib/contracts/published.js +4 -1
- package/lib/contracts/repair-policy.d.ts +20 -0
- package/lib/contracts/repair-policy.js +34 -0
- package/lib/contracts/report.d.ts +53 -21
- package/lib/contracts/report.js +33 -2
- package/lib/contracts/result.d.ts +26 -24
- package/lib/contracts/review.d.ts +47 -8
- package/lib/contracts/review.js +21 -1
- package/lib/control/harness.d.ts +2555 -51
- package/lib/control/harness.js +112 -6
- package/lib/control/recovery.d.ts +2 -2
- package/lib/control/report.js +1 -0
- package/lib/control/status.d.ts +30 -22
- package/lib/control/status.js +11 -1
- package/lib/control/workflow.d.ts +8 -8
- package/lib/engine/budget.d.ts +86 -3
- package/lib/engine/budget.js +45 -10
- package/lib/engine/engine.d.ts +3091 -85
- package/lib/engine/engine.js +1229 -106
- package/lib/engine/input-policy.d.ts +68 -0
- package/lib/engine/input-policy.js +285 -0
- package/lib/engine/input-requests.d.ts +64 -0
- package/lib/engine/input-requests.js +187 -0
- package/lib/engine/joint-runner.js +2 -2
- package/lib/engine/measured.d.ts +6 -1
- package/lib/engine/measured.js +12 -1
- package/lib/engine/prompt.d.ts +4 -2
- package/lib/engine/prompt.js +3 -1
- package/lib/engine/property-recovery.js +2 -0
- package/lib/engine/repair.d.ts +2 -0
- package/lib/engine/repair.js +10 -3
- package/lib/engine/runner.d.ts +44 -4
- package/lib/engine/runner.js +347 -35
- package/lib/environment/isolation.d.ts +41 -1
- package/lib/environment/isolation.js +167 -5
- package/lib/environment/lifecycle.d.ts +54 -2
- package/lib/environment/lifecycle.js +96 -4
- package/lib/explain/state.d.ts +16 -2
- package/lib/explain/state.js +254 -77
- package/lib/handoff/markdown.js +10 -0
- package/lib/handoff/pack.js +42 -1
- package/lib/index.d.ts +10 -0
- package/lib/index.js +10 -0
- package/lib/init/inspect.d.ts +34 -0
- package/lib/init/inspect.js +292 -0
- package/lib/init/project.js +14 -31
- package/lib/integrations/connector/commands.d.ts +12 -12
- package/lib/integrations/connector/config.d.ts +4 -4
- package/lib/integrations/connector/delivery.d.ts +1 -1
- package/lib/integrations/relay-v2/protocol.d.ts +4 -4
- package/lib/profiles/resolve.d.ts +2 -1
- package/lib/projections/enums.d.ts +1 -1
- package/lib/projections/enums.js +4 -0
- package/lib/projections/index.d.ts +1 -0
- package/lib/projections/index.js +1 -0
- package/lib/projections/input.d.ts +17 -0
- package/lib/projections/input.js +28 -0
- package/lib/projections/stop.d.ts +40 -1
- package/lib/projections/stop.js +87 -4
- package/lib/report/compute.d.ts +4 -1
- package/lib/report/compute.js +41 -6
- package/lib/report/document.js +3 -2
- package/lib/storage/document.d.ts +66 -28
- package/lib/testing/index.d.ts +1 -1
- package/lib/testing/index.js +1 -1
- package/lib/testing/store-contract.d.ts +8 -1
- package/lib/testing/store-contract.js +194 -1
- package/lib/verification/confirm.d.ts +3 -3
- package/lib/verification/confirm.js +6 -4
- package/lib/verification/corpus.d.ts +9 -9
- package/lib/verification/gates-at.js +3 -1
- package/lib/verification/gates.d.ts +154 -1
- package/lib/verification/gates.js +378 -11
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +130 -0
- package/schemas/execution-policy.schema.json +31 -0
- package/schemas/handoff-pack.schema.json +146 -4
- package/schemas/input-request.schema.json +665 -0
- package/schemas/project-facts.schema.json +393 -0
- package/schemas/result-envelope.schema.json +1 -0
- package/schemas/run-event.schema.json +625 -0
- package/schemas/run-result.schema.json +1 -0
- package/schemas/stop-diagnosis.schema.json +5 -1
- package/schemas/value-report.schema.json +78 -7
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
|
|
|
5
5
|
интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
|
|
6
6
|
и доказательствами.
|
|
7
7
|
|
|
8
|
-
> Статус: `0.1.0-alpha.
|
|
8
|
+
> Статус: `0.1.0-alpha.42` — предварительный выпуск (alpha). Договоры
|
|
9
9
|
> `v1alpha1` могут измениться между alpha-версиями; закрепляйте точную версию.
|
|
10
10
|
> Файл → ревью плана → кандидат → интеграция → принятие → результат JSON, с
|
|
11
11
|
> ограниченным восстановлением, повторным использованием кандидата, бюджетами,
|
|
@@ -28,7 +28,7 @@ Headless-движок исполнения инженерных поручени
|
|
|
28
28
|
Из npm — точная версия (воспроизводимо) или последняя alpha по тегу:
|
|
29
29
|
|
|
30
30
|
```sh
|
|
31
|
-
npm install --save-exact devcontour-harness@0.1.0-alpha.
|
|
31
|
+
npm install --save-exact devcontour-harness@0.1.0-alpha.42 # точная версия
|
|
32
32
|
# или: npm install --save-exact devcontour-harness@alpha # текущая alpha
|
|
33
33
|
npx harness --version
|
|
34
34
|
```
|
|
@@ -104,6 +104,7 @@ git rev-parse refs/heads/harness/accepted # совпадает с data.result.
|
|
|
104
104
|
| `doctor` | Версии, runtime, sandbox, совместимость состояния |
|
|
105
105
|
| `report --state D [--format md\|html]` | Отчёт об эффекте по данным проекта |
|
|
106
106
|
| `handoff --state D [--format md] [--intent T]…` | Пакет передачи контекста новой сессии агента |
|
|
107
|
+
| `input-list / input-show / input-answer …` | Вопрос исполнителя: ответ, снимок, применение |
|
|
107
108
|
|
|
108
109
|
stdout — один JSON (`devcontour-harness/v1alpha1`), диагностика — stderr. Exit
|
|
109
110
|
codes: 0 успех, 2 неверный вход, 3 отказ/блокировка, 4 инфраструктура.
|
|
@@ -148,6 +149,59 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
|
|
|
148
149
|
`devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
|
|
149
150
|
Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
|
|
150
151
|
|
|
152
|
+
## Выпуск 0.1.0-alpha.42
|
|
153
|
+
|
|
154
|
+
Подготовка фазы (lifecycle, хранилище зависимостей, `prepare`), изменившая
|
|
155
|
+
конфигурацию IDE, агента, shell или корневого git в дереве, — отказ с
|
|
156
|
+
причиной `sandbox-policy` вместо молчаливого прохода; вложенные `.git`
|
|
157
|
+
(подмодули, клоны зависимостей) подготовке разрешены и принадлежат ей. Отказ
|
|
158
|
+
песочницы в удалении закреплённого каталога — отказ окружения, только когда
|
|
159
|
+
EPERM и путь названы отдельным словом в одной строке вывода. Подробно —
|
|
160
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.42.md).
|
|
161
|
+
|
|
162
|
+
## Выпуск 0.1.0-alpha.41
|
|
163
|
+
|
|
164
|
+
Gate может удалить и переименовать прежний вывод в своём worktree под
|
|
165
|
+
песочницей macOS; gate кандидата, исчерпавший предел времени под высокой
|
|
166
|
+
нагрузкой хоста, повторяется один раз на том же SHA. Подробно —
|
|
167
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.41.md).
|
|
168
|
+
|
|
169
|
+
## Выпуск 0.1.0-alpha.40
|
|
170
|
+
|
|
171
|
+
Проверки reviewer при ревью интеграции сравнивают входы установки
|
|
172
|
+
зависимостей с target, на который сделано слияние, — той же базой, что
|
|
173
|
+
называет запрос reviewer. Подробно —
|
|
174
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.40.md).
|
|
175
|
+
|
|
176
|
+
## Выпуск 0.1.0-alpha.39
|
|
177
|
+
|
|
178
|
+
Ревью интеграции сравнивает с актуальным target, а не с базой попытки, и не
|
|
179
|
+
видит чужую уже принятую работу. Необязательное поле политики
|
|
180
|
+
`gateTimeoutFloorMs` поднимает короткие пределы gates. Интеграция без
|
|
181
|
+
слияния кандидата с target отказывает явно. Подробно —
|
|
182
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.39.md).
|
|
183
|
+
|
|
184
|
+
## Выпуск 0.1.0-alpha.38
|
|
185
|
+
|
|
186
|
+
Остановка вопросом исполнителя (`needs-input`) больше не тратит попытку:
|
|
187
|
+
ответ на вопрос последней попытки применяется без сброса. Таких остановок у
|
|
188
|
+
поручения — не больше `maxAttempts`; следующие засчитываются как обычные
|
|
189
|
+
попытки, поэтому цикл вопросов ограничен. Подробно —
|
|
190
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.38.md).
|
|
191
|
+
|
|
192
|
+
## Выпуск 0.1.0-alpha.37
|
|
193
|
+
|
|
194
|
+
Вопрос исполнителя (`inputRequest`, политика `inputPolicy`, ответ с ревью
|
|
195
|
+
контекста и переносом в новую редакцию) и диагностика остановок для многих
|
|
196
|
+
работ за одно чтение (`workIds`, `budgetBlocksOf`). Подробно —
|
|
197
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.37.md).
|
|
198
|
+
|
|
199
|
+
## Выпуск 0.1.0-alpha.36
|
|
200
|
+
|
|
201
|
+
Факты проекта только для чтения (`inspectProject`, договор `project-facts`) и
|
|
202
|
+
установка зависимостей исполнителя до его запуска. Подробно —
|
|
203
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.36.md).
|
|
204
|
+
|
|
151
205
|
## Выпуск 0.1.0-alpha.35
|
|
152
206
|
|
|
153
207
|
Нехватка окна контекста claude — отдельный класс отказа `context-exhausted`
|
package/docs/architecture.md
CHANGED
|
@@ -624,6 +624,17 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
624
624
|
Провал, в отчёте которого названо проваленное свойство или случай корпуса,
|
|
625
625
|
не повторяется: это найденный контрпример, и удачный второй запуск
|
|
626
626
|
недетерминированной проверки его не отменяет.
|
|
627
|
+
- **Повтор таймаута кандидата под нагрузкой.** Gate кандидата, исчерпавший
|
|
628
|
+
свой предел времени (не отмена попытки), когда средняя нагрузка хоста за
|
|
629
|
+
минуту не ниже 2 на ядро (`HOST_LOAD_RECHECK_PER_CPU`; меньшая из снятых до
|
|
630
|
+
запуска gate и в момент таймаута), controller один раз
|
|
631
|
+
на попытку повторяет на том же candidate SHA. Нагрузка названа в сводке
|
|
632
|
+
записи. Повтор прошёл — `recheck.outcome: flaky`, попытка не тратится;
|
|
633
|
+
снова таймаут или другой провал — `confirmed`, отказ `gate` засчитывается
|
|
634
|
+
как прежде. Таймаут на свободной машине, провал, записанный в JUnit или
|
|
635
|
+
отчёт свойств до таймаута, и прочие провалы кандидата не повторяются. Лог — в `candidate/recheck/`, замер — стадия
|
|
636
|
+
`candidate-recheck:<gate>`. У каждой фазы попытки свой единственный повтор:
|
|
637
|
+
повтор кандидата бюджет повтора интеграции не тратит.
|
|
627
638
|
- **Атомарная приёмка.** Продвижение target ref — compare-and-swap внутри
|
|
628
639
|
транзакции приёмки. Чужой коммит в target ref не теряется: попытка начнётся
|
|
629
640
|
от новой базы. Падение между update-ref и записью принятия восстанавливается
|
|
@@ -664,10 +675,23 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
664
675
|
операции: каталог, собранный в `node_modules` и перенесённый в дерево
|
|
665
676
|
проекта, ими не закрыт. До и после каждого gate и вокруг работы исполнителя
|
|
666
677
|
сравнивается снимок защищённых имён вне `node_modules` (каталоги IDE,
|
|
667
|
-
конфигурация shell и git, `.claude`, `.git`);
|
|
668
|
-
`scope-violation` с путями в сообщении.
|
|
669
|
-
(
|
|
670
|
-
|
|
678
|
+
конфигурация shell и git, `.claude`, `.git`); новое, изменённое или
|
|
679
|
+
исчезнувшее с содержимым — класс `scope-violation` с путями в сообщении.
|
|
680
|
+
Подготовка фазы (lifecycle `setup`/`ready`, хранилище зависимостей, шаги
|
|
681
|
+
`prepare`) идёт вне песочницы: снимок до неё сверяется сразу после
|
|
682
|
+
`prepare` (`preparationGuard`; фаза без подготовки дерево не обходит).
|
|
683
|
+
Вложенный `.git`, созданный или изменённый там (подмодули, клоны
|
|
684
|
+
зависимостей), разрешён и записывается в `execution.prepared`: сверки
|
|
685
|
+
исполнителя, установки и gates той же фазы не считают только его
|
|
686
|
+
исчезновение (уборку переносом родителя); изменение и подмена другим
|
|
687
|
+
`.git` остаются нарушением. Остальные защищённые пути, изменённые подготовкой, — отказ с
|
|
688
|
+
причиной `sandbox-policy` и путями в сообщении: в попытке — отказ
|
|
689
|
+
окружения, в `gates-at` — ошибка команды, в подтверждении контрпримера —
|
|
690
|
+
`inconclusive`. Совместная проверка рабочей области этой сверки не
|
|
691
|
+
получает. Дерево из
|
|
692
|
+
одних пустых каталогов (служебный `.claude/.cc-writes` CLI исполнителя)
|
|
693
|
+
нарушением не считается, если до снимка пути не было или он тоже был без
|
|
694
|
+
файлов; любой файл или
|
|
671
695
|
символьная ссылка внутри, правка прежнего пути с файлами и замена файла
|
|
672
696
|
`.git` каталогом — нарушение. Пустым деревом не считаются FIFO, сокеты и
|
|
673
697
|
прочие не-каталоги, а также каталог, открытый на запись всем
|