dev-prism 0.3.0 → 0.6.0

package/dist/chunk-MRBTH5PL.js

@@ -0,0 +1,66 @@
+// src/lib/compose.ts
+import { writeFileSync } from "fs";
+import { resolve } from "path";
+import { createHash } from "crypto";
+function generateComposeFile(workingDir, projectName, services) {
+  const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  const dirHash = createHash("md5").update(workingDir).digest("hex").substring(0, 8);
+  const composeProjectName = `${projectName}-${dirHash}`;
+  const lines = [
+    "# Auto-generated by dev-prism - DO NOT EDIT",
+    "",
+    "x-dev-prism-labels: &dev-prism-labels",
+    '  dev-prism.managed: "true"',
+    `  dev-prism.working_dir: "${workingDir}"`,
+    `  dev-prism.session_id: "${workingDir}"`,
+    `  dev-prism.created_at: "${createdAt}"`,
+    "",
+    "services:"
+  ];
+  for (const service of services) {
+    lines.push(`  ${service.name}:`);
+    lines.push(`    extends:`);
+    lines.push(`      file: docker-compose.yml`);
+    lines.push(`      service: ${service.name}`);
+    lines.push(`    ports:`);
+    lines.push(`      - "0:${service.internalPort}"  # Random host port`);
+    lines.push(`    labels:`);
+    lines.push(`      <<: *dev-prism-labels`);
+    lines.push(`      dev-prism.service: "${service.name}"`);
+    lines.push(`      dev-prism.internal_port: "${service.internalPort}"`);
+    lines.push(``);
+  }
+  lines.unshift(`# Compose project name: ${composeProjectName}`);
+  lines.unshift("");
+  lines.push("volumes:");
+  lines.push("  postgres-data:");
+  return lines.join("\n");
+}
+function writeComposeFile(workingDir, projectName, services) {
+  const content = generateComposeFile(workingDir, projectName, services);
+  const filePath = resolve(workingDir, "docker-compose.session.yml");
+  writeFileSync(filePath, content, "utf-8");
+  return filePath;
+}
+function generateEnvStub(workingDir, projectName) {
+  const composeProjectName = getComposeProjectName(workingDir, projectName);
+  const lines = [
+    "# Auto-generated by dev-prism",
+    `COMPOSE_PROJECT_NAME=${composeProjectName}`,
+    `SESSION_DIR=${workingDir}`,
+    "",
+    "# Ports will be added after containers start"
+  ];
+  return lines.join("\n") + "\n";
+}
+function getComposeProjectName(workingDir, projectName) {
+  const dirHash = createHash("md5").update(workingDir).digest("hex").substring(0, 8);
+  return `${projectName}-${dirHash}`;
+}
+
+export {
+  generateComposeFile,
+  writeComposeFile,
+  generateEnvStub,
+  getComposeProjectName
+};

package/dist/chunk-NNVP5F6I.js

