@decibelsystems/tools 2.0.0

package/dist/client/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Configuration for FacadeClient.
+ * Provide either stdio (command) or HTTP (daemonUrl) or both (bridge).
+ */
+export interface FacadeClientConfig {
+    /** Stdio: command to spawn MCP server (e.g. 'node') */
+    command?: string;
+    /** Stdio: args for the command (e.g. ['dist/server.js']) */
+    args?: string[];
+    /** Stdio: extra env vars for the child process */
+    env?: Record<string, string>;
+    /** Stdio: working directory for the child process */
+    cwd?: string;
+    /** HTTP: daemon URL (e.g. 'http://localhost:4888') */
+    daemonUrl?: string;
+    /** Auto-injected into every call as agentId */
+    agentId?: string;
+    /** Auto-injected into every call as project_id */
+    projectId?: string;
+    /** Restrict dispatch to these facades only */
+    allowedFacades?: string[];
+    /** Timeout in ms for individual calls (default: 30000) */
+    timeoutMs?: number;
+    /** Logger (defaults to no-op) */
+    logger?: (msg: string) => void;
+}
+export interface CallResult<T = unknown> {
+    data: T;
+    isError: false;
+}
+export interface CallError {
+    error: string;
+    code?: string;
+    isError: true;
+}
+export type FacadeResponse<T = unknown> = CallResult<T> | CallError;
+export interface BatchCall {
+    facade: string;
+    action: string;
+    params?: Record<string, unknown>;
+}
+export interface BatchResult {
+    facade: string;
+    action: string;
+    data?: unknown;
+    error?: string;
+    duration_ms: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/client/types.js

@@ -0,0 +1,8 @@
+// ============================================================================
+// FacadeClient Types
+// ============================================================================
+// Shared types for the agent-facing facade client SDK.
+// Consumed by decibel-agent's McpToolRouter and any headless agent.
+// ============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAC/E,uDAAuD;AACvD,oEAAoE;AACpE,+EAA+E"}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+export interface Config {
+    env: string;
+    org: string;
+    rootDir: string;
+}
+export declare function getConfig(): Config;
+export declare function log(message: string, ...args: unknown[]): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,IAAI,MAAM,CAQlC;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAK7D"}

package/dist/config.js

