Issues Index

Purpose

Track known issues, workarounds, and bug investigation notes for the ShadowHound system.

Prerequisites

• Understanding of affected subsystems
• Access to logs and diagnostic tools

Active Issues

vLLM & LLM Backends

• vLLM Mistral Tokenizer Hang — Inference hang issue with Mistral models
• Forcing Function Calling — Workaround for function calling reliability
• vLLM Tool Calling Configuration — Configuration requirements
• vLLM Tool Calling Not Executing — Debugging tool execution

System Issues

• Start Script Issues — Start script troubleshooting
• Thor System Utilities — Thor-specific system utilities
• Mock Mode ROS Topic Dependency — ROS topic dependencies in mock mode

Legacy Issues

• known_issues.md (legacy, needs review)
• multi_step_execution_issue.md (legacy, needs review)

Issue Workflow

Reporting New Issues

1. Check if issue already documented
2. Create new issue document with:
3. Symptoms and reproduction steps
4. Environment details (hardware, software versions)
5. Diagnostic output (logs, error messages)
6. Attempted workarounds

Resolving Issues

1. Document investigation steps
2. Update issue document with root cause
3. Link to fix/workaround in relevant docs
4. Consider moving to history/ if resolved

Validation

• [ ] Active issues have reproduction steps
• [ ] Workarounds documented and tested
• [ ] Resolved issues moved to history or marked complete

See Also

• Troubleshooting Documentation — Diagnostic procedures
• LLM Backend Validation — Backend health checks
• Development Documentation — Contribution guidelines
• Documentation Index — Complete documentation map

References

• Documentation Root
• GitHub Issues: https://github.com/danmartinez78/shadowhound/issues