How karatelabs/karate-agent-examples works
This repository is a collection of runnable Karate Agent evaluation kits, not the governance engine itself. The principal workflow is that a human or AI agent runs a kit, whose checks exercise a sample system and whose evidence supports coverage or requirements-traceability reports. The graph preserves the README’s major kit capabilities and the sampled rulebook, mock, and server responsibilities. Several branches are documented in the README but their implementations were not sampled, so those links cite the README rather than imply inspection of their source.
Main entry points: traceability-demo Loan traceability kits · policy-api Policy API kit · fleetquote Fleetquote kit · mcp MCP example kit
Components 23
Traceability demos
- Loan traceability kits
traceability-demo - Personal-loan rules
traceability-demo/rulebooks/personal-loan/calc.js - Loan Desk SUT
traceability-demo/sut/loan-calc.js - Loan Desk UI check
traceability-demo/checks/drive-quote.js - Kiro decision kit
kiro-demo - Decision service
kiro-demo/sut/decision.js - Fleetquote kit
fleetquote - Rating oracle
fleetquote/rulebooks/rating/calc.js - Quote lifecycle twin
fleetquote/rulebooks/rating/twin.js
Insurance protocols
- Policy API kit
policy-api - Protocol coverage setup
policy-api/karate-boot.js - API and rule checks
policy-api/suite.karate.js
Contract testing
- Checkout contract kit
checkout - Mock-provider paired run
checkout/contract.karate.js
Protocol examples
- Protocol test kits
grpc - gRPC protocol contract
grpc/proto/hello.proto - Kafka example
kafka - WebSocket example
websocket - STOMP broker
websocket/server/StompBroker.java
MCP example
- MCP example kit
mcp - Inventory MCP server
mcp/server/src/server.ts
Other components
- Human or AI agent
- Karate Agent engine
Connections 26
- Human or AI agent → Karate Agent engine: drives
- Karate Agent engine → Loan traceability kits: runs kit
- Karate Agent engine → Kiro decision kit: runs kit
- Karate Agent engine → Fleetquote kit: runs kit
- Karate Agent engine → Policy API kit: runs kit
- Karate Agent engine → Checkout contract kit: runs kit
- Karate Agent engine → Protocol test kits: runs kit
- Karate Agent engine → Kafka example: runs kit
- Karate Agent engine → WebSocket example: runs kit
- Karate Agent engine → MCP example kit: runs kit
- Loan traceability kits → Personal-loan rules: oracles with
traceability-demo/checks/drive-quote.js - Loan traceability kits → Loan Desk SUT: checks against
traceability-demo/sut/loan-calc.js - Loan traceability kits → Loan Desk UI check: includes UI check
traceability-demo/karate-boot.js - Kiro decision kit → Decision service: tests service
kiro-demo/sut/decision.js - Fleetquote kit → Rating oracle: grades rules
fleetquote/suite.karate.js - Fleetquote kit → Quote lifecycle twin: models lifecycle
- Policy API kit → Protocol coverage setup: configures coverage
policy-api/karate-boot.js - Policy API kit → API and rule checks: includes checks
- Policy API kit → Karate Agent engine: reports traceability
policy-api/karate-boot.js - Checkout contract kit → Mock-provider paired run: pairs implementations
checkout/contract.karate.js - Mock-provider paired run → Karate Agent engine: uses contract runner
checkout/contract.karate.js - Protocol test kits → gRPC protocol contract: tests contract
- WebSocket example → STOMP broker: includes server
websocket/server/StompBroker.java - MCP example kit → Inventory MCP server: tests server
mcp/server/src/server.ts - Human or AI agent → MCP example kit: can drive via MCP
- Inventory MCP server → Karate Agent engine: serves MCP tools