# ai-spel-rule-engine

The isolated Luau evaluation service for the AI-driven Swedish life simulator.
It receives bounded, versioned rule invocations over NATS and returns typed
effect proposals. It has no database or AI-provider integration; the game API
remains responsible for validating and committing effects.

## Contract

Requests use NATS subject `ai-spel.rules.evaluate.v1` and contract version 1.
The canonical JSON Schema is `contracts/rule-evaluation-v1.schema.json`.
Responses echo the correlation ID and have status `evaluated` or `rejected`.

The NATS user may subscribe only to the evaluation subject and publish only to
reply inboxes. The service receives no credentials other than its own NATS
identity and has no configured database or AI-provider secrets.

## Local commands

For source development, the Rust commands are `cargo fmt --all -- --check`,
`cargo test --workspace`, and `cargo clippy --workspace --all-targets -- -D warnings`.
Production builds, tests, image builds, and executable verification for this
project are run by Gitea Actions on the existing `large` runner and Kubernetes.