feat(runtime): pin gentle-ai v3.1.0 and prepare gentle-pi 3.2.0

[Alan-TheGentleman]

Closes #1152

Summary

• Pins Gentle AI v3.1.0 (cfc415ce) on the /v3 module: installer version, the four signed release archives with archive and binary SHA-256 digests, and the SumDB source module checksum for the Windows build.
• Adds the 3.1.0 row to NATIVE_CLI_CONTRACTS (lib and generated runtime module), repeating 3.0.1 exactly: zero bytes changed under contracts/review-integration/v2 and contracts/review-provider-contract between the v3.0.2 and v3.1.0 tags; provider contract stays 1.2.0.
• Prepares gentle-pi 3.2.0 (package.json, docs, openspec spec, version-bound tests).

Same file set as #1118.

Verification

• Archive digests verified against the minisign-signed checksums.txt of the v3.1.0 release and freshly computed hashes; binary digests computed from the extracted executables.
• node --experimental-strip-types --test tests/gentle-ai-installer.test.ts tests/gentle-ai-binary.test.ts tests/native-review-capability-contract.test.ts tests/package-manifest.test.ts: 113 pass, 7 Windows-only skips
• pnpm test: 2638 pass, 0 fail, 38 skipped; provider contract check passed (contract 1.2.0)
• node scripts/verify-package-files.mjs: passed (168 files; 69 byte-pinned contract artifacts for the v3.1.0 runtime)
• npm pack --dry-run: gentle-pi-3.2.0.tgz
• node scripts/test-packed-runner.mjs: packed package E2E passed (gentle-pi 3.2.0; Gentle AI 3.1.0), downloading and verifying the published v3.1.0 assets
• Native review per the ODD contract: see the lineage noted in the merge commit discussion

AI assistance

Material assistance used: Claude Code (Claude Fable 5.1 orchestrating, Sonnet writer) with maintainer-computed digests in the feature document. Verification: the commands above and the native review.

Summary by CodeRabbit

• New Features

  • Added support for the Gentle AI v3.1.0 runtime and native capability negotiation.
  • Updated installation assets and integrity metadata for v3.1.0 across supported platforms.
  • Advanced the package version to 3.2.0.

• Bug Fixes

  • Older runtime versions now fail negotiation with the expected version instead of degrading.

• Documentation

  • Updated installation, source checkout, build, rollback, and runtime reference documentation for the new versions.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 9058ed6b-447b-4bb9-b0b4-eb89f3a081c2

📥 Commits

Reviewing files that changed from the base of the PR and between 10e65f5 and 8d5b82d.

📒 Files selected for processing (12)

• docs/gentle-shell.md
• docs/readme-reference.md
• lib/native-review-cli.ts
• openspec/specs/review-transaction/spec.md
• package.json
• runtime/native-review-cli.mjs
• scripts/gentle-ai-installer.mjs
• scripts/verify-package-files.mjs
• tests/gentle-ai-binary.test.ts
• tests/gentle-ai-installer.test.ts
• tests/native-review-capability-contract.test.ts
• tests/package-manifest.test.ts

Included review availability: Your plan provides up to 4 included reviews per hour; 1 remains after this review.

---

📝 Walkthrough

Walkthrough

The package now pins Gentle AI v3.1.0 and gentle-pi 3.2.0. Installer assets, Windows source-build metadata, native capability mappings, specifications, tests, verification messages, and documentation use the updated versions.

Changes

Gentle AI runtime and package release

Layer / File(s)	Summary
Installer and package validation scripts/gentle-ai-installer.mjs, tests/gentle-ai-installer.test.ts, tests/gentle-ai-binary.test.ts, tests/package-manifest.test.ts, package.json	The installer, release assets, Windows source-build metadata, runtime paths, integrity manifests, lock files, recovery fixtures, and package version now reference Gentle AI v3.1.0 and gentle-pi 3.2.0.
Capability and negotiation alignment lib/native-review-cli.ts, runtime/native-review-cli.mjs, openspec/specs/review-transaction/spec.md, tests/native-review-capability-contract.test.ts	The native capability tables add a v3.1.0 row matching v3.0.1. The specification requires v3.1.0 and names negotiation failure for older runtimes.
Documentation and verification messaging docs/gentle-shell.md, docs/readme-reference.md, scripts/verify-package-files.mjs	Documentation and package verification messages now identify the v3.1.0 runtime and the gentle-pi 3.2.0 pairing.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~15 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 8d5b8

The package and runtime pins are aligned across installation, negotiation, release checks, tests, and documentation, so no merge-blocking risk remains.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 10.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 10 functions across 8 files. (4 skipped: …	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely identifies the two primary changes: pinning Gentle AI v3.1.0 and preparing gentle-pi 3.2.0.
Linked Issues check	✅ Passed	The pull request satisfies the coding requirements in issue #1152. scripts/gentle-ai-installer.mjs pins Gentle AI 3.1.0, commit cfc415ce, the Windows SumDB checksum, and the Darwin/Linux release…
Out of Scope Changes check	✅ Passed	The reported changes remain within issue #1152. Documentation, OpenSpec updates, verifier messages, native contract metadata, and test updates support the runtime pin and gentle-pi 3.2.0 release. No…

Full details: Docstring Coverage

Explanation

Docstring coverage is 10.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 10 functions across 8 files. (4 skipped: 4 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}