Skip to content

gentle-pi v1.0.4

Choose a tag to compare

@Alan-TheGentleman Alan-TheGentleman released this 14 Jul 10:35
· 1115 commits to main since this release

What's New

gentle-pi v1.0.4 repairs historical SDD apply agents that could remain read-only after upgrading from versions before v0.10.8. It also hardens the native review adapter for valid low-risk, zero-lens START responses and expands the README around verifiable trust and exact runtime boundaries.

Highlights

  • Automatic legacy repair: Exact package-owned v0.10.7 sdd-apply.md bytes migrate from a scalar tool declaration to the current YAML allowlist.
  • User overrides preserved: Migration uses the historical SHA-256 and never overwrites modified variants.
  • Durable managed ownership: Repaired assets re-enter the managed manifest so later Gentle Pi updates can refresh them safely.
  • Low-risk native compatibility: selected_lenses: null is accepted only for low-risk reviews where lenses are explicitly not required; contradictory medium/high responses remain rejected.
  • Verifiable trust documentation: The README now explains immutable candidates, bounded review, same-receipt lifecycle gates, package-local authority, and the current workspace-projection boundary.

Changes

SDD Asset Migration

  • Added exact v0.10.7 managed-asset evidence for the historical malformed sdd-apply.md tool declaration.
  • Loads legacy hashes lazily when a forced refresh encounters an installed but unowned candidate, including homes where managed-assets.json already exists.
  • Preserves byte-modified user overrides and existing v0.13/v0.14 migrations.
  • Records current ownership after repair so subsequent package upgrades remain deterministic.

Native Review Adapter

  • Normalizes selected_lenses: null to an empty array only when risk_level is low and lenses_required is false.
  • Continues rejecting null lens metadata for low-risk reviews requiring actors and for every medium/high-risk response.
  • Adds focused controls for valid zero-lens responses and contradictory risk/lens states.

Documentation And Packaging

  • Documents the install → plan → build → review → deliver workflow using Git-derived evidence rather than agent narration.
  • Clarifies that Gentle AI v2.1.4 supports staged projection while the current Gentle Pi adapter intentionally exposes workspace projection only.
  • Adds native adapter, candidate-view, package-local binary, and installer responsibilities to the package map.
  • Includes the v0.10.7 migration evidence and fixture in the verified npm package resource set.

Compatibility

  • No application configuration migration is required.
  • Affected historical global assets repair automatically on the next Pi session after upgrading.
  • Genuine user-edited agent definitions remain untouched and continue to override package-managed assets.
  • Users who manually repaired sdd-apply.md do not need to undo their change; the migration will preserve it as an override.

Verification

  • Released from exact commit 4014f521a9651c2df6ec6677587386fe99aedf64.
  • CI run 29325749092 passed on that exact SHA with 736 tests plus the Pi runtime harness.
  • Package dry-run and verification passed for all 55 required files.
  • Exact-old migration, existing-manifest recovery, user-override preservation, managed refresh, and low-risk native decoding regressions passed.
  • npm publish workflow 29325935272 completed successfully on the release SHA.

Install Or Upgrade

pi update

Then restart Pi or run:

/reload

For a fresh installation:

pi install npm:gentle-pi

Links