Delete CLAUDE.md

CLAUDE.md

@@ -1,192 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-**Chat UI Helper** is a Gradio-based configuration and deployment tool for creating custom AI chat interfaces on HuggingFace Spaces. It serves as middleware that helps educators and developers generate secure, configurable chat assistants with OpenRouter API integration and web scraping capabilities.
-
-## Key Commands
-
-### Development
-```bash
-# Install dependencies
-pip install -r requirements.txt
-
-# Run application locally (launches on default Gradio port)
-python app.py
-
-# Run faculty authentication tests
-pytest test_faculty_password.py -v
-
-# Run specific test class
-pytest test_faculty_password.py::TestFacultyPasswordAuthentication -v
-
-# Run with coverage report
-pytest test_faculty_password.py --cov=secure_config_editor --cov-report=html
-```
-
-### Virtual Environment
-```bash
-# Project uses Python 3.11
-source venv311/bin/activate  # or venv/bin/activate
-```
-
-## Architecture Overview
-
-### Three-Tab Interface Structure
-- **app.py** (1,942 lines): Main entry point with sophisticated three-tab Gradio interface
-  - **Configuration Tab**: Assistant creation, template selection, deployment package generation
-  - **Preview Tab**: Real-time testing sandbox with OpenRouter API integration
-  - **Support Tab**: Documentation, guides, and expert chat support
-
-### Key Components and Their Relationships
-- **secure_config_editor.py**: Faculty-only configuration editor with password protection
-- **support_docs.py**: Documentation module with accordion-style help and conversation export
-- **test_faculty_password.py**: Comprehensive test suite covering authentication, security scenarios, and edge cases
-- **simplified_ui_config.py**: User-friendly configuration components with reduced complexity
-- **ui_simplification_guide.md**: Implementation guide for less intimidating UI patterns
-
-### Template-Based Space Generation System
-The application generates complete, self-contained HuggingFace Space deployments via `SPACE_TEMPLATE` containing:
-- Customized `app.py` with modern Gradio 5.x ChatInterface
-- Runtime `config.json` with all user configurations
-- Complete `requirements.txt` with exact dependency versions
-- Built-in access control and URL grounding capabilities
-
-### Multi-Layer Security Architecture
-1. **Faculty Authentication**: `FACULTY_CONFIG_PASSWORD` environment variable controls configuration editing
-2. **Student Access Control**: Optional `SPACE_ACCESS_CODE` for general space access
-3. **Configuration Locking**: Exam-mode freeze prevents changes during assessments
-4. **Authentication State Management**: Session-based access control with proper validation
-
-## URL Grounding System Architecture
-
-### Two-Tier URL Processing
-- **Primary URLs (2)**: Highest priority sources (syllabus, main textbook) processed first
-- **Secondary URLs (8)**: Additional context sources for enhanced responses
-- **Dynamic URL Fetching**: Real-time content extraction from URLs mentioned in conversations
-- **Global Caching**: `url_content_cache` prevents re-crawling identical URL sets
-
-### Web Scraping Implementation Details
-- Uses `requests` + `beautifulsoup4` with enhanced headers for compatibility
-- Smart content cleaning: removes scripts, styles, navigation, forms
-- Preferential main content extraction (`<main>`, `<article>`, content divs)
-- Timeout handling (15s limit) with graceful error messages
-- Smart text truncation at sentence boundaries (4000 char limit)
-
-## Template System and Model Support
-
-### Built-in Assistant Templates
-- **Research Template**: Academic literature search and analysis with dynamic URL fetching enabled
-- **Socratic Template**: Pedagogical questioning approach for educational use
-- **Mathematics Template**: LaTeX-enabled mathematical education with step-by-step problem solving
-- **Custom Templates**: User-defined system prompts with flexible configuration
-
-### Template Development Pattern
-When adding new templates to the system:
-1. Add template choice to `template_selector` choices in the Configuration Tab
-2. Create template prompt variable in `toggle_template()` function (matching length/detail of existing templates)
-3. Add template prompt to the caching logic check (prevents accidental caching of template prompts)
-4. Add elif clause in `toggle_template()` with the template logic and appropriate dynamic URL setting
-5. Templates should be pedagogically focused and include specific formatting instructions when relevant
-
-### Supported OpenRouter Models
-```python
-MODELS = [
-    "google/gemini-2.0-flash-001",      # Fast, reliable, general tasks
-    "google/gemma-3-27b-it",            # High-performance open model  
-    "anthropic/claude-3.5-sonnet",      # Superior LaTeX rendering and mathematical reasoning
-    "anthropic/claude-3.5-haiku",       # Complex reasoning and analysis
-    "openai/gpt-4o-mini-search-preview", # Balanced with search capabilities
-    # ... additional models in app.py MODELS list
-]
-```
-
-## Important Configuration Details
-
-### Environment Variables for Generated Spaces
-- `OPENROUTER_API_KEY`: LLM API access (configurable variable name)
-- `FACULTY_CONFIG_PASSWORD`: Faculty configuration access
-- `SPACE_ACCESS_CODE`: Optional student access control
-- `CONFIG_EDIT_TOKEN`: Alternative token-based authentication
-
-### Generated Deployment Package Structure
-```
-ai_assistant_space.zip/
-├── app.py          # 684-line ChatInterface with access control
-├── config.json     # Complete runtime configuration backup
-└── requirements.txt # gradio>=5.38.0, requests>=2.32.3, beautifulsoup4>=4.12.3
-```
-
-### Configuration JSON Schema
-```json
-{
-  "name": "AI Assistant",
-  "system_prompt": "Behavioral instructions with grounding context",
-  "model": "google/gemini-2.0-flash-001",
-  "api_key_var": "OPENROUTER_API_KEY",
-  "temperature": 0.7,
-  "max_tokens": 750,
-  "examples": "['Example 1', 'Example 2']",
-  "grounding_urls": "[\"https://...\"]",
-  "enable_dynamic_urls": true,
-  "locked": false,
-  "last_modified_by": "faculty"
-}
-```
-
-## Testing and Quality Assurance
-
-### Faculty Authentication Test Coverage
-`test_faculty_password.py` includes:
-- **Password Validation**: Correct/incorrect credentials, case sensitivity, special characters
-- **Security Scenarios**: SQL injection attempts, brute force protection, environment manipulation
-- **Configuration Locking**: Lock behavior and access prevention
-- **Edge Cases**: Empty passwords, None values, whitespace handling
-- **Manual Testing Procedures**: UI flow verification and session management
-
-### Running the Full Test Suite
-```bash
-# Automated tests with verbose output
-pytest test_faculty_password.py -v
-
-# Generate test report with manual procedures
-python test_faculty_password.py
-
-# Coverage analysis
-pytest test_faculty_password.py --cov=secure_config_editor --cov-report=html
-```
-
-## UI Simplification System
-
-### User-Friendly Configuration Options
-The `simplified_ui_config.py` provides:
-- **Simplified Variable Names**: "MY_API_KEY" instead of "OPENROUTER_API_KEY"
-- **Progressive Disclosure**: Advanced options hidden by default
-- **Compact Layout**: Mobile-responsive design with minimal vertical space
-- **Template-First Approach**: Quick-start templates prominently displayed
-- **Friendly Labels**: "Assistant Instructions" instead of "System Prompt"
-
-### Implementation Pattern for UI Changes
-1. Create user-friendly components in `simplified_ui_config.py`
-2. Map friendly names to technical equivalents in `generate_zip()`
-3. Maintain backward compatibility with existing deployments
-4. Test across desktop, tablet, and mobile viewports
-
-## Critical Architecture Patterns
-
-### State Management Across Tabs
-- `sandbox_state` and `preview_config_state` enable cross-tab functionality
-- Configuration flows: Config Tab → Preview Tab → Deployment Package
-- Preview system uses real OpenRouter API calls for accurate testing
-
-### Error Handling and User Feedback
-- Comprehensive API error handling with user-friendly messages
-- Rate limiting and timeout management
-- Progressive enhancement: works without API key but shows limitations
-
-### Security-First Design
-- No API keys stored in generated code (environment variable approach)
-- Faculty authentication required for configuration changes
-- Configuration locking prevents unauthorized modifications during exams