feat(input): gate activities on connected input devices (#96) #99

Merged

albert merged 1 commit from u/albert/96/input-dependencies into main 2026-07-19 01:26:14 +00:00

Conversation 0 Commits 1 Files changed 19 +952 -8

albert commented 2026-07-19 00:43:23 +00:00

Owner

Copy link

Add requires_input to entries so an activity is only shown and launchable
while a required class of physical input device is connected — e.g. a typing
tutor on a gaming handheld that appears only once a keyboard is attached.

Supported types: mouse, touch, keyboard, gamepad (camera/mic and MIDI are
future work; the enum is closed so configuring one is a parse error).

• shepherd-api: InputDeviceType enum + ReasonCode::RequiredInputUnavailable.
• shepherd-config: requires_input on entries (scalar-or-list, mirrors
  input_compat); sorted/deduped into the validated Entry.
• shepherd-core: connected_inputs state + set_connected_inputs, and a gate
  in evaluate_entry.
• shepherdd: new input_devices::InputMonitor — evdev enumeration + hotplug via
  a notify watch on /dev/input, feeding the engine and re-broadcasting
  StateChanged. Only runs when some entry declares requires_input.
• launcher-ui: reason message + a tooltip naming the missing device(s).

This is a gating condition, distinct from the existing input_compat (a
spawn-time input-translation behaviour that shares the same vocabulary).

Fails open: before the first scan, and when /dev/input isn't readable (the
daemon's user isn't in the input group), gated activities stay visible and a
warning is logged rather than silently hiding content.

Docs in config.example.toml, docs/INSTALL.md, and
docs/ai/history/2026-07-18 001 input-dependencies.md.

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01CyP8KhzvqMpRyju5ZiPkLB

Fixes #96

Add `requires_input` to entries so an activity is only shown and launchable while a required class of physical input device is connected — e.g. a typing tutor on a gaming handheld that appears only once a keyboard is attached. Supported types: mouse, touch, keyboard, gamepad (camera/mic and MIDI are future work; the enum is closed so configuring one is a parse error). - shepherd-api: `InputDeviceType` enum + `ReasonCode::RequiredInputUnavailable`. - shepherd-config: `requires_input` on entries (scalar-or-list, mirrors input_compat); sorted/deduped into the validated `Entry`. - shepherd-core: `connected_inputs` state + `set_connected_inputs`, and a gate in `evaluate_entry`. - shepherdd: new `input_devices::InputMonitor` — evdev enumeration + hotplug via a notify watch on /dev/input, feeding the engine and re-broadcasting StateChanged. Only runs when some entry declares `requires_input`. - launcher-ui: reason message + a tooltip naming the missing device(s). This is a gating condition, distinct from the existing `input_compat` (a spawn-time input-translation behaviour that shares the same vocabulary). Fails open: before the first scan, and when /dev/input isn't readable (the daemon's user isn't in the `input` group), gated activities stay visible and a warning is logged rather than silently hiding content. Docs in config.example.toml, docs/INSTALL.md, and docs/ai/history/2026-07-18 001 input-dependencies.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CyP8KhzvqMpRyju5ZiPkLB Fixes #96

albert added 1 commit 2026-07-19 00:43:23 +00:00

feat(input): gate activities on connected input devices (#96) ... 78963585e6

Add `requires_input` to entries so an activity is only shown and launchable
while a required class of physical input device is connected — e.g. a typing
tutor on a gaming handheld that appears only once a keyboard is attached.

Supported types: mouse, touch, keyboard, gamepad (camera/mic and MIDI are
future work; the enum is closed so configuring one is a parse error).

- shepherd-api: `InputDeviceType` enum + `ReasonCode::RequiredInputUnavailable`.
- shepherd-config: `requires_input` on entries (scalar-or-list, mirrors
  input_compat); sorted/deduped into the validated `Entry`.
- shepherd-core: `connected_inputs` state + `set_connected_inputs`, and a gate
  in `evaluate_entry`.
- shepherdd: new `input_devices::InputMonitor` — evdev enumeration + hotplug via
  a notify watch on /dev/input, feeding the engine and re-broadcasting
  StateChanged. Only runs when some entry declares `requires_input`.
- launcher-ui: reason message + a tooltip naming the missing device(s).

This is a gating condition, distinct from the existing `input_compat` (a
spawn-time input-translation behaviour that shares the same vocabulary).

Fails open: before the first scan, and when /dev/input isn't readable (the
daemon's user isn't in the `input` group), gated activities stay visible and a
warning is logged rather than silently hiding content.

Docs in config.example.toml, docs/INSTALL.md, and
docs/ai/history/2026-07-18 001 input-dependencies.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CyP8KhzvqMpRyju5ZiPkLB

albert merged commit 80952ad166 into main 2026-07-19 01:26:14 +00:00

albert referenced this pull request from a commit 2026-07-19 01:26:17 +00:00

Merge pull request 'feat(input): gate activities on connected input devices (#96)' (#99) from u/albert/96/input-dependencies into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

bug

Something is not working

  

duplicate

This issue or pull request already exists

  

enhancement

New feature

  

future

  

help wanted

Need some help

  

invalid

Something is wrong

  

question

More information is needed

  

wontfix

This won't be fixed

No labels

bug

duplicate

enhancement

future

help wanted

invalid

question

wontfix

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

albert/shepherd-launcher!99

No description provided.