| # CHANGELOG |
|
|
| ## v3.0.0a1 (2026-05-01) |
|
|
| ### Added β Track A: Foundation |
| - **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 |
|
|
| ### Added β Track B: Interoperability |
| - **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) |
|
|
| ### Added β Track C: Intelligence |
| - **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 |
|
|
| ### Added β Track D: Optimization |
| - **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 |
| |
| ### Added β Track E: Hardening |
| - **Robustness Benchmark** (`benchmark_v3.py`) |
| - 35+ checks: core loop, tools, immune, memory, routing, skills, events, protocols |
| - Runs with mock backend in CI |
|
|
| ### Backward Compatibility |
| - 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 |
|
|
| --- |
|
|
| ## v2.1.1 (2026-04-30) |
| - Creative naming: Spark, Flow, swarm, Council, Vault |
| - 19/19 production test pass with Llama-3.3-70B |
| - Published on PyPI |
|
|
| ## v2.0.0 (2026-04-29) |
| - V2 kernel: evidence-gated memory, immune system, RunMode, trace, compiler |
| - 13 research papers implemented |
| - 6 breakthroughs: self-improving critic, MoH, hindsight, evolution, adversarial |
| - TOML prompts, robust_parser, secure tools |
| - 119/119 tests pass |
| |
| ## v0.2.0 (2026-04-28) |
| - Initial release: Actor, Purpose Function, Experience Replay, Optimizer |
| - SLM-native backends, streaming, tools, multi-agent, HITL, evaluation |
| - Published on PyPI |
| |