chore(main): release 0.2.21

[w7-mgfcode]

🤖 I have created a release beep boop

0.2.21 (2026-06-01)

Features

• api,db,ui: forecast champion selector slice B — async comparison & results (2168b61)
• api,db,ui: forecast champion selector slice C — forecast decision, business summary & promotion (#362) (0602a86)
• api,db: add forecast champion selector backend (#353) (6c3f8d4)
• api,db: add forecast champion selector backend (#353) (645047e)
• api,db: forecast champion selector slice B — async comparison & results (#360) (cf2cb47)
• api,db: forecast champion selector slice C — forecast decision & promotion (#362) (20e9689)
• ui: add forecast champion selector foundation (e7f4db7)
• ui: add forecast champion selector foundation (#356) (f1bb4ed)

Bug Fixes

• agents,ui: Ollama chat HITL — null-content, pending-approval salvage, and approval report (7cced50)
• agents: cast finalizer compact result to fix mypy index error (#355) (0d1c119)
• agents: compact tool data for finalizer to fix metric ranking (#351) (ae25be8)
• agents: constrain experiment read-only queries (79c33c0)
• agents: constrain read-only experiment queries (#347) (ba6da82)
• agents: non-streaming fallback for Ollama agent chat (de97ecd)
• agents: non-streaming fallback for ollama agent chat (#342) (535946c)
• agents: persist pending_action for gated tool calls (e896fc6)
• agents: persist pending_action for gated tool calls (#336) (d832b70)
• agents: preserve pending approval when ollama model misbehaves (#344) (cc72f89)
• agents: salvage experiment answer when weak model fails structured output (1b4c3f3)
• agents: salvage plain-text answer when structured output fails (#351) (57cc894)
• agents: sanitize null content for ollama chat requests (#344) (5fff334)
• agents: stop experiment read-only tool-call loop (082391d)
• agents: stop read-only tool-call loop in experiment guard (#349) (bcb80de)
• agents: validate scenario proposal entity ids (#347) (0e05ec2)
• api: add embedding-auth problem type and exception (#329) (65edb2f)
• api: honor feature_frame_version >= 3 in ops + registry (0c9c3a4)
• api: honor feature_frame_version >= 3 in ops + registry (#338) (5af7e26)
• api: showcase agent step runs on local Ollama (no API key needed) (ac1af1b)
• api: skip showcase knowledge phase on embedding auth failure (f44db5b)
• api: skip showcase knowledge phase on embedding auth failure (#329) (6fc5501)
• api: treat ollama agent provider as key-present in showcase (#340) (985ef8e)
• rag: classify embedding provider auth failures (#329) (1f93cf0)
• ui: avoid setState-in-effect in RunHistoryStrip to unblock lint (#357) (4d4c471)
• ui: avoid setState-in-effect in RunHistoryStrip to unblock lint (#357) (5a49fe3)
• ui: surface approved-action execution report for all outcomes (#346) (c4b532e)

Documentation

• add forecast champion selector backend PRP and research (#353) (b719184)
• add forecast champion selector slice A/B/C PRPs (#360) (45b7a70)
• docs: complete showcase dogfood screenshots (c47aa02)
• docs: complete showcase dogfood screenshots (#331) (ff6ebbf)
• docs: document showcase knowledge auth skip (#329) (582e62f)

---

This PR was generated with Release Please. See documentation.

Summary by Sourcery

Release version 0.2.21 with forecast champion selection capabilities and robustness improvements to agents, API behavior, and UI.

New Features:

• Introduce backend and UI support for a forecast champion selector, including async comparison, decision workflow, and promotion flows across API, database, and UI layers.

Bug Fixes:

• Improve Ollama-based agent chat reliability with null-content handling, non-streaming fallback, pending-approval preservation, and better experiment answer salvage.
• Tighten experiment tooling behavior by constraining read-only queries, preventing tool-call loops, and validating scenario proposal entity IDs.
• Refine API behavior around feature frame versioning, embedding auth failures, and local Ollama showcase flows, including better error classification and graceful knowledge-phase skipping.
• Resolve UI issues including lint-unfriendly state updates and ensure approved action execution reports are surfaced for all outcomes.

Build:

• Bump the package version to 0.2.21 in project metadata.

Documentation:

• Document the forecast champion selector design and research, update PRPs for its slices, and complete showcase documentation with updated screenshots and auth-skip behavior.

[coderabbitai]

Warning

Review limit reached

@w7-mgfcode, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 55 minutes and 39 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 44252d83-5cc5-4d63-af8f-a8f5f59eeb9f

📥 Commits

Reviewing files that changed from the base of the PR and between c839217 and 2712e49.

📒 Files selected for processing (3)

• .release-please-manifest.json
• CHANGELOG.md
• pyproject.toml

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release-please--branches--main--components--forecastlabai

---

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 and usage tips.}

[sourcery-ai]

Reviewer's Guide

Release-please cut version 0.2.21: bumps the Python package version and records all previously-merged feature, bugfix, and docs changes in the changelog; no functional code changes are introduced in this PR itself.

File-Level Changes

Change	Details	Files
Record the 0.2.21 release notes in the changelog based on merged commits.	Add 0.2.21 section with Features, Bug Fixes, and Documentation subsections. List forecast champion selector backend and UI work, agent/Ollama fixes, API/RAG robustness changes, and documentation updates with links to commits and issues.	CHANGELOG.md
Bump the library version metadata to 0.2.21 for packaging and release automation.	Update the project version number from 0.2.20 to 0.2.21 in the Python project configuration. Update the release-please manifest to reflect version 0.2.21 so future automated releases build on this tag.	pyproject.toml .release-please-manifest.json

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

Hey - I've found 1 issue

Prompt for AI Agents

Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="CHANGELOG.md" line_range="26" />
<code_context>
+* **agents:** non-streaming fallback for ollama agent chat ([#342](https://github.com/w7-mgfcode/ForecastLabAI/issues/342)) ([535946c](https://github.com/w7-mgfcode/ForecastLabAI/commit/535946c1deb338273256d186bd2419a3c5970224))
</code_context>
<issue_to_address>
**suggestion (typo):** Standardize capitalization of the product name "Ollama".

In this and similar entries (e.g., "preserve pending approval when ollama model misbehaves", "sanitize null content for ollama chat requests"), use "Ollama" with consistent capitalization to match its usage elsewhere in the changelog.

Suggested implementation:

```
* **agents:** non-streaming fallback for Ollama agent chat ([#342](https://github.com/w7-mgfcode/ForecastLabAI/issues/342)) ([535946c](https://github.com/w7-mgfcode/ForecastLabAI/commit/535946c1deb338273256d186bd2419a3c5970224))

```

```
* **agents:** preserve pending approval when Ollama model misbehaves ([#344](https://github.com/w7-mgfcode/ForecastLabAI/issues/344)) ([cc72f89](https://github.com/w7-mgfcode/ForecastLabAI/commit/cc72f89e1fbdf686964635bdb8eddc4810dae9e8))

```

```
* **agents:** sanitize null content for Ollama chat requests ([#344](https://github.com/w7-mgfcode/ForecastLabAI/issues/344)) ([5fff334](https://github.com/w7-mgfcode/ForecastLabAI/commit/5fff33421b1442b026e1cd34fe118f467ca001b8))

```
</issue_to_address>

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[sourcery-ai]

suggestion (typo): Standardize capitalization of the product name "Ollama".

In this and similar entries (e.g., "preserve pending approval when ollama model misbehaves", "sanitize null content for ollama chat requests"), use "Ollama" with consistent capitalization to match its usage elsewhere in the changelog.

Suggested implementation:

* **agents:** non-streaming fallback for Ollama agent chat ([#342](https://github.com/w7-mgfcode/ForecastLabAI/issues/342)) ([535946c](https://github.com/w7-mgfcode/ForecastLabAI/commit/535946c1deb338273256d186bd2419a3c5970224))

* **agents:** preserve pending approval when Ollama model misbehaves ([#344](https://github.com/w7-mgfcode/ForecastLabAI/issues/344)) ([cc72f89](https://github.com/w7-mgfcode/ForecastLabAI/commit/cc72f89e1fbdf686964635bdb8eddc4810dae9e8))

* **agents:** sanitize null content for Ollama chat requests ([#344](https://github.com/w7-mgfcode/ForecastLabAI/issues/344)) ([5fff334](https://github.com/w7-mgfcode/ForecastLabAI/commit/5fff33421b1442b026e1cd34fe118f467ca001b8))

[w7-mgfcode]

🤖 Created releases:

• v0.2.21

🌻