dev-cockpit 0.1.0 → 0.2.1

package/dist/ink.js

@@ -1 +1,38 @@
-export { Box, Text, render, useApp, useInput, useFocus, useFocusManager, useStdout, useStderr, useStdin, Static, Newline, Spacer, Transform } from 'ink';
+import { createRequire as __createRequireDC } from 'node:module';
+const require = __createRequireDC(import.meta.url);
+
+import {
+  Box_default,
+  Newline,
+  Spacer,
+  Static,
+  Text,
+  Transform,
+  render_default,
+  use_app_default,
+  use_focus_default,
+  use_focus_manager_default,
+  use_input_default,
+  use_stderr_default,
+  use_stdin_default,
+  use_stdout_default
+} from "./chunk-Q6677JQF.js";
+import "./chunk-VN6UILQW.js";
+import "./chunk-6XGHLLYT.js";
+export {
+  Box_default as Box,
+  Newline,
+  Spacer,
+  Static,
+  Text,
+  Transform,
+  render_default as render,
+  use_app_default as useApp,
+  use_focus_default as useFocus,
+  use_focus_manager_default as useFocusManager,
+  use_input_default as useInput,
+  use_stderr_default as useStderr,
+  use_stdin_default as useStdin,
+  use_stdout_default as useStdout
+};
+//# sourceMappingURL=ink.js.map

package/dist/ink.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/mount/compose.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Docker Compose overlay renderer.
+ *
+ * Generates a valid docker-compose.yml override that bind-mounts each entry's
+ * hostPath onto containerPath inside the named service. Hand-rolled (no YAML
+ * dependency) so output stays stable + diff-friendly.
+ *
+ * Uses the explicit `type: bind` long-form with `create_host_path: false` so
+ * docker refuses to start if the host directory disappears (early signal vs.
+ * silent empty mount — the short-form `host:container` syntax auto-creates).
+ */
+import type { MountEntry } from './types.js';
+export interface RenderOverlayOptions {
+    service: string;
+    /** Optional banner comment at top of the file. */
+    banner?: string;
+    /** Whether docker may auto-create the host path if missing (default: false). */
+    createHostPath?: boolean;
+}
+export declare function renderDockerOverlay(mounts: readonly MountEntry[], opts: RenderOverlayOptions): string;
+//# sourceMappingURL=compose.d.ts.map

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

@@ -0,0 +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"}

package/dist/mount/discovery.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Generic host-clone discovery.
+ *
+ * A profile typically has a list of "packages" (composer packages, npm
+ * workspaces, python wheels, …) and wants to know which ones have a
+ * developer clone sitting somewhere under a parent directory. This helper
+ * takes the package list + parentDir + a per-package path resolver and
+ * returns the subset that exist on disk as directories.
+ *
+ * The path resolver lets each package land at an arbitrary subpath
+ * convention (e.g. `<parent>/plugins/<name>` vs `<parent>/<name>` vs
+ * `<parent>/packages/<name>`).
+ */
+export interface FsLike {
+    existsSync: (p: string) => boolean;
+    statSync: (p: string) => {
+        isDirectory(): boolean;
+    };
+}
+export interface FindHostClonesOptions<P> {
+    /** Packages to check. */
+    packages: readonly P[];
+    /** Parent directory under which clones might exist. */
+    parentDir: string;
+    /** Per-package: where the host clone would live. */
+    resolveHostPath: (pkg: P, parentDir: string) => string;
+    /** Optional fs implementation for tests. */
+    fsImpl?: FsLike;
+}
+export interface DiscoveredClone<P> {
+    package: P;
+    hostPath: string;
+}
+export declare function findHostClones<P>(opts: FindHostClonesOptions<P>): DiscoveredClone<P>[];
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/mount/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;QAAE,WAAW,IAAI,OAAO,CAAA;KAAE,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,yBAAyB;IACzB,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;IACvB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,eAAe,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CActF"}

package/dist/mount/git-status.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Git branch + dirty detection for a single host path.
+ *
+ * Used by `mount status` to enrich each row when the host path is a git
+ * checkout. Failures are silent — non-git paths simply yield `null`.
+ */
+export interface GitInfo {
+    branch: string;
+    dirty: boolean;
+}
+export declare function readGitInfo(hostPath: string): Promise<GitInfo | null>;
+//# sourceMappingURL=git-status.d.ts.map

package/dist/mount/git-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-status.d.ts","sourceRoot":"","sources":["../../src/mount/git-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA0B3E"}

