Stable Public Surface
OpenEmpiric v1.0.0 locks in the managed knowledge lifecycle that has been taking shape across the v0.99 line.
Projects now operate against a consistent five-step session model: start, read, search, reflect, and end. The CLI and MCP layers share the same result envelope, status vocabulary, and project resolution rules so agents and users see one coherent runtime instead of version-specific behavior.
Project Memory That Stays Attached
This release strengthens the contract between a session and its project.
Project initialization is manifest-driven, session-to-project binding is persisted, and project resolution is more defensive when sessions are restored or recovered. oem read also expands the first-user path with direct access to project, recent, skills, and health views without requiring users to reach for internal lifecycle commands.
Hardening And Recovery
v1.0.0 focuses heavily on reliability under real session churn.
Reflection handling is more resilient, session end is idempotent, staged events are deduplicated more carefully, and concept ID collision handling is stricter. The runtime also does a better job diagnosing and recovering from registry drift so memory state stays usable after interruptions or tool restarts.
Tooling Updates
OpenCode integration is more robust in this release, with setup and hook behavior tightened around the managed runtime.
OpenEmpiric also adds a Grok adapter path through oem setup grok and oem run grok, while removing older Vault and lint-era surfaces that no longer match the v1 architecture. The legacy knowledge_session_commit alias remains deprecated in favor of the stable lifecycle tool set.
Install
The recommended install path remains:
uv tool install "git+https://github.com/xpajonx/openempiric.git#subdirectory=packages/oem-knowledge[semantic]"Validation
The v1.0.0 release line was validated on the v0.99 branch state that becomes main for this release.
The package tree compiled cleanly:
uv run python -m compileall -q -f packages/The full test suite passed:
uv run pytest -qResult: 485 passed.