@aliou/pi-processes 0.6.4 → 0.7.1

package/README.md

@@ -114,6 +114,55 @@ Available settings include:
 - Linux: supported
 - Windows: not supported
 
+## Runtime log watch alerts
+
+Use `process` tool `start` with `logWatches` to trigger immediate alerts while the process is still running.
+
+- default behavior: each watch fires once (`repeat: false`)
+- set `repeat: true` to trigger on every match
+- scope by stream (`stdout`, `stderr`, `both`) to reduce noise
+
+Example: server ready marker (one-time default)
+
+```json
+{
+  "action": "start",
+  "name": "dev-server",
+  "command": "pnpm dev",
+  "logWatches": [
+    { "pattern": "ready on http://localhost:3000" }
+  ]
+}
+```
+
+Example: error marker from stderr
+
+```json
+{
+  "action": "start",
+  "name": "builder",
+  "command": "pnpm build --watch",
+  "logWatches": [
+    { "pattern": "TypeError|ReferenceError", "stream": "stderr" }
+  ]
+}
+```
+
+Example: repeatable watch on stdout only
+
+```json
+{
+  "action": "start",
+  "name": "worker",
+  "command": "pnpm worker",
+  "logWatches": [
+    { "pattern": "job completed", "stream": "stdout", "repeat": true }
+  ]
+}
+```
+
+Invalid regex patterns fail fast at process start with a clear error.
+
 ## Troubleshooting
 
 ### Pi started something and I want to see more output

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-processes",
-  "version": "0.6.4",
+  "version": "0.7.1",
   "license": "MIT",
   "type": "module",
   "private": false,
@@ -39,16 +39,16 @@
     "@sinclair/typebox": "^0.34.41"
   },
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "0.61.0",
-    "@mariozechner/pi-tui": "0.61.0"
+    "@mariozechner/pi-coding-agent": "0.65.0",
+    "@mariozechner/pi-tui": "0.65.0"
   },
   "devDependencies": {
     "@aliou/biome-plugins": "^0.3.2",
     "@aliou/pi-evals": "^0.3.0",
     "@biomejs/biome": "^2.3.13",
     "@changesets/cli": "^2.27.11",
-    "@mariozechner/pi-ai": "0.61.0",
-    "@mariozechner/pi-coding-agent": "0.61.0",
+    "@mariozechner/pi-ai": "0.65.0",
+    "@mariozechner/pi-coding-agent": "0.65.0",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",
     "typescript": "^5.9.3",
@@ -69,6 +69,7 @@
     "check:lockfile": "pnpm install --frozen-lockfile --ignore-scripts",
     "changeset": "changeset",
     "version": "changeset version",
+    "test": "vitest run",
     "release": "pnpm changeset publish"
   }
 }

package/src/commands/kill/command.ts

