Skip to content

v3.17.0 — install.sh URL fix + --search-mode flag

Choose a tag to compare

View all tags
@noahgift noahgift released this 06 May 00:34
· 28 commits to master since this release
v3.17.0
097c9f5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Highlights

Two ship-blocking bugs landed via #564 and #565, both discovered while building a Coursera RAG-from-Zero lab.

Fixed

  • scripts/install.sh URL pattern, tarball layout, and Linux platform default (#561 → #564). Three sub-bugs in the documented one-liner installer:
    1. URL was constructed as paiml-mcp-agent-toolkit-${PLATFORM}.tar.gz but actual release assets are named pmat-v${VERSION}-${PLATFORM}.tar.gz — every install since the v3.0 rename returned 404.
    2. The release tarball extracts to a subdirectory (pmat-v${V}-${P}/pmat), not flat — the script's binary-locator looked at the wrong path.
    3. Linux platform detection defaulted to the gnu variant, which requires GLIBC 2.39 and fails on Ubuntu 22.04 (GLIBC 2.35); now defaults to the static-pie musl variant for portability across glibc versions.

Added

  • pmat query --search-mode {semantic,lexical,hybrid} (#562 → #565). Explicit search-mode flag on pmat query for lexical-vs-semantic comparison without the config gate that pmat semantic search requires.
    • semantic (default) preserves current behavior — auto-blended relevance + structural signals.
    • lexical does case-insensitive smart-case match against function name + signature + source span, ranked by hit count plus existing structural-signal blend (works without an embeddings index).
    • hybrid runs both pipelines and combines via reciprocal-rank fusion at k=60.
  • Provable contracts: contracts/pmat-install-v1.yaml and contracts/pmat-query-search-modes-v1.yaml.

Install

The corrected one-liner:

curl -fsSL https://raw.githubusercontent.com/paiml/paiml-mcp-agent-toolkit/master/scripts/install.sh | sh -s v3.17.0

Or download a prebuilt directly (musl recommended for Linux portability):

curl -fsSL https://github.com/paiml/paiml-mcp-agent-toolkit/releases/download/v3.17.0/pmat-v3.17.0-x86_64-unknown-linux-musl.tar.gz \
  | tar -xz
./pmat-v3.17.0-x86_64-unknown-linux-musl/pmat --version

Try the new flag

pmat query "error handling" --search-mode lexical --limit 3
pmat query "error handling" --search-mode semantic --limit 3
pmat query "error handling" --search-mode hybrid --limit 3

🤖 Generated with Claude Code

Assets 9
Loading