dev-cockpit 0.4.1 → 0.5.0

package/examples/cockpit.schema.json

@@ -431,14 +431,14 @@
     },
     "Keybindings": {
       "type": "object",
-      "description": "Single-keypress → list-of-health-ids dispatch table. Each value may be a string (one id) or an array (fired in declared order on press). Keys SHOULD be single characters; longer strings are accepted but won't ever match a keypress.",
+      "description": "Single-keypress → health-id dispatch table for the Health pane.\n\n- Value may be a single id (string) or a list of ids (array).\n- Multi-id binding: every referenced row shows the key chip in the Health pane. On press, all matching rows are collected; the dispatcher then dedupes by `command|cwd` and fires each UNIQUE remediation exactly once. N rows sharing a command run it once; N rows with distinct commands fire N times.\n- `run`-shaped programmatic remediations (used by profiles) are never folded by dedup — they carry no comparable key.\n- Keys SHOULD be single characters; longer strings are accepted but never match a keypress.\n\nAction keys live separately on `actions[].key` because actions carry `scope` (`global` | `repos` | `repos:<id>`) which doesn't translate cleanly to a global table.",
       "additionalProperties": {
         "oneOf": [
           { "type": "string", "description": "Single health check id to fire." },
           {
             "type": "array",
             "items": { "type": "string" },
-            "description": "Ordered list of health check ids. All fire on a single keypress."
+            "description": "Ordered list of health check ids. All show the key chip; dispatcher dedups by command|cwd before firing."
           }
         ]
       }

package/examples/cockpit.yaml

@@ -1,5 +1,5 @@
 # yaml-language-server: $schema=./cockpit.schema.json
-# cockpit.yaml — example config (schema v2)
+# cockpit.yaml — example config (schema v3)
 # Run `dev-cockpit dev` from the directory containing this file.
 # Or, if it lives elsewhere:
 #   dev-cockpit link <path/to/this-file>     # registers cwd → this config
@@ -7,7 +7,7 @@
 #   DEV_COCKPIT_CONFIG=<path> dev-cockpit dev   # one-shot env override
 #   dev-cockpit dev --config <path>          # one-shot CLI override
 
-version: 2 # config schema version; required (v1 auto-migrated in memory)
+version: 3 # config schema version; required (v1 and v2 auto-migrated in memory)
 appName: my-app # state dir: ~/.local/state/my-app/<workspace-hash>/
 
 # Processes — long-running commands streamed into the Output pane.
@@ -63,7 +63,8 @@ highlights:
     severity: error
 
 # Health checks — `type` references a built-in or profile-registered check id.
-# Each check has a one-keystroke remediation.
+# Each check has a remediation (label + command). Keys for triggering live in
+# the `keybindings:` block below, NOT on the remediation.
 health:
   - id: api-up
     label: API responds
@@ -72,7 +73,6 @@ health:
     notify:
       onTransitionTo: [error] # only notify on going-down, not on recovery
     remediation:
-      key: a
       label: restart api
       command: docker compose restart web
 
@@ -81,7 +81,14 @@ health:
     type: container-running
     container: db
     remediation:
-      key: d
+      label: bring db up
+      command: docker compose up -d db
+
+  - id: redis-running
+    label: Redis container running
+    type: container-running
+    container: redis
+    remediation:
       label: bring db up
       command: docker compose up -d db
 
@@ -90,7 +97,6 @@ health:
     type: file-exists
     path: ./.env
     remediation:
-      key: e
       label: copy .env.example
       command: cp .env.example .env
 
@@ -99,10 +105,27 @@ health:
     type: exec-zero
     command: npm run db:check
     remediation:
-      key: m
       label: run migrations
       command: npm run db:migrate
 
+# Keybindings — single-keypress → health-id dispatch for the Health pane.
+#
+#   - Value can be a single id (string) or a list of ids (array).
+#   - Multi-id binding: every referenced row shows the chip on press, all
+#     match. The dispatcher then dedupes by `command|cwd` and fires each
+#     UNIQUE remediation exactly once — N rows sharing a command run it
+#     once; N rows with distinct commands fire N times.
+#   - Example below: pressing `D` brings the whole docker stack up. The
+#     `db-running` and `redis-running` rows share `docker compose up -d db`,
+#     so that runs once; `api-up`'s `restart web` runs separately.
+keybindings:
+  D:
+    - api-up
+    - db-running
+    - redis-running
+  E: env-file
+  M: migrations
+
 # Help — extra markdown directories layered on top of the built-in help.
 help:
   sources:
@@ -124,8 +147,18 @@ notifications:
 #   manifestFile: mount.manifest.json                   # basename inside stateDir
 #   service: web                                      # target compose service (default: first in docker.services)
 
+# Composer scopes for the auto-registered `composer-drift` health check.
+# Wrappers with nested PHP roots list each scope explicitly. Default: ['.'].
+# composer:
+#   packageDirs:
+#     - .
+#     - project
+
 # Actions — named, key-bound shell commands surfaced via the `:` palette and
 # the Targets pane. `scope` values: `global` | `repos` | `repos:<id>`.
+# Action keys are separate from `keybindings:` (which is health-only) because
+# actions carry scope; `repos:<id>` row-scoped action keys couldn't translate
+# cleanly to the global keybindings dispatch table.
 actions:
   - id: docs
     label: Open docs

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dev-cockpit",
-  "version": "0.4.1",
-  "description": "A reusable, domain-neutral terminal UI dev cockpit — tabbed pane shell, watcher streaming, optional Docker log tail with highlights, health framework with one-keystroke remediations, transition-only OS notifications, live-markdown Help. Profiles extend it with project-specific commands, repos, and health checks.",
+  "version": "0.5.0",
+  "description": "A reusable, domain-neutral terminal UI dev cockpit \u2014 tabbed pane shell, watcher streaming, optional Docker log tail with highlights, health framework with one-keystroke remediations, transition-only OS notifications, live-markdown Help. Profiles extend it with project-specific commands, repos, and health checks.",
   "license": "MIT",
   "repository": {
     "type": "git",