pi-note 0.39.2 → 0.39.4

package/README.md

@@ -13,6 +13,10 @@ Host Pi ── Pinote extension ──┐
 VM Pi ──── Pinote extension ──┘
 ```
 
+Compact suggestion and selected-task titles hide leading Markdown heading markers
+(`# ` through `###### `); saved task text and
+full Markdown previews keep the original source.
+
 Tasks, tags, progress and handoff fields are shared. Selection and pending
 suggestions belong to each Pi conversation/branch, not the HTTP connection.
 Other tools continue running wherever Pi and their services run.
@@ -58,9 +62,10 @@ confirmation. **Clear selection** leaves its progress unchanged.
 
 **Preview** opens a scrollable, read-only document. **Insert task prompt…** reviews
 and inserts into an empty editor only; it never submits or replaces a draft.
-Creation, suggestion acceptance and shared changes require complete review, then
-a separate Cancel-first confirmation. Menu completion also asks explicitly;
-footer double-click is sufficient approval. Both require idle Pi. Failed or uncertain
+Creation, menu suggestion acceptance and shared changes require complete review,
+then a separate Cancel-first confirmation. Menu completion also asks explicitly.
+Footer double-click directly approves suggestion acceptance or completion;
+completion requires idle Pi. Failed or uncertain
 writes offer refresh/verification, never automatic replay.
 
 **Settings** groups prompts/guidance, task-offer policy, footer layout and field
@@ -73,7 +78,8 @@ Menus use Pi's native inline components, themes and configured selection keys.
 Small terminals show compact menus or ask you to enlarge the window before acting.
 Fullscreen has a clickable footer: **▤** opens Pinote; single-click a task title
 to preview, or double-click to complete immediately without another confirmation
-(requires idle Pi). Suggestion titles only preview; double-click never accepts.
+(requires idle Pi). Single-click a suggestion title to preview it; double-click
+to accept, start and select it immediately without another confirmation.
 Regular mode shows status; `/pinote` provides all actions. No Kitty action handler
 is needed.
 
@@ -215,10 +221,14 @@ See [setup, script contract and safeguards](mcp/FIELD_EVENTS.md). Disabled by de
 
 ## Migration
 
+Since pi-note 0.39.3, fullscreen suggestion-title double-click accepts immediately;
+single-click still previews and menu acceptance still requires review/confirmation.
+Update both client and service, then `/reload` Pi.
+
 Since pi-note 0.39.2, fullscreen task-title double-click completes without another
 confirmation; single-click still previews and menu completion still confirms.
 Update the client and `/reload` Pi. The service must support footer double-click
-(pi-note 0.39.1+). Suggestion acceptance remains menu-only.
+(pi-note 0.39.1+).
 
 Since pi-note 0.38.0, the default HTTP extension uses task-first navigation and
 explicit completion/suggestion approval. Update the client and service together,

package/dist-mcp/mcp/core.js

@@ -13,6 +13,7 @@ import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
 import { stripVTControlCharacters } from 'node:util';
 import { defaultAgentGuidance, defaultFooterField, defaultHandoffPrompt, defaultNewSessionPrompt, effectiveFooterFields, parseAgentGuidance, parseFooterConfig, parseHandoffPrompt, parseNewSessionPrompt, readConfigDocument, readFooterDocument, saveFooterConfig } from "../footer-config.js";
 import { proposalTitleOptions, proposalDescriptionOptions, proposalText } from "../proposal.js";
+import { taskTitle } from "../task-title.js";
 const URI = 'pinote://ui';
 const MIME = 'application/vnd.mcp-native-ui+json';
 const AGENT_URI = 'pinote://agent-context';
