[FEAT]: Dapr-Backed Blackboard State Store

[tilman-sattler]

This pull request significantly expands Flock's documentation to introduce and explain support for Dapr-backed state stores as a distributed blackboard backend. It updates example references, guides, and quick start instructions to reflect the new backend options, and provides a comprehensive new guide for Dapr integration. The changes also clarify the differences between in-memory, SQLite, and Dapr-backed storage, helping users choose the right persistence option for their needs.

Dapr State Store Integration Documentation:

• Added a detailed guide (dapr-state-store.md) covering installation, configuration, backend matrix, limitations, and example setups for using Dapr-backed state stores with Flock, including Redis and PostgreSQL options.
• Updated the guides index, getting started, and main documentation pages to highlight Dapr integration as an optional distributed persistence backend, including links to the new guide. [1] [2] [3] [4]

Examples and Quick Start Updates:

• Revised the examples index and quick start instructions to introduce new naming conventions, add Dapr-specific examples, and update code samples and commands to match the new folder structure and backend options. [1] [2] [3] [4] [5]

Blackboard Storage Guidance:

• Updated the blackboard guide to document support for in-memory, SQLite, and Dapr-backed stores, with new code snippets and links to backend-specific guides.
• Clarified the persistent blackboard guide to explain the choice between SQLite and Dapr for different deployment scenarios, and updated backend terminology. [1] [2]

Configuration Reference:

• Expanded the configuration reference to list all supported blackboard storage backends and direct users to the appropriate setup guides.

Additional Note:

(Partially) Relevant to #410

[codecov]

Codecov Report

❌ Patch coverage is 96.91558% with 19 lines in your changes missing coverage. Please review.
✅ Project coverage is 84.01%. Comparing base (6b9ef28) to head (ab15ff4).

Files with missing lines	Patch %	Lines
.../flock/storage/dapr/dapr_state_blackboard_store.py	96.64%	4 Missing and 14 partials ⚠️
src/flock/storage/dapr/_serialization.py	97.77%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #414      +/-   ##
==========================================
+ Coverage   83.27%   84.01%   +0.73%     
==========================================
  Files         153      157       +4     
  Lines       10552    11159     +607     
  Branches     1452     1536      +84     
==========================================
+ Hits         8787     9375     +588     
- Misses       1370     1374       +4     
- Partials      395      410      +15     

Flag	Coverage Δ
backend	84.01% <96.91%> (+0.73%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.