Skip to content

gentle-pi v1.0.3

Choose a tag to compare

View all tags
@Alan-TheGentleman Alan-TheGentleman released this 14 Jul 06:53
v1.0.3
e78e9b8

What's New

gentle-pi v1.0.3 completes the transition from Pi-owned review approximations to the official Gentle AI native authority lifecycle. Reviews now operate on immutable candidate views, preserve authority across worktrees and restarts, recover blocked SDD changes without destroying history, and ship with a verified package-local Gentle AI v2.1.4 runtime.

Highlights

  • Official native authority: START, FINALIZE, status, SDD binding, and lifecycle validation now follow the strict Gentle AI v2.1.4 contract.
  • Immutable candidate views: Review actors receive canonical changed-scope projections while full candidate-tree, path, mode, symlink, and staging integrity remain enforced.
  • Package-local runtime: Six supported platform archives are downloaded with pinned SHA-256 checksums, safely extracted, verified, and confined to the package installation.
  • Worktree-aware routing: Linked worktrees, committed bases, explicit policy/base selectors, replay, reload, correction, and resumed review flows preserve the correct native authority.
  • Non-destructive SDD recovery: Legacy graph-v1 authority can be explicitly superseded by compatible compact authority without resetting unrelated or historical review state.
  • Fail-closed evidence handling: Refuter batches, lens sets, lifecycle responses, publication topology, and correction evidence are normalized and validated before authority mutation.

Changes

Native Review Lifecycle

  • Added a strict native CLI adapter for review START, FINALIZE, validation, SDD binding, and status operations.
  • Enforced canonical risk-tier lens sets and separate action/state semantics for fresh, resumed, correction, and reusable authority.
  • Routed explicit policyPath and baseRef selectors to native START instead of local receipt shortcuts.
  • Added committed-base review support with process-safe argument validation and literal argv forwarding.
  • Preserved exact replay and reload behavior without rerunning actors or reopening review budgets.

Candidate Scope And Worktrees

  • Added immutable changed-scope candidate views bound to the full candidate tree.
  • Unified review authority discovery across primary and linked worktrees.
  • Added exact path, tree, staging, file-mode, executable-bit, and symlink validation.
  • Bounded candidate Git subprocesses and rejected drift, ambiguity, malformed state, and out-of-scope mutations.
  • Separated implementation-owned SDD tasks from parent-owned review lifecycle work so completed applies hand off cleanly.

Authority Recovery And Evidence

  • Added append-only graph-v1 to compact-v2 supersession for blocked SDD changes.
  • Bound recovery to source/successor equivalence, change identity, CAS revisions, and durable lifecycle evidence.
  • Normalized refuter output as one complete batch bound to the frozen request, exact finding IDs, and admitted proof references.
  • Escalated malformed, incomplete, mismatched, or replayed evidence atomically instead of accepting partial authority.
  • Kept unrelated historical lineages and terminal receipts intact.

Package-Local Gentle AI Runtime

  • Pinned production runtime compatibility to official Gentle AI v2.1.4.
  • Added verified artifacts for macOS, Linux, and Windows on AMD64 and ARM64.
  • Added bounded download, redirect, header, body, retry, and timeout behavior.
  • Used trusted absolute extractors and atomic promotion after archive and binary integrity checks.
  • Rejected PATH, global, sibling, symlink, manifest, checksum, confinement, and executable-mode fallbacks.
  • Added explicit offline installation guidance and actionable missing-runtime errors.

Contracts, Documentation, And Tests

  • Updated reviewer, refuter, validator, Judgment Day, SDD, and orchestration contracts for native authority ownership.
  • Added native response fixtures, real-binary parity coverage, installer and resolver regressions, candidate-view tests, controller matrices, and recovery durability tests.
  • Added OpenSpec proposals, specifications, designs, task evidence, upstream trackers, and independent verification reports for the consolidated lifecycle work.
  • Expanded package verification from 49 to 54 required resources.

Compatibility

  • No application configuration migration is required.
  • The package now requires and provisions the exact package-local Gentle AI v2.1.4 runtime; global, sibling, and PATH binaries are intentionally ignored.
  • Existing graph-v1 ordinary authority remains readable and recoverable through explicit supersession, but new ordinary mutations use native compact authority.
  • Judgment Day remains a separate graph-v1 workflow.
  • Historical v2.1.2 and v2.1.3 fixtures remain test fixtures only and are not runtime fallbacks.

Verification

  • Released from exact commit e78e9b81d75d02a83793f89a20a17287b619658c.
  • CI run 29312409913 passed on that exact SHA with 734 tests plus the Pi runtime harness.
  • Package dry-run and verification passed for all 54 required files.
  • Official Gentle AI v2.1.4 native parity, bounded correction validation, and immutable lifecycle gates passed.
  • npm publish workflow 29312740691 completed successfully on the release SHA.

Install Or Upgrade

pi update

For a fresh installation:

pi install npm:gentle-pi

Links

Assets 2
Loading