feat(detect): add muse agent with generic Pick blocked detection

[ohk]

Add Muse agent detection.

• manifests: src/detect/manifests/muse.toml + website/agent-detection/muse.toml (id muse v2026.08.06.1)
• runtime: src/detect/mod.rs Agent::Muse (ALL 22, SCREEN 20), lookup for muse/muse-bin/muse-code, label/executable, sound override (sidebar unchanged)
• fix waiting answer miss: Pick footer is generic 'Enter to select · ↑/↓ to move · Tab for an optional note · Esc to interrupt' – title/message can be anything. Previous rule required AND combos; now blocked pick is single generic gate 'Enter to select' (bottom_non_empty_lines(5), priority 950, visible_blocker) with working not Enter, so any Pick triggers blocked regardless of question text.

Evidence: herdr pane read --source detection (muse-spark-1.2-contributor 0.1.0) – idle YOLO/⟩, working esc to interrupt.

Replaces #2456 (closed by bot) with sidebar revert (6 files).

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 49c6f643-a631-49c0-9f2e-0db9d56a290f

📥 Commits

Reviewing files that changed from the base of the PR and between ef121fd and 4320fe1.

📒 Files selected for processing (3)

• src/detect/manifests/muse.toml
• src/detect/mod.rs
• website/agent-detection/muse.toml

🚧 Files skipped from review as they are similar to previous changes (3)

• website/agent-detection/muse.toml
• src/detect/manifests/muse.toml
• src/detect/mod.rs

---

📝 Walkthrough

Walkthrough

Adds Muse as a supported agent. The change defines Muse aliases and executable mappings, adds bundled and website detection manifests for terminal states, and adds Muse sound override configuration.

Changes

Muse detection integration

Layer / File(s)	Summary
Define the Muse agent src/detect/mod.rs	Adds Agent::Muse to agent collections, labels, executable mappings, aliases, and identification tests.
Add Muse detection rules src/detect/manifest.rs, src/detect/manifests/muse.toml, website/agent-detection/index.toml, website/agent-detection/muse.toml	Registers Muse manifests and defines rules for blocked approvals, active work, idle prompts, and idle YOLO status output.
Configure Muse sound overrides src/config/sound.rs	Adds Muse sound override storage, lookup handling, and default initialization.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant DetectionEngine
  participant MuseManifest
  participant TerminalPane
  DetectionEngine->>MuseManifest: evaluate Muse detection rules
  MuseManifest->>TerminalPane: inspect aliases and terminal evidence
  TerminalPane-->>MuseManifest: provide blocked, working, or idle evidence
  MuseManifest-->>DetectionEngine: return Muse state

Loading

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main changes: adding Muse detection and improving generic Pick blocked detection.
Description check	✅ Passed	The description directly explains the Muse detection support and the generic Pick blocked-detection update.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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

[kangal-bot]

Hi @ohk, thanks for your interest in contributing.

Herdr does not accept unsolicited implementation pull requests from contributors who are not listed in .github/APPROVED_CONTRIBUTORS.

The pull request author is not an approved contributor.

If you encountered a reproducible bug, report the observed behavior through the bug issue template. A report does not reserve the work or authorize a pull request; accepted fixes are normally implemented by Herdr’s maintainer-controlled agents.

Feature requests, behavior changes, and other proposals belong in GitHub Discussions. Do not open an issue merely to justify an implementation that was already written.

If a maintainer explicitly wants this implementation, they can reopen the pull request. Reopening by anyone else will be closed again automatically.

See https://github.com/herdrdev/herdr/blob/master/CONTRIBUTING.md for the contribution policy.

[coderabbitai]

Actionable comments posted: 3

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 79b2bc5b-5e09-4326-8058-6f7f02062b92

📥 Commits

Reviewing files that changed from the base of the PR and between 7d77e92 and 773b4b6.

📒 Files selected for processing (6)

• src/config/sound.rs
• src/detect/manifest.rs
• src/detect/manifests/muse.toml
• src/detect/mod.rs
• website/agent-detection/index.toml
• website/agent-detection/muse.toml

[greptile-apps]

Greptile Summary

Adds Muse as a recognized agent with bundled and remotely published screen-detection rules, executable aliases, and per-agent sound configuration.

• Registers Muse across the agent enum, labels, executable lookup, manifest loading, and catalog.
• Adds blocked, working, and idle screen rules based on Muse terminal chrome.
• Replaces broad Muse-prefix executable recognition with explicit aliases.

Confidence Score: 4/5

The PR does not appear safe to merge until Muse working detection stops being suppressed by stale picker text in the wider working-rule region.

The working rule still rejects esc to interrupt whenever Enter to select remains within its eight-line region, while the higher-priority blocked rule checks only five lines; text in the three-line gap therefore leaves a visibly working Muse pane misclassified.

Files Needing Attention: src/detect/manifests/muse.toml and website/agent-detection/muse.toml

Important Files Changed

Filename	Overview
src/detect/mod.rs	Registers Muse throughout agent identification and replaces broad prefix recognition with exact executable aliases.
src/detect/manifests/muse.toml	Defines Muse state-detection rules for picker prompts, approvals, active work, and idle chrome.
website/agent-detection/muse.toml	Publishes a synchronized copy of the new Muse detection manifest.
src/config/sound.rs	Adds a default-enabled Muse entry to per-agent sound overrides.
src/detect/manifest.rs	Includes the Muse manifest in the bundled manifest registry.
website/agent-detection/index.toml	Adds Muse to the remotely published agent-manifest catalog.

_{Reviews (2): Last reviewed commit: "fix(detect): tighten muse manifest and a..." | Re-trigger Greptile}