gentle-pi v1.0.4
·
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.mdbytes 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: nullis 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.mdtool declaration. - Loads legacy hashes lazily when a forced refresh encounters an installed but unowned candidate, including homes where
managed-assets.jsonalready 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: nullto an empty array only whenrisk_levelislowandlenses_requiredis 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.mddo 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 updateThen restart Pi or run:
/reload
For a fresh installation:
pi install npm:gentle-pi