petfishframework 0.5.0__tar.gz → 0.5.2__tar.gz

{petfishframework-0.5.0 → petfishframework-0.5.2}/CHANGELOG.md

@@ -2,6 +2,77 @@
 
 All notable changes to petfishFramework will be documented in this file.
 
+## [0.5.2] — 2026-07-09
+
+### Review Fix Patch
+
+#### MCP Server Version Fix
+- `serve_as_mcp()` now returns dynamic `__version__` instead of hardcoded "0.5.0"
+
+#### README Status Sync
+- MCP server mode: `📋 Planned` → `✅ MVP (stdio JSON-RPC: initialize/tools.list/tools.call)`
+- Examples run instruction: added "from a repository checkout" clarification
+
+#### ToolGovernance First-Class API
+- New `ToolGovernance` dataclass bundles schema_validator + rate_limiter + idempotency_store + timeout_policy
+- `Agent(tool_governance=...)` wires governance into Session → RuntimeEnvironment
+- No more need to construct RuntimeEnvironment directly for governance features
+- README now includes Tool Governance usage example
+
+#### Resource Type Fix
+- `Resource` dataclass gains `risk_level: RiskLevel | None` field
+- `RiskClassificationPolicy` now works with standard Resource objects
+
+#### Rate-Limit / Idempotency Order Fix
+- Idempotency cache check moved BEFORE rate limiting
+- Cache hits no longer consume rate quota (correct semantic: rate limit counts real executions)
+
+## [0.5.1] — 2026-07-09
+
+### Deferred Items Completion + Reasoning Strategy Upgrades
+
+#### LATS Full MCTS
+- Upgraded from simplified greedy to full Monte Carlo Tree Search
+- UCB1 node selection, rollout simulation, backpropagation
+- `n_simulations` and `exploration_constant` parameters
+- Backward compatible (n_simulations=1 ≈ previous greedy behavior)
+
+#### LLM+P Generalization
+- Supports arbitrary planners beyond path_planner
+- `problem_type`, `translate_template`, `parse_template` fields
+- `for_planner()` factory for common configurations
+- Backward compatible (default = path_finding)
+
+#### Reflexion Strategy
+- Self-reflection wrapper around any ReasoningStrategy
+- Attempts task → reflects on failure → retries with accumulated lessons
+- `max_reflections` and `inner_strategy` parameters
+
+#### MCP Server Mode
+- `serve_as_mcp()` now functional (was NotImplementedError stub)
+- JSON-RPC over stdio: tools/list, tools/call, initialize
+- Framework tools exportable as MCP server
+
+#### Sandbox Executor
+- Subprocess isolation for high-risk tool execution
+- Temp working directory, restricted env vars, hard timeout
+- Documented as "Phase 1 — process isolation, not security boundary"
+
+#### CircuitBreaker
+- Failure-rate-based circuit breaking (CLOSED → OPEN → HALF_OPEN)
+- `failure_threshold`, `recovery_timeout_s` configuration
+- Thread-safe state management
+
+#### Policy Hot-Reload
+- `PolicyHotReloader` watches YAML policy files for changes
+- mtime-based polling (no watchdog dependency)
+- Callback registration for reload events
+- Daemon thread watcher
+
+#### Test Growth
+- v0.5.0: 352 tests → v0.5.1: 382 tests (+30)
+- All existing tests unmodified (backward compatible)
+
 ## [0.5.0] — 2026-07-08
 
 ### Tool / MCP Governance

