This document serves as the absolute Source of Truth for Sanctuary OS, consolidating the high-level vision of the Republic with the deep-level technical architecture of the system. This master manifest restores all foundational sections regarding UI customization, creator management, and functional workflows.
 
I. The Hierarchy of the Republic

• The ecosystem is sustained through distinct roles, ensuring specialized oversight and collaborative growth:

  • Wayfinders (The Compass): Responsible for leadership and the overarching roadmap vision; responsible for maintaining the Nexus and the Sanctuary OS platform.

  • Architects (The Brain): The logic and security elite; responsible for verifying & maintaining meta data, protocol integrity and Lab verification.

  • Masons (The Hands): The builders; individuals who develop scripts, meshes, and packages.

  • Citizens (The Heart): The core of the ecosystem; the everyday players who curate Blueprints, field-test artifacts in the Citizen Lab, and breathe life into the network. 

 
II. Core Security and Sovereign Integrity

• The Sovereign Stance (Malware & Adult Content)

  • Adult Content: Permitted for local management and installation. However, all associated metadata and DNA signatures are strictly blocked from the Global Data Stream (upload/sync) to maintain network compliance and legal safety.

  • The Nuclear Override (Master Toggle): A one-time toggle allowing users to bypass malware locks. Engaging this toggle triggers a high-level system alert. Proceeding will permanently and irreversibly sever database communication for that account and hardware ID (PC), ensuring the global network remains uncontaminated while granting the user absolute local freedom.

• Security vs. Choice Balance

  • Logic Protocols

    • Highlander, Twins, Dependencies

  • FULL CONTROL (Toggleable)

    • Integrity Protocols

    • Merged Files, Unverified Content

  • WARNINGS (Bypassable)

  • Security Protocols

    • Malware

    • HARD LOCKOUT (No bypass)

 
III. Mod Installation and Data Architecture

• Lexicon Protocol (Word-as-a-Service)

  • Architecture: Static text is database-driven to facilitate "Persona Packs" (e.g., Lore-friendly vs. Vanilla terminology).

  • Resolution Logic: System priorities follow the hierarchy: User_Custom → Theme → Default (Standard English).

• Manual Download Assistant (Drop Zone)

  • Waiting Room Mode: For external mods requiring manual interaction, the OS opens the browser to the Mason's URL and enters a "Drop Zone" state.

  • Automated Processing: Upon file drop, the OS manages unzipping, vaulting, and automatic linking of Twins and Addons.

• Local Override Layer

  • Separation of Concerns: Global database protocols (UUIDs, hashes) are handled in the Architect Hub. The Mod Dossier is decoupled for local customization.

  • Deduplication Shield: The Radar Sweep utilizes uniqueMap logic. By checking DNA hashes during the scan, it merges identical Vault and Live files, preventing redundant folder structures.

 
IV. Dependency and Conflict Management

• Conflict Tier Logic (TGI Accuracy)

  • Tier 4 (Fatal Override): Detection via DBPF Index Reading identifies duplicate Instance IDs (Type, Group, Instance) to flag "Mortal Enemies" that would cause system instability.

  • DLC Awareness: Mod cards are ghosted (grayed-out) if requiredDLC is missing or masked via -disablepack: launch arguments.

 
V. Testing and Laboratory

• Virtual Injection (100% Nuke)

  • Scorched Earth: Enforces a 100% pure test environment. All existing symlinks are wiped, injecting ONLY the test subject and its mandatory requirements to ensure diagnostic accuracy.

  • Dual Injection: Allows for side-by-side comparison of "Mortal Enemies" in a clean-room sandbox to verify and log fatal conflicts.

 
VI. UI & Customization

•  The Chameleon Protocol

  • Provides engine-level RGB control over the UI environment, including variables for The Void (Background), Command Deck (Sidebar), Plasma (Accents), and Readout (Text Color).

• The "Dissolve" Button

  • A tactical delete utility featuring two distinct modes:

  • Uninstall: Ejects the mod from playsets while maintaining the file in the Vault.

  • Purge (Hard Nuke): Permanently deletes physical files and associated database records.

​