webmux 0.7.3 → 0.8.0

package/README.md

@@ -34,6 +34,12 @@ Track dev server ports across worktrees. webmux polls configured services and sh
 
 Run agents in isolated Docker containers for untrusted or experimental work. webmux manages the container lifecycle, port forwarding, and volume mounts automatically.
 
+### Linear Integration
+
+![linear-1 5x](https://github.com/user-attachments/assets/3187fbe2-eeee-4a33-8780-c51c3575b72a)
+
+See your assigned Linear issues alongside your worktrees. Webmux matches branches to issues automatically, so you can browse your backlog, pick an issue, and spin up a worktree for it in one click.
+
 ## Quick Start
 
 ```bash

package/backend/dist/server.js

@@ -6905,7 +6905,7 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // backend/src/server.ts
-import { join as join5, resolve as resolve5 } from "path";
+import { join as join6, resolve as resolve5 } from "path";
 import { networkInterfaces } from "os";
 
 // backend/src/lib/log.ts
@@ -7931,6 +7931,7 @@ async function removeContainer(branch) {
 }
 
 // backend/src/adapters/hooks.ts
+import { join as join2 } from "path";
 function buildErrorMessage(name, exitCode, stdout, stderr) {
   const output = stderr.trim() || stdout.trim();
   if (output) {
@@ -7938,10 +7939,30 @@ function buildErrorMessage(name, exitCode, stdout, stderr) {
   }
   return `${name} hook failed (exit ${exitCode})`;
 }
+function hasDirenv() {
+  return Bun.spawnSync(["direnv", "version"], { stdout: "pipe", stderr: "pipe" }).exitCode === 0;
+}
 
 class BunLifecycleHookRunner {
+  direnvAvailable = null;
+  checkDirenv() {
+    if (this.direnvAvailable === null) {
+      this.direnvAvailable = hasDirenv();
+    }
+    return this.direnvAvailable;
+  }
+  async buildCommand(cwd, command) {
+    if (this.checkDirenv() && await Bun.file(join2(cwd, ".envrc")).exists()) {
+      Bun.spawnSync(["direnv", "allow"], { cwd, stdout: "pipe", stderr: "pipe" });
+      return ["direnv", "exec", cwd, "bash", "-c", command];
+    }
+    return ["bash", "-c", command];
+  }
   async run(input) {
-    const proc = Bun.spawn(["bash", "-lc", input.command], {
+    const cmd = await this.buildCommand(input.cwd, input.command);
+    console.debug(`[hook-runner] Spawning: ${cmd.join(" ")} cwd=${input.cwd}`);
+    console.debug(`[hook-runner] Env keys: ${Object.keys(input.env).join(", ")}`);
+    const proc = Bun.spawn(cmd, {
       cwd: input.cwd,
       env: {
         ...Bun.env,
@@ -7955,6 +7976,11 @@ class BunLifecycleHookRunner {
       new Response(proc.stdout).text(),
       new Response(proc.stderr).text()
     ]);
+    console.debug(`[hook-runner] ${input.name} exitCode=${exitCode}`);
+    if (stdout.trim())
+      console.debug(`[hook-runner] stdout: ${stdout.trim()}`);
+    if (stderr.trim())
+      console.debug(`[hook-runner] stderr: ${stderr.trim()}`);
     if (exitCode !== 0) {
       throw new Error(buildErrorMessage(input.name, exitCode, stdout, stderr));
     }
@@ -8678,11 +8704,11 @@ import { dirname as dirname3, resolve as resolve3 } from "path";
 
 // backend/src/adapters/agent-runtime.ts
 import { chmod as chmod2, mkdir as mkdir3 } from "fs/promises";
-import { dirname as dirname2, join as join3 } from "path";
+import { dirname as dirname2, join as join4 } from "path";
 
 // backend/src/adapters/fs.ts
 import { mkdir as mkdir2 } from "fs/promises";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 var SAFE_ENV_VALUE_RE = /^[A-Za-z0-9_./:@%+=,-]+$/;
 function stringifyAllocatedPorts(ports) {
   const entries = Object.entries(ports).map(([key, value]) => [key, String(value)]);
@@ -8694,14 +8720,14 @@ function quoteEnvValue(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
 function getWorktreeStoragePaths(gitDir) {
-  const webmuxDir = join2(gitDir, "webmux");
+  const webmuxDir = join3(gitDir, "webmux");
   return {
     gitDir,
     webmuxDir,
-    metaPath: join2(webmuxDir, "meta.json"),
-    runtimeEnvPath: join2(webmuxDir, "runtime.env"),
-    controlEnvPath: join2(webmuxDir, "control.env"),
-    prsPath: join2(webmuxDir, "prs.json")
+    metaPath: join3(webmuxDir, "meta.json"),
+    runtimeEnvPath: join3(webmuxDir, "runtime.env"),
+    controlEnvPath: join3(webmuxDir, "control.env"),
+    prsPath: join3(webmuxDir, "prs.json")
   };
 }
 async function ensureWorktreeStorageDirs(gitDir) {
@@ -9053,8 +9079,8 @@ async function mergeClaudeSettings(settingsPath, hookSettings) {
 async function ensureAgentRuntimeArtifacts(input) {
   const storagePaths = getWorktreeStoragePaths(input.gitDir);
   const artifacts = {
-    agentCtlPath: join3(storagePaths.webmuxDir, "webmux-agentctl"),
-    claudeSettingsPath: join3(input.worktreePath, ".claude", "settings.local.json")
+    agentCtlPath: join4(storagePaths.webmuxDir, "webmux-agentctl"),
+    claudeSettingsPath: join4(input.worktreePath, ".claude", "settings.local.json")
   };
   await mkdir3(dirname2(artifacts.claudeSettingsPath), { recursive: true });
   await Bun.write(artifacts.agentCtlPath, buildAgentCtlScript());
@@ -9710,9 +9736,12 @@ class LifecycleService {
     await this.deps.reconciliation.reconcile(this.deps.projectRoot);
   }
   async runLifecycleHook(input) {
+    console.debug(`[lifecycle-hook] name=${input.name} command=${input.command ?? "UNDEFINED"} meta=${input.meta ? "present" : "NULL"} cwd=${input.worktreePath}`);
     if (!input.command || !input.meta) {
+      console.debug(`[lifecycle-hook] SKIPPING ${input.name}: command=${!!input.command} meta=${!!input.meta}`);
       return;
     }
+    console.debug(`[lifecycle-hook] RUNNING ${input.name}: ${input.command} in ${input.worktreePath}`);
     await this.deps.hooks.run({
       name: input.name,
       command: input.command,
@@ -9721,6 +9750,7 @@ class LifecycleService {
         WEBMUX_WORKTREE_PATH: input.worktreePath
       })
     });
+    console.debug(`[lifecycle-hook] COMPLETED ${input.name}`);
   }
   wrapOperationError(error) {
     if (error instanceof LifecycleError) {
@@ -10839,7 +10869,7 @@ Bun.serve({
     if (STATIC_DIR) {
       const url = new URL(req.url);
       const rawPath = url.pathname === "/" ? "index.html" : url.pathname;
-      const filePath = join5(STATIC_DIR, rawPath);
+      const filePath = join6(STATIC_DIR, rawPath);
       const staticRoot = resolve5(STATIC_DIR);
       if (!resolve5(filePath).startsWith(staticRoot + "/")) {
         return new Response("Forbidden", { status: 403 });
@@ -10849,7 +10879,7 @@ Bun.serve({
         const headers = rawPath.startsWith("/assets/") ? { "Cache-Control": "public, max-age=31536000, immutable" } : {};
         return new Response(file, { headers });
       }
-      return new Response(Bun.file(join5(STATIC_DIR, "index.html")), {
+      return new Response(Bun.file(join6(STATIC_DIR, "index.html")), {
         headers: { "Cache-Control": "no-cache" }
       });
     }

package/bin/webmux.js

@@ -1557,7 +1557,7 @@ function createAgentStreamPrinter(label) {
     }
   };
 }
-var deps, gitRoot, missing, webmuxYaml;
+var deps, gitRoot, missing, MIN_BUN_VERSION = "1.3.5", bunVersionResult, webmuxYaml;
 var init_init = __esm(async () => {
   init_dist2();
   init_shared();
@@ -1589,6 +1589,19 @@ var init_init = __esm(async () => {
     Gt("Setup incomplete.");
     process.exit(1);
   }
+  bunVersionResult = run("bun", ["--version"]);
+  if (bunVersionResult.success) {
+    const bunVersion = bunVersionResult.stdout.toString().trim();
+    const [major, minor, patch] = bunVersion.split(".").map(Number);
+    const [reqMajor, reqMinor, reqPatch] = MIN_BUN_VERSION.split(".").map(Number);
+    const tooOld = major < reqMajor || major === reqMajor && minor < reqMinor || major === reqMajor && minor === reqMinor && patch < reqPatch;
+    if (tooOld) {
+      R2.error(`Bun ${bunVersion} is too old. webmux requires Bun >= ${MIN_BUN_VERSION}.`);
+      R2.info("Upgrade with: bun upgrade");
+      Gt("Setup incomplete.");
+      process.exit(1);
+    }
+  }
   if (which("gh")) {
     const ghAuth = run("gh", ["auth", "status"]);
     if (!ghAuth.success) {