Skip to main content
A thesis is a living causal tree that evolves as signals arrive. SimpleFunctions wraps the lifecycle in a small set of verbs — each is a single CLI command and a single API endpoint.

​
Lifecycle

​
Walkthrough

1

Create

The server runs an LLM classifier that rejects shell-escape garbage and obvious junk, expands the thesis into a causal tree (root claim → drivers → markers → markets), and assigns an initial confidence. Returns the new thesis id.
2

Pull context

Returns the full causal tree, current confidence, related markets with edges, and any pending signals.
3

Inject a signal

Server appends the signal, schedules the next monitor cycle. Use inject_signal MCP tool to do the same from an LLM.
4

Evaluate

Triggers a deep evaluation (heavy model). Confidence delta and position recommendations come back in the response.
5

Augment

LLM proposes new tree nodes; you accept/reject. Append-only — old nodes never deleted.
6

Publish

Makes the thesis public at simplefunctions.dev/thesis/<slug>. Slugs are normalized hard (/[^a-z0-9\s-]/g strip, max 60 chars).

​
Heartbeat

Theses run on a heartbeat — the server periodically re-evaluates active theses and notifies you when confidence shifts or kill conditions trip. See Heartbeat.

​
Next steps

Thesis API

Every endpoint with payload shapes.

CLI command reference

Every sf thesis command.

Trade intents

Turn a thesis edge into a tradeable intent.

Concepts

Causal trees, edges, kill conditions.