@maxiaochao/pi-toolkit 0.9.1 → 0.9.2

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2026-09-30 - v0.9.2
+
+- show contiguous queue positions in the todo widget while retaining stable internal task IDs
+
 ## 2026-09-30 - v0.9.1
 
 - redesign the todo lifecycle with plan replacement, cancellation, automatic advancement, active-only widget rendering, concise model guidance, and deterministic state tests

package/README.md

@@ -38,7 +38,7 @@ To synchronize the file directly from a checkout instead:
 bash scripts/install.sh
 ```
 
-The `todo` tool maintains a session checklist for explicit plans and multi-step work. It automatically keeps one task active and advances the next queued task; `replace` starts a clean plan after a change of direction, while `cancelled` records obsolete work honestly. The persistent widget shows active work only, and `/todos` shows active and closed tasks in the current plan.
+The `todo` tool maintains a session checklist for explicit plans and multi-step work. It automatically keeps one task active and advances the next queued task; `replace` starts a clean plan after a change of direction, while `cancelled` records obsolete work honestly. The persistent widget numbers active work by queue position; `/todos` shows active and closed tasks with their stable internal IDs.
 
 The `/btw` side chat is a separate agent session. It can inspect the main conversation and repository, and its thread stays out of the main context until you close it and choose to inject a summary. Use `/btw` to open it or `/btw <question>` to ask directly. While the BTW overlay has focus, use `Up` / `Down` to scroll its transcript one line at a time and `PageUp` / `PageDown` to move by one transcript page.
 

package/extensions/tests/todo-state.mjs

@@ -1,5 +1,6 @@
 import assert from "node:assert/strict";
 import {
+	activeTodoRows,
 	activeTodos,
 	applyTodoAction,
 	restoreTodoState,
@@ -7,6 +8,19 @@ import {
 
 const empty = { todos: [], nextId: 1 };
 
+assert.deepEqual(
+	activeTodoRows([
+		{ id: 8, text: "closed", status: "done" },
+		{ id: 9, text: "current", status: "doing" },
+		{ id: 11, text: "next", status: "todo" },
+	]).map(({ position, todo }) => ({ position, id: todo.id })),
+	[
+		{ position: 1, id: 9 },
+		{ position: 2, id: 11 },
+	],
+	"active rows expose contiguous queue positions independently of internal IDs",
+);
+
 const replaced = applyTodoAction(empty, {
 	action: "replace",
 	items: ["Inspect the failure", "Implement the fix", "Run verification"],

package/extensions/todo-state.ts

@@ -19,6 +19,11 @@ export interface TodoState {
 	nextId: number;
 }
 
+export interface ActiveTodoRow {
+	position: number;
+	todo: Todo;
+}
+
 export interface TodoActionInput {
 	action: TodoAction;
 	text?: string;
@@ -73,6 +78,10 @@ export function activeTodos(todos: Todo[]): Todo[] {
 	return todos.filter((todo) => todo.status === "doing" || todo.status === "todo");
 }
 
+export function activeTodoRows(todos: Todo[]): ActiveTodoRow[] {
+	return activeTodos(todos).map((todo, index) => ({ position: index + 1, todo }));
+}
+
 function cloneState(state: TodoState): TodoState {
 	return { todos: state.todos.map((todo) => ({ ...todo })), nextId: state.nextId };
 }

package/extensions/todo.ts

@@ -9,7 +9,7 @@ import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-c
 import { matchesKey, Text, truncateToWidth } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import {
-	activeTodos,
+	activeTodoRows,
 	applyTodoAction,
 	countTodoStatuses,
 	normalizeTodo,
@@ -80,6 +80,11 @@ function renderTodoLine(theme: Theme, todo: Todo): string {
 	return `${icon} ${theme.fg("accent", `#${todo.id}`)} ${theme.fg("text", todo.text)}`;
 }
 
+function renderActiveTodoLine(theme: Theme, todo: Todo, position: number): string {
+	const icon = themedStatus(theme, todo.status, statusMarker(todo.status));
+	return `${icon} ${theme.fg("accent", `${position}.`)} ${theme.fg("text", todo.text)}`;
+}
+
 class TodoListComponent {
 	private cachedWidth?: number;
 	private cachedLines?: string[];
@@ -134,7 +139,7 @@ export default function (pi: ExtensionAPI) {
 
 	const refreshUI = (ctx: ExtensionContext) => {
 		if (!ctx.hasUI) return;
-		const visible = activeTodos(state.todos);
+		const visible = activeTodoRows(state.todos);
 		if (visible.length === 0) {
 			ctx.ui.setWidget(WIDGET_KEY, undefined);
 			return;
@@ -146,7 +151,7 @@ export default function (pi: ExtensionAPI) {
 				render(width: number): string[] {
 					return [
 						truncateToWidth(`${theme.fg("accent", "●")} ${theme.fg("muted", taskSummary(state.todos))}`, width),
-						...sortedTodos(visible).map((todo) => truncateToWidth(`  ${renderTodoLine(theme, todo)}`, width)),
+						...visible.map(({ position, todo }) => truncateToWidth(`  ${renderActiveTodoLine(theme, todo, position)}`, width)),
 					];
 				},
 				invalidate() {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxiaochao/pi-toolkit",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Personal pi coding agent toolkit: /todos, /btw, /cache_export and apply_patch extensions, browser automation, and bundled theme/skills.",
   "type": "module",
   "keywords": [