fix: resolve circular imports and update configuration for v0.0.3 (#107)

* fix: resolve circular imports and update documentation

- Fix critical circular import between session.py and session_service.py using lazy imports
- Convert all relative imports to absolute imports to resolve TID252 violations
- Update MyPy configuration with mypy_path="src" for pre-commit compatibility
- Update all documentation to use consistent `uv run --directory src mypy .` syntax
- Streamline test-coverage-analyzer agent description to focus on prescriptive guidance

This resolves all blocking issues for v0.0.3 release:
- Package imports successfully without circular dependency errors
- All ruff violations resolved (15 TID252 fixes)
- MyPy passes with zero errors from project root
- Pre-commit pipeline passes completely

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: update CHANGELOG for v0.0.3 release

- Add comprehensive changelog entry for v0.0.3
- Document circular import resolution and import architecture fixes
- Note MyPy configuration improvements and documentation consistency updates

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: jonpspri

.claude/agents/python-type-optimizer.md

@@ -168,7 +168,7 @@ uv run rg ".*: dict\[str, Any\]" src/databeak/ --type py -A 2 -B 1
 
 ```bash
 # Check current type issues
-uv run mypy src/databeak/ | grep -i "any"
+uv run --directory src mypy databeak/ | grep -i "any"
 ```
 
 ### Step 3: Create Central Type Definitions
@@ -345,7 +345,7 @@ class DataBeakErrorInfo(TypedDict):
 
 ```bash
 # Check type improvements don't break existing code
-uv run mypy src/databeak/ --strict
+uv run --directory src mypy databeak/ --strict
 
 # Ensure no new Any usage introduced
 uv run rg "Any" src/databeak/ --type py | wc -l
@@ -354,7 +354,7 @@ uv run rg "Any" src/databeak/ --type py | wc -l
 uv run pytest -n auto tests/ -v
 
 # Full quality check
-uv run ruff check src/ tests/ && uv run ruff format --check src/ tests/ && uv run mypy src/ && uv run pytest -n auto
+uv run ruff check src/ tests/ && uv run ruff format --check src/ tests/ && uv run --directory src mypy . && uv run pytest -n auto
 ```
 
 ### Analysis Commands
@@ -365,7 +365,7 @@ uv run rg ": Any" src/databeak/ --count-matches
 uv run rg "dict\[str, Any\]" src/databeak/ --count-matches
 
 # Check for new type issues
-uv run mypy src/databeak/ | grep -c "error:"
+uv run --directory src mypy databeak/ | grep -c "error:"
 ```
 
 ## Success Criteria

.claude/agents/quality-gate-runner.md

@@ -65,7 +65,7 @@ uv run ruff check src/ tests/
 uv run ruff format --check src/ tests/
 
 # 4. Type checking
-uv run mypy src/
+uv run --directory src mypy .
 
 # 5. MCP documentation compliance
 scripts/check_docstring_args.py         # Ensure no Args sections in MCP tools
@@ -149,7 +149,8 @@ mypy.....................................................................Failed
 
 **Use individual tools when:**
 
-- Debugging specific issues (e.g., `uv run mypy src/databeak/analytics.py`)
+- Debugging specific issues (e.g.,
+  `uv run --directory src mypy databeak/analytics.py`)
 - Testing fixes for specific tool failures
 - Need detailed output format (e.g., JSON for parsing)
 
@@ -267,7 +268,7 @@ uv run ruff check src/ tests/ --output-format=json
 uv run ruff format --check src/ tests/
 
 # Type checking (collect all MyPy errors)
-uv run mypy src/ --error-format=json
+uv run --directory src mypy . --error-format=json
 
 # Testing with coverage
 uv run pytest -n auto tests/ --cov=src --cov-report=json --cov-report=term-missing
@@ -355,7 +356,7 @@ uv run ruff check --fix --select I src/ tests/
 # For coverage gaps - suggest specific test scenarios
 
 # After fixes, re-run specific checks
-uv run mypy src/databeak/tools/analytics.py  # Target specific file
+uv run --directory src mypy databeak/tools/analytics.py  # Target specific file
 uv run pytest tests/test_io_operations.py -v  # Target specific test (single test, no parallel)
 ```