tools: command records, Git group - NOTES as bullets, one exit line per cause, examples and prohibitions (#142)

Files changed:
- CHANGES.md
- VERSION
- tools/CONTRACT.md
- tools/README.md
- tools/chemenu/cli_contract.py
- tools/chemenu/commands/cite_cmd.py
- tools/chemenu/commands/dist_cmd.py
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/commands/doctor.py
- tools/chemenu/commands/eval_cmd.py
- tools/chemenu/commands/git_publish.py
- tools/chemenu/commands/index_build.py
- tools/chemenu/commands/instructions_cmd.py
- tools/chemenu/commands/links_cmd.py
- tools/chemenu/commands/lint.py
- tools/chemenu/commands/log_append.py
- tools/chemenu/commands/migrate_cmd.py
- tools/chemenu/commands/new_page.py
- tools/chemenu/commands/page_ops.py
- tools/chemenu/commands/provenance_cmd.py
- tools/chemenu/commands/raw_cmd.py
- tools/chemenu/commands/review_cmd.py
- tools/chemenu/commands/run_budget.py
- tools/chemenu/commands/search.py
- tools/chemenu/commands/task_cmd.py
- tools/chemenu/commands/touch.py
- tools/chemenu/commands/types_cmd.py
- tools/chemenu/commands/upload_cmd.py
- tools/chemenu/commands/upstream_cmd.py
- tools/chemenu/commands/version_cmd.py
- tools/chemenu/commands/work_cmd.py
- tools/chemenu/commands/xref.py
- tools/chemenu/tests/test_cli_contract.py
- tools/chemenu/tests/test_docs_verify.py

tools/chemenu/commands/raw_cmd.py

@@ -366,7 +366,7 @@ def _replace(
     failures=(
         cli_contract.Failure(
             label="raw accept",
-            exit_1="A file does not exist, is not under `incoming/`, or is nested more than "
+            cause="A file does not exist, is not under `incoming/`, or is nested more than "
             "one level below it, two files in one call share a filename, a target path already "
             "exists, `--fidelity`/`--authority` is missing (unless `--replaces`) or names "
             "`unknown` or a value outside the schema's enum, the target name is already "
@@ -374,7 +374,7 @@ def _replace(
             "an unknown page or one with no `raw_files:` yet, an existing `raw_files:` entry is "
             "missing on disk, a file to be moved has more than one owning page, or `--page` "
             "would overwrite an already-set `fidelity`/`authority` with a different value",
-            retry="Fix the named argument and retry once. Safe to retry as-is once the cause is "
+            reaction="Fix the named argument and retry once. Safe to retry as-is once the cause is "
             "fixed: a file already at its computed destination is what \"already exists\" "
             "reports, not a partial prior run to resume. A stem-occupied refusal is not fixed "
             "by retrying at all - it names `--replaces` and renaming in `incoming/` as the two "
@@ -383,12 +383,12 @@ def _replace(
         ),
         cli_contract.Failure(
             label="raw accept --replaces",
-            exit_1="More than one incoming file, `--page` also given, the incoming file does "
+            cause="More than one incoming file, `--page` also given, the incoming file does "
             "not exist or is not under `incoming/` (or is nested more than one level below "
             "it), its filename differs from the target's, the target does not lie under `raw/` "
             "or does not exist, `--fidelity`/`--authority` names `unknown` or a value outside "
             "the schema's enum, or the target has more than one owning source page",
-            retry="Fix the named argument and retry once. Every check runs before the "
+            reaction="Fix the named argument and retry once. Every check runs before the "
             "filesystem is touched, so a refusal leaves both files exactly as they were",
         ),
     ),