multica-collaboration

Multica 6-agent pipeline collaboration engine — the central coordinator that drives the PM→PMgr→Dev→Review→QA→Merge workflow.

Architecture

config/rules.yaml → Parser → Rule objects
                               ↓
Poller(HTTP API) → diff → Event → Rule Engine → Action Executor
    ↓                              ↓                  ↓
 SQLite snapshots            DSL evaluator      Multica API

• Adapter pattern: PollAdapter (now) → WebhookAdapter (when Multica outbound webhooks land)
• HTTP API native: calls Multica REST API directly — no subprocess CLI, no ANSI escape codes
• YAML DSL: per-workspace, per-project pipeline configuration

HTTP API Client

The collaboration.client module provides a fully-featured HTTP API client for Multica REST API:

from collaboration.client import MulticaClient

async with MulticaClient(
    base_url="https://api.multica.io",
    token="your-token",
) as client:
    issues, total = await client.list_issues(workspace_id="workspace-id")

Features:

• Bearer token authentication
• Retry logic with exponential backoff and jitter
• Type-safe Pydantic models
• YAML configuration support
• Engine and Actions modules for orchestration

Pipeline

Stage	Trigger	Gate	Action
dev	Vexel/Vulcan completed	—	→ Radian (review)
review	Radian completed	APPROVED / REJECTED	→ Verity (QA) or back to dev
qa	Verity completed	QA_PASSED / FAILED	→ Lynx (merge) or back to dev
merge	Lynx completed	—	merge + close

Quick Start

pip install -e .
python -m collaboration.main --rules config/rules.yaml --interval 30 --periodic-every 10

Development

For development and running tests, install with dev dependencies:

pip install -e ".[dev]"

This includes pytest, pytest-asyncio, and pytest-cov for testing async functionality.

License

Apache 2.0