@@ -0,0 +1,77 @@
+import {
+  calculatePorts
+} from "./chunk-3ATDGV4Y.js";
+import {
+  isRunning
+} from "./chunk-GBN67HYD.js";
+import {
+  loadConfig
+} from "./chunk-25WQHUYW.js";
+import {
+  SessionStore
+} from "./chunk-H4HPDIY3.js";
+
+// src/commands/list.ts
+import { existsSync } from "fs";
+import { resolve } from "path";
+import chalk from "chalk";
+async function listSessions(projectRoot, options) {
+  const showAll = options?.all ?? false;
+  const config = await loadConfig(projectRoot);
+  const store = new SessionStore();
+  let sessions;
+  try {
+    const projectSessions = store.listByProject(projectRoot);
+    if (showAll || projectSessions.length === 0) {
+      sessions = store.listAll();
+    } else {
+      sessions = projectSessions;
+    }
+  } finally {
+    store.close();
+  }
+  if (sessions.length === 0) {
+    console.log(chalk.gray("No active sessions found."));
+    console.log(chalk.gray("\nTo create a session:"));
+    console.log(chalk.cyan("  dev-prism create"));
+    return;
+  }
+  console.log(chalk.blue("Active Sessions:"));
+  console.log(chalk.gray("================\n"));
+  for (const session of sessions) {
+    const sessionConfig = await loadConfig(session.project_root).catch(() => config);
+    const status = await getSessionStatus(session.session_id, session.session_dir, session.branch, sessionConfig);
+    printSessionStatus(status);
+  }
+}
+async function getSessionStatus(sessionId, path, branch, config) {
+  const ports = calculatePorts(config, sessionId);
+  let running = false;
+  const envFile = resolve(path, ".env.session");
+  if (existsSync(envFile)) {
+    running = await isRunning({ cwd: path });
+  }
+  return {
+    sessionId,
+    path,
+    branch,
+    running,
+    ports
+  };
+}
+function printSessionStatus(status) {
+  const statusIcon = status.running ? chalk.green("\u25CF") : chalk.red("\u25CB");
+  const statusText = status.running ? chalk.green("running") : chalk.gray("stopped");
+  console.log(`${statusIcon} Session ${chalk.bold(status.sessionId)} ${statusText}`);
+  console.log(chalk.gray(`  Path: ${status.path}`));
+  console.log(chalk.gray(`  Branch: ${status.branch}`));
+  console.log(chalk.gray("  Ports:"));
+  for (const [name, port] of Object.entries(status.ports)) {
+    console.log(chalk.cyan(`    ${name}: http://localhost:${port}`));
+  }
+  console.log("");
+}
+
+export {
+  listSessions
+};

package/dist/chunk-OL25TBYX.js

@@ -0,0 +1,67 @@
+import {
+  isRunning
+} from "./chunk-GBN67HYD.js";
+import {
+  loadConfig
+} from "./chunk-25WQHUYW.js";
+import {
+  SessionStore
+} from "./chunk-H4HPDIY3.js";
+
+// src/commands/stop-all.ts
+import { existsSync } from "fs";
+import { resolve } from "path";
+import chalk from "chalk";
+import { execa } from "execa";
+async function stopAllSessions(projectRoot) {
+  const config = await loadConfig(projectRoot);
+  const store = new SessionStore();
+  let sessions;
+  try {
+    sessions = store.listByProject(projectRoot);
+  } finally {
+    store.close();
+  }
+  if (sessions.length === 0) {
+    console.log(chalk.gray("No sessions found."));
+    return;
+  }
+  const runningSessions = [];
+  for (const session of sessions) {
+    const envFile = resolve(session.session_dir, ".env.session");
+    if (existsSync(envFile)) {
+      const running = await isRunning({ cwd: session.session_dir });
+      if (running) {
+        runningSessions.push({ sessionId: session.session_id, path: session.session_dir });
+      }
+    }
+  }
+  if (runningSessions.length === 0) {
+    console.log(chalk.gray("No running sessions found."));
+    return;
+  }
+  console.log(chalk.blue(`Stopping ${runningSessions.length} running session(s)...
+`));
+  const allApps = config.apps ?? [];
+  const profileFlags = allApps.flatMap((p) => ["--profile", p]);
+  const allServices = ["postgres", "mailpit", ...allApps];
+  for (const session of runningSessions) {
+    console.log(chalk.gray(`  Stopping session ${session.sessionId}...`));
+    try {
+      await execa(
+        "docker",
+        ["compose", "-f", "docker-compose.session.yml", "--env-file", ".env.session", ...profileFlags, "stop", ...allServices],
+        { cwd: session.path, stdio: "pipe" }
+      );
+      console.log(chalk.green(`  Session ${session.sessionId} stopped.`));
+    } catch {
+      console.log(chalk.yellow(`  Warning: Could not stop session ${session.sessionId}`));
+    }
+  }
+  console.log(chalk.green(`
+Stopped ${runningSessions.length} session(s).`));
+}
+
+export {
+  stopAllSessions
+};

