Docs
  • 0.4.1-alphalatest

What it holds

The record families an agent writes, and why memories and facts, and a checklist and a list of ticks, are kept apart.

The store is invisible

Agents speak only to the service. The service is the store's only user, its only reader and its only writer, so nothing about the query language, tenancy or indexes reaches an agent — an agent knows a set of verbs and nothing else.

The authenticated identity is the namespace. One identity's records live in a TessariDB namespace of their own, so isolation between tenants is a property of the credential rather than a filter somebody has to remember to apply.

The families

AreaWhat it holds
Agents and sessionswho an agent is across time, and one run of it — host, client, model, what it claims
Projectsthe registry, profiles and policies, as structured records rather than files
Goalsobjectives, and the evidence each criterion was validated against
Plans and wavesthe plan, the waves it is cut into, and steps that trace back to what asked for them
Tasksdecomposition, status, dependencies and claims
Checklistsa phase gate: which phase, which flow, whether it was written before the phase it guards
Questions, decisions, risks, ideasfour lifecycles, kept apart
Artifactsresearch, reports, snapshots, critiques and audits a flow produced
Memorieswhat an agent remembers, typed by how long it should live, with its vector when it brought one
Facts and ruleswhat the project has established, and what binds work here
Activitywhat happened, when, by whom, against which object
Answersa model's answers, kept against the question's vector for as long as the caller allowed

Memories and facts are split by who vouches

A memory is asserted by one agent from its own experience, needs no ceremony, and is allowed to be wrong. A fact is asserted by the project: it carries a closed topic, a provenance, and — when it claims to be confirmed — evidence. A memory that proves durable is promoted to a fact, so the expensive schema is paid once, later, only for what turned out to matter.

A fact may cite other facts, memories, decisions and documents. Withdrawing one of them marks every fact resting on it, through any chain of citations, in the same change.

A checklist is not a list of ticks

Its header is what makes it a gate: which phase it guards, which flow it belongs to, and whether it was written before that phase. Its counts are derived from its rows every time and never stored, because a stored count drifts from what it describes.

Claims are bounded

A claim on a task is a hold with an end. Nothing renews it silently, so a session that dies releases its work when the hold lapses instead of freezing the project. A session sends a heartbeat while it is thinking, because from outside a long pause looks exactly like a crash.