feat: Coven familiars as dynamic agents + familiars docs section#2
Merged
Conversation
- agents_view: import coven_shared; add familiar_as_agent_def() builder
that converts CovenFamiliar → AgentDefinition with source tag
'coven:familiar:<id>', synthesised persona prompt, workspace memory scope
- load_agent_definitions(): append Coven daemon familiars after user agents;
user definitions with the same display name take precedence (shadow check)
- TUI agents list: split into 'Workspace Agents' and '✨ Coven Familiars'
sections with violet accent for the familiars section header
- render_agent_detail(): familiar-sourced entries show 'Persona' instead of
'Prompt', violet badge 'Coven Familiar · <id>', persona-preview truncation
- named_commands: agents list shows grouped output with ★ bullets for
familiars, switch hint, familiar count
- named_commands: new 'agents familiars' subcommand lists only familiar-
sourced agents
- named_commands: new AgentCommand ('coven-code agent <name>') resolves by
display name or familiar id, shows persona preview + --agent invocation
hint; --list flag enumerates all with ✨/• badges
- docs/familiars.md: new dedicated section covering familiar detection,
familiars.toml format, TUI/CLI usage, workspace agent overrides, glyphs
- docs/agents.md: cross-link callout to familiars page at top
- docs/index.md: Coven ecosystem integration section + familiars nav entry
All 47 command tests pass; 553 TUI tests pass (5 pre-existing failures
unrelated to this change).
be402e9 to
619a632
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Familiars from the Coven daemon are now surfaced as first-class agent personas inside Coven Code — automatically, with no extra config.
What changed
Core bridge (agents_view.rs)
familiar_as_agent_def()— convertsCovenFamiliar→AgentDefinitionwith source tagcoven:familiar:<id>, synthesised persona system prompt, and workspace memory scopeload_agent_definitions()now appends Coven daemon familiars after user workspace agents; user definitions with the same display name take precedenceTUI (agents overlay)
CLI commands (named_commands.rs)
agents list: grouped output with star bullets for familiars, count, switch hintagents familiars: new subcommand — list only familiar-sourced agentsagent <name>(new command): resolve by display name or familiar id, show persona preview +--agentinvocation hint;--listflag enumerates allDocs
docs/familiars.md: new dedicated section covering familiar detection,familiars.tomlformat, TUI/CLI usage, workspace agent overrides, standalone mode fallback, glyph referencedocs/agents.md: cross-link callout at topdocs/index.md: Coven ecosystem integration section + familiars nav linkTests
All 47 command tests pass; 553 TUI tests pass. 5 pre-existing failures are unrelated to this change.