Update README.md

README.md

@@ -1,489 +1,22 @@
-# VAMGUARD TITAN 🚀
-
-**Automated GitHub to HuggingFace Space Synchronization with AI Agent**
-
-VAMGUARD TITAN is a comprehensive system for managing, synchronizing, and automating file transfers between GitHub repositories and HuggingFace Spaces. It includes a Streamlit-based web interface with an integrated AI agent powered by Claude for intelligent file management and code assistance.
-
-## Features
-
-- 🤖 **AI Agent Interface**: Interactive Claude-powered assistant for code help and file management
-- 🔄 **Automated Sync**: Seamless synchronization between GitHub and HuggingFace Spaces
-- 📊 **File Auditing**: Complete file system auditing with JSON inventory and compressed archives
-- 📁 **File Management**: Web-based file browser, upload, and management interface
-- ⚙️ **Automation**: GitHub Actions workflows for scheduled syncing and deployment
-- 🗂️ **Mapping & Inventory**: Integration with mapping-and-inventory repository for backup and organization
-
-## Quick Start
-
-### Prerequisites
-
-- Python 3.11+
-- HuggingFace account with API token
-- Anthropic API key (for AI agent)
-- GitHub repository (for automation)
-
-### Installation
-
-1. **Clone the repository**
-   ```bash
-   git clone https://github.com/DJ-Goana-Coding/VAMGUARD_TITAN.git
-   cd VAMGUARD_TITAN
-   ```
-
-2. **Install dependencies**
-   ```bash
-   pip install -r requirements.txt
-   ```
-
-3. **Configure environment variables**
-   ```bash
-   cp .env.example .env
-   # Edit .env with your API keys and configuration
-   ```
-
-4. **Update configuration**
-   Edit `config.yaml` to match your spaces and preferences.
-
-### Running the Application
-
-#### Streamlit Web Interface
-
-```bash
-streamlit run app.py
-```
-
-The web interface provides:
-- Dashboard with space overview
-- AI agent chat interface
-- File management tools
-- Space synchronization controls
-- Audit and archive creation
-
-#### Command Line Automation
-
-```bash
-# Run file audit
-python automation.py audit
-
-# Sync all configured spaces
-python automation.py sync
-
-# Sync specific space
-python automation.py sync-space --space vamguard-titan
-
-# Backup to mapping-and-inventory
-python automation.py backup
-
-# Run full automation (audit + sync + backup)
-python automation.py full
-```
-
-## Configuration
-
-### Environment Variables (.env)
-
-```bash
-# HuggingFace Configuration
-HF_TOKEN=your_huggingface_token_here
-HF_USERNAME=your-username
-
-# Anthropic API (for AI agent)
-ANTHROPIC_API_KEY=your_anthropic_api_key_here
-
-# GitHub (optional)
-GITHUB_TOKEN=your_github_token_here
-
-# Agent Settings
-AGENT_MODEL=claude-sonnet-4-5-20250929
-MAX_TOKENS=4096
-```
-
-### Configuration File (config.yaml)
-
-```yaml
-spaces:
-  primary:
-    name: "vamguard-titan"
-    type: "streamlit"
-    auto_sync: true
-
-  mapping_inventory:
-    name: "mapping-and-inventory"
-    type: "streamlit"
-    auto_sync: true
-
-sync:
-  enabled: true
-  interval_minutes: 30
-  exclude_patterns:
-    - "*.pyc"
-    - "__pycache__"
-    - ".git"
-    - ".env"
-```
-
-## Architecture
-
-### Core Components
-
-1. **genesis_boiler.py**: File auditing and archive creation
-   - Scans directories and creates file inventories
-   - Generates compressed tar.gz archives
-   - Produces JSON metadata for all files
-
-2. **hf_space_sync.py**: HuggingFace Space synchronization
-   - Creates and manages HF Spaces
-   - Uploads files and directories
-   - Handles bulk synchronization
-
-3. **app.py**: Streamlit web interface
-   - Interactive dashboard
-   - AI agent chat interface
-   - File management UI
-   - Space sync controls
-
-4. **automation.py**: Automation and CLI tools
-   - Scheduled synchronization
-   - Batch operations
-   - Logging and reporting
-
-### GitHub Actions Workflows
-
-#### HuggingFace Space Sync (.github/workflows/hf_sync.yml)
-- Runs on push to main branches
-- Scheduled execution every 6 hours
-- Manual trigger with sync type selection
-- Uploads logs and archives as artifacts
-
-#### Deploy to HuggingFace Space (.github/workflows/deploy_spaces.yml)
-- Deploys to primary space on push to main
-- Automatically creates spaces if they don't exist
-- Deploys to mapping-and-inventory space
-
-## Usage Examples
-
-### Using the AI Agent
-
-The AI agent can help with:
-
-```
-User: "Help me organize these Python files by module"
-Agent: I'll analyze your Python files and suggest an organization structure...
-
-User: "Create a backup of all .py files"
-Agent: I'll use the genesis_boiler to create an archive of Python files...
-
-User: "Sync the latest changes to HuggingFace"
-Agent: I'll initiate a sync to your configured HuggingFace space...
-```
-
-### File Auditing
-
-```python
-from genesis_boiler import GenesisBoiler
-
-boiler = GenesisBoiler()
-results = boiler.run_full_audit()
-# Creates: inventory.json and genesis_archive_TIMESTAMP.tar.gz
-```
-
-### Space Synchronization
-
-```python
-from hf_space_sync import HFSpaceSync
-
-sync = HFSpaceSync()
-result = sync.sync_directory("vamguard-titan", ".")
-print(f"Uploaded {result['uploaded']} files")
-```
-
-### Automation
-
-```bash
-# Via cron (every 6 hours)
-0 */6 * * * cd /path/to/VAMGUARD_TITAN && python automation.py full
-
-# Via GitHub Actions (automatic on push)
-git push origin main  # Triggers deployment workflow
-```
-
-## GitHub Secrets Setup
-
-For GitHub Actions to work, configure these secrets in your repository:
-
-1. Go to Settings > Secrets and variables > Actions
-2. Add the following secrets:
-   - `HF_TOKEN`: Your HuggingFace API token
-   - `HF_USERNAME`: Your HuggingFace username
-   - `ANTHROPIC_API_KEY`: Your Anthropic API key (for AI agent)
-
-## File Structure
-
-```
-VAMGUARD_TITAN/
-├── .github/
-│   └── workflows/
-│       ├── hf_sync.yml          # Sync automation workflow
-│       └── deploy_spaces.yml    # Deployment workflow
-├── app.py                       # Streamlit web interface
-├── automation.py                # CLI automation script
-├── genesis_boiler.py            # File auditing and archiving
-├── hf_space_sync.py            # HuggingFace sync utilities
-├── config.yaml                  # Configuration file
-├── requirements.txt             # Python dependencies
-├── .env.example                 # Environment template
-└── README.md                    # This file
-```
-
-## Advanced Features
-
-### Custom Sync Filters
-
-Edit `config.yaml` to customize sync behavior:
-
-```yaml
-sync:
-  exclude_patterns:
-    - "*.log"
-    - "temp/*"
-    - "__pycache__"
-  include_extensions:
-    - ".py"
-    - ".md"
-    - ".yaml"
-```
-
-### Multi-Space Management
-
-Configure multiple spaces for different purposes:
-
-```yaml
-spaces:
-  production:
-    name: "vamguard-prod"
-    type: "streamlit"
-    auto_sync: true
-
-  development:
-    name: "vamguard-dev"
-    type: "streamlit"
-    auto_sync: false
-
-  archive:
-    name: "mapping-and-inventory"
-    type: "streamlit"
-    auto_sync: true
-```
-
-### Scheduled Backups
-
-The system automatically backs up to the mapping-and-inventory space, which serves as:
-- Central repository for all code
-- Historical archive of changes
-- Recovery point for accidentally deleted spaces
-
-## Troubleshooting
-
-### Common Issues
-
-**HuggingFace Token Error**
-- Ensure `HF_TOKEN` is set in `.env`
-- Verify token has write permissions
-- Check token hasn't expired
-
-**AI Agent Not Working**
-- Verify `ANTHROPIC_API_KEY` is set correctly
-- Check API key has sufficient credits
-- Ensure model name is correct
-
-**Sync Failures**
-- Check network connectivity
-- Verify space names match HuggingFace
-- Review exclude patterns in config
-
-### Logs and Debugging
-
-- Check `automation_log_YYYYMMDD.txt` for detailed logs
-- Review `automation_report_*.json` for sync results
-- Inspect `inventory.json` for file audit details
-
-## Contributing
-
-Contributions are welcome! Please:
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Submit a pull request
-
-## License
-
-This project is open source and available under the MIT License.
-
-## Support
-
-For issues, questions, or suggestions:
-- Open an issue on GitHub
-- Check the documentation in `config.yaml`
-- Review the automation logs
-
-## Roadmap
-
-- [ ] Multi-repository sync support
-- [ ] Web UI for configuration editing
-- [ ] Advanced AI agent capabilities
-- [ ] Real-time sync notifications
-- [ ] Space health monitoring
-- [ ] Automated testing integration
-
 ---
