pi-note 0.22.0 → 0.23.0

package/README.md

@@ -1,5 +1,7 @@
 # pi-note
 
+[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,
 add, and tag-listing tools.
@@ -12,10 +14,8 @@ explicit initial-version limits; it is not activated by installing this extensio
 ## Install
 
 Requires Pi 0.99.1+, Node.js 22.19+ and **pinote 0.3.0+** (`note` on PATH). Add and tag listing need **pinote 0.4.0+**.
-From this checkout, install the extension with `pi install ./pi`, then run
-`/reload` in interactive Pi. The planned npm package name is `pi-note`; after its
-first release use `pi install npm:pi-note` instead. It is not published yet. npm
-installation does not run Python installers.
+Install with `pi install npm:pi-note`, or `pi install ./pi` from this checkout,
+then run `/reload` in interactive Pi. npm installation does not run Python installers.
 
 ### CLI setup and upgrades
 
@@ -390,13 +390,13 @@ data. Run visual checks under Xvfb/private D-Bus; never use personal task data.
 OIDC trusted publishing and provenance. Existing versions are skipped; registry
 failures fail the workflow. No npm token is stored in GitHub.
 
-One-time maintainer setup (not performed by installing this package):
+Only a package's first publication needs this manual bootstrap (not part of
+installation). `pi-note` is already published; use automated releases above.
 
 1. From `pi/`, run `npm login`, then `npm publish --ignore-scripts --access public`
    to bootstrap `pi-note` after checking name availability.
 2. In npm's package settings configure the GitHub trusted publisher: owner
    `kvidzibo`, repository `pinote`, workflow `publish.yml`, no environment.
-3. Add verified npm and Pi package-directory links here after publication.
 
 The CLI source pin in `setup.ts` must point to a verified immutable commit with a
 compatible Python package. Update it and the bundled-version setup text together

package/dist-mcp/mcp/server.js

@@ -27,7 +27,7 @@ const Action = z.object({ method: z.literal('native-ui/action'), params: z.objec
         uri: z.literal(URI), revision: z.string().min(1).max(256), action: z.string().min(1).max(256),
         value: z.union([z.string().max(20_000), z.number().finite(), z.boolean(), z.null()]).optional(), _meta: z.record(z.unknown()).optional(),
     }) });
