pi-note 0.7.1 → 0.8.0

package/README.md

@@ -56,10 +56,10 @@ standalone `settings/pi/extensions/pinote.ts` entry if installed; load only one
 
 ## Use
 
-`/pi-note` picks a task, marks it in progress, and adds this prompt to the editor:
+`/pi-note` picks a task, marks it in progress, and adds this default prompt to the editor:
 “Read the current Pinote task. Summarize your understanding, but don’t start work yet.”
 The agent fetches current task text and saved handoff fields when you submit;
-they are not copied into the draft. The prompt asks for a summary, not implementation.
+they are not copied into the draft. The default prompt asks for a summary, not implementation.
 Existing drafts are preserved; nothing is submitted automatically.
 With a selected task it offers **Continue**, **Done**, and **Switch task**.
 Type in the task picker to filter by text, ID, tag, or state (all words must match).
@@ -74,14 +74,33 @@ Resume restores that session's task; a new session starts unselected and does no
 an older per-folder selection. Pi saves the session after the first submitted message;
 quitting before that leaves the next launch unselected, while the task stays in progress.
 Use **Continue**
-to insert the same read-and-summarize prompt. Completing, removing, or scheduling a task clears it
+to insert the same configured prompt. Completing, removing, or scheduling a task clears it
 from sessions that refresh it. Switching does not complete or reset the previous task.
 Task fields such as `Worktree` and `PR` stay on the task, so sessions can use separate
 worktrees and pull requests. Task status refreshes at session start, before/after
 agent activity, and after commands/tools. The CLI's per-directory `agent selected`
 command is not this session memory.
 
-Agent tools:
+### Handoff prompt configuration
+
+Set `handoffPrompt` in `~/.pi/agent/pi-note.json` (or in the agent directory set
+by `PI_CODING_AGENT_DIR`):
+
+```json
+{
+  "handoffPrompt": "Read the current Pinote task. Summarize your understanding and proposed approach, but don’t start work yet."
+}
+```
+
+Both task selection and **Continue** read this file each time; no `/reload` is
+needed after edits. The value is literal text, not a prompt template; use `\n`
+in JSON strings for multiple lines. It must be a nonblank string without control
+characters other than tabs and newlines. A missing file or key uses the default.
+Invalid/unreadable configuration reports an error without starting/switching a
+task or changing the editor. **Done** and agent tools are unaffected. This is
+user-level configuration only; project-local files are not read.
+
+### Agent tools
 
 - `pinote_get_current`: read this session's selected task, including its revision.
   Takes no arguments; returns null when this session has no selected task.

package/index.ts

@@ -1,6 +1,7 @@
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { getAgentDir, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth } from "@earendil-works/pi-tui";
 import { readFileSync } from "node:fs";
+import { join } from "node:path";
 import { stripVTControlCharacters } from "node:util";
 import { Type } from "typebox";
 import { createPRWatcher } from "./pr-watch.ts";
@@ -34,6 +35,26 @@ const clean = (value: string) => stripVTControlCharacters(value).replace(/[\x00-
 const firstLine = (task: Summary) => clean(task.text.split("\n", 1)[0]).replace(/\s+/gu, " ").trim();
 const title = (task: Summary) => truncateToWidth(`#${task.id} ${firstLine(task)}`, 60);
 
+const defaultHandoffPrompt = "Read the current Pinote task. Summarize your understanding, but don’t start work yet.";
+function handoffPrompt(): string {
+  const path = join(getAgentDir(), "pi-note.json");
+  let raw: string;
+  try {
+    raw = readFileSync(path, "utf8");
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === "ENOENT") return defaultHandoffPrompt;
+    throw new Error(`Cannot read ${path}. Check the pi-note configuration.`);
+  }
+  let config: unknown;
+  try { config = JSON.parse(raw); } catch { throw new Error(`Invalid JSON in ${path}.`); }
+  if (!record(config)) throw new Error(`Expected a JSON object in ${path}.`);
+  if (!("handoffPrompt" in config)) return defaultHandoffPrompt;
+  if (!text(config.handoffPrompt) || !config.handoffPrompt.trim()) {
+    throw new Error(`handoffPrompt in ${path} must be a nonblank string without control characters (except tabs/newlines).`);
+  }
+  return config.handoffPrompt;
+}
+
 function parse(raw: string): unknown {
   try { return JSON.parse(raw); } catch { throw new Error(compatible); }
 }
@@ -333,6 +354,7 @@ export default function (pi: ExtensionAPI) {
           if (currentSession()) ctx.ui.notify(`Pinote #${current.id} completed.`, "info");
           return;
         }
+        const handoff = handoffPrompt();
         let id: number;
         if (action === "Continue" && current) {
           id = current.id;
@@ -349,7 +371,6 @@ export default function (pi: ExtensionAPI) {
         const chosen = await startTask(id, canAct);
         if (!chosen || !canAct()) return;
         const draft = ctx.ui.getEditorText();
-        const handoff = "Read the current Pinote task. Summarize your understanding, but don’t start work yet.";
         ctx.ui.setEditorText(draft ? `${draft}\n\n${handoff}` : handoff);
         ctx.ui.notify(`Pinote #${chosen.id} is in progress. Task added to input.`, "info");
       } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-note",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Persistent pinote tasks, Markdown handoffs, and task status for Pi",
   "license": "MIT",
   "type": "module",