@@ -195,7 +196,7 @@ function view(data, scoped = false, secondary = false, features = {}) {
     const controls = [];
     const action = (id, label, extra = {}) => controls.push({ id, label: label.slice(0, 2000), kind: 'action', ...extra });
     let title = 'Pinote · Tasks';
-    let body = task ? `#${task.id} · ${task.tag || 'No tag'} · ${humanStatus(task.state)} · CURRENT\n${task.text.split('\n')[0]}` : state.proposal ? `Suggestion only; no task is selected for this conversation.\n${suggestion.text.split('\n')[0]}` : 'Select a task or create one. No task is selected for this conversation.';
+    let body = task ? `#${task.id} · ${task.tag || 'No tag'} · ${humanStatus(task.state)} · CURRENT\n${taskTitle(task.text)}` : state.proposal ? `Suggestion only; no task is selected for this conversation.\n${taskTitle(suggestion.text)}` : 'Select a task or create one. No task is selected for this conversation.';
     // Footer actions remain valid on every screen, including Settings.
     if (task) {
         action('preview', 'Preview full task', { description: 'Display only; never sent to the model' });
@@ -253,7 +254,7 @@ function view(data, scoped = false, secondary = false, features = {}) {
             ? t.id === state.launch.task_id && t.updated_at === state.launch.updated_at
             : terms.every((term) => `${t.text} ${t.tag ?? ''} #${t.id}`.toLowerCase().includes(term)));
         for (const candidate of matches.slice(0, 200))
-            action(`select:${candidate.id}`, candidate.text.split('\n')[0], { description: `#${candidate.id} · ${candidate.tag || 'No tag'} · ${humanStatus(candidate.state)}${candidate.id === task?.id ? ' · CURRENT' : ''} · Select and start this task for this conversation` });
+            action(`select:${candidate.id}`, taskTitle(candidate.text), { description: `#${candidate.id} · ${candidate.tag || 'No tag'} · ${humanStatus(candidate.state)}${candidate.id === task?.id ? ' · CURRENT' : ''} · Select and start this task for this conversation` });
         if (matches.length > 200)
             body += '\nShowing the first 200 matches; use Filter tasks to narrow the list.';
     }
@@ -262,19 +263,19 @@ function view(data, scoped = false, secondary = false, features = {}) {
         : [{ text: `${icons.note} `, width: 3 }];
     if (features.footerNativeActions) {
         if (task)
-            footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', ...(features.footerDoubleActions ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
+            footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${taskTitle(task.text).slice(0, 2000)}`, action: 'preview', ...(features.footerDoubleActions ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
         else if (state.proposal)
-            footer.push({ text: `? ${suggestion.tag ? `[${suggestion.tag}] ` : ''}${suggestion.text.split('\n')[0].slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } } : {}), width: config.config.titleWidth });
+            footer.push({ text: `? ${suggestion.tag ? `[${suggestion.tag}] ` : ''}${taskTitle(suggestion.text).slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerDoubleActions ? { doubleAction: 'proposal:accept' } : {}), ...(features.footerStyles ? { style: { italic: true, color: 'accent' } } : {}), width: config.config.titleWidth });
         else
             footer.push({ text: 'Pinote · No task', width: config.config.titleWidth });
     }
     else if (task) {
         footer.push({ text: `${icons.check} `, action: 'done', width: 3 });
-        footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', width: config.config.titleWidth });
+        footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${taskTitle(task.text).slice(0, 2000)}`, action: 'preview', width: config.config.titleWidth });
     }
     else if (state.proposal) {
         footer.push({ text: `${icons.add} `, action: 'proposal:accept', ...(secondary ? { secondaryAction: 'proposal:dismiss' } : {}), width: 3 });
-        footer.push({ text: `${suggestion.tag ? `[${suggestion.tag}] ` : ''}${suggestion.text.split('\n')[0].slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } } : {}), width: config.config.titleWidth });
+        footer.push({ text: `${suggestion.tag ? `[${suggestion.tag}] ` : ''}${taskTitle(suggestion.text).slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } } : {}), width: config.config.titleWidth });
     }
     else
         footer.push({ text: 'Pinote · no task', width: config.config.titleWidth });
