# pi-processes: v0.10.0

release · 2026-08-05 · #pi-processes · v0.10.0

### Minor Changes

- a146230: Bound in-memory process output by both line count and a new configurable byte budget. `/ps`, `/ps:logs`, and the dock now append live output without repeatedly reading full log files, and show a marker when a burst drops lines.
- 530dd99: Create the per-session log directory lazily, so a session that never starts a process leaves no temp directory behind. Cap each log file at 64 MB via truncate-and-restart; when a file exceeds the cap it is reset to a marker line and writing continues, so old history is discarded to bound disk (and RAM on tmpfs) usage. Budget ~128-192 MB per process.
- e6937a3: Rewrite `@aliou/pi-processes` into a pi-agnostic core plus three focused Pi extensions, each owning a self-contained UI.

  ## One package, three extensions

  - `extensions/processes` — the core: the `process` tool, settings, notifications, and the `/ps` overview panel, `/ps:kill`, `/ps:clear`, `/ps:settings`.
  - `extensions/processes-logs` — the `/ps:logs` log overlay with per-process tabs, stream filtering, follow, and search.
  - `extensions/processes-dock` — the dock UI: `/ps:dock`, `/ps:pin`, the dock widget, and the status widget.
  - `extensions/shared` — shared UI primitives (`statusDot`, `processStatusTone`, `LineComponent`) so all three extensions render status the same way.
  - `src/` — the pi-agnostic process manager. No UI, no Pi imports.

  ## Harmonized UI

  - One status-dot glyph system across the `/ps` panel, the `/ps:logs` overlay tabs, and the dock. Every surface shows the same running / terminating / killed / success / failure states.
  - The panel, overlay, and dock read from the same shared helpers, so truncation, color, and status tone never drift between surfaces.
  - `/ps` Enter pins to the dock (pin/unpin toggle) instead of focusing.
  - The status widget below the editor shares the same dot system and reflows on terminal resize with `+N more` overflow.

  ## Better log watches

  - Watches are manageable at runtime via the new `process update` action: add, replace, remove, or clear watches on a running process without restarting it.
  - `start` and `list` output show active watches, and the `/ps:logs` overlay highlights matches.
  - Stale log-match notifications are suppressed after a process ends or is cleared — watches are unregistered on `process_ended`, so belated output events for a cleared id short-circuit instead of flooding the conversation. Closes #54.
  - Empty match patterns (literal and regex) are rejected at `start`.

  ## Process tool

  Seven actions: `start`, `list`, `output`, `update`, `write`, `stop`, `clear`.

  - `start` restores the `cwd` parameter.
  - `output` filters by stream (stdout/stderr/both) and matches patterns.
  - `write` sends stdin and optionally closes it; no-op calls are rejected.
  - `clear` removes finished process entries.

  ## `/ps:logs` overlay

  - Per-process tabs (`tab`), stream cycling (`s`), follow toggle (`f`), search (`/`), match navigation (`n`/`N`), jump-to-bottom (`G`), close (`q`).
  - `LogFileViewer` is cached per process across tab switches.
  - Tab labels share the panel's status system, so they match the overview rows.

  ## Dock and status widget

  - `/ps:dock` (`expand`/`collapse`/`close`) and `/ps:pin`. Dock height is measured in log rows.
  - The dock auto-unpins a killed focused process via `processes-changed`, so `/ps:kill` never has to touch the dock.
  - Status widget (`widget.showStatusWidget`, off by default) renders a compact line of status dots under the editor, reflowing on resize.

  ## Settings and migration

  - `/ps:settings` covers process-list, output, dock, follow, status-widget, and interception options, persisted across sessions.
  - Imports the legacy `process.json` on first run and migrates v0.9.4 settings forward to v0.10.0, preserving `widget.showStatusWidget`.
  - Stamps migrated `processes.json` files with `version: "0.10.0"`, so future migrations can key off an explicit config version instead of inferring from shape.

  ## Notifications

  - Configurable events (`onSuccess`/`onFailure`/`onKilled`) with attention levels (`turn`/`context`/`ignore`). Defaults: `onKilled` = `context`, `blockBackgroundCommands` = `false`.
  - Log-watch alerts fan out and are highlighted in the overlay; the dead `timeout` kind is removed.

  ## Intentional changes

  - Log watches match literally by default with one-shot `repeat: false` defaults.
  - Process IDs are opaque; sorting, truncation, and color are UI concerns only.
  - Managed processes keep running in detached process groups when pi is suspended (`Ctrl+Z`); log capture continues and match notifications deliver once pi is foregrounded.

  ## Polish and runtime fixes

  - Rate-limit delivered log-match notifications to 20 per minute across all processes, summarize suppressed matches, and cool down repeated matchers to 15 seconds.
  - Share one `statusColor` / `statusDot` mapping across panel, overlay, dock, and widget; exited-success uses `✓`, and the widget collapses finished-success processes into a `✓ N done` summary.
  - Clamp dock sidebar width to the longest active process name; truncate tab labels instead of padding.
  - Drop the dock bottom border and fix a line-overflow crash on narrow terminals.
  - Re-read dock widget config on each render so `/ps:settings` changes apply immediately.
  - Reap old finished records from the manager.
  - Preserve leading empty lines in tail-style log views.

  ## Tooling

  - Targets Pi 0.80.3. 508 unit tests and 6 e2e tests pass; typecheck and lint clean. Tests are excluded from published files.

### Patch Changes

- df8478b: Polish the dock chrome for a cleaner look.

  - Drop the vertical side rails and corner borders.
  - Use a single space of side padding instead of `│` rails.
  - Keep a top bar with the title.
  - In expanded mode, add a full-width rule between the process strip and the streaming logs.
  - In collapsed mode, show only the header and a short log preview — no process strip.
  - Leave the bottom open so the dock still sits flush against the editor.

- 4d5b4d6: Fix issue #58: `process output` no longer persists raw stdout/stderr arrays in tool-result `details`. Output details now contain only metadata, including optional truncation info, while the bounded text preview is returned as tool-result `content`.
- f0111d9: Limit delivered log-match notifications to 20 per minute across all processes, summarize suppressed matches, and increase repeated matcher cooldowns to 15 seconds. Lifecycle notifications remain exempt.

- [GitHub release](https://github.com/aliou/pi-processes/releases/tag/v0.10.0)
- [npm](https://www.npmjs.com/package/@aliou/pi-processes/v/0.10.0)