package/dist/chunk-OOJ6YOGS.js

@@ -0,0 +1,53 @@
+import {
+  loadConfig
+} from "./chunk-25WQHUYW.js";
+import {
+  getSession
+} from "./chunk-DQER5GNG.js";
+
+// src/commands/logs.ts
+import chalk from "chalk";
+import { execa } from "execa";
+import { resolve } from "path";
+import { existsSync } from "fs";
+async function streamLogs(workingDir, options) {
+  const session = await getSession(workingDir);
+  if (!session) {
+    console.error(chalk.red(`Error: No session found in ${workingDir}`));
+    process.exit(1);
+  }
+  let projectRoot = workingDir;
+  for (let i = 0; i < 5; i++) {
+    const configPath = resolve(projectRoot, "session.config.mjs");
+    const altConfigPath = resolve(projectRoot, "session.config.js");
+    if (existsSync(configPath) || existsSync(altConfigPath)) {
+      break;
+    }
+    projectRoot = resolve(projectRoot, "..");
+  }
+  const config = await loadConfig(projectRoot);
+  let profileFlags = [];
+  if (options.mode === "docker") {
+    const allApps = config.apps ?? [];
+    const excludeApps = options.without ?? [];
+    const profiles = allApps.filter((app) => !excludeApps.includes(app));
+    profileFlags = profiles.flatMap((p) => ["--profile", p]);
+  }
+  const args = [
+    "compose",
+    "-f",
+    "docker-compose.session.yml",
+    "--env-file",
+    ".env.session",
+    ...profileFlags,
+    "logs",
+    "-f",
+    "--tail",
+    options.tail ?? "50"
+  ];
+  await execa("docker", args, { cwd: workingDir, stdio: "inherit" });
+}
+
+export {
+  streamLogs
+};

package/dist/chunk-OPEZFBBI.js

