Skip to content
Marivo

Marivo 0.2.8

Marivo 0.2.8 is a v0.2 patch release for agent-facing analysis workflows. It adds a read-only marivo doctor diagnostic command, expands observe(...) to support multi-metric observations in one scope, records bounded observation digests in session knowledge, and tightens several observe planner edge cases.

Highlights

Section titled “Highlights”
  • marivo doctor now provides read-only environment, project, semantic, and datasource checks before an agent starts authoring or running analysis work. It can inspect semantic files and optionally verify datasource connectivity.
  • observe(...) now accepts a non-empty sequence of same-scope metrics for multi-metric observations. Marivo fuses compatible execution work, projects the requested metric columns, and records the observation as one evidence step.
  • Session knowledge now includes bounded observation digests for observe(...) and derive_metric_frame(...) commits. Agents can review what was observed without re-reading full frames.

Changed

Section titled “Changed”
  • marivo init installs bundled skills into the shared .agents/skills directory while keeping Claude Code and Codex compatibility targets.
  • Analysis intents now carry an explicit purpose through frames, lineage, and help output so evidence can explain why a result was produced.

Fixed

Section titled “Fixed”
  • Fanout-side where slices are now applied before merge-grain distinct planning, which keeps cross-dataset observe results aligned with authored filters.
  • Base observe queries prune unused projections before execution, reducing unnecessary selected columns.
  • Slice collection shorthand is normalized consistently before execution.
  • ClickHouse datasource authoring disables autogenerated SQLAlchemy sessions where they are not supported.

Documentation

Section titled “Documentation”
  • Added docs and examples for multi-metric observations, observation digests, marivo doctor, and the shared .agents/skills install target.
  • Added design specs for multi-metric observe and cumulative metrics.

Installation

Section titled “Installation”
Terminal window
pip install marivo

Install the backend extra for the datasource you plan to use:

Terminal window
pip install "marivo[duckdb]"
pip install "marivo[mysql]"
pip install "marivo[trino]"
pip install "marivo[postgres]"
pip install "marivo[clickhouse]"
pip install "marivo[all]"

Marivo 0.2.8 requires Python 3.12 or newer.

Documentation

Section titled “Documentation”