pi-note 0.8.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.
@@ -81,20 +84,34 @@ worktrees and pull requests. Task status refreshes at session start, before/afte
 agent activity, and after commands/tools. The CLI's per-directory `agent selected`
 command is not this session memory.
 
-### Handoff prompt configuration
+### Personal configuration
 
-Set `handoffPrompt` in `~/.pi/agent/pi-note.json` (or in the agent directory set
-by `PI_CODING_AGENT_DIR`):
+Configure `~/.pi/agent/pi-note.json` (or the agent directory set by
+`PI_CODING_AGENT_DIR`):
 
 ```json
 {
-  "handoffPrompt": "Read the current Pinote task. Summarize your understanding and proposed approach, but don’t start work yet."
+  "handoffPrompt": "Read the current Pinote task. Summarize your understanding and proposed approach, but don’t start work yet.",
+  "taskOfferPolicy": "github-remote"
 }
 ```
 
-Both task selection and **Continue** read this file each time; no `/reload` is
-needed after edits. The value is literal text, not a prompt template; use `\n`
-in JSON strings for multiple lines. It must be a nonblank string without control
+`taskOfferPolicy` controls the agent's task-offer guidance:
+
+- `always` (default): offer a task when given work with no task selected.
+- `github-remote`: first verify with Git that the repository has an HTTPS or SSH
+  remote hosted on `github.com`; otherwise do not offer. Local paths and other
+  hosts do not qualify. This is agent guidance, not a network or PR-access check.
+- `never`: do not offer tasks; explicit requests to create one remain allowed.
+
+All policies preserve the existing creation tools, user-consent requirement,
+and selected tasks. Run `/reload` after changing this setting. Invalid policy
+values or unreadable/malformed configuration suppress offers; interactive startup
+warns until you fix the file and reload. No project-local configuration is read.
+
+Task selection and **Continue** reread `handoffPrompt` each time; changing that
+field needs no `/reload`. Its value is literal text, not a prompt template; use
+`\n` in JSON strings for multiple lines. It must be a nonblank string without control
 characters other than tabs and newlines. A missing file or key uses the default.
 Invalid/unreadable configuration reports an error without starting/switching a
 task or changing the editor. **Done** and agent tools are unaffected. This is
@@ -109,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.
@@ -117,20 +138,21 @@ Version 0.7.0 replaces `pinote_get`/`pinote_update` with these current-task tool
 and removes `pinote_tag`, without aliases. Agents cannot read/update tasks by ID
 or retag existing tasks; use `/pi-note` to select an existing task.
 
-When the user gives work and no task is selected, the agent proposes one note as
-`[tag] text` and asks before creating it. No continues without a note. Yes calls
+When allowed by `taskOfferPolicy`, the agent proposes one note as `[tag] text`
+and asks before creating it. No continues without a note. Yes calls
 `pinote_add` with `select: true`. An existing selection is not replaced unless the
 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
@@ -149,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,18 +1,23 @@
 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 createGuidance = [
-  "When the user gives work and no pinote task is selected, propose one note as `[tag] text` and ask before creating it. On no, continue without a note. On yes, call pinote_add with select true so it becomes this session's active task. Never add or select without a yes. If a task is already selected, do not replace it unless the user asks to switch.",
-  "Reuse a pinote_tags name when it fits. One tag; case-sensitive, trimmed, at most 64 characters. Tags are set when creating tasks with pinote_add; agent tools cannot retag existing tasks. Do not use pinote_update_current for tags or task text.",
-];
+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.",
+  never: "Do not offer to create a pinote task. Create one only when the user explicitly requests it.",
+};
+const consentGuidance = "On no, continue without a note. On yes, call pinote_add with select true so it becomes this session's active task. Never add or select without a yes. If a task is already selected, do not replace it unless the user asks to switch.";
+const tagGuidance = "Reuse a pinote_tags name when it fits. One tag; case-sensitive, trimmed, at most 64 characters. Tags are set when creating tasks with pinote_add; agent tools cannot retag existing tasks. Do not use pinote_update_current for tags or task text.";
 type Task = {
   id: number;
   text: string;
@@ -36,18 +41,43 @@ const firstLine = (task: Summary) => clean(task.text.split("\n", 1)[0]).replace(
 const title = (task: Summary) => truncateToWidth(`#${task.id} ${firstLine(task)}`, 60);
 
 const defaultHandoffPrompt = "Read the current Pinote task. Summarize your understanding, but don’t start work yet.";
-function handoffPrompt(): string {
+function readConfig(): Record<string, unknown> {
   const path = join(getAgentDir(), "pi-note.json");
   let raw: string;
   try {
     raw = readFileSync(path, "utf8");
   } catch (error) {
-    if ((error as NodeJS.ErrnoException).code === "ENOENT") return defaultHandoffPrompt;
+    if ((error as NodeJS.ErrnoException).code === "ENOENT") return {};
     throw new Error(`Cannot read ${path}. Check the pi-note configuration.`);
   }
   let config: unknown;
   try { config = JSON.parse(raw); } catch { throw new Error(`Invalid JSON in ${path}.`); }
   if (!record(config)) throw new Error(`Expected a JSON object in ${path}.`);
+  return config;
+}
+
+function creationGuidance(): { guidelines: string[]; error?: string } {
+  let policy: keyof typeof offerGuidance = "always";
+  let error: string | undefined;
+  try {
+    const config = readConfig();
+    if ("taskOfferPolicy" in config) {
+      const value = config.taskOfferPolicy;
+      if (value !== "always" && value !== "github-remote" && value !== "never") {
+        throw new Error(`taskOfferPolicy in ${join(getAgentDir(), "pi-note.json")} must be always, github-remote, or never.`);
+      }
+      policy = value;
+    }
+  } catch (cause) {
+    policy = "never";
+    error = cause instanceof Error ? cause.message : String(cause);
+  }
+  return { guidelines: [`${offerGuidance[policy]} ${consentGuidance}`, tagGuidance], error };
+}
+
+function handoffPrompt(): string {
+  const config = readConfig();
+  const path = join(getAgentDir(), "pi-note.json");
   if (!("handoffPrompt" in config)) return defaultHandoffPrompt;
   if (!text(config.handoffPrompt) || !config.handoffPrompt.trim()) {
     throw new Error(`handoffPrompt in ${path} must be a nonblank string without control characters (except tabs/newlines).`);
@@ -90,6 +120,7 @@ function toolResult(value: Task | null) {
 }
 
 export default function (pi: ExtensionAPI) {
+  const { guidelines: createGuidance, error: offerConfigError } = creationGuidance();
   let alive = true;
   let epoch = 0;
   let refreshSerial = 0;
@@ -97,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;
@@ -212,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 {
@@ -223,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([
@@ -246,8 +279,12 @@ 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");
       ctx.ui.addAutocompleteProvider((current) => cliMenu(current, () => setupAbort ? undefined : cliState));
     }
     // Keep the setup lock until its aborted subprocess has actually settled.
@@ -323,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; }
@@ -340,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 {
@@ -396,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())),
@@ -423,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.8.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();