@@ -0,0 +1,219 @@
+import {
+  extractPorts,
+  formatPortsTable
+} from "./chunk-LAOWFCQL.js";
+import {
+  generateEnvStub,
+  getComposeProjectName,
+  writeComposeFile
+} from "./chunk-H3L73URT.js";
+import {
+  writeAppEnvFiles,
+  writeEnvFile
+} from "./chunk-HZBJF67X.js";
+import {
+  createWorktree,
+  generateDefaultBranchName,
+  removeWorktree
+} from "./chunk-3Q454U3I.js";
+import {
+  down,
+  logs,
+  up
+} from "./chunk-GBN67HYD.js";
+import {
+  getSessionsDir,
+  loadConfig
+} from "./chunk-25WQHUYW.js";
+import {
+  getPortMappings,
+  sessionExists
+} from "./chunk-JZ2VPQXP.js";
+
+// src/commands/create.ts
+import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync } from "fs";
+import { basename, join, resolve } from "path";
+import chalk from "chalk";
+import { execa } from "execa";
+function updateEnvDatabaseUrl(envPath, newDbUrl) {
+  if (!existsSync(envPath)) return;
+  let content = readFileSync(envPath, "utf-8");
+  if (content.includes("DATABASE_URL=")) {
+    content = content.replace(/^DATABASE_URL=.*/m, `DATABASE_URL=${newDbUrl}`);
+  } else {
+    content += `
+DATABASE_URL=${newDbUrl}
+`;
+  }
+  writeFileSync(envPath, content);
+}
+async function createSession(projectRoot, _sessionId, options) {
+  const config = await loadConfig(projectRoot);
+  const sessionsDir = getSessionsDir(config, projectRoot);
+  const inPlace = options.inPlace ?? false;
+  const mode = options.mode || "docker";
+  let workingDir;
+  let branchName = "";
+  if (inPlace) {
+    workingDir = projectRoot;
+    console.log(chalk.blue(`Creating session in current directory (${mode} mode)...`));
+  } else {
+    branchName = options.branch || generateDefaultBranchName();
+    workingDir = resolve(sessionsDir, branchName);
+    console.log(chalk.blue(`Creating session (${mode} mode)...`));
+    console.log(chalk.gray(`Branch: ${branchName}`));
+    console.log(chalk.gray(`Directory: ${workingDir}`));
+  }
+  if (await sessionExists(workingDir)) {
+    console.error(chalk.red(`
+Error: Session already running in this directory.`));
+    console.error(chalk.gray(`Stop it first with: dev-prism stop`));
+    process.exit(1);
+  }
+  let profiles;
+  try {
+    if (!inPlace) {
+      if (!existsSync(sessionsDir)) {
+        mkdirSync(sessionsDir, { recursive: true });
+      }
+      console.log(chalk.blue("\nCreating git worktree..."));
+      await createWorktree(projectRoot, workingDir, branchName);
+      console.log(chalk.green(`  Created: ${workingDir}`));
+    }
+    const projectName = config.projectName ?? basename(projectRoot);
+    const services = config.services ?? [
+      { name: "postgres", internalPort: 5432 },
+      { name: "app", internalPort: 3e3 }
+    ];
+    console.log(chalk.blue("\nGenerating docker-compose.session.yml..."));
+    const composePath = writeComposeFile(workingDir, projectName, services);
+    console.log(chalk.green(`  Written: ${composePath}`));
+    console.log(chalk.blue("\nGenerating .env.session stub..."));
+    const envStub = generateEnvStub(workingDir, projectName);
+    const envPath = resolve(workingDir, ".env.session");
+    writeFileSync(envPath, envStub, "utf-8");
+    console.log(chalk.green(`  Written: ${envPath}`));
+    if (!inPlace) {
+      const envFilesToCopy = config.envFiles ?? [];
+      for (const envFile of envFilesToCopy) {
+        const srcPath = join(projectRoot, envFile);
+        const destPath = join(workingDir, envFile);
+        if (existsSync(srcPath)) {
+          copyFileSync(srcPath, destPath);
+          console.log(chalk.green(`  Copied: ${envFile}`));
+        }
+      }
+    }
+    console.log(chalk.blue("\nStarting Docker services..."));
+    if (mode === "docker") {
+      const allApps = config.apps ?? [];
+      const excludeApps = options.without ?? [];
+      profiles = allApps.filter((app) => !excludeApps.includes(app));
+      if (excludeApps.length > 0) {
+        console.log(chalk.gray(`  Excluding apps: ${excludeApps.join(", ")}`));
+      }
+    }
+    await up({ cwd: workingDir, profiles, detach: true });
+    console.log(chalk.blue("Waiting for services to be ready..."));
+    await new Promise((resolve2) => setTimeout(resolve2, 3e3));
+    console.log(chalk.blue("\nDiscovering ports from containers..."));
+    const portMappings = await getPortMappings(workingDir);
+    const ports = extractPorts(portMappings);
+    console.log(chalk.gray("Discovered ports:"));
+    console.log(chalk.gray(formatPortsTable(ports)));
+    const composeProjectName = getComposeProjectName(workingDir, projectName);
+    const finalEnvContent = writeEnvFile(workingDir, ports, composeProjectName);
+    console.log(chalk.green(`  Updated: ${finalEnvContent}`));
+    const appEnvFiles = writeAppEnvFiles(config, workingDir, ports);
+    for (const file of appEnvFiles) {
+      console.log(chalk.green(`  Written: ${file}`));
+    }
+    if (!inPlace && ports.POSTGRES_PORT) {
+      const sessionDbUrl = `postgresql://postgres:postgres@localhost:${ports.POSTGRES_PORT}/postgres`;
+      const envFilesToCopy = config.envFiles ?? [];
+      for (const envFile of envFilesToCopy) {
+        const destPath = join(workingDir, envFile);
+        if (existsSync(destPath)) {
+          updateEnvDatabaseUrl(destPath, sessionDbUrl);
+          console.log(chalk.green(`  Updated DATABASE_URL in: ${envFile}`));
+        }
+      }
+    }
+    if (config.setup.length > 0) {
+      console.log(chalk.blue("\nRunning setup commands..."));
+      const setupEnv = {
+        ...process.env,
+        SESSION_DIR: workingDir
+      };
+      for (const [name, port] of Object.entries(ports)) {
+        setupEnv[name] = String(port);
+      }
+      if (ports.POSTGRES_PORT) {
+        setupEnv.DATABASE_URL = `postgresql://postgres:postgres@localhost:${ports.POSTGRES_PORT}/postgres`;
+      }
+      for (const cmd of config.setup) {
+        console.log(chalk.gray(`  Running: ${cmd}`));
+        const [command, ...args] = cmd.split(" ");
+        try {
+          await execa(command, args, {
+            cwd: workingDir,
+            stdio: "inherit",
+            env: setupEnv
+          });
+        } catch {
+          console.warn(chalk.yellow(`  Warning: Command failed: ${cmd}`));
+        }
+      }
+    }
+    console.log(chalk.green(`
+Session ready!`));
+    console.log(chalk.gray(`Directory: ${workingDir}`));
+    if (mode === "docker") {
+      console.log(chalk.gray("\nDocker mode - all services in containers."));
+      console.log(chalk.gray("View logs: docker compose -f docker-compose.session.yml logs -f"));
+    } else {
+      console.log(chalk.gray("\nNative mode - run apps with: pnpm dev"));
+    }
+    console.log(chalk.gray("\nPorts:"));
+    for (const [name, port] of Object.entries(ports)) {
+      console.log(chalk.cyan(`  ${name}: http://localhost:${port}`));
+    }
+    if (options.detach === false) {
+      console.log(chalk.blue("\nStreaming logs (Ctrl+C to stop)..."));
+      console.log(chalk.gray("\u2500".repeat(60)));
+      try {
+        await logs({ cwd: workingDir, profiles });
+      } catch (error) {
+        const execaError = error;
+        if (execaError.signal === "SIGINT") {
+          console.log(chalk.gray("\n\u2500".repeat(60)));
+          console.log(chalk.yellow("\nLog streaming stopped. Services are still running."));
+          console.log(
+            chalk.gray(
+              `Resume logs: cd ${workingDir} && docker compose -f docker-compose.session.yml --env-file .env.session logs -f`
+            )
+          );
+        } else {
+          throw error;
+        }
+      }
+    }
+  } catch (error) {
+    console.error(chalk.red("Session creation failed. Cleaning up..."));
+    try {
+      await down({ cwd: workingDir });
+    } catch {
+    }
+    if (!inPlace && branchName) {
+      try {
+        await removeWorktree(projectRoot, workingDir, branchName);
+      } catch {
+      }
+    }
+    throw error;
+  }
+}
+
+export {
+  createSession
+};

