The Public Repository Paradox
Building software in a Public GitHub Repository provides unprecedented transparency, open-source auditability, and seamless zero-cost CI/CD via GitHub Actions. However, hosting a live SaaS operating system with user profiles, ephemeral share links, job queues, and automated 12-hour backups inside a public repository introduces a fundamental challenge:
How can an application store persistent operational state in git without public visitors ever being able to read user passwords, phone numbers, or private task artifacts?
Zero-Knowledge Envelope Encryption (AES-256-GCM)
THE SABBiR OS resolves this paradox using military-grade envelope encryption:
- PBKDF2-SHA256 Key Derivation: A private
VAULT_MASTER_SECRET(never committed to git) is stretched across 100,000 iterations to derive a high-entropy 256-bit symmetric encryption key. - Authenticated Ciphertext Generation: The complete runtime database snapshot (users, recovery hashes, jobs, shares, rates) is encrypted using AES-256-GCM with a random 12-byte initialization vector (IV) and a 16-byte authentication tag.
- Public-Safe File Persistence: The encrypted payload is serialized to disk at
data/vault/sabbir-os-state.vault.enc. Even if an attacker clones the entire repository, the file contains zero readable bytes. - Automated Tamper Detection: Any modification to a single byte of
.vault.enccauses the AES-GCM tag verification to fail immediately, preventing corrupted state restoration.
12-Hour Dual Automated Backup Engine
Every 12 hours (0 */12 * * *), an automated workflow executes:
- Snapshots platform state and computes a cryptographic SHA-256 integrity digest.
- Commits the encrypted
.vault.encsnapshot back to GitHub. - Dispatches the encrypted binary payload to an external Google Drive Apps Script Webhook, providing geographic redundancy across cloud providers.
The 30 Agentic Systems: Input-to-Action + Cloud Sync
Rather than static conversational models, THE SABBiR OS operates 30 Real-World Agentic Systems:
- Fleet A (15 Worker Agents): User-triggered task processors for batch image conversion, OCR ledger extraction, PII blackout, legal contract generation, and Dockerfile hardening.
- Fleet B (15 Scheduled Bots): Automated crons handling daily tech news harvesting, bank remittance rate sync, route health verification, and pre-commit secret leak protection.
Explore the active fleet at THE SABBiR OS Agents Studio and inspect live backups in SuperAdmin Console.