pi-note 0.9.0 → 0.10.0

package/README.md

@@ -61,12 +61,15 @@ standalone `settings/pi/extensions/pinote.ts` entry if installed; load only one
 The agent fetches current task text and saved handoff fields when you submit;
 they are not copied into the draft. The default prompt asks for a summary, not implementation.
 Existing drafts are preserved; nothing is submitted automatically.
-With a selected task it offers **Continue**, **Done**, and **Switch task**.
+With a selected task it offers **Continue**, **Done**, **Switch task**, and **Settings**.
+Press **Tab** from the task menu or picker to open global footer settings; Tab
+returns to tasks without saving. Settings also lists fields found on the current
+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 60 terminal columns including the pin and tag.
+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 the terminal's emoji font, not a Nerd Font or icon theme.
 
 Each Pi session remembers its own task, including several sessions in one folder.
@@ -123,6 +126,10 @@ user-level configuration only; project-local files are not read.
   ID argument. Updates merge fields, never replace the task text or tag. Fails if
   no task is selected or the selection changes during the operation. If another
   process changed the task, read again before retrying.
+- `pinote_fields`: read the user's global footer definitions (names, display labels,
+  links, formats, widths), even without a task. Agents should read this before
+  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_add`: create an active task. Optional `tag`. `select: true` starts and
   remembers it for this session only; use that only after the user agrees.
@@ -138,13 +145,14 @@ user asks to switch. Reuse a saved tag name when it fits.
 
 Agents are guided to keep notes to three short bullets total: relevant outcome,
 blocker, and next action. Replace stale notes; omit narration, repeated task text,
-and routine test logs. Keep a GitHub pull request in `PR`. To show another footer
-field, set its Markdown value and append its label to `Bar`, one label per line.
-Do not list `PR` in `Bar`. Remove the field and its `Bar` line to drop it. This is
-guidance, not truncation or a storage limit.
+and routine test logs. Keep a GitHub pull request in `PR`. Set configured footer
+fields with Markdown values; remove a field to hide it. Without a configured field
+list, append its label to `Bar`, one label per line. Do not list `PR` in `Bar`.
+Agents use `pinote_update_current`; there is no separate `add_to_bottom_bar` tool.
+This is guidance, not truncation or a storage limit.
 
 Values are Markdown strings; no fields are required. `PR` enables the watcher below.
-`Bar` chooses extra footer fields:
+`Bar` chooses extra footer fields unless configuration overrides it:
 
 ```markdown
 # Agent
@@ -163,31 +171,90 @@ sessions. Labels are case-sensitive (trimmed, Unicode-normalized), at most 64
 characters; values are at most 4096 characters. Maximum 64 fields / 32 KiB JSON
 per task. Use removal rather than empty values.
 
+### Footer configuration
+
+Add `footer` to `~/.pi/agent/pi-note.json` (or `pi-note.json` under
+`PI_CODING_AGENT_DIR`), preserving any existing `handoffPrompt`:
+
+```json
+{
+  "footer": {
+    "titleWidth": 40,
+    "fieldWidth": 30,
+    "maxFields": 4,
+    "fields": [
+      { "name": "PR", "label": "", "link": true, "format": "#<number>" },
+      { "name": "Dashboard", "label": "Dashboard", "link": true, "format": "<value>" },
+      { "name": "Next", "label": "", "link": false, "format": "<value>", "width": 24 }
+    ]
+  }
+}
+```
+
+Widths are terminal columns, including icons/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`.
+Names are case-sensitive, trimmed and NFC-normalized, at most 64 characters;
+`Bar` is reserved and duplicate names are rejected. Up to 64 definitions are
+accepted. Missing/blank values do not display and do not consume the field limit.
+`[]` or `maxFields: 0` hides configured fields, including PR.
+
+In `/pi-note → Settings`, **Add field** adds a global display definition, not a
+task value. Select any field to edit **Link**, **Label**, **Format**, and **Width**.
+Label starts as the field name; clear it for no prefix. Link off displays plain
+text without a clickable link. **Save** persists the draft; cancellation leaves
+configuration untouched. Saves preserve unrelated settings (`handoffPrompt`,
+`taskOfferPolicy`) and reject configuration changes made while the dialog was open.
+Concurrent saves use `pi-note.json.lock`; remove stale locks only when no save is
+running. Symlinked configuration must be edited manually; saves never replace the link.
+
+Formats support `<value>` (Markdown display text), `<url>` (one safe link target),
+and `<number>` (a GitHub PR number or numeric field value). With a blank label,
+PR format `#<number>` displays `#123`; Link on makes it clickable. An unavailable
+placeholder hides the field. The template is literal text, not executable code
+or Markdown. Default format is `<value>`, or `#<number>` for PR.
+String definitions and the older `{ "label": "Next", "width": 24 }` form still
+work. Absent/`null` fields retain the legacy automatic PR link plus `Bar` fields;
+the first Settings save turns this legacy list into explicit global definitions.
+
+Settings saves apply immediately in this Pi session. Run `/reload` after manual
+footer edits or in other running sessions; settings are also reread on session start.
+Invalid footer configuration warns and uses footer defaults; missing files silently
+use defaults. This does not validate or change `handoffPrompt`, which is read
+separately on selection/Continue as described above.
+This is user-level configuration, not task data; agents should not change it
+without approval. Task values still come from `pinote_update_current`.
+
 ### Footer links
 
 The selected active or in-progress task can show fields after its title.
