Parenchek

Parenchek checks structural delimiters in Common Lisp, Scheme, and Clojure source. It provides language-aware in-memory analysis, bounded edit warnings, and a recursive filesystem checker for SBCL on Unix.

The scanner ignores delimiters inside:

• strings
• line comments
• supported nested block comments
• escaped symbols
• character literals
• script headers
• language-specific reader escapes

It reports unexpected closers, mismatched delimiter types, and unclosed openers with one-based line and column locations.

Usage

(asdf:load-system :parenchek)

(parenchek:lisp-source-balance-issues
 #P"example.clj"
 "{:items [1 2)}")

(parenchek:lisp-source-balance-warning
 #P"example.scm"
 "(define value 1")

(parenchek:lisp-source-edit-result-content
 "Applied edit."
 #P"example.lisp"
 "(defun incomplete ()")

lisp-paren-check-path checks one recognized source file or recursively checks a directory. It returns two values: a success boolean and bounded model-facing text. :readable-roots may restrict canonical filesystem authority. Failures before candidate checking, including unsafe root changes and traversal limits, signal lisp-paren-check-error. Individual file read and snapshot failures become failed diagnostics in the returned report.

(multiple-value-bind (success-p report)
    (parenchek:lisp-paren-check-path
     #P"src/"
     :readable-roots (list (truename #P"./")))
  (format t "~:[failed~;passed~]~%~A~%" success-p report))

Supported source extensions

• Common Lisp: asd, cl, lisp, lsp, ros
• Scheme: sch, scheme, scm, sld, sls, ss
• Clojure: bb, clj, cljc, cljs, edn

Tests

./script/bootstrap
./script/check

License

Parenchek uses COLL-Attribution. The authoritative terms are in LICENSE.lisp.