package/dist/mount/manifest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Mount manifest read/write.
+ *
+ * The manifest records the currently-applied mount set so subsequent commands
+ * (status, clear) and lifecycle hooks (onMountClear) can see what changed.
+ */
+import type { MountManifest } from './types.js';
+export declare const CURRENT_MANIFEST_VERSION = 1;
+export declare class MountManifestError extends Error {
+    constructor(filePath: string, reason: string);
+}
+export declare function readMountManifest(manifestPath: string): MountManifest | null;
+export declare function writeMountManifest(manifestPath: string, manifest: MountManifest): void;
+export declare function deleteMountManifest(manifestPath: string): boolean;
+export declare function validateMountManifest(filePath: string, raw: unknown): asserts raw is MountManifest;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/mount/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI7C;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAU5E;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGtF;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,GAAG,IAAI,aAAa,CA4B9B"}

package/dist/mount/symlinks.d.ts

@@ -0,0 +1,30 @@
+/**
+ * IDE-facing symlink management.
+ *
+ * Some mount strategies need a host-side symlink so editor tooling (LSPs,
+ * file watchers, debuggers) can follow into the live clone even when the
+ * container's bind-mount shadows whatever the package manager originally
+ * installed. The strategy is profile-supplied — `MountSymlinkStrategy.linkPath`
+ * resolves where the link should live for each entry; null means skip.
+ */
+import type { MountEntry, MountSymlinkStrategy } from './types.js';
+export interface SymlinkReport {
+    /** Symlinks created or already pointing at the right target (idempotent). */
+    created: string[];
+    /** A real (non-symlink) directory exists at the link path; left untouched. */
+    skipped: string[];
+}
+export declare function applyManagedSymlinks(workspaceRoot: string, mounts: readonly MountEntry[], strategy: MountSymlinkStrategy): SymlinkReport;
+export declare function removeManagedSymlinks(workspaceRoot: string, mounts: readonly MountEntry[], strategy: MountSymlinkStrategy): void;
+export interface BrokenLink {
+    linkPath: string;
+    intendedTarget: string;
+    /**
+     * 'broken'  — symlink exists but its target does not
+     * 'missing' — no symlink (or other entry) at the link path
+     */
+    reason: 'broken' | 'missing';
+    mount: MountEntry;
+}
+export declare function detectBrokenSymlinks(workspaceRoot: string, mounts: readonly MountEntry[], strategy: MountSymlinkStrategy): BrokenLink[];
+//# sourceMappingURL=symlinks.d.ts.map

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

@@ -0,0 +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,8EAA8E;IAC9E,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,CA4Bf;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"}

