pi-note 0.10.0 → 0.11.0

package/README.md

@@ -62,7 +62,7 @@ The agent fetches current task text and saved handoff fields when you submit;
 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**, **Switch task**, and **Settings**.
-Press **Tab** from the task menu or picker to open global footer settings; Tab
+Press **Tab** from the task menu or picker to open global settings; Tab
 returns to tasks without saving. Settings also lists fields found on the current
 task, so existing values can be configured without creating another task.
 Type in the task picker to filter by text, ID, tag, or state (all words must match).
@@ -109,6 +109,12 @@ and selected tasks. Run `/reload` after changing this setting. Invalid policy
 values or unreadable/malformed configuration suppress offers; interactive startup
 warns until you fix the file and reload. No project-local configuration is read.
 
+In `/pi-note → Settings`, select **Task prompt** to edit the text inserted after
+selection or **Continue**. **Shift+Enter** or **Ctrl+J** adds a newline; **Enter** applies it to
+the settings draft, **Ctrl+C** clears it, and **Esc** cancels that edit. Select **Save settings** to
+persist it globally; leaving Settings with **Esc** or **Tab** discards the draft.
+Saving never changes existing editor input or submits anything.
+
 Task selection and **Continue** reread `handoffPrompt` each time; changing that
 field needs no `/reload`. Its value is literal text, not a prompt template; use
 `\n` in JSON strings for multiple lines. It must be a nonblank string without control
@@ -204,8 +210,8 @@ In `/pi-note → Settings`, **Add field** adds a global display definition, not
 task value. Select any field to edit **Link**, **Label**, **Format**, and **Width**.
 Label starts as the field name; clear it for no prefix. Link off displays plain
 text without a clickable link. **Save** persists the draft; cancellation leaves
-configuration untouched. Saves preserve unrelated settings (`handoffPrompt`,
-`taskOfferPolicy`) and reject configuration changes made while the dialog was open.
+configuration untouched. Saves include the task prompt and preserve unrelated
+settings (such as `taskOfferPolicy`) and reject configuration changes made while the dialog was open.
 Concurrent saves use `pi-note.json.lock`; remove stale locks only when no save is
 running. Symlinked configuration must be edited manually; saves never replace the link.
 
@@ -221,8 +227,8 @@ the first Settings save turns this legacy list into explicit global definitions.
 Settings saves apply immediately in this Pi session. Run `/reload` after manual
 footer edits or in other running sessions; settings are also reread on session start.
 Invalid footer configuration warns and uses footer defaults; missing files silently
-use defaults. This does not validate or change `handoffPrompt`, which is read
-separately on selection/Continue as described above.
+use defaults. The task prompt is also read separately on selection/Continue as
+described above; prompt changes need no reload in any running session.
 This is user-level configuration, not task data; agents should not change it
 without approval. Task values still come from `pinote_update_current`.
 

package/footer-config.ts

@@ -3,6 +3,15 @@ import { closeSync, lstatSync, mkdirSync, openSync, readFileSync, renameSync, rm
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";
 
+export const defaultHandoffPrompt = "Read the current Pinote task. Summarize your understanding, but don’t start work yet.";
+export function parseHandoffPrompt(value: unknown): string {
+  if (typeof value !== "string" || !value.trim() || /[\x00-\x08\x0b-\x1f\x7f-\x9f]/u.test(value)) {
+    throw new Error("handoffPrompt in pi-note.json must be a nonblank string without control characters (except tabs/newlines).");
+  }
+  return value;
+}
+export type PinoteSettings = { footer: FooterConfig; handoffPrompt: string };
+
 export type FooterField = { name: string; label: string; link: boolean; format: string; width?: number };
 export type FooterConfig = { titleWidth: number; fieldWidth: number; maxFields: number; fields: FooterField[] | null };
 export const defaultFooterConfig: FooterConfig = { titleWidth: 60, fieldWidth: 60, maxFields: 4, fields: null };
@@ -80,9 +89,10 @@ export function loadFooterConfig(warn: (message: string) => void): FooterConfig
 }
 
 // Synchronous compare-and-replace: reject edits made while the settings dialog was open,
