pi-quests 0.6.2 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [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
+- feat: add redo action and rename revert to undo
+- chore: migrate from taskfile to npm scripts and update dependencies
+
 ## [0.6.2] - 2026-04-17
 
 - fix: system prompt was too weak

package/README.md

@@ -1,6 +1,6 @@
 # pi-quests
 
-[![version 0.6.2](https://img.shields.io/badge/version-0.6.2-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.6.2",
+  "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,25 +32,30 @@
     "LICENSE.md"
   ],
   "peerDependencies": {
-    "@mariozechner/pi-ai": "*",
-    "@mariozechner/pi-coding-agent": "*",
-    "@mariozechner/pi-tui": "*",
-    "@sinclair/typebox": "*"
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.10",
-    "@mariozechner/pi-coding-agent": "^0.63.2",
-    "@mariozechner/pi-tui": "^0.63.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "@biomejs/biome": "^2.4.13",
+    "@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"
   },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "style": "biome check ./src ./test",
-    "style:fix": "biome check --write --unsafe --no-errors-on-unmatched ./src ./test",
+    "style": "biome check --error-on-warnings ./src ./test",
+    "style:fix": "biome check --write --unsafe --no-errors-on-unmatched --error-on-warnings ./src ./test",
     "format": "biome format --write --no-errors-on-unmatched ./src ./test",
-    "prepublishOnly": "npx tsc --noEmit && npx vitest run"
+    "prepublishOnly": "npx tsc --noEmit && npx vitest run",
+    "prepare": "bash scripts/setup.sh",
+    "cleanup": "bash scripts/cleanup.sh",
+    "dev": "bash scripts/dev.sh",
+    "logs": "bash scripts/logs.sh"
   }
 }

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";
@@ -25,7 +25,8 @@ type MutatingCommand = Extract<
       | typeof QUEST_ACTIONS.clear
       | typeof QUEST_ACTIONS.reorder
       | typeof QUEST_ACTIONS.reparent
-      | typeof QUEST_ACTIONS.revert;
+      | typeof QUEST_ACTIONS.undo
+      | typeof QUEST_ACTIONS.redo;
   }
 >["action"];
 
@@ -41,13 +42,13 @@ const commandActionBuilders: {
     id: p.id,
     descriptions: p.descriptions,
   }),
-  [QUEST_ACTIONS.toggle]: (p) => ({ type: QUEST_ACTIONS.toggle, id: p.id }),
+  [QUEST_ACTIONS.toggle]: (p) => ({ type: QUEST_ACTIONS.toggle, ids: p.ids }),
   [QUEST_ACTIONS.update]: (p) => ({
     type: QUEST_ACTIONS.update,
     id: p.id,
     description: p.description,
   }),
