dev-cockpit 0.2.6 → 0.2.8

package/dist/ink.d.ts

@@ -1,3 +1,3 @@
-export { Box, Text, render, useApp, useInput, useFocus, useFocusManager, useStdout, useStderr, useStdin, Static, Newline, Spacer, Transform } from 'ink';
+export { Box, Text, render, useApp, useInput, useFocus, useFocusManager, useStdout, useStderr, useStdin, Static, Newline, Spacer, Transform, } from 'ink';
 export type { BoxProps, TextProps, RenderOptions, Instance, AppProps } from 'ink';
 //# sourceMappingURL=ink.d.ts.map

package/dist/ink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ink.d.ts","sourceRoot":"","sources":["../src/ink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACzJ,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC"}
+{"version":3,"file":"ink.d.ts","sourceRoot":"","sources":["../src/ink.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,MAAM,EACN,SAAS,GACV,MAAM,KAAK,CAAC;AACb,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC"}

package/dist/{link-VWT2VQH6.js → link-Y7OFHOUP.js}

@@ -7,7 +7,7 @@ import {
   manifestPath,
   removeMapping,
   setMapping
-} from "./chunk-A446TCT5.js";
+} from "./chunk-YTMK7EXK.js";
 import "./chunk-6XGHLLYT.js";
 
 // src/commands/link.ts
@@ -24,10 +24,8 @@ function linkAddCommand(opts) {
     process.exit(1);
   }
   setMapping(cwd, absConfig);
