eyemind 0.1.23 → 0.1.24

package/README.md

@@ -15,10 +15,10 @@ JavaScript library, and a browser application, with no dependencies.
   write rules, check proofs, use the library, and develop eyemind.
 - **[Specification](https://eyereasoner.github.io/eyemind/SPEC)**: the
   language, its canonical text, the proof format, and the C1–C8 checks.
-- **[Examples](examples/)**: 80 runnable programs, with their conclusions,
+- **[Examples](examples/)**: 90 runnable programs, with their conclusions,
   proofs and check reports, and a
   [card deck](https://eyereasoner.github.io/eyemind/examples/deck/) for each.
-- **[Conformance suite](conformance/)**: 353 cases that test any
+- **[Conformance suite](conformance/)**: 356 cases that test any
   implementation of the specification through its command line.
 
 ```js

package/SPEC.md

@@ -2,7 +2,7 @@
 
 ```text
 Title:      The eyemind Rule Language and Proof Format
-Version:    eyemind 0.1.23
+Version:    eyemind 0.1.24
 Status:     Informational
 Author:     Jos De Roo, KNoWS office of IDLab, Ghent University - imec
 Repository: https://github.com/eyereasoner/eyemind
@@ -22,7 +22,7 @@ command line.
 ## Status of This Memo
 
 This document is not an Internet Standards Track specification. It describes
-the language and formats as implemented by eyemind 0.1.23, for readers who want
+the language and formats as implemented by eyemind 0.1.24, for readers who want
 to write programs, produce or consume proofs and reports, or implement a
 compatible reasoner or checker. Where this document and the implementation
 disagree, that is a defect in one of them.
@@ -814,15 +814,16 @@ eyemind [OPTION ...] [FILE ...]
 | Option | Meaning |
 | --- | --- |
 | (none) | Load the files, or standard input, as one program and print its conclusions. |
-| `--proof` | Print the proof document instead. |
-| `--check-proof FILE` | Check the proof in `FILE` (`-` for standard input) against the program and print its report. |
+| `-p`, `--proof` | Print the proof document instead. |
+| `-c FILE`, `--check-proof FILE` | Check the proof in `FILE` (`-` for standard input) against the program and print its report. |
 | `--json` | With `--check-proof`, print the report as JSON. |
 | `--goal GOAL` | Ask `GOAL`, read as in Section 9, where an array is a conjunction; MAY be repeated. With `--check-proof`, the goals the proof answers. |
 | `--strict-proof` | With `--check-proof`, forbid trusted boundaries. |
 | `--unused` | Print the unused clauses (Section 13). |
 | `--stats` | Print reasoning statistics as JSON to standard error: `inferences`, the goals started, which `--max-inferences` bounds; `rounds`, the forward rounds run over all strata; and `derived`, the facts forward rules added, not counting a conclusion the program states as a fact, a query's answers or `'false'`. |
 | `--max-depth N`, `--max-iterations N`, `--max-inferences N` | The bounds of Section 7.3; `N` MUST be a positive safe integer, at most 9007199254740991. |
-| `--version`, `--help` | Print the version, or the usage. |
+| `-v`, `--version` | Print the version. |
+| `-h`, `--help` | Print the usage, including every option and its short alias where one exists. |
 
 `--check-proof` MUST NOT be combined with `--proof`, nor `--unused` with
 either, and `--json` and `--strict-proof` need `--check-proof`. A program
@@ -867,7 +868,7 @@ conclusions and proof documents in the canonical text, and checks every proof
 it produces as Section 11 describes. A conforming **checker** implements
 Sections 9, 11 and 12 and does not depend on a reasoner. For the same
 program, a conforming reasoner and checker MUST produce the same
-conclusions, proof documents and reports as eyemind 0.1.23, byte for byte,
+conclusions, proof documents and reports as eyemind 0.1.24, byte for byte,
 except for the `Detail` texts of failures (Section 12), the internal names of
 variables where Section 3 says so, and where the host's floating-point
 library functions (`exp`, `log`, the trigonometric and hyperbolic functions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eyemind",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "A dependency-free JavaScript rule language with forward and backward reasoning and checkable proofs.",
   "type": "module",
   "main": "./src/index.js",

package/src/cli.js

@@ -7,19 +7,19 @@ import { VERSION } from './version.js';
 
 export const HELP = `Usage: eyemind [OPTION ...] [FILE ...]
 Programs are JavaScript; forward rules run to a fixpoint.
-  --proof             Print the claims with clause(...) and step(...) records
-  --check-proof FILE  Print a C1-C8 check report of a proof (- for stdin)
-  --json              Print the check report as JSON instead
-  --goal GOAL         Ask a backward goal after forward reasoning; with
-                      --check-proof, the goal the proof answers
-  --strict-proof      Reject proofs relying on absence or collection
-  --unused            List the clauses that make no difference to the conclusions
-  --stats             Print reasoning statistics to stderr
-  --max-depth N       Bound backward recursion (default 1000000)
-  --max-iterations N  Bound forward rounds per stratum (default 1000)
-  --max-inferences N  Bound reasoning work (default 1000000)
-  --version           Print the version
-  --help              Print this help
+  -p, --proof             Print the claims with clause(...) and step(...) records
+  -c, --check-proof FILE  Print a C1-C8 check report of a proof (- for stdin)
+      --json              Print the check report as JSON instead
+      --goal GOAL         Ask a backward goal after forward reasoning; with
+                          --check-proof, the goal the proof answers
+      --strict-proof      Reject proofs relying on absence or collection
+      --unused            List the clauses that make no difference to the conclusions
+      --stats             Print reasoning statistics to stderr
+      --max-depth N       Bound backward recursion (default 1000000)
+      --max-iterations N  Bound forward rounds per stratum (default 1000)
+      --max-inferences N  Bound reasoning work (default 1000000)
+  -v, --version           Print the version
+  -h, --help              Print this help
 Source defaults to stdin; multiple files form one program.
 Exit codes: 0 success, 1 error, 2 invalid proof, 65 contradiction.
 `;
@@ -66,11 +66,11 @@ export function main(argv, io) {
         asJson = true;
       } else if (arg === '--unused') {
         unused = true;
-      } else if (arg === '--check-proof' || arg === '--goal' || Object.hasOwn(LIMITS, arg)) {
+      } else if (arg === '--check-proof' || arg === '-c' || arg === '--goal' || Object.hasOwn(LIMITS, arg)) {
         i++;
         if (i >= argv.length) throw new UsageError(`${arg} needs a value`);
         const value = argv[i];
-        if (arg === '--check-proof') {
+        if (arg === '--check-proof' || arg === '-c') {
           proofFile = value;
         } else if (arg === '--goal') {
           goals.push(value);

package/src/version.js

@@ -1,2 +1,2 @@
 // The release this checkout is; ./release keeps it in step with package.json.
-export const VERSION = '0.1.23';
+export const VERSION = '0.1.24';