pi-note 0.40.0 → 0.40.1

package/README.md

@@ -52,10 +52,11 @@ state routing, tools and UI.
 
 ## Use
 
-Open **`/pinote`** for the selected task's actions, pending suggestion, task picker
-and shared settings. **Choose a task… / Switch task…** opens task-only search:
-all search terms must match the title, description, tag or numeric ID. Results show
-status and the current selection; selection waits for fresh search results.
+Open **`/pinote`** for the searchable task list, newest-created first, with
+**+ New task** as its first option. All search terms must match the title,
+description, tag or numeric ID. Results show status and the current selection;
+selection waits for fresh search results. Selected-task and pending-suggestion
+actions follow the task results.
 Press **F1** on a result to read its full title and text without selecting it.
 Selecting a task starts it and returns to the unchanged prompt without another
 confirmation. **Clear selection** leaves its progress unchanged.
@@ -68,9 +69,10 @@ 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
-definitions. Editors accept plain text or numbers, not JSON; validation retains
-the draft. Cancelling a change's confirmation returns to its text draft. Values
+Press **Tab** for **Settings**: **Agent guidance**, **Fields**, **Task offers**,
+then **Footer layout**. **Tab** or **Escape** returns to tasks with the search
+retained. Editors accept plain text or numbers, not JSON; validation retains the
+draft. Cancelling a change's confirmation returns to its text draft. Values
 are saved only after review and confirmation.
 
 Menus use Pi's native inline components, themes and configured selection keys.
@@ -212,7 +214,7 @@ CLI/service instead of silently truncating.
 
 ### Field watchers (pi-note 0.40.0+)
 
-Open **Settings → Footer fields → Watchers** to enable bundled watchers or add a
+Open **Settings → Fields → Watchers** to enable bundled watchers or add a
 trusted executable on the service machine. Files in the packaged `watchers/`
 folder are discovered automatically, but remain disabled until enabled explicitly.
 Each watcher handles task-field changes and scheduled checks independently.
@@ -226,6 +228,10 @@ See [setup, script contract and safeguards](mcp/FIELD_EVENTS.md).
 
 ## Migration
 
+Since pi-note 0.40.1, `/pinote` opens tasks directly and **Tab** opens settings.
+Update both client and service for newest-created-first search results, then
+`/reload` Pi.
+
 Since pi-note 0.40.0, `fieldWatchers` replaces `fieldHandler`. Existing handlers
 appear disabled and need explicit re-enabling: enabling now authorizes automatic
 worker turns, not just notifications. Update/restart the service and `/reload` Pi.

package/dist-mcp/mcp/core.js

@@ -266,6 +266,8 @@ function view(data, scoped = false, secondary = false, features = {}) {
         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)));
+        // IDs are assigned by SQLite AUTOINCREMENT at creation and retained on edits/restores.
+        matches.sort((a, b) => b.id - a.id);
         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)

package/mcp/core.ts

@@ -234,6 +234,8 @@ 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)));
+    // IDs are assigned by SQLite AUTOINCREMENT at creation and retained on edits/restores.
+    matches.sort((a, b) => b.id - a.id);
     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.';
   }

package/package.json

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

package/remote/menu.ts

@@ -2,11 +2,12 @@ import { DynamicBorder, getSelectListTheme, keyText, type ExtensionContext } fro
 import { Input, Key, matchesKey, SelectList, truncateToWidth, visibleWidth, wrapTextWithAnsi, type Component, type Container, type TUI } from '@earendil-works/pi-tui';
 import { clean, editorText, type NativeView } from './protocol.ts';
 
-export interface MenuState { search: string; selected?: string; input?: Input }
+export interface MenuState { search: string; selected?: string; input?: Input; pendingSearch?: Promise<void> }
 export interface MenuChoice { id: string }
 export interface MenuOptions {
   search?: 'none' | 'local' | 'tasks';
   searchLabel?: string;
+  tab?: 'settings' | 'tasks';
   onSearch?: (query: string) => Promise<void>;
   notice?: string;
 }