-`PR` is always shown when it matches the watcher format below, as **PR #123**.
-`Bar` is a newline-separated list of other field labels. Each listed value is
+Legacy configuration automatically shows a valid `PR` as **PR #123**.
+With an explicit field list, PR presentation is configured like any other field.
+Configured `fields`, or otherwise `Bar`, selects field names. Each listed value is
 Markdown: the footer shows its text, and links in it are clickable for any scheme
 except `javascript:`, `data:`, and `vbscript:`. Credentials, control characters,
 and targets over 2048 characters after serialization are shown as text but not
-linked. Missing labels and the `PR` and `Bar` labels themselves are skipped.
-At most four extra fields are shown, each truncated to 60 columns. Removing a listed
-field hides it even if `Bar` still names it. Terminal OSC 8 support is required
-for clicking links. Pi joins footer statuses on one line, so a narrow terminal can
-ellipsize later fields. Other fields, such as `Jira` and `CWD` in the example, stay
-off the footer unless named in `Bar`.
+linked. `Bar` itself is never displayed.
+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
+`CWD` in the example, stay off the footer unless selected.
 
 ### PR merge watcher
 
 Set `PR` with `pinote_update_current` to one `https://github.com/owner/repo/pull/123` URL
-or Markdown link. The footer adds a clickable, link-coloured **PR #123**, without
-status text. Other hosts, multiple links, and prose are not watched.
+or Markdown link. Legacy footer settings show a clickable **PR #123**; global
+field settings can change or hide that presentation without disabling the watcher.
+Other hosts, multiple links, and prose are not watched.
 
 Interactive Pi checks only the selected task's PR using authenticated `gh`
 (`gh auth login`). Polling defaults to 60 seconds; launch Pi with
 `PINOTE_PR_POLL_SECONDS=120 pi` to change it, or `0` to disable polling.
-Allowed intervals are 10–86400 seconds. The selected task's link remains visible when polling is disabled.
+Allowed intervals are 10–86400 seconds. Configured links remain visible when polling is disabled.
 Network/authentication failures warn once until recovery and retry next interval.
 No polling runs in print/RPC mode or after Pi exits.
 

package/footer-config.ts

