pi-note 0.31.1 → 0.33.0

package/LOCAL.md

@@ -3,7 +3,7 @@
 [npm](https://www.npmjs.com/package/pi-note) · [Pi package directory](https://pi.dev/packages/pi-note)
 
 Persistent [pinote](https://github.com/kvidzibo/pinote) tasks and Markdown handoffs
-in Pi: selected-task footer status, `/pi-note`, and agent current-task read/update,
+in Pi: selected-task footer status, `/pinote`, and agent current-task read/update,
 add, and tag-listing tools.
 The extension and Python app share a repository but install separately.
 
@@ -30,8 +30,8 @@ Install [uv](https://docs.astral.sh/uv/getting-started/installation/) first and
 restart Pi with `uv` on PATH. At startup the extension checks `note --version`
 against its bundled CLI version (currently 0.4.0), without network requests:
 
-- Missing/unrecognized CLI: `/pi-note` opens Settings directly, where **Install CLI** is available.
-- Older CLI: `/pi-note` opens Settings directly, where **Upgrade CLI** is available.
+- Missing/unrecognized CLI: `/pinote` opens Settings directly, where **Install CLI** is available.
+- Older CLI: `/pinote` opens Settings directly, where **Upgrade CLI** is available.
 - Equal/newer CLI: neither installation action is shown; no upgrade notification.
 
 Install and upgrade recheck the CLI version and ask before installing into uv's
@@ -54,7 +54,7 @@ Check `note --version`, then restart Pi or `/reload`. Network/build failures and
 conflicting executables are reported without forcibly overwriting another
 installer's commands. Fix the reported cause and retry; installs time out after
 three minutes. Installation actions are unavailable while installation runs.
-Setup hints direct users to `/pi-note` → Settings.
+Setup hints direct users to `/pinote` → Settings.
 Missing uv is reported with its installation link, not installed
 automatically. The [GTK desktop app](../README.md#optional-gtk-checklist) is optional
 and still requires separate system dependencies.
@@ -65,16 +65,16 @@ standalone `settings/pi/extensions/pinote.ts` entry if installed; load only one
 
 ## Use
 
-When the CLI is ready and no task is selected, `/pi-note` opens the task picker.
+When the CLI is ready and no task is selected, `/pinote` opens the task picker.
 It marks the chosen task in progress and adds this default prompt to the editor:
 “Read the current Pinote task. Summarize your understanding, but don’t start work yet.”
-If the CLI is missing or older than the bundled version, `/pi-note` opens Settings
+If the CLI is missing or older than the bundled version, `/pinote` opens Settings
 directly so the relevant CLI installation action remains accessible. **Tab** opens
 Settings from the picker or task view; **Tab** from Settings returns to tasks.
 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, `/pi-note` offers **Continue**, **Done**, **Switch task**, and
+With a selected task, `/pinote` offers **Continue**, **Done**, **Switch task**, and
 **Settings**. Settings provides **Preview task**, **Complete task (new session)**,
 **Accept suggestion**, and **Dismiss suggestion** when applicable, plus
 **Install CLI** or **Upgrade CLI** only when needed. Settings also lists fields found
@@ -170,7 +170,7 @@ 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
+In `/pinote → Settings`, select **Task prompt** to edit the text inserted after
 selection or **Continue**. **Shift+Enter** or **Ctrl+J** adds a newline; **Enter** saves it
 globally, **Ctrl+C** clears the edit, and **Esc** cancels that unfinished edit.
 
@@ -219,7 +219,7 @@ configuration only; project-local files are not read.
 
 Version 0.7.0 replaces `pinote_get`/`pinote_update` with these current-task tools
 and removes `pinote_tag`, without aliases. Agents cannot read/update tasks by ID
-or retag existing tasks; use `/pi-note` to select an existing task.
+or retag existing tasks; use `/pinote` to select an existing task.
 
 When allowed by `taskOfferPolicy`, the agent uses `pinote_propose` instead of
 asking in chat. The pin footer shows a pending suggestion, distinct from a selected task:
@@ -242,7 +242,7 @@ The configured `footer.titleWidth` bounds the entire row (default 60 columns). C
 
 Controls use the [Kitty preview handler](#display-only-preview), with no additional configuration. Fullscreen Kitty uses **Ctrl+Shift+click**. The Settings actions **Accept suggestion** and **Dismiss suggestion** perform the corresponding footer actions. No action submits input or starts an agent turn. Add and Dismiss preserve editor drafts; **Complete task** starts a clean session and reloads Pi, discarding the editor draft, so save unfinished input before completing a task.
 
-Completion requires an idle Pi session and no pending Pinote operation. It rejects stale selected-task links and externally changed revisions. Accepted mutations drain even if the helper disconnects. On an error, check `/pi-note` before retrying, because a write may already have committed. Failed or stale writes never restart Pi. If another extension cancels the new session, the task remains completed and Pi reports the cancellation. The reload runs through the new session's fresh context; retired contexts are not reused.
+Completion requires an idle Pi session and no pending Pinote operation. It rejects stale selected-task links and externally changed revisions. Accepted mutations drain even if the helper disconnects. On an error, check `/pinote` before retrying, because a write may already have committed. Failed or stale writes never restart Pi. If another extension cancels the new session, the task remains completed and Pi reports the cancellation. The reload runs through the new session's fresh context; retired contexts are not reused.
 
 If another task fits better, the agent can replace an unaccepted suggestion by calling `pinote_propose` again, without waiting for dismissal. Replacement invalidates the old ✚/✖ links; only the latest suggestion can be accepted or dismissed. Pending suggestions survive `/reload` and session resume, including their full text and tag; new links replace stale capabilities. Accepted or dismissed suggestions never reappear on reload, but dismissal does not block new proposals—even in sessions saved by older versions. New sessions and forks start without a suggestion; selecting a task or navigating the tree clears it. Suggestion state is local, display-only session metadata, not model context. Pi saves the session after the first submitted message; quitting before that can still lose unsaved session state. Repeated acceptance cannot duplicate a note. A busy Pinote operation blocks acceptance. Noninteractive agents still ask in chat before using `pinote_add` with `select: true`. An existing selection is not replaced unless the user asks to switch. Reuse a saved
 tag name when it fits.
@@ -310,7 +310,7 @@ Names are case-sensitive, trimmed and NFC-normalized, at most 64 characters;
 accepted. Missing/blank values do not display and do not consume the field limit.
 `[]` or `maxFields: 0` hides configured fields, including PR.
 
-In `/pi-note → Settings`, **Add field** adds a global display definition, not a
+In `/pinote → Settings`, **Add field** adds a global display definition, not a
 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. Toggles, field additions/removals, and edits confirmed
@@ -369,7 +369,7 @@ Pinote no longer polls GitHub, runs `gh`, watches completed tasks, or prompts on
 PR merges. No GitHub authentication is required. `PINOTE_PR_POLL_SECONDS` is no
 longer used. Other separately installed Pi PR/Git extensions are unaffected.
 
-Tools work without a TUI. `/pi-note` works in a TUI while the agent is running:
+Tools work without a TUI. `/pinote` works in a TUI while the agent is running:
 you can select/switch tasks, use Continue, preview tasks, respond to suggestions,
 and edit settings without interrupting the turn or submitting input. Completion
 and CLI installation/upgrades still require an idle session. Another pending

package/README.md

@@ -48,7 +48,7 @@ state routing, tools and UI.
 
 ## Use
 
-Open **`/pinote`** (`/pi-note` is an alias). Select or create a task, preview it,
+Open **`/pinote`**. Select or create a task, preview it,
 clear the selection, complete it, respond to suggestions, or edit shared settings.
 Selecting an existing task starts it immediately and returns focus to the prompt,
 with no extra confirmation. Creation and settings changes still require confirmation.
@@ -76,9 +76,16 @@ Changing endpoints starts a separate selection namespace. Unsaved Pi sessions
 cannot guarantee selection persistence.
 
 The GTK app's **Start in Kitty…** action (note 0.13.0+) chooses a working directory
-and opens a named tab with this task selected, without submitting a prompt. Client
-and service both need pi-note 0.31.0+. The one-shot `PINOTE_LAUNCH_TASK` environment
-handoff carries only the task ID and displayed revision, never task text or tokens.
+and opens a named tab with this task selected, without submitting a prompt.
+In note 0.16.0+, it uses the tag's default folder when available, otherwise keeps
+the directory chooser. Set or clear defaults in **Manage tags…**.
+With note 0.15.0+ and pi-note 0.32.0+, successful selection prefills an empty Pi editor
+with `is task clear?`. Configure `gui.kitty_start_prompt` in the
+[GUI config](../docs/gui.md#gui-configuration), or set it to `""` to disable; existing
+drafts are never replaced. The service needs pi-note 0.31.0+.
+The one-shot `PINOTE_LAUNCH_TASK` environment handoff carries the task ID, displayed
+revision and optional editor draft, never task text or tokens. The draft stays
+client-local and is never sent to the service or persisted as launch state.
 Only a fresh session can consume it. The service must share the GUI's database;
 missing/stale revisions fail closed. Resume, reload and `/new` never replay the
 handoff or replace another selection. Pi keeps its normal endpoint/token settings.
@@ -116,6 +123,10 @@ separate from global display settings.
 
 ## Migration
 
+Since pi-note 0.33.0, `/pinote` is the only slash command in both modes.
+The `/pi-note` alias is removed; update saved shortcuts to `/pinote`.
+The npm package name and `pi-note.json` configuration filename are unchanged.
+
 1. Back up the service machine's Pinote data; keep `notes.db` local to that machine.
 2. Start the standalone service against that same database and settings directory.
 3. Remove Pinote's service entry and its unused package entry from the gateway

package/index.ts

@@ -107,7 +107,7 @@ function task(raw: string): Task | null {
 }
 function requiredTask(raw: string, id?: number): Task {
   const value = task(raw);
-  if (!value) throw new Error("No selected pinote task. Select one with /pi-note first.");
+  if (!value) throw new Error("No selected pinote task. Select one with /pinote first.");
   if (id !== undefined && value.id !== id) throw new Error(compatible);
   return value;
 }
@@ -187,7 +187,7 @@ export default function (pi: ExtensionAPI) {
     if (!alive || generation !== epoch || setupAbort) return;
     cliState = action;
     if (suggest && action === "upgrade") {
-      ctx.ui.notify(`Pinote CLI ${bundledCLIVersion} is bundled with this extension. Open /pi-note → Settings → Upgrade CLI to update your older CLI.`, "info");
+      ctx.ui.notify(`Pinote CLI ${bundledCLIVersion} is bundled with this extension. Open /pinote → Settings → Upgrade CLI to update your older CLI.`, "info");
     }
   };
 
@@ -314,7 +314,7 @@ export default function (pi: ExtensionAPI) {
       if (alive && generation === epoch && serial === refreshSerial) {
         previewBridge?.invalidate();
         clearTaskFooter(ctx);
-        ctx.ui.setStatus("pinote", suggestionStatus(ctx) ?? `${ctx.ui.theme.bold(noteIcon)} Pinote unavailable · /pi-note → Settings`);
+        ctx.ui.setStatus("pinote", suggestionStatus(ctx) ?? `${ctx.ui.theme.bold(noteIcon)} Pinote unavailable · /pinote → Settings`);
       }
     }
   };
@@ -357,10 +357,10 @@ export default function (pi: ExtensionAPI) {
       };
       const timer = setTimeout(() => {
         finish(false);
-        if (alive && activeContext === ctx) ctx.ui.notify("Pinote completion could not start. Open /pi-note → Settings → Complete task.", "warning");
+        if (alive && activeContext === ctx) ctx.ui.notify("Pinote completion could not start. Open /pinote → Settings → Complete task.", "warning");
       }, 4000);
       completionDispatch = { token, selection, task: displayed, started: () => clearTimeout(timer), finish };
-      try { pi.sendUserMessage(`/pi-note ${token}`, { expandPromptTemplates: true }); }
+      try { pi.sendUserMessage(`/pinote ${token}`, { expandPromptTemplates: true }); }
       catch { finish(false); }
     });
   };
@@ -454,7 +454,7 @@ export default function (pi: ExtensionAPI) {
       } catch {
         await bridge.stop();
         if (previewBridge === bridge) previewBridge = undefined;
-        ctx.ui.notify("Pinote task link unavailable; open /pi-note → Settings → Preview task.", "warning");
+        ctx.ui.notify("Pinote task link unavailable; open /pinote → Settings → Preview task.", "warning");
       }
     }
     if (!alive || generation !== epoch) return;
@@ -553,7 +553,7 @@ export default function (pi: ExtensionAPI) {
     }
   };
 
