pi-quests 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-05-26
+
+- feat: migrate to `@earendil-works`
+- feat: remove the nudge-based acknowledgement system
+
 ## [0.7.0] - 2026-04-26
 
 - feat: add batch toggle and batch delete support for quests (#2) — @pascal-de-ladurantaye

package/README.md

@@ -1,6 +1,6 @@
 # pi-quests
 
-[![version 0.7.0](https://img.shields.io/badge/version-0.7.0-blue)](CHANGELOG.md)
+[![version 0.8.0](https://img.shields.io/badge/version-0.8.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.7.0",
+  "version": "0.8.0",
   "description": "A quest-log for your pi. Keep your agent on track, one quest at a time.",
   "type": "module",
   "keywords": [
@@ -32,15 +32,15 @@
     "LICENSE.md"
   ],
   "peerDependencies": {
-    "@mariozechner/pi-ai": "*",
-    "@mariozechner/pi-coding-agent": "*",
-    "@mariozechner/pi-tui": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.13",
-    "@mariozechner/pi-coding-agent": "^0.70.2",
-    "@mariozechner/pi-tui": "^0.70.2",
+    "@earendil-works/pi-coding-agent": "^0.75.5",
+    "@earendil-works/pi-tui": "^0.75.5",
     "typebox": "^1.1.33",
     "typescript": "^6.0.3",
     "vitest": "^4.1.5"

package/src/commands/handler.ts

@@ -3,7 +3,7 @@ import type {
   ExtensionAPI,
   ExtensionCommandContext,
   ExtensionContext,
-} from "@mariozechner/pi-coding-agent";
+} from "@earendil-works/pi-coding-agent";
 import type { ResolvedConfig } from "../config.js";
 import { logger } from "../logger.js";
 import type { QuestAction, QuestLog } from "../quest/dataplane.js";

package/src/config.ts

@@ -1,53 +1,17 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
-import { getAgentDir } from "@mariozechner/pi-coding-agent";
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
 
 export interface ResolvedConfig {
   ids: { length: number };
   display: { pageSize: number; progressBarMaxWidth: number; icon: string; showStatus: boolean };
-  nudges: {
-    enable: boolean;
-    toolCallThreshold: number;
-    hintIntervalMinutes: number;
-    timeBasedToolCallThreshold: number;
-    zeroActiveToolCallThreshold: number;
-    staleProgressToolCallThreshold: number;
-    stepSuggestionToolCallThreshold: number;
-    complexTaskKeywords: string[];
-  };
-  validation: { fakeDonePattern: string };
   shortcuts?: { openQuests?: string };
 }
 
-export const DEFAULT_COMPLEX_TASK_KEYWORDS = [
-  "implement",
-  "refactor",
-  "investigate",
-  "analyze",
-  "audit",
-  "design",
-  "fix",
-  "plan",
-  "build",
-] as const;
-
-export const DEFAULT_FAKE_DONE_PATTERN = String.raw`\s[-\u2013\u2014]\s*(DONE|COMPLETED|FINISHED)$|\s[([](DONE|COMPLETED|FINISHED)[)\]]$`;
-
 export const DEFAULT_CONFIG: ResolvedConfig = {
   ids: { length: 2 },
   display: { pageSize: 10, progressBarMaxWidth: 24, icon: "󰣏", showStatus: true },
-  nudges: {
-    enable: true,
-    toolCallThreshold: 8,
-    hintIntervalMinutes: 4,
-    timeBasedToolCallThreshold: 8,
-    zeroActiveToolCallThreshold: 8,
-    staleProgressToolCallThreshold: 12,
-    stepSuggestionToolCallThreshold: 10,
-    complexTaskKeywords: [...DEFAULT_COMPLEX_TASK_KEYWORDS],
-  },
-  validation: { fakeDonePattern: DEFAULT_FAKE_DONE_PATTERN },
   shortcuts: {},
 };
 
@@ -119,30 +83,6 @@ export function getConfig(ctx: Pick<ExtensionContext, "cwd">): ResolvedConfig {
       icon: user.display?.icon ?? DEFAULT_CONFIG.display.icon,
       showStatus: user.display?.showStatus ?? DEFAULT_CONFIG.display.showStatus,
     },
-    nudges: {
-      enable: user.nudges?.enable ?? DEFAULT_CONFIG.nudges.enable,
-      toolCallThreshold: user.nudges?.toolCallThreshold ?? DEFAULT_CONFIG.nudges.toolCallThreshold,
-      hintIntervalMinutes:
-        user.nudges?.hintIntervalMinutes ?? DEFAULT_CONFIG.nudges.hintIntervalMinutes,
-      timeBasedToolCallThreshold:
-        user.nudges?.timeBasedToolCallThreshold ?? DEFAULT_CONFIG.nudges.timeBasedToolCallThreshold,
-      zeroActiveToolCallThreshold:
-        user.nudges?.zeroActiveToolCallThreshold ??
-        DEFAULT_CONFIG.nudges.zeroActiveToolCallThreshold,
-      staleProgressToolCallThreshold:
-        user.nudges?.staleProgressToolCallThreshold ??
-        DEFAULT_CONFIG.nudges.staleProgressToolCallThreshold,
-      stepSuggestionToolCallThreshold:
-        user.nudges?.stepSuggestionToolCallThreshold ??
-        DEFAULT_CONFIG.nudges.stepSuggestionToolCallThreshold,
-      complexTaskKeywords: [
-        ...(user.nudges?.complexTaskKeywords ?? DEFAULT_CONFIG.nudges.complexTaskKeywords),
-      ],
-    },
-    validation: {
-      fakeDonePattern:
-        user.validation?.fakeDonePattern ?? DEFAULT_CONFIG.validation.fakeDonePattern,
-    },
     shortcuts: {
       openQuests: user.shortcuts?.openQuests,
     },

package/src/index.ts

@@ -1,6 +1,5 @@
-import type { UserMessage } from "@mariozechner/pi-ai";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import type { KeyId } from "@mariozechner/pi-tui";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { KeyId } from "@earendil-works/pi-tui";
 import { createQuestsHandler, openQuestList } from "./commands/handler.js";
 import { DEFAULT_CONFIG, getConfig, type ResolvedConfig } from "./config.js";
 import { logger } from "./logger.js";
@@ -24,12 +23,9 @@ import { registerQuestTool } from "./tools/handler.js";
 const NO_QUESTS_REMINDER =
   "No active quests. Use the learn_quests tool to understand how to use quests and use quests to track this task. DO THIS NOW and acknowledge it.";
 
-const FAKE_DONE_REMINDER =
-  "QUEST REMINDER: A quest has a completion marker appended to its description but is not toggled done. Use the list action to find it, then toggle it done. NEVER append completion markers via update.";
-
 export default function (pi: ExtensionAPI): void {
   let questLog = new QuestLog();
-  let tracker = new QuestUsageTracker(DEFAULT_CONFIG);
+  let tracker = new QuestUsageTracker();
   let config: ResolvedConfig = DEFAULT_CONFIG;
   let statusWidget = new QuestStatusWidget(
     DEFAULT_CONFIG.display.icon,
@@ -56,7 +52,7 @@ export default function (pi: ExtensionAPI): void {
   pi.on("session_start", async (_event, ctx) => {
     config = getConfig(ctx);
     questLog = new QuestLog(config);
-    tracker = new QuestUsageTracker(config);
+    tracker = new QuestUsageTracker();
     statusWidget = new QuestStatusWidget(config.display.icon, config.display.showStatus);
     questLog.reconstructFromSession(ctx);
     if (questLog.getAll().length > 0) tracker.markQuestToolUsed();
@@ -79,8 +75,6 @@ export default function (pi: ExtensionAPI): void {
     statusWidget.update(questLog, ctx.ui, ctx.ui.theme);
   });
 
-  pi.on("turn_start", async () => tracker.clearTurnNudge());
-
   pi.on("tool_execution_end", async (event, ctx) => {
     tracker.onToolExecution(event.toolName);
     if (event.toolName === "quest") {
@@ -88,38 +82,6 @@ export default function (pi: ExtensionAPI): void {
     }
   });
 
-  pi.on("context", async (event) => {
-    if (!config.nudges.enable) return undefined;
-    const latestPrompt = event.messages
-      .filter((m) => m.role === "user")
-      .map((m) => (typeof m.content === "string" ? m.content : ""))
-      .join("\n");
-
-    const allQuests = questLog.getAll();
-    const activeQuests = allQuests.filter((q) => !q.done);
-    const activeQuestCount = activeQuests.length;
-    const activeTopLevel = activeQuests.filter((q) => !(q as { parentId?: string }).parentId);
-    const hasTopLevelQuestWithoutSubs = activeTopLevel.some(
-      (q) => !allQuests.some((step) => (step as { parentId?: string }).parentId === q.id),
-    );
-    const nudge = tracker.getNudge(activeQuestCount, latestPrompt, hasTopLevelQuestWithoutSubs);
-
-    const fakeDoneRegex = new RegExp(config.validation.fakeDonePattern, "i");
-    const fakeDone = questLog.getAll().find((q) => !q.done && fakeDoneRegex.test(q.description));
-    if (!nudge && !fakeDone) return undefined;
-
-    const parts: string[] = [];
-    if (nudge) parts.push(nudge);
-    if (fakeDone) parts.push(FAKE_DONE_REMINDER);
-
-    const reminder: UserMessage = {
-      role: "user",
-      content: parts.join("\n"),
-      timestamp: Date.now(),
-    };
-    return { messages: [...event.messages, reminder] };
-  });
-
   pi.on("before_agent_start", async (event) => {
     if (questLog.getAll().length === 0)
       return {

package/src/quest/dataplane.ts

@@ -1,4 +1,4 @@
-import type { AgentToolResult, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import type { AgentToolResult, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { DEFAULT_CONFIG, type ResolvedConfig } from "../config.js";
 import { logger } from "../logger.js";
 import { getQuestSkillDocument } from "../prompts.js";

package/src/quest/tracker.ts

@@ -1,34 +1,32 @@
-import type { ResolvedConfig } from "../config.js";
-import { logger } from "../logger.js";
-
-const ACKNOWLEDGEMENT = "Update your quest status before continuing.";
-
-type NudgeCandidate = { index: number; message: string };
+export interface QuestUsageStats {
+  readonly totalToolCalls: number;
+  readonly questToolCalls: number;
+  readonly nonQuestToolCalls: number;
+  readonly consecutiveNonQuestToolCalls: number;
+  readonly hasUsedQuestTool: boolean;
+  readonly lastQuestToolTimestamp: number | undefined;
+}
 
 export class QuestUsageTracker {
   private totalToolCalls = 0;
+  private questToolCalls = 0;
+  private nonQuestToolCalls = 0;
   private consecutiveNonQuestToolCalls = 0;
   private hasEverUsedQuestTool = false;
-  private lastQuestToolTime = 0;
-  private nudgedThisTurn = false;
-  private lastNudgeTime = 0;
-  private lastNudgeIndex = -1;
-
-  constructor(private readonly config: ResolvedConfig) {}
+  private lastQuestToolTimestamp: number | undefined;
 
   onToolExecution(toolName: string): void {
     this.totalToolCalls++;
     if (toolName === "quest") {
+      this.questToolCalls++;
       this.hasEverUsedQuestTool = true;
-      this.lastQuestToolTime = Date.now();
+      this.lastQuestToolTimestamp = Date.now();
       this.consecutiveNonQuestToolCalls = 0;
-    } else {
-      this.consecutiveNonQuestToolCalls++;
+      return;
     }
-  }
 
-  clearTurnNudge(): void {
-    this.nudgedThisTurn = false;
+    this.nonQuestToolCalls++;
+    this.consecutiveNonQuestToolCalls++;
   }
 
   get hasUsedQuestTool(): boolean {
@@ -37,141 +35,17 @@ export class QuestUsageTracker {
 
   markQuestToolUsed(): void {
     this.hasEverUsedQuestTool = true;
-    this.lastQuestToolTime = Date.now();
-  }
-
-  getNudge(
-    activeQuestCount: number,
-    latestPrompt?: string,
-    hasTopLevelQuestWithoutSubs?: boolean,
-  ): string | undefined {
-    if (this.nudgedThisTurn) {
-      logger.debug("quests:tracker", "nudge-suppressed", { reason: "turn-limit" });
-      return undefined;
-    }
-
-    const now = Date.now();
-    const cooldownMs = this.config.nudges.hintIntervalMinutes * 60 * 1000;
-    if (this.lastNudgeTime > 0 && now - this.lastNudgeTime < cooldownMs) {
-      logger.debug("quests:tracker", "nudge-suppressed", {
-        reason: "cooldown",
-        elapsed: now - this.lastNudgeTime,
-        cooldownMs,
-      });
-      return undefined;
-    }
-
-    const eligible = this.getEligibleNudges(
-      activeQuestCount,
-      latestPrompt,
-      hasTopLevelQuestWithoutSubs,
-    );
-
-    logger.debug("quests:tracker", "nudge-candidates", {
-      eligible: eligible.length,
-      indices: eligible.map((c) => c.index),
-    });
-
-    // Rotate priority: start checking from the nudge after the last one that fired
-    const rotated = [
-      ...eligible.filter((n) => n.index > this.lastNudgeIndex),
-      ...eligible.filter((n) => n.index <= this.lastNudgeIndex),
-    ];
-
-    const winner = rotated[0];
-    if (winner) {
-      this.nudgedThisTurn = true;
-      this.lastNudgeTime = now;
-
-      logger.debug("quests:tracker", "nudge-fired", {
-        winner: winner.index,
-        rotatedFrom: this.lastNudgeIndex,
-      });
-      this.lastNudgeIndex = winner.index;
-      return winner.message;
-    }
-
-    return undefined;
-  }
-
-  private getEligibleNudges(
-    activeQuestCount: number,
-    latestPrompt?: string,
-    hasTopLevelQuestWithoutSubs?: boolean,
-  ): NudgeCandidate[] {
-    const candidates: NudgeCandidate[] = [];
-
-    // 0. Initialization nudge
-    if (this.totalToolCalls >= this.config.nudges.toolCallThreshold && !this.hasEverUsedQuestTool) {
-      candidates.push({
-        index: 0,
-        message: `QUEST REMINDER: You have made multiple tool calls but have NEVER used the quest tool this session. USE the quest tool to initialize tracking and break your work into concrete steps. ${ACKNOWLEDGEMENT}`,
-      });
-    }
-
-    // 1. Complex-task entrypoint nudge
-    if (activeQuestCount === 0 && latestPrompt && this.isComplexPrompt(latestPrompt)) {
-      candidates.push({
-        index: 1,
-        message: `QUEST REMINDER: Your latest prompt looks like a complex task, but there are 0 active quests. USE the quest tool to break it into concrete, trackable steps. ${ACKNOWLEDGEMENT}`,
-      });
-    }
-
-    // 2. Time-based alignment nudge
-    if (
-      this.hasEverUsedQuestTool &&
-      this.lastQuestToolTime > 0 &&
-      this.consecutiveNonQuestToolCalls >= this.config.nudges.timeBasedToolCallThreshold &&
-      Date.now() - this.lastQuestToolTime >= this.config.nudges.hintIntervalMinutes * 60 * 1000
-    ) {
-      candidates.push({
-        index: 2,
-        message: `QUEST REMINDER: It has been a while since your last quest tool use and many tools have been called since then. ALIGN on quest status before continuing. ${ACKNOWLEDGEMENT}`,
-      });
-    }
-
-    // 3. Zero-active sustained-work nudge
-    if (
-      this.consecutiveNonQuestToolCalls >= this.config.nudges.zeroActiveToolCallThreshold &&
-      activeQuestCount === 0
-    ) {
-      candidates.push({
-        index: 3,
-        message: `QUEST REMINDER: You have made several consecutive tool calls without using the quest tool and there are 0 active quests. TRACK your work with specific, actionable quests. ${ACKNOWLEDGEMENT}`,
-      });
-    }
-
-    // 4. Sub-quest suggestion nudge
-    if (
-      this.hasEverUsedQuestTool &&
-      this.consecutiveNonQuestToolCalls >= this.config.nudges.stepSuggestionToolCallThreshold &&
-      activeQuestCount > 0 &&
-      hasTopLevelQuestWithoutSubs
-    ) {
-      candidates.push({
-        index: 4,
-        message: `QUEST REMINDER: You have made several consecutive tool calls without using the quest tool and have active top-level quests without steps. Consider whether decomposing them with the \`split\` action would help track progress. ${ACKNOWLEDGEMENT}`,
-      });
-    }
-
-    // 5. Stale-progress sustained-work nudge (with time-gate)
-    if (
-      this.consecutiveNonQuestToolCalls >= this.config.nudges.staleProgressToolCallThreshold &&
-      activeQuestCount > 0 &&
-      this.lastQuestToolTime > 0 &&
-      Date.now() - this.lastQuestToolTime >= this.config.nudges.hintIntervalMinutes * 60 * 1000
-    ) {
-      candidates.push({
-        index: 5,
-        message: `QUEST REMINDER: You have made many consecutive tool calls without using the quest tool despite having active quests. UPDATE your quest progress to reflect current status. ${ACKNOWLEDGEMENT}`,
-      });
-    }
-
-    return candidates;
+    this.lastQuestToolTimestamp = Date.now();
   }
 
-  private isComplexPrompt(prompt: string): boolean {
-    const lower = prompt.toLowerCase();
-    return this.config.nudges.complexTaskKeywords.some((kw) => lower.includes(kw));
+  getStats(): QuestUsageStats {
+    return {
+      totalToolCalls: this.totalToolCalls,
+      questToolCalls: this.questToolCalls,
+      nonQuestToolCalls: this.nonQuestToolCalls,
+      consecutiveNonQuestToolCalls: this.consecutiveNonQuestToolCalls,
+      hasUsedQuestTool: this.hasEverUsedQuestTool,
+      lastQuestToolTimestamp: this.lastQuestToolTimestamp,
+    };
   }
 }

package/src/renderers/changelog.ts

@@ -1,7 +1,7 @@
-import type { MessageRenderer, MessageRenderOptions, Theme } from "@mariozechner/pi-coding-agent";
-import { getMarkdownTheme } from "@mariozechner/pi-coding-agent";
-import type { Component } from "@mariozechner/pi-tui";
-import { Markdown } from "@mariozechner/pi-tui";
+import type { MessageRenderer, MessageRenderOptions, Theme } from "@earendil-works/pi-coding-agent";
+import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import type { Component } from "@earendil-works/pi-tui";
+import { Markdown } from "@earendil-works/pi-tui";
 import { logger } from "../logger.js";
 
 export const questChangelogRenderer: MessageRenderer<{ content: string }> = (

package/src/renderers/commands.ts

@@ -1,5 +1,5 @@
-import type { Theme } from "@mariozechner/pi-coding-agent";
-import { Key, matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { ResolvedConfig } from "../config.js";
 import { logger } from "../logger.js";
 import type { QuestLog } from "../quest/dataplane.js";

package/src/renderers/quests.ts

@@ -1,5 +1,5 @@
-import type { Theme } from "@mariozechner/pi-coding-agent";
-import { visibleWidth } from "@mariozechner/pi-tui";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { visibleWidth } from "@earendil-works/pi-tui";
 import type { Quest, Step } from "../quest/types.js";
 
 export function formatQuestRow(

package/src/renderers/status.ts

@@ -1,4 +1,4 @@
-import type { Theme } from "@mariozechner/pi-coding-agent";
+import type { Theme } from "@earendil-works/pi-coding-agent";
 import type { QuestLog } from "../quest/dataplane.js";
 
 export class QuestStatusWidget {

package/src/renderers/tools.ts

@@ -1,5 +1,5 @@
-import type { AgentToolResult, Theme } from "@mariozechner/pi-coding-agent";
-import { Text } from "@mariozechner/pi-tui";
+import type { AgentToolResult, Theme } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
 import type { ResolvedConfig } from "../config.js";
 import { logger } from "../logger.js";
 import type { Quest } from "../quest/types.js";

package/src/tools/handler.ts

@@ -1,4 +1,4 @@
-import type { AgentToolResult, ExtensionAPI, Theme } from "@mariozechner/pi-coding-agent";
+import type { AgentToolResult, ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
 import { type Static, Type } from "typebox";
 import type { ResolvedConfig } from "../config.js";
 import { logger } from "../logger.js";

package/src/tools/params.ts

@@ -1,4 +1,4 @@
-import { StringEnum } from "@mariozechner/pi-ai";
+import { StringEnum } from "@earendil-works/pi-ai";
 import { Type } from "typebox";
 import { QUEST_ACTION_VALUES } from "../quest/types.js";