@autoclawd/autoclawd 1.0.0 → 1.0.2

package/Dockerfile

@@ -1,18 +1,15 @@
-# autoclawd base image — all common runtimes for Claude Code
-# Use this as docker.image in your config for zero-setup multi-language support
+# autoclawd Docker image — multi-runtime environment for Claude Code
 #
-# Build:  docker build -t autoclawd-base .
-# Config: docker: { image: autoclawd-base }
+# Build:  docker build -t autoclawd .
+# Config: docker: { image: autoclawd }
 #
-# Includes: Node.js 20, Python 3, Go, Rust, Ruby, Git, common build tools
-# Size: ~1.5 GB (trades disk for zero-config developer experience)
+# Includes: Node.js 20, Python 3, Go, Ruby, Git, common build tools
+# Claude Code is auto-installed by autoclawd at runtime — not baked in
 
 FROM node:20-bookworm
 
-# Avoid interactive prompts during package installation
 ENV DEBIAN_FRONTEND=noninteractive
 
-# Common build tools + git (already in node:20 but be explicit)
 RUN apt-get update && apt-get install -y --no-install-recommends \
     build-essential \
     git \
@@ -22,15 +19,12 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     openssh-client \
     jq \
     unzip \
-    # Python
     python3 \
     python3-pip \
     python3-venv \
     python3-dev \
-    # Ruby
     ruby \
     ruby-dev \
