dev-cockpit 0.2.1 → 0.2.3

package/dist/link-HXNII7EU.js

@@ -0,0 +1,65 @@
+import { createRequire as __createRequireDC } from 'node:module';
+const require = __createRequireDC(import.meta.url);
+
+import {
+  canonical,
+  listMappings,
+  manifestPath,
+  removeMapping,
+  setMapping
+} from "./chunk-C4GFJDMG.js";
+import "./chunk-6XGHLLYT.js";
+
+// src/commands/link.ts
+import fs from "node:fs";
+import path from "node:path";
+function linkAddCommand(opts) {
+  const cwd = process.cwd();
+  const absConfig = path.resolve(cwd, opts.configPath);
+  if (!fs.existsSync(absConfig)) {
+    process.stderr.write(
+      `dev-cockpit link: ${absConfig} doesn't exist. Create the config file first or pass a valid path.
+`
+    );
+    process.exit(1);
+  }
+  setMapping(cwd, absConfig);
+  process.stdout.write(
+    `dev-cockpit link: ${canonical(cwd)} \u2192 ${canonical(absConfig)}
+`
+  );
+}
+function linkListCommand() {
+  const entries = listMappings();
+  if (entries.length === 0) {
+    process.stdout.write(
+      `dev-cockpit link: no mappings registered (manifest at ${manifestPath()}).
+`
+    );
+    return;
+  }
+  const longest = Math.max(...entries.map((e) => e.workspace.length));
+  for (const { workspace, config } of entries) {
+    process.stdout.write(`${workspace.padEnd(longest)}  \u2192  ${config}
+`);
+  }
+}
+function linkRemoveCommand() {
+  const cwd = process.cwd();
+  const removed = removeMapping(cwd);
+  if (removed) {
+    process.stdout.write(`dev-cockpit link: removed mapping for ${canonical(cwd)}
+`);
+  } else {
+    process.stdout.write(
+      `dev-cockpit link: no mapping for ${canonical(cwd)} (nothing to remove)
+`
+    );
+  }
+}
+export {
+  linkAddCommand,
+  linkListCommand,
+  linkRemoveCommand
+};
+//# sourceMappingURL=link-HXNII7EU.js.map

package/dist/link-HXNII7EU.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\tcanonical,\n\tlistMappings,\n\tmanifestPath,\n\tremoveMapping,\n\tsetMapping,\n} from '../core/manifest.js';\n\nexport interface LinkAddOptions {\n\tconfigPath: string;\n}\n\nexport function linkAddCommand(opts: LinkAddOptions): void {\n\tconst cwd = process.cwd();\n\tconst absConfig = path.resolve(cwd, opts.configPath);\n\tif (!fs.existsSync(absConfig)) {\n\t\tprocess.stderr.write(\n\t\t\t`dev-cockpit link: ${absConfig} doesn't exist. Create the config file first or pass a valid path.\\n`,\n\t\t);\n\t\tprocess.exit(1);\n\t}\n\tsetMapping(cwd, absConfig);\n\tprocess.stdout.write(\n\t\t`dev-cockpit link: ${canonical(cwd)} \u2192 ${canonical(absConfig)}\\n`,\n\t);\n}\n\nexport function linkListCommand(): void {\n\tconst entries = listMappings();\n\tif (entries.length === 0) {\n\t\tprocess.stdout.write(\n\t\t\t`dev-cockpit link: no mappings registered (manifest at ${manifestPath()}).\\n`,\n\t\t);\n\t\treturn;\n\t}\n\tconst longest = Math.max(...entries.map((e) => e.workspace.length));\n\tfor (const { workspace, config } of entries) {\n\t\tprocess.stdout.write(`${workspace.padEnd(longest)}  \u2192  ${config}\\n`);\n\t}\n}\n\nexport function linkRemoveCommand(): void {\n\tconst cwd = process.cwd();\n\tconst removed = removeMapping(cwd);\n\tif (removed) {\n\t\tprocess.stdout.write(`dev-cockpit link: removed mapping for ${canonical(cwd)}\\n`);\n\t} else {\n\t\tprocess.stdout.write(\n\t\t\t`dev-cockpit link: no mapping for ${canonical(cwd)} (nothing to remove)\\n`,\n\t\t);\n\t}\n}"],
+  "mappings": ";;;;;;;;;;;;;AAcA,OAAO,QAAQ;AACf,OAAO,UAAU;AAaV,SAAS,eAAe,MAA4B;AAC1D,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,YAAY,KAAK,QAAQ,KAAK,KAAK,UAAU;AACnD,MAAI,CAAC,GAAG,WAAW,SAAS,GAAG;AAC9B,YAAQ,OAAO;AAAA,MACd,qBAAqB,SAAS;AAAA;AAAA,IAC/B;AACA,YAAQ,KAAK,CAAC;AAAA,EACf;AACA,aAAW,KAAK,SAAS;AACzB,UAAQ,OAAO;AAAA,IACd,qBAAqB,UAAU,GAAG,CAAC,WAAM,UAAU,SAAS,CAAC;AAAA;AAAA,EAC9D;AACD;AAEO,SAAS,kBAAwB;AACvC,QAAM,UAAU,aAAa;AAC7B,MAAI,QAAQ,WAAW,GAAG;AACzB,YAAQ,OAAO;AAAA,MACd,yDAAyD,aAAa,CAAC;AAAA;AAAA,IACxE;AACA;AAAA,EACD;AACA,QAAM,UAAU,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC,MAAM,EAAE,UAAU,MAAM,CAAC;AAClE,aAAW,EAAE,WAAW,OAAO,KAAK,SAAS;AAC5C,YAAQ,OAAO,MAAM,GAAG,UAAU,OAAO,OAAO,CAAC,aAAQ,MAAM;AAAA,CAAI;AAAA,EACpE;AACD;AAEO,SAAS,oBAA0B;AACzC,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,UAAU,cAAc,GAAG;AACjC,MAAI,SAAS;AACZ,YAAQ,OAAO,MAAM,yCAAyC,UAAU,GAAG,CAAC;AAAA,CAAI;AAAA,EACjF,OAAO;AACN,YAAQ,OAAO;AAAA,MACd,oCAAoC,UAAU,GAAG,CAAC;AAAA;AAAA,IACnD;AAAA,EACD;AACD;",
+  "names": []
+}