@@ -19,7 +19,7 @@ export function registerPsKillCommand(
       let processId: string | undefined;
 
       if (arg) {
-        const proc = manager.find(arg);
+        const proc = manager.get(arg);
         if (!proc) {
           return;
         }
@@ -49,18 +49,18 @@ export function registerPsKillCommand(
         }
       }
 
+      if (!processId) return;
+
       const proc = manager.get(processId);
-      if (!proc) {
-        return;
-      }
+      if (!proc) return;
 
       const signal =
         proc.status === "terminate_timeout" ? "SIGKILL" : "SIGTERM";
       const timeoutMs = signal === "SIGKILL" ? 200 : 3000;
-      const result = await manager.kill(processId, { signal, timeoutMs });
+      const result = await manager.kill(proc.id, { signal, timeoutMs });
 
       if (result.ok) {
-        if (dockActions.getFocusedProcessId() === processId) {
+        if (dockActions.getFocusedProcessId() === proc.id) {
           dockActions.setFocus(null);
         }
       }

package/src/commands/logs/command.ts

@@ -18,7 +18,7 @@ export function registerPsLogsCommand(
       let processId: string | undefined;
 
       if (arg) {
-        const proc = manager.find(arg);
+        const proc = manager.get(arg);
         if (!proc) return;
         processId = proc.id;
       }

package/src/commands/pin/command.ts

@@ -17,7 +17,7 @@ export function registerPsPinCommand(
       let processId: string | undefined;
 
       if (arg) {
-        const proc = manager.find(arg);
+        const proc = manager.get(arg);
         if (!proc) {
           return;
         }
@@ -27,6 +27,7 @@ export function registerPsPinCommand(
         if (!processId) return;
       }
 
+      if (!processId) return;
       dockActions.setFocus(processId);
     },
   });

package/src/components/log-dock-component.ts

@@ -17,8 +17,6 @@ import { LIVE_STATUSES } from "../constants";
 import type { ProcessManager } from "../manager";
 import { LogFileViewer } from "./log-file-viewer";
 
-const POLL_INTERVAL_MS = 500;
-
 const PROCESS_COLORS: ThemeColor[] = [
   "accent",
   "warning",
@@ -47,7 +45,6 @@ export class LogDockComponent implements Component {
   private mode: "collapsed" | "open";
   private focusedProcessId: string | null;
 
-  private timer: ReturnType<typeof setInterval> | null = null;
   private unsubscribeManager: (() => void) | null = null;
 
   /** One viewer per process, lazily created, follow:true. */
@@ -64,10 +61,6 @@ export class LogDockComponent implements Component {
     this.mode = options.mode;
     this.focusedProcessId = options.focusedProcessId;
 
-    this.timer = setInterval(() => {
-      this.tui.requestRender();
-    }, POLL_INTERVAL_MS);
-
     this.unsubscribeManager = this.manager.onEvent(() => {
       this.tui.requestRender();
     });
@@ -227,10 +220,6 @@ export class LogDockComponent implements Component {
   }
 
   dispose(): void {
-    if (this.timer) {
-      clearInterval(this.timer);
-      this.timer = null;
-    }
     this.unsubscribeManager?.();
     this.viewers.clear();
     this.processColors.clear();

package/src/components/log-overlay-component.ts

@@ -61,7 +61,6 @@ export class LogOverlayComponent implements Component {
   private mode: OverlayMode = "normal";
   private searchInput: Input = new Input();
 
-  private timer: ReturnType<typeof setInterval> | null = null;
   private unsubscribeManager: (() => void) | null = null;
 
   constructor(opts: LogOverlayOptions) {
@@ -91,10 +90,6 @@ export class LogOverlayComponent implements Component {
       this.tui.requestRender();
     });
 
-    this.timer = setInterval(() => {
-      this.tui.requestRender();
-    }, 300);
-
     this.searchInput.onSubmit = (query) => {
       const trimmed = query.trim();
       if (trimmed) {
@@ -163,10 +158,6 @@ export class LogOverlayComponent implements Component {
   // ---------------------------------------------------------------------------
 
   private close(): void {
-    if (this.timer) {
-      clearInterval(this.timer);
-      this.timer = null;
-    }
     this.unsubscribeManager?.();
     this.unsubscribeManager = null;
     this.done();

package/src/components/processes-component.ts

@@ -48,6 +48,19 @@ function truncate(str: string, maxLen: number): string {
   return `${str.slice(0, maxLen - 3)}...`;
 }
 
+function fitCell(
+  value: string,
+  width: number,
+  align: "left" | "right" = "left",
+): string {
+  const truncated = truncateToWidth(value, Math.max(0, width));
+  const pad = Math.max(0, width - visibleWidth(truncated));
+  if (align === "right") {
+    return " ".repeat(pad) + truncated;
+  }
+  return truncated + " ".repeat(pad);
+}
+
 export class ProcessesComponent implements Component {
   private tui: { requestRender: () => void };
   private theme: Theme;
@@ -243,8 +256,7 @@ export class ProcessesComponent implements Component {
       const scaleFactor =
         innerWidth < minTotalWidth ? innerWidth / minTotalWidth : 1;
 
-      const idWidth = Math.max(6, Math.floor(9 * scaleFactor));
-      const nameWidth = Math.max(8, Math.floor(15 * scaleFactor));
+      const processWidth = Math.max(14, Math.floor(24 * scaleFactor));
       const statusWidth = Math.max(10, Math.floor(18 * scaleFactor));
       const timeWidth = Math.max(4, Math.floor(8 * scaleFactor));
       const sizeWidth = Math.max(4, Math.floor(8 * scaleFactor));
@@ -258,8 +270,7 @@ export class ProcessesComponent implements Component {
       // Calculate command column width based on remaining space
       const fixedWidth =
         prefixWidth +
-        idWidth +
-        nameWidth +
+        processWidth +
         statusWidth +
         timeWidth +
         sizeWidth +
@@ -269,8 +280,7 @@ export class ProcessesComponent implements Component {
       lines.push(padLine(""));
       const header =
         "  " +
-        dim("ID".padEnd(idWidth)) +
-        dim("Name".padEnd(nameWidth)) +
+        dim("Process".padEnd(processWidth)) +
         dim("Command".padEnd(cmdWidth)) +
         dim("Status".padEnd(statusWidth)) +
         dim("Time".padEnd(timeWidth)) +
@@ -294,18 +304,24 @@ export class ProcessesComponent implements Component {
         const totalSize = sizes ? sizes.stdout + sizes.stderr : 0;
 
         const statusText = this.formatStatus(proc);
-        const statusPadding =
-          statusWidth + (statusText.length - visibleWidth(statusText));
+
+        // Keep process cell bounded even with large IDs.
+        const idPlain = `(${proc.id})`;
+        const maxNameLen = Math.max(
+          1,
+          processWidth - visibleWidth(idPlain) - 1,
+        );
+        const tName = truncate(proc.name, maxNameLen);
+        const processCell = isSelected
+          ? `${accent(tName)} ${dim(` ${idPlain}`)}`
+          : `${tName}${dim(` ${idPlain}`)}`;
 
         const row =
-          (isSelected
-            ? accent(proc.id.padEnd(idWidth))
-            : proc.id.padEnd(idWidth)) +
-          truncate(proc.name, nameWidth - 1).padEnd(nameWidth) +
-          truncate(proc.command, cmdWidth - 1).padEnd(cmdWidth) +
-          statusText.padEnd(statusPadding) +
-          formatRuntime(proc.startTime, proc.endTime).padEnd(timeWidth) +
-          formatBytes(totalSize).padStart(sizeWidth);
+          fitCell(processCell, processWidth) +
+          fitCell(truncate(proc.command, cmdWidth - 1), cmdWidth) +
+          fitCell(statusText, statusWidth) +
+          fitCell(formatRuntime(proc.startTime, proc.endTime), timeWidth) +
+          fitCell(formatBytes(totalSize), sizeWidth, "right");
 
         if (isSelected) {
           lines.push(padLine(`${accent(">")} ${row}`));

package/src/constants/index.ts

@@ -1,7 +1,11 @@
 export type {
   ExecuteResult,
   KillResult,
+  LogWatch,
+  LogWatchMatchEvent,
+  LogWatchStream,
   ManagerEvent,
+  ProcessAction,
   ProcessesDetails,
   ProcessInfo,
   ProcessStatus,

package/src/constants/types.ts

@@ -1,6 +1,16 @@
 // Custom message type for process update notifications
 export const MESSAGE_TYPE_PROCESS_UPDATE = "ad-process:update";
 
+export type ProcessAction =
+  | "start"
+  | "list"
+  | "output"
+  | "logs"
+  | "kill"
+  | "clear"
+  | "write"
+  | "debug_preview";
+
 export type ProcessStatus =
   | "running"
   | "terminating"
@@ -14,6 +24,14 @@ export const LIVE_STATUSES: ReadonlySet<ProcessStatus> = new Set([
   "terminate_timeout",
 ]);
 
+export type LogWatchStream = "stdout" | "stderr" | "both";
+
+export interface LogWatch {
+  pattern: string;
+  stream?: LogWatchStream;
+  repeat?: boolean;
+}
+
 export interface ProcessInfo {
   id: string;
   name: string;
@@ -32,9 +50,25 @@ export interface ProcessInfo {
   alertOnKill: boolean;
 }
 
+export interface LogWatchMatchEvent {
+  processId: string;
+  processName: string;
+  processCommand: string;
+  source: "stdout" | "stderr";
+  line: string;
+  watch: {
+    index: number;
+    pattern: string;
+    stream: LogWatchStream;
+    repeat: boolean;
+  };
+}
+
 export type ManagerEvent =
   | { type: "process_started"; info: ProcessInfo }
   | { type: "process_ended"; info: ProcessInfo }
+  | { type: "process_output_changed"; id: string }
+  | { type: "process_watch_matched"; match: LogWatchMatchEvent }
   | { type: "processes_changed" };
 
 export type KillResult =
@@ -52,10 +86,11 @@ export interface StartOptions {
   alertOnSuccess?: boolean;
   alertOnFailure?: boolean;
   alertOnKill?: boolean;
+  logWatches?: LogWatch[];
 }
 
 export interface ProcessesDetails {
-  action: string;
+  action: ProcessAction;
   success: boolean;
   message: string;
   process?: ProcessInfo;

package/src/hooks/index.ts

@@ -5,6 +5,7 @@ import { setupBackgroundBlocker } from "./background-blocker";
 import { setupCleanupHook } from "./cleanup";
 import { setupMessageRenderer } from "./message-renderer";
 import { setupProcessEndHook } from "./process-end";
+import { setupProcessWatchHook } from "./process-watch";
 import { type DockActions, setupProcessWidget } from "./widget";
 
 export type { DockActions };
@@ -16,6 +17,7 @@ export function setupProcessesHooks(
 ): { update: () => void; dockActions: DockActions } {
   setupCleanupHook(pi, manager);
   setupProcessEndHook(pi, manager);
+  setupProcessWatchHook(pi, manager);
 
   if (config.interception.blockBackgroundCommands) {
     setupBackgroundBlocker(pi);

package/src/hooks/message-renderer.ts

@@ -6,7 +6,8 @@ import type {
 import { Text } from "@mariozechner/pi-tui";
 import { MESSAGE_TYPE_PROCESS_UPDATE } from "../constants";
 
-interface ProcessUpdateDetails {
+interface ProcessLifecycleDetails {
+  kind?: "lifecycle";
   processId: string;
   processName: string;
   command: string;
@@ -16,10 +17,25 @@ interface ProcessUpdateDetails {
   runtime: string;
 }
 
+interface ProcessWatchMatchDetails {
+  kind: "watch_matched";
+  processId: string;
+  processName: string;
+  command: string;
+  source: "stdout" | "stderr";
+  line: string;
+  watch: {
+    index: number;
+    pattern: string;
+    stream: "stdout" | "stderr" | "both";
+    repeat: boolean;
+  };
+}
+
 interface ProcessUpdateMessage {
   customType: string;
   content: string | Array<{ type: string; text?: string }>;
-  details?: ProcessUpdateDetails;
+  details?: ProcessLifecycleDetails | ProcessWatchMatchDetails;
 }
 
 function getContentText(
@@ -35,7 +51,9 @@ function getContentText(
 }
 
 export function setupMessageRenderer(pi: ExtensionAPI) {
-  pi.registerMessageRenderer<ProcessUpdateDetails>(
+  pi.registerMessageRenderer<
+    ProcessLifecycleDetails | ProcessWatchMatchDetails
+  >(
     MESSAGE_TYPE_PROCESS_UPDATE,
     (
       message: ProcessUpdateMessage,
@@ -48,6 +66,20 @@ export function setupMessageRenderer(pi: ExtensionAPI) {
         return new Text(getContentText(message.content), 0, 0);
       }
 
+      if (details.kind === "watch_matched") {
+        const streamColor = details.source === "stderr" ? "warning" : "accent";
+        const text =
+          theme.fg("success", "* ") +
+          theme.fg("accent", `"${details.processName}"`) +
+          theme.fg("muted", ` (${details.processId}) `) +
+          theme.fg("success", "watch matched ") +
+          theme.fg("muted", `/${details.watch.pattern}/ `) +
+          theme.fg(streamColor, `[${details.source}]`) +
+          theme.fg("muted", ` ${details.line}`);
+
+        return new Text(text, 0, 0);
+      }
+
       let icon: string;
       let color: "success" | "error" | "warning";
 

package/src/hooks/process-end.ts

@@ -4,6 +4,7 @@ import type { ProcessManager } from "../manager";
 import { formatRuntime } from "../utils";
 
 interface ProcessUpdateDetails {
+  kind: "lifecycle";
   processId: string;
   processName: string;
   command: string;
@@ -43,6 +44,7 @@ export function setupProcessEndHook(pi: ExtensionAPI, manager: ProcessManager) {
     // Send the message to the conversation - displayed via custom renderer in UI
     // Only trigger an agent turn when the notification preferences say so.
     const details: ProcessUpdateDetails = {
+      kind: "lifecycle",
       processId: info.id,
       processName: info.name,
       command: info.command,

package/src/hooks/process-watch.ts

@@ -0,0 +1,83 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { MESSAGE_TYPE_PROCESS_UPDATE } from "../constants";
+import type { ProcessManager } from "../manager";
+
+interface ProcessWatchUpdateDetails {
+  kind: "watch_matched";
+  processId: string;
+  processName: string;
+  command: string;
+  source: "stdout" | "stderr";
+  line: string;
+  watch: {
+    index: number;
+    pattern: string;
+    stream: "stdout" | "stderr" | "both";
+    repeat: boolean;
+  };
+}
+
+const REPEAT_WATCH_TURN_COOLDOWN_MS = 5000;
+
+export function setupProcessWatchHook(
+  pi: ExtensionAPI,
+  manager: ProcessManager,
+) {
+  const lastRepeatTurnAt = new Map<string, number>();
+
+  manager.onEvent((event) => {
+    if (event.type === "process_ended") {
+      // Cleanup cooldown state for this process.
+      const prefix = `${event.info.id}:`;
+      for (const key of lastRepeatTurnAt.keys()) {
+        if (key.startsWith(prefix)) {
+          lastRepeatTurnAt.delete(key);
+        }
+      }
+      return;
+    }
+
+    if (event.type !== "process_watch_matched") return;
+
+    const match = event.match;
+    const message =
+      `Watch matched for '${match.processName}' (${match.processId}) ` +
+      `[${match.source}] /${match.watch.pattern}/`;
+
+    const details: ProcessWatchUpdateDetails = {
+      kind: "watch_matched",
+      processId: match.processId,
+      processName: match.processName,
+      command: match.processCommand,
+      source: match.source,
+      line: match.line,
+      watch: {
+        index: match.watch.index,
+        pattern: match.watch.pattern,
+        stream: match.watch.stream,
+        repeat: match.watch.repeat,
+      },
+    };
+
+    let triggerTurn = true;
+    if (match.watch.repeat) {
+      const watchKey = `${match.processId}:${match.watch.index}`;
+      const now = Date.now();
+      const last = lastRepeatTurnAt.get(watchKey) ?? 0;
+      triggerTurn = now - last >= REPEAT_WATCH_TURN_COOLDOWN_MS;
+      if (triggerTurn) {
+        lastRepeatTurnAt.set(watchKey, now);
+      }
+    }
+
+    pi.sendMessage(
+      {
+        customType: MESSAGE_TYPE_PROCESS_UPDATE,
+        content: message,
+        display: true,
+        details,
+      },
+      { triggerTurn },
+    );
+  });
+}

package/src/hooks/widget/setup.ts

@@ -147,10 +147,6 @@ export function setupProcessWidget(
   });
 
   pi.on("session_start", async (_event, ctx) => {
-    latestContext = ctx;
-  });
-
-  pi.on("session_switch", async (_event, ctx) => {
     if (logDockComponent) {
       logDockComponent.dispose();
       logDockComponent = null;