package/dist/mount/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Mount subsystem types.
+ *
+ * A "mount" describes a host directory bind-mounted into a docker container.
+ * Profiles can extend each entry with `meta` for richer status output and
+ * lifecycle decisions.
+ */
+export interface MountEntry {
+    /** Absolute path on the host. */
+    hostPath: string;
+    /** Absolute path inside the container. */
+    containerPath: string;
+    /**
+     * Optional metadata attached by profiles (e.g. logical name, category,
+     * source provenance). dev-cockpit treats this as opaque; profile hooks
+     * read it.
+     */
+    meta?: Record<string, unknown>;
+}
+export interface MountManifest {
+    version: 1;
+    appName: string;
+    workspaceRoot: string;
+    service: string;
+    overlayPath: string;
+    mounts: MountEntry[];
+    /** ISO 8601 timestamp of last apply. */
+    appliedAt: string;
+}
+export interface MountHookCtx {
+    workspaceRoot: string;
+    mounts: MountEntry[];
+    log: (line: string) => void;
+    errLog: (line: string) => void;
+}
+export interface MountClearHookCtx extends MountHookCtx {
+    /** The mounts that were active before clear. `mounts` is the empty array. */
+    previous: MountEntry[];
+}
+export interface MountStatusInfo {
+    /** Git branch of the host clone, if it's a git repo. */
+    branch?: string;
+    /** Whether the host clone has uncommitted changes. */
+    dirty?: boolean;
+    /** True if the IDE-facing symlink (if any) is broken/missing. */
+    brokenSymlink?: boolean;
+    /** Extra columns to render in `mount status` (column header → value). */
+    extra?: Record<string, string>;
+}
+export type MountStatusEnricher = (mount: MountEntry, ctx: {
+    workspaceRoot: string;
+}) => Promise<MountStatusInfo | null> | MountStatusInfo | null;
+export interface MountSymlinkStrategy {
+    /**
+     * Resolve where the IDE-facing symlink should live for the given mount.
+     * Return null to skip symlink management for this entry.
+     */
+    linkPath: (mount: MountEntry, workspaceRoot: string) => string | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/react.js

@@ -1 +1,35 @@
-export { useState, useEffect, useMemo, useCallback, useRef, useReducer, useContext, useLayoutEffect, createContext, Fragment, } from 'react';
+import { createRequire as __createRequireDC } from 'node:module';
+const require = __createRequireDC(import.meta.url);
+
+import {
+  require_react
+} from "./chunk-VN6UILQW.js";
+import {
+  __toESM
+} from "./chunk-6XGHLLYT.js";
+
+// src/react.ts
+var import_react = __toESM(require_react(), 1);
+var export_Fragment = import_react.Fragment;
+var export_createContext = import_react.createContext;
+var export_useCallback = import_react.useCallback;
+var export_useContext = import_react.useContext;
+var export_useEffect = import_react.useEffect;
+var export_useLayoutEffect = import_react.useLayoutEffect;
+var export_useMemo = import_react.useMemo;
+var export_useReducer = import_react.useReducer;
+var export_useRef = import_react.useRef;
+var export_useState = import_react.useState;
+export {
+  export_Fragment as Fragment,
+  export_createContext as createContext,
+  export_useCallback as useCallback,
+  export_useContext as useContext,
+  export_useEffect as useEffect,
+  export_useLayoutEffect as useLayoutEffect,
+  export_useMemo as useMemo,
+  export_useReducer as useReducer,
+  export_useRef as useRef,
+  export_useState as useState
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/react.ts"],
+  "sourcesContent": ["export {\n  useState,\n  useEffect,\n  useMemo,\n  useCallback,\n  useRef,\n  useReducer,\n  useContext,\n  useLayoutEffect,\n  createContext,\n  Fragment,\n} from 'react';\nexport type {\n  ReactNode,\n  ReactElement,\n  FC,\n  PropsWithChildren,\n  Dispatch,\n  SetStateAction,\n  MutableRefObject,\n  RefObject,\n} from 'react';\n"],
+  "mappings": ";;;;;;;;;;;AAAA,mBAWO;",
+  "names": []
+}

package/dist/runCockpit.d.ts

@@ -16,9 +16,12 @@
 import { type Instance } from 'ink';
 import { type CockpitProps } from './cockpit/Cockpit.js';
 import type { Profile } from './core/types.js';
+import type { ActionConfig } from './actions/types.js';
 export interface RunCockpitOptions extends CockpitProps {
     /** Optional profile — used to seed helpConfig (sources + defaultPage). */
     profile?: Profile;
+    /** Action registry surfaced through the `:` palette. Seeded into the store. */
+    actions?: ActionConfig[];
     /** Skip the alternate-screen-buffer dance (e.g. for tests). Default: false. */
     noAltScreen?: boolean;
 }

package/dist/runCockpit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runCockpit.d.ts","sourceRoot":"","sources":["../src/runCockpit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,wEAAwE;IACxE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,sCAAsC;IACtC,GAAG,EAAE,QAAQ,CAAC;CACf;AAKD,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CAyDzE"}
+{"version":3,"file":"runCockpit.d.ts","sourceRoot":"","sources":["../src/runCockpit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,wEAAwE;IACxE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,sCAAsC;IACtC,GAAG,EAAE,QAAQ,CAAC;CACf;AAKD,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CA4DzE"}

package/docs/commands.md

@@ -1,13 +1,14 @@
 # Commands
 
-`dev-cockpit` ships four 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).
+`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 three-pane TUI (Repos / Output / Health / Help).                    |
-| `doctor`      | Runs every registered health check once and prints a status table.            |
-| `init-config` | Writes a starter `cockpit.yaml` in the current directory.                     |
-| `mount`       | Generates a Docker compose overlay for declared bind mounts.                  |
+| 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`
 
@@ -15,7 +16,7 @@
 dev-cockpit dev [-c <path>]
 ```
 
-Loads `cockpit.yaml`, wires the active profile + config-declared health checks into the cockpit shell, and starts an optional Docker log tailer if the config declares services to tail.
+Loads `cockpit.yaml` (auto-migrating older versions in memory), runs the active profile's `boot` lifecycle hook, wires the action registry (built-ins + profile defaults + dynamic boot-result actions + user config), starts an optional Docker log tailer if `config.docker.services[]` is declared, then renders the cockpit shell.
 
 ## `doctor`
 
@@ -28,25 +29,33 @@ Builds the health registry from `config.health[]` plus `profile.healthChecks`, r
 ## `init-config`
 
 ```
-dev-cockpit init-config [--with-docker] [-f|--force]
+dev-cockpit init-config [--with-docker] [-i|--interactive] [-f|--force]
 ```
 
-Writes a `cockpit.yaml` template at the current directory. `--with-docker` uncomments the docker block. The template is otherwise heavily commented — uncomment the sections you need.
+Writes a `cockpit.yaml` at the current directory.
+
+- **Static template** (default): heavily commented; uncomment what you need. `--with-docker` uncomments the docker block.
+- **Interactive wizard** (`-i`): 8 steps with auto-detection from `package.json` / `compose.yaml`. Picks up scripts as actions (test/build/lint/format) or processes (dev/watch). Profile-contributed steps via `Profile.wizardSteps` run between Notifications and the summary; their output lands under `profile.<appName>:`. See [init-config.md](./init-config.md).
 
 ## `mount`
 
 ```
-dev-cockpit mount [-c <path>] [-s|--service <name>]
+dev-cockpit mount [-c <path>] [-s|--service <name>] [-q|--quiet] [-e|--exclude <name>]
 dev-cockpit mount status [-c <path>]
-dev-cockpit mount clear [-c <path>]
+dev-cockpit mount clear  [-c <path>]
 ```
 
-Merges `config.mounts[]` with `profile.mountCandidatesProvider?.()`, then writes:
+Merges `config.mounts[]` with `profile.mountCandidatesProvider?.()` and writes a docker-compose overlay + manifest. Interactive picker by default (when candidates exist); `--quiet` skips the prompt. Full reference: [mount.md](./mount.md).
+
+## `migrate-config`
 
-- `<workspace>/docker-compose.dev-cockpit.yml` — the overlay
-- `<state-dir>/mount.manifest.json` — what was applied + when
+```
+dev-cockpit migrate-config [-c <path>] [--dry-run]
+```
 
-See [mount.md](./mount.md) for the full mount story.
+Reads `cockpit.yaml`, runs migrators from whatever version it declares up to the current `CONFIG_VERSION`, writes the result back with a comment banner. Idempotent on a current-version file. `--dry-run` prints the migrated YAML to stdout instead of writing.
+
+The `dev` command auto-applies migrations in memory each boot — `migrate-config` exists to persist the change so the warning stops firing.
 
 ## Profile setupCli
 
@@ -69,3 +78,7 @@ export const myProfile: Profile = {
 ```
 
 The profile is invoked **before** the core commands register. Any name the profile claims (`dev`, `doctor`, etc.) silently skips its core counterpart — no overrides API, no array mutation, just registration order.
+
+## `:` command palette (not a CLI command)
+
+Inside the running cockpit, `:` opens a vim-style palette over the action registry. Type to substring-filter, ↑/↓ to navigate, Enter to fire, Esc to cancel. Actions can also be bound to a single keystroke via `key:` and dispatched directly in their scope (e.g., `scope: repos:<id>` actions fire on a keypress when that row is selected). See `actions:` in [config-reference.md](./config-reference.md).

package/docs/config-reference.md

@@ -1,19 +1,123 @@
 # Config reference
 
-A `cockpit.yaml` lives at the root of your project. The cockpit reads it on startup and seeds the store from it.
+A `cockpit.yaml` lives at the root of your project. The cockpit reads it on startup, auto-migrates older `version:` to the current `CONFIG_VERSION`, and seeds the store from it.
 
 ## Top-level keys
 
-- `version` (number, required) — schema version. Must match the running build's `CONFIG_VERSION`.
-- `appName` (string, required) — used as the state-dir name (`~/.local/state/<appName>/...`) and the OS-notification title prefix.
-- `watchers` (array) — see watchers.md.
-- `repos` (array) — items to show in the Repos pane.
-- `docker` (object) — `composeFile` + `services[]`. Omit the whole block on plain-Node projects.
-- `highlights` (array) — patterns applied to all log streams.
-- `health` (array) — see health.md.
-- `help` (object) — extra docs sources + `defaultPage`.
-- `notifications` (object) — see notifications.md.
-- `profile` (object) — namespace for profile-specific extension keys (e.g. `profile.myapp = { ... }`). Each profile validates its own block via its `configSchemaExt`.
+| 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: `docker-compose.dev-cockpit.yml`, `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
+      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).
+
+## `actions:`
+
+```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 `:`)
+```
+
+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`.
+
+User-declared actions with the same `(scope, key)` shadow the built-in.
+
+## `health:`
+
+See [health.md](./health.md). Brief shape:
+
+```yaml
+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
+    remediation:
+      key: R
+      label: restart app
+      command: docker compose restart app
+      cwd: .                              # optional
+```
+
+## `mount:` + `mounts:`
+
+```yaml
+mount:                                                # path overrides
+  overlayPath: docker-compose.dev-cockpit.yml         # workspace-relative
+  manifestFile: mount.manifest.json                   # basename within stateDir
+
+mounts:                                               # explicit candidates
+  - hostPath: ./packages/api
+    containerPath: /srv/api
+    meta:                                             # opaque to dev-cockpit; profile hooks read it
+      name: api
+```
+
+Full mount story: [mount.md](./mount.md).
+
+## `notifications:`
+
+```yaml
+notifications:
+  enabled: true
+  onTransitionTo: []   # restrict to specific destination states; empty = all transitions
+  exclude: []          # `NotifiableEvent` strings to suppress
+```
+
+See [notifications.md](./notifications.md).
+
+## `help:`
+
+```yaml
+help:
+  sources:
+    - ./docs            # directory tree of markdown pages
+  defaultPage: getting-started
+```
+
+Profiles can contribute their own `helpSources` that layer over the generic docs.
 
 ## Example
 

