@aliou/pi-processes 0.9.4 → 0.10.0

package/src/commands/processes/command.ts

@@ -1,39 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { ProcessesComponent } from "../../components/processes-component";
-import type { DockActions } from "../../hooks/widget";
-import type { ProcessManager } from "../../manager";
-
-export function registerPsCommand(
-  pi: ExtensionAPI,
-  manager: ProcessManager,
-  dockActions: DockActions,
-): void {
-  pi.registerCommand("ps", {
-    description: "View and manage background processes",
-    handler: async (_args, ctx) => {
-      if (!ctx.hasUI) {
-        return;
-      }
-
-      const result = await ctx.ui.custom<string | null>(
-        (tui, theme, _keybindings, done) => {
-          return new ProcessesComponent(
-            tui,
-            theme,
-            (processId?: string) => {
-              if (processId) {
-                dockActions.setFocus(processId);
-              }
-              done(processId ?? null);
-            },
-            manager,
-          );
-        },
-      );
-
-      if (result === undefined) {
-        return;
-      }
-    },
-  });
-}

package/src/commands/processes/index.ts

@@ -1 +0,0 @@
-export { registerPsCommand } from "./command";

package/src/commands/settings/apply-setting-change.ts

@@ -1,72 +0,0 @@
-import type { ProcessesConfig } from "../../config";
-
-export function applySettingChange(
-  id: string,
-  newValue: string,
-  config: ProcessesConfig,
-): ProcessesConfig | null {
-  const updated = structuredClone(config);
-
-  if (id === "interception.blockBackgroundCommands") {
-    if (!updated.interception) updated.interception = {};
-    updated.interception.blockBackgroundCommands = newValue === "on";
-    return updated;
-  }
-  if (id === "widget.showStatusWidget") {
-    if (!updated.widget) updated.widget = {};
-    updated.widget.showStatusWidget = newValue === "on";
-    return updated;
-  }
-  if (id === "widget.dockDefaultState") {
-    if (!updated.widget) updated.widget = {};
-    updated.widget.dockDefaultState =
-      newValue === "hidden" ? "hidden" : "collapsed";
-    return updated;
-  }
-  if (id === "widget.dockHeight") {
-    if (!updated.widget) updated.widget = {};
-    updated.widget.dockHeight = Number.parseInt(newValue, 10);
-    return updated;
-  }
-  if (id === "follow.enabledByDefault") {
-    if (!updated.follow) updated.follow = {};
-    updated.follow.enabledByDefault = newValue === "on";
-    return updated;
-  }
-  if (id === "follow.autoHideOnFinish") {
-    if (!updated.follow) updated.follow = {};
-    updated.follow.autoHideOnFinish = newValue === "on";
-    return updated;
-  }
-  if (id === "execution.shellPath") {
-    if (!updated.execution) updated.execution = {};
-    updated.execution.shellPath = newValue === "auto" ? undefined : newValue;
-    return updated;
-  }
-
-  const num = Number.parseInt(newValue, 10);
-  if (Number.isNaN(num)) return null;
-
-  switch (id) {
-    case "processList.maxVisibleProcesses":
-      if (!updated.processList) updated.processList = {};
-      updated.processList.maxVisibleProcesses = num;
-      break;
-    case "processList.maxPreviewLines":
-      if (!updated.processList) updated.processList = {};
-      updated.processList.maxPreviewLines = num;
-      break;
-    case "output.defaultTailLines":
-      if (!updated.output) updated.output = {};
-      updated.output.defaultTailLines = num;
-      break;
-    case "output.maxOutputLines":
-      if (!updated.output) updated.output = {};
-      updated.output.maxOutputLines = num;
-      break;
-    default:
-      return null;
-  }
-
-  return updated;
-}

package/src/commands/settings/build-sections.ts