-const server = new Server({ name: 'pinote', version: '0.22.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
+const server = new Server({ name: 'pinote', version: '0.23.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
 // Serialize complete read/check/write cycles even when a host sends parallel calls.
 let queue = Promise.resolve();
 function serial(run) {
@@ -137,7 +137,13 @@ function staleAction() {
 function secondaryActions(meta) {
     return z.object({ footerSecondaryActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success;
 }
-function view(data, scoped = false, secondary = false) {
+function footerFeatures(meta) {
+    return {
+        footerStyles: z.object({ footerStyles: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
+        footerDoubleActions: z.object({ footerDoubleActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
+    };
+}
+function view(data, scoped = false, secondary = false, features = {}) {
     const { tasks, task, config, revision } = data;
     const state = Context.parse({ conversationId: 'outgoing-state', state: { ...data.state, selectedId: task?.id ?? null } }).state;
     const controls = [];
@@ -196,11 +202,11 @@ function view(data, scoped = false, secondary = false) {
     const footer = [{ text: `${icons.note} `, width: 3 }];
     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}] ` : ''}${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: `${icons.add} `, action: 'proposal:accept', ...(secondary ? { secondaryAction: 'proposal:dismiss' } : {}), width: 3 });
-        footer.push({ text: `${state.proposal.tag ? `[${state.proposal.tag}] ` : ''}${state.proposal.text.split('\n')[0].slice(0, 2000)}`, width: config.config.titleWidth });
+        footer.push({ text: `${state.proposal.tag ? `[${state.proposal.tag}] ` : ''}${state.proposal.text.split('\n')[0].slice(0, 2000)}`, ...(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 });
@@ -256,7 +262,7 @@ server.setRequestHandler(ReadResourceRequestSchema, (request, extra) => serial(a
     if (request.params.uri !== URI)
         throw new Error('Unknown resource');
     const data = await snapshot(context(request.params._meta).state, extra.signal);
-    return { contents: [{ uri: URI, mimeType: MIME, text: JSON.stringify(view(data, scopedActions(request.params._meta), secondaryActions(request.params._meta))) }] };
+    return { contents: [{ uri: URI, mimeType: MIME, text: JSON.stringify(view(data, scopedActions(request.params._meta), secondaryActions(request.params._meta), footerFeatures(request.params._meta))) }] };
 }));
 server.setRequestHandler(Action, (request, extra) => serial(async () => {
     const state = context(request.params._meta).state;
@@ -354,7 +360,7 @@ server.setRequestHandler(Action, (request, extra) => serial(async () => {
         extra.signal.throwIfAborted();
         saveFooterConfig(cfg, before.config.raw, handoff, newSession, policy);
     }
-    const result = { view: view(await snapshot(next, extra.signal), scoped, secondaryActions(request.params._meta)), ...(draft ? { draft } : {}), ...(preview ? { preview } : {}) };
+    const result = { view: view(await snapshot(next, extra.signal), scoped, secondaryActions(request.params._meta), footerFeatures(request.params._meta)), ...(draft ? { draft } : {}), ...(preview ? { preview } : {}) };
     await server.notification({ method: 'notifications/native-ui/changed', params: { uri: URI } });
     return result;
 }));

package/mcp/README.md

@@ -18,11 +18,12 @@ npm --prefix pi ci --ignore-scripts
 npm --prefix pi run build:mcp
 ```
 
-Add a service to the gateway config (use absolute paths):
+Merge the service into your gateway's existing `mcpServers` map, preserving other
+services (use absolute paths). Do not mix `mcpServers` with the legacy `servers` key:
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "pinote": {
       "command": "node",
       "args": ["/absolute/path/to/pinote/pi/dist-mcp/mcp/server.js"],
@@ -54,13 +55,18 @@ normal personal data. No desktop notifications are sent.
   edits are rejected and unrelated settings are preserved. Invalid configuration
   fails closed; repair it manually rather than replacing it with defaults.
 - **Footer:** selected task plus configured fields; safe HTTP(S) links are clickable.
-  The title previews the task; **✔** completes it and clears the selection without
-  resetting the conversation or editor. Suggestions show only **✚**: left-click to
+  Single-click the active title to preview; double-click it to complete. **✔** also
+  completes and clears the selection without resetting the conversation or editor.
+  Suggested titles use italic accent text; double-click to accept/start, then the
+  title returns to normal text. Acceptance cannot reuse the same click capability
+  to complete. Styling/double-click require gateway 0.28.0+ and double-click needs
+  its updated Kitty mouse mapping (Ctrl+Shift+double-click in fullscreen).
+  Older hosts retain plain titles and icon actions. Suggestions show **✚**: left-click to
   create/start/select, right-click to dismiss. Right-click requires gateway 0.22.0+
   and its Kitty mouse mapping; **Dismiss suggestion** in the app menu remains the
   keyboard/older-host fallback. These use the gateway's generic footer actions, not a Pinote
-  extension or private handler. Install the gateway's Kitty protocol handler as
-  and right-click mouse mapping described in its native UI documentation. Existing
+  extension or private handler. Install the gateway's Kitty protocol handler
+  and right-click mouse mapping as described in its native UI documentation. Existing
   installations need to add the mapping and reload Kitty; package updates do not
   edit terminal configuration. App menus remain the keyboard fallback.
 - **Agent:** `propose`, `get_current`, `update_current`, `fields`, and `tags` are

package/mcp/server.ts

@@ -32,7 +32,7 @@ const Action = z.object({ method: z.literal('native-ui/action'), params: z.objec
   uri: z.literal(URI), revision: z.string().min(1).max(256), action: z.string().min(1).max(256),
   value: z.union([z.string().max(20_000), z.number().finite(), z.boolean(), z.null()]).optional(), _meta: z.record(z.unknown()).optional(),
 }) });
-const server = new Server({ name: 'pinote', version: '0.22.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
+const server = new Server({ name: 'pinote', version: '0.23.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
 // Serialize complete read/check/write cycles even when a host sends parallel calls.
 let queue = Promise.resolve();
 function serial<T>(run: () => Promise<T>): Promise<T> {
@@ -118,7 +118,13 @@ function staleAction(): never {
 function secondaryActions(meta: Record<string, unknown> | undefined): boolean {
   return z.object({ footerSecondaryActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success;
 }
-function view(data: Snapshot, scoped = false, secondary = false) {
+function footerFeatures(meta: Record<string, unknown> | undefined) {
+  return {
+    footerStyles: z.object({ footerStyles: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
+    footerDoubleActions: z.object({ footerDoubleActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
+  };
+}
+function view(data: Snapshot, scoped = false, secondary = false, features: { footerStyles?: boolean; footerDoubleActions?: boolean } = {}) {
   const { tasks, task, config, revision } = data;
   const state = Context.parse({ conversationId: 'outgoing-state', state: { ...data.state, selectedId: task?.id ?? null } }).state;
   const controls: Control[] = [];
@@ -164,13 +170,13 @@ function view(data: Snapshot, scoped = false, secondary = false) {
     for (const candidate of matches.slice(0, 200)) action(`select:${candidate.id}`, `${candidate.tag ? `[${candidate.tag}] ` : ''}${candidate.text.split('\n')[0]}`, { description: `#${candidate.id} · ${candidate.state}`, confirm: '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; url?: string; action?: string; secondaryAction?: string; width?: number }[] = [{ text: `${icons.note} `, width: 3 }];
+  const footer: { text: string; url?: string; action?: string; secondaryAction?: string; doubleAction?: string; style?: { italic: boolean; color: 'accent' }; width?: number }[] = [{ text: `${icons.note} `, width: 3 }];
   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}] ` : ''}${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: `${icons.add} `, action: 'proposal:accept', ...(secondary ? { secondaryAction: 'proposal:dismiss' } : {}), width: 3 });
-    footer.push({ text: `${state.proposal.tag ? `[${state.proposal.tag}] ` : ''}${state.proposal.text.split('\n')[0].slice(0, 2000)}`, width: config.config.titleWidth });
+    footer.push({ text: `${state.proposal.tag ? `[${state.proposal.tag}] ` : ''}${state.proposal.text.split('\n')[0].slice(0, 2000)}`, ...(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 });
   const titleParts = footer.length;
   if (task) {
@@ -211,7 +217,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => ({ resources: [
 server.setRequestHandler(ReadResourceRequestSchema, (request, extra) => serial(async () => {
   if (request.params.uri !== URI) throw new Error('Unknown resource');
   const data = await snapshot(context(request.params._meta).state, extra.signal);
-  return { contents: [{ uri: URI, mimeType: MIME, text: JSON.stringify(view(data, scopedActions(request.params._meta), secondaryActions(request.params._meta))) }] };
+  return { contents: [{ uri: URI, mimeType: MIME, text: JSON.stringify(view(data, scopedActions(request.params._meta), secondaryActions(request.params._meta), footerFeatures(request.params._meta))) }] };
 }));
 server.setRequestHandler(Action, (request, extra) => serial(async () => {
   const state = context(request.params._meta).state;
@@ -275,7 +281,7 @@ server.setRequestHandler(Action, (request, extra) => serial(async () => {
     extra.signal.throwIfAborted();
     saveFooterConfig(cfg, before.config.raw, handoff, newSession, policy);
   }
-  const result = { view: view(await snapshot(next, extra.signal), scoped, secondaryActions(request.params._meta)), ...(draft ? { draft } : {}), ...(preview ? { preview } : {}) };
+  const result = { view: view(await snapshot(next, extra.signal), scoped, secondaryActions(request.params._meta), footerFeatures(request.params._meta)), ...(draft ? { draft } : {}), ...(preview ? { preview } : {}) };
   await server.notification({ method: 'notifications/native-ui/changed', params: { uri: URI } });
   return result;
 }));

package/package.json

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