THE LANGUAGE, AS A JOURNEY
RedRuffSolveGuide Make the statetell the story.
RedRuff Solve is built for real-time, stateful, rule-driven systems that need to decide what happens next—and explain why.
Model state · preserve truth · react to change · select the best valid outcome · explain everything
WHY SOLVE EXISTS
The hard part isn’t writing one function. It’s making everything agree.
Operational software usually stitches together a database, workers, cron, rules, connectors, workflows, queues, traces, and recovery. Solve makes the shared meaning between them native.

ONE MENTAL MODEL
RedRuff Solve
State + truth + change + choice + work + explanation01
MODEL THE STATE
Start with what the business remembers.
Entities hold durable business state. Structures shape temporary values. Queries read like the question you meant to ask.
Language lens
One domain. Three native views.
entity Product: sku: Text name: Text inventory: Int active: Bool = trueproduct = create Product: sku = "RR-104" name = "Edge Router" inventory = 12Persistent state is declared beside its meaning—not hidden behind an ORM.
02
PRESERVE TRUTH
Invalid state never gets a chance to become history.
Transactions make related changes succeed or fail together. Requirements protect one operation. Rules protect the whole domain.
Atomic truth
Try to oversell the last 12 units.
transaction: require product.inventory >= 3 product.inventory -= 3 save product save order03
REACT TO CHANGE
The outside world can interrupt. The story still continues.
Events cross the system boundary. Reactions express domain consequences. The supervised runtime records, retries, recovers, and traces the work.
Supervised runtime
Watch an order survive the boundary.
{ id: "ord-849", quantity: 3, region: "south" }- 01Recorded
Event stored durably
- 02Dispatched
Worker accepts the message
- 03Committed
Order state changes atomically
- 04Explained
Trace records what happened
Bounded queues · retries with limits · idempotency checks · dead-letter queues · startup recovery
Boundary input, durably handled.
State changes with consequences.
Time-based work that can catch up.
04
SELECT THE BEST VALID OUTCOME
Requirements remove the impossible. Goals find the best.
A problem filters invalid candidates, scores valid ones, and explains the winner. A decision returns a clear typed answer from evidence.
Live problem
Choose the best valid driver.
- Load
- 2
- Rating
- 4.9
- Capacity
- 30kg
- Load
- 1
- Rating
- 4.6
- Capacity
- 24kg
Best valid outcome
- Load
- 4
- Rating
- 5
- Capacity
- 45kg
- Load
- 0
- Rating
- 4.8
- Capacity
- 40kg
Filtered: wrong region
Neel wins with the strongest weighted score after hard requirements remove invalid candidates.
problem AssignDriver(order: Order) -> Driver: choose driver from Driver where status == "available" require driver.region == order.region require driver.capacity >= order.weight minimize driver.currentLoad weight 0.6 maximize driver.rating weight 0.4 explainProblems choose.
Decisions answer.
Plans coordinate.
05
COORDINATE THE WORK
Some steps run in milliseconds. Some wait for a person.
Plans keep both in one durable strategy—with dependencies, missing information, verification, and compensation when later work fails.
Durable plan
Onboard a vendor—even when work crosses people and time.
- 1
system
Verify documentsWaiting - 2
human
Compliance reviewWaiting - 3
system
Activate vendorWaiting - 4
system
Verify outcomeWaiting
06
EXPLAIN EVERYTHING
Every important outcome leaves a reason behind.
Reasoning traces connect inputs, reads, rules, candidate scores, plan steps, connector calls, missing information, and the final result.
Reasoning trace
Not just what happened. Why.
- INPUTorder.region = south · weight = 20kg
- READ4 available Driver records
- REQUIREKabir rejected · region mismatch
- SCOREAsha 75.2 · Neel 84.8 · Mira 52.0
- SELECTNeel · strongest valid weighted score
- VERIFYresult != none · passed
PRODUCTION, WITHOUT THE PRETEND
Lightweight by evidence. Honest by design.
Validated in the Solve Enterprise 7.1.0 Windows x86-64 release-gate environment. Your workload and hardware will differ.
parser characters / sec
SolveDB writes / sec
SolveDB reads / sec
startup p95
Production is a behavior
Bounded. Recoverable. Observable.
- Bounded queues and backpressure
- Retries, idempotency, and dead-letter queues
- Database backup, verification, recovery, and rollback
- Health, readiness, metrics, and trace verification
solve checksolve testsolve db migrate --previewsolve db backup --out Backups/todaysolve serve --profile productionsolve healthsolve trace verify
START SMALL. GROW INTO PRODUCTION.