[llm] agent-facing interfaces: interactive REPL and in-binary MCP server

.github/workflows/ci.yml

@@ -113,7 +113,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        target: [unit, stdlib, examples]
+        target: [unit, stdlib, examples, test-llm, test-mcp]
     steps:
     - uses: actions/checkout@v4
     - uses: actions/download-artifact@v4

Makefile

@@ -13,6 +13,12 @@ CHECK     += --jobs="$(ECJOBS)"
 CHECK     += --bin-args=-timeout --bin-args="$(ECTOUT)"
 CHECK     += $(foreach arg,$(ECARGS),--bin-args="$(arg)")
 CHECK     += $(ECEXTRA) config/tests.config
+LLMCHECK  := scripts/testing/llm-golden
+LLMCHECK  += --bin=./ec.native
+MCPCHECK  := scripts/testing/mcp-golden
+MCPCHECK  += --bin=./ec.native
+MCPPARITY := scripts/testing/mcp-parity
+MCPPARITY += --bin=./ec.native
 NIX       ?= nix --extra-experimental-features "nix-command flakes"
 PROFILE   ?= dev
 
@@ -22,6 +28,7 @@ UNAME_S = $(shell uname -s)
 
 # --------------------------------------------------------------------
 .PHONY: default build byte native tests check examples
+.PHONY: test-llm test-mcp
 .PHONY: nix-build nix-build-with-provers nix-develop
 .PHONY: clean install uninstall
 
@@ -51,7 +58,14 @@ stdlib: build
 examples: build
 	$(CHECK) examples mee-cbc
 
-check: unit stdlib examples
+test-llm: build
+	$(LLMCHECK)
+
+test-mcp: build
+	$(MCPCHECK)
+	$(MCPPARITY)
+
+check: unit stdlib examples test-llm test-mcp
 	@true
 
 nix-build:

README.md

@@ -166,6 +166,13 @@ with proof scripts). At present, the only available front-end is based on Emacs'
 [Proof General](https://github.com/ProofGeneral/PG).
 However, a front-end for VSCode is currently in development.
 
+Besides these, EasyCrypt ships an interface aimed at LLM agents rather
+than at humans: `easycrypt llm`, an interactive REPL speaking a
+machine-friendly protocol, and `easycrypt mcp`, a
+[Model Context Protocol](https://modelcontextprotocol.io/) server over
+stdio. Both drive the same proof engine, and both are documented in
+[doc/llm/CLAUDE.md](doc/llm/CLAUDE.md).
+
 ### Proof-General (Emacs)
 
 EasyCrypt mode has been integrated upstream. Please, go