pi-goal-x 0.32.0 → 0.32.2

package/README.md

@@ -6,7 +6,7 @@
   <a href="https://pi.dev/packages?type=extension" target="_blank" rel="noopener noreferrer">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="assets/badge-dark.svg">
-      <img src="assets/badge-light.svg" alt="TOP 0.2% of Pi coding agent extensions: #6 of 3,258 by downloads · Oct 1, 2026 (best recorded rank)" width="480">
+      <img src="assets/badge-light.svg" alt="TOP 0.2% of Pi coding agent extensions: #6 of 3,177 by downloads · Oct 2, 2026 (best recorded rank)" width="480">
     </picture>
   </a>
 </div>
@@ -19,8 +19,6 @@ The extension saves goal objectives, tasks, and progress across sessions. You ca
 
 ## Install
 
-Supports pi 0.83 through 1.x (`@earendil-works/pi-ai`, `pi-coding-agent`, and `pi-tui` `>=0.83.0 <2.0.0`), developed and verified against 1.0.0.
-
 ```bash
 pi install npm:pi-goal-x
 ```

package/assets/badge-dark.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="480" height="54" viewBox="0 0 480 54" role="img" aria-label="TOP 0.2% of Pi coding agent extensions: #6 of 3,258 by downloads · Oct 1, 2026 (best recorded rank)">
+<svg xmlns="http://www.w3.org/2000/svg" width="480" height="54" viewBox="0 0 480 54" role="img" aria-label="TOP 0.2% of Pi coding agent extensions: #6 of 3,177 by downloads · Oct 2, 2026 (best recorded rank)">
   <!-- Dark mode -->
   <style>
     .frame { fill: #14181f; stroke: #2a3040; stroke-width: 1; }
@@ -13,6 +13,6 @@
     <text class="rank" x="18" y="34">TOP 0.2%</text>
     <line class="divider" x1="128" y1="13" x2="128" y2="41"/>
     <text class="label" x="143" y="25">of Pi coding agent extensions</text>
-    <text class="meta" x="143" y="41">#6 of 3,258 by downloads · Oct 1, 2026</text>
+    <text class="meta" x="143" y="41">#6 of 3,177 by downloads · Oct 2, 2026</text>
   </a>
 </svg>

package/assets/badge-light.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="480" height="54" viewBox="0 0 480 54" role="img" aria-label="TOP 0.2% of Pi coding agent extensions: #6 of 3,258 by downloads · Oct 1, 2026 (best recorded rank)">
+<svg xmlns="http://www.w3.org/2000/svg" width="480" height="54" viewBox="0 0 480 54" role="img" aria-label="TOP 0.2% of Pi coding agent extensions: #6 of 3,177 by downloads · Oct 2, 2026 (best recorded rank)">
   <!-- Light mode -->
   <style>
     .frame { fill: #f6f8fa; stroke: #d0d7de; stroke-width: 1; }
@@ -13,6 +13,6 @@
     <text class="rank" x="18" y="34">TOP 0.2%</text>
     <line class="divider" x1="128" y1="13" x2="128" y2="41"/>
     <text class="label" x="143" y="25">of Pi coding agent extensions</text>
-    <text class="meta" x="143" y="41">#6 of 3,258 by downloads · Oct 1, 2026</text>
+    <text class="meta" x="143" y="41">#6 of 3,177 by downloads · Oct 2, 2026</text>
   </a>
 </svg>

package/extensions/goal-format.ts

@@ -229,14 +229,15 @@ export function isErrorAssistantMessage(message: unknown): boolean {
 /**
  * Transient provider failures are safe for goal-level recovery backoff:
  * Pi-declared network errors plus HTTP 429/5xx-style outages surfaced by
- * providers (429 rate limits, 503 server_error, "Endpoint is unavailable",
- * overloaded, gateway failures). Deliberately excludes auth and
+ * providers (429 rate limits, 503 server_error, HTTP/2 PROTOCOL_ERROR,
+ * "Endpoint is unavailable", overloaded, gateway failures). Deliberately excludes auth and
  * malformed-request failures (and quota/billing text), which retrying
  * cannot fix.
  */
 const TRANSIENT_PROVIDER_ERROR_RE = new RegExp(
 	[
 		"\\bnetwork[_\\s-]?error\\b",
+		"\\bprotocol[_\\s-]?error\\b",
 		"\\bserver[_\\s]?error\\b",
 		"\\b(?:429|502|503|504|529)\\b",
 		"\\brate[_\\s-]?limited\\b",

package/extensions/goal-state.ts

@@ -681,6 +681,7 @@ export function createGoalCore(
 						getExpanded: () => dashboardExpanded,
 						getLedgerEvents: () => state.goal ? goalActivityEvents(storage, state.goal.id) : [],
 						getAuditResult: () => auditResult,
+						componentRef: goalWidgetComponentRef,
 					}),
 					{ placement: "aboveEditor" },
 				);
@@ -711,6 +712,7 @@ export function createGoalCore(
 					getExpanded: () => dashboardExpanded,
 					getLedgerEvents: () => state.goal ? goalActivityEvents(storage, state.goal.id) : [],
 					getAuditResult: () => auditResult,
+					componentRef: goalWidgetComponentRef,
 				}),
 				{ placement: "aboveEditor" },
 			);

package/extensions/goal-widget.ts

@@ -9,6 +9,10 @@ import type { GoalCore } from "./goal-state.ts";
 
 const DEBUG_GOALS_DIR = ".pi/goals/debug";
 
+function isKittyRepeatOrRelease(data: string): boolean {
+	return data.startsWith("\x1b[") && /^[0-9:;]+:[23][u~ABCDHF]$/.test(data.slice(2));
+}
+
 /**
  * Terminal input keybindings (Escape pause/abort-audit, Ctrl+Shift+T dashboard
  * overlay, and the hidden debug-mode bindings) plus the debug goal/task/audit
@@ -111,8 +115,7 @@ export async function toggleTaskViaService(core: GoalCore, ctx: ExtensionContext
 export function syncTerminalInputPause(core: GoalCore, ctx: ExtensionContext): void {
 		if (!ctx.hasUI) return;
 		core.terminalInputUnsubscribe?.();
-		const settings = loadGoalSettings(typeof ctx.cwd === "string" ? ctx.cwd : process.cwd());
-		const keybindings = settings.keybindings?.dashboard ?? DEFAULT_GOAL_KEYBINDINGS.dashboard;
+		const goalCwd = typeof ctx.cwd === "string" ? ctx.cwd : process.cwd();
 		core.terminalInputUnsubscribe = ctx.ui.onTerminalInput((data) => {
 			// If an audit is running, Escape aborts the audit instead of pausing.
 			// Must return { consume: true } so the TUI doesn't also process the key
@@ -128,6 +131,15 @@ export function syncTerminalInputPause(core: GoalCore, ctx: ExtensionContext): v
 			// before the dialog could process it (bn-l pattern). Depth counter so
 			// nested goal modals remain guarded.
 			if (core.goalModalDepth > 0) return undefined;
+			const keybindings = loadGoalSettings(goalCwd).keybindings?.dashboard ?? DEFAULT_GOAL_KEYBINDINGS.dashboard;
+			if (isKittyRepeatOrRelease(data)) {
+				const goalShortcut = matchesKey(data, keybindings.toggleExpand) || matchesKey(data, "ctrl+shift+a") ||
+					(matchesKey(data, "escape") && (core.isDashboardExpanded() || core.state.goal !== null)) ||
+					(core.isDashboardExpanded() && (["up", "down", "pageUp", "pageDown", "home", "end"] as const).some(key => matchesKey(data, key))) ||
+					(!core.isDashboardExpanded() && core.goalWidgetComponentRef.current !== null &&
+						([keybindings.scrollUp, keybindings.scrollDown, "ctrl+shift+pageUp", "ctrl+shift+pageDown", "ctrl+shift+home", "ctrl+shift+end"] as const).some(key => matchesKey(data, key)));
+				return goalShortcut ? { consume: true } : undefined;
+			}
 			if (matchesKey(data, "escape") && core.auditProgress) {
 				core.abortAudit(ctx);
 				return { consume: true };

package/extensions/widgets/goal-widget.ts

@@ -82,20 +82,26 @@ export function makeGoalWidgetFactory(opts: {
 	getExpanded?: () => boolean;
 	getLedgerEvents?: () => GoalLedgerEvent[];
 	getAuditResult?: () => AuditResultView | null;
+	/** Receives the live widget so terminal shortcuts can scroll its viewports. */
+	componentRef?: { current: GoalWidgetComponent | null };
 }) {
-	return (tui: TUI, theme: Theme) => new GoalWidgetComponent({
-		tui,
-		theme,
-		getGoal: opts.getGoal,
-		getOpenGoalCount: opts.getOpenGoalCount,
-		getAuditorProgress: opts.getAuditorProgress,
-		getSettings: opts.getSettings,
-		getDebugMode: opts.getDebugMode,
-		getStalled: opts.getStalled,
-		getExpanded: opts.getExpanded,
-		getLedgerEvents: opts.getLedgerEvents,
-		getAuditResult: opts.getAuditResult,
-	});
+	return (tui: TUI, theme: Theme) => {
+		const component = new GoalWidgetComponent({
+			tui,
+			theme,
+			getGoal: opts.getGoal,
+			getOpenGoalCount: opts.getOpenGoalCount,
+			getAuditorProgress: opts.getAuditorProgress,
+			getSettings: opts.getSettings,
+			getDebugMode: opts.getDebugMode,
+			getStalled: opts.getStalled,
+			getExpanded: opts.getExpanded,
+			getLedgerEvents: opts.getLedgerEvents,
+			getAuditResult: opts.getAuditResult,
+		});
+		if (opts.componentRef) opts.componentRef.current = component;
+		return component;
+	};
 }
 
 export interface AuditorWidgetProgress {
@@ -623,6 +629,7 @@ export class GoalWidgetComponent implements Component {
 	 * list. Returns true when the key was consumed.
 	 */
 	handleCompactScrollKey(key: "up" | "down" | "pageUp" | "pageDown" | "home" | "end"): boolean {
+		if (this.getExpanded()) return false;
 		const settings = this.getSettings();
 		const goal = this.getGoal();
 		const model = goal ? deriveGoalDashboardModel(goal as GoalRecord | null, {
@@ -632,6 +639,7 @@ export class GoalWidgetComponent implements Component {
 			tasksDisabled: settings.disableTasks === true,
 			maxAutonomousRuns: settings.maxAutonomousRuns,
 		}) : null;
+		this.maybeReanchor(model);
 		const list = model?.taskTree.filter((n) => n.depth === 0) ?? [];
 		const rows = compactTaskViewportRows(this.lastRenderWidth);
 		if (list.length <= rows) return false;
@@ -667,11 +675,12 @@ export class GoalWidgetComponent implements Component {
 			tasksDisabled: settings.disableTasks === true,
 			maxAutonomousRuns: settings.maxAutonomousRuns,
 		}) : null;
+		this.maybeReanchor(model);
 		const list = model?.taskTree ?? [];
 		if (list.length === 0) return false;
 		const rows = expandedTaskViewportRows(this.lastRenderWidth);
 		const maxO = maxScrollOffset(list.length, rows);
-		if (maxO <= 0) return false;
+		if (maxO <= 0) return true;
 		let offset = clampScrollOffset(this.expandedScrollOffset, list.length, rows);
 		if (key === "up") offset -= 1;
 		else if (key === "down") offset += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goal-x",
-  "version": "0.32.0",
+  "version": "0.32.2",
   "description": "Adds /goal to pi: conversational goal planning, flexible or ordered goals, persistent progress, and an independent completion auditor.",
   "license": "MIT",
   "author": "pi-goal-x contributors",