{petfishframework-0.5.0 → petfishframework-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: petfishframework
-Version: 0.5.0
+Version: 0.5.2
 Summary: A lightweight runtime framework for reliable, auditable, budget-aware, and permission-aware AI agents.
 Project-URL: Homepage, https://github.com/kylecui/petfishFramework
 Project-URL: Documentation, https://github.com/kylecui/petfishFramework/tree/master/docs
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
 
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/kylecui/petfishFramework/blob/master/LICENSE)
-[![Tests: 352](https://img.shields.io/badge/tests-352-brightgreen.svg)](https://github.com/kylecui/petfishFramework/tree/master/tests/)
+[![Tests: 382](https://img.shields.io/badge/tests-382-brightgreen.svg)](https://github.com/kylecui/petfishFramework/tree/master/tests/)
 
 **Status: Alpha** — API may change. Core runtime works; see [Roadmap](#roadmap).
 
@@ -218,7 +218,7 @@ print(result.summary())
 
 See `examples/05_enterprise_expense.py` and `tests/test_enterprise_demo.py` for a complete enterprise expense approval scenario demonstrating all 6 DecisionEffects.
 
-Run: `python examples/05_enterprise_expense.py`
+Run (from a repository checkout): `python examples/05_enterprise_expense.py`
 
 ## YAML Policy Engine
 
@@ -271,6 +271,20 @@ session.events.subscribe(siem_sink)
 result = session.run()
 ```
 
+## Tool Governance
+
+```python
+from petfishframework.tools import ToolGovernance, ToolSchemaValidator
+from petfishframework.tools.rate_limiter import RateLimiter, RateLimitPolicy
+
+governance = ToolGovernance(
+    schema_validator=ToolSchemaValidator(),  # validate tool args before execution
+    rate_limiter=RateLimiter(),              # per-tool sliding-window rate limit
+)
+
+agent = Agent(model=model, reasoning=ReAct(), tools=tools, tool_governance=governance)
+```
+
 ## Roadmap
 
 - **v0.2.x**: Core runtime, permission semantics, enterprise PoC, Trusted Publishing ✅
@@ -293,7 +307,7 @@ petfishFramework is **Alpha**. API may change before v1.0.
 | Session replay / deterministic rerun / resume | ✅ Available |
 | OpenTelemetry + SIEM observability | ✅ Available |
 | MCP client stdio | ✅ Available |
-| MCP server mode | 📋 Planned |
+| MCP server mode | ✅ MVP (stdio JSON-RPC: initialize/tools.list/tools.call) |
 | Structured output / conversation memory | ✅ Available |
 | YAML Policy Engine | ✅ Available |
 | Credential Broker | ✅ Available |
@@ -306,7 +320,7 @@ petfishFramework is **Alpha**. API may change before v1.0.
 git clone https://github.com/kylecui/petfishFramework.git
 cd petfishFramework
 uv sync --all-extras
-uv run pytest              # 352 tests
+uv run pytest              # 382 tests
 uv run ruff check src/ tests/
 ```
 

{petfishframework-0.5.0 → petfishframework-0.5.2}/README.md

@@ -4,7 +4,7 @@
 
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/kylecui/petfishFramework/blob/master/LICENSE)
-[![Tests: 352](https://img.shields.io/badge/tests-352-brightgreen.svg)](https://github.com/kylecui/petfishFramework/tree/master/tests/)
+[![Tests: 382](https://img.shields.io/badge/tests-382-brightgreen.svg)](https://github.com/kylecui/petfishFramework/tree/master/tests/)
 
 **Status: Alpha** — API may change. Core runtime works; see [Roadmap](#roadmap).
 
@@ -183,7 +183,7 @@ print(result.summary())
 
 See `examples/05_enterprise_expense.py` and `tests/test_enterprise_demo.py` for a complete enterprise expense approval scenario demonstrating all 6 DecisionEffects.
 
-Run: `python examples/05_enterprise_expense.py`
+Run (from a repository checkout): `python examples/05_enterprise_expense.py`
 
 ## YAML Policy Engine
 
@@ -236,6 +236,20 @@ session.events.subscribe(siem_sink)
 result = session.run()
 ```
 
+## Tool Governance
+
+```python
+from petfishframework.tools import ToolGovernance, ToolSchemaValidator
+from petfishframework.tools.rate_limiter import RateLimiter, RateLimitPolicy
+
+governance = ToolGovernance(
+    schema_validator=ToolSchemaValidator(),  # validate tool args before execution
+    rate_limiter=RateLimiter(),              # per-tool sliding-window rate limit
+)
+
+agent = Agent(model=model, reasoning=ReAct(), tools=tools, tool_governance=governance)
+```
+
 ## Roadmap
 
 - **v0.2.x**: Core runtime, permission semantics, enterprise PoC, Trusted Publishing ✅
@@ -258,7 +272,7 @@ petfishFramework is **Alpha**. API may change before v1.0.
 | Session replay / deterministic rerun / resume | ✅ Available |
 | OpenTelemetry + SIEM observability | ✅ Available |
 | MCP client stdio | ✅ Available |
-| MCP server mode | 📋 Planned |
+| MCP server mode | ✅ MVP (stdio JSON-RPC: initialize/tools.list/tools.call) |
 | Structured output / conversation memory | ✅ Available |
 | YAML Policy Engine | ✅ Available |
 | Credential Broker | ✅ Available |
@@ -271,7 +285,7 @@ petfishFramework is **Alpha**. API may change before v1.0.
 git clone https://github.com/kylecui/petfishFramework.git
 cd petfishFramework
 uv sync --all-extras
-uv run pytest              # 352 tests
+uv run pytest              # 382 tests
 uv run ruff check src/ tests/
 ```
 

{petfishframework-0.5.0 → petfishframework-0.5.2}/docs/api.md

@@ -1,6 +1,6 @@
 # petfishFramework API Reference
 
-This document is the authoritative reference for the public API of petfishFramework v0.5.0. Every signature, field, and example below is derived from the source code and from the tests that exercise it.
+This document is the authoritative reference for the public API of petfishFramework v0.5.2. Every signature, field, and example below is derived from the source code and from the tests that exercise it.
 
 ## 1. Overview