applies some best practice changes and tries to be more deliberate and precise (declaritive)

📋 Checklist

• I have read the Contributing Guidelines
• My PR title follows the conventional commit format: <type>(<scope>): <description>
• I have run pnpm nx format to ensure consistent code formatting
• I have added tests for new functionality (if applicable)
• I have updated documentation (if applicable)

📝 Additional notes

zizmor still has additional findings but this gets the low hanging fruit.