-
-**Built with:**
-- 🐍 Python
-- 🎈 Streamlit
-- 🤗 HuggingFace Hub
-- 🤖 Claude AI (Anthropic)
-- ⚡ GitHub Actions
-
-*Automate your way to organized code spaces!* 🚀
----
-title: TIA-ARCHITECT-CORE
-emoji: 🧠
-colorFrom: indigo
-colorTo: purple
+title: oppo-node
+emoji: 💻
+colorFrom: green
+colorTo: gray
 sdk: streamlit
 sdk_version: 1.42.0
+python_version: '3.13'
 app_file: app.py
 pinned: false
-license: mit
 ---
 
-# 🧠 TIA-ARCHITECT-CORE
-
-**The Intelligence Architect** — Central Reasoning Hub for Q.G.T.N.L. Citadel Mesh
-
-## Overview
+# 📱 OPPO-NODE
+Sovereign Interface for the Q.G.T.N.L. Citadel Mesh.
 
-TIA-ARCHITECT-CORE is a Sovereign AI Oracle & RAG System providing:
-
-- **RAG Intelligence** — Vector search & synthesis across Citadel documents
-- **Model Management** — Deploy & monitor AI models from the registry
-- **Worker Orchestration** — Coordinate automation workers across the mesh
-- **Knowledge Mesh** — Connect all Citadel nodes via persistent knowledge graphs
-
-## Features
-
-### 🏠 Dashboard
-System overview with real-time status, district topology mapping, and connection health.
-
-### 🤖 Models Registry
-Browse, download, and manage AI models including:
-- Gemma 4 (2B, 4B) — Multimodal, edge-ready
-- Qwen 3.5 (7B, 14B) — Multilingual code specialist
-- DeepSeek V4 — Reasoning & code expert
-- FinBERT, CryptoBERT — Financial sentiment models
-
-### ⚙️ Workers Constellation
-Automated task execution via:
-- Apps Script Toolbox — Google Sheets integration
-- Worker Watchdog — Monitor & restart workers
-- Self-Healing Worker — Auto-recovery system
-
-### 📚 Knowledge Base & RAG
-Retrieval-Augmented Generation with:
-- FAISS vector store
-- Sentence-transformers embeddings
-- District artifact knowledge base
-
-### 🔧 Tools & Utilities
-System diagnostics, configuration export, cache management.
-
-## Architecture
-
-```
-┌─────────────────────────────────────┐
-│      TIA-ARCHITECT-CORE (HF)       │
-│  Streamlit UI + RAG + Orchestration │
-└──────────────┬──────────────────────┘
-               │
-    ┌──────────┼──────────┐
-    ▼          ▼          ▼
-┌────────┐ ┌────────┐ ┌────────┐
-│ Models │ │Workers │ │  RAG   │
-│Registry│ │Constel.│ │ Store  │
-└────────┘ └────────┘ └────────┘
-```
-
-## District System
-
-| District | Domain |
-|----------|--------|
-| D01 | Core Infrastructure |
-| D02 | Data Processing |
-| D03 | Security & Authentication |
-| D04 | ML Models & Training |
-| D05 | API & Integration |
-| D06 | Random Futures Trading |
-
-## Double-N Rift
-
-- **GitHub:** DJ-Goana-Coding (single N)
-- **HuggingFace:** DJ-Goanna-Coding (double N)
-
-## Development
-
-```bash
-# Install dependencies
-pip install -r requirements.txt
-
-# Run locally
-streamlit run app.py
-```
-
-## Testing
-
-Comprehensive test suite with 150+ test cases and ~85% code coverage.
-
-```bash
-# Install test dependencies
-pip install -r requirements-test.txt
-
-# Run all tests
-pytest -v --cov=. --cov-report=term-missing
-
-# Run specific test file
-pytest tests/test_genesis_boiler.py -v
-
-# Generate HTML coverage report
-pytest --cov=. --cov-report=html
-```
-
-See [TESTING.md](TESTING.md) for detailed testing documentation.
-
-### Test Coverage
-
-- ✅ **genesis_boiler.py** - 95% coverage (25+ tests)
-- ✅ **worker_watchdog.py** - 90% coverage (30+ tests)
-- ✅ **self_healing_worker.py** - 90% coverage (35+ tests)
-- ✅ **apps_script_toolbox.py** - 85% coverage (20+ tests)
-- ✅ **download scripts** - 80% coverage (15+ tests)
-- ✅ **app.py** - 75% coverage (25+ tests)
-
-### CI/CD
-
-Tests run automatically on:
-- Push to main, develop, or claude/* branches
-- Pull requests to main
-- Supports Python 3.10, 3.11, 3.12, 3.13
-
-## Tech Stack
-
-- **SDK:** Streamlit ≥1.42.0
-- **Python:** 3.13 compatible
-- **Embeddings:** sentence-transformers (all-MiniLM-L6-v2)
-- **Vector Store:** FAISS
-- **LLM Tools:** llama-index, smolagents
-
----
+## 🏛️ SYSTEM ROLE
+This node serves as the **Mobile Telemetry Faceplate**. It is specifically aligned to visualize data shards harvested from the Oppo hardware environment and bridged to the **Librarian Vault**.
 
-*TIA-ARCHITECT-CORE v25.0.OMNI++ | Citadel Mesh Coordination System*
+## 🚀 ACTIVE PROTOCOLS
+- **Telemetry visualization**: Real-time display of district stability.
+- **RAG Integration**: Modular search across the 321GB Substrate.
+- **Alignment**: Standardized to 777.1122.