System architecture · 03

Persistent execution.
Explicit boundaries.

A local desktop shell, durable workflow engine and policy-governed adapter layer work together without turning the model into the database.

Inspect the systemView governance
01System layers

Execution moves through clear boundaries.

The application shell never talks directly to tools. Calls pass through a local gateway, durable runtime and governed capability adapter.

Desktop clientTauri v2 shell
Local APIHTTP and WebSocket gateway
Execution engineTemporal workflows + activities
Control planeRouting + governance + delivery
AdaptersMCP · OpenAPI · CLI · local plugins
Local memorySQLite append-only event log
02Event model

The current state is derived from evidence.

Instead of overwriting state, LibreTask records an append-only sequence of decisions and results. The thread can be replayed, explained and recovered.

task.created

Contract version one and the initial intent.

plan.generated

Task graph and candidate capabilities with explanations.

capability.invoked

Normalized request, idempotency key and data destination.

checkpoint.reached

The pending human decision and the path that continues after it.

deliverable.produced

An immutable package containing result, evidence and unresolved issues.

03Local API

The client controls tasks, not tools directly.

A compact local API exposes task actions and capability routing while keeping execution internals replaceable.

POST/tasks/{id}/delegateValidate the contract and start the execution thread.
PATCH/tasks/{id}/contractCreate a new contract version with an explicit reason.
POST/tasks/{id}/decisionResume a waiting workflow with a human decision.
GET/tasks/{id}/eventsStream the execution trail through paginated events or SSE.
GET/capabilities/matchReturn candidates and the reasons they passed or failed policy.
GET/tasks/{id}/deliverableRetrieve the immutable delivery package.
04Technology choices

Boring foundations for ambitious automation.

The MVP deliberately avoids custom durable state, premature cloud sync and unnecessary application weight.

DESKTOP

Tauri v2

Small packages, low memory use and native tray, shortcut and notification plugins.

INTERFACE

React / TypeScript

A web interface isolated from runtime concerns by an adapter boundary.

EXECUTION

Temporal

Durable workflows, replayable history and safe multi-day human waits.

CAPABILITIES

MCP first

Discovery and invocation through MCP, with OpenAPI and CLI adapters alongside it.

STORAGE

SQLite

Portable local events, contracts and projections with explicit exports.

SYNC

CRDT · later

Cross-device continuity follows a stable data model, not a rushed MVP dependency.

≠
The model is not the source of truth.

Contracts, policy, event history and delivery evidence live outside model context and remain inspectable.

NEXT · 04Enter the governance layer
DELIVERY PLANReview the roadmap