Silo Grounding & Semantic Maps
Arkhein's silo grounding system provides persistent structural awareness through high-fidelity directory trees and ground-truth file lists. This system ensures that all operations are performed within well-defined boundaries.
Level 0: Grounding (EnvironmentScanner)
The foundation of Arkhein's awareness is Level 0. The EnvironmentScanner detects naming patterns, directory structures, and folder purposes to establish a Silo Semantic Map. This map allows the agent to navigate the filesystem with the context of a human developer.
Silo Semantic Maps
High-fidelity directory trees that provide hierarchical reasoning capabilities. These maps enable the system to quickly understand the structure and relationships between different folders and files without full-text indexing.
Silo Manifest
The ground-truth file lists provide 100% structural accuracy for each silo. This manifest is used to validate that all operations (reads, writes, searches) are performed within the correct boundaries.
Invariants
- Silo Guard: Strict path traversal protection via realpath normalization and boundary checks.
- Structural Accuracy: All reasoning must be grounded in the Silo Manifest before execution.
- Self-Healing Integrity: Autonomous drift detection and zero-downtime shadow rebuilds using disk signatures.
Operational Protocols
- Silo Guard: Ensures all file operations remain within user-authorized boundaries.
- HealSiloJob: Autonomous sync and drift detection for maintaining silo integrity.
- Task Registry: Persistent
system_tasksfor tracking multi-item background pipelines. - InventoryTool: Direct database-backed structural queries that bypass SLM hallucinations.