@@ -1,160 +0,0 @@
-import type { SettingsSection } from "@aliou/pi-utils-settings";
-import type { ProcessesConfig, ResolvedProcessesConfig } from "../../config";
-
-export function buildSettingsSections(
-  tabConfig: ProcessesConfig | null,
-  resolved: ResolvedProcessesConfig,
-): SettingsSection[] {
-  return [
-    {
-      label: "Process List",
-      items: [
-        {
-          id: "processList.maxVisibleProcesses",
-          label: "Max visible processes",
-          description:
-            "Maximum processes shown in the /ps list before scrolling",
-          currentValue: String(
-            tabConfig?.processList?.maxVisibleProcesses ??
-              resolved.processList.maxVisibleProcesses,
-          ),
-          values: ["4", "6", "8", "12", "16"],
-        },
-        {
-          id: "processList.maxPreviewLines",
-          label: "Max preview lines",
-          description: "Log preview lines shown below the selected process",
-          currentValue: String(
-            tabConfig?.processList?.maxPreviewLines ??
-              resolved.processList.maxPreviewLines,
-          ),
-          values: ["6", "8", "12", "16", "24"],
-        },
-      ],
-    },
-    {
-      label: "Output Limits",
-      items: [
-        {
-          id: "output.defaultTailLines",
-          label: "Default tail lines",
-          description: "Number of tail lines returned to the agent by default",
-          currentValue: String(
-            tabConfig?.output?.defaultTailLines ??
-              resolved.output.defaultTailLines,
-          ),
-          values: ["50", "100", "200", "500"],
-        },
-        {
-          id: "output.maxOutputLines",
-          label: "Max output lines",
-          description: "Hard cap on output lines returned to the agent",
-          currentValue: String(
-            tabConfig?.output?.maxOutputLines ?? resolved.output.maxOutputLines,
-          ),
-          values: ["100", "200", "500", "1000"],
-        },
-      ],
-    },
-    {
-      label: "Execution",
-      items: [
-        {
-          id: "execution.shellPath",
-          label: "Shell path",
-          description: "Absolute shell path override used to execute commands",
-          currentValue:
-            tabConfig?.execution?.shellPath ??
-            resolved.execution.shellPath ??
-            "auto",
-          values: [
-            "auto",
-            "/run/current-system/sw/bin/bash",
-            "/bin/bash",
-            "/usr/bin/bash",
-            "/usr/local/bin/bash",
-          ],
-        },
-      ],
-    },
-    {
-      label: "Interception",
-      items: [
-        {
-          id: "interception.blockBackgroundCommands",
-          label: "Block background commands",
-          description:
-            "Block bash background commands (&, nohup, disown, setsid) and guide the model to use the process tool",
-          currentValue:
-            (tabConfig?.interception?.blockBackgroundCommands ??
-            resolved.interception.blockBackgroundCommands)
-              ? "on"
-              : "off",
-          values: ["on", "off"],
-        },
-      ],
-    },
-    {
-      label: "Widget",
-      items: [
-        {
-          id: "widget.showStatusWidget",
-          label: "Show status widget",
-          description: "Show process status widget below the editor",
-          currentValue:
-            (tabConfig?.widget?.showStatusWidget ??
-            resolved.widget.showStatusWidget)
-              ? "on"
-              : "off",
-          values: ["on", "off"],
-        },
-        {
-          id: "widget.dockDefaultState",
-          label: "Dock default state",
-          description:
-            "Default visibility state of the log dock when follow mode is on",
-          currentValue:
-            tabConfig?.widget?.dockDefaultState ??
-            resolved.widget.dockDefaultState,
-          values: ["hidden", "collapsed"],
-        },
-        {
-          id: "widget.dockHeight",
-          label: "Dock height",
-          description: "Height of the log dock in lines when open",
-          currentValue: String(
-            tabConfig?.widget?.dockHeight ?? resolved.widget.dockHeight,
-          ),
-          values: ["8", "10", "12", "16", "20"],
-        },
-      ],
-    },
-    {
-      label: "Follow Mode",
-      items: [
-        {
-          id: "follow.enabledByDefault",
-          label: "Enable by default",
-          description: "Automatically show logs when a process starts",
-          currentValue:
-            (tabConfig?.follow?.enabledByDefault ??
-            resolved.follow.enabledByDefault)
-              ? "on"
-              : "off",
-          values: ["on", "off"],
-        },
-        {
-          id: "follow.autoHideOnFinish",
-          label: "Auto-hide on finish",
-          description: "Hide dock when all processes finish",
-          currentValue:
-            (tabConfig?.follow?.autoHideOnFinish ??
-            resolved.follow.autoHideOnFinish)
-              ? "on"
-              : "off",
-          values: ["on", "off"],
-        },
-      ],
-    },
-  ];
-}

package/src/commands/settings/command.ts

@@ -1,20 +0,0 @@
-import { registerSettingsCommand } from "@aliou/pi-utils-settings";
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import type { ProcessesConfig, ResolvedProcessesConfig } from "../../config";
-import { configLoader } from "../../config";
-import { applySettingChange } from "./apply-setting-change";
-import { buildSettingsSections } from "./build-sections";
-
-export function registerProcessesSettings(
-  pi: ExtensionAPI,
-  onSave?: () => void,
-): void {
-  registerSettingsCommand<ProcessesConfig, ResolvedProcessesConfig>(pi, {
-    commandName: "ps:settings",
-    title: "Processes Settings",
-    configStore: configLoader,
-    buildSections: buildSettingsSections,
-    onSettingChange: applySettingChange,
-    onSave,
-  });
-}

