dev-cockpit 0.2.6 → 0.2.8

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   readManifest,
   removeMapping,
   setMapping
-} from "./chunk-A446TCT5.js";
+} from "./chunk-YTMK7EXK.js";
 import {
   __commonJS,
   __export,
@@ -4819,7 +4819,7 @@ var require_cross_spawn = __commonJS({
       enoent.hookChildProcess(spawned, parsed);
       return spawned;
     }
-    function spawnSync2(command, args, options2) {
+    function spawnSync3(command, args, options2) {
       const parsed = parse(command, args, options2);
       const result = cp.spawnSync(parsed.command, parsed.args, parsed.options);
       result.error = result.error || enoent.verifyENOENTSync(result.status, parsed);
@@ -4827,7 +4827,7 @@ var require_cross_spawn = __commonJS({
     }
     module.exports = spawn2;
     module.exports.spawn = spawn2;
-    module.exports.sync = spawnSync2;
+    module.exports.sync = spawnSync3;
     module.exports._parse = parse;
     module.exports._enoent = enoent;
   }
@@ -83970,9 +83970,13 @@ var NotificationsSchema = external_exports.object({
 });
 var MountSchema = external_exports.object({
   hostPath: external_exports.string(),
-  containerPath: external_exports.string(),
+  containerPath: external_exports.string().optional(),
+  kind: external_exports.enum(["bind", "symlink-only"]).optional(),
   meta: external_exports.record(external_exports.unknown()).optional()
-});
+}).refine(
+  (m) => m.kind === "symlink-only" ? true : typeof m.containerPath === "string" && m.containerPath.length > 0,
+  { message: "Mount with kind='bind' (default) requires containerPath" }
+);
 var ActionSchema = external_exports.object({
   id: external_exports.string(),
   label: external_exports.string(),
@@ -83994,7 +83998,9 @@ var MountSettingsSchema = external_exports.object({
    */
   overlayPath: external_exports.string().optional(),
   /** Basename inside stateDir for the manifest. */
-  manifestFile: external_exports.string().optional().default("mount.manifest.json")
+  manifestFile: external_exports.string().optional().default("mount.manifest.json"),
+  /** Target compose service. Unset = first in docker.services. */
+  service: external_exports.string().optional()
 });
 var BaseCockpitConfigSchema = external_exports.object({
   version: external_exports.number().int(),
@@ -84176,9 +84182,7 @@ var FOCUS_ORDER = ["repos", "output", "health", "help"];
 function filterActions(actions, filter) {
   if (!filter) return actions;
   const f = filter.toLowerCase();
-  return actions.filter(
-    (a2) => a2.id.toLowerCase().includes(f) || a2.label.toLowerCase().includes(f)
-  );
+  return actions.filter((a2) => a2.id.toLowerCase().includes(f) || a2.label.toLowerCase().includes(f));
 }
 var cockpitStore = createStore()((set, get2) => ({
   repos: {},
@@ -84447,7 +84451,7 @@ function Repos() {
           const heading2 = kind === "repo" ? "Repos" : kind === "docker" ? "Docker" : "Processes";
           return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Box_default, { flexDirection: "column", marginTop: 1, children: [
             /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Text, { dimColor: true, children: [
-              "  ",
+              " ",
               heading2
             ] }),
             entriesInKind.map(({ key, idx, entry }) => {
@@ -84484,7 +84488,7 @@ function Repos() {
                 " ",
                 a2.label
               ] }),
-              isDefault && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { dimColor: true, children: "  (default)" })
+              isDefault && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { dimColor: true, children: " (default)" })
             ] }, a2.id);
           })
         ]
@@ -84585,9 +84589,7 @@ function Output() {
       } else if (key.downArrow) {
         setScrollOffset((prev) => Math.max(0, prev - 1));
       } else if (key.pageUp) {
-        setScrollOffset(
-          (prev) => Math.min(prev + visibleLines, Math.max(0, total - visibleLines))
-        );
+        setScrollOffset((prev) => Math.min(prev + visibleLines, Math.max(0, total - visibleLines)));
       } else if (key.pageDown) {
         setScrollOffset((prev) => Math.max(0, prev - visibleLines));
       } else if (key.return) {
@@ -87647,7 +87649,9 @@ function Footer({ legends } = {}) {
     if (!key) return NAV_HINT;
     const keyed = actionsForRepoRow(s.actions, key).filter((a2) => a2.key);
     if (keyed.length === 0) return NAV_HINT;
-    return [NAV_HINT, ...keyed.map((a2) => `[${a2.key}] ${shortLabel(a2.label).toLowerCase()}`)].join("  ");
+    return [NAV_HINT, ...keyed.map((a2) => `[${a2.key}] ${shortLabel(a2.label).toLowerCase()}`)].join(
+      "  "
+    );
   });
   let legend;
   if (focus === "repos") {
@@ -87667,7 +87671,9 @@ var import_react5 = __toESM(require_react(), 1);
 var import_jsx_runtime7 = __toESM(require_jsx_runtime(), 1);
 function FilterModal() {
   const outputFilter = useCockpitStore((s) => s.outputFilter);
-  const [severityDraft, setSeverityDraft] = (0, import_react5.useState)(outputFilter.severity);
+  const [severityDraft, setSeverityDraft] = (0, import_react5.useState)(
+    outputFilter.severity
+  );
   const SEVERITIES = [void 0, "info", "warn", "error"];
   use_input_default((input, key) => {
     if (input === "s") {
@@ -87680,26 +87686,16 @@ function FilterModal() {
       cockpitStore.getState().setActiveModal(null);
     }
   });
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Box_default, { flexGrow: 1, alignItems: "center", justifyContent: "center", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
-    Box_default,
-    {
-      flexDirection: "column",
-      borderStyle: "round",
-      borderColor: "cyan",
-      paddingX: 2,
-      paddingY: 1,
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { bold: true, children: " Filter Output " }),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: " " }),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Box_default, { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: "Severity (s to cycle): " }),
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { color: "cyan", children: severityDraft ?? "all" })
-        ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: " " }),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { dimColor: true, children: "Enter = apply \xB7 Esc = cancel" })
-      ]
-    }
-  ) });
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Box_default, { flexGrow: 1, alignItems: "center", justifyContent: "center", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Box_default, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { bold: true, children: " Filter Output " }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: " " }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Box_default, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: "Severity (s to cycle): " }),
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { color: "cyan", children: severityDraft ?? "all" })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: " " }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { dimColor: true, children: "Enter = apply \xB7 Esc = cancel" })
+  ] }) });
 }
 
 // src/cockpit/panes/SearchModal.tsx
