Mental Model

Hexi is a deterministic execution shell around non-deterministic models.

Run pipeline

1. Input task arrives.
2. Repo context is collected (git status, bounded git diff).
3. Model emits ActionPlan JSON.
4. Plan is validated.
5. Actions execute through ports/adapters under policy.
6. Review and done events are emitted.

Why this works

• Model creativity is constrained into a typed plan.
• Execution is bounded by policy and workspace guards.
• Event logs provide replayable operational evidence.

Failure model

• Invalid plan shape fails early.
• Disallowed command/path fails at execution boundary.
• Each failure emits structured error and terminal done events.