Rocq Check File
rocq_check_fileCheck a Rocq file and report error diagnostics with source sentences and proof states. Use it to find proof errors and long-running sentences, with caching and graceful timeout handling.
Instructions
Check a Rocq file and report diagnostics.
Use this to check files for errors. (To find warnings, recompile the file manually.) Error diagnostics include the source sentence and the proof state at error positions.
The first error in a file is always reported, along with later errors reached within the after-error deadline. The list of errors may be truncated. The tool also reports Rocq sentences running for long time.
This tool is efficient due to per-file caching. For dune-based Rocq projects,
it attempts to rebuild dependencies before checking and restarts the cached
coq-lsp process when that applies. Use clear_cache = true when project
files have changed or dependencies were rebuilt outside dune.
Timeouts are handled gracefully, and partial diagnostics are returned when possible. Repeated checks after timeouts use the cache.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file": "<file>"
},
"name": "rocq_check_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Absolute path to a .v file. | |
| clear_cache | No | Restart this file's coq-lsp process before checking. | |
| command_timeout_seconds | No | Per Rocq sentence watchdog for checking. None uses the server default, 0 disables it, and positive values abort on slow sentences. | |
| timeout_after_error_seconds | No | Overall deadline once the first error has been reported: the whole check is stopped at most this many seconds after the first error. None uses the server default, 0 disables it, and positive values enable it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||