@aliou/pi-processes 0.10.4 → 0.10.6

package/extensions/processes/config/index.ts

@@ -1,7 +1,6 @@
 export { DEFAULT_CONFIG } from "./defaults";
 export {
   configLoader,
-  createSettingsConfigStore,
   drainImportMessages,
   loadProcessConfig,
 } from "./loader";

package/extensions/processes/config/loader.ts

@@ -1,8 +1,4 @@
-import {
-  ConfigLoader,
-  type ConfigStore,
-  type Scope,
-} from "@aliou/pi-utils-settings";
+import { ConfigLoader } from "@aliou/pi-utils-settings";
 import { DEFAULT_CONFIG } from "./defaults";
 import { importLegacyProcessConfig, migrations } from "./migrations";
 import { PROCESS_CONFIG_SCHEMA_URL } from "./schema";
@@ -41,22 +37,3 @@ export const configLoader = new ConfigLoader<
   migrations,
   schemaUrl: PROCESS_CONFIG_SCHEMA_URL,
 });
-
-export function createSettingsConfigStore(): ConfigStore<
-  ProcessConfig,
-  ProcessProtocolConfig
-> {
-  return {
-    save: (scope, config) => configLoader.save(scope, config),
-    getConfig: () => configLoader.getConfig(),
-    getRawConfig: (scope) => configLoader.getRawConfig(scope),
-    hasScope: (scope) => configLoader.hasScope(scope),
-    hasConfig: (scope) => configLoader.hasConfig(scope),
-    getEnabledScopes: () => {
-      const enabled = new Set(configLoader.getEnabledScopes());
-      return (["global", "local", "memory"] as Scope[]).filter((scope) =>
-        enabled.has(scope),
-      );
-    },
-  };
-}

package/extensions/processes/config/migrations/001-v0-9-4-to-v0-10-0-config.ts

@@ -95,9 +95,31 @@ function migrateDockDefaultState(
   return undefined;
 }
 
