pi-note 0.13.0 → 0.13.2

package/README.md

@@ -68,9 +68,9 @@ 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).
 Use ↑/↓ and Enter to select, or Esc to cancel. Rows show **●** for in progress or
 **○** for active, followed by the tag (`[Untagged]` when absent).
-The normal Pi status area shows `👁 📌 [tag] Task title` without replacing other footers.
-The footer omits the task ID and state and shows only the first line, truncated to the configured width (default 60 terminal columns including the eye, pin and tag). Overflow ends with `...`.
-The glyphs are bundled in `icons/eye.txt` and `icons/note.txt`; they use terminal fonts, not a Nerd Font or icon theme.
+The normal Pi status area shows `📌 [tag] Task title` without replacing other footers.
+The footer omits the task ID and state and shows only the first line, truncated to the configured width (default 60 terminal columns including the pin and tag). Overflow ends with `...`.
+The pin glyph is bundled in `icons/note.txt`; it uses terminal fonts, not a Nerd Font or icon theme.
 
 ### Display-only preview
 
@@ -82,12 +82,13 @@ modify the note, editor draft or task selection, and never starts a model call.
 The agent can still read the task separately with `pinote_get_current`.
 Previewing requires Pi to be idle with no other Pinote operation open.
 
-On Linux, the eye is a clickable OSC 8 link to a private per-session Unix socket.
+On Linux, the task text (pin, tag and title) is a clickable OSC 8 link to a
+private per-session Unix socket. Overflow at the configured title width stays linked.
 The package ships [a Kitty configuration example](kitty/open-actions.conf).
 Append its block to `~/.config/kitty/open-actions.conf`, preserving existing
 actions. Replace `/absolute/path/to/pi-note` with the installed package directory
 containing `preview-click.cjs`; for this checkout, that directory is `pi/`.
-Keep `${URL}` literal: Kitty substitutes the clicked eye's link.
+Keep `${URL}` literal: Kitty substitutes the clicked task's link.
 
 ```conf
 protocol pi-note-preview
@@ -97,12 +98,12 @@ action launch --type=background node /absolute/path/to/pi-note/preview-click.cjs
 Do not replace or symlink your entire Kitty configuration to the example: it
 contains only Pinote's handler. Package installation does not edit Kitty files.
 
-Reload Kitty with **Ctrl+Shift+F5**. In Pi's regular mode, click the eye; in
+Reload Kitty with **Ctrl+Shift+F5**. In Pi's regular mode, click the task text; in
 fullscreen mode, use **Ctrl+Shift+click** so Kitty handles the link instead of
 Pi's system URL opener. The helper sends only an authenticated selection
 identifier, never note content or a model prompt. Stale links after task switching, tree navigation, reload or session exit
 are rejected. Other terminals can use `/pi-note-preview`; if the socket cannot
-start, the eye is omitted and that command remains available.
+start, the task remains visible without a link and that command remains available.
 
 Each Pi session remembers its own task, including several sessions in one folder.
 Resume restores that session's task; a new session starts unselected and does not import
@@ -170,8 +171,8 @@ user-level configuration only; project-local files are not read.
   populating relevant values with `pinote_update_current`. Empty/missing values
   stay hidden; this tool does not edit configuration.
 - `pinote_tags`: list saved tag names.
-- `pinote_propose`: show a nonmodal suggested-task bar below the input without
-  creating a note. Optional `tag`; full text is retained, but the bar shows only
+- `pinote_propose`: show a suggested task beside the pin icon in the footer without
+  creating a note. Optional `tag`; full text is retained, but the footer shows only
   its title. Requires a TUI with no selected task. The agent continues your work
   while the suggestion awaits your choice.
 - `pinote_add`: create an active task. Optional `tag`. `select: true` starts and
@@ -182,12 +183,25 @@ 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.
 
 When allowed by `taskOfferPolicy`, the agent uses `pinote_propose` instead of
-asking in chat. A bar below the input shows `[tag] Task title  ✓  ✕`:
+asking in chat. The pin footer shows a pending suggestion, distinct from a selected task:
 
-- **✓** creates the note, starts it, and selects it for this session.
-- **✕** hides the suggestion without creating a note; further offers are suppressed
+```text
+📌 Suggested: ✓ Add  ✕ Dismiss · [tag] Task title...
+```
+
+![Suggested task beside the footer pin](../docs/images/pi-task-suggestion.png)
+
+- **✓ Add** creates the note, starts it, and selects it for this session.
+- **✕ Dismiss** hides the suggestion without creating a note; further offers are suppressed
   until a new session or reload.
 
+The configured `footer.titleWidth` bounds the whole suggestion (default 60 columns).
+Controls precede the variable text so long titles cannot push them off the right edge.
+The tag is omitted when space is tight; the first-line title truncates with `...`.
+Smaller budgets shorten controls to ✓ and ✕; tiny budgets show only the suggestion cue.
+Pi can still clip the combined status row on narrow terminals; use the commands below
+if the controls are not visible. Accepting replaces the suggestion with the selected task.
+
 Neither action submits input or starts an agent turn; editor drafts stay unchanged.
 The icons reuse the [Kitty preview handler](#display-only-preview), with no additional
 configuration. Fullscreen Kitty uses **Ctrl+Shift+click**. Keyboard alternatives are
@@ -215,7 +229,7 @@ Values are Markdown strings; no fields are required. `PR` enables the watcher be
 `Bar` chooses extra footer fields unless configuration overrides it:
 
 ```markdown
