pi-quests 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-04-17
+
+- feat: add footer quest progress indicator with configurable icon
+- fix: quest list widget cache invalidation
+
 ## [0.5.1] - 2026-04-17
 
 - fix: add context signals and calibrate nudge thresholds

package/README.md

@@ -1,6 +1,6 @@
 # pi-quests
 
-[![version 0.5.1](https://img.shields.io/badge/version-0.5.1-blue)](CHANGELOG.md)
+[![version 0.6.0](https://img.shields.io/badge/version-0.6.0-blue)](CHANGELOG.md)
 [![MIT license](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)
 [![pi extension](https://img.shields.io/badge/pi-extension-purple)](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-quests",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "A quest-log for your pi. Keep your agent on track, one quest at a time.",
   "type": "module",
   "keywords": [

package/src/commands/handler.ts

@@ -8,7 +8,7 @@ import type { ResolvedConfig } from "../config.js";
 import { logger } from "../logger.js";
 import type { QuestAction, QuestLog } from "../quest/dataplane.js";
 import { QUEST_ACTIONS } from "../quest/types.js";
-import { QuestListWidget } from "../renderers/commands.js";
+import { invalidateQuestListWidget, QuestListWidget } from "../renderers/commands.js";
 import { CHANGELOG_PATH, getVersion } from "../version.js";
 import { reverseChangelog } from "./changelog.js";
 import { type ParsedArgs, parseQuestArgs } from "./parse-args.js";
@@ -73,7 +73,12 @@ export function openQuestList(
   );
 }
 
-export function createQuestsHandler(pi: ExtensionAPI, questLog: QuestLog, config: ResolvedConfig) {
+export function createQuestsHandler(
+  pi: ExtensionAPI,
+  questLog: QuestLog,
+  config: ResolvedConfig,
+  onMutate?: (ctx: ExtensionCommandContext) => void,
+) {
   return async function handler(args: string, ctx: ExtensionCommandContext): Promise<void> {
     logger.debug("quests:cmd", "handler", { args, hasUI: ctx.hasUI });
 
@@ -144,6 +149,8 @@ export function createQuestsHandler(pi: ExtensionAPI, questLog: QuestLog, config
         const result = questLog.execute(action);
 
         logger.debug("quests:cmd", parsed.action, { success: result.success });
+        invalidateQuestListWidget();
+        onMutate?.(ctx);
         ctx.ui.notify(result.message, result.success ? "info" : "error");
         return;
       }

package/src/config.ts

@@ -5,7 +5,7 @@ import { getAgentDir } from "@mariozechner/pi-coding-agent";
 
 export interface ResolvedConfig {
   ids: { length: number };
-  display: { pageSize: number; progressBarMaxWidth: number };
+  display: { pageSize: number; progressBarMaxWidth: number; icon: string };
   nudges: {
     toolCallThreshold: number;
     hintIntervalMinutes: number;
@@ -35,7 +35,7 @@ export const DEFAULT_FAKE_DONE_PATTERN = String.raw`\s[-\u2013\u2014]\s*(DONE|CO
 
 export const DEFAULT_CONFIG: ResolvedConfig = {
   ids: { length: 2 },
-  display: { pageSize: 10, progressBarMaxWidth: 24 },
+  display: { pageSize: 10, progressBarMaxWidth: 24, icon: "󰣏" },
   nudges: {
     toolCallThreshold: 8,
     hintIntervalMinutes: 4,
@@ -114,6 +114,7 @@ export function getConfig(ctx: Pick<ExtensionContext, "cwd">): ResolvedConfig {
       pageSize: user.display?.pageSize ?? DEFAULT_CONFIG.display.pageSize,
       progressBarMaxWidth:
         user.display?.progressBarMaxWidth ?? DEFAULT_CONFIG.display.progressBarMaxWidth,
+      icon: user.display?.icon ?? DEFAULT_CONFIG.display.icon,
     },
     nudges: {
       toolCallThreshold: user.nudges?.toolCallThreshold ?? DEFAULT_CONFIG.nudges.toolCallThreshold,

package/src/index.ts

@@ -9,6 +9,7 @@ import { QuestLog } from "./quest/dataplane.js";
 import { formatQuestList } from "./quest/formatters.js";
 import { QuestUsageTracker } from "./quest/tracker.js";
 import { questChangelogRenderer } from "./renderers/changelog.js";
+import { QuestStatusWidget } from "./renderers/status.js";
 import { registerQuestTool } from "./tools/handler.js";
 
 /**
@@ -25,6 +26,7 @@ export default function (pi: ExtensionAPI): void {
   let questLog = new QuestLog();
   let tracker = new QuestUsageTracker(DEFAULT_CONFIG);
   let config: ResolvedConfig = DEFAULT_CONFIG;
+  let statusWidget = new QuestStatusWidget(DEFAULT_CONFIG.display.icon);
 
   const shortcutKey = getConfig({ cwd: process.cwd() }).shortcuts?.openQuests ?? "ctrl+shift+l";
   logger.debug("quests:shortcut", "register", { key: shortcutKey });
@@ -47,23 +49,33 @@ export default function (pi: ExtensionAPI): void {
     config = getConfig(ctx);
     questLog = new QuestLog(config);
     tracker = new QuestUsageTracker(config);
+    statusWidget = new QuestStatusWidget(config.display.icon);
     questLog.reconstructFromSession(ctx);
+    statusWidget.update(questLog, ctx.ui, ctx.ui.theme);
 
     registerQuestTool(pi, questLog, config);
 
-    const questsHandler = createQuestsHandler(pi, questLog, config);
+    const questsHandler = createQuestsHandler(pi, questLog, config, (ctx) => {
+      statusWidget.update(questLog, ctx.ui, ctx.ui.theme);
+    });
     pi.registerCommand("quests", {
       description: "Quest commands: /quests [help] to see usage",
       handler: questsHandler,
     });
   });
 
-  pi.on("session_tree", async (_event, ctx) => questLog.reconstructFromSession(ctx));
+  pi.on("session_tree", async (_event, ctx) => {
+    questLog.reconstructFromSession(ctx);
+    statusWidget.update(questLog, ctx.ui, ctx.ui.theme);
+  });
 
   pi.on("turn_start", async () => tracker.clearTurnNudge());
 
-  pi.on("tool_execution_end", async (event) => {
+  pi.on("tool_execution_end", async (event, ctx) => {
     tracker.onToolExecution(event.toolName);
+    if (event.toolName === "quest") {
+      statusWidget.update(questLog, ctx.ui, ctx.ui.theme);
+    }
   });
 
   pi.on("context", async (event) => {

package/src/renderers/commands.ts

@@ -5,6 +5,12 @@ import { logger } from "../logger.js";
 import type { QuestLog } from "../quest/dataplane.js";
 import { formatQuestRow, formatStepSpacerLine } from "./quests.js";
 
+let activeQuestListWidget: QuestListWidget | undefined;
+
+export function invalidateQuestListWidget(): void {
+  activeQuestListWidget?.invalidate();
+}
+
 export class QuestListWidget {
   private cachedWidth?: number;
   private cachedLines?: string[];
@@ -17,12 +23,14 @@ export class QuestListWidget {
     private readonly config: ResolvedConfig,
   ) {
     logger.debug("quests:widget", "create", { questCount: questLog.getAll().length });
+    activeQuestListWidget = this;
   }
 
   handleInput(data: string): void {
     logger.debug("quests:widget", "handleInput", { data });
     if (matchesKey(data, Key.escape) || data === "q" || data === "Q") {
       logger.debug("quests:widget", "close");
+      activeQuestListWidget = undefined;
       this.onClose();
       return;
     }
@@ -134,7 +142,7 @@ export class QuestListWidget {
       const barWidth = Math.min(width - 4, this.config.display.progressBarMaxWidth);
       const filled = Math.round((doneCount / total) * barWidth);
       const empty = barWidth - filled;
-      const bar = th.fg("success", "█".repeat(filled)) + th.fg("dim", "░".repeat(empty));
+      const bar = th.fg("success", "▰".repeat(filled)) + th.fg("dim", "▱".repeat(empty));
 
       lines.push(truncateToWidth(`  ${bar}  ${th.fg("muted", `${doneCount}/${total}`)}`, width));
       lines.push("");

package/src/renderers/status.ts

@@ -0,0 +1,34 @@
+import type { Theme } from "@mariozechner/pi-coding-agent";
+import type { QuestLog } from "../quest/dataplane.js";
+
+export class QuestStatusWidget {
+  private readonly key = "pi-quests";
+  private readonly barWidth = 5;
+
+  constructor(private readonly icon: string) {}
+
+  update(
+    questLog: QuestLog,
+    ui: { setStatus(key: string, text: string | undefined): void },
+    theme: Theme,
+  ): void {
+    const all = questLog.getAll();
+    const total = all.length;
+    const done = all.filter((q) => q.done).length;
+
+    const text = this.formatStatus(total, done, theme);
+    ui.setStatus(this.key, text);
+  }
+
+  private formatStatus(total: number, done: number, theme: Theme): string | undefined {
+    if (total === 0) {
+      return undefined;
+    }
+
+    const filled = Math.round((done / total) * this.barWidth);
+    const empty = this.barWidth - filled;
+    const bar = theme.fg("success", "▰".repeat(filled)) + theme.fg("muted", "▱".repeat(empty));
+
+    return `${theme.fg("accent", this.icon)} ${bar} ${theme.fg("dim", `${done}/${total}`)}`;
+  }
+}

package/src/tools/handler.ts

@@ -14,6 +14,7 @@ const SPLIT_DISPLAY_ACTIONS = [
   QUEST_ACTIONS.revert,
 ] as const;
 
+import { invalidateQuestListWidget } from "../renderers/commands.js";
 import { renderQuestCall, renderQuestResult } from "../renderers/tools.js";
 import { createQuestParams, type QuestParamsType } from "./params.js";
 
@@ -96,6 +97,7 @@ function runTool(
   action: QuestAction,
 ): AgentToolResult<unknown> {
   const result = questLog.execute(action);
+  invalidateQuestListWidget();
   logger.debug("quests:tool", "execute-complete", { toolCallId, success: result.success });
 
   const displayQuests = SPLIT_DISPLAY_ACTIONS.includes(