Fix stale comments to match current code

Audited comments project-wide against the current implementation:

- scripts/install.sh, scripts/uninstall.sh: header curl URLs pointed at a
  root-level install.sh/uninstall.sh, but the files live under scripts/ —
  the documented command 404'd. Corrected to the scripts/ path (matching
  the README and the actual file location).
- src/move.ts: header said it ties "four logic modules" and omitted
  editor.ts; the --edit terminal action was also missing from the order of
  operations. Both corrected.
- src/config.ts: numeric Config fields are all milliseconds now; dropped the
  stale "pixels" unit left over from stepCount/stepSize.

Comments-only (plus two script header lines); tsc clean, 64 tests pass.
This commit is contained in:
2026-08-14 13:39:15 -05:00
parent 41903ebaf1
commit c002a6d902
4 changed files with 12 additions and 8 deletions
+1 -1
View File
@@ -4,7 +4,7 @@
# #
# Curl-pipe ready: # Curl-pipe ready:
# #
# curl -fsSL https://gitea.cahlen.com/nokeo08/Move/raw/branch/master/install.sh | sh # curl -fsSL https://gitea.cahlen.com/nokeo08/Move/raw/branch/master/scripts/install.sh | sh
# #
# What it does: # What it does:
# 1. Detect platform; bail on anything @nut-tree-fork/nut-js doesn't ship. # 1. Detect platform; bail on anything @nut-tree-fork/nut-js doesn't ship.
+1 -1
View File
@@ -4,7 +4,7 @@
# #
# Curl-pipe ready: # Curl-pipe ready:
# #
# curl -fsSL https://gitea.cahlen.com/nokeo08/Move/raw/branch/master/uninstall.sh | sh # curl -fsSL https://gitea.cahlen.com/nokeo08/Move/raw/branch/master/scripts/uninstall.sh | sh
# #
# Removes the `move` wrapper from $XDG_BIN_HOME and the install tree from # Removes the `move` wrapper from $XDG_BIN_HOME and the install tree from
# $XDG_DATA_HOME/move. Does NOT remove Bun — that's your runtime, not ours. # $XDG_DATA_HOME/move. Does NOT remove Bun — that's your runtime, not ours.
+1 -1
View File
@@ -10,7 +10,7 @@
* `resolveConfig` rather than mutating the defaults, so the defaults stay * `resolveConfig` rather than mutating the defaults, so the defaults stay
* genuinely constant and the resolved config stays structurally typed. * genuinely constant and the resolved config stays structurally typed.
* *
* All numeric `Config` fields are in their internal units (ms, pixels). * All numeric `Config` fields are in their internal units (milliseconds).
* The CLI and config file expose the time-valued fields in seconds for * The CLI and config file expose the time-valued fields in seconds for
* ergonomics; `resolveConfig` performs the seconds->ms conversion at the * ergonomics; `resolveConfig` performs the seconds->ms conversion at the
* boundary so downstream code never has to think about it. * boundary so downstream code never has to think about it.
+9 -5
View File
@@ -4,23 +4,27 @@
* ------- * -------
* Entry point for the `move` CLI. * Entry point for the `move` CLI.
* *
* Thin shim that ties the four logic modules together: * Thin shim that ties the logic modules together:
* - `cli.ts` parses and validates `process.argv`. * - `cli.ts` parses and validates `process.argv`.
* - `configFile.ts` loads and validates the JSON config file. * - `configFile.ts` loads and validates the JSON config file.
* - `config.ts` holds defaults and the layered `resolveConfig` overlay. * - `config.ts` holds defaults and the layered `resolveConfig` overlay.
* - `keeper.ts` owns the synthetic-activity sweep and idle-watch loop. * - `editor.ts` backs `--edit` (open the config file in `$EDITOR`).
* - `keeper.ts` owns the idle-watch loop and drives the movement
* machinery (device / strategy / executor).
* *
* Order of operations: * Order of operations:
* 1. Parse CLI args. Bad input -> stderr + usage hint, exit 2. * 1. Parse CLI args. Bad input -> stderr + usage hint, exit 2.
* 2. `--help` / `--version` short-circuit before any I/O, config load, or * 2. `--help` / `--version` short-circuit before any I/O, config load, or
* mouse work. `keeper.ts` is also lazy-imported (see below) so these * mouse work. `keeper.ts` is also lazy-imported (see below) so these
* flags don't pay the cost of loading the nut.js native binary. * flags don't pay the cost of loading the nut.js native binary.
* 3. Load + validate the config file (default XDG path, or `--config * 3. `--edit` opens the resolved config file in `$EDITOR` and is a
* terminal action (propagates the editor's exit code).
* 4. Load + validate the config file (default XDG path, or `--config
* <path>` if supplied). Validation failures share the exit-2 path. * <path>` if supplied). Validation failures share the exit-2 path.
* 4. Resolve the full `Config` (CLI > file > DEFAULT_CONFIG) — verbose * 5. Resolve the full `Config` (CLI > file > DEFAULT_CONFIG) — verbose
* lives inside `Config` and is layered with the same precedence as * lives inside `Config` and is layered with the same precedence as
* the numeric fields. * the numeric fields.
* 5. Lazy-import `keeper.ts` (dynamic import keeps nut.js out of the * 6. Lazy-import `keeper.ts` (dynamic import keeps nut.js out of the
* `--help` / `--version` startup path) and run it. Any unhandled * `--help` / `--version` startup path) and run it. Any unhandled
* rejection — from the import itself or from the loop — exits 1. * rejection — from the import itself or from the loop — exits 1.
* *