swarm-mail 0.1.4 → 0.2.0

package/bin/daemon-cli.ts

@@ -0,0 +1,304 @@
+#!/usr/bin/env bun
+/**
+ * swarm-mail-daemon CLI
+ *
+ * Command-line interface for managing the swarm-mail pglite-server daemon.
+ *
+ * Commands:
+ *   start [options]  - Start the daemon
+ *   stop             - Stop the daemon
+ *   status           - Show daemon status
+ *
+ * @example
+ * ```bash
+ * # Start daemon on default port
+ * swarm-mail-daemon start
+ *
+ * # Start with custom port
+ * swarm-mail-daemon start --port 5555
+ *
+ * # Start with Unix socket
+ * swarm-mail-daemon start --path /tmp/swarm-mail.sock
+ *
+ * # Check status
+ * swarm-mail-daemon status
+ *
+ * # Stop daemon
+ * swarm-mail-daemon stop
+ * ```
+ */
+
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { parseArgs } from "node:util";
+import {
+	type DaemonOptions,
+	getPidFilePath,
+	healthCheck,
+	isDaemonRunning,
+	startDaemon,
+	stopDaemon,
+} from "../src/daemon";
+
+// Colors for terminal output
+const colors = {
+	reset: "\x1b[0m",
+	red: "\x1b[31m",
+	green: "\x1b[32m",
+	yellow: "\x1b[33m",
+	blue: "\x1b[34m",
+	dim: "\x1b[2m",
+	bold: "\x1b[1m",
+};
+
+function success(msg: string) {
+	console.log(`${colors.green}✓${colors.reset} ${msg}`);
+}
+
+function error(msg: string) {
+	console.error(`${colors.red}✗${colors.reset} ${msg}`);
+}
+
+function info(msg: string) {
+	console.log(`${colors.blue}ℹ${colors.reset} ${msg}`);
+}
+
+function showHelp() {
+	console.log(`
+${colors.bold}swarm-mail-daemon${colors.reset} - Manage pglite-server daemon for swarm-mail
+
+${colors.bold}USAGE${colors.reset}
+  swarm-mail-daemon <command> [options]
+
+${colors.bold}COMMANDS${colors.reset}
+  start [options]  Start the daemon
+  stop             Stop the daemon
+  status           Show daemon status
+
+${colors.bold}START OPTIONS${colors.reset}
+  --port <number>    TCP port to bind (default: 5433)
+  --host <string>    Host to bind (default: 127.0.0.1)
+  --path <string>    Unix socket path (alternative to port/host)
+  --db <string>      Database path (default: .opencode/streams or ~/.opencode/streams)
+  --project <string> Project path for PID file location
+
+${colors.bold}EXAMPLES${colors.reset}
+  # Start daemon on default port
+  swarm-mail-daemon start
+
+  # Start with custom port
+  swarm-mail-daemon start --port 5555
+
+  # Start with Unix socket
+  swarm-mail-daemon start --path /tmp/swarm-mail.sock
+
+  # Start with custom database path
+  swarm-mail-daemon start --db /custom/db/path
+
+  # Check status
+  swarm-mail-daemon status
+
+  # Stop daemon
+  swarm-mail-daemon stop
+`);
+}
+
+/**
+ * Read PID from PID file
+ */
+async function readPid(projectPath?: string): Promise<number | null> {
+	const pidFilePath = getPidFilePath(projectPath);
+	if (!existsSync(pidFilePath)) {
+		return null;
+	}
+	try {
+		const content = await readFile(pidFilePath, "utf-8");
+		const pid = Number.parseInt(content.trim(), 10);
+		if (Number.isNaN(pid) || pid <= 0) {
+			return null;
+		}
+		return pid;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Start command handler
+ */
+async function startCommand(args: string[]): Promise<void> {
+	const { values } = parseArgs({
+		args,
+		options: {
+			port: { type: "string", short: "p" },
+			host: { type: "string", short: "h" },
+			path: { type: "string" },
+			db: { type: "string" },
+			project: { type: "string" },
+			help: { type: "boolean" },
+		},
+	});
+
+	if (values.help) {
+		showHelp();
+		return;
+	}
+
+	const options: DaemonOptions = {
+		port: values.port ? Number.parseInt(values.port, 10) : undefined,
+		host: values.host,
+		path: values.path,
+		dbPath: values.db,
+		projectPath: values.project,
+	};
+
+	try {
+		// Check if already running
+		if (await isDaemonRunning(options.projectPath)) {
+			const pid = await readPid(options.projectPath);
+			const connInfo = options.path
+				? `socket=${options.path}`
+				: `port=${options.port || 5433}`;
+			info(`Daemon already running (PID: ${pid}, ${connInfo})`);
+			return;
+		}
+
+		info("Starting daemon...");
+		const daemonInfo = await startDaemon(options);
+
+		const connInfo = daemonInfo.socketPath
+			? `socket=${daemonInfo.socketPath}`
+			: `port=${daemonInfo.port}`;
+		success(`Daemon started (PID: ${daemonInfo.pid}, ${connInfo})`);
+	} catch (err) {
+		error(
+			`Failed to start daemon: ${err instanceof Error ? err.message : String(err)}`,
+		);
+		process.exit(1);
+	}
+}
+
+/**
+ * Stop command handler
+ */
+async function stopCommand(args: string[]): Promise<void> {
+	const { values } = parseArgs({
+		args,
+		options: {
+			project: { type: "string" },
+			help: { type: "boolean" },
+		},
+	});
+
+	if (values.help) {
+		showHelp();
+		return;
+	}
+
+	try {
+		const pid = await readPid(values.project);
+
+		if (!pid || !(await isDaemonRunning(values.project))) {
+			info("Daemon is not running");
+			return;
+		}
+
+		info(`Stopping daemon (PID: ${pid})...`);
+		await stopDaemon(values.project);
+		success("Daemon stopped");
+	} catch (err) {
+		error(
+			`Failed to stop daemon: ${err instanceof Error ? err.message : String(err)}`,
+		);
+		process.exit(1);
+	}
+}
+
+/**
+ * Status command handler
+ */
+async function statusCommand(args: string[]): Promise<void> {
+	const { values } = parseArgs({
+		args,
+		options: {
+			port: { type: "string", short: "p" },
+			host: { type: "string", short: "h" },
+			path: { type: "string" },
+			project: { type: "string" },
+			help: { type: "boolean" },
+		},
+	});
+
+	if (values.help) {
+		showHelp();
+		return;
+	}
+
+	const projectPath = values.project;
+	const pid = await readPid(projectPath);
+	const running = await isDaemonRunning(projectPath);
+
+	if (!running) {
+		console.log(`${colors.bold}Status:${colors.reset} ${colors.red}Stopped${colors.reset}`);
+		console.log(`${colors.bold}PID File:${colors.reset} ${getPidFilePath(projectPath)}`);
+		return;
+	}
+
+	// Daemon is running - check health
+	const port = values.port ? Number.parseInt(values.port, 10) : 5433;
+	const host = values.host || "127.0.0.1";
+	const path = values.path;
+
+	const healthOptions = path ? { path } : { port, host };
+	const healthy = await healthCheck(healthOptions);
+
+	console.log(
+		`${colors.bold}Status:${colors.reset} ${colors.green}Running${colors.reset}`,
+	);
+	console.log(`${colors.bold}PID:${colors.reset} ${pid}`);
+	console.log(`${colors.bold}PID File:${colors.reset} ${getPidFilePath(projectPath)}`);
+
+	if (path) {
+		console.log(`${colors.bold}Socket:${colors.reset} ${path}`);
+	} else {
+		console.log(`${colors.bold}Host:${colors.reset} ${host}`);
+		console.log(`${colors.bold}Port:${colors.reset} ${port}`);
+	}
+
+	console.log(
+		`${colors.bold}Health:${colors.reset} ${healthy ? `${colors.green}OK${colors.reset}` : `${colors.red}Failed${colors.reset}`}`,
+	);
+}
+
+/**
+ * Main CLI entrypoint
+ */
+async function main() {
+	const [command, ...args] = process.argv.slice(2);
+
+	if (!command || command === "help" || command === "--help" || command === "-h") {
+		showHelp();
+		process.exit(0);
+	}
+
+	switch (command) {
+		case "start":
+			await startCommand(args);
+			break;
+		case "stop":
+			await stopCommand(args);
+			break;
+		case "status":
+			await statusCommand(args);
+			break;
+		default:
+			error(`Unknown command: ${command}`);
+			showHelp();
+			process.exit(1);
+	}
+}
+
+main().catch((err) => {
+	error(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+	process.exit(1);
+});

package/dist/daemon.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Daemon Lifecycle Management for pglite-server
+ *
+ * Provides start/stop/health functionality for the pglite-server daemon process.
+ * Uses detached child_process for background operation with PID file tracking.
+ *
+ * ## Usage
+ * ```typescript
+ * import { startDaemon, stopDaemon, isDaemonRunning, healthCheck } from 'swarm-mail/daemon';
+ *
+ * // Start daemon
+ * const { pid, port } = await startDaemon({ port: 5433 });
+ *
+ * // Check health
+ * const healthy = await healthCheck({ port: 5433 });
+ *
+ * // Stop daemon
+ * await stopDaemon('/path/to/project');
+ * ```
+ */
+/**
+ * Daemon start options
+ */
+export interface DaemonOptions {
+    /** TCP port to bind (default: 5433) */
+    port?: number;
+    /** Host to bind (default: 127.0.0.1) */
+    host?: string;
+    /** Unix socket path (alternative to port/host) */
+    path?: string;
+    /** Database path (default: project .opencode/streams or ~/.opencode/streams) */
+    dbPath?: string;
+    /** Project path for PID file location (default: global ~/.opencode) */
+    projectPath?: string;
+}
+/**
+ * Daemon info returned by startDaemon
+ */
+export interface DaemonInfo {
+    /** Process ID */
+    pid: number;
+    /** TCP port (if using TCP) */
+    port?: number;
+    /** Unix socket path (if using socket) */
+    socketPath?: string;
+}
+/**
+ * Get PID file path for a project
+ *
+ * Stores PID file in $TMPDIR alongside the streams database.
+ * Path format: `$TMPDIR/opencode-<project-name>-<hash>/pglite-server.pid`
+ * Falls back to global `$TMPDIR/opencode-global/pglite-server.pid`
+ *
+ * @param projectPath - Optional project root path
+ * @returns Absolute path to PID file
+ */
+export declare function getPidFilePath(projectPath?: string): string;
+/**
+ * Check if daemon is running
+ *
+ * Checks both PID file existence and process liveness.
+ *
+ * @param projectPath - Optional project root path
+ * @returns true if daemon is running
+ *
+ * @example
+ * ```typescript
+ * if (!await isDaemonRunning()) {
+ *   await startDaemon();
+ * }
+ * ```
+ */
+export declare function isDaemonRunning(projectPath?: string): Promise<boolean>;
+/**
+ * Health check - verify daemon is responding
+ *
+ * Connects to the daemon and runs SELECT 1 query.
+ * Times out after 5 seconds.
+ *
+ * @param options - Connection options (port/host or path)
+ * @returns true if daemon is healthy
+ *
+ * @example
+ * ```typescript
+ * const healthy = await healthCheck({ port: 5433 });
+ * if (!healthy) {
+ *   console.error('Daemon not responding');
+ * }
+ * ```
+ */
+export declare function healthCheck(options: Pick<DaemonOptions, "port" | "host" | "path">): Promise<boolean>;
+/**
+ * Start pglite-server daemon
+ *
+ * Spawns pglite-server as a detached background process.
+ * Writes PID file and waits for server to be ready via health check.
+ *
+ * If daemon is already running, returns existing daemon info.
+ *
+ * @param options - Daemon configuration
+ * @returns Daemon info (PID and connection details)
+ * @throws Error if daemon fails to start
+ *
+ * @example
+ * ```typescript
+ * // Start with TCP port
+ * const { pid, port } = await startDaemon({ port: 5433 });
+ *
+ * // Start with Unix socket
+ * const { pid, socketPath } = await startDaemon({
+ *   path: '/tmp/swarm-mail-pglite.sock'
+ * });
+ *
+ * // Start with custom database path
+ * const { pid, port } = await startDaemon({
+ *   port: 5433,
+ *   dbPath: '/custom/path/to/db'
+ * });
+ * ```
+ */
+export declare function startDaemon(options?: DaemonOptions): Promise<DaemonInfo>;
+/**
+ * Stop pglite-server daemon
+ *
+ * Sends SIGTERM to the daemon process and waits for clean shutdown.
+ * Cleans up PID file after process exits.
+ *
+ * If daemon is not running, this is a no-op (not an error).
+ *
+ * @param projectPath - Optional project root path
+ * @throws Error if daemon doesn't stop within timeout
+ *
+ * @example
+ * ```typescript
+ * await stopDaemon('/path/to/project');
+ * ```
+ */
+export declare function stopDaemon(projectPath?: string): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB3D;AAqGD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,GACrD,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAgErB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CpE"}

package/dist/index.d.ts

@@ -17,7 +17,11 @@
 export declare const SWARM_MAIL_VERSION = "0.1.0";
 export { createSwarmMailAdapter } from "./adapter";
 export type { DatabaseAdapter, SwarmMailAdapter, EventStoreAdapter, AgentAdapter, MessagingAdapter, ReservationAdapter, SchemaAdapter, ReadEventsOptions, InboxOptions, Message, Reservation, Conflict, } from "./types";
-export { getSwarmMail, createInMemorySwarmMail, closeSwarmMail, closeAllSwarmMail, getDatabasePath, PGlite, } from "./pglite";
+export { getSwarmMail, getSwarmMailSocket, createInMemorySwarmMail, closeSwarmMail, closeAllSwarmMail, getDatabasePath, getProjectTempDirName, hashProjectPath, PGlite, } from "./pglite";
+export { wrapPostgres, createSocketAdapter, } from "./socket-adapter";
+export type { SocketAdapterOptions } from "./socket-adapter";
 export * from "./streams";
 export * from "./beads";
+export { startDaemon, stopDaemon, isDaemonRunning, healthCheck, getPidFilePath, } from "./daemon";
+export type { DaemonOptions, DaemonInfo } from "./daemon";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAM1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,MAAM,GACP,MAAM,UAAU,CAAC;AAMlB,cAAc,WAAW,CAAC;AAM1B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAM1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,MAAM,GACP,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAM7D,cAAc,WAAW,CAAC;AAM1B,cAAc,SAAS,CAAC;AAMxB,OAAO,EACL,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}