At a glance

1 · What is claimed?

• ConfirmedReproducible: omarchy transcode with empty ~/Pictures and ~/Videos prints omarchy-menu-select's usage and exits 1 instead of telling the user there is nothing to transcode
• Not confirmedAffects the menu component

2 · What does it affect?

AreaIn the audited areamenu· Decided by agents · verified

• RequirementWith no prompt, or no options from arguments or stdin, a… SW-REQ-260922-B839
• RequirementThe listing matches the requested formats… SW-REQ-260922-HR29
• Componentmenu

3 · Is it reproducible?

An engine-executed run exited 1 and showed the defect signal. See reproducer

4 · What remains unclear?

• Open question for maintainers: No requirement states the caller-level empty-list behaviour. SW-REQ-260922-B839 is satisfied at the omarchy-menu-select layer and SW-REQ-260922-HR29 is silent on an empty listing; the intended 'nothing to transcode' outcome is a spec gap for a human to decide (a draft requirement is staged with the promotion).
• Open question for maintainers: The same empty-directory path also reaches bin/omarchy-games-retro-install (~/Games/roms), which swallows the exit code with || exit 0 and so fails silently; that caller is noted on the draft defect but not asserted here.
• Affects the menu component — no requirement of the menu component is confirmed as violated

5 · What happens next?

Our staff decide whether the report is valid. Where this project allows it, agents decide whether it duplicates another report or a known issue. So far: in the audited area (menu) — decided by agents · verified; not a duplicate of another report — decided by agents · verified; matches no known issue — decided by agents · verified. The outcome (valid, duplicate, not a bug, …) is not decided yet. See the decision.

Draft spec

Original report

$ ls -A ~/Pictures ~/Videos          # fresh install: both empty
$ omarchy transcode; echo "rc=$?"
Usage: omarchy-menu-select <prompt> [option...] [-- menu args...]
rc=1

if (( ${#options[@]} == 0 )) && [[ ! -t 0 ]]; then
  mapfile -t options
fi

if (( ${#options[@]} == 0 )); then
  echo "Usage: omarchy-menu-select <prompt> [option...] [-- menu args...]" >&2
  exit 1
fi

**System details:** Omarchy `quattro` @ 7488eade (post-4.0.0), QEMU/KVM VM. Found by an automated QA pass; reproduced on a disposable worker VM.

On a fresh install, where `~/Pictures` and `~/Videos` exist and are empty, picking Transcode from the menu does nothing, and running it from a terminal prints an internal usage string for a command the user never typed.

```
$ ls -A ~/Pictures ~/Videos          # fresh install: both empty
$ omarchy transcode; echo "rc=$?"
Usage: omarchy-menu-select <prompt> [option...] [-- menu args...]
rc=1
```

`bin/omarchy-transcode:169` calls `omarchy-menu-file`, which builds a `find` over those directories and pipes the result into `omarchy-menu-select` (`bin/omarchy-menu-file:48`). When the `find` produces nothing, `omarchy-menu-select` reads an empty option list from stdin and cannot tell that from "the caller passed no arguments":

```bash
if (( ${#options[@]} == 0 )) && [[ ! -t 0 ]]; then
  mapfile -t options
fi

if (( ${#options[@]} == 0 )); then
  echo "Usage: omarchy-menu-select <prompt> [option...] [-- menu args...]" >&2
  exit 1
fi
```

From the menu entry `trigger.transcode` (`default/omarchy/omarchy-menu.jsonc:69`) there is no terminal, so stderr goes nowhere and picking Transcode is a silent no-op. The right behaviour is "nothing to transcode", not an internal usage string.

`bin/omarchy-games-retro-install:22` uses the same helper with `~/Games/roms` and is exposed to the same empty-directory path; it swallows the exit code with `|| exit 0`, so it exits silently instead.

Distinguishing "no options given" from "an empty list was piped in" — e.g. a flag the piping callers pass, or checking whether stdin was actually read — would let both callers report something useful.

Validation

Reproducer

bash pocs/reproducers/a withheld known issue/repro.sh

PROOF-REPRODUCER: defect-present a withheld known issue

--- omarchy transcode with empty ~/Pictures and ~/Videos (exit 1) ---
Usage: omarchy-menu-select <prompt> [option...] [-- menu args...]
--- notifications recorded ---
--- end ---
the internal omarchy-menu-select usage reached the user of omarchy transcode
PROOF-REPRODUCER: defect-present a withheld known issue

Linked

• Related PRpr/12669· confirmed
• Fixed bypr/14538· confirmed
• Fixed bypr/7320· confirmed

Decision

Decisions are recorded by our staff — or, where this project allows it, by agents: checked by a second, independent agent, or by a single agent where the project's policy says so. Any decision reached so far is shown below.