feat(plugin): derive Tiny Actor faces from agent visual.eye metadata (#1301)

[JeremyDev87]

Summary

• Load real visual.eye glyphs from agent JSON definitions (packages/rules/.ai-rules/agents/*.json) into Tiny Actor specialist cards
• Add _load_agent_eye() helper that resolves agent ID to JSON file and reads visual.eye field
• Primary and specialist cards now display per-agent Unicode eye glyphs instead of generic default ●
• Buddy moderator card unchanged — keeps hardcoded ◕ identity
• Graceful fallback to default glyph when agent file is missing, malformed, or lacks visual block

Test plan

• Known agent returns its real visual.eye glyph
• Unknown agent falls back to None (default glyph)
• Malformed agent JSON doesn't break rendering
• Missing visual block returns None
• Empty eye string returns None
• Buddy moderator still uses ◕‿◕ face
• Specialist cards contain real eye glyphs in rendered output
• All preset modes render successfully with real glyphs
• 668 pytest tests pass, 5893 vitest tests pass

Closes #1301

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
codingbuddy-landing	Ready	Preview, Comment	Apr 4, 2026 10:06am

[JeremyDev87]

Review: ✅ APPROVE

CI Status: ALL PASS

Code Quality:

• _load_agent_eye(): Clean JSON loader with safe fallback — reads .ai-rules/agents/<id>.json, extracts visual.eye
• Path resolution: _AGENTS_DIR computed relative to file location
• Integration: eye_glyph=_load_agent_eye(...) passed to both primary and specialist create_actor_card() calls
• Buddy unchanged: Moderator still uses hardcoded BUDDY_FACE
• Tests: 9 new tests — known agent, unknown agent, malformed JSON, missing visual block, empty eye, buddy moderator, specialist real glyph, all modes

Safety:

• All failures silently return None (generic fallback)
• No import changes to existing callers
• Feature flag still respected

✅ Tiny Actor cards now show real per-agent persona glyphs.