Qredence · Zochory · Oct 12, 2025 · Oct 12, 2025 · Oct 12, 2025 · Oct 12, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -92,24 +92,12 @@ jobs:
         run: uv sync --all-extras
 
       - name: Run configuration tests
-        run: uv run python tests/test_config.py
-        env:
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          AZURE_AI_PROJECT_ENDPOINT: ${{ secrets.AZURE_AI_PROJECT_ENDPOINT }}
-          AZURE_AI_SEARCH_ENDPOINT: ${{ secrets.AZURE_AI_SEARCH_ENDPOINT }}
-          AZURE_AI_SEARCH_KEY: ${{ secrets.AZURE_AI_SEARCH_KEY }}
-          AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME: ${{ secrets.AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME }}
-          AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME: ${{ secrets.AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME }}
+        if: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false }}
+        run: OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY }} AZURE_AI_PROJECT_ENDPOINT=${{ secrets.AZURE_AI_PROJECT_ENDPOINT }} AZURE_AI_SEARCH_ENDPOINT=${{ secrets.AZURE_AI_SEARCH_ENDPOINT }} AZURE_AI_SEARCH_KEY=${{ secrets.AZURE_AI_SEARCH_KEY }} AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME=${{ secrets.AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME }} AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME=${{ secrets.AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME }} uv run python tests/test_config.py
 
       - name: Run pytest with coverage
-        run: uv run pytest -v --tb=short --cov=src/agenticfleet --cov-report=xml --cov-report=term-missing
-        env:
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          AZURE_AI_PROJECT_ENDPOINT: ${{ secrets.AZURE_AI_PROJECT_ENDPOINT }}
-          AZURE_AI_SEARCH_ENDPOINT: ${{ secrets.AZURE_AI_SEARCH_ENDPOINT }}
-          AZURE_AI_SEARCH_KEY: ${{ secrets.AZURE_AI_SEARCH_KEY }}
-          AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME: ${{ secrets.AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME }}
-          AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME: ${{ secrets.AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME }}
+        if: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false }}
+        run: OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY }} AZURE_AI_PROJECT_ENDPOINT=${{ secrets.AZURE_AI_PROJECT_ENDPOINT }} AZURE_AI_SEARCH_ENDPOINT=${{ secrets.AZURE_AI_SEARCH_ENDPOINT }} AZURE_AI_SEARCH_KEY=${{ secrets.AZURE_AI_SEARCH_KEY }} AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME=${{ secrets.AZURE_OPENAI_CHAT_COMPLETION_DEPLOYED_MODEL_NAME }} AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME=${{ secrets.AZURE_OPENAI_EMBEDDING_DEPLOYED_MODEL_NAME }} uv run pytest -v --tb=short --cov=src/agenticfleet --cov-report=xml --cov-report=term-missing
 
   build:
     name: Build Package

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -68,10 +68,7 @@ jobs:
     name: Publish to TestPyPI
     needs: build
     runs-on: ubuntu-latest
-    if: github.event_name == 'workflow_dispatch'
-    environment:
-      name: testpypi
-      url: https://test.pypi.org/p/agentic-fleet
+    if: ${{ github.event_name == 'workflow_dispatch' }}
     permissions:
       id-token: write
 

diff --git a/.gitignore b/.gitignore
@@ -32,6 +32,7 @@ env/
 *.swp
 *.swo
 *~
+logs
 
 # Environment variables
 .env

diff --git a/README.md b/README.md
@@ -165,7 +165,7 @@ source .venv/bin/activate  # macOS/Linux
 .venv\Scripts\activate     # Windows
 ```
 
-**Using pip (not recommended):**
+#### Using pip (not recommended)
 
 See `docs/COMMANDS.md` for pip-based installation.
 
@@ -178,27 +178,27 @@ uv run pytest tests/test_config.py -v
 
 ### 5. Run the Application
 
-**Method 1: Console script (easiest)**
+#### Method 1: Console script (easiest)
 
 ```bash
 uv run agentic-fleet
 ```
 
-**Method 2: Module execution**
+#### Method 2: Module execution
 
 ```bash
 uv run python -m agenticfleet
 ```
 
-**Method 3: Direct REPL file (legacy)**
+#### Method 3: Direct REPL file (legacy)
 
 ```bash
 uv run python src/agenticfleet/cli/repl.py
 ```
 
 ### 5. Developer Workflow
 
-**Using Makefile (recommended):**
+#### Using Makefile (recommended)
 
 ```bash
 make help          # Show all available commands
@@ -435,4 +435,4 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ---
 
-**Built with ❤️ by Qredence**
+### Built with ❤️ by Qredence
diff --git a/docs/GITHUB_ACTIONS_SETUP.md b/docs/GITHUB_ACTIONS_SETUP.md
@@ -113,7 +113,7 @@ Go to **Settings → General**:
 
 Go to **Settings → Branches → Add rule** for `main` and `0.5.0a`:
 
-```
+```text
 Branch name pattern: main (or 0.5.0a)
 ☑ Require pull request before merging
   ☑ Require approvals: 1
@@ -132,7 +132,7 @@ Go to **Settings → Secrets and variables → Actions**:
 
 #### Required for Testing (Optional for Public Repos)
 
-```
+```text
 OPENAI_API_KEY
 AZURE_AI_PROJECT_ENDPOINT
 AZURE_AI_SEARCH_ENDPOINT

diff --git a/docs/WORKFLOWS_QUICK_REFERENCE.md b/docs/WORKFLOWS_QUICK_REFERENCE.md
@@ -2,7 +2,7 @@
 
 ## 📋 Workflows Overview
 
-```
+```text
 .github/
 ├── workflows/
 │   ├── ci.yml                      # Main CI pipeline
@@ -214,7 +214,7 @@ Add to README.md:
 
 ### Repository Secrets (Optional)
 
-```
+```text
 OPENAI_API_KEY
 AZURE_AI_PROJECT_ENDPOINT
 AZURE_AI_SEARCH_ENDPOINT
-Original file line number
+Diff line change
@@ Expand Up / @@ -32,6 +32,7 @@ env/ @@
     *.swp
     *.swo
     *~
+    logs
     # Environment variables
     .env
@@ Expand Down @@