@getmonoceros/workbench 1.22.1 → 1.23.0

package/dist/bin.js

@@ -2457,9 +2457,156 @@ var init_claude_settings = __esm({
   }
 });
 
-// src/create/scaffold.ts
-import { existsSync as existsSync6, promises as fs7 } from "fs";
+// src/create/opencode-config.ts
+import { existsSync as existsSync6, promises as fsp3 } from "fs";
 import path9 from "path";
+import { consola } from "consola";
+function parseOpencodeModel(model) {
+  const idx = model.indexOf("/");
+  if (idx <= 0 || idx === model.length - 1) return void 0;
+  return { provider: model.slice(0, idx), modelId: model.slice(idx + 1) };
+}
+async function writeOpencodeConfig(targetDir, containerName2, features) {
+  if (!features) return;
+  const entry2 = Object.entries(features).find(
+    ([ref]) => matchMonocerosFeature(ref)?.name === "opencode"
+  );
+  if (!entry2) return;
+  const options = entry2[1] ?? {};
+  const str = (key) => typeof options[key] === "string" ? options[key].trim() : "";
+  const model = str("model");
+  const apiToken = str("apiToken");
+  const npm = str("npm");
+  const baseUrl = str("baseUrl");
+  const file = path9.join(
+    targetDir,
+    "home",
+    ".config",
+    "opencode",
+    "opencode.json"
+  );
+  await fsp3.mkdir(path9.dirname(file), { recursive: true });
+  let config = {};
+  if (existsSync6(file)) {
+    try {
+      const txt = await fsp3.readFile(file, "utf8");
+      if (txt.trim()) {
+        const parsed2 = JSON.parse(txt);
+        if (typeof parsed2 === "object" && parsed2 !== null) {
+          config = parsed2;
+        }
+      }
+    } catch {
+      config = {};
+    }
+  }
+  if (typeof config.$schema !== "string") {
+    config.$schema = "https://opencode.ai/config.json";
+  }
+  const workspaceRoot = `/workspaces/${containerName2}`;
+  const managedInstructions = [
+    `${workspaceRoot}/AGENTS.md`,
+    `${workspaceRoot}/.monoceros/commands.md`
+  ];
+  const existingInstructions = Array.isArray(config.instructions) ? config.instructions.filter(
+    (i) => typeof i === "string"
+  ) : [];
+  config.instructions = [
+    ...managedInstructions,
+    ...existingInstructions.filter((i) => !managedInstructions.includes(i))
+  ];
+  if (model) {
+    config.model = model;
+  }
+  const parsed = parseOpencodeModel(model);
+  if (npm) {
+    if (!parsed) {
+      consola.warn(
+        "[opencode] `npm` is set but `model` is empty or has no provider prefix \u2014 set `model: <provider>/<model-id>` to configure a custom provider."
+      );
+    } else {
+      writeCustomProvider(config, parsed, { npm, baseUrl, apiToken });
+    }
+  } else if (parsed) {
+    if (KNOWN_APIKEY_PROVIDERS.includes(parsed.provider)) {
+      if (apiToken) {
+        writeHostedApiKey(config, parsed.provider, apiToken);
+      }
+    } else {
+      consola.warn(
+        `[opencode] '${parsed.provider}' is not a known single-key provider (${KNOWN_APIKEY_PROVIDERS.join(", ")}). For a custom or local provider (e.g. Ollama), set the \`npm\` and \`baseUrl\` options on the opencode feature.`
+      );
+    }
+  }
+  await fsp3.writeFile(file, `${JSON.stringify(config, null, 2)}
+`);
+}
+function providersOf(config) {
+  if (typeof config.provider === "object" && config.provider !== null) {
+    return config.provider;
+  }
+  const fresh = {};
+  config.provider = fresh;
+  return fresh;
+}
+function providerEntry(providers, id) {
+  if (typeof providers[id] === "object" && providers[id] !== null) {
+    return providers[id];
+  }
+  const fresh = {};
+  providers[id] = fresh;
+  return fresh;
+}
+function optionsOf(entry2) {
+  if (typeof entry2.options === "object" && entry2.options !== null) {
+    return entry2.options;
+  }
+  const fresh = {};
+  entry2.options = fresh;
+  return fresh;
+}
+function writeHostedApiKey(config, provider, apiToken) {
+  const entry2 = providerEntry(providersOf(config), provider);
+  optionsOf(entry2).apiKey = apiToken;
+}
+function writeCustomProvider(config, parsed, {
+  npm,
+  baseUrl,
+  apiToken
+}) {
+  const entry2 = providerEntry(providersOf(config), parsed.provider);
+  entry2.npm = npm;
+  if (typeof entry2.name !== "string") entry2.name = parsed.provider;
+  const opts = optionsOf(entry2);
+  if (baseUrl) opts.baseURL = baseUrl;
+  if (apiToken) opts.apiKey = apiToken;
+  const models = typeof entry2.models === "object" && entry2.models !== null ? entry2.models : {};
+  if (models[parsed.modelId] === void 0) {
+    models[parsed.modelId] = { name: parsed.modelId };
+  }
+  entry2.models = models;
+}
+var KNOWN_APIKEY_PROVIDERS;
+var init_opencode_config = __esm({
+  "src/create/opencode-config.ts"() {
+    "use strict";
+    init_ref();
+    KNOWN_APIKEY_PROVIDERS = [
+      "anthropic",
+      "openai",
+      "google",
+      "openrouter",
+      "mistral",
+      "groq",
+      "deepseek",
+      "xai"
+    ];
+  }
+});
+
+// src/create/scaffold.ts
+import { existsSync as existsSync7, promises as fs7 } from "fs";
+import path10 from "path";
 function deriveRepoName(url) {
   const lastSep = Math.max(url.lastIndexOf("/"), url.lastIndexOf(":"));
   const tail = url.slice(lastSep + 1);
@@ -2590,7 +2737,7 @@ function featuresSourceRoot() {
   const override2 = process.env.MONOCEROS_FEATURES_DIR_OVERRIDE?.trim();
   if (override2 && override2.length > 0) return override2;
   const checkout = workbenchCheckoutRoot();
-  return checkout ? path9.join(checkout, "components", "features") : null;
+  return checkout ? path10.join(checkout, "components", "features") : null;
 }
 function resolveFeatures(opts) {
   const resolved = [];
@@ -2630,8 +2777,8 @@ function resolveFeatures(opts) {
         const descriptor = featureDescriptor(name);
         const { paths, files } = descriptorPersistentHome(descriptor);
         const sourceRoot = featuresSourceRoot();
-        const localSourceDir = sourceRoot ? path9.join(sourceRoot, name) : null;
-        if (descriptor && localSourceDir && existsSync6(localSourceDir)) {
+        const localSourceDir = sourceRoot ? path10.join(sourceRoot, name) : null;
+        if (descriptor && localSourceDir && existsSync7(localSourceDir)) {
           resolved.push({
             devcontainerKey: `./features/${name}`,
             options,
@@ -3076,7 +3223,7 @@ function buildPostCreateScript(opts) {
   return lines.join("\n") + "\n";
 }
 async function writePostCreateScript(devcontainerDir, opts) {
-  const dest = path9.join(devcontainerDir, "post-create.sh");
+  const dest = path10.join(devcontainerDir, "post-create.sh");
   await fs7.writeFile(dest, buildPostCreateScript(opts));
   await fs7.chmod(dest, 493);
 }
@@ -3090,11 +3237,11 @@ async function writeIfChanged(filePath, content) {
 }
 async function writeScaffold(opts, targetDir, scaffoldOpts = {}) {
   const dockerMode = scaffoldOpts.dockerMode ?? "rootful";
-  const devcontainerDir = path9.join(targetDir, ".devcontainer");
-  const monocerosDir = path9.join(targetDir, ".monoceros");
-  const projectsDir = path9.join(targetDir, "projects");
-  const homeDir = path9.join(targetDir, "home");
-  const dataDir = path9.join(targetDir, "data");
+  const devcontainerDir = path10.join(targetDir, ".devcontainer");
+  const monocerosDir = path10.join(targetDir, ".monoceros");
+  const projectsDir = path10.join(targetDir, "projects");
+  const homeDir = path10.join(targetDir, "home");
+  const dataDir = path10.join(targetDir, "data");
   await fs7.mkdir(devcontainerDir, { recursive: true });
   await fs7.mkdir(monocerosDir, { recursive: true });
   await fs7.mkdir(projectsDir, { recursive: true });
@@ -3104,36 +3251,36 @@ async function writeScaffold(opts, targetDir, scaffoldOpts = {}) {
     for (const svc of opts.services) {
       const hasDataVolume = svc.volumes.some((v) => v.split(":")[0] === "data");
       if (hasDataVolume) {
-        await fs7.mkdir(path9.join(dataDir, svc.name), { recursive: true });
+        await fs7.mkdir(path10.join(dataDir, svc.name), { recursive: true });
       }
     }
   }
-  const containerGitignore = path9.join(targetDir, ".gitignore");
+  const containerGitignore = path10.join(targetDir, ".gitignore");
   await fs7.writeFile(
     containerGitignore,
     "/home/\n/.monoceros/\n/data/\n/AGENTS.md\n/CLAUDE.md\n"
   );
-  const gitkeep = path9.join(projectsDir, ".gitkeep");
-  if (!existsSync6(gitkeep)) {
+  const gitkeep = path10.join(projectsDir, ".gitkeep");
+  if (!existsSync7(gitkeep)) {
     await fs7.writeFile(gitkeep, "");
   }
   await fs7.writeFile(
-    path9.join(monocerosDir, ".gitignore"),
+    path10.join(monocerosDir, ".gitignore"),
     "git-credentials*\ngitconfig\n"
   );
   const devcontainerJson = buildDevcontainerJson(opts, dockerMode);
   await writeIfChanged(
-    path9.join(devcontainerDir, "devcontainer.json"),
+    path10.join(devcontainerDir, "devcontainer.json"),
     JSON.stringify(devcontainerJson, null, 2) + "\n"
   );
-  const featuresDir = path9.join(devcontainerDir, "features");
-  if (existsSync6(featuresDir)) {
+  const featuresDir = path10.join(devcontainerDir, "features");
+  if (existsSync7(featuresDir)) {
     await fs7.rm(featuresDir, { recursive: true, force: true });
   }
   const resolvedFeatures = resolveFeatures(opts);
   for (const f of resolvedFeatures) {
     if (!f.localSourceDir || !f.localName) continue;
-    const dest = path9.join(featuresDir, f.localName);
+    const dest = path10.join(featuresDir, f.localName);
     await fs7.mkdir(dest, { recursive: true });
     const entries = await fs7.readdir(f.localSourceDir, { withFileTypes: true });
     for (const entry2 of entries) {
@@ -3142,38 +3289,39 @@ async function writeScaffold(opts, targetDir, scaffoldOpts = {}) {
         continue;
       }
       await fs7.cp(
-        path9.join(f.localSourceDir, entry2.name),
-        path9.join(dest, entry2.name)
+        path10.join(f.localSourceDir, entry2.name),
+        path10.join(dest, entry2.name)
       );
     }
     if (f.generatedManifest) {
       await fs7.writeFile(
-        path9.join(dest, "devcontainer-feature.json"),
+        path10.join(dest, "devcontainer-feature.json"),
         JSON.stringify(f.generatedManifest, null, 2) + "\n"
       );
     }
   }
   for (const f of resolvedFeatures) {
     for (const sub of f.persistentHomePaths) {
-      await fs7.mkdir(path9.join(homeDir, sub), { recursive: true });
+      await fs7.mkdir(path10.join(homeDir, sub), { recursive: true });
     }
     for (const entry2 of f.persistentHomeFiles) {
-      const filePath = path9.join(homeDir, entry2.path);
-      await fs7.mkdir(path9.dirname(filePath), { recursive: true });
-      if (!existsSync6(filePath)) {
+      const filePath = path10.join(homeDir, entry2.path);
+      await fs7.mkdir(path10.dirname(filePath), { recursive: true });
+      if (!existsSync7(filePath)) {
         await fs7.writeFile(filePath, entry2.initialContent);
       }
     }
   }
   await writeClaudePermissionMode(targetDir, opts.features);
+  await writeOpencodeConfig(targetDir, opts.name, opts.features);
   await writePostCreateScript(devcontainerDir, opts);
-  const composePath = path9.join(devcontainerDir, "compose.yaml");
+  const composePath = path10.join(devcontainerDir, "compose.yaml");
   if (needsCompose(opts)) {
     await writeIfChanged(composePath, buildComposeYaml(opts, dockerMode));
-  } else if (existsSync6(composePath)) {
+  } else if (existsSync7(composePath)) {
     await fs7.rm(composePath);
   }
-  const workspacePath = path9.join(targetDir, `${opts.name}.code-workspace`);
+  const workspacePath = path10.join(targetDir, `${opts.name}.code-workspace`);
   let existingWorkspace;
   try {
     const raw = await fs7.readFile(workspacePath, "utf8");
@@ -3184,8 +3332,8 @@ async function writeScaffold(opts, targetDir, scaffoldOpts = {}) {
   const generated = buildCodeWorkspaceJson(opts);
   const merged = mergeCodeWorkspace(existingWorkspace, generated);
   await fs7.writeFile(workspacePath, JSON.stringify(merged, null, 2) + "\n");
-  const vscodeDir = path9.join(targetDir, ".vscode");
-  const settingsPath = path9.join(vscodeDir, "settings.json");
+  const vscodeDir = path10.join(targetDir, ".vscode");
+  const settingsPath = path10.join(vscodeDir, "settings.json");
   let existingSettings;
   try {
     existingSettings = JSON.parse(await fs7.readFile(settingsPath, "utf8"));
@@ -3207,6 +3355,7 @@ var init_scaffold = __esm({
     init_load_sync();
     init_generate_manifest();
     init_claude_settings();
+    init_opencode_config();
     init_catalog();
     APT_PACKAGE_NAME_RE2 = /^[a-z0-9][a-z0-9.+-]*$/;
     FEATURE_REF_RE2 = /^[a-z0-9.-]+(\/[a-z0-9._-]+)+:[a-z0-9._-]+$/;
@@ -3660,8 +3809,8 @@ function removeRepoFromDoc(doc, urlOrPath) {
     if (!isMap2(item)) return false;
     const url = item.get("url");
     if (url === urlOrPath) return true;
-    const path27 = item.get("path");
-    const effectivePath = typeof path27 === "string" ? path27 : typeof url === "string" ? deriveRepoName(url) : void 0;
+    const path28 = item.get("path");
+    const effectivePath = typeof path28 === "string" ? path28 : typeof url === "string" ? deriveRepoName(url) : void 0;
     return effectivePath === urlOrPath;
   });
   if (idx < 0) return false;
@@ -3696,9 +3845,9 @@ var init_yml = __esm({
 
 // src/modify/index.ts
 import { promises as fs8 } from "fs";
-import { consola } from "consola";
+import { consola as consola2 } from "consola";
 import { createPatch } from "diff";
-import path10 from "path";
+import path11 from "path";
 function runAddLanguage(input) {
   const spec = parseLanguageSpec(input.language);
   if (!spec || !BUILTIN_LANGUAGES.has(spec.name) && !LANGUAGE_CATALOG[spec.name]) {
@@ -3783,7 +3932,7 @@ async function runAddRepo(input) {
       "Missing repo URL. Usage: monoceros add-repo <containername> <url>."
     );
   }
-  const path27 = (input.path ?? deriveRepoName(url)).trim();
+  const path28 = (input.path ?? deriveRepoName(url)).trim();
   const hasName = typeof input.gitName === "string" && input.gitName.trim().length > 0;
   const hasEmail = typeof input.gitEmail === "string" && input.gitEmail.trim().length > 0;
   if (hasName !== hasEmail) {
@@ -3820,7 +3969,7 @@ async function runAddRepo(input) {
   const providerToWrite = !canonical && explicitProvider ? explicitProvider : void 0;
   const entry2 = {
     url,
-    path: path27,
+    path: path28,
     ...hasName && hasEmail ? {
       gitUser: {
         name: input.gitName.trim(),
@@ -3952,7 +4101,7 @@ async function tryCloneInRunningContainer(input, entry2) {
   logger.info(
     `Cloned ${entry2.url} into /workspaces/${containerName2}/${targetRel} inside the running container.`
   );
-  void path10;
+  void path11;
 }
 function shquote(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
@@ -4194,9 +4343,9 @@ async function mutate(opts, apply) {
 }
 function defaultLogger() {
   return {
-    info: (m) => consola.info(m),
-    success: (m) => consola.success(m),
-    warn: (m) => consola.warn(m)
+    info: (m) => consola2.info(m),
+    success: (m) => consola2.success(m),
+    warn: (m) => consola2.warn(m)
   };
 }
 async function syncPortsToProxy(input) {
@@ -4276,7 +4425,7 @@ var init_modify = __esm({
     init_scaffold();
     init_yml();
     defaultConfirm = async (message) => {
-      const result = await consola.prompt(message, {
+      const result = await consola2.prompt(message, {
         type: "confirm",
         initial: false
       });
@@ -4287,7 +4436,7 @@ var init_modify = __esm({
 
 // src/commands/add-apt-packages.ts
 import { defineCommand } from "citty";
-import { consola as consola2 } from "consola";
+import { consola as consola3 } from "consola";
 var addAptPackagesCommand;
 var init_add_apt_packages = __esm({
   "src/commands/add-apt-packages.ts"() {
@@ -4316,7 +4465,7 @@ var init_add_apt_packages = __esm({
       async run({ args }) {
         const packages = [...getInnerArgs()];
         if (packages.length === 0) {
-          consola2.error(
+          consola3.error(
             "No package names given. Usage: `monoceros add-apt-packages <containername> [--yes] -- <pkg> [<pkg> \u2026]`."
           );
           process.exit(1);
@@ -4329,7 +4478,7 @@ var init_add_apt_packages = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola2.error(err instanceof Error ? err.message : String(err));
+          consola3.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -4339,7 +4488,7 @@ var init_add_apt_packages = __esm({
 
 // src/commands/add-feature.ts
 import { defineCommand as defineCommand2 } from "citty";
-import { consola as consola3 } from "consola";
+import { consola as consola4 } from "consola";
 function parseOptionsAfterDashes(tokens) {
   const result = {};
   for (const token of tokens) {
@@ -4399,7 +4548,7 @@ var init_add_feature = __esm({
         try {
           options = parseOptionsAfterDashes(getInnerArgs());
         } catch (err) {
-          consola3.error(err instanceof Error ? err.message : String(err));
+          consola4.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
         try {
@@ -4411,7 +4560,7 @@ var init_add_feature = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola3.error(err instanceof Error ? err.message : String(err));
+          consola4.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -4421,7 +4570,7 @@ var init_add_feature = __esm({
 
 // src/commands/add-from-url.ts
 import { defineCommand as defineCommand3 } from "citty";
-import { consola as consola4 } from "consola";
+import { consola as consola5 } from "consola";
 function printSecurityWarning(url) {
   const w = (line) => process.stderr.write(line + "\n");
   w("");
@@ -4490,7 +4639,7 @@ var init_add_from_url = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola4.error(err instanceof Error ? err.message : String(err));
+          consola5.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -4500,7 +4649,7 @@ var init_add_from_url = __esm({
 
 // src/commands/add-repo.ts
 import { defineCommand as defineCommand4 } from "citty";
-import { consola as consola5 } from "consola";
+import { consola as consola6 } from "consola";
 var addRepoCommand;
 var init_add_repo = __esm({
   "src/commands/add-repo.ts"() {
@@ -4559,7 +4708,7 @@ var init_add_repo = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola5.error(err instanceof Error ? err.message : String(err));
+          consola6.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -4569,7 +4718,7 @@ var init_add_repo = __esm({
 
 // src/commands/add-language.ts
 import { defineCommand as defineCommand5 } from "citty";
-import { consola as consola6 } from "consola";
+import { consola as consola7 } from "consola";
 var addLanguageCommand;
 var init_add_language = __esm({
   "src/commands/add-language.ts"() {
@@ -4608,7 +4757,7 @@ var init_add_language = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola6.error(err instanceof Error ? err.message : String(err));
+          consola7.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -4618,7 +4767,7 @@ var init_add_language = __esm({
 
 // src/commands/add-port.ts
 import { defineCommand as defineCommand6 } from "citty";
-import { consola as consola7 } from "consola";
+import { consola as consola8 } from "consola";
 function coerceToken(raw) {
   const n = Number(raw);
   return Number.isFinite(n) ? n : raw;
@@ -4656,7 +4805,7 @@ var init_add_port = __esm({
       async run({ args }) {
         const tokens = [...getInnerArgs()];
         if (tokens.length === 0) {
-          consola7.error(
+          consola8.error(
             "No ports given. Usage: `monoceros add-port <containername> [--yes] [--default] -- <port> [<port> \u2026]`."
           );
           process.exit(1);
@@ -4670,7 +4819,7 @@ var init_add_port = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola7.error(err instanceof Error ? err.message : String(err));
+          consola8.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -4680,7 +4829,7 @@ var init_add_port = __esm({
 
 // src/commands/add-service.ts
 import { defineCommand as defineCommand7 } from "citty";
-import { consola as consola8 } from "consola";
+import { consola as consola9 } from "consola";
 var addServiceCommand;
 var init_add_service = __esm({
   "src/commands/add-service.ts"() {
@@ -4724,7 +4873,7 @@ var init_add_service = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola8.error(err instanceof Error ? err.message : String(err));
+          consola9.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -4734,7 +4883,7 @@ var init_add_service = __esm({
 
 // src/config/state.ts
 import { promises as fs9 } from "fs";
-import path11 from "path";
+import path12 from "path";
 function buildStateFile(opts) {
   return {
     schemaVersion: CONFIG_SCHEMA_VERSION,
@@ -4745,7 +4894,7 @@ function buildStateFile(opts) {
   };
 }
 function stateFilePath(targetDir) {
-  return path11.join(targetDir, ".monoceros", "state.json");
+  return path12.join(targetDir, ".monoceros", "state.json");
 }
 async function readStateFile(targetDir) {
   try {
@@ -4756,7 +4905,7 @@ async function readStateFile(targetDir) {
   }
 }
 async function writeStateFile(targetDir, state) {
-  const monocerosDir = path11.join(targetDir, ".monoceros");
+  const monocerosDir = path12.join(targetDir, ".monoceros");
   await fs9.mkdir(monocerosDir, { recursive: true });
   await fs9.writeFile(
     stateFilePath(targetDir),
@@ -4868,7 +5017,7 @@ var init_transform = __esm({
 
 // src/apply/apply-log.ts
 import { createWriteStream, mkdirSync } from "fs";
-import path12 from "path";
+import path13 from "path";
 import { Writable } from "stream";
 function safeIsoStamp(d) {
   return d.toISOString().replace(/[:.]/g, "-");
@@ -4878,7 +5027,7 @@ function createApplyLog(opts) {
   const dir = containerLogsDir(opts.name, opts.home);
   mkdirSync(dir, { recursive: true });
   const file = `apply-${opts.name}-${safeIsoStamp(now)}.log`;
-  const fullPath = path12.join(dir, file);
+  const fullPath = path13.join(dir, file);
   const stream = createWriteStream(fullPath, { flags: "w" });
   const header = [
     `# monoceros apply log`,
@@ -5364,11 +5513,17 @@ function generateAgentsMd(input) {
     "  repo already listed above), add it to the VS Code multi-root workspace so",
     `  it shows up in the Explorer. Open \`/workspaces/${input.containerName}/${input.containerName}.code-workspace\``,
     "  and append an entry to the `folders` array, for example",
-    '  `{ "path": "projects/<app>", "name": "<app>" }`. Cloned repos are added',
-    "  there automatically by the apply; projects you create yourself are not, so",
-    "  without this step VS Code (opened on the host from the workspace file) would",
-    "  not list them. Hand-added folder entries survive `monoceros apply`: the",
-    "  apply merges into the file, it does not overwrite your edits.",
+    '  `{ "path": "projects/<app>", "name": "<app>" }`.',
+    "  Add **exactly one** folder entry per directory directly under `projects/`:",
+    "  the top-level project directory itself, even when it contains several",
+    "  sub-projects (e.g. a `backend/` and a `frontend/`, or a multi-module",
+    "  layout). Do **not** register those sub-directories as separate roots \u2014 one",
+    "  root per top-level project keeps the Explorer readable as more projects",
+    "  land in the container. Cloned repos are added there automatically by the",
+    "  apply; projects you create yourself are not, so without this step VS Code",
+    "  (opened on the host from the workspace file) would not list them.",
+    "  Hand-added folder entries survive `monoceros apply`: the apply merges into",
+    "  the file, it does not overwrite your edits.",
     "- You run as the `node` user. `sudo` is available but its effects do",
     "  not persist across rebuilds.",
     "- A bare `EXPOSE` directive has no effect on host reachability. Ports",
@@ -5739,7 +5894,7 @@ var init_markers = __esm({
 
 // src/briefing/index.ts
 import { promises as fs10 } from "fs";
-import path13 from "path";
+import path14 from "path";
 async function writeBriefing(input) {
   const subCommands = input.subCommands ?? await loadSubCommandsDynamic();
   const manifestLoader = input.manifestLoader ?? ((ref) => loadFeatureManifestSummary(ref));
@@ -5752,12 +5907,12 @@ async function writeBriefing(input) {
   );
   const claudeBody = generateClaudeMd();
   const commandsBody = generateCommandsMd(subCommands);
-  await writeMarkerAware(path13.join(input.targetDir, "AGENTS.md"), agentsBody);
-  await writeMarkerAware(path13.join(input.targetDir, "CLAUDE.md"), claudeBody);
-  const monocerosDir = path13.join(input.targetDir, ".monoceros");
+  await writeMarkerAware(path14.join(input.targetDir, "AGENTS.md"), agentsBody);
+  await writeMarkerAware(path14.join(input.targetDir, "CLAUDE.md"), claudeBody);
+  const monocerosDir = path14.join(input.targetDir, ".monoceros");
   await fs10.mkdir(monocerosDir, { recursive: true });
   await fs10.writeFile(
-    path13.join(monocerosDir, "commands.md"),
+    path14.join(monocerosDir, "commands.md"),
     commandsBody,
     "utf8"
   );
@@ -5916,7 +6071,7 @@ var init_runtime_pull_hint = __esm({
 import { spawn as spawn4 } from "child_process";
 import { readFileSync as readFileSync4 } from "fs";
 import { createRequire } from "module";
-import path14 from "path";
+import path15 from "path";
 function devcontainerCliPath() {
   if (cachedBinaryPath) return cachedBinaryPath;
   const pkgJsonPath = require_.resolve("@devcontainers/cli/package.json");
@@ -5925,7 +6080,7 @@ function devcontainerCliPath() {
   if (!binEntry) {
     throw new Error("Could not resolve @devcontainers/cli bin entry.");
   }
-  cachedBinaryPath = path14.resolve(path14.dirname(pkgJsonPath), binEntry);
+  cachedBinaryPath = path15.resolve(path15.dirname(pkgJsonPath), binEntry);
   return cachedBinaryPath;
 }
 var require_, cachedBinaryPath, spawnDevcontainer;
@@ -5999,10 +6154,10 @@ var init_cli = __esm({
 
 // src/devcontainer/compose.ts
 import { spawn as spawn5 } from "child_process";
-import { existsSync as existsSync7 } from "fs";
-import path15 from "path";
+import { existsSync as existsSync8 } from "fs";
+import path16 from "path";
 import { Writable as Writable3 } from "stream";
-import { consola as consola9 } from "consola";
+import { consola as consola10 } from "consola";
 async function findContainerIds(filters, exec = spawnDocker) {
   const ids = /* @__PURE__ */ new Set();
   for (const filter of filters) {
@@ -6050,16 +6205,16 @@ async function cleanupDockerObjects(opts) {
   return { exitCode: rmExit, removedIds: ids };
 }
 function composeProjectName(root) {
-  return `${path15.basename(root)}_devcontainer`;
+  return `${path16.basename(root)}_devcontainer`;
 }
 function resolveCompose(root) {
-  if (!existsSync7(path15.join(root, ".devcontainer"))) {
+  if (!existsSync8(path16.join(root, ".devcontainer"))) {
     throw new Error(
       `No .devcontainer/ at ${root}. Run \`monoceros apply <name>\` first.`
     );
   }
-  const composeFile = path15.join(root, ".devcontainer", "compose.yaml");
-  if (!existsSync7(composeFile)) {
+  const composeFile = path16.join(root, ".devcontainer", "compose.yaml");
+  if (!existsSync8(composeFile)) {
     throw new Error(
       `No compose.yaml at ${composeFile}. \`start\` / \`stop\` / \`status\` / \`logs\` require services configured via \`monoceros add-service <name> <svc>\`. Use \`monoceros shell <name>\` to enter the container directly.`
     );
@@ -6074,7 +6229,7 @@ async function runComposeAction(buildSubArgs, opts) {
 }
 async function runStart(opts) {
   resolveCompose(opts.root);
-  const logger = opts.logger ?? { info: (msg) => consola9.info(msg) };
+  const logger = opts.logger ?? { info: (msg) => consola10.info(msg) };
   const spawnFn = opts.spawn ?? spawnDevcontainer;
   logger.info(`Bringing devcontainer up at ${opts.root}\u2026`);
   return spawnFn(
@@ -6320,14 +6475,14 @@ var init_images = __esm({
 });
 
 // src/config/machine-state.ts
-import { promises as fsp3 } from "fs";
-import path16 from "path";
+import { promises as fsp4 } from "fs";
+import path17 from "path";
 function machineStatePath(home = monocerosHome()) {
-  return path16.join(home, ".machine-state.json");
+  return path17.join(home, ".machine-state.json");
 }
 async function readMachineState(home = monocerosHome()) {
   try {
-    const raw = await fsp3.readFile(machineStatePath(home), "utf8");
+    const raw = await fsp4.readFile(machineStatePath(home), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed === "object" && parsed !== null) {
       return parsed;
@@ -6337,7 +6492,7 @@ async function readMachineState(home = monocerosHome()) {
   return {};
 }
 async function writeMachineState(state, home = monocerosHome()) {
-  await fsp3.writeFile(
+  await fsp4.writeFile(
     machineStatePath(home),
     `${JSON.stringify(state, null, 2)}
 `
@@ -6449,8 +6604,8 @@ var init_docker_mode = __esm({
 // src/devcontainer/identity.ts
 import { spawn as spawn7 } from "child_process";
 import { promises as fs11 } from "fs";
-import path17 from "path";
-import { consola as consola10 } from "consola";
+import path18 from "path";
+import { consola as consola11 } from "consola";
 async function resolveIdentityWithPrompt(options = {}) {
   const spawnFn = options.spawn ?? realGitConfigGet;
   const promptFn = options.prompt ?? realIdentityPrompt;
@@ -6505,8 +6660,8 @@ async function resolveIdentityWithPrompt(options = {}) {
   };
 }
 async function collectGitIdentity(devContainerRoot, options = {}) {
-  const gitconfigDir = path17.join(devContainerRoot, ".monoceros");
-  const gitconfigPath = path17.join(gitconfigDir, "gitconfig");
+  const gitconfigDir = path18.join(devContainerRoot, ".monoceros");
+  const gitconfigPath = path18.join(gitconfigDir, "gitconfig");
   const logger = options.logger ?? { info: () => {
   }, warn: () => {
   } };
@@ -6599,7 +6754,7 @@ var init_identity = __esm({
         return void 0;
       }
       const label = key === "user.name" ? "Git user.name for this dev container (full name)" : "Git user.email for this dev container";
-      const value = await consola10.prompt(`${label}:`, { type: "text" });
+      const value = await consola11.prompt(`${label}:`, { type: "text" });
       if (typeof value !== "string") return void 0;
       const trimmed = value.trim();
       return trimmed.length > 0 ? trimmed : void 0;
@@ -6609,7 +6764,7 @@ var init_identity = __esm({
         return ctx.reason === "prompt" ? "g" : "n";
       }
       const heading = ctx.reason === "persisted" ? `Found identity in .monoceros/gitconfig: ${ctx.name} <${ctx.email}>. Promote where?` : "Save this identity where?";
-      const choice = await consola10.prompt(heading, {
+      const choice = await consola11.prompt(heading, {
         type: "select",
         options: [
           {
@@ -6640,14 +6795,14 @@ var init_identity = __esm({
 });
 
 // src/apply/index.ts
-import { existsSync as existsSync8, promises as fs12 } from "fs";
-import { consola as consola11 } from "consola";
+import { existsSync as existsSync9, promises as fs12 } from "fs";
+import { consola as consola12 } from "consola";
 async function runApply(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
   const logger = opts.logger ?? {
-    info: (msg) => consola11.info(msg),
-    success: (msg) => consola11.success(msg),
-    warn: (msg) => consola11.warn(msg),
+    info: (msg) => consola12.info(msg),
+    success: (msg) => consola12.success(msg),
+    warn: (msg) => consola12.warn(msg),
     // Default section renderer: empty line, bold-underlined "▸ Label",
     // empty line. Mirrors install.sh's section visuals.
     section: (label) => process.stderr.write(`
@@ -6662,7 +6817,7 @@ ${sectionLine(label)}
     );
   }
   const ymlPath = containerConfigPath(opts.name, home);
-  if (!existsSync8(ymlPath)) {
+  if (!existsSync9(ymlPath)) {
     throw new Error(
       `No such config: ${ymlPath}. Run \`monoceros init <template> ${opts.name}\` first.`
     );
@@ -6935,7 +7090,7 @@ ${stripAnsi(formatted)}
   return { targetDir, configPath: ymlPath, containerExitCode: exitCode };
 }
 async function assertSafeTargetDir(targetDir, expectedOrigin) {
-  if (!existsSync8(targetDir)) return;
+  if (!existsSync9(targetDir)) return;
   const entries = await fs12.readdir(targetDir);
   if (entries.length === 0) return;
   const state = await readStateFile(targetDir);
@@ -7065,18 +7220,18 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "1.22.1" : "dev";
+    CLI_VERSION = true ? "1.23.0" : "dev";
   }
 });
 
 // src/commands/_dispatch.ts
-import { consola as consola12 } from "consola";
+import { consola as consola13 } from "consola";
 async function dispatch(runner) {
   try {
     const exitCode = await runner();
     process.exit(exitCode);
   } catch (err) {
-    consola12.error(err instanceof Error ? err.message : String(err));
+    consola13.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
 }
@@ -7255,8 +7410,8 @@ var init_completion = __esm({
 });
 
 // src/completion/resolve.ts
-import { existsSync as existsSync9, promises as fs13 } from "fs";
-import path18 from "path";
+import { existsSync as existsSync10, promises as fs13 } from "fs";
+import path19 from "path";
 async function resolveCompletions(line, point, opts = {}) {
   const { prev, current } = parseCompletionLine(line, point);
   const ctx = { prev, current, opts };
@@ -7405,8 +7560,8 @@ function filterPrefix(values, fragment) {
 }
 async function listContainerNames(ctx) {
   const home = ctx.opts.monocerosHome ?? monocerosHome();
-  const dir = path18.join(home, "container-configs");
-  if (!existsSync9(dir)) return [];
+  const dir = path19.join(home, "container-configs");
+  if (!existsSync10(dir)) return [];
   const entries = await fs13.readdir(dir);
   return entries.filter((e) => e.endsWith(".yml")).map((e) => e.slice(0, -".yml".length)).sort();
 }
@@ -8074,14 +8229,14 @@ var init_generator = __esm({
 });
 
 // src/init/index.ts
-import { existsSync as existsSync10, promises as fs14 } from "fs";
-import path19 from "path";
-import { consola as consola13 } from "consola";
+import { existsSync as existsSync11, promises as fs14 } from "fs";
+import path20 from "path";
+import { consola as consola14 } from "consola";
 async function runInit(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
   const logger = opts.logger ?? {
-    success: (msg) => consola13.success(msg),
-    info: (msg) => consola13.info(msg)
+    success: (msg) => consola14.success(msg),
+    info: (msg) => consola14.info(msg)
   };
   if (!REGEX.solutionName.test(opts.name)) {
     throw new Error(
@@ -8089,12 +8244,12 @@ async function runInit(opts) {
     );
   }
   const dest = containerConfigPath(opts.name, home);
-  if (existsSync10(dest)) {
+  if (existsSync11(dest)) {
     throw new Error(
       `Config already exists: ${dest}. Delete it manually before re-running \`monoceros init\` \u2014 this protects any hand-edits.`
     );
   }
-  const componentsRoot = opts.workbenchRoot ? path19.join(opts.workbenchRoot, "components") : componentsRootDir();
+  const componentsRoot = opts.workbenchRoot ? path20.join(opts.workbenchRoot, "components") : componentsRootDir();
   const catalog = await loadComponentCatalog(componentsRoot);
   if (catalog.size === 0) {
     throw new Error(
@@ -8185,8 +8340,8 @@ async function runInit(opts) {
   }
   await ensureEnvVars(envPath, opts.name, seedVars);
   const documented = !anyComposed;
-  const ymlRel = path19.relative(home, dest);
-  const envRel = path19.relative(home, envPath);
+  const ymlRel = path20.relative(home, dest);
+  const envRel = path20.relative(home, envPath);
   if (documented) {
     logger.success(`Wrote documented default to ${ymlRel} and ${envRel}.`);
     logger.info(
@@ -8330,7 +8485,7 @@ var init_init = __esm({
 
 // src/commands/init.ts
 import { defineCommand as defineCommand11 } from "citty";
-import { consola as consola14 } from "consola";
+import { consola as consola15 } from "consola";
 function collectListFlag(flag, rawArgs) {
   const eq = `${flag}=`;
   const pieces = [];
@@ -8456,7 +8611,7 @@ var init_init2 = __esm({
             ...ports && ports.length > 0 ? { withPorts: ports } : {}
           });
         } catch (err) {
-          consola14.error(err instanceof Error ? err.message : String(err));
+          consola15.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -8505,7 +8660,7 @@ var init_expand = __esm({
 
 // src/commands/list-components.ts
 import { defineCommand as defineCommand12 } from "citty";
-import { consola as consola15 } from "consola";
+import { consola as consola16 } from "consola";
 var CATEGORY_LABELS, CATEGORY_ORDER, listComponentsCommand;
 var init_list_components = __esm({
   "src/commands/list-components.ts"() {
@@ -8534,7 +8689,7 @@ var init_list_components = __esm({
         try {
           const catalog = expandSelectable(await loadDescriptorCatalog());
           if (catalog.size === 0) {
-            consola15.warn(
+            consola16.warn(
               "No components found. The workbench checkout looks incomplete."
             );
             process.exit(0);
@@ -8585,7 +8740,7 @@ var init_list_components = __esm({
           }
           process.exit(0);
         } catch (err) {
-          consola15.error(err instanceof Error ? err.message : String(err));
+          consola16.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -8595,8 +8750,8 @@ var init_list_components = __esm({
 
 // src/commands/logs.ts
 import { spawn as spawn8 } from "child_process";
-import { existsSync as existsSync11 } from "fs";
-import path20 from "path";
+import { existsSync as existsSync12 } from "fs";
+import path21 from "path";
 import { defineCommand as defineCommand13 } from "citty";
 function tailLogFile(file, follow) {
   const [cmd, args] = follow ? ["tail", ["-F", file]] : ["cat", [file]];
@@ -8639,8 +8794,8 @@ var init_logs = __esm({
       run({ args }) {
         const service = typeof args.service === "string" ? args.service : void 0;
         if (service) {
-          const logFile = path20.join(containerLogsDir(args.name), `${service}.log`);
-          if (existsSync11(logFile)) {
+          const logFile = path21.join(containerLogsDir(args.name), `${service}.log`);
+          if (existsSync12(logFile)) {
             return dispatch(() => tailLogFile(logFile, args.follow));
           }
         }
@@ -8658,10 +8813,10 @@ var init_logs = __esm({
 
 // src/commands/port.ts
 import { defineCommand as defineCommand14 } from "citty";
-import { consola as consola16 } from "consola";
+import { consola as consola17 } from "consola";
 async function runPortListing(opts) {
   const out = opts.out ?? process.stdout;
-  const info = opts.info ?? ((m) => consola16.info(m));
+  const info = opts.info ?? ((m) => consola17.info(m));
   const parsed = await readConfig(
     containerConfigPath(opts.name, opts.monocerosHome)
   );
@@ -8737,7 +8892,7 @@ var init_port = __esm({
           const code = await runPortListing({ name: args.name });
           process.exit(code);
         } catch (err) {
-          consola16.error(err instanceof Error ? err.message : String(err));
+          consola17.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -8747,7 +8902,7 @@ var init_port = __esm({
 
 // src/commands/remove-apt-packages.ts
 import { defineCommand as defineCommand15 } from "citty";
-import { consola as consola17 } from "consola";
+import { consola as consola18 } from "consola";
 var removeAptPackagesCommand;
 var init_remove_apt_packages = __esm({
   "src/commands/remove-apt-packages.ts"() {
@@ -8776,7 +8931,7 @@ var init_remove_apt_packages = __esm({
       async run({ args }) {
         const packages = [...getInnerArgs()];
         if (packages.length === 0) {
-          consola17.error(
+          consola18.error(
             "No package names given. Usage: `monoceros remove-apt-packages <containername> [--yes] -- <pkg> [<pkg> \u2026]`."
           );
           process.exit(1);
@@ -8789,7 +8944,7 @@ var init_remove_apt_packages = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola17.error(err instanceof Error ? err.message : String(err));
+          consola18.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -8799,7 +8954,7 @@ var init_remove_apt_packages = __esm({
 
 // src/commands/remove-feature.ts
 import { defineCommand as defineCommand16 } from "citty";
-import { consola as consola18 } from "consola";
+import { consola as consola19 } from "consola";
 var removeFeatureCommand;
 var init_remove_feature = __esm({
   "src/commands/remove-feature.ts"() {
@@ -8838,7 +8993,7 @@ var init_remove_feature = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola18.error(err instanceof Error ? err.message : String(err));
+          consola19.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -8847,15 +9002,15 @@ var init_remove_feature = __esm({
 });
 
 // src/remove/index.ts
-import { existsSync as existsSync12, promises as fs15 } from "fs";
-import path21 from "path";
-import { consola as consola19 } from "consola";
+import { existsSync as existsSync13, promises as fs15 } from "fs";
+import path22 from "path";
+import { consola as consola20 } from "consola";
 async function runRemove(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
   const logger = opts.logger ?? {
-    info: (msg) => consola19.info(msg),
-    success: (msg) => consola19.success(msg),
-    warn: (msg) => consola19.warn(msg)
+    info: (msg) => consola20.info(msg),
+    success: (msg) => consola20.success(msg),
+    warn: (msg) => consola20.warn(msg)
   };
   if (!REGEX.solutionName.test(opts.name)) {
     throw new Error(
@@ -8865,9 +9020,9 @@ async function runRemove(opts) {
   const ymlPath = containerConfigPath(opts.name, home);
   const envPath = containerEnvPath(opts.name, home);
   const containerPath = containerDir(opts.name, home);
-  const hasYml = existsSync12(ymlPath);
-  const hasEnv = existsSync12(envPath);
-  const hasContainer = existsSync12(containerPath);
+  const hasYml = existsSync13(ymlPath);
+  const hasEnv = existsSync13(envPath);
+  const hasContainer = existsSync13(containerPath);
   if (!hasYml && !hasContainer) {
     throw new Error(
       `Nothing to remove for '${opts.name}': neither ${ymlPath} nor ${containerPath} exists.`
@@ -8893,16 +9048,16 @@ async function runRemove(opts) {
   let backupPath = null;
   if (!opts.noBackup && (hasYml || hasContainer)) {
     const ts = (opts.now ?? /* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    backupPath = path21.join(home, "container-backups", `${opts.name}-${ts}`);
+    backupPath = path22.join(home, "container-backups", `${opts.name}-${ts}`);
     await fs15.mkdir(backupPath, { recursive: true });
     if (hasYml) {
-      await fs15.copyFile(ymlPath, path21.join(backupPath, `${opts.name}.yml`));
+      await fs15.copyFile(ymlPath, path22.join(backupPath, `${opts.name}.yml`));
     }
     if (hasEnv) {
-      await fs15.copyFile(envPath, path21.join(backupPath, `${opts.name}.env`));
+      await fs15.copyFile(envPath, path22.join(backupPath, `${opts.name}.env`));
     }
     if (hasContainer) {
-      await fs15.cp(containerPath, path21.join(backupPath, "container"), {
+      await fs15.cp(containerPath, path22.join(backupPath, "container"), {
         recursive: true
       });
     }
@@ -8992,7 +9147,7 @@ var init_remove = __esm({
 
 // src/commands/remove.ts
 import { defineCommand as defineCommand17 } from "citty";
-import { consola as consola20 } from "consola";
+import { consola as consola21 } from "consola";
 import { createInterface } from "readline/promises";
 var removeCommand;
 var init_remove2 = __esm({
@@ -9036,7 +9191,7 @@ var init_remove2 = __esm({
           const skipPrompt = args.yes === true;
           if (!skipPrompt) {
             const warning = noBackup ? `About to remove '${args.name}' WITHOUT a backup. Docker objects, container-configs entry, and container directory will all be deleted.` : `About to remove '${args.name}'. A backup will be written to container-backups/ first, then docker objects, container-configs entry, and container directory will all be deleted.`;
-            consola20.warn(warning);
+            consola21.warn(warning);
             const rl = createInterface({
               input: process.stdin,
               output: process.stdout
@@ -9044,7 +9199,7 @@ var init_remove2 = __esm({
             const answer = await rl.question("Continue? [y/N] ");
             rl.close();
             if (!/^y(es)?$/i.test(answer.trim())) {
-              consola20.info("Aborted. Nothing changed.");
+              consola21.info("Aborted. Nothing changed.");
               process.exit(0);
             }
           }
@@ -9053,7 +9208,7 @@ var init_remove2 = __esm({
             ...noBackup ? { noBackup: true } : {}
           });
         } catch (err) {
-          consola20.error(err instanceof Error ? err.message : String(err));
+          consola21.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9062,17 +9217,17 @@ var init_remove2 = __esm({
 });
 
 // src/restore/index.ts
-import { existsSync as existsSync13, promises as fs16 } from "fs";
-import path22 from "path";
-import { consola as consola21 } from "consola";
+import { existsSync as existsSync14, promises as fs16 } from "fs";
+import path23 from "path";
+import { consola as consola22 } from "consola";
 async function runRestore(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
   const logger = opts.logger ?? {
-    info: (msg) => consola21.info(msg),
-    success: (msg) => consola21.success(msg)
+    info: (msg) => consola22.info(msg),
+    success: (msg) => consola22.success(msg)
   };
-  const backup = path22.resolve(opts.backupPath);
-  if (!existsSync13(backup)) {
+  const backup = path23.resolve(opts.backupPath);
+  if (!existsSync14(backup)) {
     throw new Error(`Backup not found: ${backup}.`);
   }
   const stat = await fs16.stat(backup);
@@ -9093,24 +9248,24 @@ async function runRestore(opts) {
   }
   const ymlFile = ymlFiles[0];
   const name = ymlFile.replace(/\.yml$/, "");
-  const containerInBackup = path22.join(backup, "container");
-  const hasContainer = existsSync13(containerInBackup);
-  const envInBackup = path22.join(backup, `${name}.env`);
-  const hasEnv = existsSync13(envInBackup);
+  const containerInBackup = path23.join(backup, "container");
+  const hasContainer = existsSync14(containerInBackup);
+  const envInBackup = path23.join(backup, `${name}.env`);
+  const hasEnv = existsSync14(envInBackup);
   const destYml = containerConfigPath(name, home);
   const destContainer = containerDir(name, home);
-  if (existsSync13(destYml)) {
+  if (existsSync14(destYml)) {
     throw new Error(
       `Refusing to restore: ${destYml} already exists. Remove the current container first (\`monoceros remove ${name}\`) or rename the existing config.`
     );
   }
-  if (hasContainer && existsSync13(destContainer)) {
+  if (hasContainer && existsSync14(destContainer)) {
     throw new Error(
       `Refusing to restore: ${destContainer} already exists. Remove the current container first (\`monoceros remove ${name}\`).`
     );
   }
   await fs16.mkdir(containerConfigsDir(home), { recursive: true });
-  await fs16.copyFile(path22.join(backup, ymlFile), destYml);
+  await fs16.copyFile(path23.join(backup, ymlFile), destYml);
   if (hasEnv) {
     await fs16.copyFile(envInBackup, containerEnvPath(name, home));
   }
@@ -9136,7 +9291,7 @@ var init_restore = __esm({
 
 // src/commands/restore.ts
 import { defineCommand as defineCommand18 } from "citty";
-import { consola as consola22 } from "consola";
+import { consola as consola23 } from "consola";
 var restoreCommand;
 var init_restore2 = __esm({
   "src/commands/restore.ts"() {
@@ -9159,7 +9314,7 @@ var init_restore2 = __esm({
         try {
           await runRestore({ backupPath: args["backup-path"] });
         } catch (err) {
-          consola22.error(err instanceof Error ? err.message : String(err));
+          consola23.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9169,7 +9324,7 @@ var init_restore2 = __esm({
 
 // src/commands/remove-from-url.ts
 import { defineCommand as defineCommand19 } from "citty";
-import { consola as consola23 } from "consola";
+import { consola as consola24 } from "consola";
 var removeFromUrlCommand;
 var init_remove_from_url = __esm({
   "src/commands/remove-from-url.ts"() {
@@ -9208,7 +9363,7 @@ var init_remove_from_url = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola23.error(err instanceof Error ? err.message : String(err));
+          consola24.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9218,7 +9373,7 @@ var init_remove_from_url = __esm({
 
 // src/commands/remove-language.ts
 import { defineCommand as defineCommand20 } from "citty";
-import { consola as consola24 } from "consola";
+import { consola as consola25 } from "consola";
 var removeLanguageCommand;
 var init_remove_language = __esm({
   "src/commands/remove-language.ts"() {
@@ -9257,7 +9412,7 @@ var init_remove_language = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola24.error(err instanceof Error ? err.message : String(err));
+          consola25.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9267,7 +9422,7 @@ var init_remove_language = __esm({
 
 // src/commands/remove-port.ts
 import { defineCommand as defineCommand21 } from "citty";
-import { consola as consola25 } from "consola";
+import { consola as consola26 } from "consola";
 function coerceToken2(raw) {
   const n = Number(raw);
   return Number.isFinite(n) ? n : raw;
@@ -9300,7 +9455,7 @@ var init_remove_port = __esm({
       async run({ args }) {
         const tokens = [...getInnerArgs()];
         if (tokens.length === 0) {
-          consola25.error(
+          consola26.error(
             "No ports given. Usage: `monoceros remove-port <containername> [--yes] -- <port> [<port> \u2026]`."
           );
           process.exit(1);
@@ -9313,7 +9468,7 @@ var init_remove_port = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola25.error(err instanceof Error ? err.message : String(err));
+          consola26.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9323,7 +9478,7 @@ var init_remove_port = __esm({
 
 // src/commands/remove-repo.ts
 import { defineCommand as defineCommand22 } from "citty";
-import { consola as consola26 } from "consola";
+import { consola as consola27 } from "consola";
 var removeRepoCommand;
 var init_remove_repo = __esm({
   "src/commands/remove-repo.ts"() {
@@ -9362,7 +9517,7 @@ var init_remove_repo = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola26.error(err instanceof Error ? err.message : String(err));
+          consola27.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9372,7 +9527,7 @@ var init_remove_repo = __esm({
 
 // src/commands/remove-service.ts
 import { defineCommand as defineCommand23 } from "citty";
-import { consola as consola27 } from "consola";
+import { consola as consola28 } from "consola";
 var removeServiceCommand;
 var init_remove_service = __esm({
   "src/commands/remove-service.ts"() {
@@ -9411,7 +9566,7 @@ var init_remove_service = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola27.error(err instanceof Error ? err.message : String(err));
+          consola28.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9421,9 +9576,9 @@ var init_remove_service = __esm({
 
 // src/devcontainer/browser-bridge.ts
 import { spawn as spawn9 } from "child_process";
-import { existsSync as existsSync14, promises as fsp4, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync15, promises as fsp5, readFileSync as readFileSync5 } from "fs";
 import http from "http";
-import path23 from "path";
+import path24 from "path";
 function parseCallbackTarget(authUrl) {
   try {
     const u = new URL(authUrl);
@@ -9457,12 +9612,12 @@ function openInBrowser(url) {
   }
 }
 async function startBrowserBridge(opts) {
-  const relayDir = path23.join(opts.root, RELAY_DIRNAME);
-  const relayScript = path23.join(relayDir, "xdg-open");
-  const urlFile = path23.join(relayDir, "url");
-  await fsp4.mkdir(relayDir, { recursive: true });
-  await fsp4.rm(urlFile, { force: true });
-  await fsp4.writeFile(
+  const relayDir = path24.join(opts.root, RELAY_DIRNAME);
+  const relayScript = path24.join(relayDir, "xdg-open");
+  const urlFile = path24.join(relayDir, "url");
+  await fsp5.mkdir(relayDir, { recursive: true });
+  await fsp5.rm(urlFile, { force: true });
+  await fsp5.writeFile(
     relayScript,
     `#!/bin/sh
 printf '%s\\n' "$1" > "$(dirname "$0")/url"
@@ -9470,7 +9625,7 @@ exit 0
 `,
     { mode: 493 }
   );
-  await fsp4.chmod(relayScript, 493);
+  await fsp5.chmod(relayScript, 493);
   const servers = [];
   let lastOpened = null;
   const onUrl = (url) => {
@@ -9503,7 +9658,7 @@ exit 0
     servers.push(server);
   };
   const poll = setInterval(() => {
-    if (!existsSync14(urlFile)) return;
+    if (!existsSync15(urlFile)) return;
     let content = "";
     try {
       content = readFileSync5(urlFile, "utf8");
@@ -9520,7 +9675,7 @@ exit 0
     async dispose() {
       clearInterval(poll);
       for (const s of servers) s.close();
-      await fsp4.rm(relayDir, { recursive: true, force: true });
+      await fsp5.rm(relayDir, { recursive: true, force: true });
     }
   };
 }
@@ -9533,18 +9688,18 @@ var init_browser_bridge = __esm({
 });
 
 // src/devcontainer/claude-trust.ts
-import { existsSync as existsSync15, promises as fsp5 } from "fs";
-import path24 from "path";
+import { existsSync as existsSync16, promises as fsp6 } from "fs";
+import path25 from "path";
 function resolveContainerCwd(name, cwd) {
   const workspace = `/workspaces/${name}`;
   if (!cwd) return workspace;
-  return path24.posix.isAbsolute(cwd) ? cwd : path24.posix.join(workspace, cwd);
+  return path25.posix.isAbsolute(cwd) ? cwd : path25.posix.join(workspace, cwd);
 }
 async function preApproveClaudeProject(opts) {
-  const file = path24.join(opts.root, "home", ".claude.json");
-  if (!existsSync15(file)) return;
+  const file = path25.join(opts.root, "home", ".claude.json");
+  if (!existsSync16(file)) return;
   try {
-    const raw = await fsp5.readFile(file, "utf8");
+    const raw = await fsp6.readFile(file, "utf8");
     const config = raw.trim() ? JSON.parse(raw) : {};
     if (typeof config !== "object" || config === null) return;
     const dir = resolveContainerCwd(opts.name, opts.cwd);
@@ -9564,7 +9719,7 @@ async function preApproveClaudeProject(opts) {
     if (typeof entry2.projectOnboardingSeenCount !== "number") {
       entry2.projectOnboardingSeenCount = 1;
     }
-    await fsp5.writeFile(file, `${JSON.stringify(config, null, 2)}
+    await fsp6.writeFile(file, `${JSON.stringify(config, null, 2)}
 `);
   } catch {
   }
@@ -9576,8 +9731,8 @@ var init_claude_trust = __esm({
 });
 
 // src/devcontainer/shell.ts
-import { existsSync as existsSync16 } from "fs";
-import path25 from "path";
+import { existsSync as existsSync17 } from "fs";
+import path26 from "path";
 async function runShell(opts) {
   assertContainerExists(opts.root);
   const spawnFn = opts.spawn ?? spawnDevcontainer;
@@ -9600,7 +9755,7 @@ async function runShell(opts) {
   );
 }
 function assertContainerExists(root) {
-  if (!existsSync16(path25.join(root, ".devcontainer"))) {
+  if (!existsSync17(path26.join(root, ".devcontainer"))) {
     throw new Error(
       `No .devcontainer/ at ${root}. Run \`monoceros apply <name>\` first.`
     );
@@ -9690,7 +9845,7 @@ var init_run = __esm({
 
 // src/commands/run.ts
 import { defineCommand as defineCommand24 } from "citty";
-import { consola as consola28 } from "consola";
+import { consola as consola29 } from "consola";
 var runCommand;
 var init_run2 = __esm({
   "src/commands/run.ts"() {
@@ -9718,7 +9873,7 @@ var init_run2 = __esm({
       async run({ args }) {
         const command = [...getInnerArgs()];
         if (command.length === 0) {
-          consola28.error(
+          consola29.error(
             "No command provided. Usage: `monoceros run <containername> -- <cmd> [args\u2026]`."
           );
           process.exit(1);
@@ -9732,7 +9887,7 @@ var init_run2 = __esm({
           });
           process.exit(exitCode);
         } catch (err) {
-          consola28.error(err instanceof Error ? err.message : String(err));
+          consola29.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9742,7 +9897,7 @@ var init_run2 = __esm({
 
 // src/commands/shell.ts
 import { defineCommand as defineCommand25 } from "citty";
-import { consola as consola29 } from "consola";
+import { consola as consola30 } from "consola";
 var shellCommand;
 var init_shell2 = __esm({
   "src/commands/shell.ts"() {
@@ -9767,7 +9922,7 @@ var init_shell2 = __esm({
           const exitCode = await runShell({ root: containerDir(args.name) });
           process.exit(exitCode);
         } catch (err) {
-          consola29.error(err instanceof Error ? err.message : String(err));
+          consola30.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -9777,7 +9932,7 @@ var init_shell2 = __esm({
 
 // src/commands/start.ts
 import { defineCommand as defineCommand26 } from "citty";
-import { consola as consola30 } from "consola";
+import { consola as consola31 } from "consola";
 var startCommand;
 var init_start = __esm({
   "src/commands/start.ts"() {
@@ -9814,7 +9969,7 @@ var init_start = __esm({
               hostPort = proxyHostPort(global);
             }
           } catch (err) {
-            consola30.warn(
+            consola31.warn(
               `Could not read container yml ahead of start: ${err instanceof Error ? err.message : String(err)}. Skipping Traefik pre-flight.`
             );
           }
@@ -9869,7 +10024,7 @@ var init_status = __esm({
 
 // src/commands/stop.ts
 import { defineCommand as defineCommand28 } from "citty";
-import { consola as consola31 } from "consola";
+import { consola as consola32 } from "consola";
 var stopCommand;
 var init_stop = __esm({
   "src/commands/stop.ts"() {
@@ -9903,10 +10058,10 @@ var init_stop = __esm({
           });
           try {
             await maybeStopProxy({
-              logger: { info: (msg) => consola31.info(msg) }
+              logger: { info: (msg) => consola32.info(msg) }
             });
           } catch (err) {
-            consola31.warn(
+            consola32.warn(
               `Could not tear down the Traefik proxy: ${err instanceof Error ? err.message : String(err)}. Ignored.`
             );
           }
@@ -9918,11 +10073,11 @@ var init_stop = __esm({
 });
 
 // src/tunnel/resolve.ts
-import { existsSync as existsSync17 } from "fs";
-import path26 from "path";
+import { existsSync as existsSync18 } from "fs";
+import path27 from "path";
 async function resolveTunnelTarget(opts) {
   const ymlPath = containerConfigPath(opts.name, opts.monocerosHome);
-  if (!existsSync17(ymlPath)) {
+  if (!existsSync18(ymlPath)) {
     throw new Error(
       `No yml profile for '${opts.name}' at ${ymlPath}. Run \`monoceros init ${opts.name}\` first.`
     );
@@ -9930,13 +10085,13 @@ async function resolveTunnelTarget(opts) {
   const parsed = await readConfig(ymlPath);
   const config = parsed.config;
   const containerRoot = containerDir(opts.name, opts.monocerosHome);
-  if (!existsSync17(containerRoot)) {
+  if (!existsSync18(containerRoot)) {
     throw new Error(
       `Container '${opts.name}' is not materialised at ${containerRoot}. Run \`monoceros apply ${opts.name}\` first.`
     );
   }
-  const composePath = path26.join(containerRoot, ".devcontainer", "compose.yaml");
-  const isCompose = existsSync17(composePath);
+  const composePath = path27.join(containerRoot, ".devcontainer", "compose.yaml");
+  const isCompose = existsSync18(composePath);
   const parsedTarget = parseTargetArg(opts.target, config);
   const docker = opts.docker ?? defaultDockerExec;
   if (isCompose) {
@@ -10172,7 +10327,7 @@ var init_port_check2 = __esm({
 
 // src/tunnel/run.ts
 import { spawn as spawn10 } from "child_process";
-import { consola as consola32 } from "consola";
+import { consola as consola33 } from "consola";
 function signalNumber(signal) {
   switch (signal) {
     case "SIGINT":
@@ -10185,8 +10340,8 @@ function signalNumber(signal) {
 }
 async function runTunnel(opts) {
   const log = opts.logger ?? {
-    info: (m) => consola32.info(m),
-    warn: (m) => consola32.warn(m)
+    info: (m) => consola33.info(m),
+    warn: (m) => consola33.warn(m)
   };
   const resolve = opts.resolve ?? resolveTunnelTarget;
   const resolveArgs3 = {
@@ -10293,7 +10448,7 @@ var init_run3 = __esm({
 
 // src/commands/tunnel.ts
 import { defineCommand as defineCommand29 } from "citty";
-import { consola as consola33 } from "consola";
+import { consola as consola34 } from "consola";
 function parseLocalPort(raw) {
   if (raw === void 0) return void 0;
   const n = Number(raw);
@@ -10346,7 +10501,7 @@ var init_tunnel = __esm({
           });
           process.exit(exitCode);
         } catch (err) {
-          consola33.error(err instanceof Error ? err.message : String(err));
+          consola34.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -10416,8 +10571,8 @@ var init_prune = __esm({
 });
 
 // src/upgrade/index.ts
-import { existsSync as existsSync18, promises as fs17 } from "fs";
-import { consola as consola34 } from "consola";
+import { existsSync as existsSync19, promises as fs17 } from "fs";
+import { consola as consola35 } from "consola";
 async function fetchRuntimeVersions() {
   const tokenUrl = `https://ghcr.io/token?service=ghcr.io&scope=repository:${RUNTIME_REPO}:pull`;
   const tokenRes = await fetch(tokenUrl);
@@ -10455,7 +10610,7 @@ ${yml}`;
 }
 async function runUpgrade(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
-  const logger = opts.logger ?? consola34;
+  const logger = opts.logger ?? consola35;
   const fetchVersions = opts.fetchVersions ?? fetchRuntimeVersions;
   if (opts.list) {
     const versions = await fetchVersions();
@@ -10481,7 +10636,7 @@ async function runUpgrade(opts) {
       );
     }
   }
-  if (opts.name && !existsSync18(containerConfigPath(opts.name, home))) {
+  if (opts.name && !existsSync19(containerConfigPath(opts.name, home))) {
     throw new Error(
       `No such config: ${containerConfigPath(opts.name, home)}. Run \`monoceros init <template> ${opts.name}\` first.`
     );
@@ -10532,7 +10687,7 @@ async function runUpgrade(opts) {
   let bumped = 0;
   for (const name of targets) {
     const ymlPath = containerConfigPath(name, home);
-    if (!existsSync18(ymlPath)) continue;
+    if (!existsSync19(ymlPath)) continue;
     const raw = await fs17.readFile(ymlPath, "utf8");
     const updated = setRuntimeVersion(raw, pinVersion);
     if (updated !== raw) {
@@ -10983,25 +11138,25 @@ function detectHelpRequest(argv, main2) {
   const separatorIdx = argv.indexOf("--");
   if (helpIdx === -1) return null;
   if (separatorIdx !== -1 && separatorIdx < helpIdx) return null;
-  const path27 = [];
+  const path28 = [];
   const tokens = argv.slice(
     0,
     separatorIdx === -1 ? argv.length : separatorIdx
   );
   let cursor = main2;
   const mainName = (main2.meta ?? {}).name ?? "monoceros";
-  path27.push(mainName);
+  path28.push(mainName);
   for (const tok of tokens) {
     if (tok.startsWith("-")) continue;
     const subs = cursor.subCommands ?? {};
     if (tok in subs) {
       cursor = subs[tok];
-      path27.push(tok);
+      path28.push(tok);
       continue;
     }
     break;
   }
-  return { path: path27, cmd: cursor };
+  return { path: path28, cmd: cursor };
 }
 async function maybeRenderHelp(argv, main2) {
   const hit = detectHelpRequest(argv, main2);