1.17.0 - 2026-05-21

Release Notes

Added

• project_query::function_at(path, line, col) — new host import returning the FunctionInfo whose body contains the given position. Useful for tree-query–driven detectors that need to disambiguate which declared function a queried position belongs to.
• WasmPluginTest::option_list / option_bool / option_int / option_float — list and typed option setters in the test harness, replacing the previous string-only option().

Changed (breaking for WASM plugins)

• tree_query::QueryMatch.start_line / end_line are now 1-based (was 0-based). Aligns with FunctionInfo / ClassInfo / CommentInfo line numbering — no more per-plugin off-by-one conversion. Inputs to node_at(line, col) and nodes_in_range(start, end) are likewise 1-based now.
• Existing plugins compiled against the pre-1.17 WIT will need to be rebuilt against the new SDK; instantiation will fail loudly otherwise.

Fixed

• react-hooks example plugin — false positives on hook_after_early_return (in sibling components and inside return expressions like return useState()) eliminated by switching to project_query::function_at for host-function disambiguation. Now reports 5 true positives / 0 false positives on the 6-component .tsx fixture (was 5 / 2).

Documentation

• docs/plugin-development.md: added Line/Column convention note, Project Query API section, WASM Compatibility Cheatsheet (regex panics, no clock, no FS), cha plugin build vs cargo build distinction, and new option helpers in Testing.

Install cha-cli 1.17.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/Cha/releases/download/v1.17.0/cha-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/W-Mai/Cha/releases/download/v1.17.0/cha-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install W-Mai/cellar/cha-cli

Download cha-cli 1.17.0

File	Platform	Checksum
cha-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
cha-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
cha-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
cha-cli-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
cha-cli-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
cha-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum
cha-cli-x86_64-unknown-linux-musl.tar.xz	x64 MUSL Linux	checksum