@bulletproof-sh/ctrl-daemon 0.0.2 → 0.0.4

package/README.md

@@ -0,0 +1,74 @@
+# @bulletproof-sh/ctrl-daemon
+
+WebSocket daemon for [Ctrl / Cubicles](https://bulletproof.sh) — watches Claude Code sessions on disk and broadcasts live agent state to connected web clients.
+
+## Requirements
+
+- [Bun](https://bun.sh) — required at runtime (`curl -fsSL https://bun.sh/install | bash`)
+
+## Usage
+
+```sh
+# Watch all Claude Code projects (default)
+npx @bulletproof-sh/ctrl-daemon
+
+# Watch a single project directory
+npx @bulletproof-sh/ctrl-daemon --project-dir /path/to/your/project
+
+# Custom port / host
+npx @bulletproof-sh/ctrl-daemon --port 3001 --host 127.0.0.1
+```
+
+### Options
+
+| Flag | Default | Description |
+|---|---|---|
+| `--port <number>` | `3001` | Port to listen on |
+| `--host <address>` | `0.0.0.0` | Host/address to bind to |
+| `--project-dir <path>` | — | Watch a single project; omit to watch all projects |
+| `--help`, `-h` | — | Print usage |
+
+Without `--project-dir`, the daemon scans `~/.claude/projects/` and watches every session it finds there.
+
+## WebSocket API
+
+Connect to `ws://localhost:3001/ws`. The daemon broadcasts JSON messages whenever agent state changes — the same message format used by the VS Code extension's internal webview protocol.
+
+The [Ctrl web app](https://ctrl.bulletproof.sh) connects here by default. You can change the URL in the app's Settings modal or by setting `VITE_DAEMON_WS_URL` at build time.
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `VITE_PUBLIC_POSTHOG_KEY` | PostHog API key for analytics (optional) |
+| `VITE_PUBLIC_POSTHOG_HOST` | PostHog host (default: `https://us.i.posthog.com`) |
+| `CLAUDE_HOME` | Override the Claude home directory (default: `~/.claude`) |
+
+Analytics are disabled when `VITE_PUBLIC_POSTHOG_KEY` is not set. Crash reports use PostHog Error Tracking (free feature).
+
+## Auto-update
+
+On startup the daemon checks npm for a newer version and prints a notice if one is available:
+
+```
+[ctrl-daemon] Update available: v0.0.2 → v0.0.3
+  Run: npm install -g @bulletproof-sh/ctrl-daemon@latest
+```
+
+The check is non-blocking and fails silently if the registry is unreachable.
+
+> **Note:** If you're running via `npx`, you already get the latest version on every invocation — no manual update needed.
+
+## Development
+
+```sh
+bun install
+bun run dev        # watch mode
+bun run build      # compile to dist/
+bun run check      # biome lint + format
+```
+
+## License
+
+MIT
+

package/bin/ctrl-daemon.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { execFileSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const entry = join(__dirname, "..", "dist", "index.js");

package/dist/index.js

@@ -16,6 +16,10 @@ import * as path3 from "path";
 // src/analytics.ts
 import os from "os";
 
+// ../shared/src/constants.ts
+var DEFAULT_POSTHOG_KEY = "phc_V3aPfuu7VEWm1u4CEYLIFr8Ksk8nR7qyZzGn8HotO8U";
+var DEFAULT_POSTHOG_HOST = "https://a.bulletproof.sh";
+
 // node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
 import { dirname, posix, sep } from "path";
 function createModulerModifier() {
@@ -4204,17 +4208,26 @@ class PostHog extends PostHogBackendClient {
 }
 
 // src/analytics.ts
-var POSTHOG_API_KEY = process.env.VITE_PUBLIC_POSTHOG_KEY ?? "";
-var POSTHOG_HOST = process.env.VITE_PUBLIC_POSTHOG_HOST ?? "https://us.i.posthog.com";
+var systemInfo = {
+  os_platform: os.platform(),
+  os_arch: os.arch(),
+  os_release: os.release(),
+  node_version: process.version
+};
+var POSTHOG_API_KEY = process.env.VITE_PUBLIC_POSTHOG_KEY ?? DEFAULT_POSTHOG_KEY;
+var POSTHOG_HOST = process.env.VITE_PUBLIC_POSTHOG_HOST ?? DEFAULT_POSTHOG_HOST;
+var customKey = !!process.env.VITE_PUBLIC_POSTHOG_KEY;
+var customHost = !!process.env.VITE_PUBLIC_POSTHOG_HOST;
 var client = null;
 var distinctId = os.hostname();
 function initAnalytics() {
-  if (!POSTHOG_API_KEY)
-    return;
-  client = new PostHog(POSTHOG_API_KEY, { host: POSTHOG_HOST });
-  client.on("error", (err) => {
-    console.error("[ctrl-daemon] PostHog error:", err);
-  });
+  if (POSTHOG_API_KEY) {
+    client = new PostHog(POSTHOG_API_KEY, { host: POSTHOG_HOST });
+    client.on("error", (err) => {
+      console.error("[ctrl-daemon] PostHog error:", err);
+    });
+  }
+  return { customKey, customHost };
 }
 function trackEvent(event, properties) {
   if (!client)
@@ -4824,6 +4837,67 @@ function createServer({ port, host, agents }) {
   };
 }
 
+// src/updater.ts
+var PACKAGE_NAME = "@bulletproof-sh/ctrl-daemon";
+var NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+var UPDATE_CHECK_TIMEOUT_MS = 5000;
+function parseSemver(version2) {
+  const match = version2.match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!match)
+    return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isNewer(current, next) {
+  const a = parseSemver(current);
+  const b = parseSemver(next);
+  if (!a || !b)
+    return false;
+  for (let i = 0;i < 3; i++) {
+    if (b[i] > a[i])
+      return true;
+    if (b[i] < a[i])
+      return false;
+  }
+  return false;
+}
+async function getCurrentVersion() {
+  try {
+    const pkgFile = Bun.file(new URL("../package.json", import.meta.url));
+    const pkg = await pkgFile.json();
+    return pkg.version ?? null;
+  } catch {
+    return null;
+  }
+}
+async function getLatestVersion() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), UPDATE_CHECK_TIMEOUT_MS);
+    const res = await fetch(NPM_REGISTRY_URL, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+async function checkForUpdate() {
+  const [current, latest] = await Promise.all([
+    getCurrentVersion(),
+    getLatestVersion()
+  ]);
+  if (!current || !latest)
+    return;
+  if (!isNewer(current, latest))
+    return;
+  console.log(`
+[ctrl-daemon] Update available: v${current} \u2192 v${latest}
+` + `  Run: npx ${PACKAGE_NAME}@latest
+`);
+}
+
 // src/index.ts
 function printUsage() {
   console.log(`Usage: ctrl-daemon [options]
@@ -4860,18 +4934,19 @@ function resolveProjectsRoot(claudeHome) {
   const home = claudeHome || path3.join(process.env.HOME || "~", ".claude");
   return path3.join(home, "projects");
 }
-function main() {
-  initAnalytics();
+async function main() {
+  const analyticsConfig = initAnalytics();
+  const [version2] = await Promise.all([getCurrentVersion(), checkForUpdate()]);
   process.on("uncaughtException", async (err) => {
     console.error("[ctrl-daemon] Uncaught exception:", err);
-    trackException(err);
+    trackException(err, { ...systemInfo, crash_type: "uncaughtException" });
     await shutdownAnalytics();
     process.exit(1);
   });
   process.on("unhandledRejection", async (reason) => {
     const err = reason instanceof Error ? reason : new Error(String(reason));
     console.error("[ctrl-daemon] Unhandled rejection:", err);
-    trackException(err);
+    trackException(err, { ...systemInfo, crash_type: "unhandledRejection" });
     await shutdownAnalytics();
     process.exit(1);
   });
@@ -4895,10 +4970,12 @@ function main() {
   const permissionTimers = new Map;
   const server = createServer({ port, host, agents });
   trackEvent("daemon_started", {
-    distinct_id: distinctId,
+    version: version2 ?? "unknown",
     port,
     host,
-    mode: projectDir ? "single" : "all"
+    mode: projectDir ? "single" : "all",
+    ...systemInfo,
+    ...analyticsConfig
   });
   const scanAll = !projectDir;
   const scanner = startProjectScanner(scanDirs[0], scanAll, agents, fileWatchers, pollingTimers, waitingTimers, permissionTimers, server.broadcast);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bulletproof-sh/ctrl-daemon",
-	"version": "0.0.2",
+	"version": "0.0.4",
 	"description": "WebSocket daemon for ctrl — watches Claude Code sessions and broadcasts agent state",
 	"type": "module",
 	"license": "MIT",