@@ -87729,29 +87725,19 @@ function SearchModal() {
       setQuery((prev) => prev + input);
     }
   });
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Box_default, { flexGrow: 1, alignItems: "center", justifyContent: "center", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
-    Box_default,
-    {
-      flexDirection: "column",
-      borderStyle: "round",
-      borderColor: "cyan",
-      paddingX: 2,
-      paddingY: 1,
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { bold: true, children: " Search Output " }),
-        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { children: " " }),
-        /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(Box_default, { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { children: "Query: " }),
-          /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(Text, { color: "cyan", children: [
-            query,
-            /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { color: "gray", children: "\u2588" })
-          ] })
-        ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { children: " " }),
-        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { dimColor: true, children: "Enter = apply \xB7 Esc = cancel \xB7 Backspace = delete" })
-      ]
-    }
-  ) });
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Box_default, { flexGrow: 1, alignItems: "center", justifyContent: "center", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(Box_default, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { bold: true, children: " Search Output " }),
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { children: " " }),
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(Box_default, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { children: "Query: " }),
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(Text, { color: "cyan", children: [
+        query,
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { color: "gray", children: "\u2588" })
+      ] })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { children: " " }),
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Text, { dimColor: true, children: "Enter = apply \xB7 Esc = cancel \xB7 Backspace = delete" })
+  ] }) });
 }
 
 // src/cockpit/panes/CommandModal.tsx
