pi-fold 4.2.2 → 4.2.3

package/README.md

@@ -44,7 +44,7 @@ The forty-column bar uses full-height half-blocks for eighty steps of fill, read
 
 The suffix reads `34% · commit at 55% · N Folds (X Cons., Y Span, Z Tool, X Mark, Y Pin)`, naming only the kinds with something to count, in the bar's order; a fresh session reads `0 Folds`. `N Folds` counts visible compressed folds; `Mark` counts pending marks and `Pin` counts protected entries, not additional compressed folds. A tool fold is lossless compression of tool-result context, not a count of tool calls. `/fold-status` retains the detailed token and nesting figures. Its `Budget` row and the editor's `Budget` header report the separate serving budget and the tokens remaining before a commit.
 
-Two dotted marks stand in the band's edge cells: one where a commit aims to land and one where automatic folding is triggered. `minTarget` and `maxTarget` remain shares of the serving budget; the marks and displayed commit point are converted to Pi's full-window scale, so the trigger does not move. With a 272,000-token window and the default 255,616-token serving budget, the 80% trigger appears at about 75% of Pi's window. Percentages are rounded to whole numbers; a custom footer may round differently. Each is drawn over the fill's own colour in a deeper tone of that same hue, so the fill continues behind the mark; on the empty track they stand in muted ink. Neither takes a colour of its own or a warning colour. When Pi reports unknown usage, including immediately after native compaction, the row says `not measured yet`; no saved count or local estimate fills the gap. After a fold commit it identifies the old reading until the provider measures again. Crossing the target is routine runtime work, not a user action item. On reload, saved session context supplies the fold counts and composition without a new model message; the next real context event replaces that read-only view. Unavailable composition is stated as `mapping`; if folding stops, `FOLDING STOPPED` replaces the bar. Non-truecolor terminals use the theme's own colours.
+Two dotted marks stand in the band's edge cells: one where a commit aims to land and one where automatic folding is triggered. `minTarget` and `maxTarget` remain shares of the serving budget; the marks and displayed commit point are converted to Pi's full-window scale, so the trigger does not move. With a 272,000-token window and the default 255,616-token serving budget, the 80% trigger appears at about 75% of Pi's window. The usage label rounds down to a whole percentage, matching pi-cc's footer; bar fill and folding decisions keep the unrounded value. The displayed commit point rounds to the nearest whole percentage. Each is drawn over the fill's own colour in a deeper tone of that same hue, so the fill continues behind the mark; on the empty track they stand in muted ink. Neither takes a colour of its own or a warning colour. When Pi reports unknown usage, including immediately after native compaction, the row says `not measured yet`; no saved count or local estimate fills the gap. After a fold commit it identifies the old reading until the provider measures again. Crossing the target is routine runtime work, not a user action item. On reload, saved session context supplies the fold counts and composition without a new model message; the next real context event replaces that read-only view. Unavailable composition is stated as `mapping`; if folding stops, `FOLDING STOPPED` replaces the bar. Non-truecolor terminals use the theme's own colours.
 
 ## Results
 

package/extensions/active-context.ts

