Docs - Update Lambda and Api module docstrings and inline

[jomey]

This work mostly relates to experimenting with better docs and instructions when using the snowexsql with an LLM and only updates documentation or doc-strings.

Note that I also run the opened class through "Ruff" for consistent formatting.

[codecov]

Codecov Report

❌ Patch coverage is 62.25166% with 57 lines in your changes missing coverage. Please review.
✅ Project coverage is 59.42%. Comparing base (1bcb7e3) to head (86aa55b).

Files with missing lines	Patch %	Lines
snowexsql/lambda_handler.py	57.29%	41 Missing ⚠️
snowexsql/api.py	70.90%	16 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #217      +/-   ##
==========================================
- Coverage   59.52%   59.42%   -0.10%     
==========================================
  Files          23       23              
  Lines        1218     1215       -3     
==========================================
- Hits          725      722       -3     
  Misses        493      493              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.