-  pi.registerCommand("pi-note", {
+  pi.registerCommand("pinote", {
     description: "Continue, complete, switch tasks, or edit global settings (Tab)",
     handler: async (args, ctx) => {
       if (!ctx.hasUI || ctx.mode !== "tui") return;
@@ -564,7 +564,7 @@ export default function (pi: ExtensionAPI) {
         await completeSelected(token, ctx);
         return;
       }
-      if (token) { ctx.ui.notify("Usage: /pi-note", "warning"); return; }
+      if (token) { ctx.ui.notify("Usage: /pinote", "warning"); return; }
       if (pending || menuPending) {
         ctx.ui.notify("Wait until the pinote operation has finished.", "warning");
         return;
@@ -724,7 +724,7 @@ export default function (pi: ExtensionAPI) {
       const canRun = () => alive && generation === epoch && branch === branchEpoch && selectedId === id;
       const current = await selected(ctx, signal);
       if (!canRun()) throw new Error("Pinote operation cancelled: the session or selected task changed.");
-      if (!current) throw new Error("No selected pinote task. Select one with /pi-note first.");
+      if (!current) throw new Error("No selected pinote task. Select one with /pinote first.");
       const argv = ["agent", "update", String(current.id), "--expected-updated-at", params.expected_updated_at,
         "--set-json", JSON.stringify(params.set ?? {})];
       for (const label of params.remove ?? []) argv.push(`--remove=${label}`);
@@ -789,7 +789,7 @@ export default function (pi: ExtensionAPI) {
       return true;
     } catch (error) {
       if (alive && generation === epoch) ctx.ui.notify(
-        `Pinote suggestion: ${clean(String(error))}${created ? ` Note #${created.id} was created; use /pi-note to select it. Do not add it again.` : " A write may have committed; check /pi-note before retrying."}`, "error");
+        `Pinote suggestion: ${clean(String(error))}${created ? ` Note #${created.id} was created; use /pinote to select it. Do not add it again.` : " A write may have committed; check /pinote before retrying."}`, "error");
       return false;
     } finally {
       if (pending === operation) pending = undefined;
@@ -854,10 +854,10 @@ export default function (pi: ExtensionAPI) {
       clearSuggestion(ctx);
       try {
         const created = requiredTask(await run(argv, signal, canAct, "0.4.0"));
-        if (!canAct()) throw new Error("Pinote operation cancelled: the session changed. The note was created; check /pi-note before retrying.");
+        if (!canAct()) throw new Error("Pinote operation cancelled: the session changed. The note was created; check /pinote before retrying.");
         const chosen = await startTask(created.id, canAct, signal);
         if (!chosen || !alive || generation !== epoch || branch !== branchEpoch || selectedId !== chosen.id) {
-          throw new Error("Pinote operation cancelled: the session changed. The note may have started; check /pi-note before retrying.");
+          throw new Error("Pinote operation cancelled: the session changed. The note may have started; check /pinote before retrying.");
         }
         return toolResult(chosen);
       } finally {

package/package.json

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

package/remote.ts

@@ -5,6 +5,7 @@ import { ENTRY_TYPE, RemoteSession, type SavedState } from './remote/session.ts'
 import { registerTools } from './remote/tools.ts';
 import { registerPreview, RemoteUI } from './remote/ui.ts';
 import { registerRemoteExit } from './remote/exit.ts';
+import { editorText } from './remote/protocol.ts';
 
 // Only an accepted /new (previousSessionFile) may carry this process-local selection.
 // Reload/resume/fork restore branch entries, never this map or a folder-global store.
@@ -34,7 +35,6 @@ export default function pinoteRemote(pi: ExtensionAPI): void {
     await ui.open(ctx);
   };
   pi.registerCommand('pinote', { description: 'Open remote Pinote tasks and settings', handler: open });
-  pi.registerCommand('pi-note', { description: 'Open remote Pinote (compatibility alias)', handler: open });
   const start = async (ctx: ExtensionContext, reason?: string, previous?: string) => {
     const request = launchRequest; launchRequest = undefined; // Never replay an uncertain start.
     ui?.detach(); await session?.stop();
@@ -48,12 +48,17 @@ export default function pinoteRemote(pi: ExtensionAPI): void {
       const branch = ctx.sessionManager.getBranch();
       let carried = reason === 'new' && previous ? transfers.get(previous) : undefined;
       let launch: { task_id: number; updated_at: string } | undefined;
+      let prompt: string | undefined;
       if (request) {
         try {
           if (reason !== 'startup' || branch.some((entry) => entry.type === 'message' || entry.type === 'custom' && entry.customType === ENTRY_TYPE)) throw new Error('Launch requires a fresh Pi session');
           const parsed = JSON.parse(request);
           if (!parsed || !Number.isSafeInteger(parsed.task_id) || parsed.task_id < 1 ||
               typeof parsed.updated_at !== 'string' || !parsed.updated_at.length || parsed.updated_at.length > 128) throw new Error('Invalid launch request');
+          if (parsed.prompt !== undefined) {
+            if (typeof parsed.prompt !== 'string' || [...parsed.prompt].length > 4000) throw new Error('Invalid launch prompt');
+            prompt = editorText(parsed.prompt);
+          }
           launch = { task_id: parsed.task_id, updated_at: parsed.updated_at };
           carried = { scope: config.scope, contextId: randomUUID(), state: { launch } };
         } catch {
@@ -68,6 +73,10 @@ export default function pinoteRemote(pi: ExtensionAPI): void {
         const control = view.controls.find((item) => item.id === `select:${launch.task_id}`);
         if (!control) throw new Error('Launch task changed or belongs to another service');
         await session.action(view, control); // The directory chooser's Start click granted consent.
+        if (prompt?.trim() && ctx.mode === 'tui' && ctx.isIdle()) {
+          if (ctx.ui.getEditorText().length) ctx.ui.notify('Launch draft not inserted: the editor already contains a draft.', 'warning');
+          else ctx.ui.setEditorText(prompt);
+        }
       }
       if (reason === 'new' && previous) transfers.delete(previous);
     } catch (error) {

package/setup.ts

@@ -4,7 +4,7 @@ import { stripVTControlCharacters } from "node:util";
 // Immutable source: the Python app is not yet published to PyPI.
 export const cliSource = "https://github.com/kvidzibo/pinote/archive/1597baf60bff8bc96893be40781f152a001623d1.tar.gz";
 export const bundledCLIVersion = "0.4.0";
-export const setupHint = "Open /pi-note → Settings to install or upgrade the CLI; note must be on PATH.";
+export const setupHint = "Open /pinote → Settings to install or upgrade the CLI; note must be on PATH.";
 export type CLIAction = "setup" | "upgrade" | "ready";
 
 export function cliAction(version: string): CLIAction {
@@ -51,10 +51,10 @@ export async function setupCLI(
   const action = await detectCLI(pi, signal);
   if (!canAct() || signal.aborted) return;
   if (action === "ready") {
-    ctx.ui.notify(`Pinote CLI is ready (bundled version ${bundledCLIVersion} or newer). Use /pi-note.`, "info");
+    ctx.ui.notify(`Pinote CLI is ready (bundled version ${bundledCLIVersion} or newer). Use /pinote.`, "info");
     return;
   }
-  const command = `/pi-note → Settings → ${action === "upgrade" ? "Upgrade CLI" : "Install CLI"}`;
+  const command = `/pinote → Settings → ${action === "upgrade" ? "Upgrade CLI" : "Install CLI"}`;
   if (upgrade !== (action === "upgrade")) {
     ctx.ui.notify(`Use ${command} ${action === "upgrade" ? "to upgrade the older CLI" : "to install the missing CLI"}.`, "info");
     return;
@@ -88,7 +88,7 @@ export async function setupCLI(
   try {
     const version = await exec("note", ["--version"]);
     if (version.killed || version.code !== 0 || cliAction(version.stdout) !== "ready") throw new Error("note unavailable or older than bundled CLI");
-    if (canAct()) ctx.ui.notify(`${clean(version.stdout.trim())} is ready. Use /pi-note. GTK is optional and installed separately.`, "info");
+    if (canAct()) ctx.ui.notify(`${clean(version.stdout.trim())} is ready. Use /pinote. GTK is optional and installed separately.`, "info");
   } catch {
     if (canAct()) ctx.ui.notify("Pinote installed, but note on PATH is missing or older than the bundled CLI. Run uv tool dir --bin in your terminal, add that directory to PATH before older note executables, then restart Pi.", "warning");
   }