@@ -0,0 +1,19 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export function getConfig() {
+    const projectRoot = path.resolve(__dirname, '..');
+    return {
+        env: process.env.DECIBEL_ENV || 'dev',
+        org: process.env.DECIBEL_ORG || 'default',
+        rootDir: process.env.DECIBEL_MCP_ROOT || path.join(projectRoot, 'data'),
+    };
+}
+export function log(message, ...args) {
+    const config = getConfig();
+    if (config.env === 'dev') {
+        console.error(`[decibel-mcp] ${message}`, ...args);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAQ3C,MAAM,UAAU,SAAS;IACvB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAElD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK;QACrC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,SAAS;QACzC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,GAAG,IAAe;IACrD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,iBAAiB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/daemon.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Read PID from file. Returns null if file doesn't exist or is invalid.
+ */
+export declare function readPid(): number | null;
+/**
+ * Write current process PID to file.
+ */
+export declare function writePid(): void;
+/**
+ * Remove PID file.
+ */
+export declare function removePid(): void;
+/**
+ * Check if another daemon is already running.
+ * Returns the PID if running, null if not.
+ */
+export declare function checkRunning(): number | null;
+export declare function getLogPath(): string;
+/**
+ * Rotate a log file if it exceeds maxSizeBytes.
+ * Rotation: file → file.1 → file.2 → ... → file.{maxFiles} (deleted)
+ * Returns true if rotation occurred.
+ */
+export declare function rotateLog(filePath: string, maxSizeBytes?: number, maxFiles?: number): boolean;
+/**
+ * Check for crash loop. Returns true if safe to start, false if should exit.
+ * Exits process with code 0 if crash loop detected (tells launchd to stop).
+ */
+export declare function checkCrashLoop(): boolean;
+/**
+ * Reset crash count after healthy running period.
+ * Call once after successful startup.
+ */
+export declare function scheduleHealthReset(): void;
+/**
+ * Clear crash counter (for --reset-crashes CLI flag).
+ */
+export declare function resetCrashes(): void;
+/**
+ * Install signal handlers for graceful shutdown.
+ * Returns a promise that resolves when shutdown is requested.
+ */
+export declare function installShutdownHandlers(cleanup: () => Promise<void>): void;
+/**
+ * Install the launchd plist so the daemon auto-starts on login.
+ */
+export declare function installLaunchd(options?: {
+    port?: number;
+}): {
+    installed: boolean;
+    path: string;
+    message: string;
+};
+/**
+ * Uninstall the launchd plist and stop the daemon.
+ */
+export declare function uninstallLaunchd(): {
+    uninstalled: boolean;
+    message: string;
+};
+/**
+ * Get daemon status.
+ */
+export declare function daemonStatus(): {
+    running: boolean;
+    pid: number | null;
+    pidFile: string;
+    logFile: string;
+    launchd: boolean;
+    port: number | null;
+};
+/**
+ * Handle daemon subcommands: install, uninstall, status.
+ * Returns true if a subcommand was handled (and process should exit).
+ */
+export declare function handleDaemonSubcommand(args: string[]): boolean;
+//# 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":"AAgDA;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,GAAG,IAAI,CAQvC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAI/B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAOhC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAQ5C;AAMD,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AASD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,MAA8B,EAC5C,QAAQ,GAAE,MAA8B,GACvC,OAAO,CA0BT;AA6BD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAyBxC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAQ1C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC3B,IAAI,CA8BN;AAYD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAgDjH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkB5E;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAUA;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAmC9D"}

package/dist/daemon.js

@@ -0,0 +1,374 @@
+// ============================================================================
+// Daemon Lifecycle Manager
+// ============================================================================
+// Handles PID files, process locking, log rotation, and macOS launchd
+// integration for long-running daemon mode.
+// ============================================================================
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, statSync, renameSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { log } from './config.js';
+// ============================================================================
+// Paths
+// ============================================================================
+const DECIBEL_HOME = join(homedir(), '.decibel');
+const PID_PATH = join(DECIBEL_HOME, 'daemon.pid');
+const LOG_DIR = join(DECIBEL_HOME, 'logs');
+const LOG_PATH = join(LOG_DIR, 'daemon.log');
+const PLIST_NAME = 'com.decibel.daemon.plist';
+const LAUNCH_AGENTS_DIR = join(homedir(), 'Library', 'LaunchAgents');
+const PLIST_DEST = join(LAUNCH_AGENTS_DIR, PLIST_NAME);
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+// ============================================================================
+// PID Management
+// ============================================================================
+/**
+ * Check if a process with the given PID is alive.
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0); // Signal 0 = check existence, don't kill
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read PID from file. Returns null if file doesn't exist or is invalid.
+ */
+export function readPid() {
+    try {
+        const content = readFileSync(PID_PATH, 'utf-8').trim();
+        const pid = parseInt(content, 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write current process PID to file.
+ */
+export function writePid() {
+    ensureDir(DECIBEL_HOME);
+    writeFileSync(PID_PATH, String(process.pid), 'utf-8');
+    log(`Daemon: PID ${process.pid} written to ${PID_PATH}`);
+}
+/**
+ * Remove PID file.
+ */
+export function removePid() {
+    try {
+        unlinkSync(PID_PATH);
+        log(`Daemon: PID file removed`);
+    }
+    catch {
+        // File may not exist — that's fine
+    }
+}
+/**
+ * Check if another daemon is already running.
+ * Returns the PID if running, null if not.
+ */
+export function checkRunning() {
+    const pid = readPid();
+    if (pid === null)
+        return null;
+    if (isProcessAlive(pid))
+        return pid;
+    // Stale PID file — clean it up
+    log(`Daemon: Stale PID file (process ${pid} not running), cleaning up`);
+    removePid();
+    return null;
+}
+// ============================================================================
+// Logging
+// ============================================================================
+export function getLogPath() {
+    ensureDir(LOG_DIR);
+    return LOG_PATH;
+}
+// ============================================================================
+// Log Rotation
+// ============================================================================
+const DEFAULT_MAX_LOG_BYTES = 10 * 1024 * 1024; // 10MB
+const DEFAULT_MAX_LOG_FILES = 3;
+/**
+ * Rotate a log file if it exceeds maxSizeBytes.
+ * Rotation: file → file.1 → file.2 → ... → file.{maxFiles} (deleted)
+ * Returns true if rotation occurred.
+ */
+export function rotateLog(filePath, maxSizeBytes = DEFAULT_MAX_LOG_BYTES, maxFiles = DEFAULT_MAX_LOG_FILES) {
+    try {
+        if (!existsSync(filePath))
+            return false;
+        const stat = statSync(filePath);
+        if (stat.size < maxSizeBytes)
+            return false;
+        // Shift existing rotated files: .3 → delete, .2 → .3, .1 → .2
+        for (let i = maxFiles; i >= 1; i--) {
+            const src = i === 1 ? filePath : `${filePath}.${i - 1}`;
+            const dst = `${filePath}.${i}`;
+            if (i === maxFiles && existsSync(dst)) {
+                unlinkSync(dst);
+            }
+            if (existsSync(src)) {
+                renameSync(src, dst);
+            }
+        }
+        // Create empty file in place of the original (which was renamed to .1)
+        writeFileSync(filePath, '', 'utf-8');
+        log(`Daemon: Rotated log ${filePath} (was ${(stat.size / 1024 / 1024).toFixed(1)}MB)`);
+        return true;
+    }
+    catch (err) {
+        log(`Daemon: Log rotation failed for ${filePath}: ${err}`);
+        return false;
+    }
+}
+// ============================================================================
+// Crash Loop Protection
+// ============================================================================
+const META_PATH = join(DECIBEL_HOME, 'daemon.meta');
+const MAX_CRASH_COUNT = 5;
+const CRASH_WINDOW_MS = 60_000; // 60 seconds
+const HEALTH_RESET_MS = 5 * 60_000; // 5 minutes
+function readMeta() {
+    try {
+        return JSON.parse(readFileSync(META_PATH, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeMeta(meta) {
+    ensureDir(DECIBEL_HOME);
+    writeFileSync(META_PATH, JSON.stringify(meta), 'utf-8');
+}
+/**
+ * Check for crash loop. Returns true if safe to start, false if should exit.
+ * Exits process with code 0 if crash loop detected (tells launchd to stop).
+ */
+export function checkCrashLoop() {
+    const now = Date.now();
+    const meta = readMeta();
+    let crashCount = 0;
+    if (meta) {
+        const lastStart = new Date(meta.started_at).getTime();
+        if (now - lastStart < CRASH_WINDOW_MS) {
+            crashCount = meta.crash_count + 1;
+        }
+        // else: enough time has passed, reset
+    }
+    if (crashCount >= MAX_CRASH_COUNT) {
+        console.error(`Daemon: Crash loop detected (${crashCount} crashes in <60s). Exiting.`);
+        console.error('Daemon: Run with --reset-crashes to clear the counter.');
+        writeMeta({ started_at: new Date().toISOString(), crash_count: crashCount });
+        return false;
+    }
+    writeMeta({ started_at: new Date().toISOString(), crash_count: crashCount });
+    if (crashCount > 0) {
+        log(`Daemon: Crash count: ${crashCount}/${MAX_CRASH_COUNT}`);
+    }
+    return true;
+}
+/**
+ * Reset crash count after healthy running period.
+ * Call once after successful startup.
+ */
+export function scheduleHealthReset() {
+    setTimeout(() => {
+        const meta = readMeta();
+        if (meta && meta.crash_count > 0) {
+            writeMeta({ started_at: meta.started_at, crash_count: 0 });
+            log('Daemon: Crash counter reset after healthy running');
+        }
+    }, HEALTH_RESET_MS);
+}
+/**
+ * Clear crash counter (for --reset-crashes CLI flag).
+ */
+export function resetCrashes() {
+    writeMeta({ started_at: new Date().toISOString(), crash_count: 0 });
+    console.log('Daemon: Crash counter reset.');
+}
+// ============================================================================
+// Graceful Shutdown
+// ============================================================================
+const DRAIN_TIMEOUT_MS = 30_000;
+/**
+ * Install signal handlers for graceful shutdown.
+ * Returns a promise that resolves when shutdown is requested.
+ */
+export function installShutdownHandlers(cleanup) {
+    let shuttingDown = false;
+    async function shutdown(signal) {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        log(`Daemon: ${signal} received, shutting down gracefully...`);
+        // Race: cleanup vs timeout
+        const timer = setTimeout(() => {
+            log(`Daemon: Drain timeout (${DRAIN_TIMEOUT_MS}ms) exceeded, forcing exit`);
+            removePid();
+            process.exit(1);
+        }, DRAIN_TIMEOUT_MS);
+        try {
+            await cleanup();
+            log('Daemon: Clean shutdown complete');
+        }
+        catch (err) {
+            log(`Daemon: Error during shutdown: ${err}`);
+        }
+        finally {
+            clearTimeout(timer);
+            removePid();
+            process.exit(0);
+        }
+    }
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+}
+// ============================================================================
+// launchd Integration (macOS)
+// ============================================================================
+function getTemplateDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    return join(__dirname, '..', 'templates');
+}
+/**
+ * Install the launchd plist so the daemon auto-starts on login.
+ */
+export function installLaunchd(options) {
+    const templatePath = join(getTemplateDir(), PLIST_NAME);
+    if (!existsSync(templatePath)) {
+        return {
+            installed: false,
+            path: PLIST_DEST,
+            message: `Template not found: ${templatePath}`,
+        };
+    }
+    // Read template and substitute variables
+    let plist = readFileSync(templatePath, 'utf-8');
+    const serverPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'dist', 'server.js');
+    const port = options?.port || 4888;
+    plist = plist.replace('{{NODE_PATH}}', process.execPath);
+    plist = plist.replace('{{SERVER_PATH}}', serverPath);
+    plist = plist.replace('{{PORT}}', String(port));
+    plist = plist.replace('{{LOG_PATH}}', LOG_PATH);
+    plist = plist.replace('{{ERROR_LOG_PATH}}', join(LOG_DIR, 'daemon-error.log'));
+    // Write to LaunchAgents
+    ensureDir(LAUNCH_AGENTS_DIR);
+    writeFileSync(PLIST_DEST, plist, 'utf-8');
+    // Load the agent
+    try {
+        execSync(`launchctl load ${PLIST_DEST}`, { stdio: 'pipe' });
+    }
+    catch {
+        // May already be loaded — try unload then load
+        try {
+            execSync(`launchctl unload ${PLIST_DEST}`, { stdio: 'pipe' });
+            execSync(`launchctl load ${PLIST_DEST}`, { stdio: 'pipe' });
+        }
+        catch (e) {
+            return {
+                installed: true,
+                path: PLIST_DEST,
+                message: `Plist written but launchctl load failed: ${e}`,
+            };
+        }
+    }
+    return {
+        installed: true,
+        path: PLIST_DEST,
+        message: `Installed and loaded. Daemon will auto-start on login (port ${port}).`,
+    };
+}
+/**
+ * Uninstall the launchd plist and stop the daemon.
+ */
+export function uninstallLaunchd() {
+    if (!existsSync(PLIST_DEST)) {
+        return { uninstalled: false, message: 'Plist not found — daemon not installed.' };
+    }
+    try {
+        execSync(`launchctl unload ${PLIST_DEST}`, { stdio: 'pipe' });
+    }
+    catch {
+        // May not be loaded
+    }
+    try {
+        unlinkSync(PLIST_DEST);
+    }
+    catch {
+        return { uninstalled: false, message: 'Failed to remove plist file.' };
+    }
+    return { uninstalled: true, message: 'Daemon uninstalled. Will no longer auto-start.' };
+}
+/**
+ * Get daemon status.
+ */
+export function daemonStatus() {
+    const pid = checkRunning();
+    return {
+        running: pid !== null,
+        pid,
+        pidFile: PID_PATH,
+        logFile: LOG_PATH,
+        launchd: existsSync(PLIST_DEST),
+        port: null, // Would need to read from config or PID metadata
+    };
+}
+// ============================================================================
+// CLI Subcommands (called from server.ts)
+// ============================================================================
+/**
+ * Handle daemon subcommands: install, uninstall, status.
+ * Returns true if a subcommand was handled (and process should exit).
+ */
+export function handleDaemonSubcommand(args) {
+    const subcommand = args.find(a => ['install', 'uninstall', 'status'].includes(a));
+    if (!subcommand)
+        return false;
+    switch (subcommand) {
+        case 'install': {
+            const portIdx = args.indexOf('--port');
+            const port = portIdx !== -1 ? parseInt(args[portIdx + 1], 10) : undefined;
+            const result = installLaunchd({ port });
+            console.log(result.message);
+            console.log(`  Plist: ${result.path}`);
+            process.exit(result.installed ? 0 : 1);
+            return true;
+        }
+        case 'uninstall': {
+            const result = uninstallLaunchd();
+            console.log(result.message);
+            process.exit(result.uninstalled ? 0 : 1);
+            return true;
+        }
+        case 'status': {
+            const status = daemonStatus();
+            if (status.running) {
+                console.log(`Daemon is running (PID ${status.pid})`);
+            }
+            else {
+                console.log('Daemon is not running');
+            }
+            console.log(`  PID file:  ${status.pidFile}`);
+            console.log(`  Log file:  ${status.logFile}`);
+            console.log(`  launchd:   ${status.launchd ? 'installed' : 'not installed'}`);
+            process.exit(0);
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"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"}

package/dist/daemonConfig.d.ts

@@ -0,0 +1,43 @@
+export interface DaemonConfig {
+    daemon: {
+        port: number;
+        host: string;
+        auth_token?: string;
+        log_max_size_mb: number;
+        log_max_files: number;
+        rate_limit_rpm: number;
+    };
+    license?: {
+        key?: string;
+    };
+}
+/**
+ * Load config from ~/.decibel/config.yaml, merged with defaults.
+ * Returns defaults if file doesn't exist or is invalid.
+ */
+export declare function loadConfig(): DaemonConfig;
+/**
+ * Get the config file path (for display purposes).
+ */
+export declare function getConfigPath(): string;
+/**
+ * Merge CLI flags over config file values. CLI takes precedence.
+ */
+export declare function mergeCliOverrides(config: DaemonConfig, overrides: {
+    port?: number;
+    host?: string;
+    authToken?: string;
+    logMaxSizeMb?: number;
+    logMaxFiles?: number;
+    rateLimitRpm?: number;
+}): DaemonConfig;
+/**
+ * Reload config and return hot-reloadable fields that changed.
+ * Port and host changes are detected but require a restart.
+ */
+export declare function reloadConfig(current: DaemonConfig): {
+    config: DaemonConfig;
+    changes: string[];
+    requiresRestart: boolean;
+};
+//# sourceMappingURL=daemonConfig.d.ts.map

package/dist/daemonConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonConfig.d.ts","sourceRoot":"","sources":["../src/daemonConfig.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAsBD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,YAAY,CA4BzC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,YAAY,CAad;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,GACpB;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CA2BvE"}