CHANGELOG

v3.0.0a1 (2026-05-01)

Canonical Event Runtime (purpose_agent/runtime/)
- PAEvent frozen dataclass with 30 event kinds
- EventBus async pub/sub with backpressure, replay, lane isolation
- Visibility levels (public/internal/debug) — no raw CoT leaks
- streaming_v3.py AG-UI compatible stream adapters
Durable Execution (runtime/checkpoint.py, runtime/state.py)
- RunState with node tracking, idempotency keys, serialization
- Checkpointer protocol + InMemory/JSONL/SQLite implementations
- Resume from crash, HITL pause/resume
Memory Homeostasis (memory_homeostasis.py)
- MemoryBudget hard limits (active cards, injected tokens, per-kind caps)
- MemoryArchive append-only cold storage
- ConsolidationEngine (cluster → merge → compress → hibernate)
- QFunctionRetriever multi-signal ranking under token budget

Protocol Stack (purpose_agent/protocols/)
- MCPToolBridge — MCP server registration, tool wrapping, security policy
- A2AClient + AgentCard — agent-to-agent delegation with circuit breaker
- AGUIAdapter — PAEvent → AG-UI frontend streaming
- parse_agents_md() — repo-local instruction parser with precedence
Quorum Coordinator (quorum.py)
- Agreement → merge, disagreement → escalate, critical risk → HITL
- CriticEnsemble (correctness/safety/efficiency/alignment)

LLM Call Router (routing.py)
- TaskComplexityClassifier (simple/moderate/complex/critical)
- ModelSelector local-first, smallest-capable
- Cost budget hard cap
MAS Generator (mas_generator.py)
- generate(use_case) → complete system (agents + flow + tools + evals + routing)
- 5 templates: code, security, research, data, operations
Skill Genome (purpose_agent/skills/)
- SkillCard versioned, testable, evolvable
- SkillGenome lineage tracking + rollback
- SkillCI immune scan → fitness test → promote/archive + mutation

Capability Fingerprint (optimization/fingerprint.py)
- Domains, tool motifs, action patterns, failure modes, latency/cost
Dataset Builder (optimization/dataset.py)
- Trace → filtered examples with immune scan + dedup + train/val/test split
Prompt Pack (optimization/prompt_pack.py)
- Token-budget-compliant optimization artifact (epigenetics first)
Shadow Evaluator (optimization/shadow_eval.py)
- Candidate vs baseline comparison, promote/rollback decisions
Agentic Optimizer (optimization/optimizer.py)
- Trend monitoring: improving → continue, plateau → optimize, degrading → rollback
Distillation Planning (optimization/lora_plan.py)
- Dry-run plans (none/prompt_pack/lora/distill/pdq), no GPU required for planning

Robustness Benchmark (benchmark_v3.py)
- 35+ checks: core loop, tools, immune, memory, routing, skills, events, protocols
- Runs with mock backend in CI

All v2.1.1 public imports still work
pa.purpose(), Team.run(), Spark, Flow, swarm, Council, Vault unchanged
Old names (Agent, Graph, parallel, Conversation, KnowledgeStore) are aliases
tests/compat/test_public_api_211.py validates full API surface