@@ -757,7 +757,7 @@ export function registerActiveContext(pi: any, options: {
   // and post-compaction unknown state. Never substitute our saved provider measurement
   // or projection estimate. The band remains a share of the SERVING budget: convert its
   // points onto Pi's full-window axis, without changing any scheduling arithmetic.
-  const foldBarUsage = (ctx: any): Pick<FoldBarModel, "share" | "commitShare" | "aimShare"> => {
+  const foldBarUsage = (ctx: any): Pick<FoldBarModel, "share" | "percent" | "commitShare" | "aimShare"> => {
     let usage: unknown;
     try { usage = ctx.getContextUsage?.(); } catch { }
     const reportedWindow = ownValue(usage, "contextWindow");
@@ -778,7 +778,8 @@ export function registerActiveContext(pi: any, options: {
       usedTokens: null,
     });
     const budgetShare = capacity.budgetTokens / window;
-    return { share, commitShare: thresholds.maxTarget * budgetShare,
+    return { share, percent: share === null ? null : percent as number,
+      commitShare: thresholds.maxTarget * budgetShare,
       aimShare: thresholds.minTarget * budgetShare };
   };
   const installFoldBar = (ctx: any): void => {
@@ -802,7 +803,8 @@ export function registerActiveContext(pi: any, options: {
     }, { placement: "belowEditor" });
   };
   const foldBarModel = (ctx: any, input: {
-    share: number | null; commitShare: number; aimShare: number; staged: number; weighed: boolean;
+    share: number | null; percent?: number | null;
+    commitShare: number; aimShare: number; staged: number; weighed: boolean;
   }): FoldBarModel => {
     const state = persistence.state;
     // THE SAME SNAPSHOT /fold-status PRICES AGAINST. `markFreedBytes` answers ZERO, silently,
@@ -816,6 +818,7 @@ export function registerActiveContext(pi: any, options: {
     const model: FoldBarModel = {
       brand: brandNoun,
       share: input.share,
+      percent: input.percent,
       commitShare: input.commitShare,
       aimShare: input.aimShare,
       mapped: false, mass: emptyFoldBarMass(),
@@ -914,7 +917,7 @@ export function registerActiveContext(pi: any, options: {
       if (ladder.automaticFailure) parts.push("FOLDING STOPPED");
       // Unmeasured is stated, never guessed: an estimate rendered as a fact is the habit
       // that cost a live session, and this line is the most-read surface there is.
-      parts.push(share === null ? "not measured" : `${Math.round(share * 100)}% full`);
+      parts.push(share === null ? "not measured" : `${Math.floor(usage.percent ?? share * 100)}% full`);
       // THE LIVE BAND, NOT THE LAST SNAPSHOT'S (2026-08-29). This read the threshold off
       // `lifecycle.latestSnapshot`, which is derived per context event, so a band changed
       // in /fold-settings went on being announced at its old value until the next event

package/extensions/lib/status-widget.ts

@@ -254,6 +254,8 @@ export function foldBarShades(palette: FoldBarPalette, dark: boolean): Record<Fo
 export interface FoldBarModel {
   brand: string;
   share: number | null;
+  /** Pi's original percent avoids round-trip drift when flooring the usage label. */
+  percent?: number | null;
   commitShare: number;
   aimShare: number;
   /** Estimated visible mass, counted exactly once, in the category order above. */
@@ -355,7 +357,7 @@ export function renderFoldBar(model: FoldBarModel, width: number, theme: FoldBar
   const muted = (text: string): string => theme.fg("muted", text);
   const brand = theme.fg("dim", model.brand);
   if (model.stopped) return cut(`${brand} ${theme.fg("error", theme.bold("FOLDING STOPPED"))}` +
-    (model.share === null ? "" : neutral(` · ${Math.round(model.share * 100)}% full`)));
+    (model.share === null ? "" : neutral(` · ${Math.floor(model.percent ?? model.share * 100)}% full`)));
   if (model.share === null) return cut(`${brand} ${muted(`not measured yet · folds automatically at ${Math.round(model.commitShare * 100)}%`)}`);
   const truecolorMode = theme.getColorMode?.() === "truecolor";
   const dark = !lightBackground(theme);
@@ -429,7 +431,7 @@ export function renderFoldBar(model: FoldBarModel, width: number, theme: FoldBar
       bar += bg ? `${bg}${ink(left as FoldBarKind, "▌")}\x1b[49m` : solid(left);
     }
   }
-  const pct = Math.round(model.share * 100);
+  const pct = Math.floor(model.percent ?? model.share * 100);
   const parts: string[] = [];
   if (model.staleAfterCommit) parts.push(muted(`${pct}% before the commit`));
   else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-fold",
-  "version": "4.2.2",
+  "version": "4.2.3",
   "description": "Lossless context folding for the Pi coding agent: only the oldest context changes; the fresh window stays untouched.",
   "keywords": [
     "pi-package",