memex/projects/verify-repl-tool

verify-repl

Compliance checker for literate programming discipline. Scans .org files for violations of the REPL-first and one-per-block rules.

== Usage

  verify-repl org/
  verify-repl projects/passepartout/org/

== Checks performed

1. REPL-first — every (defun|defmacro|defvar|defstruct|defmethod|defclass) block must have ;; REPL-VERIFIED: <timestamp> on the line above #+begin_src lisp. Any definition block without this comment is a violation.
2. One-per-block — each #+begin_src lisp block must contain exactly one top-level form. Multiple defuns in the same block are a violation.
3. Prose-before-code — each code block must be preceded by an Org headline (the prose explanation). Blocks without a preceding headline are a violation.

== Exempt files

Some core infrastructure files are blacklisted (package definitions, setup), defined in the script's BLACKLIST array. Extend as needed.

== Dependencies

Bash, grep.