+/** Config version this migration brings the config to. */
+export const CONFIG_VERSION_V0100 = "0.10.0";
+
+function compareSemver(a: string, b: string): number {
+  const left = a.split(".");
+  const right = b.split(".");
+
+  for (let i = 0; i < 3; i++) {
+    const diff = (Number(left[i]) || 0) - (Number(right[i]) || 0);
+    if (diff !== 0) return diff;
+  }
+
+  return 0;
+}
+
 export function needsConfigV094ToV0100Migration(
   config: ProcessConfig,
+  fromVersion: number | string = "0.0.0",
 ): boolean {
+  // Gate on content and version: the v0.9.4 projection drops keys added
+  // after v0.10.0, so it must never touch an already-stamped config.
+  if (compareSemver(String(fromVersion), CONFIG_VERSION_V0100) >= 0) {
+    return false;
+  }
+
   const root = config as Record<string, unknown>;
   const widget = isRecord(root.widget) ? root.widget : undefined;
 
@@ -177,7 +199,9 @@ function setNonEmpty<K extends keyof ConfigV0100>(
 
 export const configV094ToV0100Migration: Migration<ProcessConfig> = {
   name: "001-v0-9-4-to-v0-10-0-config",
-  shouldRun: (config) => needsConfigV094ToV0100Migration(config),
+  version: CONFIG_VERSION_V0100,
+  shouldRun: (config, ctx) =>
+    needsConfigV094ToV0100Migration(config, ctx.fromVersion),
   run: (config) => migrateConfigV094ToV0100(config as ConfigV094),
   message:
     "Migrated pi-processes settings to the current schema. Mapped the dock hidden state to closed.",

package/extensions/processes/config/migrations/002-stamp-config-version.ts

@@ -0,0 +1,24 @@
+import type { Migration } from "@aliou/pi-utils-settings";
+
+import type { ProcessConfig } from "../types";
+
+/**
+ * Current config version stamped on every settings file.
+ *
+ * Keep this in sync with the `--version` flag of the `gen:schema` and
+ * `check:schema` scripts in package.json.
+ */
+export const PROCESS_CONFIG_VERSION = "0.10.6";
+
+/**
+ * Terminal migration: converge every config on the current version.
+ *
+ * The config is left untouched; the loader stamps `version` after the run.
+ * Configs stamped by earlier migrations (or already current) are skipped by
+ * the default version comparison.
+ */
+export const configVersionStampMigration: Migration<ProcessConfig> = {
+  name: "002-stamp-config-version",
+  version: PROCESS_CONFIG_VERSION,
+  run: (config) => config,
+};

package/extensions/processes/config/migrations/index.ts

@@ -2,7 +2,7 @@ import type { Migration } from "@aliou/pi-utils-settings";
 
 import type { ProcessConfig } from "../types";
 import { configV094ToV0100Migration } from "./001-v0-9-4-to-v0-10-0-config";
-import { configVersionStampMigration } from "./002-stamp-v0-10-0-config-version";
+import { configVersionStampMigration } from "./002-stamp-config-version";
 
 export { importLegacyProcessConfig } from "./000-import-legacy-process-config";
 export {
@@ -14,10 +14,8 @@ export {
 } from "./001-v0-9-4-to-v0-10-0-config";
 export {
   configVersionStampMigration,
-  needsConfigVersionStamp,
   PROCESS_CONFIG_VERSION,
-  stampConfigVersion,
-} from "./002-stamp-v0-10-0-config-version";
+} from "./002-stamp-config-version";
 
 export const migrations: Migration<ProcessConfig>[] = [
   configV094ToV0100Migration,

package/extensions/processes/config/types.ts

@@ -49,12 +49,13 @@ export interface WidgetConfig {
   dockHeight?: number;
 }
 
-/** User-facing pi-processes settings stored on disk. */
+/**
+ * User-facing pi-processes settings stored on disk.
+ *
+ * The reserved `$schema` and `version` keys are owned by the config loader
+ * and injected into schema.json by `pi-settings-schema`.
+ */
 export interface ProcessConfig {
-  /** JSON Schema URL used by editors for validation and autocomplete. */
-  $schema?: string;
-  /** Config migration marker written after v0.10.0 settings migration. */
-  version?: string;
   /** Process execution settings. */
   execution?: ExecutionConfig;
   /** Shell-command interception settings. */

package/extensions/processes/message-renderer.ts

@@ -2,11 +2,17 @@ import type {
   ExtensionAPI,
   MessageRenderOptions,
   Theme,
+  ThemeColor,
 } from "@earendil-works/pi-coding-agent";
 import { type Component, Container, Text } from "@earendil-works/pi-tui";
 import { truncateForDisplay } from "../shared/display-text";
 import { MESSAGE_TYPE_PROCESS_NOTIFICATION } from "./constants";
-import type { ProcessNotificationDetails } from "./notifications/types";
+import type {
+  Attention,
+  ProcessNotificationDetails,
+  ProcessNotificationKind,
+} from "./notifications/types";
+import { formatPatternForDisplay, quoteFilter } from "./tools/components";
 
 export function registerProcessNotificationRenderer(pi: ExtensionAPI): void {
   pi.registerMessageRenderer<ProcessNotificationDetails>(
@@ -25,11 +31,17 @@ export function renderProcessNotificationMessage(
     return undefined;
   }
 
+  // outputPad is only populated on Pi 0.82.1+ (see MessageRenderOptions);
+  // fall back to 0 so this renderer doesn't break on older Pi builds.
+  const outputPad = options.outputPad ?? 0;
+
   const container = new Container();
-  container.addChild(new Text(formatSummary(details, theme), 0, 0));
+  container.addChild(new Text(formatSummary(details, theme), outputPad, 0));
 
   if (options.expanded) {
-    container.addChild(new Text(formatDetailLine(details, theme), 0, 1));
+    container.addChild(
+      new Text(formatDetailLine(details, theme), outputPad, 0),
+    );
   }
 
   return container;
@@ -66,17 +78,100 @@ function formatDetailLine(
   details: ProcessNotificationDetails,
   theme: Theme,
 ): string {
-  const parts = [
-    `id: ${details.processId}`,
-    `attention: ${details.attention}`,
-    details.status ? `status: ${details.status}` : null,
-    details.exitCode === undefined || details.exitCode === null
-      ? null
-      : `exit: ${details.exitCode}`,
-    details.endReason ? `reason: ${details.endReason}` : null,
-  ].filter(Boolean);
-
-  return theme.fg("muted", parts.join("  "));
+  const parts: string[] = [
+    field("id", details.processId, theme),
+    field("notify", formatAttention(details.attention, theme), theme),
+  ];
+
+  if (details.logMatch) {
+    const pattern = quoteFilter(
+      formatPatternForDisplay(details.logMatch.pattern),
+      details.logMatch.mode,
+    );
+    parts.push(
+      field("pattern", theme.fg("accent", pattern), theme),
+      field("stream", theme.fg("muted", `[${details.logMatch.stream}]`), theme),
+    );
+  } else {
+    if (details.status) {
+      parts.push(
+        field(
+          "status",
+          theme.fg(statusTone(details.kind), details.status),
+          theme,
+        ),
+      );
+    }
+
+    if (details.exitCode !== undefined && details.exitCode !== null) {
+      parts.push(
+        field(
+          "exit",
+          theme.fg(statusTone(details.kind), String(details.exitCode)),
+          theme,
+        ),
+      );
+    }
+
+    if (details.endReason) {
+      parts.push(field("reason", theme.fg("muted", details.endReason), theme));
+    }
+
+    if (details.signal) {
+      const number =
+        details.signal.number === null
+          ? ""
+          : ` (${details.signal.number}, ${details.signal.description})`;
+      parts.push(
+        field(
+          "signal",
+          theme.fg("muted", `${details.signal.name}${number}`),
+          theme,
+        ),
+      );
+    }
+  }
+
+  return parts.join("  ");
+}
+
+/** `label:` in muted, matching `buildField` in tools/utils.ts. */
+function field(label: string, value: string, theme: Theme): string {
+  return `${theme.fg("muted", `${label}:`)} ${value}`;
+}
+
+/**
+ * Plain-language attention level, reusing the tone mapping from
+ * `attentionTone` in tools/components/watch.ts (turn/context keep their
+ * color; ignore switches from muted to dim to read as "quieter").
+ */
+function formatAttention(attention: Attention, theme: Theme): string {
+  switch (attention) {
+    case "turn":
+      return theme.bold(theme.fg("warning", "now"));
+    case "context":
+      return theme.bold(theme.fg("success", "next turn"));
+    default:
+      return theme.bold(theme.fg("dim", "silent"));
+  }
+}
+
+/**
+ * Same tone family as `statusColor` in shared/ui.ts: success for a clean
+ * exit, error for failure/crash, dim for killed.
+ */
+function statusTone(kind: ProcessNotificationKind): ThemeColor {
+  switch (kind) {
+    case "success":
+      return "success";
+    case "failure":
+    case "crash":
+      return "error";
+    case "killed":
+      return "dim";
+    default:
+      return "muted";
+  }
 }
 
 function summaryVerb(details: ProcessNotificationDetails): string {

package/extensions/processes/settings/index.ts

@@ -6,18 +6,21 @@
  */
 
 import {
+  createConfigStore,
   registerSettingsCommand,
   type SettingsSection,
 } from "@aliou/pi-utils-settings";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 import type { ProcessConfig, ProcessProtocolConfig } from "../config";
-import { createSettingsConfigStore } from "../config";
+import { configLoader } from "../config";
 import { applySettingChange } from "./apply-setting-change";
 import { buildSections } from "./build-sections";
 
 export function registerProcessSettings(pi: ExtensionAPI): void {
-  const configStore = createSettingsConfigStore();
+  const configStore = createConfigStore(configLoader, {
+    scopes: ["global", "local", "memory"],
+  });
 
   registerSettingsCommand<ProcessConfig, ProcessProtocolConfig>(pi, {
     commandName: "ps:settings",

package/extensions/processes/tools/components/index.ts

@@ -1,4 +1,8 @@
 export { ProcessActionHeader } from "./process-action-header";
 export { ProcessActionTitle } from "./process-action-title";
 export { ToolLayout } from "./tool-layout";
-export { buildMatcherLine, formatPatternForDisplay } from "./watch";
+export {
+  buildMatcherLine,
+  formatPatternForDisplay,
+  quoteFilter,
+} from "./watch";

package/extensions/processes/tools/components/watch.ts

@@ -15,6 +15,8 @@ export function buildMatcherLine(
   const attentionTone =
     on === "turn" ? "warning" : on === "context" ? "success" : "muted";
 
+  const pattern = quoteFilter(formatPatternForDisplay(matcher.pattern), mode);
+
   return new Text(
     [
       prefix,
@@ -22,13 +24,22 @@ export function buildMatcherLine(
       "  ",
       theme.bold(theme.fg(attentionTone, `${on}${repeat}`)),
       "  ",
-      theme.fg("accent", formatPatternForDisplay(matcher.pattern)),
+      theme.fg("accent", pattern),
     ].join(""),
     0,
     0,
   );
 }
 
+export function quoteFilter(
+  pattern: string,
+  mode: "literal" | "regex",
+): string {
+  if (mode === "regex") return `/${pattern}/`;
+  if (pattern.includes('"')) return `'${pattern}'`;
+  return `"${pattern}"`;
+}
+
 export function formatPatternForDisplay(pattern: string): string {
   let formatted = "";
 

package/extensions/processes/tools/index.ts

@@ -3,7 +3,8 @@ import {
   defineTool,
   type ExtensionAPI,
   type ExtensionContext,
-  type Theme,
+  Theme,
+  type ToolDefinition,
 } from "@earendil-works/pi-coding-agent";
 import { type Component, Container, Text } from "@earendil-works/pi-tui";
 
@@ -105,11 +106,32 @@ async function execute(
   }
 }
 
+/** pi's declared renderCall signature, per its public ToolDefinition type. */
+type RenderCallFn = NonNullable<ToolDefinition["renderCall"]>;
+/** pi's third renderCall argument (ToolRenderContext — not root-exported). */
+type RenderCallFnContext = Parameters<RenderCallFn>[2];
+
+/**
+ * pi invokes renderCall as (args, theme, context) where theme is pi's Theme
+ * class instance. Detecting that exact class distinguishes pi's argument
+ * order from OMP's (args, options, theme), where the second argument is a
+ * plain options object.
+ */
+function isPiTheme(value: unknown): value is Theme {
+  return value instanceof Theme;
+}
+
 function renderProcessCall(
   args: ProcessesParamsType,
-  theme: Theme,
-  context?: { expanded?: boolean },
+  second: Theme | RenderCallFnContext,
+  third?: RenderCallFnContext | Theme,
 ): Component {
+  const usesPiOrder = isPiTheme(second);
+  const theme = usesPiOrder ? second : (third as Theme);
+  const context = (usesPiOrder ? third : second) as
+    | RenderCallFnContext
+    | undefined;
+
   switch (args.action) {
     case "start":
       return new ToolLayout().setHeader(

package/extensions/processes/tools/output/render.ts

@@ -2,7 +2,8 @@ import type { Theme } from "@earendil-works/pi-coding-agent";
 import { Container, Spacer, Text } from "@earendil-works/pi-tui";
 
 import { sanitizeForDisplay } from "../../../shared/display-text";
-import { ProcessActionHeader } from "../components";
+import { truncateToWidth } from "../../../shared/truncate";
+import { ProcessActionHeader, quoteFilter } from "../components";
 import type { ProcessesParamsType } from "../schema";
 import { buildField } from "../utils";
 import type { OutputDetails } from ".";
@@ -73,9 +74,23 @@ export function buildCollapsed(
     ),
   );
 
+  if (details.pattern) {
+    const quoted = quoteFilter(details.pattern, details.mode);
+    const value = truncateToWidth(sanitizeForDisplay(quoted), 80);
+    container.addChild(
+      new Text(
+        `${theme.fg("muted", "filter:")} ${theme.fg("accent", value)}`,
+        0,
+        0,
+      ),
+    );
+  }
+
   const bodyLines = extractOutputBody(contentText, details);
   const preview = bodyLines.slice(-2).map(sanitizeForDisplay).join("\n");
 
+  container.addChild(new Spacer(1));
+
   if (preview) {
     container.addChild(new Text(theme.fg("muted", preview), 0, 0));
   } else {
@@ -119,9 +134,8 @@ function buildOutputMeta(details: OutputDetails, theme: Theme): Container {
   container.addChild(buildField("stream", details.stream, theme));
 
   if (details.pattern) {
-    const modeTag = details.mode === "regex" ? " (regex)" : "";
     container.addChild(
-      buildField("filter", `${details.pattern}${modeTag}`, theme),
+      buildField("filter", quoteFilter(details.pattern, details.mode), theme),
     );
   }
 

package/extensions/processes-dock/components/log-dock-component.ts

@@ -3,9 +3,9 @@ import type { Theme } from "@earendil-works/pi-coding-agent";
 import { type Component, visibleWidth } from "@earendil-works/pi-tui";
 import type { ProcessInfo } from "../../../src/types";
 import { LIVE_STATUSES } from "../../../src/types";
-import { renderProcessTab } from "../../process-tabs";
 import { sanitizeForDisplay } from "../../shared/display-text";
 import { displayTextOf, renderLogLine } from "../../shared/log-line";
+import { renderProcessTab } from "../../shared/process-tabs";
 import { truncateToWidth } from "../../shared/truncate";
 import {
   clampNameColumn,

package/extensions/processes-logs/components/log-overlay-component.ts

@@ -17,8 +17,8 @@ import {
 import { LIVE_STATUSES, type ProcessInfo } from "../../../src/types";
 import { formatRuntime } from "../../../src/utils/format";
 import { isRecord } from "../../../src/utils/is-record";
-import { renderProcessTab } from "../../process-tabs";
 import { truncateForDisplay } from "../../shared/display-text";
+import { renderProcessTab } from "../../shared/process-tabs";
 import { truncateToWidth } from "../../shared/truncate";
 import { LineComponent, LinesComponent, RuleComponent } from "../../shared/ui";
 import { requestProcessList } from "../client";

package/extensions/{process-tabs.ts → shared/process-tabs.ts}

@@ -1,8 +1,8 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
 
-import type { ProcessInfo } from "../src/types";
-import { truncateForDisplay } from "./shared/display-text";
-import { MAX_TAB_NAME, statusDot } from "./shared/ui";
+import type { ProcessInfo } from "../../src/types";
+import { truncateForDisplay } from "./display-text";
+import { MAX_TAB_NAME, statusDot } from "./ui";
 
 export { MAX_TAB_NAME, statusDot as renderProcessTabDot };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-processes",
-  "version": "0.10.4",
+  "version": "0.10.6",
   "license": "MIT",
   "type": "module",
   "private": false,
@@ -23,7 +23,8 @@
     "skills": [
       "./skills/pi-processes"
     ],
-    "video": "https://assets.aliou.me/pi-extensions/demos/pi-processes.mp4"
+    "image": "https://assets.aliou.me/github/aliou/pi-processes/banner-v0.10.x.png",
+    "video": "https://assets.aliou.me/pi-extensions/demos/processes/v0.10.0/agent-starts-processes.mp4"
   },
   "publishConfig": {
     "access": "public"
@@ -42,7 +43,7 @@
     "CONTRIBUTING.md"
   ],
   "dependencies": {
-    "@aliou/pi-utils-settings": "^0.18.0",
+    "@aliou/pi-utils-settings": "^0.19.1",
     "@aliou/pi-utils-ui": "^0.5.0",
     "@aliou/sh": "^0.1.0"
   },
@@ -56,9 +57,9 @@
     "@aliou/biome-plugins": "^0.8.1",
     "@biomejs/biome": "^2.4.15",
     "@changesets/cli": "^2.27.11",
-    "@earendil-works/pi-ai": "0.80.3",
-    "@earendil-works/pi-coding-agent": "0.80.3",
-    "@earendil-works/pi-tui": "0.80.3",
+    "@earendil-works/pi-ai": "0.84.1",
+    "@earendil-works/pi-coding-agent": "0.84.1",
+    "@earendil-works/pi-tui": "0.84.1",
     "@golevelup/ts-vitest": "^4.0.0",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",
@@ -66,20 +67,24 @@
     "ts-json-schema-generator": "^2.9.0",
     "typebox": "1.1.38",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.5",
+    "vitest-evals": "0.15.0"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
+    "typecheck:evals": "tsc --noEmit -p tests/evals/tsconfig.json",
     "lint": "biome check",
     "format": "biome check --write",
-    "gen:schema": "ts-json-schema-generator --path extensions/processes/config/types.ts --type ProcessConfig --no-type-check -o schema.json",
-    "check:schema": "ts-json-schema-generator --path extensions/processes/config/types.ts --type ProcessConfig --no-type-check -o /tmp/pi-processes-schema-check.json && diff -q schema.json /tmp/pi-processes-schema-check.json",
+    "gen:schema": "pi-settings-schema -p extensions/processes/config/types.ts -t ProcessConfig -o schema.json --version 0.10.6",
+    "check:schema": "pi-settings-schema -p extensions/processes/config/types.ts -t ProcessConfig -o schema.json --version 0.10.6 --check",
+    "check:changesets": "node scripts/check-changesets.ts",
     "check:lockfile": "pnpm install --frozen-lockfile --ignore-scripts",
     "prepare": "[ -d .git ] && husky || true",
     "changeset": "changeset",
     "version": "changeset version",
     "test": "vitest run",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:evals": "vitest run --config tests/evals/vitest.config.ts",
     "release": "pnpm changeset publish"
   },
   "packageManager": "pnpm@11.5.1",

package/schema.json

@@ -1,134 +1,142 @@
 {
-  "$ref": "#/definitions/ProcessConfig",
   "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ProcessConfig",
   "definitions": {
-    "ExecutionConfig": {
-      "additionalProperties": false,
+    "ProcessConfig": {
+      "type": "object",
       "properties": {
-        "shellPath": {
-          "description": "Absolute shell executable used to run process commands.",
+        "execution": {
+          "$ref": "#/definitions/ExecutionConfig",
+          "description": "Process execution settings."
+        },
+        "interception": {
+          "$ref": "#/definitions/InterceptionConfig",
+          "description": "Shell-command interception settings."
+        },
+        "processList": {
+          "$ref": "#/definitions/ProcessListConfig",
+          "description": "Process overview and log viewport settings."
+        },
+        "output": {
+          "$ref": "#/definitions/OutputConfig",
+          "description": "Process output retention settings."
+        },
+        "follow": {
+          "$ref": "#/definitions/FollowConfig",
+          "description": "Live log follow behavior."
+        },
+        "widget": {
+          "$ref": "#/definitions/WidgetConfig",
+          "description": "Dock and status widget settings."
+        },
+        "$schema": {
           "type": "string"
+        },
+        "version": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0
+            },
+            {
+              "type": "string",
+              "pattern": "^\\d{1,15}(\\.\\d{1,15})?(\\.\\d{1,15})?$"
+            }
+          ],
+          "description": "Config schema version, stamped by migrations. Current version: 0.10.6."
         }
       },
-      "type": "object"
-    },
-    "FollowConfig": {
       "additionalProperties": false,
+      "description": "User-facing pi-processes settings stored on disk.\n\nThe reserved `$schema` and `version` keys are owned by the config loader and injected into schema.json by `pi-settings-schema`."
+    },
+    "ExecutionConfig": {
+      "type": "object",
       "properties": {
-        "autoHideOnFinish": {
-          "description": "Hide process log interfaces when all managed processes finish.",
-          "type": "boolean"
-        },
-        "enabledByDefault": {
-          "description": "Open process log interfaces in follow mode by default.",
-          "type": "boolean"
+        "shellPath": {
+          "type": "string",
+          "description": "Absolute shell executable used to run process commands."
         }
       },
-      "type": "object"
+      "additionalProperties": false
     },
     "InterceptionConfig": {
-      "additionalProperties": false,
+      "type": "object",
       "properties": {
         "blockBackgroundCommands": {
-          "description": "Block shell background patterns and redirect the agent to the process tool.",
-          "type": "boolean"
+          "type": "boolean",
+          "description": "Block shell background patterns and redirect the agent to the process tool."
         }
       },
-      "type": "object"
+      "additionalProperties": false
     },
-    "OutputConfig": {
-      "additionalProperties": false,
+    "ProcessListConfig": {
+      "type": "object",
       "properties": {
-        "defaultTailLines": {
-          "description": "Default number of recent lines returned by the process output action.",
-          "type": "number"
-        },
-        "maxOutputBytes": {
-          "description": "Maximum bytes retained by each process log interface.",
-          "type": "number"
+        "maxPreviewLines": {
+          "type": "number",
+          "description": "Maximum log rows displayed in the overview preview and logs overlay."
         },
-        "maxOutputLines": {
-          "description": "Maximum lines retained by process log interfaces.",
-          "type": "number"
+        "maxVisibleProcesses": {
+          "type": "number",
+          "description": "Maximum process rows displayed in the overview before scrolling."
         }
       },
-      "type": "object"
+      "additionalProperties": false
     },
-    "ProcessConfig": {
-      "additionalProperties": false,
-      "description": "User-facing pi-processes settings stored on disk.",
+    "OutputConfig": {
+      "type": "object",
       "properties": {
-        "$schema": {
-          "description": "JSON Schema URL used by editors for validation and autocomplete.",
-          "type": "string"
-        },
-        "execution": {
-          "$ref": "#/definitions/ExecutionConfig",
-          "description": "Process execution settings."
-        },
-        "follow": {
-          "$ref": "#/definitions/FollowConfig",
-          "description": "Live log follow behavior."
-        },
-        "interception": {
-          "$ref": "#/definitions/InterceptionConfig",
-          "description": "Shell-command interception settings."
-        },
-        "output": {
-          "$ref": "#/definitions/OutputConfig",
-          "description": "Process output retention settings."
-        },
-        "processList": {
-          "$ref": "#/definitions/ProcessListConfig",
-          "description": "Process overview and log viewport settings."
+        "defaultTailLines": {
+          "type": "number",
+          "description": "Default number of recent lines returned by the process output action."
         },
-        "version": {
-          "description": "Config migration marker written after v0.10.0 settings migration.",
-          "type": "string"
+        "maxOutputLines": {
+          "type": "number",
+          "description": "Maximum lines retained by process log interfaces."
         },
-        "widget": {
-          "$ref": "#/definitions/WidgetConfig",
-          "description": "Dock and status widget settings."
+        "maxOutputBytes": {
+          "type": "number",
+          "description": "Maximum bytes retained by each process log interface."
         }
       },
-      "type": "object"
+      "additionalProperties": false
     },
-    "ProcessListConfig": {
-      "additionalProperties": false,
+    "FollowConfig": {
+      "type": "object",
       "properties": {
-        "maxPreviewLines": {
-          "description": "Maximum log rows displayed in the overview preview and logs overlay.",
-          "type": "number"
+        "enabledByDefault": {
+          "type": "boolean",
+          "description": "Open process log interfaces in follow mode by default."
         },
-        "maxVisibleProcesses": {
-          "description": "Maximum process rows displayed in the overview before scrolling.",
-          "type": "number"
+        "autoHideOnFinish": {
+          "type": "boolean",
+          "description": "Hide process log interfaces when all managed processes finish."
         }
       },
-      "type": "object"
+      "additionalProperties": false
     },
     "WidgetConfig": {
-      "additionalProperties": false,
+      "type": "object",
       "properties": {
+        "showStatusWidget": {
+          "type": "boolean",
+          "description": "Show a one-line process summary below the editor."
+        },
         "dockDefaultState": {
-          "description": "Initial visibility of the process dock.",
+          "type": "string",
           "enum": [
             "closed",
             "collapsed",
             "expanded"
           ],
-          "type": "string"
+          "description": "Initial visibility of the process dock."
         },
         "dockHeight": {
-          "description": "Number of log rows displayed in the expanded process dock.",
-          "type": "number"
-        },
-        "showStatusWidget": {
-          "description": "Show a one-line process summary below the editor.",
-          "type": "boolean"
+          "type": "number",
+          "description": "Number of log rows displayed in the expanded process dock."
         }
       },
-      "type": "object"
+      "additionalProperties": false
     }
   }
-}
+}

package/extensions/processes/config/migrations/002-stamp-v0-10-0-config-version.ts

@@ -1,21 +0,0 @@
-import type { Migration } from "@aliou/pi-utils-settings";
-
-import type { ProcessConfig } from "../types";
-
-export const PROCESS_CONFIG_VERSION = "0.10.0";
-
-export function needsConfigVersionStamp(config: ProcessConfig): boolean {
-  return (config.version ?? "") < PROCESS_CONFIG_VERSION;
-}
-
-export function stampConfigVersion(config: ProcessConfig): ProcessConfig {
-  return { ...config, version: PROCESS_CONFIG_VERSION };
-}
-
-export const configVersionStampMigration: Migration<ProcessConfig> = {
-  name: "002-stamp-v0-10-0-config-version",
-  shouldRun: needsConfigVersionStamp,
-  run: (config) => stampConfigVersion(config),
-  message:
-    "Updated pi-processes settings for v0.10.0. This release rewrites the package into separate process, logs, and dock extensions while preserving your existing settings. Release notes are available at https://github.com/aliou/pi-processes/releases/tag/v0.10.0.",
-};