package/src/commands/settings/index.ts

@@ -1 +0,0 @@
-export { registerProcessesSettings } from "./command";

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

@@ -1,29 +0,0 @@
-import { visibleWidth } from "@earendil-works/pi-tui";
-import { describe, expect, it } from "vitest";
-import { renderCollapsedDockLine } from "./log-dock-component";
-
-const LONG_LOG_LINE =
-  "build-step - 3f7a9c2 pending ↻ https://example.com/pipelines/project/service/123456/workflows/abcdef12-3456-7890-abcd-ef1234567890/jobs/integration-test?token=very-long-unbroken-log-segment-and-query-string";
-
-describe("renderCollapsedDockLine", () => {
-  it("leaves a spare terminal column for long log lines", () => {
-    for (const width of [1, 2, 40, 80, 120]) {
-      const rendered = renderCollapsedDockLine(LONG_LOG_LINE, width);
-
-      expect(visibleWidth(rendered)).toBe(width - 1);
-    }
-  });
-
-  it("leaves a spare terminal column for ansi-styled log lines", () => {
-    const rendered = renderCollapsedDockLine(
-      `\u001b[2m${LONG_LOG_LINE}\u001b[22m`,
-      80,
-    );
-
-    expect(visibleWidth(rendered)).toBe(79);
-  });
-
-  it("renders nothing for zero width", () => {
-    expect(renderCollapsedDockLine(LONG_LOG_LINE, 0)).toBe("");
-  });
-});

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