package/dist/chunk-Q5DPX4WL.js

@@ -0,0 +1,219 @@
+import {
+  extractPorts,
+  formatPortsTable
+} from "./chunk-LAOWFCQL.js";
+import {
+  generateEnvStub,
+  getComposeProjectName,
+  writeComposeFile
+} from "./chunk-MRBTH5PL.js";
+import {
+  writeAppEnvFiles,
+  writeEnvFile
+} from "./chunk-HZBJF67X.js";
+import {
+  createWorktree,
+  generateDefaultBranchName,
+  removeWorktree
+} from "./chunk-3Q454U3I.js";
+import {
+  down,
+  logs,
+  up
+} from "./chunk-GBN67HYD.js";
+import {
+  getSessionsDir,
+  loadConfig
+} from "./chunk-25WQHUYW.js";
+import {
+  getPortMappings,
+  sessionExists
+} from "./chunk-JZ2VPQXP.js";
+
+// src/commands/create.ts
+import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync } from "fs";
+import { basename, join, resolve } from "path";
+import chalk from "chalk";
+import { execa } from "execa";
+function updateEnvDatabaseUrl(envPath, newDbUrl) {
+  if (!existsSync(envPath)) return;
+  let content = readFileSync(envPath, "utf-8");
+  if (content.includes("DATABASE_URL=")) {
+    content = content.replace(/^DATABASE_URL=.*/m, `DATABASE_URL=${newDbUrl}`);
+  } else {
+    content += `
+DATABASE_URL=${newDbUrl}
+`;
+  }
+  writeFileSync(envPath, content);
+}
+async function createSession(projectRoot, _sessionId, options) {
+  const config = await loadConfig(projectRoot);
+  const sessionsDir = getSessionsDir(config, projectRoot);
+  const inPlace = options.inPlace ?? false;
+  const mode = options.mode || "docker";
+  let workingDir;
+  let branchName = "";
+  if (inPlace) {
+    workingDir = projectRoot;
+    console.log(chalk.blue(`Creating session in current directory (${mode} mode)...`));
+  } else {
+    branchName = options.branch || generateDefaultBranchName();
+    workingDir = resolve(sessionsDir, branchName);
+    console.log(chalk.blue(`Creating session (${mode} mode)...`));
+    console.log(chalk.gray(`Branch: ${branchName}`));
+    console.log(chalk.gray(`Directory: ${workingDir}`));
+  }
+  if (await sessionExists(workingDir)) {
+    console.error(chalk.red(`
+Error: Session already running in this directory.`));
+    console.error(chalk.gray(`Stop it first with: dev-prism stop`));
+    process.exit(1);
+  }
+  let profiles;
+  try {
+    if (!inPlace) {
+      if (!existsSync(sessionsDir)) {
+        mkdirSync(sessionsDir, { recursive: true });
+      }
+      console.log(chalk.blue("\nCreating git worktree..."));
+      await createWorktree(projectRoot, workingDir, branchName);
+      console.log(chalk.green(`  Created: ${workingDir}`));
+    }
+    const projectName = config.projectName ?? basename(projectRoot);
+    const services = config.services ?? [
+      { name: "postgres", internalPort: 5432 },
+      { name: "app", internalPort: 3e3 }
+    ];
+    console.log(chalk.blue("\nGenerating docker-compose.session.yml..."));
+    const composePath = writeComposeFile(workingDir, projectName, services);
+    console.log(chalk.green(`  Written: ${composePath}`));
+    console.log(chalk.blue("\nGenerating .env.session stub..."));
+    const envStub = generateEnvStub(workingDir, projectName);
+    const envPath = resolve(workingDir, ".env.session");
+    writeFileSync(envPath, envStub, "utf-8");
+    console.log(chalk.green(`  Written: ${envPath}`));
+    if (!inPlace) {
+      const envFilesToCopy = config.envFiles ?? [];
+      for (const envFile of envFilesToCopy) {
+        const srcPath = join(projectRoot, envFile);
+        const destPath = join(workingDir, envFile);
+        if (existsSync(srcPath)) {
+          copyFileSync(srcPath, destPath);
+          console.log(chalk.green(`  Copied: ${envFile}`));
+        }
+      }
+    }
+    console.log(chalk.blue("\nStarting Docker services..."));
+    if (mode === "docker") {
+      const allApps = config.apps ?? [];
+      const excludeApps = options.without ?? [];
+      profiles = allApps.filter((app) => !excludeApps.includes(app));
+      if (excludeApps.length > 0) {
+        console.log(chalk.gray(`  Excluding apps: ${excludeApps.join(", ")}`));
+      }
+    }
+    await up({ cwd: workingDir, profiles, detach: true });
+    console.log(chalk.blue("Waiting for services to be ready..."));
+    await new Promise((resolve2) => setTimeout(resolve2, 3e3));
+    console.log(chalk.blue("\nDiscovering ports from containers..."));
+    const portMappings = await getPortMappings(workingDir);
+    const ports = extractPorts(portMappings);
+    console.log(chalk.gray("Discovered ports:"));
+    console.log(chalk.gray(formatPortsTable(ports)));
+    const composeProjectName = getComposeProjectName(workingDir, projectName);
+    const finalEnvContent = writeEnvFile(workingDir, ports, composeProjectName);
+    console.log(chalk.green(`  Updated: ${finalEnvContent}`));
+    const appEnvFiles = writeAppEnvFiles(config, workingDir, ports);
+    for (const file of appEnvFiles) {
+      console.log(chalk.green(`  Written: ${file}`));
+    }
+    if (!inPlace && ports.POSTGRES_PORT) {
+      const sessionDbUrl = `postgresql://postgres:postgres@localhost:${ports.POSTGRES_PORT}/postgres`;
+      const envFilesToCopy = config.envFiles ?? [];
+      for (const envFile of envFilesToCopy) {
+        const destPath = join(workingDir, envFile);
+        if (existsSync(destPath)) {
+          updateEnvDatabaseUrl(destPath, sessionDbUrl);
+          console.log(chalk.green(`  Updated DATABASE_URL in: ${envFile}`));
+        }
+      }
+    }
+    if (config.setup.length > 0) {
+      console.log(chalk.blue("\nRunning setup commands..."));
+      const setupEnv = {
+        ...process.env,
+        SESSION_DIR: workingDir
+      };
+      for (const [name, port] of Object.entries(ports)) {
+        setupEnv[name] = String(port);
+      }
+      if (ports.POSTGRES_PORT) {
+        setupEnv.DATABASE_URL = `postgresql://postgres:postgres@localhost:${ports.POSTGRES_PORT}/postgres`;
+      }
+      for (const cmd of config.setup) {
+        console.log(chalk.gray(`  Running: ${cmd}`));
+        const [command, ...args] = cmd.split(" ");
+        try {
+          await execa(command, args, {
+            cwd: workingDir,
+            stdio: "inherit",
+            env: setupEnv
+          });
+        } catch {
+          console.warn(chalk.yellow(`  Warning: Command failed: ${cmd}`));
+        }
+      }
+    }
+    console.log(chalk.green(`
+Session ready!`));
+    console.log(chalk.gray(`Directory: ${workingDir}`));
+    if (mode === "docker") {
+      console.log(chalk.gray("\nDocker mode - all services in containers."));
+      console.log(chalk.gray("View logs: docker compose -f docker-compose.session.yml logs -f"));
+    } else {
+      console.log(chalk.gray("\nNative mode - run apps with: pnpm dev"));
+    }
+    console.log(chalk.gray("\nPorts:"));
+    for (const [name, port] of Object.entries(ports)) {
+      console.log(chalk.cyan(`  ${name}: http://localhost:${port}`));
+    }
+    if (options.detach === false) {
+      console.log(chalk.blue("\nStreaming logs (Ctrl+C to stop)..."));
+      console.log(chalk.gray("\u2500".repeat(60)));
+      try {
+        await logs({ cwd: workingDir, profiles });
+      } catch (error) {
+        const execaError = error;
+        if (execaError.signal === "SIGINT") {
+          console.log(chalk.gray("\n\u2500".repeat(60)));
+          console.log(chalk.yellow("\nLog streaming stopped. Services are still running."));
+          console.log(
+            chalk.gray(
+              `Resume logs: cd ${workingDir} && docker compose -f docker-compose.session.yml --env-file .env.session logs -f`
+            )
+          );
+        } else {
+          throw error;
+        }
+      }
+    }
+  } catch (error) {
+    console.error(chalk.red("Session creation failed. Cleaning up..."));
+    try {
+      await down({ cwd: workingDir });
+    } catch {
+    }
+    if (!inPlace && branchName) {
+      try {
+        await removeWorktree(projectRoot, workingDir, branchName);
+      } catch {
+      }
+    }
+    throw error;
+  }
+}
+
+export {
+  createSession
+};