-    # Go (via official tarball for latest stable)
     && rm -rf /var/lib/apt/lists/*
 
 # Install Go (bookworm packages are often outdated)
@@ -39,19 +33,15 @@ RUN curl -fsSL "https://go.dev/dl/go${GO_VERSION}.linux-$(dpkg --print-architect
     | tar -xz -C /usr/local
 ENV PATH="/usr/local/go/bin:${PATH}"
 
-# Rust is omitted by default (~1.5GB). For Rust repos, use docker.setup:
+# Rust is omitted (~1.5GB). For Rust repos, use docker.setup:
 #   docker:
 #     setup:
 #       - curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
 
-# Pre-install Claude Code globally
-RUN npm install -g @anthropic-ai/claude-code@latest
-
 # Verify installations
 RUN node --version && python3 --version && go version && ruby --version && git --version
 
-# Workspace directory
 WORKDIR /workspace
 
-LABEL org.opencontainers.image.title="autoclawd-base"
-LABEL org.opencontainers.image.description="Multi-runtime base image for autoclawd (Linear → Claude Code → PRs)"
+LABEL org.opencontainers.image.title="autoclawd"
+LABEL org.opencontainers.image.description="Multi-runtime environment for autoclawd (Linear → Claude Code → PRs)"

package/dist/index.js

@@ -184,6 +184,10 @@ function enableFileLogging() {
   const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   logFilePath = join2(logDir, `autoclawd-${date}.log`);
 }
+function getLogFilePath() {
+  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return join2(homedir2(), ".autoclawd", "logs", `autoclawd-${date}.log`);
+}
 function shouldLog(level) {
   return levels[level] >= levels[currentLevel];
 }
@@ -535,10 +539,9 @@ import { createHmac, timingSafeEqual } from "crypto";
 // src/docker.ts
 import Docker from "dockerode";
 import { PassThrough } from "stream";
-import { homedir as homedir3, tmpdir } from "os";
+import { homedir as homedir3 } from "os";
 import { join as join3 } from "path";
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync, mkdtempSync, rmSync } from "fs";
-import { execSync } from "child_process";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 var docker = new Docker();
 async function checkDockerAvailable() {
   try {
@@ -549,20 +552,6 @@ async function checkDockerAvailable() {
     );
   }
 }
-var AUTOCODE_BASE_DOCKERFILE = `FROM node:20-bookworm
-ENV DEBIAN_FRONTEND=noninteractive
-RUN apt-get update && apt-get install -y --no-install-recommends \\
-    build-essential git curl wget ca-certificates openssh-client jq unzip \\
-    python3 python3-pip python3-venv python3-dev \\
-    ruby ruby-dev \\
-    && rm -rf /var/lib/apt/lists/*
-ARG GO_VERSION=1.22.2
-RUN curl -fsSL "https://go.dev/dl/go\${GO_VERSION}.linux-$(dpkg --print-architecture).tar.gz" \\
-    | tar -xz -C /usr/local
-ENV PATH="/usr/local/go/bin:\${PATH}"
-RUN npm install -g @anthropic-ai/claude-code@latest
-WORKDIR /workspace
-`;
 async function ensureImage(image) {
   try {
     await docker.getImage(image).inspect();
@@ -570,28 +559,6 @@ async function ensureImage(image) {
     return;
   } catch {
   }
-  if (image === "autoclawd-base") {
-    log.info("Building autoclawd-base image (first time only, takes a few minutes)...");
-    const buildDir = mkdtempSync(join3(tmpdir(), "autoclawd-build-"));
-    try {
-      writeFileSync(join3(buildDir, "Dockerfile"), AUTOCODE_BASE_DOCKERFILE);
-      execSync(`docker build -t autoclawd-base ${buildDir}`, {
-        stdio: "inherit",
-        timeout: 6e5
-      });
-      log.success("autoclawd-base image built");
-      return;
-    } catch (err) {
-      throw new Error(
-        `Failed to build autoclawd-base image.
-You can build manually: docker build -t autoclawd-base .
-Or use a different image in your config (e.g. node:20).
-Error: ${err instanceof Error ? err.message : err}`
-      );
-    } finally {
-      rmSync(buildDir, { recursive: true, force: true });
-    }
-  }
   log.info(`Pulling image ${image} (this may take a moment)...`);
   await retry(() => new Promise((resolve, reject) => {
     docker.pull(image, (err, stream) => {
@@ -1058,10 +1025,10 @@ async function commitAndPush(container, opts) {
 }
 
 // src/worker.ts
-import { mkdtempSync as mkdtempSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+import { mkdtempSync, rmSync, writeFileSync } from "fs";
 import { join as join5 } from "path";
-import { tmpdir as tmpdir2 } from "os";
-import { execSync as execSync2 } from "child_process";
+import { tmpdir } from "os";
+import { execSync } from "child_process";
 
 // src/db.ts
 import Database from "better-sqlite3";
@@ -1231,9 +1198,9 @@ function assertSafeRef(name, label) {
   }
 }
 function createAskpass(githubToken) {
-  const dir = mkdtempSync2(join5(tmpdir2(), "autoclawd-cred-"));
+  const dir = mkdtempSync(join5(tmpdir(), "autoclawd-cred-"));
   const path = join5(dir, "askpass.sh");
-  writeFileSync2(path, `#!/bin/sh
+  writeFileSync(path, `#!/bin/sh
 echo "${githubToken}"
 `, { mode: 448 });
   return { dir, path };
@@ -1245,7 +1212,7 @@ function detectDefaultBranch(repoUrl, githubToken) {
   const askpass = createAskpass(githubToken);
   const authedUrl = repoUrl.replace("https://", "https://x-access-token@");
   try {
-    const output = execSync2(
+    const output = execSync(
       `git ls-remote --symref -- ${authedUrl} HEAD`,
       { stdio: "pipe", timeout: 3e4, env: gitEnv(askpass.path), encoding: "utf-8" }
     );
@@ -1253,27 +1220,27 @@ function detectDefaultBranch(repoUrl, githubToken) {
     if (match) return match[1];
   } catch {
   } finally {
-    rmSync2(askpass.dir, { recursive: true, force: true });
+    rmSync(askpass.dir, { recursive: true, force: true });
   }
   return "main";
 }
 async function cloneToTemp(repoUrl, baseBranch, githubToken) {
   assertSafeRef(baseBranch, "base branch");
   return retrySync(() => {
-    const workDir = mkdtempSync2(join5(tmpdir2(), "autoclawd-"));
+    const workDir = mkdtempSync(join5(tmpdir(), "autoclawd-"));
     const askpass = createAskpass(githubToken);
     const authedUrl = repoUrl.replace("https://", "https://x-access-token@");
     try {
-      execSync2(`git clone --depth=50 -b ${baseBranch} -- ${authedUrl} ${workDir}`, {
+      execSync(`git clone --depth=50 -b ${baseBranch} -- ${authedUrl} ${workDir}`, {
         stdio: "pipe",
         timeout: 12e4,
         env: gitEnv(askpass.path)
       });
     } catch (err) {
-      rmSync2(workDir, { recursive: true, force: true });
+      rmSync(workDir, { recursive: true, force: true });
       throw err;
     } finally {
-      rmSync2(askpass.dir, { recursive: true, force: true });
+      rmSync(askpass.dir, { recursive: true, force: true });
     }
     return workDir;
   }, { label: "git clone", retryIf: isTransientError });
@@ -1409,10 +1376,10 @@ async function executeTicket(opts) {
       log.ticket(ticket.identifier, `Stacked on branch: ${ticket.baseBranch}`);
     }
     if (actualBase !== detectedBase) {
-      rmSync2(workDir, { recursive: true, force: true });
+      rmSync(workDir, { recursive: true, force: true });
       workDir = await cloneToTemp(ticket.repoUrl, actualBase, config.github.token);
     }
-    execSync2(`git checkout -B ${branchName} --`, { cwd: workDir, stdio: "pipe" });
+    execSync(`git checkout -B ${branchName} --`, { cwd: workDir, stdio: "pipe" });
     container = await createContainer({
       dockerConfig: docker2,
       workspacePath: workDir,
@@ -1579,7 +1546,7 @@ async function executeTicket(opts) {
     }
     if (workDir) {
       try {
-        rmSync2(workDir, { recursive: true, force: true });
+        rmSync(workDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -1668,7 +1635,7 @@ async function fixPR(opts) {
     if (container) await destroyContainer(container);
     if (workDir) {
       try {
-        rmSync2(workDir, { recursive: true, force: true });
+        rmSync(workDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -2143,7 +2110,7 @@ function printHistoryTable(records) {
 }
 
 // src/deps.ts
-import { execSync as execSync3 } from "child_process";
+import { execSync as execSync2 } from "child_process";
 import { existsSync as existsSync6 } from "fs";
 import { join as join7 } from "path";
 import { homedir as homedir5 } from "os";
@@ -2158,7 +2125,7 @@ function detectPackageManager() {
   ];
   for (const [name, cmd] of checks) {
     try {
-      execSync3(`which ${cmd}`, { stdio: "pipe" });
+      execSync2(`which ${cmd}`, { stdio: "pipe" });
       return name;
     } catch {
     }
@@ -2249,7 +2216,7 @@ function installDep(dep) {
   if (dep.installCommands.length === 0) return false;
   for (const cmd of dep.installCommands) {
     try {
-      execSync3(cmd, { stdio: "inherit", timeout: 3e5 });
+      execSync2(cmd, { stdio: "inherit", timeout: 3e5 });
     } catch {
       return false;
     }
@@ -2259,15 +2226,15 @@ function installDep(dep) {
 function addUserToDockerGroup() {
   if (process.platform !== "linux") return;
   try {
-    const user = execSync3("whoami", { encoding: "utf-8" }).trim();
-    execSync3(`sudo usermod -aG docker ${user}`, { stdio: "pipe" });
+    const user = execSync2("whoami", { encoding: "utf-8" }).trim();
+    execSync2(`sudo usermod -aG docker ${user}`, { stdio: "pipe" });
     log.info(`Added ${user} to docker group \u2014 log out and back in to apply`);
   } catch {
   }
 }
 function commandExists(cmd) {
   try {
-    execSync3(`which ${cmd}`, { stdio: "pipe" });
+    execSync2(`which ${cmd}`, { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -2275,7 +2242,7 @@ function commandExists(cmd) {
 }
 function isDockerRunning() {
   try {
-    execSync3("docker info", { stdio: "pipe", timeout: 1e4 });
+    execSync2("docker info", { stdio: "pipe", timeout: 1e4 });
     return true;
   } catch {
     return false;
@@ -2283,8 +2250,8 @@ function isDockerRunning() {
 }
 
 // src/index.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { execSync as execSync4 } from "child_process";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, writeFileSync as writeFileSync2, readFileSync as readFileSync4, unlinkSync } from "fs";
+import { execSync as execSync3, spawn as spawn2 } from "child_process";
 import { createInterface } from "readline";
 import { join as join8 } from "path";
 import { homedir as homedir6 } from "os";
@@ -2294,6 +2261,36 @@ import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
 var program = new Command();
+var WATCHER_PID_FILE = join8(homedir6(), ".autoclawd", "watcher.pid");
+function readWatcherPid() {
+  try {
+    const content = readFileSync4(WATCHER_PID_FILE, "utf-8").trim();
+    const pid = parseInt(content, 10);
+    return isNaN(pid) ? null : pid;
+  } catch {
+    return null;
+  }
+}
+function writeWatcherPid(pid) {
+  mkdirSync3(join8(homedir6(), ".autoclawd"), { recursive: true });
+  writeFileSync2(WATCHER_PID_FILE, String(pid), { mode: 384 });
+}
+function removeWatcherPid() {
+  try {
+    unlinkSync(WATCHER_PID_FILE);
+  } catch {
+  }
+}
+function getRunningWatcherPid() {
+  const pid = readWatcherPid();
+  if (pid === null) return null;
+  try {
+    process.kill(pid, 0);
+    return pid;
+  } catch {
+    return null;
+  }
+}
 program.name("autoclawd").description("Linear webhooks \u2192 Claude Code in Docker \u2192 PRs").version(pkg.version);
 function ask(question, defaultVal) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -2367,7 +2364,29 @@ program.command("serve").description("Start webhook server with auto-tunnel").op
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
 });
-program.command("watch").description("Poll Linear for tickets (no webhook/tunnel needed)").option("-c, --config <path>", "Config file path").option("-i, --interval <seconds>", "Poll interval in seconds", "30").option("--once", "Poll once and exit (useful for cron)").option("-v, --verbose", "Verbose logging").action(async (opts) => {
+program.command("watch").description("Poll Linear for tickets (no webhook/tunnel needed)").option("-c, --config <path>", "Config file path").option("-i, --interval <seconds>", "Poll interval in seconds", "30").option("--once", "Poll once and exit (useful for cron)").option("--foreground", "Run in foreground instead of daemonizing").option("-v, --verbose", "Verbose logging").action(async (opts) => {
+  if (!opts.foreground && !opts.once) {
+    const existingPid = getRunningWatcherPid();
+    if (existingPid !== null) {
+      console.error(`autoclawd watcher is already running (PID ${existingPid})`);
+      console.error(`Run 'autoclawd stop' to stop it, or use '--foreground' to run in terminal`);
+      process.exit(1);
+    }
+    const child = spawn2(process.argv[0], [...process.argv.slice(1), "--foreground"], {
+      detached: true,
+      stdio: "ignore"
+    });
+    await new Promise((resolve, reject) => {
+      child.once("spawn", resolve);
+      child.once("error", reject);
+    });
+    writeWatcherPid(child.pid);
+    const logPath = getLogFilePath();
+    console.log(`autoclawd watching in background (PID ${child.pid}, log: ${logPath})`);
+    child.unref();
+    process.exit(0);
+    return;
+  }
   if (opts.verbose) setLogLevel("debug");
   enableFileLogging();
   log.info(`autoclawd v${pkg.version}`);
@@ -2390,12 +2409,34 @@ program.command("watch").description("Poll Linear for tickets (no webhook/tunnel
   const shutdown = () => {
     log.info("Shutting down...");
     watcher.stop();
+    removeWatcherPid();
     process.exit(0);
   };
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
   await watcher.start(intervalSeconds, opts.once ?? false);
 });
+program.command("stop").description("Stop the background watcher").action(() => {
+  const pid = readWatcherPid();
+  if (pid === null) {
+    log.info("No watcher PID file found \u2014 watcher is not running");
+    return;
+  }
+  const running = getRunningWatcherPid();
+  if (running === null) {
+    removeWatcherPid();
+    log.info(`Removed stale PID file (process ${pid} is not running)`);
+    return;
+  }
+  try {
+    process.kill(pid, "SIGTERM");
+    removeWatcherPid();
+    log.success(`Watcher stopped (PID ${pid})`);
+  } catch (err) {
+    log.error(`Failed to stop watcher: ${err instanceof Error ? err.message : err}`);
+    process.exit(1);
+  }
+});
 program.command("run <ticket>").description("Run a single ticket (e.g. autoclawd run RAH-123)").option("-c, --config <path>", "Config file path").option("-v, --verbose", "Verbose logging").option("--dry-run", "Show what would happen without executing").option("--force", "Bypass completed-ticket check and re-run").action(async (ticketId, opts) => {
   if (opts.verbose) setLogLevel("debug");
   enableFileLogging();
@@ -2703,7 +2744,7 @@ program.command("init").description("Set up autoclawd interactively").action(asy
   }
   let ghToken = "";
   try {
-    ghToken = execSync4("gh auth token", { encoding: "utf-8" }).trim();
+    ghToken = execSync3("gh auth token", { encoding: "utf-8" }).trim();
     log.success(`GitHub token detected from gh CLI`);
   } catch {
     ghToken = await ask("GitHub personal access token");
@@ -2719,19 +2760,11 @@ program.command("init").description("Set up autoclawd interactively").action(asy
     log.error("GitHub token is invalid or expired");
     process.exit(1);
   }
-  console.log("\n  Docker image options:");
-  console.log("    autoclawd-base    \u2014 All runtimes: Node, Python, Go, Rust, Ruby (~1.5GB)");
-  console.log("                       Works with any repo, no per-repo config needed");
-  console.log("    node:20          \u2014 Node.js only (fast, ~300MB)");
-  const dockerImage = await ask("Docker image", "autoclawd-base");
-  if (dockerImage === "autoclawd-base") {
-    try {
-      execSync4("docker image inspect autoclawd-base", { stdio: "pipe" });
-      log.success("autoclawd-base image found");
-    } catch {
-      log.info("autoclawd-base will be built automatically on first run (~3 min)");
-    }
-  }
+  console.log("\n  Docker image (any image works \u2014 autoclawd auto-installs git + Claude Code):");
+  console.log("    node:20          \u2014 Node.js (default, recommended)");
+  console.log("    python:3.12      \u2014 Python");
+  console.log("    ubuntu:24.04     \u2014 General purpose");
+  const dockerImage = await ask("Docker image", "node:20");
   const model = await ask("Claude model", "claude-sonnet-4-6");
   const maxIter = await ask("Max iterations per ticket", "10");
   const config = `# autoclawd config \u2014 generated by autoclawd init
@@ -2762,7 +2795,7 @@ agent:
 
 maxConcurrent: 1
 `;
-  writeFileSync3(CONFIG_FILE, config, { mode: 384 });
+  writeFileSync2(CONFIG_FILE, config, { mode: 384 });
   log.success(`Config saved to ${CONFIG_FILE}`);
   console.log(`
   Setup complete! Next steps: