have/REQUIREMENTS.md

REQUIREMENTS

cli

ring id requirement 0 001 have must be a compiled single-file Zig CLI with no runtime dependencies beyond the OS/libc boundary needed for POSIX executable checks. 0 002 have must inspect command availability through PATH only; it must not mutate files, execute discovered commands, invoke a shell, inspect package managers, access the network, read hidden config, prompt, page, colorize, or emit JSON by default. 1 003 With no arguments, have must stream executable file names discovered in PATH, one per stdout line, de-duplicated by first executable PATH occurrence without collecting the full listing before writing records. 1 004 With NAME... arguments, have must print only available command names found through PATH, exit 0 when all requested names are available, and exit nonzero when any requested name is missing or not a command name. 1 005 have must not report shell builtins, aliases, shell functions, directories, non-executable files, or package installation state unless they also exist as executable files in PATH. 1 006 Usage-error and runtime diagnostics must go to stderr and never corrupt stdout records. 1 007 zig build test must prove PATH listing, executable-bit filtering, first-occurrence de-duplication, query output, missing-command failure, help stdout behavior, and that inspected commands are not executed. 1 008 have --help and have -h must print manual text to stdout and exit 0 without emitting stderr.