Skip to content

v0.98.2: Committed Regression Test Suites & Agent Contract Freeze

Choose a tag to compare

@github-actions github-actions released this 21 Nov 01:17
· 13 commits to main since this release

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_found or 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