-  process.stdout.write(
-    `dev-cockpit link: ${canonical(cwd)} \u2192 ${canonical(absConfig)}
-`
-  );
+  process.stdout.write(`dev-cockpit link: ${canonical(cwd)} \u2192 ${canonical(absConfig)}
+`);
 }
 function linkListCommand() {
   const entries = listMappings();
@@ -62,4 +60,4 @@ export {
   linkListCommand,
   linkRemoveCommand
 };
-//# sourceMappingURL=link-VWT2VQH6.js.map
+//# sourceMappingURL=link-Y7OFHOUP.js.map

package/dist/link-Y7OFHOUP.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/commands/link.ts"],
+  "sourcesContent": ["/**\n * `dev-cockpit link` \u2014 manage the project\u2192config mapping in\n * $XDG_DATA_HOME/dev-cockpit/manifest.json.\n *\n * Sub-commands:\n *   link <config-path>     register a mapping for the current cwd\n *   link list              show all registered mappings\n *   link remove            unregister the current cwd\n *\n * Path canonicalisation (symlink-resolved) happens inside the manifest\n * module \u2014 the same cwd reached via a symlinked alias hashes to the\n * same key as its real path.\n */\n\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport {\n  canonical,\n  listMappings,\n  manifestPath,\n  removeMapping,\n  setMapping,\n} from '../core/manifest.js';\n\nexport interface LinkAddOptions {\n  configPath: string;\n}\n\nexport function linkAddCommand(opts: LinkAddOptions): void {\n  const cwd = process.cwd();\n  const absConfig = path.resolve(cwd, opts.configPath);\n  if (!fs.existsSync(absConfig)) {\n    process.stderr.write(\n      `dev-cockpit link: ${absConfig} doesn't exist. Create the config file first or pass a valid path.\\n`,\n    );\n    process.exit(1);\n  }\n  setMapping(cwd, absConfig);\n  process.stdout.write(`dev-cockpit link: ${canonical(cwd)} \u2192 ${canonical(absConfig)}\\n`);\n}\n\nexport function linkListCommand(): void {\n  const entries = listMappings();\n  if (entries.length === 0) {\n    process.stdout.write(\n      `dev-cockpit link: no mappings registered (manifest at ${manifestPath()}).\\n`,\n    );\n    return;\n  }\n  const longest = Math.max(...entries.map((e) => e.workspace.length));\n  for (const { workspace, config } of entries) {\n    process.stdout.write(`${workspace.padEnd(longest)}  \u2192  ${config}\\n`);\n  }\n}\n\nexport function linkRemoveCommand(): void {\n  const cwd = process.cwd();\n  const removed = removeMapping(cwd);\n  if (removed) {\n    process.stdout.write(`dev-cockpit link: removed mapping for ${canonical(cwd)}\\n`);\n  } else {\n    process.stdout.write(\n      `dev-cockpit link: no mapping for ${canonical(cwd)} (nothing to remove)\\n`,\n    );\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;AAcA,OAAO,QAAQ;AACf,OAAO,UAAU;AAaV,SAAS,eAAe,MAA4B;AACzD,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,YAAY,KAAK,QAAQ,KAAK,KAAK,UAAU;AACnD,MAAI,CAAC,GAAG,WAAW,SAAS,GAAG;AAC7B,YAAQ,OAAO;AAAA,MACb,qBAAqB,SAAS;AAAA;AAAA,IAChC;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,aAAW,KAAK,SAAS;AACzB,UAAQ,OAAO,MAAM,qBAAqB,UAAU,GAAG,CAAC,WAAM,UAAU,SAAS,CAAC;AAAA,CAAI;AACxF;AAEO,SAAS,kBAAwB;AACtC,QAAM,UAAU,aAAa;AAC7B,MAAI,QAAQ,WAAW,GAAG;AACxB,YAAQ,OAAO;AAAA,MACb,yDAAyD,aAAa,CAAC;AAAA;AAAA,IACzE;AACA;AAAA,EACF;AACA,QAAM,UAAU,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC,MAAM,EAAE,UAAU,MAAM,CAAC;AAClE,aAAW,EAAE,WAAW,OAAO,KAAK,SAAS;AAC3C,YAAQ,OAAO,MAAM,GAAG,UAAU,OAAO,OAAO,CAAC,aAAQ,MAAM;AAAA,CAAI;AAAA,EACrE;AACF;AAEO,SAAS,oBAA0B;AACxC,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,UAAU,cAAc,GAAG;AACjC,MAAI,SAAS;AACX,YAAQ,OAAO,MAAM,yCAAyC,UAAU,GAAG,CAAC;AAAA,CAAI;AAAA,EAClF,OAAO;AACL,YAAQ,OAAO;AAAA,MACb,oCAAoC,UAAU,GAAG,CAAC;AAAA;AAAA,IACpD;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/mount/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/mount/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,IAAI,EAAE,oBAAoB,GACzB,MAAM,CAoBR"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/mount/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,IAAI,EAAE,oBAAoB,GACzB,MAAM,CA6BR"}

package/dist/mount/symlinks.d.ts

@@ -20,10 +20,10 @@ export interface SymlinkReport {
      */
     replaced: string[];
     /**
-     * Reserved for cases that legitimately couldn't apply (e.g. linkPath is a
-     * regular file whose deletion failed). The "real directory" case used to
-     * land here as a safety guard; now those entries land in `replaced`
-     * because explicit-mount intent overrides the guard.
+     * Entries that couldn't be applied — e.g. a real directory at the link path
+     * that resisted deletion (macOS `deny delete` ACL that survived even an ACL
+     * strip + retry), or `symlinkSync` failing for any other reason. Callers
+     * surface these to the user so they can intervene manually.
      */
     skipped: string[];
 }

package/dist/mount/symlinks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symlinks.d.ts","sourceRoot":"","sources":["../../src/mount/symlinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,QAAQ,EAAE,oBAAoB,GAC7B,aAAa,CAkCf;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,QAAQ,EAAE,oBAAoB,GAC7B,IAAI,CAWN;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,QAAQ,EAAE,oBAAoB,GAC7B,UAAU,EAAE,CAuBd"}
+{"version":3,"file":"symlinks.d.ts","sourceRoot":"","sources":["../../src/mount/symlinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,QAAQ,EAAE,oBAAoB,GAC7B,aAAa,CAWf;AAmED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,QAAQ,EAAE,oBAAoB,GAC7B,IAAI,CAWN;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,QAAQ,EAAE,oBAAoB,GAC7B,UAAU,EAAE,CAuBd"}

package/dist/mount/types.d.ts

@@ -8,8 +8,21 @@
 export interface MountEntry {
     /** Absolute path on the host. */
     hostPath: string;
-    /** Absolute path inside the container. */
-    containerPath: string;
+    /**
+     * Absolute path inside the container. Required for `kind: 'bind'` (the
+     * default); omitted when `kind: 'symlink-only'`.
+     */
+    containerPath?: string;
+    /**
+     * Discriminator for how this mount is materialised.
+     *
+     *   - `'bind'` (default): emit a docker-compose bind AND optionally manage
+     *     an IDE-facing symlink via `MountSymlinkStrategy`.
+     *   - `'symlink-only'`: no docker bind. Exists purely so the symlink
+     *     strategy can place a host-side symlink (e.g. a wrapper-level
+     *     `./project` symlink that redirects a pre-existing compose bind).
+     */
+    kind?: 'bind' | 'symlink-only';
     /**
      * Optional metadata attached by profiles (e.g. logical name, category,
      * source provenance). dev-cockpit treats this as opaque; profile hooks

package/dist/mount/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mount/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,6EAA6E;IAC7E,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,KAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACvE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mount/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,6EAA6E;IAC7E,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,KAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACvE"}

package/docs/commands.md

@@ -2,13 +2,13 @@
 
 `dev-cockpit` ships five core commands. A profile contributes its own commands via `setupCli(program)` — these register **first**, so a profile can take over a core command name (the matching core command is then skipped).
 
-| Command           | What it does                                                                  |
-|-------------------|-------------------------------------------------------------------------------|
-| `dev`             | Boots the four-pane TUI (Targets / Output / Health / Help).                     |
-| `doctor`          | Runs every registered health check once and prints a status table.            |
-| `init-config`     | Writes a `cockpit.yaml` (static template or interactive wizard).              |
-| `mount`           | Manages a docker-compose bind-mount overlay (apply / status / clear).         |
-| `migrate-config`  | Rewrites `cockpit.yaml` at the current `CONFIG_VERSION`.                       |
+| Command          | What it does                                                          |
+| ---------------- | --------------------------------------------------------------------- |
+| `dev`            | Boots the four-pane TUI (Targets / Output / Health / Help).           |
+| `doctor`         | Runs every registered health check once and prints a status table.    |
+| `init-config`    | Writes a `cockpit.yaml` (static template or interactive wizard).      |
+| `mount`          | Manages a docker-compose bind-mount overlay (apply / status / clear). |
+| `migrate-config` | Rewrites `cockpit.yaml` at the current `CONFIG_VERSION`.              |
 
 ## `dev`
 
@@ -40,7 +40,7 @@ Writes a `cockpit.yaml` at the current directory.
 ## `mount`
 
 ```
-dev-cockpit mount [-c <path>] [-s|--service <name>] [-q|--quiet] [-e|--exclude <name>]
+dev-cockpit mount [-c <path>] [-s|--service <name>] [-q|--quiet]
 dev-cockpit mount status [-c <path>]
 dev-cockpit mount clear  [-c <path>]
 ```

package/docs/config-reference.md

@@ -4,36 +4,37 @@ A `cockpit.yaml` lives at the root of your project. The cockpit reads it on star
 
 ## Top-level keys
 
-| Key | Type | Required | Notes |
-|---|---|---|---|
-| `version` | number | yes | Current schema version is `2`. Older versions migrate in memory (with a stderr warning); run `dev-cockpit migrate-config` to persist. |
-| `appName` | string | yes | State-dir name (`$XDG_STATE_HOME/<appName>/<workspace-hash>/`) + OS-notification title prefix. |
-| `processes` | array | no | Long-running commands streamed into the Output pane. See `processes:` below. |
-| `repos` | array | no | Code-side rows in the Targets pane. |
-| `docker` | object | no | `composeFile` + `services[]`. Omit on plain-Node projects. |
-| `highlights` | array | no | Regex patterns applied to all output streams (process + docker). Each can carry an explicit `severity:` (else inferred). |
-| `health` | array | no | Health check declarations — see `health:` below. |
-| `actions` | array | no | Named, optionally key-bound shell commands surfaced via the `:` palette and the Targets pane. |
-| `mount` | object | no | `overlayPath`, `manifestFile` overrides. Defaults: `<stateDir>/dev-mount-overlay.yml` (sibling to the manifest, keeps the wrapper repo clean), `mount.manifest.json`. |
-| `mounts` | array | no | Explicit `{hostPath, containerPath, meta?}` entries for `dev-cockpit mount`. |
-| `help` | object | no | Extra `sources[]` + `defaultPage`. |
-| `notifications` | object | no | `enabled`, `onTransitionTo[]`, `exclude[]`. |
-| `defaultPane` | enum | no | `repos` (default) \| `output` \| `health` \| `help`. Falls back to Output when the requested tab is hidden. |
-| `profile` | object | no | Namespace for profile-specific extension keys (`profile.<appName>: { ... }`). Each profile validates its block via its `configSchemaExt` (see [ADR 0005](../adr/0005-strict-profile-namespace.md)). |
+| Key             | Type   | Required | Notes                                                                                                                                                                                               |
+| --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `version`       | number | yes      | Current schema version is `2`. Older versions migrate in memory (with a stderr warning); run `dev-cockpit migrate-config` to persist.                                                               |
+| `appName`       | string | yes      | State-dir name (`$XDG_STATE_HOME/<appName>/<workspace-hash>/`) + OS-notification title prefix.                                                                                                      |
+| `processes`     | array  | no       | Long-running commands streamed into the Output pane. See `processes:` below.                                                                                                                        |
+| `repos`         | array  | no       | Code-side rows in the Targets pane.                                                                                                                                                                 |
+| `docker`        | object | no       | `composeFile` + `services[]`. Omit on plain-Node projects.                                                                                                                                          |
+| `highlights`    | array  | no       | Regex patterns applied to all output streams (process + docker). Each can carry an explicit `severity:` (else inferred).                                                                            |
+| `health`        | array  | no       | Health check declarations — see `health:` below.                                                                                                                                                    |
+| `actions`       | array  | no       | Named, optionally key-bound shell commands surfaced via the `:` palette and the Targets pane.                                                                                                       |
+| `mount`         | object | no       | `overlayPath`, `manifestFile` and `service` overrides. Defaults: `<stateDir>/dev-mount-overlay.yml` (sibling to the manifest, keeps the wrapper repo clean), `mount.manifest.json`.                 |
+| `mounts`        | array  | no       | Explicit `{hostPath, containerPath, meta?}` entries for `dev-cockpit mount`.                                                                                                                        |
+| `help`          | object | no       | Extra `sources[]` + `defaultPage`.                                                                                                                                                                  |
+| `notifications` | object | no       | `enabled`, `onTransitionTo[]`, `exclude[]`.                                                                                                                                                         |
+| `defaultPane`   | enum   | no       | `repos` (default) \| `output` \| `health` \| `help`. Falls back to Output when the requested tab is hidden.                                                                                         |
+| `profile`       | object | no       | Namespace for profile-specific extension keys (`profile.<appName>: { ... }`). Each profile validates its block via its `configSchemaExt` (see [ADR 0005](../adr/0005-strict-profile-namespace.md)). |
 
 ## `processes:`
 
 ```yaml
 processes:
-  - id: vite               # required, stable identifier; used as Output source tag and Targets row id
-    label: Vite dev        # optional, displayed in Targets / Output
-    command: npm run dev   # shell command; runs via sh -c (cmd /c on Windows)
-    cwd: ./apps/web        # optional; relative to workspaceRoot
-    env:                   # optional; merged on top of process.env
+  - id: vite # required, stable identifier; used as Output source tag and Targets row id
+    label: Vite dev # optional, displayed in Targets / Output
+    command: npm run dev # shell command; runs via sh -c (cmd /c on Windows)
+    cwd: ./apps/web # optional; relative to workspaceRoot
+    env: # optional; merged on top of process.env
       DEBUG: '1'
 ```
 
 Each process gets:
+
 - A row in the Targets pane (kind: `process`) with a built-in `[r] Restart <id>` action (kill via SIGTERM, respawn) backed by the tagged-spawn lookup.
 - Output lines tagged by `label` or `id`.
 - Highlight matching against `config.highlights[]` — matched lines use the configured severity (overriding the default `info` for stdout / `warn` for stderr).
@@ -42,20 +43,22 @@ Each process gets:
 
 ```yaml
 actions:
-  - id: test                    # required, unique
-    label: Run tests            # required, shown in the `:` palette + Targets action panel
-    command: npm test           # required for YAML; profiles can supply `invoke:` instead (TS-only)
-    cwd: ./api                  # optional
-    scope: global               # 'global' | 'repos' | 'repos:<rowId>'  (default: 'global')
-    key: t                      # optional single keystroke; fires within scope (in addition to `:`)
+  - id: test # required, unique
+    label: Run tests # required, shown in the `:` palette + Targets action panel
+    command: npm test # required for YAML; profiles can supply `invoke:` instead (TS-only)
+    cwd: ./api # optional
+    scope: global # 'global' | 'repos' | 'repos:<rowId>'  (default: 'global')
+    key: t # optional single keystroke; fires within scope (in addition to `:`)
 ```
 
 Scope semantics:
+
 - `global` — `:` palette only.
 - `repos` — `:` palette AND fires on any selected Targets row when the keystroke matches.
 - `repos:<id>` — fires only when that specific row is selected.
 
 Built-in actions are synthesized automatically:
+
 - Each docker service: `__builtin:restart-docker:<svc>` with `scope: repos:<svc>`, `key: r`.
 - Each process: `__builtin:restart-process:<id>` with `scope: repos:<id>`, `key: r`.
 
@@ -69,30 +72,31 @@ See [health.md](./health.md). Brief shape:
 health:
   - id: app-up
     label: app responsive
-    type: http-ok            # container-running | port-open | http-ok | file-exists | exec-zero
-    url: http://localhost:3000/health   # type-specific args
-    severity: error                     # ok | warn | error
-    triggers: [startup, fsevent]        # optional; defaults to ['startup']
-    notify: { onTransitionTo: ['error'] }  # optional per-check override
+    type: http-ok # container-running | port-open | http-ok | file-exists | exec-zero
+    url: http://localhost:3000/health # type-specific args
+    severity: error # ok | warn | error
+    triggers: [startup, fsevent] # optional; defaults to ['startup']
+    notify: { onTransitionTo: ['error'] } # optional per-check override
     remediation:
       key: R
       label: restart app
       command: docker compose restart app
-      cwd: .                              # optional
+      cwd: . # optional
 ```
 
 ## `mount:` + `mounts:`
 
 ```yaml
-mount:                                                # path overrides — omit for defaults
+mount: # path overrides — omit for defaults
   # overlayPath: docker-compose.dev-cockpit.yml       # default: <stateDir>/dev-mount-overlay.yml
-                                                      #   set to keep the overlay in-repo (workspace-relative or absolute)
-  manifestFile: mount.manifest.json                   # basename within stateDir
+  #   set to keep the overlay in-repo (workspace-relative or absolute)
+  manifestFile: mount.manifest.json # basename within stateDir
+  # service: web                                      # target compose service (default: first in docker.services)
 
-mounts:                                               # explicit candidates
+mounts: # explicit candidates
   - hostPath: ./packages/api
     containerPath: /srv/api
-    meta:                                             # opaque to dev-cockpit; profile hooks read it
+    meta: # opaque to dev-cockpit; profile hooks read it
       name: api
 ```
 
@@ -103,8 +107,8 @@ Full mount story: [mount.md](./mount.md).
 ```yaml
 notifications:
   enabled: true
-  onTransitionTo: []   # restrict to specific destination states; empty = all transitions
-  exclude: []          # `NotifiableEvent` strings to suppress
+  onTransitionTo: [] # restrict to specific destination states; empty = all transitions
+  exclude: [] # `NotifiableEvent` strings to suppress
 ```
 
 See [notifications.md](./notifications.md).
@@ -114,7 +118,7 @@ See [notifications.md](./notifications.md).
 ```yaml
 help:
   sources:
-    - ./docs            # directory tree of markdown pages
+    - ./docs # directory tree of markdown pages
   defaultPage: getting-started
 ```
 

package/docs/health.md

@@ -4,24 +4,24 @@ A health check is a small predicate that decides whether something in your works
 
 The cockpit re-runs health checks on three triggers:
 
-| Trigger    | When                                                                  |
-|------------|-----------------------------------------------------------------------|
-| `startup`  | once, at boot                                                         |
-| `fsevent`  | when the watcher reports a file change (debounced ~500 ms)            |
-| `lockfile` | when `composer.lock`, `package-lock.json`, or `yarn.lock` changes     |
-| `docker`   | when a docker event is signalled (e.g. by the docker subsystem)       |
+| Trigger    | When                                                              |
+| ---------- | ----------------------------------------------------------------- |
+| `startup`  | once, at boot                                                     |
+| `fsevent`  | when the watcher reports a file change (debounced ~500 ms)        |
+| `lockfile` | when `composer.lock`, `package-lock.json`, or `yarn.lock` changes |
+| `docker`   | when a docker event is signalled (e.g. by the docker subsystem)   |
 
 Transitions (`ok → error`, `error → ok`) fire OS notifications according to the global `notifications:` block, optionally overridden per-check.
 
 ## Built-in check vocabulary
 
-| Type                | Required args        | Optional args                | Default triggers          |
-|---------------------|----------------------|------------------------------|---------------------------|
-| `container-running` | `container`          |                              | `startup`, `docker`       |
-| `port-open`         | `port` (number)      | `host` (default `127.0.0.1`) | `startup`                 |
-| `http-ok`           | `url`                | `expectStatus` (default 200) | `startup`                 |
-| `file-exists`       | `path`               |                              | `startup`, `fsevent`      |
-| `exec-zero`         | `command`            | `args[]`, `cwd`              | `startup`                 |
+| Type                | Required args   | Optional args                | Default triggers     |
+| ------------------- | --------------- | ---------------------------- | -------------------- |
+| `container-running` | `container`     |                              | `startup`, `docker`  |
+| `port-open`         | `port` (number) | `host` (default `127.0.0.1`) | `startup`            |
+| `http-ok`           | `url`           | `expectStatus` (default 200) | `startup`            |
+| `file-exists`       | `path`          |                              | `startup`, `fsevent` |
+| `exec-zero`         | `command`       | `args[]`, `cwd`              | `startup`            |
 
 Defaults can be overridden by setting `triggers:` and `severity:` on the entry.
 
@@ -49,7 +49,7 @@ health:
       label: start db
       command: docker compose up -d db
     notify:
-      onTransitionTo: [health-failed]   # only notify on going-down
+      onTransitionTo: [health-failed] # only notify on going-down
 ```
 
 ## Remediations
@@ -65,11 +65,11 @@ The remediation `key` is a single uppercase letter. Pressing the key (lowercase
 
 Per-check `notify:` overrides:
 
-| Setting                                       | Effect                                                |
-|-----------------------------------------------|-------------------------------------------------------|
-| omitted                                       | inherit global `notifications:` policy                |
-| `notify: false`                               | always silent for this check                          |
-| `notify: { onTransitionTo: [health-failed] }` | only notify on the listed transition events           |
+| Setting                                       | Effect                                      |
+| --------------------------------------------- | ------------------------------------------- |
+| omitted                                       | inherit global `notifications:` policy      |
+| `notify: false`                               | always silent for this check                |
+| `notify: { onTransitionTo: [health-failed] }` | only notify on the listed transition events |
 
 The session toggle (`n` keystroke) and global `notifications.enabled: false` always silence everything — per-check overrides cannot opt back in.
 
@@ -88,8 +88,16 @@ export const myProfile: Profile = {
       label: 'Composer',
       severity: 'error',
       triggers: ['startup', 'lockfile'],
-      predicate: async (ctx) => { /* … */ },
-      remediation: { key: 'R', label: 'composer install', run: async (ctx, root) => { /* … */ } },
+      predicate: async (ctx) => {
+        /* … */
+      },
+      remediation: {
+        key: 'R',
+        label: 'composer install',
+        run: async (ctx, root) => {
+          /* … */
+        },
+      },
     },
   ],
 };