@@ -1,236 +0,0 @@
-/**
- * Log Dock Component - shows process logs in the bottom dock.
- *
- * Collapsed view: one-line summary (running procs) + last log line.
- * Open view: LogFileViewer for the focused process (or first running), follow mode on.
- */
-
-import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
-import type { Component } from "@earendil-works/pi-tui";
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { LIVE_STATUSES } from "../constants";
-import type { ProcessManager } from "../manager";
-import { stripAnsi } from "../utils";
-import { LogFileViewer } from "./log-file-viewer";
-import {
-  createPanelPadder,
-  renderPanelRule,
-  renderPanelTitleLine,
-} from "./panel-helpers";
-
-const PROCESS_COLORS: ThemeColor[] = [
-  "accent",
-  "warning",
-  "success",
-  "error",
-  "accent",
-  "dim",
-  "accent",
-  "warning",
-];
-
-const COLLAPSED_DOCK_RIGHT_MARGIN = 1;
-
-function getCollapsedDockLineWidth(width: number): number {
-  return Math.max(0, width - COLLAPSED_DOCK_RIGHT_MARGIN);
-}
-
-export function renderCollapsedDockLine(
-  content: string,
-  width: number,
-): string {
-  const lineWidth = getCollapsedDockLineWidth(width);
-  if (lineWidth === 0) return "";
-
-  const innerWidth = Math.max(0, lineWidth - 2);
-  const line = truncateToWidth(content, innerWidth, "", true);
-  return ` ${line}${" ".repeat(Math.max(0, lineWidth - 1 - visibleWidth(line)))}`;
-}
-
-interface LogDockOptions {
-  manager: ProcessManager;
-  theme: Theme;
-  tui: { requestRender: () => void };
-  mode: "collapsed" | "open";
-  focusedProcessId: string | null;
-  dockHeight?: number;
-}
-
-export class LogDockComponent implements Component {
-  private manager: ProcessManager;
-  private theme: Theme;
-  private tui: { requestRender: () => void };
-  private dockHeight: number;
-  private mode: "collapsed" | "open";
-  private focusedProcessId: string | null;
-
-  private unsubscribeManager: (() => void) | null = null;
-
-  /** One viewer per process, lazily created, follow:true. */
-  private viewers: Map<string, LogFileViewer> = new Map();
-
-  private processColors: Map<string, ThemeColor> = new Map();
-  private colorCounter = 0;
-
-  constructor(options: LogDockOptions) {
-    this.manager = options.manager;
-    this.theme = options.theme;
-    this.tui = options.tui;
-    this.dockHeight = options.dockHeight ?? 12;
-    this.mode = options.mode;
-    this.focusedProcessId = options.focusedProcessId;
-
-    this.unsubscribeManager = this.manager.onEvent(() => {
-      this.tui.requestRender();
-    });
-  }
-
-  update(opts: {
-    mode: "collapsed" | "open";
-    focusedProcessId: string | null;
-    dockHeight: number;
-  }): void {
-    this.mode = opts.mode;
-    this.focusedProcessId = opts.focusedProcessId;
-    this.dockHeight = opts.dockHeight;
-    this.tui.requestRender();
-  }
-
-  handleInput(_data: string): boolean {
-    return false;
-  }
-
-  invalidate(): void {
-    // No local cache; always renders fresh.
-  }
-
-  private getProcessColor(processId: string): ThemeColor {
-    const existing = this.processColors.get(processId);
-    if (existing) return existing;
-    const color = PROCESS_COLORS[this.colorCounter % PROCESS_COLORS.length];
-    this.colorCounter++;
-    this.processColors.set(processId, color);
-    return color;
-  }
-
-  private getViewer(processId: string, combinedFile: string): LogFileViewer {
-    let viewer = this.viewers.get(processId);
-    if (!viewer) {
-      viewer = new LogFileViewer({
-        filePath: combinedFile,
-        format: "combined",
-        theme: this.theme,
-        follow: true,
-      });
-      this.viewers.set(processId, viewer);
-    }
-    return viewer;
-  }
-
-  render(width: number): string[] {
-    if (this.mode === "collapsed") return this.renderCollapsed(width);
-    return this.renderOpen(width);
-  }
-
-  private renderCollapsed(width: number): string[] {
-    const theme = this.theme;
-    const dim = (s: string) => theme.fg("dim", s);
-    const fg = (color: ThemeColor, s: string) => theme.fg(color, s);
-
-    const processes = this.manager.list();
-    const lineWidth = getCollapsedDockLineWidth(width);
-    const padLine = (content: string) =>
-      renderCollapsedDockLine(content, width);
-
-    if (processes.length === 0) {
-      return [renderPanelRule(lineWidth, theme), padLine(dim("No processes"))];
-    }
-
-    const running = processes.filter((p) => LIVE_STATUSES.has(p.status));
-    const finished = processes.filter((p) => !LIVE_STATUSES.has(p.status));
-
-    const parts: string[] = [];
-    for (const proc of running) {
-      const color = this.getProcessColor(proc.id);
-      parts.push(`${fg(color, "●")} ${proc.name}`);
-    }
-    if (finished.length > 0) {
-      parts.push(dim(`+${finished.length} finished`));
-    }
-
-    const firstLine = parts.join(" | ");
-    const lines = [renderPanelRule(lineWidth, theme), padLine(firstLine)];
-
-    if (running.length > 0) {
-      const lastLogs = this.manager.getCombinedOutput(running[0].id, 1);
-      if (lastLogs && lastLogs.length > 0) {
-        const lastLog = stripAnsi(lastLogs[lastLogs.length - 1].text);
-        lines.push(padLine(dim(lastLog)));
-      }
-    }
-
-    return lines;
-  }
-
-  private renderOpen(width: number): string[] {
-    const theme = this.theme;
-    const dim = (s: string) => theme.fg("dim", s);
-
-    const innerWidth = width - 2;
-    const basePadLine = createPanelPadder(width);
-    const padLine = (content: string): string =>
-      basePadLine(
-        visibleWidth(content) > innerWidth
-          ? truncateToWidth(content, innerWidth, "", true)
-          : content,
-      );
-
-    const processes = this.manager.list();
-    const running = processes.filter((p) => LIVE_STATUSES.has(p.status));
-
-    const targetProc =
-      (this.focusedProcessId
-        ? processes.find((p) => p.id === this.focusedProcessId)
-        : null) ??
-      running[0] ??
-      processes[0] ??
-      null;
-
-    if (!targetProc) {
-      return [
-        renderPanelTitleLine("Process Logs", width, theme),
-        padLine(dim("No processes")),
-        padLine(dim("Run a command to start")),
-      ];
-    }
-
-    const logFiles = this.manager.getLogFiles(targetProc.id);
-    if (!logFiles) {
-      return [
-        renderPanelTitleLine("Process Logs", width, theme),
-        padLine(dim("Log files unavailable")),
-      ];
-    }
-
-    const viewer = this.getViewer(targetProc.id, logFiles.combinedFile);
-
-    const logRows = Math.max(1, this.dockHeight - 2);
-
-    const title = `${targetProc.name} ${dim(`(${targetProc.id})`)}`;
-    const lines: string[] = [];
-    lines.push(renderPanelTitleLine(title, width, theme));
-
-    const contentLines = viewer.renderLines(innerWidth, logRows);
-    for (let i = 0; i < logRows; i++) {
-      lines.push(padLine(contentLines[i] ?? ""));
-    }
-
-    return lines.slice(0, this.dockHeight);
-  }
-
-  dispose(): void {
-    this.unsubscribeManager?.();
-    this.viewers.clear();
-    this.processColors.clear();
-  }
-}