package/docs/getting-started.md

@@ -1,20 +1,23 @@
 # Getting started
 
-Run `dev-cockpit dev` from a directory that contains a `cockpit.yaml`. The TUI boots into the **Repos** tab and starts any watchers + health checks declared in your config.
+Run `dev-cockpit dev` from a directory that contains a `cockpit.yaml`. The TUI boots into the **Targets** tab (or whatever `config.defaultPane` points at) and starts any processes + health checks declared in your config.
+
+Don't have a `cockpit.yaml` yet? `dev-cockpit init-config -i` walks you through it in eight steps with auto-detection from `package.json` / `compose.yaml`.
 
 ## At a glance
 
-- **Cycle tabs** — `←` / `→` (or `Tab` / `Shift-Tab`)
+- **Cycle tabs** — `←` / `→` (or `Tab` / `Shift-Tab`). Empty tabs (Targets with no rows, Health with no checks) auto-hide.
 - **Quit** — `q`
 - **Toggle notifications for this session** — `n`
+- **Open the `:` command palette** — `:` (any tab). Type to filter actions, ↑↓ to navigate, Enter to fire.
 
-Every tab fills the full terminal. Modals (filter, search) render in place of the active pane.
+Every tab fills the full terminal. Modals (filter, search, `:` palette) render in place of the active pane.
 
 ## What the panes do
 
