Clew

Der Faden durch ein Brownfield-Labyrinth. Ein Hop ist ein Knoten auf diesem Faden (docs/hops.md).

Brownfield-Dienste funktionieren bereits. Coding-Agenten zahlen trotzdem dafür, denselben Multi-Service-Ablauf in jeder Sitzung neu zu entdecken. Clew behält die vier Graphen, die Sie bereits haben — Code, Katalog, Loadout, Traces — und verbindet sie zu einem Pfad, den Sie begehen können.

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

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

Keine Scale-Lizenz, kein Neo4j, kein OpenSearch.

Jedes Brownfield, drei Befehle

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

Stubs lassen Sie auf jeden eingehenden Port verweisen. Bäume ohne when bleiben P1 unerfasst. Vertiefen Sie mit clew loop — erfinden Sie keine Verzweigungen.

Related MCP server: PrecisionContextEngine

Aus dem Quellcode erstellen

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 ist ein stdio-MCP-Server (loadout, who_consumes, who_calls, next_p0, drift, score). Jedes Tool hat sein eigenes Eingabeschema.

Anpassungsdatei

Mit .clew.yaml wird aus einem fremden Repo eine Karte:

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

Generische Türen (kein Parser pro Framework): OpenAPI / proto / GraphQL, OTLP (clew watch) oder clew ingest --file doors.json. Optional errät http: [auto] Actix/Spring/… und ist nicht der Weg, wie ein neuer Stack hinzugefügt wird.

Sprache

Clew ist Go. CBM bleibt der Codegraph. Wir verbinden HTTP/ASYNC/CROSS, OpenAPI/AsyncAPI und OTLP — wir bauen keinen Indexer neu.

Kartenformat

Siehe SPEC.md. Pro Dienst: docs/hops.md. Abdeckung: clew score --fail-p0. Nach der ausführbaren Datei: --fail-p1 friert unerfasste Stubs ein.