Skip to content

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_tasks for tracking multi-item background pipelines.
  • InventoryTool: Direct database-backed structural queries that bypass SLM hallucinations.