CodeSampleX

Sample

commander 15.0.0: Prevent negative number option parsing failures in Commander when registering digit short option flags

Verified sample for npm commander 15.0.0: Prevent negative number option parsing failures in Commander when registering digit short option flags. The…

sha256:e84a5f7f9b0e235218dd1ae017a1fdba5fdf2fce9c93b2143bdf8d153a9953fc

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment node linux x64 node node npm

Verification-run environments

Environment Contract Stages Run
node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-17
node 22 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-18

Case

HOW
Goal
Prevent negative number option parsing failures in Commander when registering digit short option flags
Packages
Symbols
  • Command.option
  • Command.parse
  • Option
Environment
node
Created
2026-08-17T01:48:52Z

Contract

  1. Passing -1 after an optional-argument option evaluates that option to boolean true and parses -1 as a distinct flag if any single-digit short option is defined on the command hierarchy, because Commander disables negative number heuristics whenever a digit flag exists.
  2. Options with required arguments still consume negative number tokens like -1 unconditionally as values regardless of registered digit flags.
  3. Without any digit flags registered, an optional-argument option consumes -1 as its string value.
  4. Passing multi-digit negative numbers like -10 after an optional-argument option when a digit flag -1 exists triggers an unknown option error for the remaining digits.
  5. Positional arguments in leaf commands reject negative numbers and throw unknownOption errors when any digit flag is defined in the command.

Files

  • NOTES.md
  • csx.json
  • package-lock.json
  • package.json
  • test/contract.mjs
  • test1.mjs
  • test2.mjs
  • test3.mjs
  • test4.mjs
  • test5.mjs
  • test6.mjs
  • test_clean.mjs
  • test_prototype.mjs

Download the source artifact (tar.gz)

Origin Seeder

csx-seed