-- **Repos** — list of repos and (optionally) Docker services with watcher / lint status; per-row actions live here.
-- **Output** — streaming logs from watchers and Docker services, with filter and search modals.
-- **Health** — workspace health checks; each check has a one-keystroke remediation.
+- **Targets** — repos, docker services, and processes as "runnable units". Split layout (≥200 cols) shows the row list on the left and the actions registered for the selected row on the right; under narrow terminals the panels stack vertically. Built-in `[r]` restarts docker containers and processes; declare more via `config.actions[]` (or a profile's `actions`).
+- **Output** — streaming logs from processes and Docker services. Filter + search modals (`f` / `/`); open the most recent error in `$EDITOR` with `e`. Severity glyphs (`⚠`, `✗`) keep lines scannable without color.
+- **Health** — workspace health checks; each row has a one-keystroke remediation.
 - **Help** — this guide. `j` / `k` to flip pages, `↑` / `↓` to scroll.
 
 ## Try it on a fixture

package/docs/index.md

@@ -4,10 +4,14 @@ This is the in-cockpit Help tab. The pages below explain what each pane does, ho
 
 - [Getting started](./getting-started.md) — first run and what to expect
 - [Panes](./panes.md) — Repos, Output, Health, Help
-- [Watchers](./watchers.md) — long-running commands streamed into Output
+- [Processes](./processes.md) — long-running commands streamed into Output
 - [Health](./health.md) — checks and one-keystroke remediations
 - [Commands](./commands.md) — the four core CLI commands + profile `setupCli`
 - [init-config](./init-config.md) — scaffold a starter `cockpit.yaml`
 - [Mount](./mount.md) — host ↔ container bind-mount overlay
 - [Notifications](./notifications.md) — transition-only OS notifications
 - [Config reference](./config-reference.md) — `cockpit.yaml` schema
+
+## Accessibility
+
+The cockpit honours the [`NO_COLOR`](https://no-color.org) environment variable — set `NO_COLOR=1` (or any non-empty value) and all ANSI colour escapes are stripped. Semantic glyphs (`✓` `⚠` `✗` `●` `○` `▸`) carry the same information in the absence of colour, so panes remain scannable without a terminal palette or for screen-reader users.