-// preserve unrelated keys (including handoffPrompt), and never leave partial JSON behind.
-export function saveFooterConfig(config: FooterConfig, expectedRaw: string | null): FooterConfig {
+// preserve unrelated keys, and never leave partial JSON behind.
+export function saveFooterConfig(config: FooterConfig, expectedRaw: string | null, handoffPrompt?: string): FooterConfig {
   const checked = parseFooterConfig({ footer: config });
+  const prompt = handoffPrompt === undefined ? {} : { handoffPrompt: parseHandoffPrompt(handoffPrompt) };
   const directory = getAgentDir();
   mkdirSync(directory, { recursive: true });
   const path = join(directory, "pi-note.json");
@@ -96,7 +106,7 @@ export function saveFooterConfig(config: FooterConfig, expectedRaw: string | nul
     if (lstatSync(path, { throwIfNoEntry: false })?.isSymbolicLink()) throw new Error("pi-note.json is a symlink. Edit its target manually rather than replacing the link.");
     const root = expectedRaw === null ? {} : JSON.parse(expectedRaw);
     if (!object(root)) throw new Error("Invalid pi-note configuration; expected an object.");
-    writeFileSync(temp, `${JSON.stringify({ ...root, footer: checked }, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+    writeFileSync(temp, `${JSON.stringify({ ...root, ...prompt, footer: checked }, null, 2)}\n`, { flag: "wx", mode: 0o600 });
     renameSync(temp, path);
   } finally { rmSync(temp, { force: true }); closeSync(descriptor); rmSync(lock, { force: true }); }
   return checked;

package/footer-settings.ts

@@ -1,6 +1,6 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
-import { Input, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
-import { defaultFooterField, parseFooterConfig, type FooterConfig, type FooterField } from "./footer-config.ts";
+import { Editor, Input, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
+import { defaultFooterField, parseFooterConfig, parseHandoffPrompt, type PinoteSettings, type FooterConfig, type FooterField } from "./footer-config.ts";
 
 type Matches = (data: string, action: string) => boolean;
 type Row = { label: string; action: () => void };
@@ -38,10 +38,13 @@ export class TaskMenu {
 
 export class FooterSettings {
   private draft: FooterConfig;
+  private prompt: string;
+  private editor?: Editor;
+  private createEditor: () => Editor;
   private knownFields: string[];
   private theme: Theme;
   private matches: Matches;
-  private done: (result: FooterConfig | "tasks" | undefined) => void;
+  private done: (result: PinoteSettings | "tasks" | undefined) => void;
   private requestRender: () => void;
   private index = 0;
   private field?: FooterField;
@@ -49,15 +52,21 @@ export class FooterSettings {
   private error = "";
   private hasFocus = false;
 
-  constructor(config: FooterConfig, knownFields: string[], theme: Theme, matches: Matches,
-    done: (result: FooterConfig | "tasks" | undefined) => void, requestRender: () => void) {
-    this.draft = structuredClone(config);
+  constructor(config: PinoteSettings, knownFields: string[], theme: Theme, matches: Matches,
+    done: (result: PinoteSettings | "tasks" | undefined) => void, requestRender: () => void, createEditor: () => Editor) {
+    this.draft = structuredClone(config.footer);
+    this.prompt = config.handoffPrompt;
+    this.createEditor = createEditor;
     this.draft.fields ??= [];
     this.knownFields = [...new Set(knownFields)].filter((name) => name !== "Bar");
     this.theme = theme; this.matches = matches; this.done = done; this.requestRender = requestRender;
   }
   get focused() { return this.hasFocus; }
-  set focused(value: boolean) { this.hasFocus = value; if (this.input) this.input.widget.focused = value; }
+  set focused(value: boolean) {
+    this.hasFocus = value;
+    if (this.input) this.input.widget.focused = value;
+    if (this.editor) this.editor.focused = value;
+  }
 
   private ask(heading: string, value: string, apply: (value: string) => void) {
     const widget = new Input();
@@ -80,6 +89,12 @@ export class FooterSettings {
         this.draft = parseFooterConfig({ footer: candidate });
       }),
     }));
+    rows.push({ label: `Task prompt: ${display(this.prompt)}`, action: () => {
+      this.editor = this.createEditor();
+      this.editor.disableSubmit = true;
+      this.editor.setText(this.prompt);
+      this.editor.focused = this.hasFocus;
+    } });
     const configured = this.draft.fields!.map((field) => field.name);
     for (const name of [...configured, ...this.knownFields.filter((name) => !configured.includes(name))]) {
       rows.push({ label: `Field: ${display(name)}${configured.includes(name) ? "" : " (not configured)"}`, action: () => this.edit(name) });
@@ -87,7 +102,7 @@ export class FooterSettings {
     rows.push({ label: "+ Add field", action: () => this.ask("Field name", "", (value) => {
       const field = this.validate(defaultFooterField(value));
       this.edit(field.name);
-    }) }, { label: "Save settings", action: () => this.done(parseFooterConfig({ footer: this.draft })) },
+    }) }, { label: "Save settings", action: () => this.done({ footer: parseFooterConfig({ footer: this.draft }), handoffPrompt: parseHandoffPrompt(this.prompt) }) },
     { label: "Return to tasks", action: () => this.done("tasks") });
     return rows;
   }
@@ -126,7 +141,15 @@ export class FooterSettings {
     this.error = "";
     try {
       if (isTab(data)) this.done("tasks");
-      else if (this.input) {
+      else if (this.editor) {
+        if (matchesKey(data, "ctrl+c")) this.editor.setText("");
+        else if (this.matches(data, "tui.select.cancel")) this.editor = undefined;
+        else if (this.matches(data, "tui.input.newLine")) this.editor.handleInput(data);
+        else if (this.matches(data, "tui.select.confirm")) {
+          this.prompt = parseHandoffPrompt(this.editor.getExpandedText());
+          this.editor = undefined;
+        } else this.editor.handleInput(data);
+      } else if (this.input) {
         if (this.matches(data, "tui.select.cancel")) this.input = undefined;
         else if (this.matches(data, "tui.select.confirm")) {
           const input = this.input;
@@ -147,7 +170,10 @@ export class FooterSettings {
   }
   render(width: number) {
     const lines = [this.theme.fg("accent", "Pinote — Global Settings"), this.theme.fg("dim", "Tasks (Tab) · Settings · Fields")];
-    if (this.input) {
+    if (this.editor) {
+      lines.push(this.theme.fg("accent", "Task prompt"), ...this.editor.render(width),
+        this.theme.fg("dim", "Enter apply · Shift+Enter/Ctrl+J newline · Ctrl+C clear · Esc cancel"));
+    } else if (this.input) {
       lines.push(this.theme.fg("accent", this.input.heading), ...this.input.widget.render(width),
         this.theme.fg("dim", "Enter apply to draft · Esc cancel"));
     } else {
@@ -164,7 +190,7 @@ export class FooterSettings {
     lines.push(this.theme.fg("dim", "Tab: tasks, discard draft · Save settings: persist globally"));
     return lines.map((line) => truncateToWidth(line, width));
   }
-  invalidate() { this.input?.widget.invalidate(); }
+  invalidate() { this.input?.widget.invalidate(); this.editor?.invalidate(); }
 }
 
 export function withSettingsTab<T extends { handleInput?(data: string): void; render(width: number): string[]; invalidate(): void; focused?: boolean }>(

package/index.ts

@@ -1,11 +1,11 @@
 import { getAgentDir, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, type Keybinding } from "@earendil-works/pi-tui";
+import { Editor, truncateToWidth, type Keybinding } 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";
-import { defaultFooterConfig, effectiveFooterFields, loadFooterConfig, readFooterDocument, saveFooterConfig, type FooterConfig } from "./footer-config.ts";
+import { defaultFooterConfig, defaultHandoffPrompt, effectiveFooterFields, loadFooterConfig, parseHandoffPrompt, readFooterDocument, saveFooterConfig, type FooterConfig, type PinoteSettings } from "./footer-config.ts";
 import { FooterSettings, TaskMenu, withSettingsTab } from "./footer-settings.ts";
 import { TaskPicker, taskState, taskTag } from "./task-picker.ts";
 import { bundledCLIVersion, cliMenu, detectCLI, setupCLI, setupHint, versionAtLeast, type CLIAction } from "./setup.ts";
@@ -40,7 +40,6 @@ 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 readConfig(): Record<string, unknown> {
   const path = join(getAgentDir(), "pi-note.json");
   let raw: string;
@@ -77,12 +76,7 @@ function creationGuidance(): { guidelines: string[]; error?: string } {
 
 function handoffPrompt(): string {
   const config = readConfig();
-  const path = join(getAgentDir(), "pi-note.json");
-  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;
+  return "handoffPrompt" in config ? parseHandoffPrompt(config.handoffPrompt) : defaultHandoffPrompt;
 }
 
 function parse(raw: string): unknown {
@@ -360,7 +354,7 @@ export default function (pi: ExtensionAPI) {
   registerInstallCommand("pi-note-upgrade");
 
   pi.registerCommand("pi-note", {
-    description: "Continue, complete, switch tasks, or edit global footer settings (Tab)",
+    description: "Continue, complete, switch tasks, or edit global settings (Tab)",
     handler: async (args, ctx) => {
       if (!ctx.hasUI || ctx.mode !== "tui") return;
       if (args.trim()) { ctx.ui.notify("Usage: /pi-note", "warning"); return; }
@@ -381,14 +375,24 @@ export default function (pi: ExtensionAPI) {
         while (canAct()) {
           if (settings) {
             const document = readFooterDocument();
-            const config = { ...document.config, fields: effectiveFooterFields(document.config, current?.agent_notes) };
-            const edited = await ctx.ui.custom<FooterConfig | "tasks" | undefined>((tui, theme, kb, done) =>
+            const root = document.raw === null ? {} : JSON.parse(document.raw);
+            const config: PinoteSettings = {
+              footer: { ...document.config, fields: effectiveFooterFields(document.config, current?.agent_notes) },
+              handoffPrompt: "handoffPrompt" in root ? parseHandoffPrompt(root.handoffPrompt) : defaultHandoffPrompt,
+            };
+            const edited = await ctx.ui.custom<PinoteSettings | "tasks" | undefined>((tui, theme, kb, done) =>
               new FooterSettings(config, Object.keys(current?.agent_notes ?? {}).filter((name) => name !== "Bar"),
-                theme, (data, action) => kb.matches(data, action as Keybinding), done, () => tui.requestRender()));
+                theme, (data, action) => kb.matches(data, action as Keybinding), done, () => tui.requestRender(),
+                () => new Editor(tui, {
+                  borderColor: (line) => theme.fg("accent", line),
+                  selectList: { selectedPrefix: (line) => theme.fg("accent", line), selectedText: (line) => theme.fg("accent", line),
+                    description: (line) => theme.fg("muted", line), scrollInfo: (line) => theme.fg("dim", line),
+                    noMatch: (line) => theme.fg("warning", line) },
+                })));
             if (!canAct() || edited === undefined) return;
             if (edited === "tasks") { settings = false; continue; }
-            footerConfig = saveFooterConfig(edited, document.raw);
-            ctx.ui.notify("Global Pinote footer settings saved.", "info");
+            footerConfig = saveFooterConfig(edited.footer, document.raw, edited.handoffPrompt);
+            ctx.ui.notify("Global Pinote settings saved.", "info");
             return;
           }
           const action = current

package/package.json

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