@pi-unipi/unipi 2.14.2 → 2.16.0

package/packages/notify/tui/settings-overlay.ts

@@ -14,12 +14,28 @@ import {
   validateConfig,
 } from "../settings.js";
 import { loadNtfyConfig, saveNtfyConfig, getNtfyConfigScope } from "../ntfy-config.js";
-import type { NotifyConfig, NtfyConfig } from "../types.js";
+import type { NotifyConfig, NotifyPlatform, NtfyConfig } from "../types.js";
 import { OverlayTheme, boxInnerWidth } from "@pi-unipi/core";
 
 /** Section types */
 type Section = "platforms" | "events" | "recap";
 
+const PLATFORM_KEYS: NotifyPlatform[] = ["native", "gotify", "telegram", "ntfy"];
+const CHIP_LABELS: Record<NotifyPlatform, string> = {
+  native: "Native",
+  gotify: "Gotify",
+  telegram: "Telegram",
+  ntfy: "ntfy",
+};
+
+const SUPPRESS_FOCUSED_INDEX = 4;
+const SILENCE_MASTER_INDEX = 5;
+const SILENCE_CHIPS_INDEX = 6;
+
+const WINDOW_STEP_MS = 1_000;
+const WINDOW_MIN_MS = 1_000;
+const WINDOW_MAX_MS = 120_000;
+
 /**
  * Settings overlay component.
  */
