pi-task-tracker 0.1.6 → 0.1.7

package/README.md

@@ -17,7 +17,34 @@ Task workflow tracking for the [pi coding agent](https://www.npmjs.com/package/@
 - **Pre-existing double tracking respected** — if a file is already tracked by both an outer repo and a nested repo, changes go to the nested repo (innermost wins), pi never untracks the outer copy, and `/rollback` never lets the outer repo restore its stale copy over the inner worktree.
 - **Subdirectory start** — start pi in a subdirectory of an existing repo and no fresh `.git` is created there: all session changes (including TODO.md / README.md) are recorded in the enclosing repository, and `/rollback` restores the enclosing repo scoped to the session subtree.
 - **Subagent-safe** — `.pi-subagents/` session artifacts are never recorded, listed, or committed.
-- **~zero per-turn cost** — one incremental `git add` of touched files per task; no full-worktree scans, no background snapshot daemons.
+
+## Lightweight by design (measured, not claimed)
+
+The model never knows this extension exists. Every cost number below is measured on a real Windows machine (git spawn baseline ≈ 10 ms).
+
+**Zero token footprint** — the only overhead that compounds is context, and this extension adds exactly **0 tokens per turn**:
+
+- nothing injected into the system prompt (the `before_agent_start` system-prompt hook is never used)
+- zero custom tools registered (tool descriptions are what usually bloat context)
+- `/rollback` executes locally; its UI prompts never reach the model
+- task history lives in git objects, not in your conversation
+
+And it is token-*negative* in the failure-retry loop: `/rollback` rewinds the conversation branch, so a failed attempt's tokens leave the active context instead of piling up forever.
+
+**Idle = 0** — no file watchers, no daemons, no timers. Pure event handlers; when pi is idle the extension does nothing.
+
+**Bounded, spawn-bound runtime cost** — the cost is a handful of short `git` child processes, and it does **not grow with repository size** (`git status` on a 20-file repo ≈ a 5,000-file repo ≈ 20 ms):
+
+| Event | git calls | Measured cost |
+|---|---|---|
+| Session start (once) | 3–6 | ~50–100 ms |
+| Each bash/powershell command | 2 status snapshots | ~40 ms |
+| Task commit (per completed task) | add + diff + commit | ~60–80 ms |
+| Idle / between events | 0 | **0** |
+
+**Bounded memory** — snapshots hold only the dirty-file set and are freed as soon as the command's result arrives; `TODO.md` stays tiny (entries are removed when tasks complete — it starts at 8 bytes).
+
+**Zero dependencies, one file, no config** — drop it in `extensions/`, done. No setup, no keys, no services.
 
 ## /rollback
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-task-tracker",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Task workflow tracking for the pi coding agent: TODO/README maintenance, per-task git auto-commits as checkpoints, and an interactive /rollback. Hashline-aware, nested-repo aware, subagent-artifact-safe.",
   "keywords": [
     "pi-package",