Repository navigation
v0.98.2: Committed Regression Test Suites & Agent Contract Freeze
POLER Engine v0.98.2 Release Notes
🎯 Key Enhancements & Contract Freeze
1. Live Regression Test Suites Committed to Repository
Both third-party test suites are now part of the canonical repository under tests/:
tests/test_patch_crc.py(10/10 PASS): Full CRC32 container verification, ZIP/DOCX stream edits, ambiguous match refusal, and auto-entry discovery.tests/test_ergonomics.py(15/15 PASS): Zero-disk-IO--dry-run, unified diff generation (--diff), structured AI-agent JSON mode (--json), and deterministic exit codes 0–5.- Both suites are directly executable via standard Python 3 (
python3 tests/test_patch_crc.py && python3 tests/test_ergonomics.py) with dynamic binary autodetection.
2. Native CI/CD Pipeline Integration
- Automated execution of all 185 Rust tests (184 unit + 1 integration) plus all 25 Python live integration assertions on every push and pull request.
- All 6 matrix jobs (3 test matrix + 3 release build matrix) verified green.
3. 🔒 Agent API & Contract Freeze (v0.98.x → v1.0 Guarantee)
The core contract for autonomous agents is now frozen and guaranteed stable until v1.0.0:
-
Exit Codes (0–5):
-
0: SUCCESS (patch applied or dry-run matched). -
1: GENERIC_ERROR (I/O, permissions). -
2: USAGE_ERROR (invalid arguments). -
3: NOT_FOUND (match_not_foundor missing archive entry). -
4: AMBIGUOUS_MATCH (ambiguous_match— prompt agent to expand context). -
5: SYNTAX_BROKEN (trit_syntax_broken— bracket balance$\mathbb{T} \ne 0$ violated, atomic rollback).
-
-
Dual-Dispatch JSON-RPC: Seamless support for both
"cmd": "..."(CLI standard) and"method": "..."(MCP standard). -
Structured JSON Mode: Guaranteed envelope format with
ok,error,error_code,path,dry_run,diff.
📦 Platform Binaries & Verification
- Linux x86_64:
poler-linux-x86_64 - macOS ARM64 (Apple Silicon):
poler-macos-arm64 - Windows x86_64:
poler-windows-x86_64.exe