@@ -104,7 +112,9 @@ import { runCockpit, buildHealthContext } from 'dev-cockpit';
 
 await runCockpit({
   profile: myProfile,
-  footerLegends: { /* … */ },
+  footerLegends: {
+    /* … */
+  },
   health: {
     workspaceRoot,
     profileChecks: myProfile.healthChecks,

package/docs/init-config.md

@@ -9,11 +9,11 @@ dev-cockpit init-config -i [-f|--force]                    # interactive wizard
 
 ## Flags
 
-| Flag                 | Default | Effect                                                                                        |
-|----------------------|---------|-----------------------------------------------------------------------------------------------|
-| `-i, --interactive`  | off     | Walk through prompts to populate the file. Skips the static template.                         |
-| `--with-docker`      | off     | Uncomments the `docker:` block in the static template (ignored in `--interactive` mode).      |
-| `-f, --force`        | off     | Overwrites an existing `cockpit.yaml` instead of refusing.                                    |
+| Flag                | Default | Effect                                                                                   |
+| ------------------- | ------- | ---------------------------------------------------------------------------------------- |
+| `-i, --interactive` | off     | Walk through prompts to populate the file. Skips the static template.                    |
+| `--with-docker`     | off     | Uncomments the `docker:` block in the static template (ignored in `--interactive` mode). |
+| `-f, --force`       | off     | Overwrites an existing `cockpit.yaml` instead of refusing.                               |
 
 ## Static template
 
@@ -23,20 +23,20 @@ dev-cockpit init-config -i [-f|--force]                    # interactive wizard
 
 The recommended path the first time you set the cockpit up on a project. Eight steps, with project sniffing pre-populating sensible defaults so you usually just press enter:
 
-| Step | Section | What it asks + auto-detects |
-|------|---------|------------------------------|
-| 1 | **App name** | Defaults to `package.json` `name`, then the cwd basename. |
-| 2 | **Docker** | Detects `compose.yaml` / `docker-compose.yml` and parses its services. Offers them as a multi-select. Skip entirely for non-compose projects. |
-| 3 | **Processes** | Surfaces `package.json` scripts (`dev`, `watch`, `start`, `serve`) as pre-checked candidates. Anything that runs forever and writes to stdout — `vite`, `tsc --watch`, `php artisan serve`, `tail -f storage/logs/laravel.log` — fits here. |
-| 4 | **Targets** | Detects npm/yarn/pnpm workspaces; falls back to a single `.` entry. Each becomes a row in the Targets pane. The way to attach keystrokes to a repo is the Actions step (step 7), with `scope: repos:<id>` + `key:`. |
-| 5 | **Highlights** | Regex patterns that re-colour matching Output lines. `error`-severity matches additionally feed the Recent Errors strip + OS notifications. Patterns now apply to process stdout/stderr too — not just docker logs. |
-| 6 | **Health** | Test-and-fix pairs. Pick one of the five built-in types (`container-running`, `port-open`, `http-ok`, `file-exists`, `exec-zero`), supply the type-specific arg(s), then bind a single-keystroke remediation. Add as many checks as you like — same type repeats freely. `container-running` is hidden when no docker block was declared. |
-| 7 | **Actions** | One-shot shell commands surfaced through the `:` palette and/or bound to a single keypress. Auto-seeds from `package.json` scripts (`test`, `build`, `lint`, `format`, `typecheck`) with sensible default keys (`t`, `b`, `l`, `f`). Custom actions can be added inline. Distinct from processes (long-running) and health (state-checked). |
-| 8 | **Notifications** | Toggle native OS notifications on state transitions. |
+| Step | Section           | What it asks + auto-detects                                                                                                                                                                                                                                                                                                                 |
+| ---- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1    | **App name**      | Defaults to `package.json` `name`, then the cwd basename.                                                                                                                                                                                                                                                                                   |
+| 2    | **Docker**        | Detects `compose.yaml` / `docker-compose.yml` and parses its services. Offers them as a multi-select. Skip entirely for non-compose projects.                                                                                                                                                                                               |
+| 3    | **Processes**     | Surfaces `package.json` scripts (`dev`, `watch`, `start`, `serve`) as pre-checked candidates. Anything that runs forever and writes to stdout — `vite`, `tsc --watch`, `php artisan serve`, `tail -f storage/logs/laravel.log` — fits here.                                                                                                 |
+| 4    | **Targets**       | Detects npm/yarn/pnpm workspaces; falls back to a single `.` entry. Each becomes a row in the Targets pane. The way to attach keystrokes to a repo is the Actions step (step 7), with `scope: repos:<id>` + `key:`.                                                                                                                         |
+| 5    | **Highlights**    | Regex patterns that re-colour matching Output lines. `error`-severity matches additionally feed the Recent Errors strip + OS notifications. Patterns now apply to process stdout/stderr too — not just docker logs.                                                                                                                         |
+| 6    | **Health**        | Test-and-fix pairs. Pick one of the five built-in types (`container-running`, `port-open`, `http-ok`, `file-exists`, `exec-zero`), supply the type-specific arg(s), then bind a single-keystroke remediation. Add as many checks as you like — same type repeats freely. `container-running` is hidden when no docker block was declared.   |
+| 7    | **Actions**       | One-shot shell commands surfaced through the `:` palette and/or bound to a single keypress. Auto-seeds from `package.json` scripts (`test`, `build`, `lint`, `format`, `typecheck`) with sensible default keys (`t`, `b`, `l`, `f`). Custom actions can be added inline. Distinct from processes (long-running) and health (state-checked). |
+| 8    | **Notifications** | Toggle native OS notifications on state transitions.                                                                                                                                                                                                                                                                                        |
 
 After writing the file, the wizard offers to run `dev-cockpit doctor` immediately so you get instant feedback that the config parses + each declared health check has a baseline state.
 
-The wizard scaffolds a *working* config. Anything more advanced (custom triggers, `expectStatus`, exec args, mounts, profile namespaces) is a hand-edit on the generated file.
+The wizard scaffolds a _working_ config. Anything more advanced (custom triggers, `expectStatus`, exec args, mounts, profile namespaces) is a hand-edit on the generated file.
 
 ## Profile-contributed steps
 

package/docs/mount.md

@@ -34,21 +34,27 @@ docker compose -f docker-compose.yml -f <stateDir>/dev-mount-overlay.yml up -d
 
 ## What gets written
 
-| File | Default path | Configurable via |
-|---|---|---|
-| Compose overlay | `<stateDir>/dev-mount-overlay.yml` | `config.mount.overlayPath` |
-| Manifest | `<stateDir>/mount.manifest.json` | `config.mount.manifestFile` |
+| File            | Default path                       | Configurable via            |
+| --------------- | ---------------------------------- | --------------------------- |
+| Compose overlay | `<stateDir>/dev-mount-overlay.yml` | `config.mount.overlayPath`  |
+| Manifest        | `<stateDir>/mount.manifest.json`   | `config.mount.manifestFile` |
+| Service         | first in `docker.services`         | `config.mount.service`      |
 
-`<stateDir>` lives under `$XDG_STATE_HOME/<appName>/<workspace-hash>/`. Both files share that location, so anything cockpit knows about *this workspace's mounts* sits in one dir — clean wrapper repo, no per-developer artefacts to gitignore.
+`<stateDir>` lives under `$XDG_STATE_HOME/<appName>/<workspace-hash>/`. Both files share that location, so anything cockpit knows about _this workspace's mounts_ sits in one dir — clean wrapper repo, no per-developer artefacts to gitignore.
 
-Override the overlay path when the wrapper has its own conventions (workspace-relative or absolute):
+### Pointing the overlay at a path your compose chain already expects
+
+If the project's compose chain auto-discovers overrides at a fixed path — e.g. a Makefile wildcard like `$(wildcard $(COMPOSE_DIR)/web/docker-compose.dev-link.yml)`, or a `docker compose -f` include — the stateDir default won't be found by that glob (it's outside the repo). Tell `mount` to write the overlay where the chain looks for it:
 
 ```yaml
 mount:
   overlayPath: docker/compose/web/docker-compose.dev-link.yml
   manifestFile: dev-link.manifest.json
+  service: web
 ```
 
+Relative paths resolve against the workspace root; absolute paths are honoured verbatim. The Makefile include path and `mount.overlayPath` are two ends of the same contract — keep them next to each other (both committed in the wrapper repo, or both in the per-user cockpit.yaml) so they move together.
+
 ## Mount sources
 
 Mounts come from two places, merged on `containerPath` (config wins on collision):
@@ -58,7 +64,7 @@ Mounts come from two places, merged on `containerPath` (config wins on collision
    mounts:
      - hostPath: ./packages/api
        containerPath: /srv/api
-       meta:                  # optional opaque metadata (read by profile hooks + status)
+       meta: # optional opaque metadata (read by profile hooks + status)
          name: api
          type: package
    ```
@@ -73,7 +79,6 @@ dev-cockpit mount [options]            # write overlay + manifest
   -c, --config <path>                  # default: ./cockpit.yaml
   -s, --service <name>                 # default: first in docker.services
   -q, --quiet                          # skip interactive picker; apply all candidates
-  -e, --exclude <name>                 # exclude a candidate by meta.name (repeatable)
 
 dev-cockpit mount status [options]     # branch + dirty + broken-symlink table
 dev-cockpit mount clear  [options]     # remove overlay + manifest + managed symlinks
@@ -225,4 +230,4 @@ If your wrapper previously used a different manifest filename (e.g. a profile th
 1. **Adopt the new default**: run `mount` once. The new file replaces the legacy one (which is left orphaned in the state dir — safe to delete).
 2. **Keep the legacy filename**: set `config.mount.manifestFile: dev-link.manifest.json` in cockpit.yaml.
 
-Same applies to the overlay path — set `config.mount.overlayPath` if your wrapper expects a specific location for its compose stack.
+Same applies to the overlay path — set `config.mount.overlayPath` if your wrapper expects a specific location for its compose stack. See "Pointing the overlay at a path your compose chain already expects" above.

package/docs/notifications.md

@@ -20,17 +20,17 @@ OS notifications fire on **state transitions only** — never on every check, ne
    processes:
      - id: lint
        command: npx eslint . --watch
-       notify: false                     # mute this item
+       notify: false # mute this item
 
    health:
      - id: api-up
        type: http-ok
        url: http://localhost:3000/health
        notify:
-         onTransitionTo: [error]         # only on going-down, not on recovery
+         onTransitionTo: [error] # only on going-down, not on recovery
    ```
 
-3. **Session toggle** — press `n` in the cockpit to mute *all* notifications for the current session (overrides config). The Health pane shows the current session state at the bottom.
+3. **Session toggle** — press `n` in the cockpit to mute _all_ notifications for the current session (overrides config). The Health pane shows the current session state at the bottom.
 
 ## Events
 

package/docs/panes.md

@@ -17,11 +17,11 @@ Two-column layout when the terminal is at least 200 cols wide: row list on the l
 
 ### Row kinds
 
-| Kind | Source | Built-in `r` |
-|---|---|---|
-| `repo`     | `config.repos[]` or `profile.reposProvider()` | none — declare an action |
-| `docker`   | `config.docker.services[]` | `docker compose restart <service>` |
-| `process`  | `config.processes[]` | kill + respawn (tagged spawn lookup) |
+| Kind      | Source                                        | Built-in `r`                         |
+| --------- | --------------------------------------------- | ------------------------------------ |
+| `repo`    | `config.repos[]` or `profile.reposProvider()` | none — declare an action             |
+| `docker`  | `config.docker.services[]`                    | `docker compose restart <service>`   |
+| `process` | `config.processes[]`                          | kill + respawn (tagged spawn lookup) |
 
 ### Status glyphs
 

package/docs/processes.md

@@ -3,6 +3,7 @@
 A process is a long-running command — `tsc --watch`, `vitest --watch`, `npm run dev`, `php artisan serve`, `tail -f some.log` — declared in `cockpit.yaml` under `processes:`. The cockpit spawns each process once at boot and streams its stdout / stderr into the Output pane, tagged by source.
 
 Distinct from:
+
 - **Actions** (one-shot shell commands surfaced via the `:` palette and per-row keys)
 - **Health checks** (state predicates with one-keystroke remediation)
 - **Docker tailing** (`config.docker` — already managed by docker compose)
@@ -11,11 +12,11 @@ Distinct from:
 
 ```yaml
 processes:
-  - id: typecheck                       # required, unique; used as the Output source tag and Targets row id
-    label: tsc --watch                  # optional; shown in Repos + Output
-    command: npx tsc --watch --noEmit   # shell command; runs via sh -c (cmd /c on Windows)
-    cwd: ./apps/web                     # optional; relative to workspaceRoot
-    env:                                # optional; merged on top of process.env
+  - id: typecheck # required, unique; used as the Output source tag and Targets row id
+    label: tsc --watch # optional; shown in Repos + Output
+    command: npx tsc --watch --noEmit # shell command; runs via sh -c (cmd /c on Windows)
+    cwd: ./apps/web # optional; relative to workspaceRoot
+    env: # optional; merged on top of process.env
       DEBUG: '1'
 ```
 
@@ -30,6 +31,7 @@ You can shadow `r` with a custom action of the same scope + key — declared act
 ## Output + highlights
 
 Each line from a process's stdout / stderr gets:
+
 - The source label (or `id`) as a tag.
 - Default severity: `info` for stdout, `warn` for stderr.
 - Highlight matching against `config.highlights[]`. A matched pattern's `severity:` wins over the default — so a `pattern: 'boom', severity: error` highlight upgrades any line containing "boom" to `error`, which shows as `✗`-prefixed in Output and feeds the Recent Errors strip.