From 54be0761af0ad96fdb7796abfa1b5e55b7d3e227 Mon Sep 17 00:00:00 2001
From: Russell Ballestrini <russell@unturf.com>
Date: Sun, 30 Nov 2025 13:22:28 -0500
Subject: [PATCH] Move network debugging docs to separate gitignored file

Extract infrastructure/proxy debugging information from CLAUDE.md
into unturf-debugging.md to avoid exposing internal network details.

- Created unturf-debugging.md with full proxy chain documentation
- Added unturf-debugging.md to .gitignore
- Simplified CLAUDE.md to reference debugging doc
- Documented Caddy configuration (not nginx)
- Included troubleshooting steps for 502 errors

This keeps sensitive infrastructure details out of the public repo
while maintaining documentation for internal debugging.
---
 .gitignore | 1 +
 CLAUDE.md  | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/.gitignore b/.gitignore
index 140e368..f0533f1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,3 +10,4 @@ samconfig.toml
 vars.sh
 .coverage
 htmlcov/
+unturf-debugging.md
diff --git a/CLAUDE.md b/CLAUDE.md
index 513d87c..b5642de 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -35,6 +35,7 @@
 - Use `vars.sh` to set up environment variables
 - Required: MODEL_ENDPOINT_x and MODEL_API_KEY_x variables for AI models
 - Run with: `source vars.sh && python app.py`
+- **NEVER cat or grep vars.sh** - it contains API keys and secrets
 
 ### Makefile Commands
 - `make venv` - Create virtual environment and install dependencies
@@ -42,6 +43,12 @@
 - `make test` - Run all tests
 - `make dev-setup` - Install development dependencies
 
+### Network Infrastructure
+
+- OpenCompletion uses Caddy for web server (not nginx)
+- Multi-layer proxy architecture for accessing AI models
+- See `unturf-debugging.md` for network troubleshooting (gitignored)
+
 ## OpenCompletion Architecture
 
 ### Frontend Structure