workers/README.md

# 🛠️ APPS SCRIPT TOOLBOX

**Master Bridge Connection Center**
Links CITADEL workers to Google Sheets for automated inventory reporting

---

## 📡 OVERVIEW

The Apps Script Toolbox serves as the bridge between:
- **Local Workers** (citadel_reporter.py, citadel_archivist.py)
- **Google Sheets** (automated audit reports)
- **321GB Data Empire** (S10, Oppo, Laptop, GDrive)

---

## 🚀 QUICK START

### Prerequisites

Ensure the following secrets are configured:
- `GOOGLE_SHEETS_CREDENTIALS` - Service account JSON credentials
- `RCLONE_CONFIG_DATA` - Rclone configuration for GDrive access
- `HF_TOKEN` - HuggingFace API token

### Basic Commands

```bash
# Verify all connections are working
python workers/apps_script_toolbox.py --verify

# Generate Identity Strike Report (Section 44 Audit)
python workers/apps_script_toolbox.py --identity-strike

# Run full archive audit and push to Google Sheets
python workers/apps_script_toolbox.py --full-audit

# Update worker status dashboard
python workers/apps_script_toolbox.py --worker-status
```

---

## 📊 FEATURES

### 1. Identity Strike Report (`--identity-strike`)
Generates Section 44 audit report showing all files from connected systems.

### 2. Full Archive Audit (`--full-audit`)
Comprehensive archive processing with MD5 hash computation and Google Sheets export.

### 3. Worker Status Dashboard (`--worker-status`)
Updates Google Sheets dashboard with sync times, health status, and error logs.

### 4. Connection Verification (`--verify`)
Validates all connections: Google Sheets API, Rclone, HF token, worker files.

---

## ⚙️ Workers

### Worker Watchdog (`worker_watchdog.py`)
Continuous monitoring and auto-healing for scripts and workers.

```bash
# Run once
python workers/worker_watchdog.py --once

# Run continuous monitoring (every 5 minutes)
python workers/worker_watchdog.py --interval 300
```

### Self-Healing Worker (`self_healing_worker.py`)
Autonomous script repair system with syntax checking and auto-fix.

```bash
# Full heal (scan + repair)
python workers/self_healing_worker.py

# Scan only
python workers/self_healing_worker.py --no-repair
```

---

*TIA-ARCHITECT-CORE v25.0.OMNI++ | Citadel Mesh Coordination System*