docs(linux): explain persistent uinput permission failures

[SYMBaiEX]

Summary

• Update the Linux uinput doctor to distinguish a persistent owner/mode denial on an existing node from a transient access race during module or node startup. It uses the already-reported mode/UID/GID and states that retrying cannot repair restrictive permissions.
• Document node inspection and a reviewed systemd-tmpfiles z rule for an existing /dev/uinput node, including the input group access implications and how this differs from a udev rule applied when a node is created.
• All permission changes remain user-reviewed and user-run. This does not change the C helper or add retry behavior.

Source evidence

• Omarchy #8373 reports an existing root-owned mode-0600 /dev/uinput node and a tmpfiles z rule as a remedy.
• Asahi-map #6 describes a separate short startup race while access rules settle.
• systemd tmpfiles.d documentation documents the rule format and z behavior.

Acceptance scope

• Explain how current mode/owner information identifies persistent access restrictions and how those differ from startup timing.
• Include an optional tmpfiles rule for an existing node, with group/access implications alongside existing udev guidance.
• Keep all privileged commands as reviewable examples; OpenController does not write system files or run them.
• Add focused doctor output assertions.

Closes #59

Validation

• bun test packages/native-linux-uinput/src/__tests__/diagnostics.test.ts — 4 passed.
• bun --cwd packages/core build — passed.
• bun --cwd packages/native-linux-uinput typecheck — passed.
• bun --cwd packages/native-linux-uinput build — passed.
• bun run build — passed; 10 build tasks successful, 7 replayed from cache.
• bun run pack:check — passed for all seven publishable packages.
• biome check packages/native-linux-uinput/README.md packages/native-linux-uinput/src/diagnostics.ts packages/native-linux-uinput/src/__tests__/diagnostics.test.ts — passed.
• git diff --check — passed.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[coderabbitai]

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 10 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: 76c7d257-ceaa-40fc-b523-c62bf6ba1999

📥 Commits

Reviewing files that changed from the base of the PR and between f46c6fa and 3e924c7.

📒 Files selected for processing (3)

• packages/native-linux-uinput/README.md
• packages/native-linux-uinput/src/__tests__/diagnostics.test.ts
• packages/native-linux-uinput/src/diagnostics.ts

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}