@@ -87906,9 +87892,7 @@ function useGlobalKeys(opts) {
         return;
       }
       if (input === "e" && onOpenError) {
-        const target = state.recentErrors.find(
-          (er) => er.file && typeof er.line === "number"
-        );
+        const target = state.recentErrors.find((er) => er.file && typeof er.line === "number");
         if (target?.file && typeof target.line === "number") {
           onOpenError({
             file: target.file,
@@ -87946,10 +87930,7 @@ function useGlobalKeys(opts) {
           healthId: dispatch.healthId,
           healthLabel: dispatch.healthLabel
         });
-        withMinHold(
-          dispatch.promise,
-          () => cockpitStore.getState().setActiveRemediation(null)
-        );
+        withMinHold(dispatch.promise, () => cockpitStore.getState().setActiveRemediation(null));
         return;
       }
     }
@@ -90963,11 +90944,7 @@ async function devCommand(opts = {}) {
   const builtinActions = buildBuiltinActions(config);
   const actions = buildActionRegistry(
     [...config.actions],
-    [
-      ...builtinActions,
-      ...profile?.actions ?? [],
-      ...bootResult.actions ?? []
-    ]
+    [...builtinActions, ...profile?.actions ?? [], ...bootResult.actions ?? []]
   );
   const [shell, shellFlag] = process.platform === "win32" ? ["cmd", "/c"] : ["/bin/sh", "-c"];
   const highlightMatcher = compileHighlights(config.highlights);
@@ -91040,7 +91017,12 @@ async function devCommand(opts = {}) {
       }
       if (action.id.startsWith(BUILTIN_RESTART_PROCESS)) {
         const procId = action.id.slice(BUILTIN_RESTART_PROCESS.length);
-        store.appendOutput({ ts: Date.now(), source: procId, severity: "info", text: `> restart ${procId}` });
+        store.appendOutput({
+          ts: Date.now(),
+          source: procId,
+          severity: "info",
+          text: `> restart ${procId}`
+        });
         await killSpawnedByTag(procId);
         spawnProcessById(procId);
         store.setFocus("output");
@@ -91334,10 +91316,7 @@ function renderWizardYaml(result) {
   if (health.length > 0) blocks.push(health);
   const actions = renderActions(result.actions);
   if (actions.length > 0) blocks.push(actions);
-  blocks.push([
-    "notifications:",
-    indent(`enabled: ${result.notifications.enabled}`, 1)
-  ]);
+  blocks.push(["notifications:", indent(`enabled: ${result.notifications.enabled}`, 1)]);
   if (result.profileLines && result.profileLines.length > 0) {
     blocks.push([
       "profile:",
@@ -91406,7 +91385,12 @@ function safeReadJson(p) {
   }
 }
 function detectComposeFile(cwd) {
-  for (const candidate of ["compose.yaml", "compose.yml", "docker-compose.yml", "docker-compose.yaml"]) {
+  for (const candidate of [
+    "compose.yaml",
+    "compose.yml",
+    "docker-compose.yml",
+    "docker-compose.yaml"
+  ]) {
     if (fs11.existsSync(path15.join(cwd, candidate))) return candidate;
   }
   return void 0;
@@ -91444,7 +91428,10 @@ function detectRepoSuggestions(cwd, pkg) {
   }
   for (const glob of workspaceGlobs) {
     for (const entry of expandSimpleGlob(cwd, glob)) {
-      out.push({ id: path15.basename(entry), path: path15.relative(cwd, path15.join(cwd, entry)) || "." });
+      out.push({
+        id: path15.basename(entry),
+        path: path15.relative(cwd, path15.join(cwd, entry)) || "."
+      });
     }
   }
   const pnpmFile = path15.join(cwd, "pnpm-workspace.yaml");
@@ -91787,7 +91774,9 @@ async function promptHealthChecks(prompts, hints, hasDocker) {
     ].join("\n")
   );
   const out = [];
-  let typeChoices = baseHealthTypeChoices(Boolean(hints.composeFile && hints.composeServices.length > 0));
+  let typeChoices = baseHealthTypeChoices(
+    Boolean(hints.composeFile && hints.composeServices.length > 0)
+  );
   if (!hasDocker) {
     typeChoices = typeChoices.filter((c3) => c3.value !== "container-running");
   }
@@ -91852,7 +91841,14 @@ async function promptOneHealthCheck(prompts, type, hints) {
       })).trim();
       idDefault = `${slugify(container)}-up`;
       labelDefault = `Container \`${container}\` running`;
-      typeArgs = { type, container, id: "", label: "", severity: "error", remediation: { key: "", label: "", command: "" } };
+      typeArgs = {
+        type,
+        container,
+        id: "",
+        label: "",
+        severity: "error",
+        remediation: { key: "", label: "", command: "" }
+      };
       break;
     }
     case "port-open": {
@@ -91861,7 +91857,15 @@ async function promptOneHealthCheck(prompts, type, hints) {
       const port = portRaw ?? 0;
       idDefault = `port-${port}-open`;
       labelDefault = `Port ${port} open`;
-      typeArgs = { type, host, port, id: "", label: "", severity: "error", remediation: { key: "", label: "", command: "" } };
+      typeArgs = {
+        type,
+        host,
+        port,
+        id: "",
+        label: "",
+        severity: "error",
+        remediation: { key: "", label: "", command: "" }
+      };
       break;
     }
     case "http-ok": {
@@ -91873,7 +91877,14 @@ async function promptOneHealthCheck(prompts, type, hints) {
       const pathPart = url.replace(/^https?:\/\/[^/]+/, "").replace(/^\//, "") || "root";
       idDefault = `http-${slugify(pathPart)}`;
       labelDefault = `GET ${url} returns 2xx`;
-      typeArgs = { type, url, id: "", label: "", severity: "error", remediation: { key: "", label: "", command: "" } };
+      typeArgs = {
+        type,
+        url,
+        id: "",
+        label: "",
+        severity: "error",
+        remediation: { key: "", label: "", command: "" }
+      };
       break;
     }
     case "file-exists": {
@@ -91885,16 +91896,33 @@ async function promptOneHealthCheck(prompts, type, hints) {
       const basename3 = filePath.split("/").filter(Boolean).pop() ?? filePath;
       idDefault = `${slugify(basename3)}-exists`;
       labelDefault = `\`${filePath}\` exists`;
-      typeArgs = { type, path: filePath, id: "", label: "", severity: "error", remediation: { key: "", label: "", command: "" } };
+      typeArgs = {
+        type,
+        path: filePath,
+        id: "",
+        label: "",
+        severity: "error",
+        remediation: { key: "", label: "", command: "" }
+      };
       break;
     }
     case "exec-zero": {
       explain("  The command runs once at startup. Exit code 0 = pass, anything else = fail.");
-      const command = (await prompts.input({ message: "command", validate: (s) => s.trim().length > 0 ? true : "cannot be empty" })).trim();
+      const command = (await prompts.input({
+        message: "command",
+        validate: (s) => s.trim().length > 0 ? true : "cannot be empty"
+      })).trim();
       const verb = slugify(command.split(/\s+/)[0] ?? "exec");
       idDefault = `${verb}-ok`;
       labelDefault = `\`${command.length > 40 ? command.slice(0, 37) + "\u2026" : command}\` exits 0`;
-      typeArgs = { type, command, id: "", label: "", severity: "error", remediation: { key: "", label: "", command: "" } };
+      typeArgs = {
+        type,
+        command,
+        id: "",
+        label: "",
+        severity: "error",
+        remediation: { key: "", label: "", command: "" }
+      };
       break;
     }
   }
@@ -91918,7 +91946,11 @@ async function promptOneHealthCheck(prompts, type, hints) {
   });
   const typed = { ...typeArgs, id, label, severity };
   blank();
-  line(source_default.bold("  Remediation \u2014 what should pressing a key in the cockpit do when this check fails?"));
+  line(
+    source_default.bold(
+      "  Remediation \u2014 what should pressing a key in the cockpit do when this check fails?"
+    )
+  );
   explain(
     [
       "  Three pieces:",
@@ -91973,7 +92005,15 @@ function defaultRemediationCommand(type, hints) {
       return 'echo "edit cockpit.yaml to set the fix command"';
   }
 }
-var ACTION_SCRIPT_CANDIDATES = ["test", "build", "lint", "format", "typecheck", "type-check", "check"];
+var ACTION_SCRIPT_CANDIDATES = [
+  "test",
+  "build",
+  "lint",
+  "format",
+  "typecheck",
+  "type-check",
+  "check"
+];
 function defaultKeyFor(scriptName) {
   const map = {
     test: "t",
@@ -91993,9 +92033,7 @@ async function promptActions(prompts, hints) {
       "from `processes` (long-running streams) and `health` (state-checked)."
     ].join("\n")
   );
-  const suggestionScripts = ACTION_SCRIPT_CANDIDATES.filter(
-    (s) => hints.packageJsonScripts[s]
-  );
+  const suggestionScripts = ACTION_SCRIPT_CANDIDATES.filter((s) => hints.packageJsonScripts[s]);
   const actions = [];
   if (suggestionScripts.length > 0) {
     blank();
@@ -92011,7 +92049,10 @@ async function promptActions(prompts, hints) {
           const key = defaultKeyFor(s);
           const keyHint = key ? ` [${key}]` : "";
           return {
-            name: `${s}${keyHint} \u2192 npm run ${s}  (${hints.packageJsonScripts[s] ?? ""})`.slice(0, 80),
+            name: `${s}${keyHint} \u2192 npm run ${s}  (${hints.packageJsonScripts[s] ?? ""})`.slice(
+              0,
+              80
+            ),
             value: s,
             checked: true
           };
@@ -92102,7 +92143,9 @@ async function runInitWizard(opts) {
   line(source_default.dim("    8. Notifications  \u2014 native OS toasts on state changes"));
   blank();
   line("  Anything you skip you can add later by hand-editing cockpit.yaml.");
-  line(`  Press ${source_default.cyan("Ctrl-C")} to quit; press ${source_default.cyan("enter")} to accept any default.`);
+  line(
+    `  Press ${source_default.cyan("Ctrl-C")} to quit; press ${source_default.cyan("enter")} to accept any default.`
+  );
   blank();
   const proceed = await prompts.confirm({ message: "Ready?", default: true });
   if (!proceed) {
@@ -92264,14 +92307,18 @@ dev-cockpit init-config: wrote ${target}
       try {
         await doctorCommand({ config: target, profile: opts.profile });
       } catch (err) {
-        process.stderr.write(`
+        process.stderr.write(
+          `
 doctor failed: ${err instanceof Error ? err.message : String(err)}
-`);
+`
+        );
       }
     }
     process.stdout.write("\nNext:\n");
     process.stdout.write("  \u2022 Edit cockpit.yaml any time, then re-run `dev-cockpit doctor`.\n");
-    process.stdout.write("  \u2022 Run `dev-cockpit dev` to launch the cockpit (Tab/arrows cycle panes, q quits).\n");
+    process.stdout.write(
+      "  \u2022 Run `dev-cockpit dev` to launch the cockpit (Tab/arrows cycle panes, q quits).\n"
+    );
     process.stdout.write("  \u2022 The Help tab inside the cockpit has the full docs.\n");
   } else {
     process.stdout.write("  Run `dev-cockpit doctor` to verify the config loads cleanly.\n");
@@ -92346,14 +92393,19 @@ function validateMountManifest(filePath, raw) {
 // src/mount/compose.ts
 function renderDockerOverlay(mounts, opts) {
   const lines = [];
-  lines.push(opts.banner ?? "# Generated by `dev-cockpit mount`. Do not edit by hand \u2014 re-run the command.");
+  lines.push(
+    opts.banner ?? "# Generated by `dev-cockpit mount`. Do not edit by hand \u2014 re-run the command."
+  );
   lines.push("services:");
   lines.push(`  ${opts.service}:`);
-  if (mounts.length === 0) {
+  const binds = mounts.filter(
+    (m) => m.kind !== "symlink-only" && typeof m.containerPath === "string"
+  );
+  if (binds.length === 0) {
     lines.push("    volumes: []");
   } else {
     lines.push("    volumes:");
-    for (const m of mounts) {
+    for (const m of binds) {
       const source = m.hostPath.replace(/\\/g, "/");
       lines.push("      - type: bind");
       lines.push(`        source: ${source}`);
@@ -92379,35 +92431,66 @@ function resolveOverlayPath(opts) {
 // src/mount/symlinks.ts
 import fs14 from "node:fs";
 import path19 from "node:path";
+import { spawnSync as spawnSync2 } from "node:child_process";
 function applyManagedSymlinks(workspaceRoot, mounts, strategy) {
   const report = { created: [], replaced: [], skipped: [] };
   for (const m of mounts) {
     const linkPath = strategy.linkPath(m, workspaceRoot);
     if (!linkPath) continue;
-    let preExistingRealDir = false;
-    try {
-      const lstat3 = fs14.lstatSync(linkPath);
-      if (lstat3.isSymbolicLink()) {
-        const existing = fs14.readlinkSync(linkPath);
-        if (existing === m.hostPath) {
-          report.created.push(linkPath);
-          continue;
-        }
+    const outcome = applyOneSymlink(linkPath, m.hostPath);
+    if (outcome === "created") report.created.push(linkPath);
+    else if (outcome === "replaced") report.replaced.push(linkPath);
+    else report.skipped.push(linkPath);
+  }
+  return report;
+}
+function applyOneSymlink(linkPath, hostPath) {
+  let preExistingRealDir = false;
+  let existing = null;
+  try {
+    existing = fs14.lstatSync(linkPath);
+  } catch {
+  }
+  if (existing) {
+    if (existing.isSymbolicLink()) {
+      try {
+        if (fs14.readlinkSync(linkPath) === hostPath) return "created";
         fs14.unlinkSync(linkPath);
-      } else if (lstat3.isDirectory()) {
-        preExistingRealDir = true;
-        fs14.rmSync(linkPath, { recursive: true, force: true });
-      } else {
+      } catch {
+        return "skipped";
+      }
+    } else if (existing.isDirectory()) {
+      preExistingRealDir = true;
+      if (!tryRemoveDir(linkPath)) return "skipped";
+    } else {
+      try {
         fs14.unlinkSync(linkPath);
+      } catch {
+        return "skipped";
       }
-    } catch {
     }
+  }
+  try {
     fs14.mkdirSync(path19.dirname(linkPath), { recursive: true });
-    fs14.symlinkSync(m.hostPath, linkPath);
-    if (preExistingRealDir) report.replaced.push(linkPath);
-    else report.created.push(linkPath);
+    fs14.symlinkSync(hostPath, linkPath);
+  } catch {
+    return "skipped";
   }
-  return report;
+  return preExistingRealDir ? "replaced" : "created";
+}
+function tryRemoveDir(p) {
+  try {
+    fs14.rmSync(p, { recursive: true, force: true });
+  } catch {
+    if (process.platform === "darwin") {
+      spawnSync2("chmod", ["-RN", p], { stdio: "ignore" });
+      try {
+        fs14.rmSync(p, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  }
+  return !fs14.existsSync(p);
 }
 function removeManagedSymlinks(workspaceRoot, mounts, strategy) {
   for (const m of mounts) {
@@ -92449,23 +92532,19 @@ function detectBrokenSymlinks(workspaceRoot, mounts, strategy) {
 async function readGitInfo(hostPath) {
   try {
     let branchOut = "";
-    const branchHandle = spawnStream(
-      "git",
-      ["-C", hostPath, "rev-parse", "--abbrev-ref", "HEAD"],
-      { onStdout: (line2) => {
+    const branchHandle = spawnStream("git", ["-C", hostPath, "rev-parse", "--abbrev-ref", "HEAD"], {
+      onStdout: (line2) => {
         branchOut += line2;
-      } }
-    );
+      }
+    });
     const branchCode = await branchHandle.exitCode;
     if (branchCode !== 0) return null;
     let statusOut = "";
-    const statusHandle = spawnStream(
-      "git",
-      ["-C", hostPath, "status", "--porcelain"],
-      { onStdout: (line2) => {
+    const statusHandle = spawnStream("git", ["-C", hostPath, "status", "--porcelain"], {
+      onStdout: (line2) => {
         statusOut += line2;
-      } }
-    );
+      }
+    });
     await statusHandle.exitCode;
     return {
       branch: branchOut.trim() || "?",
@@ -92477,10 +92556,14 @@ async function readGitInfo(hostPath) {
 }
 
 // src/commands/mount.ts
+function mountKey(m) {
+  if (m.kind === "symlink-only") return `symlink:${m.hostPath}`;
+  return `bind:${m.containerPath ?? m.hostPath}`;
+}
 function mergeMounts(configMounts, providerMounts) {
   const seen = /* @__PURE__ */ new Map();
-  for (const m of providerMounts) seen.set(m.containerPath, m);
-  for (const m of configMounts) seen.set(m.containerPath, m);
+  for (const m of providerMounts) seen.set(mountKey(m), m);
+  for (const m of configMounts) seen.set(mountKey(m), m);
   return Array.from(seen.values());
 }
 async function resolveContext(opts) {
@@ -92503,20 +92586,18 @@ async function resolveContext(opts) {
     throw err;
   }
   if (!fs15.existsSync(configPath)) {
-    process.stderr.write(
-      `dev-cockpit mount: cockpit.yaml at ${configPath} doesn't exist.
-`
-    );
+    process.stderr.write(`dev-cockpit mount: cockpit.yaml at ${configPath} doesn't exist.
+`);
     process.exit(1);
   }
   const config = loadConfig(configPath, {
     configSchemaExt: profile?.configSchemaExt,
     profileKey: profile?.appName
   });
-  const explicitService = opts.service ?? config.docker?.services?.[0]?.name;
+  const explicitService = opts.service ?? config.mount.service ?? config.docker?.services?.[0]?.name;
   if (!explicitService) {
     process.stderr.write(
-      "dev-cockpit mount: no target service. Pass --service <name> or set docker.services in cockpit.yaml.\n"
+      "dev-cockpit mount: no target service. Pass --service <name>, set mount.service in cockpit.yaml, or set docker.services in cockpit.yaml.\n"
     );
     process.exit(1);
   }
@@ -92544,18 +92625,11 @@ var stdoutSink = (line2) => process.stdout.write(`${line2}
 `);
 var stderrSink = (line2) => process.stderr.write(`${line2}
 `);
-function applyExclude(mounts, exclude) {
-  if (exclude.length === 0) return [...mounts];
-  const set = new Set(exclude);
-  return mounts.filter((m) => {
-    const name = m.meta?.["name"] ?? "";
-    return !set.has(name);
-  });
-}
 async function pickMounts(candidates) {
   const { checkbox } = await import("@inquirer/prompts");
   const choices = candidates.map((m) => {
-    const name = m.meta?.["name"] ?? m.containerPath;
+    const fallbackName = m.containerPath ?? (m.kind === "symlink-only" ? `(symlink) ${m.hostPath}` : m.hostPath);
+    const name = m.meta?.["name"] ?? fallbackName;
     const type = m.meta?.["type"];
     const label = type ? `${name}  (${type})  ${m.hostPath}` : `${name}  ${m.hostPath}`;
     return { name: label, value: m, checked: true };
@@ -92567,8 +92641,17 @@ async function pickMounts(candidates) {
 }
 async function mountCommand(opts = {}) {
   const ctx = await resolveContext(opts);
-  const { workspaceRoot, appName, service, configMounts, providerMounts, overlayPath, manifestPath: manifestPath2, profile } = ctx;
-  const merged = applyExclude(mergeMounts(configMounts, providerMounts), opts.exclude ?? []);
+  const {
+    workspaceRoot,
+    appName,
+    service,
+    configMounts,
+    providerMounts,
+    overlayPath,
+    manifestPath: manifestPath2,
+    profile
+  } = ctx;
+  const merged = mergeMounts(configMounts, providerMounts);
   if (merged.length === 0) {
     process.stdout.write(
       "dev-cockpit mount: no mount candidates from config.mounts[] or profile.mountCandidatesProvider.\n"
@@ -92615,7 +92698,8 @@ async function mountCommand(opts = {}) {
 `
       );
     }
-    for (const p of report.skipped) process.stdout.write(`dev-cockpit mount: skipped (could not replace) \u2192 ${p}
+    for (const p of report.skipped)
+      process.stdout.write(`dev-cockpit mount: skipped (could not replace) \u2192 ${p}
 `);
   }
   if (profile?.onMountApply) {
@@ -92674,7 +92758,7 @@ dev-cockpit mount status \u2014 service: ${manifest.service}
   const headers = ["NAME", "BRANCH", "DIRTY", ...Array.from(extraKeys)];
   const widths = headers.map((h2) => h2.length);
   const dataRows = rows.map((r) => {
-    const name = r.mount.meta?.["name"] ?? r.mount.containerPath;
+    const name = r.mount.meta?.["name"] ?? r.mount.containerPath ?? r.mount.hostPath;
     const branch = (r.info.branch ?? "?").slice(0, 24);
     const dirty = r.info.dirty === void 0 ? "?" : r.info.dirty ? "yes" : "no";
     const extras = Array.from(extraKeys).map((k) => r.info.extra?.[k] ?? "");
@@ -92757,8 +92841,10 @@ async function migrateConfigCommand(opts = {}) {
   }
   const fromVersion = raw["version"];
   if (fromVersion === CONFIG_VERSION) {
-    process.stdout.write(`dev-cockpit migrate-config: already at v${CONFIG_VERSION}; nothing to do.
-`);
+    process.stdout.write(
+      `dev-cockpit migrate-config: already at v${CONFIG_VERSION}; nothing to do.
+`
+    );
     return;
   }
   if (fromVersion > CONFIG_VERSION) {
@@ -92810,24 +92896,32 @@ function buildCli(opts = {}) {
   const program2 = new Command();
   const profile = opts.profile;
   const appName = profile?.appName ?? "dev-cockpit";
-  program2.name(appName).description(
-    profile ? `${appName} \u2014 built on dev-cockpit` : "Generic terminal UI dev cockpit"
-  ).version(readPackageVersion(), "-V, --version", "Output the version number");
+  program2.name(appName).description(profile ? `${appName} \u2014 built on dev-cockpit` : "Generic terminal UI dev cockpit").version(readPackageVersion(), "-V, --version", "Output the version number");
   if (profile?.setupCli) {
     profile.setupCli(program2);
   }
   if (!hasCommand(program2, "dev")) {
-    program2.command("dev").description("Boot the three-pane TUI (Repos / Output / Health / Help)").option("-c, --config <path>", "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)").action(async (cmdOpts) => {
+    program2.command("dev").description("Boot the three-pane TUI (Repos / Output / Health / Help)").option(
+      "-c, --config <path>",
+      "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)"
+    ).action(async (cmdOpts) => {
       await devCommand({ config: cmdOpts.config, profile });
     });
   }
   if (!hasCommand(program2, "doctor")) {
-    program2.command("doctor").description("Run all health checks once and print a status table").option("-c, --config <path>", "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)").action(async (cmdOpts) => {
+    program2.command("doctor").description("Run all health checks once and print a status table").option(
+      "-c, --config <path>",
+      "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)"
+    ).action(async (cmdOpts) => {
       await doctorCommand({ config: cmdOpts.config, profile });
     });
   }
   if (!hasCommand(program2, "init-config")) {
-    program2.command("init-config").description("Write a starter cockpit.yaml in the current directory").option("-f, --force", "Overwrite an existing cockpit.yaml without prompting", false).option("--with-docker", "Include an uncommented docker block (static template only)", false).option("-i, --interactive", "Walk through prompts to populate the file (skips static template)", false).option("-o, --output <path>", "Write the file to this path instead of <cwd>/cockpit.yaml").action(
+    program2.command("init-config").description("Write a starter cockpit.yaml in the current directory").option("-f, --force", "Overwrite an existing cockpit.yaml without prompting", false).option("--with-docker", "Include an uncommented docker block (static template only)", false).option(
+      "-i, --interactive",
+      "Walk through prompts to populate the file (skips static template)",
+      false
+    ).option("-o, --output <path>", "Write the file to this path instead of <cwd>/cockpit.yaml").action(
       async (cmdOpts) => {
         await initConfigCommand({
           force: cmdOpts.force ?? false,
@@ -92842,42 +92936,52 @@ function buildCli(opts = {}) {
   }
   if (!hasCommand(program2, "link")) {
     const linkCmd = program2.command("link").description("Register the current directory as using a cockpit.yaml that lives elsewhere").argument("<config-path>", "Path to the cockpit.yaml to associate with this directory").action(async (configPath) => {
-      const { linkAddCommand } = await import("./link-VWT2VQH6.js");
+      const { linkAddCommand } = await import("./link-Y7OFHOUP.js");
       linkAddCommand({ configPath });
     });
     linkCmd.command("list").description("Print all registered project \u2192 config mappings").action(async () => {
-      const { linkListCommand } = await import("./link-VWT2VQH6.js");
+      const { linkListCommand } = await import("./link-Y7OFHOUP.js");
       linkListCommand();
     });
     linkCmd.command("remove").description("Unregister the current directory from the manifest").action(async () => {
-      const { linkRemoveCommand } = await import("./link-VWT2VQH6.js");
+      const { linkRemoveCommand } = await import("./link-Y7OFHOUP.js");
       linkRemoveCommand();
     });
   }
   if (!hasCommand(program2, "mount")) {
-    const mountCmd = program2.command("mount").description("Apply a docker-compose bind-mount overlay (interactive picker by default)").option("-c, --config <path>", "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)").option("-s, --service <name>", "Target compose service (default: first in docker.services)").option("-q, --quiet", "Skip the interactive picker; apply all candidates").option(
-      "-e, --exclude <name>",
-      "Exclude a candidate by meta.name (repeatable)",
-      (val, prev) => [...prev, val],
-      []
-    ).action(async (cmdOpts) => {
+    const mountCmd = program2.command("mount").description(
+      `Apply a docker-compose bind-mount overlay (interactive picker by default)
+
+This creates a docker-compose overlay file. The location of the overlay file is configurable in the cockpit.yaml file. You must then include the overlay file in your compose file as a wildcard include. eg. \`docker-compose.yml -f docker/compose/web/docker-compose.dev-link.yml\``
+    ).option(
+      "-c, --config <path>",
+      "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)"
+    ).option("-s, --service <name>", "Target compose service (default: first in docker.services)").option("-q, --quiet", "Skip the interactive picker; apply all candidates").action(async (cmdOpts) => {
       await mountCommand({
         config: cmdOpts.config,
         service: cmdOpts.service,
         quiet: cmdOpts.quiet ?? false,
-        exclude: cmdOpts.exclude ?? [],
         profile
       });
     });
-    mountCmd.command("status").description("Show active mounts with branch, dirty, and broken-symlink status").option("-c, --config <path>", "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)").action(async (cmdOpts) => {
+    mountCmd.command("status").description("Show active mounts with branch, dirty, and broken-symlink status").option(
+      "-c, --config <path>",
+      "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)"
+    ).action(async (cmdOpts) => {
       await mountStatusCommand({ config: cmdOpts.config, profile });
     });
-    mountCmd.command("clear").description("Remove the overlay, manifest, and managed symlinks; runs profile.onMountClear").option("-c, --config <path>", "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)").action(async (cmdOpts) => {
+    mountCmd.command("clear").description("Remove the overlay, manifest, and managed symlinks; runs profile.onMountClear").option(
+      "-c, --config <path>",
+      "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)"
+    ).action(async (cmdOpts) => {
       await mountClearCommand({ config: cmdOpts.config, profile });
     });
   }
   if (!hasCommand(program2, "migrate-config")) {
-    program2.command("migrate-config").description("Rewrite cockpit.yaml at the current CONFIG_VERSION").option("-c, --config <path>", "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)").option("--dry-run", "Print the migrated YAML to stdout instead of writing").action(async (cmdOpts) => {
+    program2.command("migrate-config").description("Rewrite cockpit.yaml at the current CONFIG_VERSION").option(
+      "-c, --config <path>",
+      "Path to cockpit.yaml (default: <cwd>/cockpit.yaml or registered via `link`)"
+    ).option("--dry-run", "Print the migrated YAML to stdout instead of writing").action(async (cmdOpts) => {
       await migrateConfigCommand({ config: cmdOpts.config, dryRun: cmdOpts.dryRun });
     });
   }