package/dist/mount/overlay-path.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Resolve where the docker-compose overlay file should be written for a
+ * workspace.
+ *
+ * Default (no `mount.overlayPath` in cockpit.yaml):
+ *   <stateDir>/dev-mount-overlay.yml
+ *   — sibling to `mount.manifest.json`. Keeps the wrapper repo clean of
+ *     per-developer state; aligns the overlay's lifecycle with the
+ *     manifest's.
+ *
+ * Override (cockpit.yaml `mount.overlayPath` is set):
+ *   - Workspace-relative paths resolve against `workspaceRoot`.
+ *   - Absolute paths are honoured verbatim.
+ *
+ * Pure: no I/O. Tested in isolation.
+ */
+export interface ResolveOverlayPathOptions {
+    /** Cockpit state dir for this workspace. */
+    stateDir: string;
+    /** Workspace root, used to resolve relative `configOverride`. */
+    workspaceRoot: string;
+    /** Optional `mount.overlayPath` value from cockpit.yaml. */
+    configOverride?: string | undefined;
+}
+export declare function resolveOverlayPath(opts: ResolveOverlayPathOptions): string;
+//# sourceMappingURL=overlay-path.d.ts.map

package/dist/mount/overlay-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-path.d.ts","sourceRoot":"","sources":["../../src/mount/overlay-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,yBAAyB;IACxC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAM1E"}

package/docs/config-reference.md

@@ -14,7 +14,7 @@ A `cockpit.yaml` lives at the root of your project. The cockpit reads it on star
 | `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`. |
+| `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[]`. |
@@ -84,8 +84,9 @@ health:
 ## `mount:` + `mounts:`
 
 ```yaml
-mount:                                                # path overrides
-  overlayPath: docker-compose.dev-cockpit.yml         # workspace-relative
+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
 
 mounts:                                               # explicit candidates

package/docs/mount.md

@@ -26,22 +26,22 @@ dev-cockpit mount status         # active mounts with branch / dirty / broken-sy
 dev-cockpit mount clear          # remove overlay + manifest + symlinks
 ```
 
-Apply the generated overlay alongside your existing compose file:
+Apply the generated overlay alongside your existing compose file (the path is printed by `dev-cockpit mount` — copy it from there):
 
 ```sh
-docker compose -f docker-compose.yml -f docker-compose.dev-cockpit.yml up -d
+docker compose -f docker-compose.yml -f <stateDir>/dev-mount-overlay.yml up -d
 ```
 
 ## What gets written
 
 | File | Default path | Configurable via |
 |---|---|---|
-| Compose overlay | `<workspace>/docker-compose.dev-cockpit.yml` | `config.mount.overlayPath` |
+| Compose overlay | `<stateDir>/dev-mount-overlay.yml` | `config.mount.overlayPath` |
 | Manifest | `<stateDir>/mount.manifest.json` | `config.mount.manifestFile` |
 
-`<stateDir>` lives under `$XDG_STATE_HOME/<appName>/<workspace-hash>/`. The manifest tracks what was applied and when, and is the source of truth for `status` and `clear`.
+`<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 paths when the wrapper has its own conventions:
+Override the overlay path when the wrapper has its own conventions (workspace-relative or absolute):
 
 ```yaml
 mount:

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dev-cockpit",
-	"version": "0.2.1",
+	"version": "0.2.3",
 	"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.",
 	"license": "MIT",
 	"repository": {