-  [QUEST_ACTIONS.delete]: (p) => ({ type: QUEST_ACTIONS.delete, id: p.id }),
+  [QUEST_ACTIONS.delete]: (p) => ({ type: QUEST_ACTIONS.delete, ids: p.ids }),
   [QUEST_ACTIONS.clear]: (p) => ({ type: QUEST_ACTIONS.clear, all: p.all }),
   [QUEST_ACTIONS.reorder]: (p) => ({
     type: QUEST_ACTIONS.reorder,
@@ -59,7 +60,8 @@ const commandActionBuilders: {
     id: p.id,
     parentId: p.parentId,
   }),
-  [QUEST_ACTIONS.revert]: () => ({ type: QUEST_ACTIONS.revert }),
+  [QUEST_ACTIONS.undo]: () => ({ type: QUEST_ACTIONS.undo }),
+  [QUEST_ACTIONS.redo]: () => ({ type: QUEST_ACTIONS.redo }),
 };
 
 export function openQuestList(
@@ -143,7 +145,8 @@ export function createQuestsHandler(
       case QUEST_ACTIONS.clear:
       case QUEST_ACTIONS.reorder:
       case QUEST_ACTIONS.reparent:
-      case QUEST_ACTIONS.revert: {
+      case QUEST_ACTIONS.undo:
+      case QUEST_ACTIONS.redo: {
         const builder = commandActionBuilders[parsed.action];
         const action = builder(parsed as never);
         const result = questLog.execute(action);
@@ -161,12 +164,13 @@ export function createQuestsHandler(
         lines.push("  add <description>           - Add a new top-level quest");
         lines.push("  add-step <id> <description> - Split a quest into a step");
         lines.push("  list               - List all quests");
-        lines.push("  toggle <id>        - Toggle quest completion");
-        lines.push("  delete <id>        - Delete a quest");
+        lines.push("  toggle <id> [moreIds...] - Toggle one or more quests");
+        lines.push("  delete <id> [moreIds...] - Delete one or more quests");
         lines.push("  update <id> <desc> - Update a quest description");
         lines.push("  reparent <id> [parentId] - Reparent a quest/step (omit parentId to promote)");
         lines.push("  reorder <id> <targetId> - Reorder a quest before the target quest");
-        lines.push("  revert             - Revert the last quest change");
+        lines.push("  undo               - Undo the last quest change");
+        lines.push("  redo               - Redo the last undone action");
         lines.push("  clear [all]        - Clear completed quests, or optionally all quests");
         lines.push("  version            - Show version");
         lines.push("  changelog          - Show changelog");

package/src/commands/parse-args.ts

@@ -5,12 +5,13 @@ export type ParsedArgs =
   | { action: typeof QUEST_ACTIONS.add; descriptions: string[] }
   | { action: typeof QUEST_ACTIONS.split; id: string; descriptions: string[] }
   | { action: typeof QUEST_ACTIONS.list }
-  | { action: typeof QUEST_ACTIONS.toggle; id: string }
+  | { action: typeof QUEST_ACTIONS.toggle; ids: string[] }
   | { action: typeof QUEST_ACTIONS.update; id: string; description: string }
-  | { action: typeof QUEST_ACTIONS.delete; id: string }
+  | { action: typeof QUEST_ACTIONS.delete; ids: string[] }
   | { action: typeof QUEST_ACTIONS.clear; all?: boolean }
   | { action: typeof QUEST_ACTIONS.reorder; id: string; targetId: string }
-  | { action: typeof QUEST_ACTIONS.revert }
+  | { action: typeof QUEST_ACTIONS.undo }
+  | { action: typeof QUEST_ACTIONS.redo }
   | { action: typeof QUEST_ACTIONS.reparent; id: string; parentId?: string }
   | { action: "help" }
   | { action: "version" }
@@ -40,13 +41,14 @@ export function parseQuestArgs(args: string, idLength = 2): ParsedArgs {
   // Quest actions without arguments
   if (command === QUEST_ACTIONS.list) return { action: QUEST_ACTIONS.list };
   if (command === QUEST_ACTIONS.clear) return parseClearArgs(rest);
-  if (command === QUEST_ACTIONS.revert) return { action: QUEST_ACTIONS.revert };
+  if (command === QUEST_ACTIONS.undo) return { action: QUEST_ACTIONS.undo };
+  if (command === QUEST_ACTIONS.redo) return { action: QUEST_ACTIONS.redo };
 
   // Quest actions with arguments
   if (command === QUEST_ACTIONS.add) return parseAddArgs(rest);
   if (command === "add-step") return parseAddStepArgs(rest, idLength);
-  if (command === QUEST_ACTIONS.toggle) return parseIdAction(QUEST_ACTIONS.toggle, rest, idLength);
-  if (command === QUEST_ACTIONS.delete) return parseIdAction(QUEST_ACTIONS.delete, rest, idLength);
+  if (command === QUEST_ACTIONS.toggle) return parseToggleArgs(rest, idLength);
+  if (command === QUEST_ACTIONS.delete) return parseDeleteArgs(rest, idLength);
   if (command === QUEST_ACTIONS.update) return parseUpdateArgs(rest, idLength);
   if (command === QUEST_ACTIONS.reorder) return parseReorderArgs(rest, idLength);
   if (command === QUEST_ACTIONS.reparent) return parseReparentArgs(rest, idLength);
@@ -70,16 +72,26 @@ function parseAddStepArgs(tokens: string[], idLength: number): ParsedArgs {
   return { action: QUEST_ACTIONS.split, id, descriptions: [description] };
 }
 
-function parseIdAction(
-  action: typeof QUEST_ACTIONS.toggle | typeof QUEST_ACTIONS.delete,
-  tokens: string[],
-  idLength: number,
-): ParsedArgs {
-  const id = tokens[0] ? tokens[0].toLowerCase() : "";
+function parseToggleArgs(tokens: string[], idLength: number): ParsedArgs {
   const pattern = new RegExp(`^[0-9a-f]{${idLength}}$`);
-  if (!pattern.test(id)) return { error: `Usage: /quests ${action} <id>` };
+  const ids = tokens.map((token) => token.toLowerCase());
+
+  if (ids.length === 0 || ids.some((id) => !pattern.test(id))) {
+    return { error: "Usage: /quests toggle <id> [moreIds...]" };
+  }
+
+  return { action: QUEST_ACTIONS.toggle, ids };
+}
+
+function parseDeleteArgs(tokens: string[], idLength: number): ParsedArgs {
+  const pattern = new RegExp(`^[0-9a-f]{${idLength}}$`);
+  const ids = tokens.map((token) => token.toLowerCase());
+
+  if (ids.length === 0 || ids.some((id) => !pattern.test(id))) {
+    return { error: "Usage: /quests delete <id> [moreIds...]" };
+  }
 
-  return { action, id };
+  return { action: QUEST_ACTIONS.delete, ids };
 }
 
 function parseUpdateArgs(tokens: string[], idLength: number): ParsedArgs {

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/prompts/skill.md

@@ -20,7 +20,8 @@ This skill provides guidelines and best practices for using the quest management
 | `clear` | — | Remove completed quests. `all: true` removes everything. |
 | `reorder` | `id`, `targetId` | Move a top-level quest before `targetId`. Steps cannot be reordered. |
 | `reparent` | `id`, `parentId?` | Demote to step under `parentId`, or promote to top-level if `parentId` omitted. |
-| `revert` | — | Undo the most recent mutating action. One level only. |
+| `undo` | — | Undo the most recent mutating action. One level only. |
+| `redo` | — | Redo the most recently undone action. |
 | `rules` / `skill` | — | Return this document. |
 
 ## Workflows
@@ -51,7 +52,8 @@ This skill provides guidelines and best practices for using the quest management
 - NEVER try to nest steps. Only top-level quests can be parents.
 - NEVER mark a parent as done if they have incomplete steps.
 - NEVER delete a quest with incomplete steps.
-- Use revert if you make a mistake to undo an action.
+- Use undo if you make a mistake to undo an action.
+- Use redo to replay an action you just undid. Redo is cleared when a new mutation happens.
 - ALWAYS use the hex ID, never the positional number when referring to quests in actions.
 - ALWAYS Use `toggle` for done states. NEVER use `update` to append "DONE" or any completion marker to a description.
 - If a parent toggle is blocked, check that all its steps are done first.