@getmonoceros/workbench 1.38.19 → 1.39.0

package/dist/bin.js

@@ -479,6 +479,18 @@ function expandEnvRefs(env) {
   }
   return out;
 }
+function mergeEnvLayers(...layers) {
+  const out = {};
+  for (const layer of layers) {
+    for (const [key, value] of Object.entries(layer)) {
+      const incomingEmpty = value.trim() === "";
+      const haveNonEmpty = out[key] !== void 0 && out[key].trim() !== "";
+      if (incomingEmpty && haveNonEmpty) continue;
+      out[key] = value;
+    }
+  }
+  return out;
+}
 function interpolateServices(services, vars) {
   const missing = [];
   const resolved = services.map((svc) => {
@@ -1439,10 +1451,10 @@ function resolveRepoTokens(config, catalog, envVars) {
 async function resolveContainerRepoTokens(name, home, catalog) {
   const ymlPath = containerConfigPath(name, home);
   const { config } = parseConfig(await fs4.readFile(ymlPath, "utf8"), ymlPath);
-  const envVars = {
-    ...readEnvFile(globalEnvPath(home)),
-    ...readEnvFile(containerEnvPath(name, home))
-  };
+  const envVars = mergeEnvLayers(
+    readEnvFile(globalEnvPath(home)),
+    readEnvFile(containerEnvPath(name, home))
+  );
   return resolveRepoTokens(config, catalog, envVars);
 }
 function formatTokenUse(use) {
@@ -4452,6 +4464,9 @@ function generateAgentsMd(input) {
           lines.push(sub ? `  ${sub}` : "");
         }
       }
+      for (const mountLine of formatServiceMounts(svc)) {
+        lines.push(mountLine);
+      }
     }
     lines.push("");
     const connEnv = serviceConnectionEnv(input.services);
@@ -4630,6 +4645,7 @@ function generateAgentsMd(input) {
   );
   lines.push("");
   const examplePort = input.ports.length > 0 ? String(input.ports[0]) : "<port>";
+  const secondPort = input.ports.length > 1 ? String(input.ports[1]) : "<port>";
   lines.push("## Running a long-running server");
   lines.push("");
   lines.push(
@@ -4664,7 +4680,10 @@ function generateAgentsMd(input) {
   lines.push("{");
   lines.push('  "targets": [');
   lines.push(
-    `    { "name": "web", "command": "<the project's start command>", "port": ${examplePort}, "default": true }`
+    `    { "name": "api", "command": "<the API's start command>", "port": ${examplePort}, "default": true },`
+  );
+  lines.push(
+    `    { "name": "web", "command": "<the web start command>", "port": ${secondPort}, "default": true }`
   );
   lines.push("  ]");
   lines.push("}");
@@ -4703,6 +4722,17 @@ function generateAgentsMd(input) {
     "not started. Pass `--target <name>` to start or stop a single one."
   );
   lines.push("");
+  lines.push(
+    "When you add a server in a later session, revisit the existing",
+    "`launch.json` instead of assuming its current `default` set is complete.",
+    "If the new server belongs to the app that should come up together (a",
+    "backend the frontend calls, a worker the app relies on), give it",
+    '`"default": true` too and place its entry before whatever depends on it.',
+    "A single pre-existing default entry does not mean later servers should",
+    "stay non-default - most servers that make up the running app belong in",
+    "the default set."
+  );
+  lines.push("");
   lines.push(
     "The server must listen on `0.0.0.0` (not `127.0.0.1`) on the exposed",
     "port, or Traefik cannot reach it. You only have the ports already",
@@ -4740,6 +4770,42 @@ function formatServiceLine(svc) {
   }
   return `- **${svc.name}** (custom image \`${svc.image}\`) \u2014 reachable at \`${reach}\``;
 }
+function formatServiceMounts(svc) {
+  const byProject = /* @__PURE__ */ new Map();
+  for (const spec of svc.volumes) {
+    const mount = parseBindMount(spec);
+    if (!mount) continue;
+    const project = projectOf(mount.source);
+    if (!project) continue;
+    const readOnly = mount.mode === "ro" ? " (read-only)" : "";
+    const bucket = byProject.get(project) ?? [];
+    bucket.push(`    - \`${mount.source}\` \u2192 \`${mount.target}\`${readOnly}`);
+    byProject.set(project, bucket);
+  }
+  if (byProject.size === 0) return [];
+  const out = ["  Workspace mounts (edit these on the host, then re-apply):"];
+  for (const [project, entries] of byProject) {
+    out.push(`  - ${project}:`);
+    out.push(...entries);
+  }
+  return out;
+}
+function parseBindMount(spec) {
+  const parts = spec.split(":");
+  if (parts.length < 2) return null;
+  const source = parts[0];
+  let mode;
+  const last = parts[parts.length - 1];
+  if (parts.length >= 3 && !last.includes("/")) {
+    mode = parts.pop();
+  }
+  return { source, target: parts.slice(1).join(":"), mode };
+}
+function projectOf(source) {
+  const segments = source.split("/");
+  if (segments[0] !== "projects" || segments.length < 2) return null;
+  return segments[1] ?? null;
+}
 function agentsMdInputFromCreateOptions(opts, featureDisplayMap2, manifestLoader, hostPort = 80) {
   const features = [];
   for (const [ref, userOptions] of Object.entries(opts.features ?? {})) {
@@ -8355,11 +8421,13 @@ ${sectionLine(label)}
   warnOnDeprecatedFeatureRefs(parsed.config.features, globalConfig, logger);
   const envPath = containerEnvPath(opts.name, home);
   await ensureEnvGitignored(containerConfigsDir(home));
-  const envVars = expandEnvRefs({
-    ...readEnvFile(globalEnvPath(home)),
-    ...readEnvFile(envPath),
-    ...opts.env ?? {}
-  });
+  const envVars = expandEnvRefs(
+    mergeEnvLayers(
+      readEnvFile(globalEnvPath(home)),
+      readEnvFile(envPath),
+      opts.env ?? {}
+    )
+  );
   const catalog = await loadComponentCatalog();
   const repoTokens = resolveRepoTokens(parsed.config, catalog, envVars);
   const featureTokenPrompt = opts.featureTokenPrompt ?? defaultFeatureTokenPrompt;
@@ -9070,7 +9138,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "1.38.19" : "dev";
+    CLI_VERSION = true ? "1.39.0" : "dev";
   }
 });
 
@@ -9145,164 +9213,6 @@ var init_apply2 = __esm({
   }
 });
 
-// src/commands/completion.ts
-import { defineCommand as defineCommand9 } from "citty";
-function renderCompletionScript(shell) {
-  if (shell === "bash") {
-    return [
-      "# bash completion for monoceros",
-      "# install: source this file from .bashrc, e.g.",
-      "#   monoceros completion bash > ~/.bash_completion.d/monoceros",
-      '#   echo "source ~/.bash_completion.d/monoceros" >> ~/.bashrc',
-      "#",
-      "# The work is done by `monoceros __complete --line --point`; this",
-      "# shell wrapper only forwards the cursor view.",
-      "",
-      "_monoceros() {",
-      "  local IFS=$'\\n'",
-      "  local candidates",
-      '  candidates=$(monoceros __complete --line "$COMP_LINE" --point "$COMP_POINT" 2>/dev/null)',
-      '  local cur="${COMP_WORDS[COMP_CWORD]}"',
-      '  COMPREPLY=( $(compgen -W "$candidates" -- "$cur") )',
-      "  # Suppress the trailing space when bash narrowed the candidate",
-      "  # set to a single token that ends with `=` \u2014 those are value-",
-      "  # flags (`--with-features=`, `--with-ports=`, \u2026) where the user types the",
-      "  # value immediately after.",
-      '  if [[ ${#COMPREPLY[@]} -eq 1 && "${COMPREPLY[0]}" == *= ]]; then',
-      "    compopt -o nospace",
-      "  fi",
-      "}",
-      "complete -F _monoceros monoceros",
-      ""
-    ].join("\n");
-  }
-  if (shell === "pwsh") {
-    return [
-      "# PowerShell completion for monoceros",
-      "# install: dot-source this file from your $PROFILE, e.g.",
-      "#   monoceros completion pwsh > $HOME/.config/monoceros/completion.ps1",
-      "#   Add-Content $PROFILE '. $HOME/.config/monoceros/completion.ps1'",
-      "#",
-      "# The work is done by `monoceros __complete --line --point`; this",
-      "# shell wrapper only forwards the cursor view.",
-      "",
-      "Register-ArgumentCompleter -Native -CommandName monoceros -ScriptBlock {",
-      "    param($wordToComplete, $commandAst, $cursorPosition)",
-      "    $line = $commandAst.Extent.Text",
-      "    $point = $cursorPosition - $commandAst.Extent.StartOffset",
-      "    if ($point -lt 0) { $point = 0 }",
-      "    $raw = & monoceros __complete --line $line --point $point 2>$null",
-      "    if (-not $raw) { return }",
-      '    $raw -split "`n" |',
-      '        Where-Object { $_.Length -gt 0 -and $_ -like "$wordToComplete*" } |',
-      '        ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_) }',
-      "}",
-      ""
-    ].join("\n");
-  }
-  return [
-    "#compdef monoceros",
-    "# zsh completion for monoceros",
-    "# install: drop this file somewhere on your $fpath as `_monoceros`,",
-    "# then start a new shell (or run `compinit`). Example:",
-    '#   monoceros completion zsh > "${fpath[1]}/_monoceros"',
-    "#",
-    "# The work is done by `monoceros __complete --line --point`; this",
-    "# shell wrapper only forwards the cursor view.",
-    "",
-    "_monoceros() {",
-    '  local line="$BUFFER"',
-    '  local point="$CURSOR"',
-    "  local -a candidates with_eq without_eq",
-    '  candidates=("${(@f)$(monoceros __complete --line "$line" --point "$point" 2>/dev/null)}")',
-    '  candidates=("${(@)candidates:#}")',
-    '  # Split candidates into "ends with `=`" (value-flags \u2014 no suffix',
-    "  # space wanted because the user types the value immediately) and",
-    '  # "everything else" (positional values, boolean flags \u2014 default',
-    "  # space behaviour).",
-    '  for cand in "${candidates[@]}"; do',
-    '    if [[ "$cand" == *= ]]; then',
-    '      with_eq+=("$cand")',
-    "    else",
-    '      without_eq+=("$cand")',
-    "    fi",
-    "  done",
-    "  (( ${#with_eq[@]} ))    && compadd -S '' -- \"${with_eq[@]}\"",
-    '  (( ${#without_eq[@]} )) && compadd      -- "${without_eq[@]}"',
-    "}",
-    "",
-    '_monoceros "$@"',
-    ""
-  ].join("\n");
-}
-var SHELLS, completionCommand;
-var init_completion = __esm({
-  "src/commands/completion.ts"() {
-    "use strict";
-    SHELLS = ["bash", "zsh", "pwsh"];
-    completionCommand = defineCommand9({
-      meta: {
-        name: "completion",
-        group: "tooling",
-        // Hidden from `monoceros --help`: the install scripts wire up
-        // completion automatically; manual setup is documented at
-        // getmonoceros.build/docs/reference/utilities/completion. Still runnable directly.
-        hidden: true,
-        description: "Print a shell completion script for bash, zsh or PowerShell to stdout. Pipe the output into a file your shell loads at startup. The install scripts (install.sh / install.ps1) call this automatically."
-      },
-      args: {
-        shell: {
-          type: "positional",
-          description: "Target shell. One of: 'bash', 'zsh', 'pwsh'.",
-          required: true
-        }
-      },
-      run({ args }) {
-        const shell = args.shell;
-        if (shell !== "bash" && shell !== "zsh" && shell !== "pwsh") {
-          process.stderr.write(
-            `Unknown shell: ${JSON.stringify(shell)}. Supported: ${SHELLS.join(", ")}.
-`
-          );
-          process.exit(2);
-        }
-        process.stdout.write(renderCompletionScript(shell));
-      }
-    });
-  }
-});
-
-// src/commands/__bridge.ts
-import { defineCommand as defineCommand10 } from "citty";
-var __bridgeCommand;
-var init_bridge = __esm({
-  "src/commands/__bridge.ts"() {
-    "use strict";
-    init_bridge_daemon();
-    __bridgeCommand = defineCommand10({
-      meta: {
-        name: "__bridge",
-        group: "internal",
-        hidden: true,
-        description: "Internal: host-side browser-bridge daemon (background)."
-      },
-      args: {
-        root: {
-          type: "positional",
-          description: "Materialized container root ($MONOCEROS_HOME/container/<name>/).",
-          required: true
-        }
-      },
-      async run({ args }) {
-        try {
-          await runBridgeDaemon({ root: args.root });
-        } catch {
-        }
-      }
-    });
-  }
-});
-
 // src/config/launch-config.ts
 import { promises as fs16 } from "fs";
 import path25 from "path";
@@ -9501,6 +9411,14 @@ function tokenize(text) {
 function isShellWhitespace(ch) {
   return ch === " " || ch === "	";
 }
+function staticSource(fn) {
+  pwshMeta.set(fn, { static: true });
+  return fn;
+}
+function dynamicSource(kind, fn) {
+  pwshMeta.set(fn, { static: false, kind });
+  return fn;
+}
 function dispatchCommand(spec, argTokens, ctx) {
   const dashDashIdx = argTokens.indexOf("--");
   const preDash = dashDashIdx < 0 ? argTokens : argTokens.slice(0, dashDashIdx);
@@ -9747,7 +9665,36 @@ async function resolveFeatureRefForCompletion(token) {
   const f = c.file.contributes.features?.[0];
   return f?.ref;
 }
-var WORKSPACE_DIR_SKIP, PROJECTS_DIR_MAX_DEPTH, ALL_COMMANDS, containerName, COMMAND_SPECS, COMPLETION_COMMAND_SPEC_KEYS;
+async function describeSource(src) {
+  if (!src) return {};
+  const meta = pwshMeta.get(src);
+  if (!meta) return {};
+  if (meta.static) return { values: await src(EMPTY_CTX) };
+  return { kind: meta.kind };
+}
+async function buildPwshCompletionModel() {
+  const specs = {};
+  for (const [name, spec] of Object.entries(COMMAND_SPECS)) {
+    const posSources = spec.positionals ?? [];
+    const positionalCount = spec.positionalCount ?? posSources.length;
+    const positionals = [];
+    for (const src of posSources) positionals.push(await describeSource(src));
+    const flags = {};
+    for (const [flag, fspec] of Object.entries(spec.flags ?? {})) {
+      const entry2 = {
+        type: fspec.type,
+        aliases: fspec.aliases ?? []
+      };
+      if (fspec.type === "value" && fspec.values) {
+        entry2.value = await describeSource(fspec.values);
+      }
+      flags[flag] = entry2;
+    }
+    specs[name] = { positionals, positionalCount, flags };
+  }
+  return { commands: [...ALL_COMMANDS], specs };
+}
+var pwshMeta, WORKSPACE_DIR_SKIP, PROJECTS_DIR_MAX_DEPTH, ALL_COMMANDS, containerName, appCandidates, appOrServiceCandidates, targetCandidates, runInDirs, languageValues, serviceValues, featureValues, providerValues, shellValues, openToolValues, COMMAND_SPECS, COMPLETION_COMMAND_SPEC_KEYS, EMPTY_CTX;
 var init_resolve = __esm({
   "src/completion/resolve.ts"() {
     "use strict";
@@ -9760,6 +9707,7 @@ var init_resolve = __esm({
     init_catalog();
     init_schema();
     init_open();
+    pwshMeta = /* @__PURE__ */ new WeakMap();
     WORKSPACE_DIR_SKIP = /* @__PURE__ */ new Set(["node_modules"]);
     PROJECTS_DIR_MAX_DEPTH = 4;
     ALL_COMMANDS = [
@@ -9796,7 +9744,26 @@ var init_resolve = __esm({
       "share",
       "completion"
     ];
-    containerName = (ctx) => listContainerNames(ctx);
+    containerName = dynamicSource(
+      "containerName",
+      (ctx) => listContainerNames(ctx)
+    );
+    appCandidates = dynamicSource("app", (ctx) => listAppCandidates(ctx));
+    appOrServiceCandidates = dynamicSource(
+      "appOrService",
+      (ctx) => listAppOrServiceCandidates(ctx)
+    );
+    targetCandidates = dynamicSource(
+      "target",
+      (ctx) => listTargetCandidates(ctx)
+    );
+    runInDirs = dynamicSource("runInDir", (ctx) => listRunInDirs(ctx));
+    languageValues = staticSource(() => listLanguageNames());
+    serviceValues = staticSource(() => listServiceNames());
+    featureValues = staticSource(() => listFeatureComponents());
+    providerValues = staticSource(() => listProviders());
+    shellValues = staticSource(() => listShellNames());
+    openToolValues = staticSource(() => [...OPEN_TOOLS]);
     COMMAND_SPECS = {
       init: {
         // First positional is a FRESH name → no suggestion source, but
@@ -9805,12 +9772,9 @@ var init_resolve = __esm({
         // flag suggestions.
         positionalCount: 1,
         flags: {
-          "--with-languages": { type: "value", values: () => listLanguageNames() },
-          "--with-features": {
-            type: "value",
-            values: () => listFeatureComponents()
-          },
-          "--with-services": { type: "value", values: () => listServiceNames() },
+          "--with-languages": { type: "value", values: languageValues },
+          "--with-features": { type: "value", values: featureValues },
+          "--with-services": { type: "value", values: serviceValues },
           "--with-apt-packages": { type: "value" },
           "--with-repos": { type: "value" },
           "--with-ports": { type: "value" }
@@ -9820,7 +9784,7 @@ var init_resolve = __esm({
         positionals: [containerName],
         flags: {
           "--yes": { type: "boolean", aliases: ["-y"] },
-          "--open": { type: "value", values: () => [...OPEN_TOOLS] }
+          "--open": { type: "value", values: openToolValues }
         }
       },
       upgrade: {
@@ -9837,39 +9801,39 @@ var init_resolve = __esm({
         }
       },
       shell: { positionals: [containerName] },
-      open: { positionals: [containerName, () => [...OPEN_TOOLS]] },
+      open: { positionals: [containerName, openToolValues] },
       run: {
         positionals: [containerName],
-        flags: { "--in": { type: "value", values: (ctx) => listRunInDirs(ctx) } }
+        flags: { "--in": { type: "value", values: runInDirs } }
       },
       logs: {
-        positionals: [containerName, (ctx) => listAppCandidates(ctx)],
+        positionals: [containerName, appCandidates],
         flags: {
-          "--target": { type: "value", values: (ctx) => listTargetCandidates(ctx) }
+          "--target": { type: "value", values: targetCandidates }
         }
       },
       start: {
-        positionals: [containerName, (ctx) => listAppCandidates(ctx)],
+        positionals: [containerName, appCandidates],
         flags: {
-          "--target": { type: "value", values: (ctx) => listTargetCandidates(ctx) },
-          "--open": { type: "value", values: () => [...OPEN_TOOLS] }
+          "--target": { type: "value", values: targetCandidates },
+          "--open": { type: "value", values: openToolValues }
         }
       },
       stop: {
-        positionals: [containerName, (ctx) => listAppCandidates(ctx)],
+        positionals: [containerName, appCandidates],
         flags: {
-          "--target": { type: "value", values: (ctx) => listTargetCandidates(ctx) }
+          "--target": { type: "value", values: targetCandidates }
         }
       },
       status: {
-        positionals: [containerName, (ctx) => listAppOrServiceCandidates(ctx)]
+        positionals: [containerName, appOrServiceCandidates]
       },
       "list-apps": { positionals: [containerName] },
       "add-language": {
-        positionals: [containerName, () => listLanguageNames()]
+        positionals: [containerName, languageValues]
       },
       "add-service": {
-        positionals: [containerName, () => listServiceNames()]
+        positionals: [containerName, serviceValues]
       },
       "add-apt-packages": {
         positionals: [containerName],
@@ -9877,7 +9841,7 @@ var init_resolve = __esm({
         // freeform package names — no useful suggestion list
       },
       "add-feature": {
-        positionals: [containerName, () => listFeatureComponents()],
+        positionals: [containerName, featureValues],
         flags: { "--yes": { type: "boolean", aliases: ["-y"] } },
         innerArgs: (ctx) => listFeatureOptionInnerArgs(ctx)
       },
@@ -9888,7 +9852,7 @@ var init_resolve = __esm({
           "--path": { type: "value" },
           "--git-name": { type: "value" },
           "--git-email": { type: "value" },
-          "--provider": { type: "value", values: () => listProviders() },
+          "--provider": { type: "value", values: providerValues },
           "--yes": { type: "boolean", aliases: ["-y"] }
         }
       },
@@ -9901,17 +9865,17 @@ var init_resolve = __esm({
         innerArgs: () => []
       },
       "remove-language": {
-        positionals: [containerName, () => listLanguageNames()]
+        positionals: [containerName, languageValues]
       },
       "remove-service": {
-        positionals: [containerName, () => listServiceNames()]
+        positionals: [containerName, serviceValues]
       },
       "remove-apt-packages": {
         positionals: [containerName],
         innerArgs: () => []
       },
       "remove-feature": {
-        positionals: [containerName, () => listFeatureComponents()],
+        positionals: [containerName, featureValues],
         flags: { "--yes": { type: "boolean", aliases: ["-y"] } }
       },
       "remove-from-url": { positionals: [containerName] },
@@ -9927,17 +9891,17 @@ var init_resolve = __esm({
         innerArgs: () => []
       },
       tunnel: {
-        positionals: [containerName, () => listServiceNames()],
+        positionals: [containerName, serviceValues],
         flags: {
           "--local-port": { type: "value" },
           "--local-address": { type: "value" }
         }
       },
       share: {
-        positionals: [containerName, (ctx) => listAppCandidates(ctx)]
+        positionals: [containerName, appCandidates]
       },
       completion: {
-        positionals: [() => listShellNames()]
+        positionals: [shellValues]
       },
       "list-components": {},
       restore: {
@@ -9948,6 +9912,401 @@ var init_resolve = __esm({
       }
     };
     COMPLETION_COMMAND_SPEC_KEYS = Object.keys(COMMAND_SPECS);
+    EMPTY_CTX = { prev: [], current: "", opts: {} };
+  }
+});
+
+// src/commands/completion.ts
+import { defineCommand as defineCommand9 } from "citty";
+function renderBashScript() {
+  return [
+    "# bash completion for monoceros",
+    "# install: source this file from .bashrc, e.g.",
+    "#   monoceros completion bash > ~/.bash_completion.d/monoceros",
+    '#   echo "source ~/.bash_completion.d/monoceros" >> ~/.bashrc',
+    "#",
+    "# The work is done by `monoceros __complete --line --point`; this",
+    "# shell wrapper only forwards the cursor view.",
+    "",
+    "_monoceros() {",
+    "  local IFS=$'\\n'",
+    "  local candidates",
+    '  candidates=$(monoceros __complete --line "$COMP_LINE" --point "$COMP_POINT" 2>/dev/null)',
+    '  local cur="${COMP_WORDS[COMP_CWORD]}"',
+    '  COMPREPLY=( $(compgen -W "$candidates" -- "$cur") )',
+    "  # Suppress the trailing space when bash narrowed the candidate",
+    "  # set to a single token that ends with `=` \u2014 those are value-",
+    "  # flags (`--with-features=`, `--with-ports=`, \u2026) where the user types the",
+    "  # value immediately after.",
+    '  if [[ ${#COMPREPLY[@]} -eq 1 && "${COMPREPLY[0]}" == *= ]]; then',
+    "    compopt -o nospace",
+    "  fi",
+    "}",
+    "complete -F _monoceros monoceros",
+    ""
+  ].join("\n");
+}
+function renderZshScript() {
+  return [
+    "#compdef monoceros",
+    "# zsh completion for monoceros",
+    "# install: drop this file somewhere on your $fpath as `_monoceros`,",
+    "# then start a new shell (or run `compinit`). Example:",
+    '#   monoceros completion zsh > "${fpath[1]}/_monoceros"',
+    "#",
+    "# The work is done by `monoceros __complete --line --point`; this",
+    "# shell wrapper only forwards the cursor view.",
+    "",
+    "_monoceros() {",
+    '  local line="$BUFFER"',
+    '  local point="$CURSOR"',
+    "  local -a candidates with_eq without_eq",
+    '  candidates=("${(@f)$(monoceros __complete --line "$line" --point "$point" 2>/dev/null)}")',
+    '  candidates=("${(@)candidates:#}")',
+    '  # Split candidates into "ends with `=`" (value-flags \u2014 no suffix',
+    "  # space wanted because the user types the value immediately) and",
+    '  # "everything else" (positional values, boolean flags \u2014 default',
+    "  # space behaviour).",
+    '  for cand in "${candidates[@]}"; do',
+    '    if [[ "$cand" == *= ]]; then',
+    '      with_eq+=("$cand")',
+    "    else",
+    '      without_eq+=("$cand")',
+    "    fi",
+    "  done",
+    "  (( ${#with_eq[@]} ))    && compadd -S '' -- \"${with_eq[@]}\"",
+    '  (( ${#without_eq[@]} )) && compadd      -- "${without_eq[@]}"',
+    "}",
+    "",
+    '_monoceros "$@"',
+    ""
+  ].join("\n");
+}
+async function renderPwshScript() {
+  const model = await buildPwshCompletionModel();
+  const json = JSON.stringify(model);
+  return `# PowerShell completion for monoceros (self-contained).
+# install: dot-source this file from your $PROFILE, e.g.
+#   monoceros completion pwsh > $HOME/.config/monoceros/completion.ps1
+#   Add-Content $PROFILE '. $HOME/.config/monoceros/completion.ps1'
+#
+# Unlike the bash/zsh wrappers this never calls back into the CLI per
+# Tab (on Windows that would be a WSL round-trip each keystroke).
+# The static candidates are baked in below; the dynamic ones (container
+# names, apps, workspace dirs, launch targets) are read straight off the
+# host filesystem via the %USERPROFILE%\\.monoceros symlink.
+
+$global:MonocerosModel = @'
+${json}
+'@ | ConvertFrom-Json
+
+function __Monoceros_Home {
+  if ($env:MONOCEROS_HOME) { return $env:MONOCEROS_HOME }
+  return (Join-Path $env:USERPROFILE '.monoceros')
+}
+
+function __Monoceros_ContainerNames {
+  $dir = Join-Path (__Monoceros_Home) 'container-configs'
+  if (-not (Test-Path -LiteralPath $dir)) { return @() }
+  @(Get-ChildItem -LiteralPath $dir -Filter '*.yml' -File -ErrorAction SilentlyContinue |
+      ForEach-Object { $_.BaseName } | Sort-Object)
+}
+
+# Recursively collect directory paths under $at, relative to it, capped
+# at $maxDepth. Skips dot-dirs, node_modules, and symlinked dirs \u2014 the
+# host-side mirror of collectDirs() in completion/resolve.ts.
+function __Monoceros_CollectDirs($maxDepth, $acc, $at, $rel, $depth) {
+  $entries = Get-ChildItem -LiteralPath $at -Directory -Force -ErrorAction SilentlyContinue
+  foreach ($e in $entries) {
+    if ($e.Name.StartsWith('.')) { continue }
+    if ($e.Name -eq 'node_modules') { continue }
+    if ($e.LinkType) { continue }
+    $childRel = if ($rel) { "$rel/$($e.Name)" } else { $e.Name }
+    [void]$acc.Add($childRel)
+    if (($depth + 1) -lt $maxDepth) {
+      __Monoceros_CollectDirs $maxDepth $acc $e.FullName $childRel ($depth + 1)
+    }
+  }
+}
+
+function __Monoceros_WorkspaceDirs($name) {
+  if (-not $name) { return @() }
+  $root = Join-Path (Join-Path (__Monoceros_Home) 'container') $name
+  if (-not (Test-Path -LiteralPath $root)) { return @() }
+  $acc = New-Object System.Collections.Generic.List[string]
+  __Monoceros_CollectDirs 1 $acc $root '' 0
+  $projects = Join-Path $root 'projects'
+  if (Test-Path -LiteralPath $projects) {
+    $pacc = New-Object System.Collections.Generic.List[string]
+    __Monoceros_CollectDirs 4 $pacc $projects '' 0
+    foreach ($p in $pacc) { [void]$acc.Add("projects/$p") }
+  }
+  @($acc | Sort-Object -Unique)
+}
+
+# App-relative paths under projects/ carrying .monoceros/launch.json.
+function __Monoceros_WalkApps($at, $rel, $depth, $acc) {
+  if ($rel -and (Test-Path -LiteralPath (Join-Path (Join-Path $at '.monoceros') 'launch.json'))) {
+    [void]$acc.Add($rel)
+  }
+  if ($depth -ge 4) { return }
+  $entries = Get-ChildItem -LiteralPath $at -Directory -Force -ErrorAction SilentlyContinue
+  foreach ($e in $entries) {
+    if ($e.Name.StartsWith('.')) { continue }
+    $childRel = if ($rel) { "$rel/$($e.Name)" } else { $e.Name }
+    __Monoceros_WalkApps $e.FullName $childRel ($depth + 1) $acc
+  }
+}
+
+function __Monoceros_Apps($name) {
+  if (-not $name) { return @() }
+  $root = Join-Path (Join-Path (Join-Path (__Monoceros_Home) 'container') $name) 'projects'
+  if (-not (Test-Path -LiteralPath $root)) { return @() }
+  $acc = New-Object System.Collections.Generic.List[string]
+  __Monoceros_WalkApps $root '' 0 $acc
+  @($acc | Sort-Object)
+}
+
+function __Monoceros_Targets($name, $app) {
+  if (-not $name -or -not $app) { return @() }
+  $appPath = $app -replace '/', '\\'
+  $file = Join-Path (Join-Path (Join-Path (Join-Path (__Monoceros_Home) 'container') $name) 'projects') (Join-Path $appPath (Join-Path '.monoceros' 'launch.json'))
+  if (-not (Test-Path -LiteralPath $file)) { return @() }
+  try { $json = Get-Content -LiteralPath $file -Raw | ConvertFrom-Json } catch { return @() }
+  $list = if ($json.targets) { $json.targets } elseif ($json.configurations) { $json.configurations } else { $null }
+  if (-not $list) { return @() }
+  @($list | ForEach-Object { $_.name } | Where-Object { $_ })
+}
+
+# The positional tokens (skipping flags) after \`monoceros <cmd>\`.
+function __Monoceros_Positionals($argTokens) {
+  $out = @()
+  foreach ($t in $argTokens) {
+    if ($t -eq '--') { break }
+    if ($t.StartsWith('-')) { continue }
+    $out += $t
+  }
+  ,$out
+}
+
+# Resolve a value descriptor ({values:[...]} static, or {kind:...}
+# dynamic) to its candidate list.
+function __Monoceros_Values($desc, $argTokens) {
+  if (-not $desc) { return @() }
+  if ($null -ne $desc.values) { return @($desc.values) }
+  if ($desc.kind) {
+    $pos = __Monoceros_Positionals $argTokens
+    $name = if ($pos.Count -gt 0) { $pos[0] } else { $null }
+    $app = if ($pos.Count -gt 1) { $pos[1] } else { $null }
+    switch ($desc.kind) {
+      'containerName' { return (__Monoceros_ContainerNames) }
+      'app'           { return (__Monoceros_Apps $name) }
+      'appOrService'  { return (__Monoceros_Apps $name) }
+      'runInDir'      { return (__Monoceros_WorkspaceDirs $name) }
+      'target'        { return (__Monoceros_Targets $name $app) }
+    }
+  }
+  return @()
+}
+
+# Comma-aware prefix filter \u2014 mirrors resolveValues() so
+# \`--with-features=a,b<TAB>\` completes after the last comma.
+function __Monoceros_Filter($values, $fragment) {
+  if (-not $values) { return @() }
+  $commaIdx = $fragment.LastIndexOf(',')
+  if ($commaIdx -lt 0) {
+    return @($values | Where-Object { $_.StartsWith($fragment) })
+  }
+  $prefix = $fragment.Substring(0, $commaIdx + 1)
+  $tail = $fragment.Substring($commaIdx + 1)
+  @($values | Where-Object { $_.StartsWith($tail) } | ForEach-Object { "$prefix$_" })
+}
+
+function __Monoceros_LookupFlag($flags, $token) {
+  if (-not $flags) { return $null }
+  $direct = $flags.PSObject.Properties[$token]
+  if ($direct) { return $direct.Value }
+  foreach ($p in $flags.PSObject.Properties) {
+    if ($p.Value.aliases -contains $token) { return $p.Value }
+  }
+  return $null
+}
+
+# Value flags are offered with a trailing '=' (so no space is wanted
+# after Tab); boolean flags and aliases as bare names.
+function __Monoceros_FlagNames($flags, $fragment) {
+  if (-not $flags) { return @() }
+  $names = @()
+  foreach ($p in $flags.PSObject.Properties) {
+    if ($p.Value.type -eq 'value') { $names += "$($p.Name)=" } else { $names += $p.Name }
+    foreach ($a in $p.Value.aliases) { $names += $a }
+  }
+  @($names | Where-Object { $_.StartsWith($fragment) })
+}
+
+function __Monoceros_CountPositionals($argTokens, $flags) {
+  $count = 0
+  for ($i = 0; $i -lt $argTokens.Count; $i++) {
+    $t = $argTokens[$i]
+    if ($t -like '--*' -and $t.Contains('=')) { continue }
+    if ($t.StartsWith('-')) {
+      $flag = __Monoceros_LookupFlag $flags $t
+      if ($flag -and $flag.type -eq 'value' -and ($i + 1) -lt $argTokens.Count) { $i++ }
+      continue
+    }
+    $count++
+  }
+  $count
+}
+
+function __Monoceros_Emit($candidates) {
+  @($candidates | ForEach-Object {
+    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+  })
+}
+
+Register-ArgumentCompleter -Native -CommandName @('monoceros', 'monoceros.cmd', 'monoceros.exe') -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+
+  $model = $global:MonocerosModel
+  $current = if ($wordToComplete) { $wordToComplete } else { '' }
+
+  # Tokens already complete on the line. When the current word is
+  # non-empty it is the last command element \u2014 drop it from "prev".
+  $elements = @($commandAst.CommandElements | ForEach-Object { $_.Extent.Text })
+  if ($current -ne '' -and $elements.Count -gt 0 -and $elements[-1] -eq $current) {
+    $prev = if ($elements.Count -gt 1) { @($elements[0..($elements.Count - 2)]) } else { @() }
+  } else {
+    $prev = $elements
+  }
+  # Strip the program name (prev[0]).
+  $tokens = if ($prev.Count -gt 1) { @($prev[1..($prev.Count - 1)]) } else { @() }
+
+  # No subcommand yet \u2192 complete the subcommand list.
+  if ($tokens.Count -eq 0) {
+    return (__Monoceros_Emit (@($model.commands | Where-Object { $_.StartsWith($current) })))
+  }
+
+  $command = $tokens[0]
+  $spec = $model.specs.PSObject.Properties[$command]
+  if (-not $spec) { return }
+  $spec = $spec.Value
+  $argTokens = if ($tokens.Count -gt 1) { @($tokens[1..($tokens.Count - 1)]) } else { @() }
+
+  # Everything after \`--\` is the inner command \u2014 not ours to complete.
+  if ($argTokens -contains '--') { return }
+
+  # Case A: current is \`--flag=fragment\` \u2192 that flag's values.
+  if ($current -like '--*' -and $current.Contains('=')) {
+    $eq = $current.IndexOf('=')
+    $flagName = $current.Substring(0, $eq)
+    $frag = $current.Substring($eq + 1)
+    $flag = if ($spec.flags) { $spec.flags.PSObject.Properties[$flagName] } else { $null }
+    if (-not $flag -or $flag.Value.type -ne 'value') { return }
+    $vals = __Monoceros_Values $flag.Value.value $argTokens
+    return (__Monoceros_Emit (@(__Monoceros_Filter $vals $frag | ForEach-Object { "$flagName=$_" })))
+  }
+
+  # Case B: current is an incomplete flag name.
+  if ($current.StartsWith('-')) {
+    return (__Monoceros_Emit (__Monoceros_FlagNames $spec.flags $current))
+  }
+
+  # Case C: previous token was a value flag expecting a value.
+  $lastPrev = if ($argTokens.Count -gt 0) { $argTokens[-1] } else { $null }
+  if ($lastPrev -and $lastPrev -like '--*' -and -not $lastPrev.Contains('=')) {
+    $flag = if ($spec.flags) { $spec.flags.PSObject.Properties[$lastPrev] } else { $null }
+    if ($flag -and $flag.Value.type -eq 'value' -and $flag.Value.value) {
+      $vals = __Monoceros_Values $flag.Value.value $argTokens
+      return (__Monoceros_Emit (__Monoceros_Filter $vals $current))
+    }
+  }
+
+  # Case D: a positional slot.
+  $positionalIdx = __Monoceros_CountPositionals $argTokens $spec.flags
+  $positionals = @($spec.positionals)
+  $expected = $spec.positionalCount
+  if ($positionalIdx -lt $positionals.Count) {
+    $vals = __Monoceros_Values $positionals[$positionalIdx] $argTokens
+    return (__Monoceros_Emit (__Monoceros_Filter $vals $current))
+  }
+  if ($positionalIdx -ge $expected) {
+    return (__Monoceros_Emit (__Monoceros_FlagNames $spec.flags $current))
+  }
+}
+`;
+}
+async function renderCompletionScript(shell) {
+  if (shell === "bash") return renderBashScript();
+  if (shell === "zsh") return renderZshScript();
+  return renderPwshScript();
+}
+var SHELLS, completionCommand;
+var init_completion = __esm({
+  "src/commands/completion.ts"() {
+    "use strict";
+    init_resolve();
+    SHELLS = ["bash", "zsh", "pwsh"];
+    completionCommand = defineCommand9({
+      meta: {
+        name: "completion",
+        group: "tooling",
+        // Hidden from `monoceros --help`: the install scripts wire up
+        // completion automatically; manual setup is documented at
+        // getmonoceros.build/docs/reference/utilities/completion. Still runnable directly.
+        hidden: true,
+        description: "Print a shell completion script for bash, zsh or PowerShell to stdout. Pipe the output into a file your shell loads at startup. The install scripts (install.sh / install.ps1) call this automatically."
+      },
+      args: {
+        shell: {
+          type: "positional",
+          description: "Target shell. One of: 'bash', 'zsh', 'pwsh'.",
+          required: true
+        }
+      },
+      async run({ args }) {
+        const shell = args.shell;
+        if (shell !== "bash" && shell !== "zsh" && shell !== "pwsh") {
+          process.stderr.write(
+            `Unknown shell: ${JSON.stringify(shell)}. Supported: ${SHELLS.join(", ")}.
+`
+          );
+          process.exit(2);
+        }
+        process.stdout.write(await renderCompletionScript(shell));
+      }
+    });
+  }
+});
+
+// src/commands/__bridge.ts
+import { defineCommand as defineCommand10 } from "citty";
+var __bridgeCommand;
+var init_bridge = __esm({
+  "src/commands/__bridge.ts"() {
+    "use strict";
+    init_bridge_daemon();
+    __bridgeCommand = defineCommand10({
+      meta: {
+        name: "__bridge",
+        group: "internal",
+        hidden: true,
+        description: "Internal: host-side browser-bridge daemon (background)."
+      },
+      args: {
+        root: {
+          type: "positional",
+          description: "Materialized container root ($MONOCEROS_HOME/container/<name>/).",
+          required: true
+        }
+      },
+      async run({ args }) {
+        try {
+          await runBridgeDaemon({ root: args.root });
+        } catch {
+        }
+      }
+    });
   }
 });