Tesserae v0.22.1 — agents init explains a flat org

<!-- translations:start -->

한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end -->

Released 2026-07-21 · PyPI · GitHub release · pip install --upgrade tesserae==0.22.1

A small usability fix for the agent org tools shipped in v0.22.0.

tesserae agents init infers the org hierarchy from subagent roles — but a session store imported before v0.21.0 (when subagent-descriptor capture landed) carries none, so every agent collapses to its main :default key and the org comes out flat. In v0.22.0 that happened silently, so the result looked like the feature did nothing.

Now init says so, and tells you how to fix it:

Note: only main (:default) agents were observed, so the org is flat — no
subagent roles to build a hierarchy from.
If you use subagents, re-import to capture them, then re-run init:
  tesserae sessions discover --import && tesserae agents init --force

The "registry already exists" message now points at the same re-import path, since a stale registry is the other half of the same trap. Both are suppressed under --flat (an explicit choice) and when a real hierarchy is present.

No behavior change to the inference itself. pip install --upgrade tesserae==0.22.1 (or npm i -g @jokerized/tesserae@0.22.1).