@@ -29,6 +45,8 @@ export class NotifySettingsOverlay implements Component {
   private ntfyScope: "project" | "global" | "none";
   private section: Section = "platforms";
   private selectedIndex = 0;
+  /** Which silence-after-input chip is focused (0–3). */
+  private chipIndex = 0;
   private error: string | null = null;
   private saved = false;
   onClose?: () => void;
@@ -70,6 +88,26 @@ export class NotifySettingsOverlay implements Component {
       this.selectedIndex = Math.min(this.maxItems - 1, this.selectedIndex + 1);
       return;
     }
+    if (this.section === "platforms" && this.selectedIndex === SILENCE_CHIPS_INDEX) {
+      if (matchesKey(data, "left") || data === "h") {
+        this.chipIndex = Math.max(0, this.chipIndex - 1);
+        return;
+      }
+      if (matchesKey(data, "right") || data === "l") {
+        this.chipIndex = Math.min(PLATFORM_KEYS.length - 1, this.chipIndex + 1);
+        return;
+      }
+    }
+    if (this.section === "platforms" && this.selectedIndex === SILENCE_MASTER_INDEX) {
+      if (data === "+" || data === "=") {
+        this.nudgeWindow(WINDOW_STEP_MS);
+        return;
+      }
+      if (data === "-" || data === "_") {
+        this.nudgeWindow(-WINDOW_STEP_MS);
+        return;
+      }
+    }
     if (matchesKey(data, "space")) {
       this.toggleCurrent();
       return;
@@ -99,30 +137,57 @@ export class NotifySettingsOverlay implements Component {
   }
 
   private get maxItems(): number {
-    if (this.section === "platforms") return 5; // native, gotify, telegram, ntfy + suppress option
+    if (this.section === "platforms") return 7; // 4 platforms + focused + silence master + chips
     if (this.section === "recap") return 1; // toggle
     return Object.keys(this.config.events).length;
   }
 
+  private nudgeWindow(delta: number): void {
+    const current = this.config.silenceAfterInput.windowMs;
+    this.config.silenceAfterInput.windowMs = Math.min(
+      WINDOW_MAX_MS,
+      Math.max(WINDOW_MIN_MS, current + delta),
+    );
+  }
+
+  private chipOn(key: NotifyPlatform): boolean {
+    const listed = this.config.silenceAfterInput.platforms;
+    if (listed.length === 0) return true;
+    return listed.includes(key);
+  }
+
+  private toggleSilenceChip(key: NotifyPlatform): void {
+    const listed = this.config.silenceAfterInput.platforms;
+    const effective = listed.length === 0 ? PLATFORM_KEYS.slice() : listed.slice();
+    const idx = effective.indexOf(key);
+    if (idx >= 0) {
+      if (effective.length === 1) return;
+      effective.splice(idx, 1);
+    } else {
+      effective.push(key);
+    }
+    const ordered = PLATFORM_KEYS.filter((p) => effective.includes(p));
+    this.config.silenceAfterInput.platforms =
+      ordered.length === PLATFORM_KEYS.length ? [] : ordered;
+  }
+
   private toggleCurrent(): void {
     if (this.section === "platforms") {
-      const platforms: Array<"native" | "gotify" | "telegram" | "ntfy"> = [
-        "native",
-        "gotify",
-        "telegram",
-        "ntfy",
-      ];
-      if (this.selectedIndex < platforms.length) {
-        const key = platforms[this.selectedIndex];
+      if (this.selectedIndex < PLATFORM_KEYS.length) {
+        const key = PLATFORM_KEYS[this.selectedIndex];
         if (key === "ntfy") {
           // ntfy toggle updates the resolved ntfy config
           this.ntfyConfig.enabled = !this.ntfyConfig.enabled;
         } else if (key) {
           this.config[key].enabled = !this.config[key].enabled;
         }
-      } else {
-        // suppressWhenFocused toggle (index 4)
+      } else if (this.selectedIndex === SUPPRESS_FOCUSED_INDEX) {
         this.config.native.suppressWhenFocused = !this.config.native.suppressWhenFocused;
+      } else if (this.selectedIndex === SILENCE_MASTER_INDEX) {
+        this.config.silenceAfterInput.enabled = !this.config.silenceAfterInput.enabled;
+      } else if (this.selectedIndex === SILENCE_CHIPS_INDEX) {
+        const key = PLATFORM_KEYS[this.chipIndex];
+        if (key) this.toggleSilenceChip(key);
       }
     } else if (this.section === "recap") {
       this.config.recap.enabled = !this.config.recap.enabled;
@@ -196,18 +261,35 @@ export class NotifySettingsOverlay implements Component {
 
     // Footer
     lines.push(this.overlay.ruleLine(innerWidth));
-    const footerHint = this.section === "recap"
-      ? "↑↓ navigate · Space toggle · M change model · Tab switch · Enter save · Esc cancel"
-      : "↑↓ navigate · Space toggle · Tab switch · Enter save · Esc cancel";
-    lines.push(this.overlay.frameLine(this.overlay.fg("dim", footerHint), innerWidth));
+    lines.push(this.overlay.frameLine(this.overlay.fg("dim", this.footerHint()), innerWidth));
     lines.push(this.overlay.borderLine(innerWidth, "bottom"));
 
     return lines;
   }
 
+  private footerHint(): string {
+    if (this.section === "recap") {
+      return "↑↓ navigate · Space toggle · M change model · Tab switch · Enter save · Esc cancel";
+    }
+    if (this.section === "platforms" && this.selectedIndex === SILENCE_MASTER_INDEX) {
+      return "↑↓ navigate · Space toggle · +/− window · Tab switch · Enter save · Esc cancel";
+    }
+    if (this.section === "platforms" && this.selectedIndex === SILENCE_CHIPS_INDEX) {
+      return "↑↓ navigate · ←→ channel · Space toggle · Tab switch · Enter save · Esc cancel";
+    }
+    return "↑↓ navigate · Space toggle · Tab switch · Enter save · Esc cancel";
+  }
+
+  private silenceSummary(): string {
+    const seconds = Math.round(this.config.silenceAfterInput.windowMs / 1000);
+    const listed = this.config.silenceAfterInput.platforms;
+    const scope = listed.length === 0 ? "all enabled" : listed.join(", ");
+    return `${seconds}s · ${scope}`;
+  }
+
   private renderPlatforms(lines: string[], innerWidth: number): void {
     const platforms: Array<{
-      key: "native" | "gotify" | "telegram" | "ntfy";
+      key: NotifyPlatform;
       label: string;
       detail: string;
     }> = [
@@ -259,8 +341,7 @@ export class NotifySettingsOverlay implements Component {
 
     // suppressWhenFocused toggle (index 4)
     {
-      const i = platforms.length;
-      const isSelected = i === this.selectedIndex;
+      const isSelected = this.selectedIndex === SUPPRESS_FOCUSED_INDEX;
       const isEnabled = this.config.native.suppressWhenFocused === true;
       const toggleOn = this.overlay.fg("success", "●");
       const toggleOff = this.overlay.fg("dim", "○");
@@ -277,6 +358,47 @@ export class NotifySettingsOverlay implements Component {
         )
       );
     }
+
+    this.renderSilenceAfterInput(lines, innerWidth);
+  }
+
+  private renderSilenceAfterInput(lines: string[], innerWidth: number): void {
+    const masterOn = this.config.silenceAfterInput.enabled;
+    const masterSelected = this.selectedIndex === SILENCE_MASTER_INDEX;
+    const toggle = masterOn
+      ? this.overlay.fg("success", "●")
+      : this.overlay.fg("dim", "○");
+    const label = masterSelected
+      ? this.overlay.bold("Quiet after activity")
+      : this.overlay.fg("dim", "Quiet after activity");
+    const detail = this.overlay.fg("dim", this.silenceSummary());
+    lines.push(
+      this.overlay.frameLine(
+        `${masterSelected ? this.overlay.fg("accent", "▸") : " "} ${toggle} ${label}  ${detail}`,
+        innerWidth,
+      ),
+    );
+
+    const chipsSelected = this.selectedIndex === SILENCE_CHIPS_INDEX;
+    const chips = PLATFORM_KEYS.map((key, i) => {
+      const on = this.chipOn(key);
+      const mark = on ? "●" : "○";
+      const text = `${mark} ${CHIP_LABELS[key]}`;
+      const focused = chipsSelected && i === this.chipIndex;
+      if (focused) {
+        return this.overlay.fg("accent", this.overlay.bold(`[${text}]`));
+      }
+      const painted = on
+        ? `${this.overlay.fg("success", mark)} ${CHIP_LABELS[key]}`
+        : this.overlay.fg("dim", text);
+      return masterOn ? painted : this.overlay.fg("dim", text);
+    });
+    lines.push(
+      this.overlay.frameLine(
+        `${chipsSelected ? this.overlay.fg("accent", "▸") : " "}   ${chips.join("  ")}`,
+        innerWidth,
+      ),
+    );
   }
 
   private renderEvents(lines: string[], innerWidth: number): void {

package/packages/notify/types.ts

@@ -71,6 +71,16 @@ export interface RecapConfig {
   model: string;
 }
 
+/** Quiet listed platforms after recent terminal input */
+export interface SilenceAfterInputConfig {
+  /** Master switch */
+  enabled: boolean;
+  /** Quiet window after the last keypress, in milliseconds */
+  windowMs: number;
+  /** Platforms to suppress (empty = all enabled platforms) */
+  platforms: NotifyPlatform[];
+}
+
 /** Full notification configuration */
 export interface NotifyConfig {
   /** Global default platforms for all events */
@@ -85,6 +95,8 @@ export interface NotifyConfig {
   telegram: TelegramConfig;
   /** Recap summarization settings */
   recap: RecapConfig;
+  /** Suppress listed platforms after recent terminal input */
+  silenceAfterInput: SilenceAfterInputConfig;
 }
 
 /** Parameters for the notify_user agent tool */

package/packages/ralph/README.md

@@ -18,6 +18,8 @@ Ralph is for work that takes more than one pass — migrating a codebase, implem
 | `/unipi:ralph list --archived` | Show archived loops |
 | `/unipi:ralph nuke [--yes]` | Delete all ralph data |
 
+Command arguments autocomplete: subcommands with descriptions, live loop names with status, and `start` flags are suggested as you type.
+
 ### Options
 
 | Flag | Description |

package/packages/ralph/SKILL.md

@@ -24,6 +24,8 @@ Long-running iterative development loops. Run complex tasks across multiple iter
 | `/unipi:ralph list --archived` | Show archived loops |
 | `/unipi:ralph nuke [--yes]` | Delete all ralph data |
 
+Arguments autocomplete: typing `/unipi:ralph ` suggests subcommands with descriptions; `resume`/`cancel`/`archive` suggest loop names with live status; `start` suggests its flags.
+
 ## Tools
 
 | Tool | Description |

package/packages/ralph/completions.ts

@@ -0,0 +1,170 @@
+/**
+ * @unipi/ralph — Argument completions for /unipi:ralph
+ *
+ * Pure, testable completion builder. index.ts wires it into
+ * registerCommand via getArgumentCompletions.
+ *
+ * NOTE: pi passes the ENTIRE argument text (everything after the command
+ * name, up to the cursor) and replaces ALL of it with item.value on accept.
+ * Nested suggestions must therefore return the full replacement string,
+ * e.g. "resume myloop" or "start mytask --max-iterations".
+ */
+
+import { RALPH_STATUS_ICONS } from "@pi-unipi/core";
+import type { LoopStatus } from "./ralph-loop.js";
+
+export interface CompletionItem {
+  value: string;
+  label: string;
+  description?: string;
+}
+
+/** Minimal loop shape the completion builder needs. */
+export interface LoopSummary {
+  name: string;
+  status: LoopStatus;
+  iteration: number;
+  maxIterations: number;
+}
+
+/** Subcommands, shown when no subcommand has been typed yet. */
+const SUBCOMMANDS: CompletionItem[] = [
+  { value: "start", label: "start", description: "Start a new loop" },
+  { value: "stop", label: "stop", description: "Stop the current loop" },
+  { value: "resume", label: "resume", description: "Resume a paused loop" },
+  { value: "status", label: "status", description: "Show all loops" },
+  { value: "list", label: "list", description: "Show loops (--archived for archived)" },
+  { value: "cancel", label: "cancel", description: "Delete loop state" },
+  { value: "archive", label: "archive", description: "Move a loop to the archive" },
+  {
+    value: "clean",
+    label: "clean",
+    description: "Clean completed loops (--all also deletes task files)",
+  },
+  { value: "nuke", label: "nuke", description: "Delete all ralph data (--yes skips confirm)" },
+];
+
+/** Flags accepted by `start` that take a numeric value. */
+const START_VALUE_FLAGS = ["--max-iterations", "--items-per-iteration", "--reflect-every"];
+
+const START_FLAGS: CompletionItem[] = [
+  {
+    value: "--max-iterations",
+    label: "--max-iterations",
+    description: "Stop after N iterations (default 50)",
+  },
+  {
+    value: "--items-per-iteration",
+    label: "--items-per-iteration",
+    description: "Process N items per iteration",
+  },
+  {
+    value: "--reflect-every",
+    label: "--reflect-every",
+    description: "Reflection checkpoint every N iterations",
+  },
+];
+
+function describeLoop(l: LoopSummary): string {
+  const maxStr = l.maxIterations > 0 ? `/${l.maxIterations}` : "";
+  const icon = RALPH_STATUS_ICONS[l.status] ?? "•";
+  return `${icon} ${l.status} · iter ${l.iteration}${maxStr}`;
+}
+
+function suggestLoopNames(
+  cmd: string,
+  partial: string,
+  listLoops: () => LoopSummary[],
+): CompletionItem[] {
+  return listLoops()
+    .filter((l) => {
+      if (cmd === "resume") return l.status !== "completed";
+      if (cmd === "archive") return l.status !== "active";
+      return true; // cancel: any non-archived loop
+    })
+    .filter((l) => l.name.startsWith(partial) && l.name !== partial)
+    .sort((a, b) => a.name.localeCompare(b.name))
+    .map((l) => ({
+      value: `${cmd} ${l.name}`,
+      label: l.name,
+      description: describeLoop(l),
+    }));
+}
+
+/**
+ * Build completion items for the argument text after `/unipi:ralph`.
+ * `listLoops` supplies non-archived loop state (empty before session_start).
+ * Returns null when there is nothing to suggest.
+ */
+export function buildRalphArgumentCompletions(
+  argumentText: string,
+  listLoops: () => LoopSummary[],
+): CompletionItem[] | null {
+  const endsWithSpace = /\s$/.test(argumentText);
+  const tokens = argumentText.trim().split(/\s+/).filter((t) => t.length > 0);
+  const complete = endsWithSpace ? tokens : tokens.slice(0, -1);
+  const partial = endsWithSpace ? "" : (tokens[tokens.length - 1] ?? "");
+  // Everything typed before the in-flight token — every suggestion must
+  // preserve it, because pi replaces the whole argument text with item.value.
+  const head = endsWithSpace
+    ? argumentText
+    : argumentText.slice(0, argumentText.length - partial.length);
+
+  // No subcommand yet → suggest subcommands
+  if (complete.length === 0) {
+    const items = SUBCOMMANDS.filter((s) => s.value.startsWith(partial) && s.value !== partial).map(
+      (s) => ({ ...s, value: head + s.value }),
+    );
+    return items.length > 0 ? items : null;
+  }
+
+  const cmd = complete[0];
+
+  // Typing the numeric value of a start flag → no suggestions
+  if (START_VALUE_FLAGS.includes(complete[complete.length - 1])) return null;
+
+  switch (cmd) {
+    case "resume":
+    case "cancel":
+    case "archive": {
+      if (complete.length > 1) return null; // name chosen, nothing more
+      const items = suggestLoopNames(cmd, partial, listLoops).map((i) => ({
+        ...i,
+        value: head + i.label,
+      }));
+      return items.length > 0 ? items : null;
+    }
+
+    case "start": {
+      if (complete.length === 1) return null; // loop name is free-form
+      const used = complete.slice(1).filter((t) => t.startsWith("--"));
+      const items = START_FLAGS.filter(
+        (f) => !used.includes(f.value) && f.value.startsWith(partial) && f.value !== partial,
+      ).map((f) => ({
+        value: head + f.value,
+        label: f.label,
+        description: f.description,
+      }));
+      return items.length > 0 ? items : null;
+    }
+
+    case "list":
+    case "clean":
+    case "nuke": {
+      const flag = cmd === "list" ? "--archived" : cmd === "clean" ? "--all" : "--yes";
+      const desc =
+        cmd === "list"
+          ? "Show archived loops"
+          : cmd === "clean"
+            ? "Also delete task files"
+            : "Skip confirmation prompt";
+      if (complete.slice(1).includes(flag) || flag === partial || !flag.startsWith(partial)) {
+        return null;
+      }
+      return [{ value: head + flag, label: flag, description: desc }];
+    }
+
+    default:
+      return null; // stop / status take no arguments
+  }
+}

package/packages/ralph/index.ts

@@ -24,6 +24,7 @@ function getInfoRegistry() {
 }
 import { RalphLoopManager } from "./ralph-loop.js";
 import { registerRalphTools } from "./tools.js";
+import { buildRalphArgumentCompletions } from "./completions.js";
 
 /** Package version */
 const VERSION = getPackageVersion(dirname(fileURLToPath(import.meta.url)));
@@ -200,6 +201,8 @@ To stop: press ESC to interrupt, then run /unipi:ralph-stop when idle`;
 
   pi.registerCommand("unipi:ralph", {
     description: "Ralph loop commands (start, stop, resume, status, etc.)",
+    getArgumentCompletions: (argumentText: string) =>
+      buildRalphArgumentCompletions(argumentText, () => manager?.listLoops(false) ?? []),
     handler: async (args, ctx) => {
       const parts = parseArgs(args);
       const cmd = parts[0];

package/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.14.2",
+  "version": "2.16.0",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -31,8 +31,8 @@
     "test": "npx tsx --test reminder.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.2",
-    "@pi-unipi/info-screen": "2.14.2"
+    "@pi-unipi/core": "2.16.0",
+    "@pi-unipi/info-screen": "2.16.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "2.14.2",
+  "version": "2.16.0",
   "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
   "type": "module",
   "main": "src/index.ts",
@@ -9,7 +9,7 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/core": "2.16.0",
     "@earendil-works/pi-agent-core": "^0.84.0",
     "acorn": "8.18.0"
   },

package/packages/subagents/src/custom-agents.ts

@@ -151,8 +151,28 @@ function listAgentFilesRecursive(dir: string): string[] {
   return files;
 }
 
-/** Builtin agent definition files shipped in packages/subagents/agents/. */
-const BUILTIN_AGENTS_DIR = join(dirname(fileURLToPath(import.meta.url)), "..", "agents");
+/**
+ * Builtin agent definition files shipped in packages/subagents/agents/.
+ *
+ * Layout-aware (issue #35): when loaded from source (packages/subagents/src/)
+ * the agents dir is one level up; when loaded from the umbrella bundle
+ * (packages/unipi/bundled.js — the file npm ships and pi actually executes)
+ * `import.meta.url` points at packages/unipi/, so the files are two levels up
+ * under ../subagents/agents. The first candidate that exists wins, so both
+ * layouts resolve without build-time path injection.
+ */
+export function resolveBuiltinAgentsDir(fromUrl: string = import.meta.url): string {
+  const here = dirname(fileURLToPath(fromUrl));
+  for (const candidate of [
+    join(here, "..", "agents"), // source layout: src/ → agents/
+    join(here, "..", "subagents", "agents"), // bundle layout: packages/unipi/bundled.js → packages/subagents/agents
+  ]) {
+    if (existsSync(candidate)) return candidate;
+  }
+  return join(here, "..", "agents");
+}
+
+const BUILTIN_AGENTS_DIR = resolveBuiltinAgentsDir();
 
 /** Frontmatter fields stored as-is on the config for later phases. */
 function collectExtraFields(frontmatter: Record<string, unknown>): Record<string, string> | undefined {

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/trajectory",
-  "version": "2.14.2",
+  "version": "2.16.0",
   "description": "Live UniPi trajectory inspector for Pi sessions",
   "type": "module",
   "main": "index.ts",