Define a heuristic for GL to use when generating counterexamples

Usage:

(gl::def-glcp-ctrex-rewrite ;; from: (lhs-lvalue lhs-rvalue) ;; to: (rhs-lvalue rhs-rvalue) :test syntaxp-term)

Example:

(gl::def-glcp-ctrex-rewrite ((logbitp n x) t) (x (logior (ash 1 n) x)) :test (quotep n))

If GL has generated Boolean variables corresponding to term-level objects, then an assignment to the Boolean variables does not directly induce an assignment of ACL2 objects to the ACL2 variables. Instead, we have terms that are assigned true or false by the Boolean assignment, and to generate a counterexample, we must find an assignment for the variables in those terms that cause the terms to take the required truth values. Ctrex-rewrite rules tell GL how to move from a valuation of a term to valuations of its components.

The example rule above says that if we want

Note that this rule does not always yield the desired result -- for example, in the case where N is a negative integer. Because these are just heuristics for generating counterexamples, there is no correctness requirement and no checking of these rules. Bad counterexample rules can't make anything unsound, but they can cause generated counterexamples to be nonsense. Be careful!