@@ -55,21 +56,28 @@ export function remoteMenu(ctx: ExtensionContext, view: NativeView, state: MenuS
     const fresh = () => !tasks || state.search === String(view.state.search ?? '');
     const schedule = () => {
       clearTimeout(timer);
-      if (fresh() || !options.onSearch || searching || disposed) return;
+      if (fresh() || !options.onSearch || state.pendingSearch || disposed) return;
       timer = setTimeout(() => {
         if (disposed || signal.aborted) return;
         searching = true;
-        void options.onSearch!(state.search).catch(() => { error = 'Search unavailable · Ctrl+R refresh'; }).finally(() => {
+        const query = state.search;
+        const pending = options.onSearch!(query).catch(() => { error = 'Search unavailable · Ctrl+R refresh'; });
+        state.pendingSearch = pending;
+        void pending.then(() => {
+          if (state.pendingSearch === pending) state.pendingSearch = undefined;
           searching = false;
-          if (!disposed) tui.requestRender();
+          if (!disposed) { if (!error && state.search !== query) schedule(); tui.requestRender(); }
         });
       }, 250);
     };
+    // A notification can replace this component before its search action settles.
+    // Share the in-flight read so replacements never queue stale duplicate searches.
+    if (state.pendingSearch) void state.pendingSearch.then(() => { if (!disposed) { schedule(); tui.requestRender(); } });
     schedule();
     const activate = (preview = false) => {
       if (signal.aborted || !usable || !layout || !fresh() || searching || geometry !== `${tui.terminal.columns}:${tui.terminal.rows}:${inlineHeight(tui, tui.terminal.columns, component)}`) return;
       const item = list?.getSelectedItem();
-      if (item) done({ id: preview && tasks ? `__preview:${item.value.slice('select:'.length)}` : item.value });
+      if (item && (!preview || item.value.startsWith('select:'))) done({ id: preview ? `__preview:${item.value.slice('select:'.length)}` : item.value });
     };
     const component: Component & { dispose(): void; focused: boolean; capturesViewportInput: boolean } = {
       capturesViewportInput: true,
@@ -82,7 +90,7 @@ export function remoteMenu(ctx: ExtensionContext, view: NativeView, state: MenuS
         if (!usable) { layout = ''; return [truncateToWidth('Enlarge terminal · Esc back', width)]; }
         const compact = height < 18;
         const border = new DynamicBorder((s) => theme.fg('border', s)).render(width);
-        const hints = wrapTextWithAnsi(`${keyText('tui.select.up')}/${keyText('tui.select.down')} move · ${keyText('tui.select.confirm')} ${tasks ? 'select · F1 preview' : 'open'} · ${keyText('tui.select.cancel')} back · Ctrl+R refresh`, width);
+        const hints = wrapTextWithAnsi(`${keyText('tui.select.up')}/${keyText('tui.select.down')} move · ${keyText('tui.select.confirm')} ${tasks ? 'open · F1 preview task' : 'open'}${options.tab ? ` · ${keyText('tui.input.tab')} ${options.tab}` : ''} · ${keyText('tui.select.cancel')} back · Ctrl+R refresh`, width);
         const summary = (view.body ?? '').split('\n').flatMap((s) => wrapTextWithAnsi(clean(s), width - 2));
         const summaryLimit = compact ? 1 : 3;
         const header = [...border, theme.fg('accent', heading(view.title, width)),
@@ -98,12 +106,14 @@ export function remoteMenu(ctx: ExtensionContext, view: NativeView, state: MenuS
         if (layout !== signature) {
           layout = signature;
           list = new SelectList(filtered, capacity, {
-            ...getSelectListTheme(), noMatch: () => theme.fg('muted', tasks ? state.search ? '  No tasks match this search.' : '  No active tasks. Esc back to create one.' : '  No matching items.'),
+            ...getSelectListTheme(), noMatch: () => theme.fg('muted', tasks ? state.search ? '  No tasks match this search.' : '  No active tasks.' : '  No matching items.'),
           }, { minPrimaryColumnWidth: 12, maxPrimaryColumnWidth: Math.min(40, Math.floor(width * 0.6)) });
-          list.setSelectedIndex(Math.max(0, filtered.findIndex((item) => item.value === state.selected)));
+          const selected = filtered.some((item) => item.value === state.selected) ? state.selected
+            : tasks && state.search.trim() ? filtered.find((item) => item.value.startsWith('select:'))?.value : undefined;
+          list.setSelectedIndex(Math.max(0, filtered.findIndex((item) => item.value === selected)));
           list.onSelectionChange = (item) => { state.selected = item.value; };
           list.onSelect = () => activate(); list.onCancel = cancel;
-          if (list.getSelectedItem()) state.selected = list.getSelectedItem()!.value;
+          if (fresh() && list.getSelectedItem()) state.selected = list.getSelectedItem()!.value;
         }
         const selectedIndex = filtered.findIndex((item) => item.value === list?.getSelectedItem()?.value);
         const selected = filtered[selectedIndex];
@@ -122,7 +132,8 @@ export function remoteMenu(ctx: ExtensionContext, view: NativeView, state: MenuS
       handleInput(data) {
         if (keys.matches(data, 'tui.select.cancel') || matchesKey(data, Key.ctrl('c'))) cancel();
         else if (usable && geometry === `${tui.terminal.columns}:${tui.terminal.rows}:${inlineHeight(tui, tui.terminal.columns, component)}`) {
-          if (matchesKey(data, Key.ctrl('r'))) done({ id: '__refresh' });
+          if (options.tab && keys.matches(data, 'tui.input.tab')) done({ id: `__${options.tab}` });
+          else if (matchesKey(data, Key.ctrl('r'))) done({ id: '__refresh' });
           else if (tasks && matchesKey(data, Key.f1)) activate(true);
           else if (keys.matches(data, 'tui.select.confirm')) activate();
           else if (keys.matches(data, 'tui.select.pageUp') || keys.matches(data, 'tui.select.pageDown')) {

package/remote/navigation.ts

@@ -2,34 +2,30 @@ import { defaultFooterField, parseAgentGuidance, parseFooterConfig, parseHandoff
 import { parseFieldWatchers } from '../field-watchers.ts';
 import { clean, editorText, type NativeControl, type NativeView } from './protocol.ts';
 
-export type Screen = 'home' | 'tasks' | 'settings' | 'prompts' | 'footer' | 'fields' | 'field' | 'watchers';
+export type Screen = 'tasks' | 'settings' | 'prompts' | 'footer' | 'fields' | 'field' | 'watchers';
 const group = (id: Screen, label: string, description: string): NativeControl => ({ id: `__${id}`, label, description, kind: 'action' });
-export const parentScreen = (screen: Screen): Screen | undefined => ({ tasks: 'home', settings: 'home', prompts: 'settings', footer: 'settings', fields: 'settings', field: 'fields', watchers: 'fields' } as const)[screen as Exclude<Screen, 'home'>];
-export const serverScreen = (screen: Screen) => screen === 'home' || screen === 'tasks' ? 'tasks' : screen === 'field' ? 'field' : 'settings';
+export const parentScreen = (screen: Screen): Screen | undefined => ({ settings: 'tasks', prompts: 'settings', footer: 'settings', fields: 'settings', field: 'fields', watchers: 'fields' } as const)[screen as Exclude<Screen, 'tasks'>];
+export const serverScreen = (screen: Screen) => screen === 'tasks' ? 'tasks' : screen === 'field' ? 'field' : 'settings';
 
 /** Local navigation only. Server controls/revisions remain the authority for every action. */
 export function menuView(view: NativeView, screen: Screen): NativeView {
   const take = (...ids: string[]) => ids.flatMap((id) => view.controls.filter((c) => c.id === id));
   let controls: NativeControl[], title: string, body: string;
   switch (screen) {
-    case 'home':
-      title = 'Pinote'; body = view.body ?? '';
-      controls = [...take('preview', 'proposal:preview', 'proposal:accept', 'proposal:dismiss', 'continue'),
-        group('tasks', view.state.selectedId ? 'Switch task…' : 'Choose a task…', 'Search tasks by title, description, tag or #ID. Enter starts and selects the chosen task.'),
-        ...take('add'), group('settings', 'Settings…', 'Shared prompts, task suggestions and footer display settings.'), ...take('done', 'clear')];
-      break;
     case 'tasks':
-      title = 'Pinote / Tasks'; body = view.body ?? '';
-      controls = view.controls.filter((c) => c.id.startsWith('select:'));
+      title = 'Pinote'; body = view.body ?? '';
+      controls = [...take('add'), ...view.controls.filter((c) => c.id.startsWith('select:')),
+        ...take('preview', 'proposal:preview', 'proposal:accept', 'proposal:dismiss', 'continue', 'done', 'clear')];
+      if (!controls.some((c) => c.id.startsWith('select:'))) body = view.state.search ? 'No tasks match this search.' : 'No active tasks. Create one with + New task.';
       break;
     case 'settings':
       title = 'Pinote / Settings'; body = 'Shared service settings · affects all connected clients. Task values are unchanged.';
-      controls = [group('prompts', 'Prompts and agent guidance…', 'Edit shared task prompts and injected instructions.'),
-        ...take('taskOfferPolicy'), group('footer', 'Footer layout…', 'Set title/field widths and the maximum visible handoff fields.'),
-        group('fields', 'Footer fields…', 'Edit display definitions, not saved task values.')];
+      controls = [group('prompts', 'Agent guidance', 'Edit shared task prompts and injected instructions.'),
+        group('fields', 'Fields', 'Edit display definitions, not saved task values.'),
+        ...take('taskOfferPolicy'), group('footer', 'Footer layout', 'Set title/field widths and the maximum visible handoff fields.')];
       break;
     case 'prompts':
-      title = 'Pinote / Settings / Prompts'; body = 'Shared prompts and instructions · each change requires review and confirmation.';
+      title = 'Pinote / Settings / Agent guidance'; body = 'Shared prompts and instructions · each change requires review and confirmation.';
       controls = take('handoffPrompt', 'newSessionPrompt', 'agentGuidance', 'reset-agent-guidance');
       // The service deliberately omits oversized editors. Keep its explanation visible.
       if (view.body?.includes('editor limit')) body = view.body;
@@ -39,7 +35,7 @@ export function menuView(view: NativeView, screen: Screen): NativeView {
       controls = take('titleWidth', 'fieldWidth', 'maxFields');
       break;
     case 'fields':
-      title = 'Pinote / Settings / Footer fields'; body = 'Display definitions only. Populated task values appear in the footer.';
+      title = 'Pinote / Settings / Fields'; body = 'Display definitions only. Populated task values appear in the footer.';
       controls = [group('watchers', 'Watchers…', 'Bundled and custom field watchers; explicitly enable trusted code and automatic worker actions.'),
         ...view.controls.filter((c) => c.id.startsWith('field:')), ...take('add-field')];
       break;

package/remote/ui.ts

@@ -148,8 +148,11 @@ export class RemoteUI {
     this.opening = true;
     const current = this.session.current(), signal = this.session.signal;
     const menus = new Map<string, MenuState>(), drafts = new Map<string, Draft>();
-    let screen = 'home' as Screen, notice = '';
+    let screen = 'tasks' as Screen, notice = '';
     const go = async (next: Screen): Promise<boolean> => {
+      // Search changes view revisions. Navigate only after it settles, using fresh controls.
+      await menus.get('tasks')?.pendingSearch;
+      if (!current()) return false;
       const view = this.session.view;
       if (!view) return false;
       const target = serverScreen(next);
@@ -163,7 +166,7 @@ export class RemoteUI {
     };
     try {
       await this.refresh(ctx);
-      await go('home');
+      await go('tasks');
       while (current() && !signal.aborted && !this.closing) {
         if (this.failure || !this.session.view) {
           const failure = this.failure;
@@ -184,6 +187,7 @@ export class RemoteUI {
           this.menuChanged = changed;
           return () => { if (this.menuChanged === changed) this.menuChanged = undefined; };
         }, { search: screen === 'tasks' ? 'tasks' : screen === 'fields' ? 'local' : 'none', notice,
+          tab: screen === 'tasks' ? 'settings' : screen === 'settings' ? 'tasks' : undefined,
           searchLabel: screen === 'fields' ? 'Filter fields' : undefined,
           onSearch: async (query) => {
             const latest = this.session.view, control = latest?.controls.find((c) => c.id === 'search');