Test suite executed from CI pipeline (#433)

* Test strategy & test cases

* Unit tests

* Integration tests

TEST_SETUP.md

@@ -0,0 +1,96 @@
+# Quick Test Setup Guide
+
+## TL;DR - Just Run This
+
+```bash
+# From the trustgraph project root directory
+./run_tests.sh
+```
+
+This script will:
+1. Check current imports
+2. Install all required TrustGraph packages
+3. Install test dependencies
+4. Run the VertexAI tests
+
+## If You Get Import Errors
+
+The most common issue is that TrustGraph packages aren't installed. Here's how to fix it:
+
+### Step 1: Check What's Missing
+```bash
+./check_imports.py
+```
+
+### Step 2: Install TrustGraph Packages
+```bash
+./install_packages.sh
+```
+
+### Step 3: Verify Installation
+```bash
+./check_imports.py
+```
+
+### Step 4: Run Tests
+```bash
+pytest tests/unit/test_text_completion/test_vertexai_processor.py -v
+```
+
+## What the Scripts Do
+
+### `check_imports.py`
+- Tests all the imports needed for the tests
+- Shows exactly what's missing
+- Helps diagnose import issues
+
+### `install_packages.sh`
+- Installs trustgraph-base (required by others)
+- Installs trustgraph-cli
+- Installs trustgraph-vertexai
+- Installs trustgraph-flow
+- Uses `pip install -e .` for editable installs
+
+### `run_tests.sh`
+- Runs all the above steps in order
+- Installs test dependencies
+- Runs the VertexAI tests
+- Shows clear output at each step
+
+## Manual Installation (If Scripts Don't Work)
+
+```bash
+# Install packages in order (base first!)
+cd trustgraph-base && pip install -e . && cd ..
+cd trustgraph-cli && pip install -e . && cd ..
+cd trustgraph-vertexai && pip install -e . && cd ..
+cd trustgraph-flow && pip install -e . && cd ..
+
+# Install test dependencies
+cd tests && pip install -r requirements.txt && cd ..
+
+# Run tests
+pytest tests/unit/test_text_completion/test_vertexai_processor.py -v
+```
+
+## Common Issues
+
+1. **"No module named 'trustgraph'"** → Run `./install_packages.sh`
+2. **"No module named 'trustgraph.base'"** → Install trustgraph-base first
+3. **"No module named 'trustgraph.model.text_completion.vertexai'"** → Install trustgraph-vertexai
+4. **Scripts not executable** → Run `chmod +x *.sh`
+5. **Wrong directory** → Make sure you're in the project root (where README.md is)
+
+## Test Results
+
+When working correctly, you should see:
+- ✅ All imports successful
+- 139 test cases running
+- Tests passing (or failing for logical reasons, not import errors)
+
+## Getting Help
+
+If you're still having issues:
+1. Share the output of `./check_imports.py`
+2. Share the exact error message
+3. Confirm you're in the right directory: `/home/mark/work/trustgraph.ai/trustgraph`