Skip to content

v0.5.2 — Independent extension preview for Pi 1.3.0, 1.2.0 and 1.1.0

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 18 Oct 16:37
86cb9c6

Pi Context Compaction v0.5.2 supplies an ordinary extension for unmodified official Pi 1.3.0, 1.2.0 and 1.1.0.

Install this release's extension package (a fixed package tag) from your terminal, then restart Pi:

pi install git:github.com/youxi-huang/pi-context-compaction@extension-v0.5.2

Start a new persistent text session and run /compaction-doctor to check it without calling a model. Source tag v0.5.2 selects the development monorepo, not the package. To follow later previews instead, install the moving extension-preview branch in place of the tag and update only this package with pi update --extension git:github.com/youxi-huang/pi-context-compaction@extension-preview. A plain pi update updates Pi itself.

This pre-release supports manual /compact and Pi's threshold compaction after completed text turns, source-linked history retrieval and explicit disk-confirmed failure recovery. In the sessions it handles, overflow recovery still requires explicit /compact, and background cache warming is paused. Sessions it never protected and cannot check, such as ones with native checkpoints, images or another Pi version, are left to Pi without a failure marker. Other checkpoint formats, parent-history grants, attachments, concurrent writers and Windows are outside its verified scope.

Ordinary Agent retries after transient provider failures are supported, including partial-response connection drops. Existing retry-related blocks and text-only context-overflow failures can use explicit /compact recovery when sufficient completed source history exists. Arbitrary context edits and unfinished tool-call omissions remain unsupported.

Optional preparation has two arms, both disabled by default: A prepares with the configured writer; B merges data-only work notes from the session model. A validated candidate can commit its covered prefix without a writer call while every later original stays verbatim. B carries covered user messages in full and falls back to the configured writer when they do not fit. Every writer call is journaled, including cancelled or discarded preparation and unknown usage. These are experimental paths; real-provider pause, total cost, cache behavior and recovery benefits remain unproven.

Validation: this publication run passed 88 stock-Pi package and lifecycle checks on official Pi 1.3.0, 1.2.0 and 1.1.0 and the full default-settings scenario suite on Pi 1.3.0 with strict acceptance and no performance exceptions or known gaps. Scenario evidence is bound to this exact package and source commit; the 50 ms request-overhead target and checkpoint-growth bound are required checks. Focused, security and frozen evaluator checks also remain required on final main. Services are synthetic and loopback only; no real-provider quality, latency or interactive TUI claim is made.

Source commit: 86cb9c6. Preview runtime: stock-preview+src.289ffa92e5522496. Resident runtime keeps its v0.3.0 fingerprint.

Usage and recovery · Validation

Changes

v0.5.2 makes the independent extension quiet when it works and specific when it has to stop. Pi's footer now shows whether compaction is on, how many checkpoints the branch holds, when a note is being written and when requests are paused. Notices say what happened before why and end with the code, and a blocked session gets a one-line reminder instead of the whole notice on every input. Text typed while requests are paused goes back to the editor instead of into a request Pi then aborts. A session that reopens with a checkpoint shows its ready or off notice at the first input, where Pi's own status line used to overwrite it. Around a compaction the extension spends 44% less of its own time, with every check in place. The changes are in the independent preview only: the resident runtime, its build fingerprint, the checkpoint schema and the evaluation pin are unchanged. Each change was walked through in an 80-column terminal on official Pi 1.3.0, 1.2.0 and 1.1.0 with synthetic responses; no real-provider run is part of this release. The source tree also drops an unused upstream example that pulled in a vulnerable node-forge.

Added

  • The independent preview shows its state on Pi's footer line: on, the number of checkpoints on the current branch, writing a note, or paused with a pointer to /compaction-doctor. Before, a paused session showed only when an input was refused.

Changed

  • /compaction-doctor ends with Result: ready for requests instead of Result: ready, so it no longer reads as a promise that /compact will run, and its note on Pi's history threshold is shorter.
  • While the independent preview is paused, text typed in Pi's interactive editor goes back to the editor, and the notice says why. No request starts, nothing is recorded in the session, and Pi no longer adds This operation was aborted. Commands still run, and the request guard still stops every other paused request.
  • The independent preview's notices begin with Source-linked compaction, say what happened before why, and put the code last. A blocked session no longer repeats the whole notice on every input: later inputs blocked by the same code get one short line until a checkpoint or recovery is confirmed. /compaction-doctor reports a requests line instead of durable block, and every code a preview session can raise or restore has its own advice.
  • The independent preview spends less of its own time around a compaction and when a long session reopens: at 40 checkpoints in a synthetic session, 311 ms instead of 558 ms around the writer and 75 ms instead of 118 ms added to a reopen. Within one synchronous step it now serializes, hashes and reads the session file once where it did so several times. Every source comparison runs at the same moments, and checkpoint hashes are byte-identical.

Fixed

  • When a session with a checkpoint reopens in Pi's interactive mode, the independent preview's ready or off notice now appears with the first input. Before, Pi's Session compacted status overwrote it.

Security

  • Remove the unused upstream Gondolin micro-VM example and its workspace dependency chain, which included node-forge affected by GHSA-86w9-cpqp-85rv. Remove its standalone lockfile and the obsolete audit exception, and update the example index and isolation guide. The documented agent maintenance commands, resident compaction runtime and independent extension do not use this example.