berimor 0.41.0 → 0.43.0
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 +8 -5
- package/checksums.json +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
[](https://www.npmjs.com/package/berimor)
|
|
15
15
|
[](https://github.com/devpilgrin/berimor/actions/workflows/ci.yml)
|
|
16
16
|
[](LICENSE)
|
|
17
|
-
[](#инфраструктура-проекта)
|
|
18
18
|
|
|
19
19
|
|
|
20
20
|
|
|
@@ -134,15 +134,19 @@ Deny-таблица деструктивных операций не переи
|
|
|
134
134
|
|
|
135
135
|
**SGR: схема ведёт рассуждение** (0.30.0): контракт может объявлять поля-обоснования ДО целевых — `risk_factors` (непустой список) перед `risk` в `ClassificationOut`; заполнив факторы, модель назначает оценку с опорой, а не произвольно. Порядок полей в JSON Schema соответствует порядку объявления (schemars `preserve_order`). На провайдерах с constrained decoding (`response_format = "json_schema"` в `[[providers]]`: OpenAI-совместимые, Ollama через `format`, llama.cpp) порядок генерации принуждается схемой физически — модель не может выдать число, не заполнив факторы. На провайдерах без constrained decoding (DeepSeek, Kimi — только `json_object`) работает мягкий уровень: порядок полей в промпте + обязательность по схеме + валидация медиации. Правило для конфиг-контрактов: поля-обоснования объявляйте раньше целевых. Автономный llama.cpp (in-process) принуждает порядок GBNF-грамматикой, построенной из схемы контракта (0.31.0).
|
|
136
136
|
|
|
137
|
+
**Волна E: память** (0.42.0): Qdrant-адаптер слоя Facts — `[memory] qdrant_url = "http://127.0.0.1:6333"` (+ `qdrant_collection`, `qdrant_api_key_env`): семантический поиск по HNSW-индексу вместо полного скана SQLite (чистый HTTP/JSON, gRPC-клиент не прибавлен); upsert/scroll/cosine/hybrid/delete проверены живым прогоном против реального Qdrant. Кэш ответов модели по ТОЧНОМУ хэшу запроса — `[agent] response_cache = true`: повторный вызов с тем же входом не идёт к провайдеру (попадание не пишет usage — вызова не было); хранилище — отдельный `<storage>.cache.db` (удаление = инвалидация); кэш по похожести эмбеддингов осознанно не строится (недетерминизм ответа).
|
|
138
|
+
|
|
137
139
|
**Волна D: Rego-правила гейта** (0.41.0): внешняя политика OPA/Rego поверх статических правил capability-гейта — через regorus (in-process, без sidecar). `[gate] rego_policy = "policy.rego"` + `environment = "prod"`: политика (`package berimor`, `deny contains msg if { ... }`) видит `input.tool`, `input.args`, `input.mutates`, `input.environment` и может только запрещать строже статики — разрешить слабее нельзя, ядро остаётся детерминированным. Ошибка разбора — отказ старта, ошибка вычисления — fail-closed. Пример из заявки работает: «terminal.exec запрещён в prod-окружении».
|
|
138
140
|
|
|
141
|
+
**Волна F: berimor как GitHub App** (0.43.0): `berimor serve` принимает вебхуки GitHub на `POST /webhooks/github` — верификация HMAC-SHA256 (webhook secret), JWT RS256 → installation token, триггер-метка в комментарии (дефолт `/berimor`) запускает процесс неинтерактивно, итог возвращается комментарием в issue/PR. Ответ 202 немедленно, процесс — в фоне. Конфиг `[github_app]`: app_id, private_key_path, process, trigger.
|
|
142
|
+
|
|
139
143
|
**Волна C: LLM-as-a-Judge** (0.40.0): `berimor eval <dir> --judge` — после прогона golden-набора сильный провайдер (первый в порядке failover) оценивает финальное состояние каждого завершённого сценария: скор 1-5 и обоснование пишутся событием `judge_score` в журнал прогона сценария и в вывод. Критерии — файл `<сценарий>.judge.md` рядом с входом (иначе рубрика по умолчанию: полнота, точность, отсутствие выдумок, форма). `--judge-threshold <N>` — CI-гейт: средний балл ниже порога = ошибка команды. Разбор ответа судьи идёт через тот же EOF-ремонт медиации; незавершённые сценарии (гейт, ошибка) судья честно пропускает.
|
|
140
144
|
|
|
141
145
|
**Волна B: наблюдаемость** (0.39.0): `berimor otlp <run> --endpoint <url>` — прогон процесса как трейс в OTLP/HTTP JSON: корневой спан запуска, спан на узел графа, спан вызова LLM (латентность + токены в атрибутах), human_gate (интервал до ответа/таймаута), ходы инструментов свободного цикла. traceId/spanId детерминированы (повторный экспорт идемпотентен). Принимается коллекторами Jaeger и Grafana Tempo (порт 4318) и Langfuse — единый OTLP, отдельные экспортёры не нужны; заголовки авторизации — `--header 'Name: value'`.
|
|
142
146
|
|
|
143
147
|
**Волна A: отказоустойчивость и стоимость** (0.38.0): circuit breaker в Model Pool — N последовательных транспортных сбоев провайдера открывают автомат, провайдер пропускается до полуоткрытой пробы по cooldown, об открытии — видимый алерт «<имя> → circuit-open» (`[agent] breaker_failures`, `breaker_cooldown_secs`; 0 = выключено). Атрибуция стоимости: каждый вызов модели журналирует usage (токены, латентность, шаг — событие `model_usage`), у локального llama.cpp токены считает токенизатор; `berimor cost <run>` — отчёт по шагам и итог (цены — `cost_per_1k_tokens` провайдера; без цены — честные токены без выдуманных денег).
|
|
144
148
|
|
|
145
|
-
**Слой правил и berimor как MCP-сервер** (0.37.0, по мотивам Harness AI 3.0): (1) **правила** — markdown-стандарты из `~/.config/berimor/rules/` и `.berimor/rules/` подмешиваются в контекст всех шагов с моделью ДО генерации (мягкий слой; жёсткий — по-прежнему медиация); проектные сильнее глобальных; (2) **`berimor mcp-serve`** — MCP-сервер по stdio: внешние агенты
|
|
149
|
+
**Слой правил и berimor как MCP-сервер** (0.37.0, по мотивам Harness AI 3.0): (1) **правила** — markdown-стандарты из `~/.config/berimor/rules/` и `.berimor/rules/` подмешиваются в контекст всех шагов с моделью ДО генерации (мягкий слой; жёсткий — по-прежнему медиация); проектные сильнее глобальных; (2) **`berimor mcp-serve`** — MCP-сервер по stdio: внешние агенты и редакторы гоняют процессы berimor через инструменты `process.list`/`process.run`/`trace.read` — модель думает снаружи, код решает внутри; (3) **GitHub Action** `devpilgrin/berimor-action@v1` — процессы как шаги CI.
|
|
146
150
|
|
|
147
151
|
**Заимствования из DeepSeek Harness** (0.36.0): (1) **pruner наблюдений** — длинный результат инструмента обрезается в промпте (голова+маркер+хвост, оригинал в журнале; `[agent] tool_result_max_chars`, 0 = выкл); (2) **Landlock-песочница** для `terminal.exec`/`terminal.start` — собственная реализация на libc (без внешнего бинаря): подпроцесс физически не выходит за рабочую область, системные каталоги — read-only; `[sandbox] landlock = off|auto|require`, require — fail-closed; (3) **compaction чата** — история длиннее порога сжимается в конспект старшим провайдером, хвост дословно, сбой суммаризации не роняет ход (`[agent] compact_threshold_chars`, 0 = выкл).
|
|
148
152
|
|
|
@@ -195,7 +199,7 @@ flowchart LR
|
|
|
195
199
|
|
|
196
200
|
**Rust-workspace по крейту на компонент** — Process Engine, Mediation, Executors, Memory, Capability, Model Pool, Actors, Tool Runtime, Context Engine, Eval, Storage. Гостевой WASM-модуль (`codeact-guest/`) живёт отдельным crate и закоммичен как готовый артефакт — обычная сборка не замедляется.
|
|
197
201
|
|
|
198
|
-
**Дисциплина проверок.** Каждый релиз: `cargo fmt` + `clippy -D warnings` + `cargo test --workspace` (
|
|
202
|
+
**Дисциплина проверок.** Каждый релиз: `cargo fmt` + `clippy -D warnings` + `cargo test --workspace` (992 тестов: юнит, интеграционные, e2e через настоящий бинарник, золотые фикстуры процессов и вредоносных вводов). Критические компоненты проходят обязательное независимое ревью. Полный самостоятельный аудит (`docs/audit-2026-07-31.md`) — **все находки закрыты или осознанно задокументированы**.
|
|
199
203
|
|
|
200
204
|
**Supply chain как у взрослых.** Кросс-платформенные релизы (Linux x64/arm64, macOS arm64, Windows x64) с keyless-подписью cosign/sigstore — приватного ключа не существует нигде. Проверка: `berimor verify <архив>`. npm-публикация с provenance, SBOM (CycloneDX) в пайплайне, самообновление (`berimor self-update`) реализовано на примитивах Process Engine — тот же журнал и восстановление после сбоя, что у обычных процессов, а не ad hoc скрипт.
|
|
201
205
|
|
|
@@ -304,9 +308,8 @@ berimor plugin install-local ./my-plugin --allow-unsigned # лок
|
|
|
304
308
|
| План разработки | `docs/ROADMAP.md` | очередь задач по фазам, декомпозиция на подзадачи, сложность, класс модели-исполнителя |
|
|
305
309
|
| Аудит | `docs/audit-2026-07-31.md` | независимый аудит безопасности — все находки закрыты или осознанно задокументированы |
|
|
306
310
|
| Тестовые данные | `fixtures/golden/` | золотые наборы: примеры процессов, контрактов, вредоносных вводов |
|
|
307
|
-
| Исследования | `docs/rnd/` | вспомогательный слой: источники и анализ существующих агентных фреймворков. См. `docs/rnd/README.md` |
|
|
308
311
|
|
|
309
|
-
`crates/` и `bootstrap/` — сам агент, код, написанный по очереди из `docs/ROADMAP.md`. `docs/arch/` — слой чистых решений позади него: не упоминает конкретные проекты и продукты (кроме `docs/arch/deployment.md` и `docs/arch/stack.md`, где это осознанное исключение), излагает архитектуру так, чтобы её можно было реализовать на любом стеке. `docs/ADR/` фиксирует, почему принято каждое решение, включая отклонённые альтернативы.
|
|
312
|
+
`crates/` и `bootstrap/` — сам агент, код, написанный по очереди из `docs/ROADMAP.md`. `docs/arch/` — слой чистых решений позади него: не упоминает конкретные проекты и продукты (кроме `docs/arch/deployment.md` и `docs/arch/stack.md`, где это осознанное исключение), излагает архитектуру так, чтобы её можно было реализовать на любом стеке. `docs/ADR/` фиксирует, почему принято каждое решение, включая отклонённые альтернативы.
|
|
310
313
|
|
|
311
314
|
## Лицензия
|
|
312
315
|
|
package/checksums.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"berimor-v0.
|
|
3
|
-
"berimor-v0.
|
|
4
|
-
"berimor-v0.
|
|
5
|
-
"berimor-v0.
|
|
2
|
+
"berimor-v0.43.0-darwin-arm64.tar.gz": "6d2ad94aa95b8fff98268ed3f37b116240a97af6584f51c442a6fc79684d4331",
|
|
3
|
+
"berimor-v0.43.0-linux-arm64.tar.gz": "528241a24d1aae147115b9f946e51b4efb5d2656a0051ad703115815487d8540",
|
|
4
|
+
"berimor-v0.43.0-linux-x64.tar.gz": "4ceb58c92e0337e01bdae350cf711bf3b00dd2863357fcfd36d9cc04de9a1d6a",
|
|
5
|
+
"berimor-v0.43.0-win32-x64.zip": "5641a2abf877ad0694b9d0ffbf39a3fb22856b2fa7aa4494129eaf0a63d62b16"
|
|
6
6
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "berimor",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.43.0",
|
|
4
4
|
"description": "Berimor — агентный CLI для LLM: интерактивный чат с инструментами (файлы, терминал, HTTP), детерминированные процессы, аудит и replay. Этот пакет — установщик платформенного бинарника.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|