docs: add local testing instructions and new test coverage script

Author: dgarciasquare1

README.md

@@ -31,13 +31,31 @@ The setup script will:
 - Initialize Husky for git hooks (if present)
 - Add `.fvm/` to `.gitignore` if needed
 
+## Testing
+
+### Local Testing
+
+Run tests with coverage locally:
+
+```bash
+# Using the provided script (recommended)
+./scripts/test_with_coverage.sh
+
+# Or manually
+fvm flutter test --coverage
+lcov --summary coverage/lcov.info
+genhtml coverage/lcov.info -o coverage/html
+open coverage/html/index.html
+```
+
 ## Contributing
 
 Contributions are welcome! Please:
 
 - Follow the existing code style and patterns
 - Write clear commit messages (Commitlint and Husky are enabled)
 - Add or update tests for new features or bug fixes
+- Ensure all tests pass before submitting a pull request
 - Open a pull request with a clear description
 
 ## License

scripts/test_with_coverage.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Flutter Policy Engine - Test with Coverage Script
+# This script runs all tests and generates coverage reports
+
+set -e  # Exit on any error
+
+echo "🧪 Running Flutter tests with coverage..."
+
+# Run tests with coverage
+fvm flutter test --coverage
+
+echo "📊 Generating coverage summary..."
+lcov --summary coverage/lcov.info
+
+echo "🌐 Generating HTML coverage report..."
+genhtml coverage/lcov.info -o coverage/html
+
+echo "✅ Coverage report generated successfully!"
+echo "📁 HTML report available at: coverage/html/index.html"
+
+# Open the coverage report in browser (macOS)
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    echo "🔗 Opening coverage report in browser..."
+    open coverage/html/index.html
+else
+    echo "📖 To view the coverage report, open: coverage/html/index.html"
+fi
+
+echo "🎉 Test coverage process completed!"