Trust Agent Zero plugin 3.2 without breaking 3.1

[TerminallyLazy]

Summary

• bump the Tree Ring CLI patch version to 0.15.3
• trust the exact Agent Zero plugin 3.2.0 / CLI 0.15.3 / compatible minor 0.15 capability tuple
• retain the legacy Agent Zero plugin 3.1.0 / CLI 0.14.0 / compatible minor 0.14 tuple
• reject mixed or partially upgraded capability tuples
• update harness acceptance coverage and release references

Why

The Agent Zero plugin 3.2 package needs the current Tree Ring protocol, but CLI 0.15.2 still hard-pinned plugin 3.1.0. Publishing 3.2.0 first would make real preflight fail. This patch releases the CLI-side trust contract first while keeping installed 3.1.0 packages working.

Validation

• cargo fmt --all -- --check
• python3 scripts/validate-plugin-packages.py
• cargo test --workspace --locked
• installer shell syntax/help checks
• git diff --check

All passed locally.

High-level PR Summary

This PR bumps the Tree Ring CLI from version 0.15.2 to 0.15.3 and implements dual-version capability trust for the Agent Zero plugin. The changes allow the CLI to accept both the legacy plugin version 3.1.0 (with CLI 0.14.0 / minor 0.14) and the new plugin version 3.2.0 (with CLI 0.15.3 / minor 0.15) through a tuple-based validation approach. This ensures backward compatibility while enabling adoption of the newer plugin version without breaking existing 3.1.0 installations. The trust logic now validates against a list of approved capability contracts and rejects mixed or partially upgraded tuples, preventing version conflicts during the transition period.

⏱️ Estimated Review Time: 15-30 minutes

💡 Review Order Suggestion

Order	File Path
1	Cargo.toml
2	crates/tree-ring-memory-cli/Cargo.toml
3	crates/tree-ring-memory-sqlite/Cargo.toml
4	Cargo.lock
5	crates/tree-ring-memory-cli/src/activation/adapters.rs
6	crates/tree-ring-memory-cli/tests/harness_activation_acceptance.rs
7	README.md
8	docs/press-kit.md
9	marketing/README.md

Summary by CodeRabbit

• New Features

  • Added support for validating Agent Zero capability manifests against supported plugin and Tree Ring version combinations.
  • Added checks to detect mismatched plugin version declarations.

• Bug Fixes

  • Improved activation validation for enabled and disabled capability descriptors.

• Documentation

  • Updated release, installation, press kit, and marketing references from version 0.15.2 to 0.15.3.

[qodo-code-review]

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 1eb9e9c7-c031-489a-bb88-d25cd5fd4072

📥 Commits

Reviewing files that changed from the base of the PR and between 6ef385c and 7656ae0.

⛔ Files ignored due to path filters (1)

• Cargo.lock is excluded by !**/*.lock

📒 Files selected for processing (8)

• Cargo.toml
• README.md
• crates/tree-ring-memory-cli/Cargo.toml
• crates/tree-ring-memory-cli/src/activation/adapters.rs
• crates/tree-ring-memory-cli/tests/harness_activation_acceptance.rs
• crates/tree-ring-memory-sqlite/Cargo.toml
• docs/press-kit.md
• marketing/README.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The release version changed from 0.15.2 to 0.15.3 across package metadata, dependencies, documentation, and release links. Agent Zero validation now supports matching 3.1.0/0.14 and 3.2.0/0.15 contracts.

Changes

Release and Agent Zero compatibility

Layer / File(s)	Summary
Release version and dependency alignment Cargo.toml, crates/tree-ring-memory-cli/Cargo.toml, crates/tree-ring-memory-sqlite/Cargo.toml, README.md, docs/press-kit.md, marketing/README.md	Package metadata, crate dependencies, installer examples, and release links now reference version 0.15.3.
Agent Zero contract validation crates/tree-ring-memory-cli/src/activation/adapters.rs	Validation matches Agent Zero plugin and Tree Ring versions against supported contracts. Plugin YAML validation uses the capability document’s declared plugin version. Tests cover supported and mismatched combinations.
Activation acceptance fixture alignment crates/tree-ring-memory-cli/tests/harness_activation_acceptance.rs	Acceptance fixtures now use Agent Zero plugin 3.2.0 with Tree Ring 0.15.3 and 0.15 compatibility.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: ⚪ Minimal · up to 7656a

The change adds compatibility for Agent Zero plugin 3.2.0 while retaining the approved 3.1.0 contract; no actionable merge-blocking risk remains after normal checks and review.

Sequence Diagram(s)

sequenceDiagram
  participant CapabilityDescriptor
  participant CapabilityValidation
  participant SupportedContracts
  participant PluginYaml
  CapabilityDescriptor->>CapabilityValidation: provide declared plugin and Tree Ring versions
  CapabilityValidation->>SupportedContracts: match plugin and Tree Ring contract
  CapabilityValidation->>PluginYaml: validate against declared plugin version
  PluginYaml-->>CapabilityValidation: return version match result

Loading

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 37.50% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 8 functions across 2 files. (6 skipped: 6…	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: support Agent Zero plugin 3.2 while preserving compatibility with plugin 3.1.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

Docstring coverage is 37.50% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 8 functions across 2 files. (6 skipped: 6 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 2

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/agent-zero-plugin-v3.2-contract

Warning

Some tools did not complete. Review the errors below.

🔧 Clippy (1.97.1)

Clippy execution failed

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}