Brain health | Living Brain

Every brain has three health scores, each from 0 to 100. They describe the state of the brain as a whole. Freshness says whether it’s being kept up to date, Readiness whether an agent can rely on it today, and Strain how much work is waiting on someone. Higher is better for Freshness and Readiness, and lower is better for Strain.

const score = await client.workspace.getScore({ brainId });
for (const metric of [score.freshness, score.readiness, score.strain]) {
  console.log(metric.label, metric.score, metric.status);
  for (const f of metric.factors) console.log("  ", f.label, f.value, f.unit);
}

Each metric comes with its factors, the inputs that produced it, so you can show a user why a score moved. scoreHistory returns the last 7, 30 or 90 days, and scoreSuggestions returns concrete next steps.

What moves each score

Score	What raises it	What lowers it
Freshness	Recent captures that finish compiling, and page changes	Time passing with nothing added. A brain people stop feeding goes stale even when every page is still correct
Readiness	More pages, searchable pages, a filled-in profile	Failed sources and unresolved contested pages
Strain (lower is better)	Failed sources, a compile backlog, contested and deprecated pages, changes and connections nobody has acknowledged	Retrying or removing failed sources, resolving contested pages, acknowledging the change feed

Recent activity counts for more than old activity, and the first few captures move a score the most. Filling in the profile can raise Readiness without adding a page.

What the scores don’t tell you

Health scores summarise activity and workload. They don’t measure whether the brain’s answers are correct. A brain can score 95 on Readiness and still be missing the one page a question needs. To see how well a brain answers questions, see Benchmarks.