feat(runtime): pin gentle-ai v3.0.1 on the /v3 module and prepare gentle-pi 3.1.0

[Alan-TheGentleman]

Closes #1116

Summary

• Pins the package-local Gentle AI runtime to v3.0.1, whose Go module path moved to github.com/gentleman-programming/gentle-ai/v3 (gentle-ai #4683). gentle-pi 3.0.0 still packaged v2.9.1 and its Windows source-install constants named the /v2 module, so it could not install any v3 runtime.
• Prepares gentle-pi 3.1.0 (a pin bump is a feat, so minor).
• Mirrors the previous pin PR (chore(release): pin gentle-ai v2.9.1 and prepare v2.7.0 #1026) exactly: version literals, Windows source module and package path on /v3, SumDB module checksum, archive and binary digests from the published v3.0.1 release, NATIVE_CLI_CONTRACTS rows for 3.0.0 and 3.0.1, docs and openspec spec text, version-bound tests.

Ground truth

• Windows module checksum: go mod download -json github.com/gentleman-programming/gentle-ai/v3@v3.0.1 → Sum h1:r2z8yf0CdL0ZPPkMEKI3km6SitjOIC/DQDvtipc1Igs=, tag commit 2594581e.
• Archive digests verified against the release's signed checksums.txt; binary digests computed from the extracted executables.
• contracts/review-integration/v2 and contracts/review-provider-contract are byte-identical between v2.9.1, v3.0.0 and v3.0.1, so the 3.0.0 and 3.0.1 contract rows repeat 2.9.1 exactly (provider contract 1.2.0).

Changes

File	Change
scripts/gentle-ai-installer.mjs	INSTALLER_VERSION 3.0.1, /v3 Windows module and package path, module checksum, four asset rows
lib/native-review-cli.ts, runtime/native-review-cli.mjs	NATIVE_CLI_CONTRACTS rows 3.0.0 and 3.0.1 (runtime regenerated with build-runtime-modules)
package.json	version 3.1.0
scripts/verify-package-files.mjs	pinned-runtime messages
docs/gentle-shell.md, docs/readme-reference.md, openspec/specs/review-transaction/spec.md	pin and version text
tests/gentle-ai-binary.test.ts, tests/gentle-ai-installer.test.ts, tests/native-review-capability-contract.test.ts, tests/package-manifest.test.ts	version-bound assertions and fixtures

Test plan

• pnpm test: 2619 pass, 2 fail (the two pre-existing macOS-only environmental failures that pass in CI: sdd-managed-runtime-settlement R1 native scope, windows-hidden-processes /private/var realpath), 38 skipped.
• node scripts/verify-package-files.mjs: passed (168 files; 69 byte-pinned contract artifacts for the v3.0.1 runtime).
• npm pack --dry-run: gentle-pi-3.1.0.tgz, 509 files.
• node scripts/test-packed-runner.mjs: passed, live install and verification of the published v3.0.1 binary.

AI assistance

Material assistance used: Claude Code (Claude Fable 5.1) for the mechanical pin update mirroring #1026 and the digest computation; verification as listed above.

Summary by CodeRabbit

• New Features

  • Added support for Gentle AI runtime versions 3.0.0 and 3.0.1 while preserving existing capabilities.
  • Updated the packaged runtime to Gentle AI v3.0.1 across supported platforms.
  • Updated the package release version to 3.1.0.

• Documentation

  • Updated installation, workspace, capability, and integration documentation for the new runtime versions.

• Tests

  • Updated installer, package verification, binary, and capability coverage for the v3.0.1 runtime and 3.1.0 package.

[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: 59279bd5-45b0-4999-9db4-3dd274327fe5

📥 Commits

Reviewing files that changed from the base of the PR and between c49ff7b and 1fb85a7.

📒 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; 3 remain after this review.

---

📝 Walkthrough

Walkthrough

Changes

Gentle AI v3.0.1 pin and gentle-pi 3.1.0

Layer / File(s)	Summary
Installer pin and runtime validation scripts/gentle-ai-installer.mjs, tests/gentle-ai-installer.test.ts, tests/gentle-ai-binary.test.ts, scripts/verify-package-files.mjs, package.json, tests/package-manifest.test.ts	The installer now targets Gentle AI v3.0.1, the /v3 Go module, updated checksums, and updated release assets. Installer and package tests use the new runtime paths and version.
Native contract negotiation lib/native-review-cli.ts, runtime/native-review-cli.mjs, tests/native-review-capability-contract.test.ts	Native contract tables and tests add versions 3.0.0 and 3.0.1 with the existing capability flags.
Version references and specification updates docs/*, openspec/specs/review-transaction/spec.md, tests/package-manifest.test.ts	Documentation and review-transaction scenarios reference Gentle AI v3.0.1 and gentle-pi 3.1.0. The package release test expects version 3.1.0.

Priority: ➖ Normal

Estimated code review effort: 3 (Moderate) | ~20 minutes

Change: Feature · Severity of issue fixed: Medium

Merge Risk: ⚪ Minimal · up to 1fb85

The runtime pin, installer metadata, contract rows, tests, and version references are aligned in the supplied change context.

🚥 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 summarizes the two main changes: pinning Gentle AI v3.0.1 on the /v3 module and preparing gentle-pi 3.1.0.
Linked Issues check	✅ Passed	The PR meets the coding requirements in issue #1116. scripts/gentle-ai-installer.mjs pins INSTALLER_VERSION to 3.0.1, uses the /v3 module and package paths, and defines the requested module ch…
Out of Scope Changes check	✅ Passed	The reviewed changes stay within issue #1116. Installer metadata, native contract regeneration, package version data, documentation, specification references, verification messages, and tests all supp…

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 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/pin-gentle-ai-v3.0.1

---

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.}