pi-note 0.13.1 → 0.13.2

package/README.md

@@ -171,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
@@ -183,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
@@ -216,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

package/index.ts

@@ -131,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;
@@ -142,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;
@@ -266,13 +271,13 @@ export default function (pi: ExtensionAPI) {
         const url = previewBridge?.url();
         // 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", label && url ? `\x1b]8;;${url}\x07${label}\x1b]8;;\x07` : label);
+        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"}`);
       }
     }
   };
@@ -661,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 })),
@@ -681,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-note",
-  "version": "0.13.1",
+  "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}`;
 }