@@ -0,0 +1,114 @@
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { closeSync, lstatSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+
+export type FooterField = { name: string; label: string; link: boolean; format: string; width?: number };
+export type FooterConfig = { titleWidth: number; fieldWidth: number; maxFields: number; fields: FooterField[] | null };
+export const defaultFooterConfig: FooterConfig = { titleWidth: 60, fieldWidth: 60, maxFields: 4, fields: null };
+export const defaultFooterField = (name: string): FooterField => ({
+  name, label: name, link: true, format: name === "PR" ? "#<number>" : "<value>",
+});
+const object = (value: unknown): value is Record<string, unknown> =>
+  value !== null && typeof value === "object" && !Array.isArray(value);
+const width = (value: unknown): value is number => Number.isInteger(value) && Number(value) >= 3 && Number(value) <= 1000;
+const safeText = (value: unknown): value is string => typeof value === "string" && !/[\x00-\x1f\x7f-\x9f]/u.test(value);
+
+export function parseFooterConfig(value: unknown): FooterConfig {
+  if (!object(value)) throw new Error("expected an object");
+  if (value.footer === undefined) return { ...defaultFooterConfig };
+  if (!object(value.footer)) throw new Error("footer must be an object");
+  const footer = value.footer;
+  for (const key of ["titleWidth", "fieldWidth"] as const) {
+    if (footer[key] !== undefined && !width(footer[key])) throw new Error(`${key} must be an integer from 3 to 1000`);
+  }
+  if (footer.maxFields !== undefined &&
+      (!Number.isInteger(footer.maxFields) || Number(footer.maxFields) < 0 || Number(footer.maxFields) > 64)) {
+    throw new Error("maxFields must be an integer from 0 to 64");
+  }
+  let fields: FooterField[] | null = null;
+  if (footer.fields !== undefined && footer.fields !== null) {
+    if (!Array.isArray(footer.fields) || footer.fields.length > 64) throw new Error("fields must be null or an array of at most 64 fields");
+    const seen = new Set<string>();
+    fields = footer.fields.map((entry): FooterField => {
+      const field = typeof entry === "string" ? { name: entry } : entry;
+      if (!object(field)) throw new Error("each field needs a name");
+      // Accept the original {label: name, width} form as well as explicit names.
+      const source = field.name === undefined ? field.label : field.name;
+      if (!safeText(source)) throw new Error("invalid field name");
+      const name = source.normalize("NFC").trim();
+      if (!name || [...name].length > 64 || name === "Bar") throw new Error("invalid field name");
+      if (seen.has(name)) throw new Error("duplicate field name");
+      seen.add(name);
+      const label = field.name === undefined ? name : field.label === undefined ? name : field.label;
+      const format = field.format === undefined ? defaultFooterField(name).format : field.format;
+      if (!safeText(label) || [...label].length > 64) throw new Error("invalid display label");
+      if (!safeText(format) || format.length > 4096 || /<(?!value>|number>|url>)[^>]*>/u.test(format)) {
+        throw new Error("format supports only <value>, <number>, and <url>");
+      }
+      if (field.link !== undefined && typeof field.link !== "boolean") throw new Error("link must be a boolean");
+      if (field.width !== undefined && !width(field.width)) throw new Error("field width must be an integer from 3 to 1000");
+      return { name, label, link: field.link as boolean | undefined ?? true, format,
+        ...(field.width === undefined ? {} : { width: field.width as number }) };
+    });
+  }
+  return {
+    titleWidth: footer.titleWidth as number | undefined ?? defaultFooterConfig.titleWidth,
+    fieldWidth: footer.fieldWidth as number | undefined ?? defaultFooterConfig.fieldWidth,
+    maxFields: footer.maxFields as number | undefined ?? defaultFooterConfig.maxFields, fields,
+  };
+}
+
+function readRaw(): string | null {
+  try { return readFileSync(join(getAgentDir(), "pi-note.json"), "utf8"); }
+  catch (error) { if ((error as NodeJS.ErrnoException).code === "ENOENT") return null; throw error; }
+}
+export function readFooterDocument() {
+  const raw = readRaw();
+  let value: unknown = {};
+  if (raw !== null) {
+    try { value = JSON.parse(raw); } catch { throw new Error("Invalid JSON in pi-note.json."); }
+  }
+  return { raw, config: parseFooterConfig(value) };
+}
+export function loadFooterConfig(warn: (message: string) => void): FooterConfig {
+  try { return readFooterDocument().config; }
+  catch {
+    warn("Cannot load pi-note.json; using default Pinote footer settings. Check the footer configuration in pi-note's README.");
+    return { ...defaultFooterConfig };
+  }
+}
+
+// Synchronous compare-and-replace: reject edits made while the settings dialog was open,
+// preserve unrelated keys (including handoffPrompt), and never leave partial JSON behind.
+export function saveFooterConfig(config: FooterConfig, expectedRaw: string | null): FooterConfig {
+  const checked = parseFooterConfig({ footer: config });
+  const directory = getAgentDir();
+  mkdirSync(directory, { recursive: true });
+  const path = join(directory, "pi-note.json");
+  const lock = join(directory, "pi-note.json.lock");
+  let descriptor: number;
+  try { descriptor = openSync(lock, "wx", 0o600); }
+  catch { throw new Error("Pinote settings are locked. Retry after another save finishes; remove a stale pi-note.json.lock only when no save is running."); }
+  const temp = join(directory, `.pi-note-${randomUUID()}.tmp`);
+  try {
+    if (readRaw() !== expectedRaw) throw new Error("Pi-note configuration changed while settings were open. Reopen settings before saving.");
+    if (lstatSync(path, { throwIfNoEntry: false })?.isSymbolicLink()) throw new Error("pi-note.json is a symlink. Edit its target manually rather than replacing the link.");
+    const root = expectedRaw === null ? {} : JSON.parse(expectedRaw);
+    if (!object(root)) throw new Error("Invalid pi-note configuration; expected an object.");
+    writeFileSync(temp, `${JSON.stringify({ ...root, footer: checked }, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+    renameSync(temp, path);
+  } finally { rmSync(temp, { force: true }); closeSync(descriptor); rmSync(lock, { force: true }); }
+  return checked;
+}
+
+export function effectiveFooterFields(config: FooterConfig, notes: Record<string, string> = {}): FooterField[] {
+  if (config.fields !== null) return config.fields;
+  const seen = new Set(["Bar"]);
+  return ["PR", ...(notes.Bar ?? "").split("\n")].flatMap((raw) => {
+    const name = raw.normalize("NFC").trim();
+    if (!name || seen.has(name)) return [];
+    seen.add(name);
+    return [defaultFooterField(name)];
+  });
+}

package/footer-links.ts

@@ -1,11 +1,10 @@
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { stripVTControlCharacters } from "node:util";
+import { defaultFooterConfig, defaultFooterField, type FooterConfig, type FooterField } from "./footer-config.ts";
 
 export const footerStatusKey = "pinote-links";
 export const legacyFooterStatusKey = "pinote-pr";
-const maxCustomChips = 4;
 const maxLabelWidth = 24;
-const maxChipWidth = 60;
 const maxUrlLength = 2048;
 const blockedProtocols = new Set(["javascript:", "data:", "vbscript:"]);
 const control = /[\u0000-\u001f\u007f-\u009f]/u;
@@ -167,32 +166,57 @@ export function renderMarkdown(value: string | undefined): FooterSegment[] {
 }
 
 function truncateSegments(segments: readonly FooterSegment[], width: number): FooterSegment[] {
+  if (segments.reduce((sum, segment) => sum + visibleWidth(segment.text), 0) <= width) return [...segments];
   const kept: FooterSegment[] = [];
-  let used = 0;
+  let room = width - 3;
   for (const segment of segments) {
-    if (used >= width) break;
-    const room = width - used;
-    const text = visibleWidth(segment.text) <= room ? segment.text : clip(segment.text, room);
-    if (!text) break;
-    kept.push(segment.url ? { text, url: segment.url } : { text });
-    used += visibleWidth(text);
+    if (room <= 0) break;
+    const text = stripVTControlCharacters(truncateToWidth(segment.text, room, ""));
+    if (text) kept.push(segment.url ? { text, url: segment.url } : { text });
+    room -= visibleWidth(text);
+    if (text !== segment.text) break;
   }
+  // Keep the ellipsis outside hyperlinks, including cuts at segment boundaries.
+  kept.push({ text: "..." });
   return kept;
 }
 
-export function customFooterChips(notes: Record<string, string> | undefined): FooterChip[] {
+function fieldSegments(field: FooterField, value: string | undefined): FooterSegment[] {
+  if (!value?.trim()) return [];
+  const original = renderMarkdown(value);
+  const urls = [...new Set(original.flatMap((part) => part.url ? [part.url] : []))];
+  const url = urls.length === 1 ? urls[0] : undefined;
+  const number = url && /^https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/([1-9][0-9]*)\/?$/u.exec(url)?.[1]
+    || (/^[0-9]+$/u.test(value.trim()) ? value.trim() : undefined);
+  if (field.format.includes("<number>") && !number || field.format.includes("<url>") && !url) return [];
+  let body: FooterSegment[];
+  if (field.format === "<value>") body = original;
+  else {
+    const shown = plain(field.format.replace(/<(value|number|url)>/gu, (_match, key: string) =>
+      ({ value: original.map((part) => part.text).join(""), number: number ?? "", url: url ?? "" })[key as "value" | "number" | "url"]));
+    body = shown ? [url ? { text: shown, url } : { text: shown }] : [];
+  }
+  if (!field.link) body = body.map((part) => ({ text: part.text }));
+  if (!body.length) return [];
+  const label = clip(field.label, maxLabelWidth);
+  return [...(label ? [{ text: `${label}: ` }] : []), ...body];
+}
+
+export function customFooterChips(
+  notes: Record<string, string> | undefined, config: FooterConfig = defaultFooterConfig,
+): FooterChip[] {
   if (!notes) return [];
   const chips: FooterChip[] = [];
-  const seen = new Set(["PR", "Bar"]);
-  for (const raw of (notes.Bar ?? "").split("\n")) {
-    if (chips.length >= maxCustomChips) break;
-    const name = raw.normalize("NFC").trim();
+  const seen = new Set(config.fields === null ? ["PR", "Bar"] : ["Bar"]);
+  const fields: FooterField[] = config.fields ?? (notes.Bar ?? "").split("\n").map(defaultFooterField);
+  for (const field of fields) {
+    if (chips.length >= config.maxFields) break;
+    const name = field.name.normalize("NFC").trim();
     if (!name || seen.has(name)) continue;
     seen.add(name);
-    const label = clip(name, maxLabelWidth);
-    const body = renderMarkdown(ownText(notes, name));
-    if (!label || !body.length) continue;
-    chips.push({ segments: truncateSegments([{ text: `${label}: ` }, ...body], maxChipWidth) });
+    const segments = fieldSegments(field, ownText(notes, name));
+    if (!segments.length) continue;
+    chips.push({ segments: truncateSegments(segments, field.width ?? config.fieldWidth) });
   }
   return chips;
 }
@@ -200,11 +224,12 @@ export function customFooterChips(notes: Record<string, string> | undefined): Fo
 export function footerChips(
   task: { state: string; agent_notes: Record<string, string> } | null,
   pr: { url: string; number: string } | undefined,
+  config: FooterConfig = defaultFooterConfig,
 ): FooterChip[] {
   if (!task || !["active", "in_progress"].includes(task.state)) return [];
   return [
-    ...(pr ? [{ segments: [{ text: `PR #${pr.number}`, url: pr.url }] }] : []),
-    ...customFooterChips(task.agent_notes),
+    ...(config.fields === null && pr ? [{ segments: [{ text: `PR #${pr.number}`, url: pr.url }] }] : []),
+    ...customFooterChips(task.agent_notes, config),
   ];
 }
 

package/footer-settings.ts

@@ -0,0 +1,180 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { Input, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
+import { defaultFooterField, parseFooterConfig, type FooterConfig, type FooterField } from "./footer-config.ts";
+
+type Matches = (data: string, action: string) => boolean;
+type Row = { label: string; action: () => void };
+const isTab = (data: string) => matchesKey(data, "tab") || matchesKey(data, "shift+tab");
+const display = (value: string) => value.replace(/[\x00-\x1f\x7f-\x9f]/gu, " ");
+const actions = ["Continue", "Done", "Switch task", "Settings"];
+
+export class TaskMenu {
+  private index = 0;
+  private title: string;
+  private theme: Theme;
+  private matches: Matches;
+  private done: (action: string | undefined) => void;
+  private requestRender: () => void;
+  constructor(title: string, theme: Theme, matches: Matches,
+    done: (action: string | undefined) => void, requestRender: () => void) {
+    this.title = title; this.theme = theme; this.matches = matches;
+    this.done = done; this.requestRender = requestRender;
+  }
+  handleInput(data: string) {
+    if (isTab(data)) this.done("Settings");
+    else if (this.matches(data, "tui.select.up")) this.index = (this.index + actions.length - 1) % actions.length;
+    else if (this.matches(data, "tui.select.down")) this.index = (this.index + 1) % actions.length;
+    else if (this.matches(data, "tui.select.confirm")) this.done(actions[this.index]);
+    else if (this.matches(data, "tui.select.cancel")) this.done(undefined);
+    this.requestRender();
+  }
+  render(width: number) {
+    return [this.theme.fg("accent", this.title), this.theme.fg("dim", "Tasks · Settings (Tab)"),
+      ...actions.map((action, index) => index === this.index ? this.theme.fg("accent", `> ${action}`) : `  ${action}`),
+      this.theme.fg("dim", "↑↓ navigate · Enter select · Esc cancel")].map((line) => truncateToWidth(line, width));
+  }
+  invalidate() {}
+}
+
+export class FooterSettings {
+  private draft: FooterConfig;
+  private knownFields: string[];
+  private theme: Theme;
+  private matches: Matches;
+  private done: (result: FooterConfig | "tasks" | undefined) => void;
+  private requestRender: () => void;
+  private index = 0;
+  private field?: FooterField;
+  private input?: { widget: Input; apply: (value: string) => void; heading: string };
+  private error = "";
+  private hasFocus = false;
+
+  constructor(config: FooterConfig, knownFields: string[], theme: Theme, matches: Matches,
+    done: (result: FooterConfig | "tasks" | undefined) => void, requestRender: () => void) {
+    this.draft = structuredClone(config);
+    this.draft.fields ??= [];
+    this.knownFields = [...new Set(knownFields)].filter((name) => name !== "Bar");
+    this.theme = theme; this.matches = matches; this.done = done; this.requestRender = requestRender;
+  }
+  get focused() { return this.hasFocus; }
+  set focused(value: boolean) { this.hasFocus = value; if (this.input) this.input.widget.focused = value; }
+
+  private ask(heading: string, value: string, apply: (value: string) => void) {
+    const widget = new Input();
+    widget.setValue(value); widget.focused = this.hasFocus;
+    this.input = { widget, heading, apply }; this.error = "";
+  }
+  private validate(field: FooterField): FooterField {
+    return parseFooterConfig({ footer: { fields: [field] } }).fields![0];
+  }
+  private edit(name: string) {
+    this.field = structuredClone(this.draft.fields!.find((field) => field.name === name) ?? defaultFooterField(name));
+    this.index = 0; this.error = "";
+  }
+  private rootRows(): Row[] {
+    const rows: Row[] = (["titleWidth", "fieldWidth", "maxFields"] as const).map((key) => ({
+      label: `${{ titleWidth: "Title width", fieldWidth: "Default field width", maxFields: "Max fields" }[key]}: ${this.draft[key]}`,
+      action: () => this.ask(key, String(this.draft[key]), (value) => {
+        const candidate = { ...this.draft, [key]: Number(value) };
+        if (!value.trim()) throw new Error("Enter a number.");
+        this.draft = parseFooterConfig({ footer: candidate });
+      }),
+    }));
+    const configured = this.draft.fields!.map((field) => field.name);
+    for (const name of [...configured, ...this.knownFields.filter((name) => !configured.includes(name))]) {
+      rows.push({ label: `Field: ${display(name)}${configured.includes(name) ? "" : " (not configured)"}`, action: () => this.edit(name) });
+    }
+    rows.push({ label: "+ Add field", action: () => this.ask("Field name", "", (value) => {
+      const field = this.validate(defaultFooterField(value));
+      this.edit(field.name);
+    }) }, { label: "Save settings", action: () => this.done(parseFooterConfig({ footer: this.draft })) },
+    { label: "Return to tasks", action: () => this.done("tasks") });
+    return rows;
+  }
+  private fieldRows(): Row[] {
+    const field = this.field!;
+    const rows: Row[] = [
+      { label: `Link: ${field.link ? "on" : "off (plain text)"}`, action: () => { field.link = !field.link; } },
+      { label: `Label: ${display(field.label) || "(none)"}`, action: () => this.ask("Label (empty = no prefix)", field.label, (value) => {
+        this.field = this.validate({ ...field, label: value });
+      }) },
+      { label: `Format: ${display(field.format) || "(empty)"}`, action: () => this.ask("Format: <value>, <url>, <number>", field.format, (value) => {
+        this.field = this.validate({ ...field, format: value });
+      }) },
+      { label: `Width: ${field.width ?? `default (${this.draft.fieldWidth})`}`, action: () => this.ask("Width (empty = default)", field.width === undefined ? "" : String(field.width), (value) => {
+        const candidate = { ...field };
+        if (value.trim()) candidate.width = Number(value); else delete candidate.width;
+        this.field = this.validate(candidate);
+      }) },
+      { label: "Save field", action: () => {
+        const candidate = this.validate(field);
+        const fields = this.draft.fields!.filter((entry) => entry.name !== candidate.name);
+        const index = this.draft.fields!.findIndex((entry) => entry.name === candidate.name);
+        fields.splice(index < 0 ? fields.length : index, 0, candidate);
+        this.draft = parseFooterConfig({ footer: { ...this.draft, fields } });
+        this.field = undefined; this.index = 0;
+      } },
+    ];
+    if (this.draft.fields!.some((entry) => entry.name === field.name)) rows.push({ label: "Remove field", action: () => {
+      this.draft.fields = this.draft.fields!.filter((entry) => entry.name !== field.name);
+      this.field = undefined; this.index = 0;
+    } });
+    rows.push({ label: "Cancel field", action: () => { this.field = undefined; this.index = 0; } });
+    return rows;
+  }
+  handleInput(data: string) {
+    this.error = "";
+    try {
+      if (isTab(data)) this.done("tasks");
+      else if (this.input) {
+        if (this.matches(data, "tui.select.cancel")) this.input = undefined;
+        else if (this.matches(data, "tui.select.confirm")) {
+          const input = this.input;
+          input.apply(input.widget.getValue());
+          this.input = undefined;
+        } else this.input.widget.handleInput(data);
+      } else if (this.matches(data, "tui.select.cancel")) {
+        if (this.field) { this.field = undefined; this.index = 0; } else this.done(undefined);
+      } else {
+        const rows = this.field ? this.fieldRows() : this.rootRows();
+        this.index = Math.min(this.index, rows.length - 1);
+        if (this.matches(data, "tui.select.up")) this.index = (this.index + rows.length - 1) % rows.length;
+        else if (this.matches(data, "tui.select.down")) this.index = (this.index + 1) % rows.length;
+        else if (this.matches(data, "tui.select.confirm")) rows[this.index].action();
+      }
+    } catch (error) { this.error = error instanceof Error ? error.message : "Invalid settings."; }
+    this.requestRender();
+  }
+  render(width: number) {
+    const lines = [this.theme.fg("accent", "Pinote — Global Settings"), this.theme.fg("dim", "Tasks (Tab) · Settings · Fields")];
+    if (this.input) {
+      lines.push(this.theme.fg("accent", this.input.heading), ...this.input.widget.render(width),
+        this.theme.fg("dim", "Enter apply to draft · Esc cancel"));
+    } else {
+      if (this.field) lines.push(this.theme.fg("accent", `Field: ${display(this.field.name)}`));
+      const rows = this.field ? this.fieldRows() : this.rootRows();
+      this.index = Math.min(this.index, rows.length - 1);
+      const start = Math.max(0, Math.min(this.index - 3, rows.length - 8));
+      lines.push(...rows.slice(start, start + 8).map((row, offset) => offset + start === this.index
+        ? this.theme.fg("accent", `> ${row.label}`) : `  ${row.label}`));
+      if (rows.length > 8) lines.push(this.theme.fg("dim", `${this.index + 1}/${rows.length}`));
+      lines.push(this.theme.fg("dim", "↑↓ navigate · Enter edit · Esc cancel"));
+    }
+    if (this.error) lines.push(this.theme.fg("error", this.error));
+    lines.push(this.theme.fg("dim", "Tab: tasks, discard draft · Save settings: persist globally"));
+    return lines.map((line) => truncateToWidth(line, width));
+  }
+  invalidate() { this.input?.widget.invalidate(); }
+}
+
+export function withSettingsTab<T extends { handleInput?(data: string): void; render(width: number): string[]; invalidate(): void; focused?: boolean }>(
+  component: T, onSettings: () => void, theme: Theme, requestRender: () => void,
+) {
+  return {
+    get focused() { return component.focused ?? false; },
+    set focused(value: boolean) { component.focused = value; },
+    handleInput(data: string) { if (isTab(data)) onSettings(); else component.handleInput?.(data); requestRender(); },
+    render(width: number) { return [truncateToWidth(theme.fg("accent", "Tasks · Settings (Tab)"), width), ...component.render(width)]; },
+    invalidate() { component.invalidate(); },
+  };
+}

package/index.ts

@@ -1,14 +1,16 @@
 import { getAgentDir, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth } from "@earendil-works/pi-tui";
+import { truncateToWidth, type Keybinding } from "@earendil-works/pi-tui";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { stripVTControlCharacters } from "node:util";
 import { Type } from "typebox";
 import { createPRWatcher } from "./pr-watch.ts";
+import { defaultFooterConfig, effectiveFooterFields, loadFooterConfig, readFooterDocument, saveFooterConfig, type FooterConfig } from "./footer-config.ts";
+import { FooterSettings, TaskMenu, withSettingsTab } from "./footer-settings.ts";
 import { TaskPicker, taskState, taskTag } from "./task-picker.ts";
 import { bundledCLIVersion, cliMenu, detectCLI, setupCLI, setupHint, versionAtLeast, type CLIAction } from "./setup.ts";
 
-const handoffGuidance = "Keep agent notes to at most three short bullets total: outcome, blocker, next action, only when relevant. Replace stale notes; omit narration, repeated task text, and routine test logs. Keep a GitHub pull request in the PR field. To show another footer field, set its Markdown value and append its label to Bar, one label per line. Links in that text are clickable. Do not list PR in Bar. Remove the field and its Bar line to drop it. Notes stay off the footer unless named in Bar.";
+const handoffGuidance = "Keep agent notes to at most three short bullets total: outcome, blocker, next action, only when relevant. Replace stale notes; omit narration, repeated task text, and routine test logs. Keep a GitHub pull request in the PR field. Read pinote_fields to learn the user's globally configured footer field names and presentation. Populate those fields with meaningful task values when relevant using pinote_update_current; fields without values stay hidden. Footer fields and widths are chosen by the user's pi-note.json config. Set configured fields with Markdown values; links are clickable. When footer.fields is unset, Bar selects labels, one per line. Do not list PR in Bar. Remove a field to hide it. Do not modify config without user approval.";
 const offerGuidance = {
   always: "When the user gives work and no pinote task is selected, propose one note as `[tag] text` and ask before creating it.",
   "github-remote": "When the user gives work and no pinote task is selected, first verify with Git that the current repository has a remote whose URL host is github.com (HTTPS or SSH). Only then propose one note as `[tag] text` and ask before creating it. Local paths, other hosts, and GitHub-looking URL paths do not qualify. If no GitHub remote is verified, do not offer a task; explicit user requests to create one remain allowed.",
@@ -126,6 +128,7 @@ export default function (pi: ExtensionAPI) {
   let setupAbort: AbortController | undefined;
   let activeContext: ExtensionContext | undefined;
   let cliState: CLIAction | undefined;
+  let footerConfig = { ...defaultFooterConfig };
   const checkCLI = async (ctx: ExtensionContext, suggest = false) => {
     if (!ctx.hasUI || ctx.mode !== "tui" || setupAbort) return;
     const generation = epoch;
@@ -241,7 +244,7 @@ export default function (pi: ExtensionAPI) {
     try {
       const current = await selected(ctx);
       if (alive && generation === epoch && serial === refreshSerial) {
-        ctx.ui.setStatus("pinote", current ? truncateToWidth(`${noteIcon} ${taskTag(current)} ${firstLine(current)}`, 60) : undefined);
+        ctx.ui.setStatus("pinote", current ? truncateToWidth(`${noteIcon} ${taskTag(current)} ${firstLine(current)}`, footerConfig.titleWidth, "...") : undefined);
         watcher.update(ctx, current);
       }
     } catch {
@@ -252,6 +255,7 @@ export default function (pi: ExtensionAPI) {
   };
   const watcher = createPRWatcher(pi, {
     selected,
+    footerConfig: () => footerConfig,
     get: async (id) => requiredTask(await run(["agent", "get", String(id)]), id),
     done: async (current, canAct) => {
       const result = requiredTask(await run([
@@ -275,6 +279,9 @@ export default function (pi: ExtensionAPI) {
     branchEpoch++;
     selectedId = readSelection(ctx);
     const generation = epoch;
+    footerConfig = loadFooterConfig((message) => {
+      if (ctx.hasUI) ctx.ui.notify(message, "warning");
+    });
     cliState = undefined;
     if (ctx.hasUI && ctx.mode === "tui") {
       if (offerConfigError) ctx.ui.notify(`Pinote task offers disabled: ${clean(offerConfigError)} Fix the configuration and /reload.`, "warning");
@@ -353,7 +360,7 @@ export default function (pi: ExtensionAPI) {
   registerInstallCommand("pi-note-upgrade");
 
   pi.registerCommand("pi-note", {
-    description: "Continue, complete, or switch the selected pinote task",
+    description: "Continue, complete, switch tasks, or edit global footer settings (Tab)",
     handler: async (args, ctx) => {
       if (!ctx.hasUI || ctx.mode !== "tui") return;
       if (args.trim()) { ctx.ui.notify("Usage: /pi-note", "warning"); return; }
@@ -370,39 +377,59 @@ export default function (pi: ExtensionAPI) {
       try {
         const current = await selected(ctx);
         if (!canAct()) return;
-        const action = current
-          ? await ctx.ui.select(`Pinote — ${taskState(current)} ${taskTag(current)} ${title(current)}`, ["Continue", "Done", "Switch task"])
-          : "Switch task";
-        if (!action || !canAct()) return;
-        if (action === "Done" && current) {
+        let settings = false;
+        while (canAct()) {
+          if (settings) {
+            const document = readFooterDocument();
+            const config = { ...document.config, fields: effectiveFooterFields(document.config, current?.agent_notes) };
+            const edited = await ctx.ui.custom<FooterConfig | "tasks" | undefined>((tui, theme, kb, done) =>
+              new FooterSettings(config, Object.keys(current?.agent_notes ?? {}).filter((name) => name !== "Bar"),
+                theme, (data, action) => kb.matches(data, action as Keybinding), done, () => tui.requestRender()));
+            if (!canAct() || edited === undefined) return;
+            if (edited === "tasks") { settings = false; continue; }
+            footerConfig = saveFooterConfig(edited, document.raw);
+            ctx.ui.notify("Global Pinote footer settings saved.", "info");
+            return;
+          }
+          const action = current
+            ? await ctx.ui.custom<string | undefined>((tui, theme, kb, done) =>
+              new TaskMenu(`Pinote — ${taskState(current)} ${taskTag(current)} ${title(current)}`,
+                theme, (data, action) => kb.matches(data, action as Keybinding), done, () => tui.requestRender()))
+            : "Switch task";
+          if (!action || !canAct()) return;
+          if (action === "Settings") { settings = true; continue; }
+          if (action === "Done" && current) {
+            refreshSerial++;
+            const completed = requiredTask(await run([
+              "agent", "done", String(current.id), "--expected-updated-at", current.updated_at,
+            ], undefined, canAct), current.id);
+            if (completed.state !== "done") throw new Error(compatible);
+            if (currentSession() && branch === branchEpoch) remember(null, branch);
+            if (currentSession()) ctx.ui.notify(`Pinote #${current.id} completed.`, "info");
+            return;
+          }
+          let id: number;
+          if (action === "Continue" && current) {
+            id = current.id;
+          } else if (action === "Switch task") {
+            const tasks = taskList(await run(["list", "--json"]));
+            if (!canAct()) return;
+            const choice = await ctx.ui.custom<number | "Settings" | undefined>((tui, theme, kb, done) =>
+              withSettingsTab(new TaskPicker(tasks, theme, (data, action) => kb.matches(data, action),
+                done, () => tui.requestRender()), () => done("Settings"), theme, () => tui.requestRender()));
+            if (choice === undefined || !canAct()) return;
+            if (choice === "Settings") { settings = true; continue; }
+            id = choice;
+          } else return;
+          const handoff = handoffPrompt();
           refreshSerial++;
-          const completed = requiredTask(await run([
-            "agent", "done", String(current.id), "--expected-updated-at", current.updated_at,
-          ], undefined, canAct), current.id);
-          if (completed.state !== "done") throw new Error(compatible);
-          if (currentSession() && branch === branchEpoch) remember(null, branch);
-          if (currentSession()) ctx.ui.notify(`Pinote #${current.id} completed.`, "info");
+          const chosen = await startTask(id, canAct);
+          if (!chosen || !canAct()) return;
+          const draft = ctx.ui.getEditorText();
+          ctx.ui.setEditorText(draft ? `${draft}\n\n${handoff}` : handoff);
+          ctx.ui.notify(`Pinote #${chosen.id} is in progress. Task added to input.`, "info");
           return;
         }
-        const handoff = handoffPrompt();
-        let id: number;
-        if (action === "Continue" && current) {
-          id = current.id;
-        } else if (action === "Switch task") {
-          const tasks = taskList(await run(["list", "--json"]));
-          if (!canAct()) return;
-          if (!tasks.length) { ctx.ui.notify("No active pinote tasks.", "info"); return; }
-          const choice = await ctx.ui.custom<number | undefined>((tui, theme, kb, done) =>
-            new TaskPicker(tasks, theme, (data, action) => kb.matches(data, action), done, () => tui.requestRender()));
-          if (choice === undefined || !canAct()) return;
-          id = choice;
-        } else return;
-        refreshSerial++;
-        const chosen = await startTask(id, canAct);
-        if (!chosen || !canAct()) return;
-        const draft = ctx.ui.getEditorText();
-        ctx.ui.setEditorText(draft ? `${draft}\n\n${handoff}` : handoff);
-        ctx.ui.notify(`Pinote #${chosen.id} is in progress. Task added to input.`, "info");
       } catch (error) {
         if (currentSession()) ctx.ui.notify(`Pinote: ${clean(error instanceof Error ? error.message : String(error))}`, "error");
       } finally {
@@ -426,7 +453,7 @@ export default function (pi: ExtensionAPI) {
     name: "pinote_update_current",
     label: "Pinote update current",
     promptGuidelines: [handoffGuidance],
-    description: "Patch arbitrary agent handoff fields on this session's current pinote task. No ID argument. Read first with pinote_get_current; pass its updated_at as expected_updated_at. Fails when no task is selected or the selection changes during the operation. set merges label/value pairs without replacing other fields or task text; values are Markdown, e.g. PR: [Fix #42](https://github.com/org/repo/pull/42). Set PR to one GitHub pull-request URL or Markdown link to show PR #N in the footer and watch for merge confirmation in interactive Pi. Set Bar to newline-separated field labels to show those Markdown fields in the footer; links in the text are clickable. remove deletes named fields. A stale revision fails; read again before retrying. Does not complete the task or change its tag.",
+    description: "Patch arbitrary agent handoff fields on this session's current pinote task. No ID argument. Read first with pinote_get_current; pass its updated_at as expected_updated_at. Fails when no task is selected or the selection changes during the operation. set merges label/value pairs without replacing other fields or task text; values are Markdown, e.g. PR: [Fix #42](https://github.com/org/repo/pull/42). Set PR to one GitHub pull-request URL or Markdown link to show PR #N in the footer and watch for merge confirmation in interactive Pi. Read pinote_fields for the user's global field names, labels, link switches, formats, and widths; set those field names when their values are relevant. Fields without values stay hidden. When footer.fields is unset, set Bar to newline-separated field labels to show those Markdown fields in the footer; links in the text are clickable. remove deletes named fields. A stale revision fails; read again before retrying. Does not complete the task or change its tag.",
     parameters: Type.Object({
       expected_updated_at: Type.String({ minLength: 1 }),
       set: Type.Optional(Type.Record(Type.String(), Type.String())),
@@ -453,6 +480,18 @@ export default function (pi: ExtensionAPI) {
       return toolResult(updated);
     },
   });
+  pi.registerTool({
+    name: "pinote_fields",
+    label: "Pinote footer fields",
+    promptGuidelines: ["Read pinote_fields before updating handoff fields to learn which global fields the user wants populated. Use pinote_update_current for meaningful values; omit empty or irrelevant fields. Do not edit global configuration without user approval."],
+    description: "Read the user's global Pinote footer field definitions, including source names, display labels, link switches, formats, and widths. Use these names in pinote_update_current set to populate relevant task values. Fields without values are not displayed. Works without a selected task; does not modify configuration or task data.",
+    parameters: Type.Object({}, { additionalProperties: false }),
+    async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
+      const config = loadFooterConfig((message) => { if (ctx.hasUI) ctx.ui.notify(message, "warning"); });
+      const value = { ...config, fields: effectiveFooterFields(config), legacy_bar: config.fields === null };
+      return { content: [{ type: "text" as const, text: JSON.stringify(value) }], details: value };
+    },
+  });
   pi.registerTool({
     name: "pinote_tags",
     label: "Pinote tags",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-note",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Persistent pinote tasks, Markdown handoffs, and task status for Pi",
   "license": "MIT",
   "type": "module",
@@ -14,7 +14,7 @@
   "homepage": "https://github.com/kvidzibo/pinote/tree/main/pi#readme",
   "bugs": { "url": "https://github.com/kvidzibo/pinote/issues" },
   "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
-  "files": ["index.ts", "pr-watch.ts", "footer-links.ts", "task-picker.ts", "setup.ts", "icons", "README.md", "LICENSE"],
+  "files": ["index.ts", "pr-watch.ts", "footer-links.ts", "footer-config.ts", "footer-settings.ts", "task-picker.ts", "setup.ts", "icons", "README.md", "LICENSE"],
   "pi": { "extensions": ["./index.ts"] },
   "scripts": {
     "check": "tsc --noEmit",

package/pr-watch.ts

@@ -1,5 +1,6 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { footerChips, footerStatusKey, legacyFooterStatusKey, renderFooterLinks, type FooterChip } from "./footer-links.ts";
+import type { FooterConfig } from "./footer-config.ts";
 
 export type WatchedTask = {
   id: number;
@@ -14,6 +15,7 @@ type Dependencies = {
   done: (task: WatchedTask, canAct: () => boolean) => Promise<void>;
   claim: () => (() => void) | undefined;
   refresh: (ctx: ExtensionContext) => Promise<void>;
+  footerConfig?: () => FooterConfig;
 };
 const entryType = "pinote-pr-acknowledged";
 const watchEntryType = "pinote-pr-watched";
@@ -99,7 +101,7 @@ export function createPRWatcher(pi: ExtensionAPI, deps: Dependencies) {
     revision++;
     // Display only the active selection, independently of the retained merge watch.
     visiblePR = current && ["active", "in_progress"].includes(current.state) ? taskPR(current) : undefined;
-    visibleLinks = footerChips(current, visiblePR);
+    visibleLinks = footerChips(current, visiblePR, deps.footerConfig?.());
     // Completion clears selection. Keep the last task until poll verifies its state.
     const changed = current ? remember(taskPR(current) ? current : null) : false;
     paint();