Aria Hands

Aria Hands is the PSI Action Compiler + Manifold Executor + Ghazali Shard Council — an autonomous execution engine with zero LLM in the execution loop. It receives cognitive directives from Aria Soul and executes them deterministically.

Service: apps/aria-hands/ — gRPC server on port defined in hands.proto. Also runs an HTTP compat server.

Execution Pipeline


1. PsiSnapshot extracted from gRPC request
   (soul charge, coherence, mode amplitudes)
        │
2. Reflex Cache checked (<1ms pattern hash lookup)
   → Deterministic for repeated patterns
        │
3. Cognition Enrichment (optional)
   → LLM enrichment via Aria Soul /chat
        │
4. COMPILE: Intent extraction + Verb detection + 
   Constraint derivation + Mizan gate + Plan building
        │
5. ForgePsi Routing (for coding directives)
        │
6. Shard Council consultation
   (Aql wisdom, Muhasaba simulation)
        │
7. EXECUTE: Deterministic DAG execution
        │
8. RECORD + LEARN: Lawwama review (async, non-blocking)

Compiler Modules

Module	File	Function
Orchestrator	`compiler/index.ts`	compile(), shouldRouteToForgePsi()
Intent Extractor	`compiler/intent-extractor.ts`	Manifold-derived intent extraction
Verb Detector	`compiler/verb-detector.ts`	Action verb identification
Constraint Deriver	`compiler/constraint-deriver.ts`	Safety constraints from cognitive modes
Mizan Gate	`compiler/mizan-gate.ts`	Ethical validation gate
Plan Builder	`compiler/plan-builder.ts`	DAG plan construction

Manifold Executor

The Manifold Executor (executor/manifold-executor.ts) executes compiled plans as deterministic DAGs. It supports multiple execution planes:

openclaw-persistent (production) — Delegates to OpenClaw persistence service
Direct execution — Via the manifold executor itself
Bridge Actions — Can dispatch publish actions to Discord/Telegram bridges

Shard Council

Before execution, the Ghazali Shard Council (shards/shard-council.ts) validates actions through Aql (wisdom) and Muhasaba (simulation) shards.

Learning Systems

System	File	Function
Reflex Cache	`reflex/reflex-cache.ts`	Pattern hash lookup — <1ms for repeated patterns
Execution Recorder	`learning/execution-recorder.ts`	Lawwama review loop — continuous improvement
Novel Detector	`adaptive/novel-detector.ts`	Detects unprecedented situations, escalates to Soul

gRPC API

service HandsService {
  rpc Execute(ExecuteRequest) returns (ExecuteResponse);
  rpc CompilePlan(CompilePlanRequest) returns (CompilePlanResponse);
  rpc GetStatus(GetStatusRequest) returns (GetStatusResponse);
}

Kubernetes

Manifest: apps/aria-hands/k8s/aria-hands.yaml
Dockerfile: apps/aria-hands/Dockerfile
Proto: apps/aria-hands/proto/hands.proto