@getmonoceros/workbench 1.33.8 → 1.34.0

package/dist/bin.js

@@ -2396,7 +2396,7 @@ var init_catalog = __esm({
     override = process.env.MONOCEROS_BASE_IMAGE_OVERRIDE?.trim();
     BASE_IMAGE = override && override.length > 0 ? override : DEFAULT_BASE_IMAGE;
     RUNTIME_IMAGE_REPO = "ghcr.io/getmonoceros/monoceros-runtime";
-    DEFAULT_RUNTIME_VERSION = true ? "1.3.6" : readFileSync3(
+    DEFAULT_RUNTIME_VERSION = true ? "1.4.0" : readFileSync3(
       fileURLToPath2(
         new URL("../../../../images/runtime/VERSION", import.meta.url)
       ),
@@ -3932,6 +3932,10 @@ function buildPostCreateScript(opts) {
     "# identity values in.",
     `git config --global include.path "/workspaces/${opts.name}/.monoceros/gitconfig"`,
     "",
+    "# Container-global gitignore: keeps each app's .monoceros/ launch-config",
+    "# dir out of the app repo by default. Per-app opt-in re-includes it.",
+    `git config --global core.excludesFile "/workspaces/${opts.name}/.monoceros/global-gitignore"`,
+    "",
     "# Per-feature post-create hooks. Each Monoceros-curated feature",
     "# may drop a script into /usr/local/share/monoceros/post-create.d/",
     "# during its install.sh \u2014 typical job is a non-interactive login",
@@ -4072,7 +4076,11 @@ async function writeScaffold(opts, targetDir, scaffoldOpts = {}) {
   }
   await fs8.writeFile(
     path11.join(monocerosDir, ".gitignore"),
-    "git-credentials*\ngitconfig\n"
+    "git-credentials*\ngitconfig\nglobal-gitignore\n"
+  );
+  await fs8.writeFile(
+    path11.join(monocerosDir, "global-gitignore"),
+    ".monoceros/\n"
   );
   const devcontainerJson = buildDevcontainerJson(opts, dockerMode);
   await writeIfChanged(
@@ -4630,8 +4638,8 @@ function removeRepoFromDoc(doc, urlOrPath) {
     if (!isMap2(item)) return false;
     const url = item.get("url");
     if (url === urlOrPath) return true;
-    const path31 = item.get("path");
-    const effectivePath = typeof path31 === "string" ? path31 : typeof url === "string" ? deriveRepoName(url) : void 0;
+    const path32 = item.get("path");
+    const effectivePath = typeof path32 === "string" ? path32 : typeof url === "string" ? deriveRepoName(url) : void 0;
     return effectivePath === urlOrPath;
   });
   if (idx < 0) return false;
@@ -4754,7 +4762,7 @@ async function runAddRepo(input) {
       "Missing repo URL. Usage: monoceros add-repo <containername> <url>."
     );
   }
-  const path31 = (input.path ?? deriveRepoName(url)).trim();
+  const path32 = (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) {
@@ -4791,7 +4799,7 @@ async function runAddRepo(input) {
   const providerToWrite = !canonical && explicitProvider ? explicitProvider : void 0;
   const entry2 = {
     url,
-    path: path31,
+    path: path32,
     ...hasName && hasEmail ? {
       gitUser: {
         name: input.gitName.trim(),
@@ -6611,10 +6619,14 @@ function spawnBridgeDaemon(root) {
     const self = process.argv[1];
     if (!self) return;
     mkdirSync(relayDir(root), { recursive: true });
-    const child = spawn8(process.execPath, [self, "__bridge", root], {
-      detached: true,
-      stdio: "ignore"
-    });
+    const child = spawn8(
+      process.execPath,
+      [...process.execArgv, self, "__bridge", root],
+      {
+        detached: true,
+        stdio: "ignore"
+      }
+    );
     if (typeof child.pid === "number") {
       try {
         writeFileSync(bridgePidFile(root), String(child.pid));
@@ -7211,46 +7223,58 @@ function generateAgentsMd(input) {
     lines.push("");
     lines.push(
       "When you build something that serves on a port (a web app, an API),",
-      "start it as a **detached** background process so it keeps running after",
-      "this session ends. A plain `npm start` (or any foreground start) dies",
-      "the moment the user exits you or closes the terminal \u2014 and then",
-      `\`${input.containerName}.localhost\` returns 502 Bad Gateway.`
+      "it must keep running after this session ends. A plain `npm start` (or",
+      "any foreground start) dies the moment the user exits you or closes the",
+      `terminal, and then \`${input.containerName}.localhost\` returns 502 Bad Gateway.`
     );
     lines.push("");
     lines.push(
-      "Launch it in a new session with `setsid`, using the project's own",
-      "start command, and record the process-group PID + log under the",
-      "container's logs directory:"
+      "Declare it in the app's own launch config at",
+      "`projects/<app>/.monoceros/launch.json`, then start it with",
+      "`monoceros-ctl`. Add or update an entry whenever you set up a",
+      "long-running server. The file travels with the app, so the human can",
+      "restart it later without knowing your start command:"
     );
     lines.push("");
-    lines.push("```");
-    lines.push(
-      `setsid sh -c 'echo $$ >/workspaces/${input.containerName}/logs/<app>.pid; \\`
-    );
+    lines.push("```json");
+    lines.push("{");
+    lines.push('  "configurations": [');
     lines.push(
-      `  exec <the project's start command> >/workspaces/${input.containerName}/logs/<app>.log 2>&1' </dev/null &`
+      `    { "name": "web", "command": "<the project's start command>", "port": ${input.ports[0]}, "default": true }`
     );
+    lines.push("  ]");
+    lines.push("}");
     lines.push("```");
     lines.push("");
     lines.push(
-      "Use whatever start command the project actually uses (`npm start`,",
-      "`./mvnw spring-boot:run`, `python app.py`, `go run .`, \u2026) \u2014 do not force",
-      "a language-specific one. `<app>` is a short name you choose."
+      "Use whatever start command the project actually uses (`npm run dev`,",
+      "`./mvnw spring-boot:run`, `python manage.py runserver`, `go run .`, \u2026).",
+      "Do not force a language-specific one. `<app>` is the path under",
+      "`projects/`; `port` must be a port already exposed on the container."
     );
     lines.push("");
-    lines.push("To stop it, kill the whole process group (also stops children");
-    lines.push("like node under npm or java under maven):");
+    lines.push("Start it, stop it, tail its log:");
     lines.push("");
     lines.push("```");
+    lines.push("monoceros-ctl start <app>");
+    lines.push("monoceros-ctl stop <app>");
+    lines.push("monoceros-ctl logs <app>");
+    lines.push("```");
+    lines.push("");
     lines.push(
-      `kill -TERM -$(cat /workspaces/${input.containerName}/logs/<app>.pid)`
+      "`start` launches it detached (it survives your session) and, when a",
+      "`port` is set, waits until it actually listens before returning. Add",
+      "`--target <name>` when the app declares more than one configuration.",
+      "The human can do the same from the host with",
+      `\`monoceros start ${input.containerName} <app>\` / \`monoceros stop ${input.containerName} <app>\`,`,
+      `and follow output with \`monoceros logs ${input.containerName} <app>\`.`
     );
-    lines.push("```");
     lines.push("");
     lines.push(
-      `The user can follow the output with \`monoceros logs ${input.containerName} <app>\``,
-      "on the host. The server must listen on `0.0.0.0` (not `127.0.0.1`) on",
-      "the exposed port, or Traefik cannot reach it."
+      "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",
+      "declared on the container; if you need another, ask the human to add it",
+      `on the host (\`monoceros add-port ${input.containerName} <port>\`) and re-apply.`
     );
     lines.push("");
   }
@@ -8661,7 +8685,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "1.33.8" : "dev";
+    CLI_VERSION = true ? "1.34.0" : "dev";
   }
 });
 
@@ -8894,9 +8918,144 @@ var init_bridge = __esm({
   }
 });
 
-// src/completion/resolve.ts
-import { existsSync as existsSync15, promises as fs14 } from "fs";
+// src/config/launch-config.ts
+import { promises as fs14 } from "fs";
 import path24 from "path";
+function launchConfigPath(name, appRel, home) {
+  return path24.join(
+    containerDir(name, home),
+    "projects",
+    appRel,
+    LAUNCH_DIRNAME,
+    LAUNCH_FILENAME
+  );
+}
+function validate(parsed, where) {
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new Error(`${where}: expected a JSON object`);
+  }
+  const obj = parsed;
+  if (!Array.isArray(obj.configurations)) {
+    throw new Error(`${where}: missing "configurations" array`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  let defaults = 0;
+  const configurations = obj.configurations.map((raw, i) => {
+    if (typeof raw !== "object" || raw === null) {
+      throw new Error(`${where}: configuration #${i} is not an object`);
+    }
+    const t = raw;
+    if (typeof t.name !== "string" || t.name.length === 0) {
+      throw new Error(`${where}: configuration #${i} is missing "name"`);
+    }
+    if (seen.has(t.name)) {
+      throw new Error(`${where}: duplicate target name "${t.name}"`);
+    }
+    seen.add(t.name);
+    if (typeof t.command !== "string" || t.command.length === 0) {
+      throw new Error(`${where}: target "${t.name}" is missing "command"`);
+    }
+    if (t.default === true) defaults += 1;
+    return {
+      name: t.name,
+      command: t.command,
+      ...typeof t.cwd === "string" ? { cwd: t.cwd } : {},
+      ...typeof t.port === "number" ? { port: t.port } : {},
+      ...t.env && typeof t.env === "object" ? { env: t.env } : {},
+      ...t.default === true ? { default: true } : {}
+    };
+  });
+  if (defaults > 1) {
+    throw new Error(`${where}: more than one target marked "default"`);
+  }
+  return {
+    version: typeof obj.version === "number" ? obj.version : 1,
+    configurations
+  };
+}
+async function readLaunchConfig(name, appRel, home) {
+  const file = launchConfigPath(name, appRel, home);
+  let content;
+  try {
+    content = await fs14.readFile(file, "utf8");
+  } catch {
+    return void 0;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch (err) {
+    throw new Error(
+      `${file}: invalid JSON (${err instanceof Error ? err.message : String(err)})`
+    );
+  }
+  return validate(parsed, file);
+}
+function resolveTarget(config, targetName, appRel) {
+  if (targetName) {
+    const found = config.configurations.find((t) => t.name === targetName);
+    if (!found) {
+      throw new Error(
+        `No target "${targetName}" in ${appRel} (have: ${config.configurations.map((t) => t.name).join(", ") || "none"})`
+      );
+    }
+    return found;
+  }
+  const marked = config.configurations.find((t) => t.default);
+  if (marked) return marked;
+  if (config.configurations.length === 1) return config.configurations[0];
+  throw new Error(
+    `${appRel} has ${config.configurations.length} targets and no default \u2014 pass --target (${config.configurations.map((t) => t.name).join(", ")})`
+  );
+}
+async function listApps(name, home) {
+  const projectsRoot = path24.join(containerDir(name, home), "projects");
+  const out = [];
+  async function walk(at, rel, depth) {
+    let entries;
+    try {
+      entries = await fs14.readdir(at, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    const hasLaunch = entries.some(
+      (e) => e.isDirectory() && e.name === LAUNCH_DIRNAME
+    );
+    if (hasLaunch) {
+      try {
+        await fs14.access(path24.join(at, LAUNCH_DIRNAME, LAUNCH_FILENAME));
+        if (rel) out.push(rel);
+      } catch {
+      }
+    }
+    if (depth >= APP_SEARCH_MAX_DEPTH) return;
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      if (e.name.startsWith(".")) continue;
+      await walk(
+        path24.join(at, e.name),
+        rel ? `${rel}/${e.name}` : e.name,
+        depth + 1
+      );
+    }
+  }
+  await walk(projectsRoot, "", 0);
+  return out.sort();
+}
+var LAUNCH_DIRNAME, LAUNCH_FILENAME, APP_SEARCH_MAX_DEPTH;
+var init_launch_config = __esm({
+  "src/config/launch-config.ts"() {
+    "use strict";
+    init_paths();
+    LAUNCH_DIRNAME = ".monoceros";
+    LAUNCH_FILENAME = "launch.json";
+    APP_SEARCH_MAX_DEPTH = 4;
+  }
+});
+
+// src/completion/resolve.ts
+import { existsSync as existsSync15, promises as fs15 } from "fs";
+import path25 from "path";
 async function resolveCompletions(line, point, opts = {}) {
   const { prev, current } = parseCompletionLine(line, point);
   const ctx = { prev, current, opts };
@@ -9045,9 +9204,9 @@ function filterPrefix(values, fragment) {
 }
 async function listContainerNames(ctx) {
   const home = ctx.opts.monocerosHome ?? monocerosHome();
-  const dir = path24.join(home, "container-configs");
+  const dir = path25.join(home, "container-configs");
   if (!existsSync15(dir)) return [];
-  const entries = await fs14.readdir(dir);
+  const entries = await fs15.readdir(dir);
   return entries.filter((e) => e.endsWith(".yml")).map((e) => e.slice(0, -".yml".length)).sort();
 }
 function containerNameFromCtx(ctx) {
@@ -9059,12 +9218,42 @@ function containerNameFromCtx(ctx) {
   }
   return void 0;
 }
+function positionalFromCtx(ctx, n) {
+  const positionals = [];
+  for (let i = 2; i < ctx.prev.length; i++) {
+    const t = ctx.prev[i];
+    if (t === "--") break;
+    if (t.startsWith("-")) continue;
+    positionals.push(t);
+  }
+  return positionals[n];
+}
+async function listAppCandidates(ctx) {
+  const name = containerNameFromCtx(ctx);
+  if (!name) return [];
+  try {
+    return await listApps(name, ctx.opts.monocerosHome);
+  } catch {
+    return [];
+  }
+}
+async function listTargetCandidates(ctx) {
+  const name = containerNameFromCtx(ctx);
+  const app = positionalFromCtx(ctx, 1);
+  if (!name || !app) return [];
+  try {
+    const cfg = await readLaunchConfig(name, app, ctx.opts.monocerosHome);
+    return cfg ? cfg.configurations.map((t) => t.name) : [];
+  } catch {
+    return [];
+  }
+}
 async function collectDirs(dir, maxDepth) {
   const out = [];
   async function walk(at, rel, depth) {
     let entries;
     try {
-      entries = await fs14.readdir(at, { withFileTypes: true });
+      entries = await fs15.readdir(at, { withFileTypes: true });
     } catch {
       return;
     }
@@ -9075,7 +9264,7 @@ async function collectDirs(dir, maxDepth) {
       const childRel = rel ? `${rel}/${e.name}` : e.name;
       out.push(childRel);
       if (depth + 1 < maxDepth) {
-        await walk(path24.join(at, e.name), childRel, depth + 1);
+        await walk(path25.join(at, e.name), childRel, depth + 1);
       }
     }
   }
@@ -9083,9 +9272,9 @@ async function collectDirs(dir, maxDepth) {
   return out;
 }
 async function listContainerWorkspaceDirs(home, name) {
-  const root = path24.join(home, "container", name);
+  const root = path25.join(home, "container", name);
   const top = await collectDirs(root, 1);
-  const projects = (await collectDirs(path24.join(root, "projects"), PROJECTS_DIR_MAX_DEPTH)).map((p) => `projects/${p}`);
+  const projects = (await collectDirs(path25.join(root, "projects"), PROJECTS_DIR_MAX_DEPTH)).map((p) => `projects/${p}`);
   return [.../* @__PURE__ */ new Set([...top, ...projects])].sort();
 }
 async function listRunInDirs(ctx) {
@@ -9161,6 +9350,7 @@ var init_resolve = __esm({
   "src/completion/resolve.ts"() {
     "use strict";
     init_paths();
+    init_launch_config();
     init_components();
     init_manifest();
     init_catalog();
@@ -9170,6 +9360,7 @@ var init_resolve = __esm({
     PROJECTS_DIR_MAX_DEPTH = 4;
     ALL_COMMANDS = [
       "init",
+      "list-apps",
       "list-components",
       "shell",
       "open",
@@ -9246,13 +9437,27 @@ var init_resolve = __esm({
         positionals: [containerName],
         flags: { "--in": { type: "value", values: (ctx) => listRunInDirs(ctx) } }
       },
-      logs: { positionals: [containerName] },
+      logs: {
+        positionals: [containerName, (ctx) => listAppCandidates(ctx)],
+        flags: {
+          "--target": { type: "value", values: (ctx) => listTargetCandidates(ctx) }
+        }
+      },
       start: {
-        positionals: [containerName],
-        flags: { "--open": { type: "value", values: () => [...OPEN_TOOLS] } }
+        positionals: [containerName, (ctx) => listAppCandidates(ctx)],
+        flags: {
+          "--target": { type: "value", values: (ctx) => listTargetCandidates(ctx) },
+          "--open": { type: "value", values: () => [...OPEN_TOOLS] }
+        }
+      },
+      stop: {
+        positionals: [containerName, (ctx) => listAppCandidates(ctx)],
+        flags: {
+          "--target": { type: "value", values: (ctx) => listTargetCandidates(ctx) }
+        }
       },
-      stop: { positionals: [containerName] },
       status: { positionals: [containerName] },
+      "list-apps": { positionals: [containerName] },
       "add-language": {
         positionals: [containerName, () => listLanguageNames()]
       },
@@ -9915,8 +10120,8 @@ var init_generator = __esm({
 });
 
 // src/init/index.ts
-import { existsSync as existsSync16, promises as fs15 } from "fs";
-import path25 from "path";
+import { existsSync as existsSync16, promises as fs16 } from "fs";
+import path26 from "path";
 import { consola as consola16 } from "consola";
 async function runInit(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
@@ -9935,7 +10140,7 @@ async function runInit(opts) {
       `Config already exists: ${dest}. Delete it manually before re-running \`monoceros init\` \u2014 this protects any hand-edits.`
     );
   }
-  const componentsRoot = opts.workbenchRoot ? path25.join(opts.workbenchRoot, "components") : componentsRootDir();
+  const componentsRoot = opts.workbenchRoot ? path26.join(opts.workbenchRoot, "components") : componentsRootDir();
   const catalog = await loadComponentCatalog(componentsRoot);
   if (catalog.size === 0) {
     throw new Error(
@@ -10001,9 +10206,9 @@ async function runInit(opts) {
   } else {
     text = generateComposedYml(opts.name, composed, lookup, repos, ports);
   }
-  await fs15.mkdir(containerConfigsDir(home), { recursive: true });
+  await fs16.mkdir(containerConfigsDir(home), { recursive: true });
   await ensureEnvGitignored(containerConfigsDir(home));
-  await fs15.writeFile(dest, text, "utf8");
+  await fs16.writeFile(dest, text, "utf8");
   const envPath = containerEnvPath(opts.name, home);
   const seedVars = {};
   for (const f of composed.features) {
@@ -10026,8 +10231,8 @@ async function runInit(opts) {
   }
   await ensureEnvVars(envPath, opts.name, seedVars);
   const documented = !anyComposed;
-  const ymlRel = path25.relative(home, dest);
-  const envRel = path25.relative(home, envPath);
+  const ymlRel = path26.relative(home, dest);
+  const envRel = path26.relative(home, envPath);
   if (documented) {
     logger.success(`Wrote documented default to ${ymlRel} and ${envRel}.`);
     logger.info(
@@ -10305,6 +10510,75 @@ var init_init2 = __esm({
   }
 });
 
+// src/commands/list-apps.ts
+import { defineCommand as defineCommand14 } from "citty";
+import { consola as consola18 } from "consola";
+var listAppsCommand;
+var init_list_apps = __esm({
+  "src/commands/list-apps.ts"() {
+    "use strict";
+    init_launch_config();
+    init_format();
+    listAppsCommand = defineCommand14({
+      meta: {
+        name: "list-apps",
+        group: "discovery",
+        description: "List the apps under the named container that declare a launch config (projects/<app>/.monoceros/launch.json), with their targets and which is the default. Pure host-side filesystem read \u2014 works with the container stopped. Parallels `list-components`."
+      },
+      args: {
+        name: {
+          type: "positional",
+          description: "Container name (yml in $MONOCEROS_HOME/container-configs/).",
+          required: true
+        }
+      },
+      async run({ args }) {
+        try {
+          const apps = await listApps(args.name);
+          if (apps.length === 0) {
+            consola18.info(
+              `No apps with a launch config under "${args.name}" (projects/<app>/.monoceros/launch.json).`
+            );
+            process.exit(0);
+          }
+          const fmt = colorsFor(process.stdout);
+          const isTty2 = process.stdout.isTTY ?? false;
+          for (const app of apps) {
+            const cfg = await readLaunchConfig(args.name, app);
+            if (!cfg) continue;
+            if (isTty2) {
+              process.stdout.write(`${fmt.cyan(app)}
+`);
+            } else {
+              process.stdout.write(`${app}
+`);
+            }
+            for (const t of cfg.configurations) {
+              const flags = [];
+              if (t.default) flags.push("default");
+              if (typeof t.port === "number") flags.push(`port ${t.port}`);
+              const suffix = flags.length > 0 ? `  (${flags.join(", ")})` : "";
+              if (isTty2) {
+                process.stdout.write(`  ${t.name}${suffix}
+`);
+              } else {
+                process.stdout.write(
+                  `${app}	${t.name}	${t.default ? "default" : ""}	${t.port ?? ""}
+`
+                );
+              }
+            }
+          }
+          process.exit(0);
+        } catch (err) {
+          consola18.error(err instanceof Error ? err.message : String(err));
+          process.exit(1);
+        }
+      }
+    });
+  }
+});
+
 // src/catalog/expand.ts
 function expandSelectable(catalog) {
   const out = /* @__PURE__ */ new Map();
@@ -10413,8 +10687,8 @@ var init_catalog_json = __esm({
 });
 
 // src/commands/list-components.ts
-import { defineCommand as defineCommand14 } from "citty";
-import { consola as consola18 } from "consola";
+import { defineCommand as defineCommand15 } from "citty";
+import { consola as consola19 } from "consola";
 var CATEGORY_LABELS, CATEGORY_ORDER, listComponentsCommand;
 var init_list_components = __esm({
   "src/commands/list-components.ts"() {
@@ -10434,7 +10708,7 @@ var init_list_components = __esm({
       "service",
       "feature"
     ];
-    listComponentsCommand = defineCommand14({
+    listComponentsCommand = defineCommand15({
       meta: {
         name: "list-components",
         group: "discovery",
@@ -10457,7 +10731,7 @@ var init_list_components = __esm({
           }
           const catalog = expandSelectable(descriptors);
           if (catalog.size === 0) {
-            consola18.warn(
+            consola19.warn(
               "No components found. The workbench checkout looks incomplete."
             );
             process.exit(0);
@@ -10508,7 +10782,7 @@ var init_list_components = __esm({
           }
           process.exit(0);
         } catch (err) {
-          consola18.error(err instanceof Error ? err.message : String(err));
+          consola19.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -10518,9 +10792,9 @@ var init_list_components = __esm({
 
 // src/commands/logs.ts
 import { spawn as spawn13 } from "child_process";
-import { existsSync as existsSync17 } from "fs";
-import path26 from "path";
-import { defineCommand as defineCommand15 } from "citty";
+import path27 from "path";
+import { defineCommand as defineCommand16 } from "citty";
+import { consola as consola20 } from "consola";
 function tailLogFile(file, follow) {
   const [cmd, args] = follow ? ["tail", ["-F", file]] : ["cat", [file]];
   return new Promise((resolve, reject) => {
@@ -10534,13 +10808,14 @@ var init_logs = __esm({
   "src/commands/logs.ts"() {
     "use strict";
     init_paths();
+    init_launch_config();
     init_compose();
     init_dispatch();
-    logsCommand = defineCommand15({
+    logsCommand = defineCommand16({
       meta: {
         name: "logs",
         group: "run",
-        description: "Tail logs from a compose service of the named dev-container, or from a long-running app started inside it (logs/<app>.log). Pass --no-follow for a one-shot dump."
+        description: "Tail logs from a compose service of the named dev-container, or from a long-running app started inside it. Pass --no-follow for a one-shot dump."
       },
       args: {
         name: {
@@ -10548,9 +10823,14 @@ var init_logs = __esm({
           description: "Container name (yml in $MONOCEROS_HOME/container-configs/).",
           required: true
         },
-        service: {
+        app: {
+          type: "positional",
+          description: "An app (a path under projects/ with .monoceros/launch.json) whose log to tail, or a compose service (e.g. postgres). Defaults to all compose services.",
+          required: false
+        },
+        target: {
           type: "string",
-          description: "A compose service (e.g. postgres) or an app whose log is at logs/<service>.log. Defaults to all compose services."
+          description: 'Which launch target of the app to tail (defaults to its "default" target, or its only one).'
         },
         follow: {
           type: "boolean",
@@ -10560,34 +10840,47 @@ var init_logs = __esm({
         }
       },
       run({ args }) {
-        const service = typeof args.service === "string" ? args.service : void 0;
-        if (service) {
-          const logFile = path26.join(containerLogsDir(args.name), `${service}.log`);
-          if (existsSync17(logFile)) {
-            return dispatch(() => tailLogFile(logFile, args.follow));
+        const app = typeof args.app === "string" ? args.app : void 0;
+        const target = typeof args.target === "string" ? args.target : void 0;
+        return dispatch(async () => {
+          if (app) {
+            const cfg = await readLaunchConfig(args.name, app);
+            if (cfg) {
+              const t = resolveTarget(cfg, target, app);
+              const logFile = path27.join(
+                containerLogsDir(args.name),
+                app,
+                `${t.name}.log`
+              );
+              return tailLogFile(logFile, args.follow);
+            }
+            if (target) {
+              consola20.warn(
+                `No launch config for "${app}" \u2014 ignoring --target and treating "${app}" as a compose service.`
+              );
+            }
+            return runLogs({
+              root: containerDir(args.name),
+              service: app,
+              follow: args.follow
+            });
           }
-        }
-        return dispatch(
-          () => runLogs({
-            root: containerDir(args.name),
-            ...service ? { service } : {},
-            follow: args.follow
-          })
-        );
+          return runLogs({ root: containerDir(args.name), follow: args.follow });
+        });
       }
     });
   }
 });
 
 // src/commands/open.ts
-import { defineCommand as defineCommand16 } from "citty";
+import { defineCommand as defineCommand17 } from "citty";
 var openCommand;
 var init_open2 = __esm({
   "src/commands/open.ts"() {
     "use strict";
     init_open();
     init_dispatch();
-    openCommand = defineCommand16({
+    openCommand = defineCommand17({
       meta: {
         name: "open",
         group: "run",
@@ -10613,11 +10906,11 @@ var init_open2 = __esm({
 });
 
 // src/commands/port.ts
-import { defineCommand as defineCommand17 } from "citty";
-import { consola as consola19 } from "consola";
+import { defineCommand as defineCommand18 } from "citty";
+import { consola as consola21 } from "consola";
 async function runPortListing(opts) {
   const out = opts.out ?? process.stdout;
-  const info = opts.info ?? ((m) => consola19.info(m));
+  const info = opts.info ?? ((m) => consola21.info(m));
   const parsed = await readConfig(
     containerConfigPath(opts.name, opts.monocerosHome)
   );
@@ -10675,7 +10968,7 @@ var init_port = __esm({
     init_schema();
     init_dynamic();
     init_format();
-    portCommand = defineCommand17({
+    portCommand = defineCommand18({
       meta: {
         name: "port",
         group: "discovery",
@@ -10693,7 +10986,7 @@ var init_port = __esm({
           const code = await runPortListing({ name: args.name });
           process.exit(code);
         } catch (err) {
-          consola19.error(err instanceof Error ? err.message : String(err));
+          consola21.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -10702,15 +10995,15 @@ var init_port = __esm({
 });
 
 // src/commands/remove-apt-packages.ts
-import { defineCommand as defineCommand18 } from "citty";
-import { consola as consola20 } from "consola";
+import { defineCommand as defineCommand19 } from "citty";
+import { consola as consola22 } from "consola";
 var removeAptPackagesCommand;
 var init_remove_apt_packages = __esm({
   "src/commands/remove-apt-packages.ts"() {
     "use strict";
     init_inner_args();
     init_modify();
-    removeAptPackagesCommand = defineCommand18({
+    removeAptPackagesCommand = defineCommand19({
       meta: {
         name: "remove-apt-packages",
         group: "edit",
@@ -10732,7 +11025,7 @@ var init_remove_apt_packages = __esm({
       async run({ args }) {
         const packages = [...getInnerArgs()];
         if (packages.length === 0) {
-          consola20.error(
+          consola22.error(
             "No package names given. Usage: `monoceros remove-apt-packages <containername> [--yes] -- <pkg> [<pkg> \u2026]`."
           );
           process.exit(1);
@@ -10745,7 +11038,7 @@ var init_remove_apt_packages = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola20.error(err instanceof Error ? err.message : String(err));
+          consola22.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -10754,14 +11047,14 @@ var init_remove_apt_packages = __esm({
 });
 
 // src/commands/remove-feature.ts
-import { defineCommand as defineCommand19 } from "citty";
-import { consola as consola21 } from "consola";
+import { defineCommand as defineCommand20 } from "citty";
+import { consola as consola23 } from "consola";
 var removeFeatureCommand;
 var init_remove_feature = __esm({
   "src/commands/remove-feature.ts"() {
     "use strict";
     init_modify();
-    removeFeatureCommand = defineCommand19({
+    removeFeatureCommand = defineCommand20({
       meta: {
         name: "remove-feature",
         group: "edit",
@@ -10794,7 +11087,7 @@ var init_remove_feature = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola21.error(err instanceof Error ? err.message : String(err));
+          consola23.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -10803,15 +11096,15 @@ var init_remove_feature = __esm({
 });
 
 // src/remove/index.ts
-import { existsSync as existsSync18, promises as fs16 } from "fs";
-import path27 from "path";
-import { consola as consola22 } from "consola";
+import { existsSync as existsSync17, promises as fs17 } from "fs";
+import path28 from "path";
+import { consola as consola24 } from "consola";
 async function runRemove(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
   const logger = opts.logger ?? {
-    info: (msg) => consola22.info(msg),
-    success: (msg) => consola22.success(msg),
-    warn: (msg) => consola22.warn(msg)
+    info: (msg) => consola24.info(msg),
+    success: (msg) => consola24.success(msg),
+    warn: (msg) => consola24.warn(msg)
   };
   if (!REGEX.solutionName.test(opts.name)) {
     throw new Error(
@@ -10821,9 +11114,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 = existsSync18(ymlPath);
-  const hasEnv = existsSync18(envPath);
-  const hasContainer = existsSync18(containerPath);
+  const hasYml = existsSync17(ymlPath);
+  const hasEnv = existsSync17(envPath);
+  const hasContainer = existsSync17(containerPath);
   if (!hasYml && !hasContainer) {
     throw new Error(
       `Nothing to remove for '${opts.name}': neither ${ymlPath} nor ${containerPath} exists.`
@@ -10849,16 +11142,16 @@ async function runRemove(opts) {
   let backupPath = null;
   if (!opts.noBackup && (hasYml || hasContainer)) {
     const ts = (opts.now ?? /* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    backupPath = path27.join(home, "container-backups", `${opts.name}-${ts}`);
-    await fs16.mkdir(backupPath, { recursive: true });
+    backupPath = path28.join(home, "container-backups", `${opts.name}-${ts}`);
+    await fs17.mkdir(backupPath, { recursive: true });
     if (hasYml) {
-      await fs16.copyFile(ymlPath, path27.join(backupPath, `${opts.name}.yml`));
+      await fs17.copyFile(ymlPath, path28.join(backupPath, `${opts.name}.yml`));
     }
     if (hasEnv) {
-      await fs16.copyFile(envPath, path27.join(backupPath, `${opts.name}.env`));
+      await fs17.copyFile(envPath, path28.join(backupPath, `${opts.name}.env`));
     }
     if (hasContainer) {
-      await fs16.cp(containerPath, path27.join(backupPath, "container"), {
+      await fs17.cp(containerPath, path28.join(backupPath, "container"), {
         recursive: true
       });
     }
@@ -10868,14 +11161,14 @@ async function runRemove(opts) {
     await stopBridgeDaemon(containerPath);
   }
   if (hasYml) {
-    await fs16.rm(ymlPath, { force: true });
+    await fs17.rm(ymlPath, { force: true });
   }
   if (hasEnv) {
-    await fs16.rm(envPath, { force: true });
+    await fs17.rm(envPath, { force: true });
   }
   if (hasContainer) {
     try {
-      await fs16.rm(containerPath, { recursive: true, force: true });
+      await fs17.rm(containerPath, { recursive: true, force: true });
     } catch (err) {
       const code = err.code;
       if (code !== "EACCES" && code !== "EPERM") {
@@ -10897,7 +11190,7 @@ async function runRemove(opts) {
         "-delete"
       ]);
       try {
-        await fs16.rm(containerPath, { recursive: true, force: true });
+        await fs17.rm(containerPath, { recursive: true, force: true });
       } catch (err2) {
         const code2 = err2.code;
         throw new Error(
@@ -10961,15 +11254,15 @@ var init_remove = __esm({
 });
 
 // src/commands/remove.ts
-import { defineCommand as defineCommand20 } from "citty";
-import { consola as consola23 } from "consola";
+import { defineCommand as defineCommand21 } from "citty";
+import { consola as consola25 } from "consola";
 import { createInterface } from "readline/promises";
 var removeCommand;
 var init_remove2 = __esm({
   "src/commands/remove.ts"() {
     "use strict";
     init_remove();
-    removeCommand = defineCommand20({
+    removeCommand = defineCommand21({
       meta: {
         name: "remove",
         group: "lifecycle",
@@ -11006,7 +11299,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.`;
-            consola23.warn(warning);
+            consola25.warn(warning);
             const rl = createInterface({
               input: process.stdin,
               output: process.stdout
@@ -11014,7 +11307,7 @@ var init_remove2 = __esm({
             const answer = await rl.question("Continue? [y/N] ");
             rl.close();
             if (!/^y(es)?$/i.test(answer.trim())) {
-              consola23.info("Aborted. Nothing changed.");
+              consola25.info("Aborted. Nothing changed.");
               process.exit(0);
             }
           }
@@ -11023,7 +11316,7 @@ var init_remove2 = __esm({
             ...noBackup ? { noBackup: true } : {}
           });
         } catch (err) {
-          consola23.error(err instanceof Error ? err.message : String(err));
+          consola25.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11032,24 +11325,24 @@ var init_remove2 = __esm({
 });
 
 // src/restore/index.ts
-import { existsSync as existsSync19, promises as fs17 } from "fs";
-import path28 from "path";
-import { consola as consola24 } from "consola";
+import { existsSync as existsSync18, promises as fs18 } from "fs";
+import path29 from "path";
+import { consola as consola26 } from "consola";
 async function runRestore(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
   const logger = opts.logger ?? {
-    info: (msg) => consola24.info(msg),
-    success: (msg) => consola24.success(msg)
+    info: (msg) => consola26.info(msg),
+    success: (msg) => consola26.success(msg)
   };
-  const backup = path28.resolve(opts.backupPath);
-  if (!existsSync19(backup)) {
+  const backup = path29.resolve(opts.backupPath);
+  if (!existsSync18(backup)) {
     throw new Error(`Backup not found: ${backup}.`);
   }
-  const stat = await fs17.stat(backup);
+  const stat = await fs18.stat(backup);
   if (!stat.isDirectory()) {
     throw new Error(`Backup path is not a directory: ${backup}.`);
   }
-  const entries = await fs17.readdir(backup);
+  const entries = await fs18.readdir(backup);
   const ymlFiles = entries.filter((f) => f.endsWith(".yml"));
   if (ymlFiles.length === 0) {
     throw new Error(
@@ -11063,29 +11356,29 @@ async function runRestore(opts) {
   }
   const ymlFile = ymlFiles[0];
   const name = ymlFile.replace(/\.yml$/, "");
-  const containerInBackup = path28.join(backup, "container");
-  const hasContainer = existsSync19(containerInBackup);
-  const envInBackup = path28.join(backup, `${name}.env`);
-  const hasEnv = existsSync19(envInBackup);
+  const containerInBackup = path29.join(backup, "container");
+  const hasContainer = existsSync18(containerInBackup);
+  const envInBackup = path29.join(backup, `${name}.env`);
+  const hasEnv = existsSync18(envInBackup);
   const destYml = containerConfigPath(name, home);
   const destContainer = containerDir(name, home);
-  if (existsSync19(destYml)) {
+  if (existsSync18(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 && existsSync19(destContainer)) {
+  if (hasContainer && existsSync18(destContainer)) {
     throw new Error(
       `Refusing to restore: ${destContainer} already exists. Remove the current container first (\`monoceros remove ${name}\`).`
     );
   }
-  await fs17.mkdir(containerConfigsDir(home), { recursive: true });
-  await fs17.copyFile(path28.join(backup, ymlFile), destYml);
+  await fs18.mkdir(containerConfigsDir(home), { recursive: true });
+  await fs18.copyFile(path29.join(backup, ymlFile), destYml);
   if (hasEnv) {
-    await fs17.copyFile(envInBackup, containerEnvPath(name, home));
+    await fs18.copyFile(envInBackup, containerEnvPath(name, home));
   }
   if (hasContainer) {
-    await fs17.cp(containerInBackup, destContainer, { recursive: true });
+    await fs18.cp(containerInBackup, destContainer, { recursive: true });
   }
   logger.success(`Restored '${name}' from ${prettyPath(backup)}.`);
   logger.info(
@@ -11105,14 +11398,14 @@ var init_restore = __esm({
 });
 
 // src/commands/restore.ts
-import { defineCommand as defineCommand21 } from "citty";
-import { consola as consola25 } from "consola";
+import { defineCommand as defineCommand22 } from "citty";
+import { consola as consola27 } from "consola";
 var restoreCommand;
 var init_restore2 = __esm({
   "src/commands/restore.ts"() {
     "use strict";
     init_restore();
-    restoreCommand = defineCommand21({
+    restoreCommand = defineCommand22({
       meta: {
         name: "restore",
         group: "lifecycle",
@@ -11129,7 +11422,7 @@ var init_restore2 = __esm({
         try {
           await runRestore({ backupPath: args["backup-path"] });
         } catch (err) {
-          consola25.error(err instanceof Error ? err.message : String(err));
+          consola27.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11138,14 +11431,14 @@ var init_restore2 = __esm({
 });
 
 // src/commands/remove-from-url.ts
-import { defineCommand as defineCommand22 } from "citty";
-import { consola as consola26 } from "consola";
+import { defineCommand as defineCommand23 } from "citty";
+import { consola as consola28 } from "consola";
 var removeFromUrlCommand;
 var init_remove_from_url = __esm({
   "src/commands/remove-from-url.ts"() {
     "use strict";
     init_modify();
-    removeFromUrlCommand = defineCommand22({
+    removeFromUrlCommand = defineCommand23({
       meta: {
         name: "remove-from-url",
         group: "edit",
@@ -11178,7 +11471,7 @@ var init_remove_from_url = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola26.error(err instanceof Error ? err.message : String(err));
+          consola28.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11187,14 +11480,14 @@ var init_remove_from_url = __esm({
 });
 
 // src/commands/remove-language.ts
-import { defineCommand as defineCommand23 } from "citty";
-import { consola as consola27 } from "consola";
+import { defineCommand as defineCommand24 } from "citty";
+import { consola as consola29 } from "consola";
 var removeLanguageCommand;
 var init_remove_language = __esm({
   "src/commands/remove-language.ts"() {
     "use strict";
     init_modify();
-    removeLanguageCommand = defineCommand23({
+    removeLanguageCommand = defineCommand24({
       meta: {
         name: "remove-language",
         group: "edit",
@@ -11227,7 +11520,7 @@ var init_remove_language = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola27.error(err instanceof Error ? err.message : String(err));
+          consola29.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11236,8 +11529,8 @@ var init_remove_language = __esm({
 });
 
 // src/commands/remove-port.ts
-import { defineCommand as defineCommand24 } from "citty";
-import { consola as consola28 } from "consola";
+import { defineCommand as defineCommand25 } from "citty";
+import { consola as consola30 } from "consola";
 function coerceToken2(raw) {
   const n = Number(raw);
   return Number.isFinite(n) ? n : raw;
@@ -11248,7 +11541,7 @@ var init_remove_port = __esm({
     "use strict";
     init_inner_args();
     init_modify();
-    removePortCommand = defineCommand24({
+    removePortCommand = defineCommand25({
       meta: {
         name: "remove-port",
         group: "edit",
@@ -11270,7 +11563,7 @@ var init_remove_port = __esm({
       async run({ args }) {
         const tokens = [...getInnerArgs()];
         if (tokens.length === 0) {
-          consola28.error(
+          consola30.error(
             "No ports given. Usage: `monoceros remove-port <containername> [--yes] -- <port> [<port> \u2026]`."
           );
           process.exit(1);
@@ -11283,7 +11576,7 @@ var init_remove_port = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola28.error(err instanceof Error ? err.message : String(err));
+          consola30.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11292,14 +11585,14 @@ var init_remove_port = __esm({
 });
 
 // src/commands/remove-repo.ts
-import { defineCommand as defineCommand25 } from "citty";
-import { consola as consola29 } from "consola";
+import { defineCommand as defineCommand26 } from "citty";
+import { consola as consola31 } from "consola";
 var removeRepoCommand;
 var init_remove_repo = __esm({
   "src/commands/remove-repo.ts"() {
     "use strict";
     init_modify();
-    removeRepoCommand = defineCommand25({
+    removeRepoCommand = defineCommand26({
       meta: {
         name: "remove-repo",
         group: "edit",
@@ -11332,7 +11625,7 @@ var init_remove_repo = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola29.error(err instanceof Error ? err.message : String(err));
+          consola31.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11341,14 +11634,14 @@ var init_remove_repo = __esm({
 });
 
 // src/commands/remove-service.ts
-import { defineCommand as defineCommand26 } from "citty";
-import { consola as consola30 } from "consola";
+import { defineCommand as defineCommand27 } from "citty";
+import { consola as consola32 } from "consola";
 var removeServiceCommand;
 var init_remove_service = __esm({
   "src/commands/remove-service.ts"() {
     "use strict";
     init_modify();
-    removeServiceCommand = defineCommand26({
+    removeServiceCommand = defineCommand27({
       meta: {
         name: "remove-service",
         group: "edit",
@@ -11381,7 +11674,7 @@ var init_remove_service = __esm({
           });
           process.exit(result.status === "aborted" ? 1 : 0);
         } catch (err) {
-          consola30.error(err instanceof Error ? err.message : String(err));
+          consola32.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11390,16 +11683,16 @@ var init_remove_service = __esm({
 });
 
 // src/devcontainer/claude-trust.ts
-import { existsSync as existsSync20, promises as fsp7 } from "fs";
-import path29 from "path";
+import { existsSync as existsSync19, promises as fsp7 } from "fs";
+import path30 from "path";
 function resolveContainerCwd(name, cwd) {
   const workspace = `/workspaces/${name}`;
   if (!cwd) return workspace;
-  return path29.posix.isAbsolute(cwd) ? cwd : path29.posix.join(workspace, cwd);
+  return path30.posix.isAbsolute(cwd) ? cwd : path30.posix.join(workspace, cwd);
 }
 async function preApproveClaudeProject(opts) {
-  const file = path29.join(opts.root, "home", ".claude.json");
-  if (!existsSync20(file)) return;
+  const file = path30.join(opts.root, "home", ".claude.json");
+  if (!existsSync19(file)) return;
   try {
     const raw = await fsp7.readFile(file, "utf8");
     const config = raw.trim() ? JSON.parse(raw) : {};
@@ -11490,8 +11783,8 @@ var init_run = __esm({
 });
 
 // src/commands/run.ts
-import { defineCommand as defineCommand27 } from "citty";
-import { consola as consola31 } from "consola";
+import { defineCommand as defineCommand28 } from "citty";
+import { consola as consola33 } from "consola";
 var runCommand;
 var init_run2 = __esm({
   "src/commands/run.ts"() {
@@ -11499,7 +11792,7 @@ var init_run2 = __esm({
     init_paths();
     init_run();
     init_inner_args();
-    runCommand = defineCommand27({
+    runCommand = defineCommand28({
       meta: {
         name: "run",
         group: "run",
@@ -11519,7 +11812,7 @@ var init_run2 = __esm({
       async run({ args }) {
         const command = [...getInnerArgs()];
         if (command.length === 0) {
-          consola31.error(
+          consola33.error(
             "No command provided. Usage: `monoceros run <containername> -- <cmd> [args\u2026]`."
           );
           process.exit(1);
@@ -11533,7 +11826,7 @@ var init_run2 = __esm({
           });
           process.exit(exitCode);
         } catch (err) {
-          consola31.error(err instanceof Error ? err.message : String(err));
+          consola33.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11542,15 +11835,15 @@ var init_run2 = __esm({
 });
 
 // src/commands/shell.ts
-import { defineCommand as defineCommand28 } from "citty";
-import { consola as consola32 } from "consola";
+import { defineCommand as defineCommand29 } from "citty";
+import { consola as consola34 } from "consola";
 var shellCommand;
 var init_shell2 = __esm({
   "src/commands/shell.ts"() {
     "use strict";
     init_paths();
     init_shell();
-    shellCommand = defineCommand28({
+    shellCommand = defineCommand29({
       meta: {
         name: "shell",
         group: "run",
@@ -11571,7 +11864,7 @@ var init_shell2 = __esm({
           });
           process.exit(exitCode);
         } catch (err) {
-          consola32.error(err instanceof Error ? err.message : String(err));
+          consola34.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -11579,9 +11872,94 @@ var init_shell2 = __esm({
   }
 });
 
+// src/devcontainer/app-control.ts
+function findRunningContainer(name, opts = {}) {
+  return findRunningContainerByLocalFolder(containerDir(name), {
+    ...opts.docker ? { docker: opts.docker } : {}
+  });
+}
+async function runAppCtl(name, ctlArgs2, opts = {}) {
+  const id = await findRunningContainer(name, opts);
+  if (!id) {
+    throw new Error(
+      `Container "${name}" is not running. Run \`monoceros start ${name}\` first.`
+    );
+  }
+  const exec = opts.exec ?? realContainerExec;
+  const result = await exec(id, ["monoceros-ctl", ...ctlArgs2]);
+  return result.exitCode;
+}
+function ctlArgs(sub, app, target, extra = []) {
+  return [sub, app, ...target ? ["--target", target] : [], ...extra];
+}
+var init_app_control = __esm({
+  "src/devcontainer/app-control.ts"() {
+    "use strict";
+    init_paths();
+    init_locate_running();
+  }
+});
+
 // src/commands/start.ts
-import { defineCommand as defineCommand29 } from "citty";
-import { consola as consola33 } from "consola";
+import { defineCommand as defineCommand30 } from "citty";
+import { consola as consola35 } from "consola";
+async function bringContainerUp(name, openTool) {
+  {
+    const args = { name, open: openTool };
+    let needsProxy = false;
+    let hostPort = 80;
+    let deferred = [];
+    let runtimeVersion;
+    try {
+      const parsed = await readConfig(containerConfigPath(args.name));
+      runtimeVersion = parsed.config.runtimeVersion;
+      if ((parsed.config.routing?.ports ?? []).length > 0) {
+        needsProxy = true;
+        const global = await readMonocerosConfig();
+        hostPort = proxyHostPort(global);
+      }
+      deferred = (parsed.config.services ?? []).filter((s) => serviceDefersStart(s.name)).map((s) => s.name);
+    } catch (err) {
+      consola35.warn(
+        `Could not read container yml ahead of start: ${err instanceof Error ? err.message : String(err)}. Skipping Traefik pre-flight.`
+      );
+    }
+    if (needsProxy) {
+      await preflightHostPort(hostPort);
+      await ensureProxy({ hostPort });
+    }
+    const exitCode = await runStart({ root: containerDir(args.name) });
+    if (exitCode === 0 && runtimeSupportsBrowserBridge(runtimeVersion)) {
+      spawnBridgeDaemon(containerDir(args.name));
+    }
+    if (exitCode === 0 && deferred.length > 0) {
+      try {
+        const deferExit = await startDeferredServices({
+          root: containerDir(args.name),
+          services: deferred,
+          logger: consola35
+        });
+        if (deferExit !== 0) {
+          consola35.warn(
+            `Deferred service(s) ${deferred.join(", ")} did not start cleanly (exit ${deferExit}).`
+          );
+        }
+      } catch (err) {
+        consola35.warn(
+          `Could not start deferred service(s) ${deferred.join(", ")}: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+    if (args.open && exitCode === 0) {
+      try {
+        await runOpen({ name: args.name, tool: args.open });
+      } catch (err) {
+        consola35.warn(err instanceof Error ? err.message : String(err));
+      }
+    }
+    return exitCode;
+  }
+}
 var startCommand;
 var init_start = __esm({
   "src/commands/start.ts"() {
@@ -11595,12 +11973,13 @@ var init_start = __esm({
     init_open();
     init_proxy();
     init_port_check();
+    init_app_control();
     init_dispatch();
-    startCommand = defineCommand29({
+    startCommand = defineCommand30({
       meta: {
         name: "start",
         group: "run",
-        description: "Bring the named dev-container up via `devcontainer up` (workspace + runServices, postCreate, features)."
+        description: "Bring the named dev-container up. With an <app>, start that app inside it (per its projects/<app>/.monoceros/launch.json); the container is brought up first if needed."
       },
       args: {
         name: {
@@ -11608,73 +11987,45 @@ var init_start = __esm({
           description: "Container name (yml in $MONOCEROS_HOME/container-configs/).",
           required: true
         },
+        app: {
+          type: "positional",
+          description: "App to start (a path under projects/ with .monoceros/launch.json). Omit to just bring the container up.",
+          required: false
+        },
+        target: {
+          type: "string",
+          description: `Which launch target to start (defaults to the app's "default" target, or its only one).`
+        },
         open: {
           type: "string",
           description: `After a successful start, open the container in this tool (${OPEN_TOOLS.join("|")}).`
         }
       },
       run({ args }) {
-        return dispatch(async () => {
-          let needsProxy = false;
-          let hostPort = 80;
-          let deferred = [];
-          let runtimeVersion;
-          try {
-            const parsed = await readConfig(containerConfigPath(args.name));
-            runtimeVersion = parsed.config.runtimeVersion;
-            if ((parsed.config.routing?.ports ?? []).length > 0) {
-              needsProxy = true;
-              const global = await readMonocerosConfig();
-              hostPort = proxyHostPort(global);
+        if (typeof args.app === "string" && args.app.length > 0) {
+          const app = args.app;
+          const target = typeof args.target === "string" ? args.target : void 0;
+          return dispatch(async () => {
+            if (!await findRunningContainer(args.name)) {
+              const up = await bringContainerUp(args.name, void 0);
+              if (up !== 0) return up;
             }
-            deferred = (parsed.config.services ?? []).filter((s) => serviceDefersStart(s.name)).map((s) => s.name);
-          } catch (err) {
-            consola33.warn(
-              `Could not read container yml ahead of start: ${err instanceof Error ? err.message : String(err)}. Skipping Traefik pre-flight.`
-            );
-          }
-          if (needsProxy) {
-            await preflightHostPort(hostPort);
-            await ensureProxy({ hostPort });
-          }
-          const exitCode = await runStart({ root: containerDir(args.name) });
-          if (exitCode === 0 && runtimeSupportsBrowserBridge(runtimeVersion)) {
-            spawnBridgeDaemon(containerDir(args.name));
-          }
-          if (exitCode === 0 && deferred.length > 0) {
-            try {
-              const deferExit = await startDeferredServices({
-                root: containerDir(args.name),
-                services: deferred,
-                logger: consola33
-              });
-              if (deferExit !== 0) {
-                consola33.warn(
-                  `Deferred service(s) ${deferred.join(", ")} did not start cleanly (exit ${deferExit}).`
-                );
-              }
-            } catch (err) {
-              consola33.warn(
-                `Could not start deferred service(s) ${deferred.join(", ")}: ${err instanceof Error ? err.message : String(err)}`
-              );
-            }
-          }
-          if (args.open && exitCode === 0) {
-            try {
-              await runOpen({ name: args.name, tool: args.open });
-            } catch (err) {
-              consola33.warn(err instanceof Error ? err.message : String(err));
-            }
-          }
-          return exitCode;
-        });
+            return runAppCtl(args.name, ctlArgs("start", app, target));
+          });
+        }
+        return dispatch(
+          () => bringContainerUp(
+            args.name,
+            typeof args.open === "string" ? args.open : void 0
+          )
+        );
       }
     });
   }
 });
 
 // src/commands/status.ts
-import { defineCommand as defineCommand30 } from "citty";
+import { defineCommand as defineCommand31 } from "citty";
 var statusCommand;
 var init_status = __esm({
   "src/commands/status.ts"() {
@@ -11682,7 +12033,7 @@ var init_status = __esm({
     init_paths();
     init_compose();
     init_dispatch();
-    statusCommand = defineCommand30({
+    statusCommand = defineCommand31({
       meta: {
         name: "status",
         group: "run",
@@ -11712,8 +12063,8 @@ var init_status = __esm({
 });
 
 // src/commands/stop.ts
-import { defineCommand as defineCommand31 } from "citty";
-import { consola as consola34 } from "consola";
+import { defineCommand as defineCommand32 } from "citty";
+import { consola as consola36 } from "consola";
 var stopCommand;
 var init_stop = __esm({
   "src/commands/stop.ts"() {
@@ -11721,12 +12072,13 @@ var init_stop = __esm({
     init_paths();
     init_compose();
     init_proxy();
+    init_app_control();
     init_dispatch();
-    stopCommand = defineCommand31({
+    stopCommand = defineCommand32({
       meta: {
         name: "stop",
         group: "run",
-        description: "Stop the compose services for the named dev-container. Volumes are preserved."
+        description: "Stop the compose services for the named dev-container. With an <app>, stop that long-running app inside it instead (kills its process group)."
       },
       args: {
         name: {
@@ -11734,12 +12086,26 @@ var init_stop = __esm({
           description: "Container name (yml in $MONOCEROS_HOME/container-configs/).",
           required: true
         },
+        app: {
+          type: "positional",
+          description: "App to stop (a path under projects/ with .monoceros/launch.json). Omit to stop the container.",
+          required: false
+        },
+        target: {
+          type: "string",
+          description: `Which launch target to stop (defaults to the app's "default" target, or its only one).`
+        },
         service: {
           type: "string",
           description: "Restrict to a single compose service (e.g. postgres). Defaults to all."
         }
       },
       run({ args }) {
+        if (typeof args.app === "string" && args.app.length > 0) {
+          const app = args.app;
+          const target = typeof args.target === "string" ? args.target : void 0;
+          return dispatch(() => runAppCtl(args.name, ctlArgs("stop", app, target)));
+        }
         return dispatch(async () => {
           const exit = await runStop({
             root: containerDir(args.name),
@@ -11747,10 +12113,10 @@ var init_stop = __esm({
           });
           try {
             await maybeStopProxy({
-              logger: { info: (msg) => consola34.info(msg) }
+              logger: { info: (msg) => consola36.info(msg) }
             });
           } catch (err) {
-            consola34.warn(
+            consola36.warn(
               `Could not tear down the Traefik proxy: ${err instanceof Error ? err.message : String(err)}. Ignored.`
             );
           }
@@ -11762,11 +12128,11 @@ var init_stop = __esm({
 });
 
 // src/tunnel/resolve.ts
-import { existsSync as existsSync21 } from "fs";
-import path30 from "path";
+import { existsSync as existsSync20 } from "fs";
+import path31 from "path";
 async function resolveTunnelTarget(opts) {
   const ymlPath = containerConfigPath(opts.name, opts.monocerosHome);
-  if (!existsSync21(ymlPath)) {
+  if (!existsSync20(ymlPath)) {
     throw new Error(
       `No yml profile for '${opts.name}' at ${ymlPath}. Run \`monoceros init ${opts.name}\` first.`
     );
@@ -11774,13 +12140,13 @@ async function resolveTunnelTarget(opts) {
   const parsed = await readConfig(ymlPath);
   const config = parsed.config;
   const containerRoot = containerDir(opts.name, opts.monocerosHome);
-  if (!existsSync21(containerRoot)) {
+  if (!existsSync20(containerRoot)) {
     throw new Error(
       `Container '${opts.name}' is not materialised at ${containerRoot}. Run \`monoceros apply ${opts.name}\` first.`
     );
   }
-  const composePath = path30.join(containerRoot, ".devcontainer", "compose.yaml");
-  const isCompose = existsSync21(composePath);
+  const composePath = path31.join(containerRoot, ".devcontainer", "compose.yaml");
+  const isCompose = existsSync20(composePath);
   const parsedTarget = parseTargetArg(opts.target, config);
   const docker = opts.docker ?? defaultDockerExec;
   if (isCompose) {
@@ -12016,7 +12382,7 @@ var init_port_check2 = __esm({
 
 // src/tunnel/run.ts
 import { spawn as spawn14 } from "child_process";
-import { consola as consola35 } from "consola";
+import { consola as consola37 } from "consola";
 function signalNumber(signal) {
   switch (signal) {
     case "SIGINT":
@@ -12029,8 +12395,8 @@ function signalNumber(signal) {
 }
 async function runTunnel(opts) {
   const log = opts.logger ?? {
-    info: (m) => consola35.info(m),
-    warn: (m) => consola35.warn(m)
+    info: (m) => consola37.info(m),
+    warn: (m) => consola37.warn(m)
   };
   const resolve = opts.resolve ?? resolveTunnelTarget;
   const resolveArgs3 = {
@@ -12136,8 +12502,8 @@ var init_run3 = __esm({
 });
 
 // src/commands/tunnel.ts
-import { defineCommand as defineCommand32 } from "citty";
-import { consola as consola36 } from "consola";
+import { defineCommand as defineCommand33 } from "citty";
+import { consola as consola38 } from "consola";
 function parseLocalPort(raw) {
   if (raw === void 0) return void 0;
   const n = Number(raw);
@@ -12153,7 +12519,7 @@ var init_tunnel = __esm({
   "src/commands/tunnel.ts"() {
     "use strict";
     init_run3();
-    tunnelCommand = defineCommand32({
+    tunnelCommand = defineCommand33({
       meta: {
         name: "tunnel",
         group: "discovery",
@@ -12190,7 +12556,7 @@ var init_tunnel = __esm({
           });
           process.exit(exitCode);
         } catch (err) {
-          consola36.error(err instanceof Error ? err.message : String(err));
+          consola38.error(err instanceof Error ? err.message : String(err));
           process.exit(1);
         }
       }
@@ -12260,8 +12626,8 @@ var init_prune = __esm({
 });
 
 // src/upgrade/index.ts
-import { existsSync as existsSync22, promises as fs18 } from "fs";
-import { consola as consola37 } from "consola";
+import { existsSync as existsSync21, promises as fs19 } from "fs";
+import { consola as consola39 } from "consola";
 async function fetchRuntimeVersions() {
   const tokenUrl = `https://ghcr.io/token?service=ghcr.io&scope=repository:${RUNTIME_REPO}:pull`;
   const tokenRes = await fetch(tokenUrl);
@@ -12299,7 +12665,7 @@ ${yml}`;
 }
 async function runUpgrade(opts) {
   const home = opts.monocerosHome ?? monocerosHome();
-  const logger = opts.logger ?? consola37;
+  const logger = opts.logger ?? consola39;
   const fetchVersions = opts.fetchVersions ?? fetchRuntimeVersions;
   if (opts.list) {
     const versions = await fetchVersions();
@@ -12325,7 +12691,7 @@ async function runUpgrade(opts) {
       );
     }
   }
-  if (opts.name && !existsSync22(containerConfigPath(opts.name, home))) {
+  if (opts.name && !existsSync21(containerConfigPath(opts.name, home))) {
     throw new Error(
       `No such config: ${containerConfigPath(opts.name, home)}. Run \`monoceros init <template> ${opts.name}\` first.`
     );
@@ -12376,11 +12742,11 @@ async function runUpgrade(opts) {
   let bumped = 0;
   for (const name of targets) {
     const ymlPath = containerConfigPath(name, home);
-    if (!existsSync22(ymlPath)) continue;
-    const raw = await fs18.readFile(ymlPath, "utf8");
+    if (!existsSync21(ymlPath)) continue;
+    const raw = await fs19.readFile(ymlPath, "utf8");
     const updated = setRuntimeVersion(raw, pinVersion);
     if (updated !== raw) {
-      await fs18.writeFile(ymlPath, updated);
+      await fs19.writeFile(ymlPath, updated);
       bumped += 1;
       logger.info(`Pinned '${name}' to runtime ${pinVersion}.`);
     }
@@ -12422,7 +12788,7 @@ function formatPruneLine(prune) {
 }
 async function listContainerNames2(home) {
   try {
-    const entries = await fs18.readdir(containerConfigsDir(home));
+    const entries = await fs19.readdir(containerConfigsDir(home));
     return entries.filter((e) => e.endsWith(".yml")).map((e) => e.slice(0, -".yml".length));
   } catch {
     return [];
@@ -12445,7 +12811,7 @@ var init_upgrade = __esm({
 });
 
 // src/commands/upgrade.ts
-import { defineCommand as defineCommand33 } from "citty";
+import { defineCommand as defineCommand34 } from "citty";
 var upgradeCommand;
 var init_upgrade2 = __esm({
   "src/commands/upgrade.ts"() {
@@ -12453,7 +12819,7 @@ var init_upgrade2 = __esm({
     init_upgrade();
     init_version();
     init_dispatch();
-    upgradeCommand = defineCommand33({
+    upgradeCommand = defineCommand34({
       meta: {
         name: "upgrade",
         group: "lifecycle",
@@ -12495,7 +12861,7 @@ var main_exports = {};
 __export(main_exports, {
   main: () => main
 });
-import { defineCommand as defineCommand34 } from "citty";
+import { defineCommand as defineCommand35 } from "citty";
 var main;
 var init_main = __esm({
   "src/main.ts"() {
@@ -12513,6 +12879,7 @@ var init_main = __esm({
     init_complete();
     init_update_check();
     init_init2();
+    init_list_apps();
     init_list_components();
     init_logs();
     init_open2();
@@ -12534,7 +12901,7 @@ var init_main = __esm({
     init_tunnel();
     init_upgrade2();
     init_version();
-    main = defineCommand34({
+    main = defineCommand35({
       meta: {
         name: "monoceros",
         version: CLI_VERSION,
@@ -12542,6 +12909,7 @@ var init_main = __esm({
       },
       subCommands: {
         init: initCommand,
+        "list-apps": listAppsCommand,
         "list-components": listComponentsCommand,
         shell: shellCommand,
         open: openCommand,
@@ -12833,25 +13201,25 @@ function detectHelpRequest(argv, main2) {
   const separatorIdx = argv.indexOf("--");
   if (helpIdx === -1) return null;
   if (separatorIdx !== -1 && separatorIdx < helpIdx) return null;
-  const path31 = [];
+  const path32 = [];
   const tokens = argv.slice(
     0,
     separatorIdx === -1 ? argv.length : separatorIdx
   );
   let cursor = main2;
   const mainName = (main2.meta ?? {}).name ?? "monoceros";
-  path31.push(mainName);
+  path32.push(mainName);
   for (const tok of tokens) {
     if (tok.startsWith("-")) continue;
     const subs = cursor.subCommands ?? {};
     if (tok in subs) {
       cursor = subs[tok];
-      path31.push(tok);
+      path32.push(tok);
       continue;
     }
     break;
   }
-  return { path: path31, cmd: cursor };
+  return { path: path32, cmd: cursor };
 }
 async function maybeRenderHelp(argv, main2) {
   const hit = detectHelpRequest(argv, main2);