-# Agent
+## Agent
 PR: [Task selection #42](https://github.com/org/repo/pull/42)
 Dashboard: [Metrics](http://127.0.0.1:3000/d/app)
 Next: Address review comments
@@ -251,7 +265,7 @@ Add `footer` to `~/.pi/agent/pi-note.json` (or `pi-note.json` under
 }
 ```
 
-Widths are terminal columns, including the eye, pin, tags or field labels, and must be
+Widths are terminal columns, including the pin, tags or field labels, and must be
 integers from 3 to 1000. Defaults: `titleWidth: 60`, `fieldWidth: 60`,
 `maxFields: 4` (allowed 0–64). Each field can override `fieldWidth` with `width`.
 `fields` selects task field names in order, regardless of a task's `Bar`.
@@ -303,8 +317,9 @@ By default, at most four extra fields are shown, each truncated to 60 columns.
 Overflow ends with `...`, including cuts between Markdown/link segments. Removing
 a listed field hides it even if configuration or `Bar` still names it. Terminal
 OSC 8 support is required for clicking links. Pi joins footer statuses on one
-line and truncates the combined line with `...` when the terminal is narrow;
-this extension does not replace other footers. Other fields, such as `Jira` and
+line and truncates the combined line with `...` when the terminal is narrow.
+Pi's final ellipsis is plain text; click the remaining task text to preview it.
+This extension does not replace other footers. Other fields, such as `Jira` and
 `CWD` in the example, stay off the footer unless selected.
 
 ### PR merge watcher

package/index.ts

@@ -1,5 +1,5 @@
 import { getAgentDir, getMarkdownTheme, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Container, Editor, Markdown, Text, truncateToWidth, visibleWidth, type Keybinding } from "@earendil-works/pi-tui";
+import { Container, Editor, Markdown, Text, truncateToWidth, type Keybinding } from "@earendil-works/pi-tui";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { stripVTControlCharacters } from "node:util";
@@ -33,7 +33,6 @@ type Task = {
 type Summary = Pick<Task, "id" | "text" | "state" | "tag">;
 // The standard Pi footer accepts text, so ship a portable terminal glyph, not a theme icon.
 const noteIcon = readFileSync(new URL("./icons/note.txt", import.meta.url), "utf8").trim();
-const eyeIcon = readFileSync(new URL("./icons/eye.txt", import.meta.url), "utf8").trim();
 const previewType = "pinote-preview";
 const compatible = "Incompatible note CLI response. Install pinote 0.3.0+ and check note on PATH.";
 const validId = (value: unknown): value is number => Number.isSafeInteger(value) && Number(value) > 0;
@@ -132,7 +131,7 @@ export default function (pi: ExtensionAPI) {
   let offerDeclined = false;
   const clearSuggestion = (ctx: ExtensionContext) => {
     previewBridge?.clearSuggestion();
-    if (suggestion && ctx.hasUI && ctx.mode === "tui") ctx.ui.setWidget("pinote-suggestion", undefined);
+    if (suggestion && ctx.hasUI && ctx.mode === "tui") ctx.ui.setStatus("pinote", undefined);
     suggestion = undefined;
   };
   let alive = true;
@@ -143,6 +142,11 @@ export default function (pi: ExtensionAPI) {
   let activeContext: ExtensionContext | undefined;
   let cliState: CLIAction | undefined;
   let footerConfig = { ...defaultFooterConfig };
+  const suggestionStatus = (ctx: ExtensionContext) => suggestion ? renderSuggestion(
+    suggestion, footerConfig.titleWidth, ctx.ui.theme, {
+      yes: previewBridge?.suggestionUrl("yes"), no: previewBridge?.suggestionUrl("no"),
+    },
+  ) : undefined;
   const checkCLI = async (ctx: ExtensionContext, suggest = false) => {
     if (!ctx.hasUI || ctx.mode !== "tui" || setupAbort) return;
     const generation = epoch;
@@ -265,16 +269,15 @@ export default function (pi: ExtensionAPI) {
         previewBridge?.setTask(previewId, (signal) => alive && generation === epoch && previewBranch === branchEpoch &&
           selectedId === previewId ? preview(ctx, signal) : Promise.resolve(false));
         const url = previewBridge?.url();
-        // Keep the eye outside title truncation, including the minimum title width.
-        const eye = url ? `\x1b]8;;${url}\x07${eyeIcon}\x1b]8;;\x07 ` : "";
-        const width = Math.max(0, footerConfig.titleWidth - (eye ? visibleWidth(eyeIcon) + 1 : 0));
-        ctx.ui.setStatus("pinote", current ? eye + truncateToWidth(`${noteIcon} ${taskTag(current)} ${firstLine(current)}`, width, "...") : undefined);
+        // Truncate before linking so the task label, including configured overflow, is clickable.
+        const label = current ? truncateToWidth(`${noteIcon} ${taskTag(current)} ${firstLine(current)}`, footerConfig.titleWidth, "...") : undefined;
+        ctx.ui.setStatus("pinote", current ? (label && url ? `\x1b]8;;${url}\x07${label}\x1b]8;;\x07` : label) : suggestionStatus(ctx));
         watcher.update(ctx, current);
       }
     } catch {
       if (alive && generation === epoch && serial === refreshSerial) {
         previewBridge?.invalidate();
-        ctx.ui.setStatus("pinote", `${noteIcon} Pinote unavailable · ${cliState === "upgrade" ? "/pi-note-upgrade" : cliState === "setup" ? "/pi-note-setup" : "/pi-note"}`);
+        ctx.ui.setStatus("pinote", suggestionStatus(ctx) ?? `${noteIcon} Pinote unavailable · ${cliState === "upgrade" ? "/pi-note-upgrade" : cliState === "setup" ? "/pi-note-setup" : "/pi-note"}`);
       }
     }
   };
@@ -365,7 +368,7 @@ export default function (pi: ExtensionAPI) {
       } catch {
         await bridge.stop();
         if (previewBridge === bridge) previewBridge = undefined;
-        ctx.ui.notify("Pinote eye link unavailable; use /pi-note-preview.", "warning");
+        ctx.ui.notify("Pinote task link unavailable; use /pi-note-preview.", "warning");
       }
     }
     if (!alive || generation !== epoch) return;
@@ -663,7 +666,7 @@ export default function (pi: ExtensionAPI) {
     name: "pinote_propose",
     label: "Pinote suggest task",
     promptGuidelines: createGuidance,
-    description: "Show a suggested task in a nonmodal bar below the input, without creating it or asking in chat. ✓ creates, starts and selects it; ✕ dismisses it. Continue the requested work while awaiting consent. Requires an interactive TUI with no selected task. An existing suggestion is retained; a dismissed offer is not repeated. In noninteractive modes ask in chat, then use pinote_add only after consent.",
+    description: "Show a suggested task beside the pin icon in the footer, without creating it or asking in chat. ✓ creates, starts and selects it; ✕ dismisses it. Continue the requested work while awaiting consent. Requires an interactive TUI with no selected task. An existing suggestion is retained; a dismissed offer is not repeated. In noninteractive modes ask in chat, then use pinote_add only after consent.",
     parameters: Type.Object({
       text: Type.String({ minLength: 1, description: "Short action-oriented title, then optional details after a blank line." }),
       tag: Type.Optional(Type.String({ minLength: 1, maxLength: 64 })),
@@ -683,13 +686,7 @@ export default function (pi: ExtensionAPI) {
       if (suggestion) return result("pending; existing suggestion retained, continue work without asking again");
       suggestion = { text: params.text, ...(params.tag === undefined ? {} : { tag: params.tag.trim() }) };
       previewBridge?.setSuggestion((choice) => respondToSuggestion(choice, ctx));
-      const proposed = suggestion;
-      ctx.ui.setWidget("pinote-suggestion", (_tui, theme) => ({
-        render: (width) => [renderSuggestion(proposed, width, theme, {
-          yes: previewBridge?.suggestionUrl("yes"), no: previewBridge?.suggestionUrl("no"),
-        })],
-        invalidate() {},
-      }), { placement: "belowEditor" });
+      ctx.ui.setStatus("pinote", suggestionStatus(ctx));
       return result("pending; user can click ✓ to add and select or ✕ to dismiss, continue work without asking again");
     },
   });

package/kitty/open-actions.conf

@@ -1,5 +1,5 @@
 # Append this block to ~/.config/kitty/open-actions.conf; preserve existing actions.
 # Replace /absolute/path/to/pi-note with the directory containing preview-click.cjs.
-# Keep ${URL} literal: Kitty substitutes the clicked eye's link.
+# Keep ${URL} literal: Kitty substitutes the clicked task's link.
 protocol pi-note-preview
 action launch --type=background node /absolute/path/to/pi-note/preview-click.cjs ${URL}

package/package.json

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

package/task-suggestion.ts

@@ -3,6 +3,7 @@ import { stripVTControlCharacters } from "node:util";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { Theme } from "@earendil-works/pi-coding-agent";
 
+const pin = readFileSync(new URL("./icons/note.txt", import.meta.url), "utf8").trim();
 const check = readFileSync(new URL("./icons/check.txt", import.meta.url), "utf8").trim();
 const cross = readFileSync(new URL("./icons/cross.txt", import.meta.url), "utf8").trim();
 const link = (label: string, url?: string) => url ? `\x1b]8;;${url}\x07${label}\x1b]8;;\x07` : label;
@@ -11,10 +12,21 @@ export function renderSuggestion(
   task: { text: string; tag?: string }, width: number, theme: Pick<Theme, "fg">,
   urls: { yes?: string; no?: string },
 ): string {
-  const actions = `${theme.fg("success", link(check, urls.yes))}  ${theme.fg("error", link(cross, urls.no))}`;
-  const actionsWidth = visibleWidth(actions);
-  if (width <= actionsWidth + 2) return truncateToWidth(actions, width, "");
+  const cue = `${pin} ${theme.fg("accent", "Suggested:")}`;
+  const actions = (compact: boolean) => `${theme.fg("success", link(compact ? check : `${check} Add`, urls.yes))}  ${theme.fg("muted", link(compact ? cross : `${cross} Dismiss`, urls.no))}`;
+  let prefix = `${cue} ${actions(false)}`;
+  if (visibleWidth(prefix) > width) prefix = `${cue} ${actions(true)}`;
+  // Never show unexplained action icons when even the suggestion cue cannot fit.
+  if (visibleWidth(prefix) > width) return truncateToWidth(cue, width, "");
+  const remaining = width - visibleWidth(prefix) - 3; // separator: " · "
+  if (remaining < 4) return prefix;
   const clean = (value: string) => stripVTControlCharacters(value).replace(/[\x00-\x1f\x7f-\x9f]/gu, " ").replace(/\s+/gu, " ").trim();
-  const label = `[${clean(task.tag ?? "Untagged")}] ${clean(task.text.split("\n", 1)[0])}`;
-  return `${theme.fg("muted", truncateToWidth(label, Math.max(0, width - actionsWidth - 2), "..."))}  ${actions}`;
+  const tag = `[${clean(task.tag ?? "Untagged")}]`;
+  const title = clean(task.text.split("\n", 1)[0]);
+  // Drop the tag before sacrificing the title to a long tag or a small budget.
+  const tagWidth = visibleWidth(tag) + 1;
+  const label = remaining >= tagWidth + Math.min(12, visibleWidth(title))
+    ? `${theme.fg("muted", tag)} ${theme.fg("text", truncateToWidth(title, remaining - tagWidth, "..."))}`
+    : theme.fg("text", truncateToWidth(title, remaining, "..."));
+  return `${prefix}${theme.fg("muted", " · ")}${label}`;
 }

package/icons/eye.txt

@@ -1 +0,0 @@
-👁