@@ -641,7 +642,7 @@ export function createPinoteServer(options = {}) {
                 const tasks = JSON.parse(await note(['list', '--json'], extra.signal));
                 const matches = tasks.filter((task) => words.every((word) => `${task.text} ${task.tag ?? ''}`.toLowerCase().includes(word)));
                 const page = matches.slice(args.offset, args.offset + args.limit);
-                result = { tasks: page.map(({ id, text, state, tag }) => ({ id, title: text.split('\n')[0].slice(0, 1000), state, tag })), total: matches.length, next_offset: args.offset + page.length < matches.length ? args.offset + page.length : null };
+                result = { tasks: page.map(({ id, text, state, tag }) => ({ id, title: taskTitle(text).slice(0, 1000), state, tag })), total: matches.length, next_offset: args.offset + page.length < matches.length ? args.offset + page.length : null };
             }
             else if (request.params.name === 'get_task') {
                 const args = ExistingProposal.parse(request.params.arguments);

package/dist-mcp/task-title.js

@@ -0,0 +1,4 @@
+/** Display-only title: keep Markdown source intact for editing and previews. */
+export function taskTitle(text) {
+    return text.split("\n", 1)[0].replace(/^ {0,3}#{1,6}[ \t]+/u, "");
+}

package/index.ts

@@ -11,6 +11,7 @@ import { FooterSettings, TaskMenu, withSettingsTab, type SettingsOption, type Se
 import { TaskPicker, taskState, taskTag } from "./task-picker.ts";
 import { bundledCLIVersion, detectCLI, setupCLI, setupHint, versionAtLeast, type CLIAction } from "./setup.ts";
 import { createPreviewBridge } from "./preview-bridge.ts";
+import { taskTitle } from "./task-title.ts";
 import { renderSuggestion, renderSelectedTask } from "./task-suggestion.ts";
 
 import { proposalTitleOptions, proposalDescriptionOptions, proposalText } from "./proposal.ts";
@@ -52,7 +53,7 @@ const record = (value: unknown): value is Record<string, unknown> =>
 const text = (value: unknown): value is string =>
   typeof value === "string" && !/[\x00-\x08\x0b-\x1f\x7f-\x9f]/u.test(value);
 const clean = (value: string) => stripVTControlCharacters(value).replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f]/gu, "�");
-const firstLine = (task: Summary) => clean(task.text.split("\n", 1)[0]).replace(/\s+/gu, " ").trim();
+const firstLine = (task: Summary) => clean(taskTitle(task.text)).replace(/\s+/gu, " ").trim();
 const title = (task: Summary) => truncateToWidth(`#${task.id} ${firstLine(task)}`, 60);
 
 function readConfig(): Record<string, unknown> {

package/mcp/core.ts

@@ -14,6 +14,7 @@ import { stripVTControlCharacters } from 'node:util';
 import { defaultAgentGuidance, defaultFooterField, defaultHandoffPrompt, defaultNewSessionPrompt, effectiveFooterFields, parseAgentGuidance, parseFooterConfig, parseHandoffPrompt, parseNewSessionPrompt, readConfigDocument, readFooterDocument, saveFooterConfig } from '../footer-config.ts';
 import { proposalTitleOptions, proposalDescriptionOptions, proposalText } from '../proposal.ts';
 import type { FieldAutomation, FieldResult } from './field-events.ts';
+import { taskTitle } from '../task-title.ts';
 
 const URI = 'pinote://ui';
 const MIME = 'application/vnd.mcp-native-ui+json';
@@ -175,7 +176,7 @@ function view(data: Snapshot, scoped = false, secondary = false, features: { foo
   const controls: Control[] = [];
   const action = (id: string, label: string, extra: Partial<Control> = {}) => controls.push({ id, label: label.slice(0, 2000), kind: 'action', ...extra });
   let title = 'Pinote · Tasks';
-  let body = task ? `#${task.id} · ${task.tag || 'No tag'} · ${humanStatus(task.state)} · CURRENT\n${task.text.split('\n')[0]}` : state.proposal ? `Suggestion only; no task is selected for this conversation.\n${suggestion!.text.split('\n')[0]}` : 'Select a task or create one. No task is selected for this conversation.';
+  let body = task ? `#${task.id} · ${task.tag || 'No tag'} · ${humanStatus(task.state)} · CURRENT\n${taskTitle(task.text)}` : state.proposal ? `Suggestion only; no task is selected for this conversation.\n${taskTitle(suggestion!.text)}` : 'Select a task or create one. No task is selected for this conversation.';
   // Footer actions remain valid on every screen, including Settings.
   if (task) {
     action('preview', 'Preview full task', { description: 'Display only; never sent to the model' });
@@ -221,22 +222,22 @@ function view(data: Snapshot, scoped = false, secondary = false, features: { foo
     const matches = tasks.filter((t) => state.launch
       ? t.id === state.launch.task_id && t.updated_at === state.launch.updated_at
       : terms.every((term) => `${t.text} ${t.tag ?? ''} #${t.id}`.toLowerCase().includes(term)));
-    for (const candidate of matches.slice(0, 200)) action(`select:${candidate.id}`, candidate.text.split('\n')[0], { description: `#${candidate.id} · ${candidate.tag || 'No tag'} · ${humanStatus(candidate.state)}${candidate.id === task?.id ? ' · CURRENT' : ''} · Select and start this task for this conversation` });
+    for (const candidate of matches.slice(0, 200)) action(`select:${candidate.id}`, taskTitle(candidate.text), { description: `#${candidate.id} · ${candidate.tag || 'No tag'} · ${humanStatus(candidate.state)}${candidate.id === task?.id ? ' · CURRENT' : ''} · Select and start this task for this conversation` });
     if (matches.length > 200) body += '\nShowing the first 200 matches; use Filter tasks to narrow the list.';
   }
   const footer: { text: string; openApp?: true; url?: string; action?: string; secondaryAction?: string; doubleAction?: string; style?: { italic?: boolean } & NonNullable<FieldResult['display']>; width?: number }[] = features.footerNativeActions
     ? [{ text: `${icons['open-app']} `, openApp: true, width: 3 }]
     : [{ text: `${icons.note} `, width: 3 }];
   if (features.footerNativeActions) {
-    if (task) footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', ...(features.footerDoubleActions ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
-    else if (state.proposal) footer.push({ text: `? ${suggestion!.tag ? `[${suggestion!.tag}] ` : ''}${suggestion!.text.split('\n')[0].slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } as const } : {}), width: config.config.titleWidth });
+    if (task) footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${taskTitle(task.text).slice(0, 2000)}`, action: 'preview', ...(features.footerDoubleActions ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
+    else if (state.proposal) footer.push({ text: `? ${suggestion!.tag ? `[${suggestion!.tag}] ` : ''}${taskTitle(suggestion!.text).slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerDoubleActions ? { doubleAction: 'proposal:accept' } : {}), ...(features.footerStyles ? { style: { italic: true, color: 'accent' } as const } : {}), width: config.config.titleWidth });
     else footer.push({ text: 'Pinote · No task', width: config.config.titleWidth });
   } else if (task) {
     footer.push({ text: `${icons.check} `, action: 'done', width: 3 });
-    footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', width: config.config.titleWidth });
+    footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${taskTitle(task.text).slice(0, 2000)}`, action: 'preview', width: config.config.titleWidth });
   } else if (state.proposal) {
     footer.push({ text: `${icons.add} `, action: 'proposal:accept', ...(secondary ? { secondaryAction: 'proposal:dismiss' } : {}), width: 3 });
-    footer.push({ text: `${suggestion!.tag ? `[${suggestion!.tag}] ` : ''}${suggestion!.text.split('\n')[0].slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } as const } : {}), width: config.config.titleWidth });
+    footer.push({ text: `${suggestion!.tag ? `[${suggestion!.tag}] ` : ''}${taskTitle(suggestion!.text).slice(0, 2000)}`, action: 'proposal:preview', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } as const } : {}), width: config.config.titleWidth });
   } else footer.push({ text: 'Pinote · no task', width: config.config.titleWidth });
   let fieldCount = 0;
   if (task) {
@@ -536,7 +537,7 @@ server.setRequestHandler(CallToolRequestSchema, (request, extra) => serial(async
       const tasks: Task[] = JSON.parse(await note(['list', '--json'], extra.signal));
       const matches = tasks.filter((task) => words.every((word) => `${task.text} ${task.tag ?? ''}`.toLowerCase().includes(word)));
       const page = matches.slice(args.offset, args.offset + args.limit);
-      result = { tasks: page.map(({ id, text, state, tag }) => ({ id, title: text.split('\n')[0].slice(0, 1000), state, tag })), total: matches.length, next_offset: args.offset + page.length < matches.length ? args.offset + page.length : null };
+      result = { tasks: page.map(({ id, text, state, tag }) => ({ id, title: taskTitle(text).slice(0, 1000), state, tag })), total: matches.length, next_offset: args.offset + page.length < matches.length ? args.offset + page.length : null };
     } else if (request.params.name === 'get_task') {
       const args = ExistingProposal.parse(request.params.arguments);
       result = JSON.parse(await note(['agent', 'get', String(args.task_id)], extra.signal));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-note",
-  "version": "0.39.2",
+  "version": "0.39.4",
   "description": "Persistent pinote tasks, Markdown handoffs, and task status for Pi",
   "license": "MIT",
   "type": "module",
@@ -42,6 +42,7 @@
     "footer-settings.ts",
     "task-picker.ts",
     "task-suggestion.ts",
+    "task-title.ts",
     "proposal.ts",
     "setup.ts",
     "preview-bridge.ts",

package/remote/ui.ts

@@ -43,8 +43,9 @@ export class RemoteUI {
           if (this.opening || this.acting) return false;
           if (item.openApp) { await this.open(ctx); return true; }
           const control = view.controls.find((c) => c.id === action && c.kind === 'action');
-          // The footer's deliberate double-click is already completion approval.
-          return control ? this.dispatch(ctx, view, control, undefined, action === 'done' && item.doubleAction === action) : false;
+          // Deliberate footer double-click approves completion or suggestion acceptance.
+          const approved = (action === 'done' || action === 'proposal:accept') && item.doubleAction === action;
+          return control ? this.dispatch(ctx, view, control, undefined, approved) : false;
         }, this.repaint);
     }, { placement: 'belowEditor' });
     this.render();
@@ -66,7 +67,7 @@ export class RemoteUI {
     }) : 'Pinote · unavailable (/pinote to reconnect)');
     this.repaint();
   }
-  async dispatch(ctx: ExtensionContext, view: NativeView, control: NativeControl, value?: NativeControl['value'], completionConfirmed = false): Promise<boolean> {
+  async dispatch(ctx: ExtensionContext, view: NativeView, control: NativeControl, value?: NativeControl['value'], footerConfirmed = false): Promise<boolean> {
     if (ctx.mode !== 'tui') throw new Error('Pinote UI actions require TUI mode');
     if (this.acting) return false;
     if (control.id === 'done' && !ctx.isIdle()) {
@@ -76,14 +77,14 @@ export class RemoteUI {
     const current = this.session.current(), signal = this.session.signal;
     try {
       if (typeof value === 'string') editorText(value);
-      if (control.id === 'done' && !completionConfirmed) {
+      if (control.id === 'done' && !footerConfirmed) {
         const exits = typeof view.state.selectedId === 'number' && this.exitOnComplete(view.state.selectedId);
         const accept = exits ? 'Complete task and exit' : 'Complete task';
         const summary = truncateToWidth(line(view.body ?? ''), 100);
         if (await ctx.ui.select(`Pinote / ${accept} #${view.state.selectedId}\n${summary}\n${exits ? 'Closes this dedicated Pi session.' : 'Clears selection; keeps this conversation and editor.'}`,
           ['Cancel', accept], { signal }) !== accept) return false;
       }
-      if (control.confirm) {
+      if (control.confirm && !(footerConfirmed && control.id === 'proposal:accept')) {
         const details = control.kind === 'action' ? control.confirm : `${control.confirm}\n\n${control.id === 'add' || control.id === 'add-field' ? '' : `Before:\n${disclosure(control.value)}\n\n`}After:\n${disclosure(value)}`;
         const accept = control.id === 'add' ? 'Create, start and select' : control.id === 'proposal:accept' ? 'Accept suggestion' :
           control.id === 'remove-field' ? 'Remove display field' : control.id === 'add-field' ? 'Add field' : 'Save change';

package/task-suggestion.ts

@@ -1,4 +1,5 @@
 import { readFileSync } from "node:fs";
+import { taskTitle } from "./task-title.ts";
 import { stripVTControlCharacters } from "node:util";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { Theme } from "@earendil-works/pi-coding-agent";
@@ -20,7 +21,7 @@ function renderTask(task: Task, width: number, theme: Colors, prefix: string, pr
   if (remaining < 4) return prefix.trimEnd();
   const clean = (value: string) => stripVTControlCharacters(value).replace(/[\x00-\x1f\x7f-\x9f]/gu, " ").replace(/\s+/gu, " ").trim();
   const tag = `[${clean(task.tag ?? "Untagged")}]`;
-  const title = clean(task.text.split("\n", 1)[0]);
+  const title = clean(taskTitle(task.text));
   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, "..."))}`

package/task-title.ts

@@ -0,0 +1,4 @@
+/** Display-only title: keep Markdown source intact for editing and previews. */
+export function taskTitle(text: string): string {
+  return text.split("\n", 1)[0].replace(/^ {0,3}#{1,6}[ \t]+/u, "");
+}