Clew

Нить через лабиринт brownfield. хоп — это узел на этой нити (docs/hops.md).

Brownfield-сервисы уже работают. Кодирующие агенты по-прежнему платят за повторное открытие одного и того же многосервисного потока в каждой сессии. Clew сохраняет четыре графа, которые у вас уже есть — код, каталог, loadout, трассы — и соединяет их в путь, по которому можно идти.

Input → Branches → Output
measure → one P0 → capture → measure    until reflected

go install github.com/jeunessegamesee/clew/cmd/clew@v0.1.1

Никакой лицензии Scale, никакого Neo4j, никакого OpenSearch.

Любой brownfield, три команды

clew init --root /path/to/repo     # .clew.yaml + CLEW.md
clew stub --root /path/to/repo     # IN+else for every gRPC / GraphQL / OpenAPI port
clew score --root /path/to/repo    # P0 = missing IN; P1 = uncaptured branches
clew loadout --root /path/to/repo --in /package.Service/Method

Заглушки позволяют ссылаться на каждый входящий порт. Деревья без when остаются P1 незахваченными. Углубляйте с помощью clew loop — не изобретайте ветви.

Related MCP server: PrecisionContextEngine

Сборка из исходников

go test ./...
go build -o clew ./cmd/clew
./clew score --root examples/shop --fail-p0
./clew loadout --root examples/shop --use-case place-order --payload '{"paymentMethod":"CARD"}'
./clew loop --root testdata/incomplete-shop

./clew score --root examples/shop --by-service
./clew score --root examples/shop --fail-p1
./clew watch --root examples/shop --traces traces/live.jsonl --follow
./clew watch --root examples/shop --listen 127.0.0.1:4318
./clew mcp

clew mcp — это stdio MCP-сервер (loadout, who_consumes, who_calls, next_p0, drift, score). Каждый инструмент имеет свою собственную схему ввода.

Файл адаптации

.clew.yaml — это то, как чужой репозиторий становится картой:

roots:
  - .
  - ../other-repo
services:
  checkoutservice: src/checkoutservice   # OTel service.name → hops folder
traces:
  - traces/*.json

Универсальные двери (без парсера для каждого фреймворка): OpenAPI / proto / GraphQL, OTLP (clew watch) или clew ingest --file doors.json. Опциональный http: [auto] угадывает Actix/Spring/… и не является способом добавления нового стека.

Язык

Clew написан на Go. CBM остаётся графом кода. Мы объединяем HTTP/ASYNC/CROSS, OpenAPI/AsyncAPI и OTLP — мы не перестраиваем индексатор.

Формат карты

См. SPEC.md. Для каждого сервиса: docs/hops.md. Покрытие: clew score --fail-p0. После исполняемого файла: --fail-p1 замораживает незахваченные заглушки.