@timmeck/brain-core 2.36.12 → 2.36.14

package/dist/watchdog/__tests__/watchdog-service.test.js

@@ -0,0 +1,113 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { WatchdogService, createDefaultWatchdogConfig } from '../watchdog-service.js';
+// Mock child_process
+vi.mock('node:child_process', () => ({
+    spawn: vi.fn().mockReturnValue({
+        pid: 12345,
+        unref: vi.fn(),
+        on: vi.fn(),
+    }),
+}));
+// Mock IpcClient
+vi.mock('../../ipc/client.js', () => ({
+    IpcClient: vi.fn().mockImplementation(() => ({
+        connect: vi.fn().mockResolvedValue(undefined),
+        request: vi.fn().mockResolvedValue({ status: 'ok' }),
+        disconnect: vi.fn(),
+    })),
+}));
+function createTestConfig() {
+    return {
+        daemons: [
+            {
+                name: 'test-brain',
+                entryPoint: '/fake/path/index.js',
+                args: ['daemon'],
+                pidPath: '/tmp/test-brain.pid',
+                pipeName: '\\\\.\\pipe\\test-brain',
+            },
+            {
+                name: 'test-trading',
+                entryPoint: '/fake/path/trading/index.js',
+                args: ['daemon'],
+                pidPath: '/tmp/test-trading.pid',
+                pipeName: '\\\\.\\pipe\\test-trading',
+            },
+        ],
+        maxRestarts: 3,
+        restartWindowMs: 60_000,
+        baseBackoffMs: 100,
+        healthCheckIntervalMs: 1000,
+    };
+}
+describe('WatchdogService', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('creates with configured daemons', () => {
+        const config = createTestConfig();
+        const watchdog = new WatchdogService(config);
+        const status = watchdog.getStatus();
+        expect(status).toHaveLength(2);
+        expect(status[0].name).toBe('test-brain');
+        expect(status[1].name).toBe('test-trading');
+        expect(status[0].running).toBe(false);
+        expect(status[0].restarts).toBe(0);
+    });
+    it('returns null for unknown daemon', () => {
+        const watchdog = new WatchdogService(createTestConfig());
+        expect(watchdog.getDaemonStatus('nonexistent')).toBeNull();
+    });
+    it('gets individual daemon status', () => {
+        const watchdog = new WatchdogService(createTestConfig());
+        const status = watchdog.getDaemonStatus('test-brain');
+        expect(status).not.toBeNull();
+        expect(status.name).toBe('test-brain');
+        expect(status.pid).toBeNull();
+        expect(status.healthy).toBe(false);
+    });
+    it('restartDaemon returns false for unknown daemon', () => {
+        const watchdog = new WatchdogService(createTestConfig());
+        expect(watchdog.restartDaemon('nonexistent')).toBe(false);
+    });
+    it('stop is safe when not started', () => {
+        const watchdog = new WatchdogService(createTestConfig());
+        expect(() => watchdog.stop()).not.toThrow();
+    });
+    it('getStatus returns uptime as null when not started', () => {
+        const watchdog = new WatchdogService(createTestConfig());
+        const status = watchdog.getStatus();
+        for (const s of status) {
+            expect(s.uptime).toBeNull();
+            expect(s.lastCrash).toBeNull();
+        }
+    });
+});
+describe('createDefaultWatchdogConfig', () => {
+    it('creates config with 3 brain daemons', () => {
+        const config = createDefaultWatchdogConfig();
+        expect(config.daemons).toHaveLength(3);
+        expect(config.daemons.map(d => d.name)).toEqual([
+            'brain',
+            'trading-brain',
+            'marketing-brain',
+        ]);
+    });
+    it('each daemon has required fields', () => {
+        const config = createDefaultWatchdogConfig();
+        for (const d of config.daemons) {
+            expect(d.name).toBeTruthy();
+            expect(d.entryPoint).toBeTruthy();
+            expect(d.args).toContain('daemon');
+            expect(d.pidPath).toBeTruthy();
+            expect(d.pipeName).toBeTruthy();
+        }
+    });
+    it('pipe names contain daemon name', () => {
+        const config = createDefaultWatchdogConfig();
+        expect(config.daemons[0].pipeName).toContain('brain');
+        expect(config.daemons[1].pipeName).toContain('trading');
+        expect(config.daemons[2].pipeName).toContain('marketing');
+    });
+});
+//# sourceMappingURL=watchdog-service.test.js.map

package/dist/watchdog/__tests__/watchdog-service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog-service.test.js","sourceRoot":"","sources":["../../../src/watchdog/__tests__/watchdog-service.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAuB,MAAM,wBAAwB,CAAC;AAE3G,qBAAqB;AACrB,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;QAC7B,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;KACZ,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,iBAAiB;AACjB,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC7C,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACpD,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;KACpB,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,SAAS,gBAAgB;IACvB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,qBAAqB;gBACjC,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,OAAO,EAAE,qBAAqB;gBAC9B,QAAQ,EAAE,yBAAyB;aACpC;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,UAAU,EAAE,6BAA6B;gBACzC,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,OAAO,EAAE,uBAAuB;gBAChC,QAAQ,EAAE,2BAA2B;aACtC;SACF;QACD,WAAW,EAAE,CAAC;QACd,eAAe,EAAE,MAAM;QACvB,aAAa,EAAE,GAAG;QAClB,qBAAqB,EAAE,IAAI;KAC5B,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QAEpC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,MAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9C,OAAO;YACP,eAAe;YACf,iBAAiB;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC5B,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;YAC/B,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/watchdog/watchdog-service.d.ts

@@ -0,0 +1,60 @@
+export interface DaemonConfig {
+    name: string;
+    entryPoint: string;
+    args: string[];
+    pidPath: string;
+    pipeName: string;
+    healthCheckIntervalMs?: number;
+}
+export interface DaemonStatus {
+    name: string;
+    pid: number | null;
+    running: boolean;
+    healthy: boolean;
+    uptime: number | null;
+    restarts: number;
+    lastCrash: string | null;
+}
+export interface WatchdogConfig {
+    daemons: DaemonConfig[];
+    maxRestarts?: number;
+    restartWindowMs?: number;
+    baseBackoffMs?: number;
+    healthCheckIntervalMs?: number;
+}
+/**
+ * WatchdogService — monitors and auto-restarts multiple Brain daemons.
+ * Provides health checks via IPC ping, exponential backoff on crashes,
+ * and unified status reporting.
+ */
+export declare class WatchdogService {
+    private daemons;
+    private healthTimer;
+    private running;
+    private logger;
+    private maxRestarts;
+    private restartWindowMs;
+    private baseBackoffMs;
+    private healthCheckIntervalMs;
+    constructor(config: WatchdogConfig);
+    /** Start all configured daemons and begin health monitoring. */
+    start(): void;
+    /** Stop all daemons and health monitoring. */
+    stop(): void;
+    /** Get status of all daemons. */
+    getStatus(): DaemonStatus[];
+    /** Get status of a single daemon. */
+    getDaemonStatus(name: string): DaemonStatus | null;
+    /** Restart a specific daemon. */
+    restartDaemon(name: string): boolean;
+    private launchDaemon;
+    /** Health check — ping each daemon via IPC. */
+    private checkHealth;
+    private readPid;
+    private isProcessAlive;
+}
+/**
+ * Create a default WatchdogConfig for the Brain Ecosystem.
+ * Discovers installed brains by checking for their entry points.
+ */
+export declare function createDefaultWatchdogConfig(): WatchdogConfig;

package/dist/watchdog/watchdog-service.js

@@ -0,0 +1,275 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+import { IpcClient } from '../ipc/client.js';
+import { getPipeName } from '../utils/paths.js';
+/**
+ * WatchdogService — monitors and auto-restarts multiple Brain daemons.
+ * Provides health checks via IPC ping, exponential backoff on crashes,
+ * and unified status reporting.
+ */
+export class WatchdogService {
+    daemons = new Map();
+    healthTimer = null;
+    running = false;
+    logger = getLogger();
+    maxRestarts;
+    restartWindowMs;
+    baseBackoffMs;
+    healthCheckIntervalMs;
+    constructor(config) {
+        this.maxRestarts = config.maxRestarts ?? 5;
+        this.restartWindowMs = config.restartWindowMs ?? 5 * 60 * 1000;
+        this.baseBackoffMs = config.baseBackoffMs ?? 1000;
+        this.healthCheckIntervalMs = config.healthCheckIntervalMs ?? 30_000;
+        for (const d of config.daemons) {
+            this.daemons.set(d.name, {
+                config: d,
+                process: null,
+                pid: null,
+                running: false,
+                healthy: false,
+                startedAt: null,
+                restarts: 0,
+                restartTimes: [],
+                lastCrash: null,
+            });
+        }
+    }
+    /** Start all configured daemons and begin health monitoring. */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.logger.info(`Watchdog starting (${this.daemons.size} daemons)`);
+        for (const [name] of this.daemons) {
+            this.launchDaemon(name);
+        }
+        this.healthTimer = setInterval(() => {
+            this.checkHealth().catch(err => this.logger.error(`Health check error: ${err}`));
+        }, this.healthCheckIntervalMs);
+    }
+    /** Stop all daemons and health monitoring. */
+    stop() {
+        this.running = false;
+        if (this.healthTimer) {
+            clearInterval(this.healthTimer);
+            this.healthTimer = null;
+        }
+        for (const [name, state] of this.daemons) {
+            if (state.pid) {
+                try {
+                    process.kill(state.pid, 'SIGTERM');
+                    this.logger.info(`Sent SIGTERM to ${name} (PID: ${state.pid})`);
+                }
+                catch {
+                    // Already dead
+                }
+            }
+            state.running = false;
+            state.process = null;
+        }
+        this.logger.info('Watchdog stopped');
+    }
+    /** Get status of all daemons. */
+    getStatus() {
+        const result = [];
+        for (const [, state] of this.daemons) {
+            result.push({
+                name: state.config.name,
+                pid: state.pid,
+                running: state.running,
+                healthy: state.healthy,
+                uptime: state.startedAt ? Date.now() - state.startedAt : null,
+                restarts: state.restarts,
+                lastCrash: state.lastCrash,
+            });
+        }
+        return result;
+    }
+    /** Get status of a single daemon. */
+    getDaemonStatus(name) {
+        const state = this.daemons.get(name);
+        if (!state)
+            return null;
+        return {
+            name: state.config.name,
+            pid: state.pid,
+            running: state.running,
+            healthy: state.healthy,
+            uptime: state.startedAt ? Date.now() - state.startedAt : null,
+            restarts: state.restarts,
+            lastCrash: state.lastCrash,
+        };
+    }
+    /** Restart a specific daemon. */
+    restartDaemon(name) {
+        const state = this.daemons.get(name);
+        if (!state)
+            return false;
+        if (state.pid) {
+            try {
+                process.kill(state.pid, 'SIGTERM');
+            }
+            catch { /* already dead */ }
+        }
+        state.running = false;
+        state.process = null;
+        this.launchDaemon(name);
+        return true;
+    }
+    launchDaemon(name) {
+        const state = this.daemons.get(name);
+        if (!state)
+            return;
+        const { config } = state;
+        // Check if already running via PID file
+        const existingPid = this.readPid(config.pidPath);
+        if (existingPid && this.isProcessAlive(existingPid)) {
+            this.logger.info(`${name} already running (PID: ${existingPid})`);
+            state.pid = existingPid;
+            state.running = true;
+            state.startedAt = Date.now();
+            return;
+        }
+        // Clean stale PID
+        try {
+            fs.unlinkSync(config.pidPath);
+        }
+        catch { /* ignore */ }
+        // Spawn
+        const isTsSource = !fs.existsSync(config.entryPoint);
+        let cmdArgs;
+        if (isTsSource) {
+            const tsEntry = config.entryPoint.replace(/\.js$/, '.ts');
+            cmdArgs = ['--import', 'tsx', tsEntry, ...config.args];
+        }
+        else {
+            cmdArgs = [config.entryPoint, ...config.args];
+        }
+        const child = spawn(process.execPath, cmdArgs, {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+        state.process = child;
+        state.pid = child.pid ?? null;
+        state.running = true;
+        state.startedAt = Date.now();
+        this.logger.info(`${name} launched (PID: ${child.pid})`);
+        child.on('exit', (code) => {
+            if (!this.running)
+                return; // watchdog stopped, don't restart
+            state.running = false;
+            state.healthy = false;
+            state.process = null;
+            if (code === 0 || code === null) {
+                this.logger.info(`${name} stopped normally`);
+                return;
+            }
+            state.lastCrash = new Date().toISOString();
+            state.restarts++;
+            this.logger.warn(`${name} crashed (code ${code})`);
+            // Rate limit restarts
+            const now = Date.now();
+            state.restartTimes.push(now);
+            const recent = state.restartTimes.filter(t => now - t < this.restartWindowMs);
+            state.restartTimes = recent;
+            if (recent.length > this.maxRestarts) {
+                this.logger.error(`${name} crashed ${this.maxRestarts} times in ${this.restartWindowMs / 1000}s — giving up`);
+                try {
+                    fs.unlinkSync(config.pidPath);
+                }
+                catch { /* ignore */ }
+                return;
+            }
+            const backoff = this.baseBackoffMs * Math.pow(2, recent.length - 1);
+            this.logger.info(`${name} restarting in ${backoff}ms (attempt ${recent.length}/${this.maxRestarts})`);
+            setTimeout(() => {
+                if (this.running)
+                    this.launchDaemon(name);
+            }, backoff);
+        });
+    }
+    /** Health check — ping each daemon via IPC. */
+    async checkHealth() {
+        for (const [name, state] of this.daemons) {
+            if (!state.running || !state.pid) {
+                state.healthy = false;
+                continue;
+            }
+            // First check if process is alive
+            if (!this.isProcessAlive(state.pid)) {
+                state.healthy = false;
+                state.running = false;
+                this.logger.warn(`${name} PID ${state.pid} no longer alive`);
+                if (this.running)
+                    this.launchDaemon(name);
+                continue;
+            }
+            // IPC health ping
+            const client = new IpcClient(state.config.pipeName, 3000);
+            try {
+                await client.connect();
+                await client.request('status');
+                state.healthy = true;
+            }
+            catch {
+                state.healthy = false;
+                this.logger.debug(`${name} IPC health check failed (process alive but IPC unreachable)`);
+            }
+            finally {
+                client.disconnect();
+            }
+        }
+    }
+    readPid(pidPath) {
+        try {
+            const content = fs.readFileSync(pidPath, 'utf-8').trim();
+            const pid = parseInt(content, 10);
+            return isNaN(pid) ? null : pid;
+        }
+        catch {
+            return null;
+        }
+    }
+    isProcessAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Create a default WatchdogConfig for the Brain Ecosystem.
+ * Discovers installed brains by checking for their entry points.
+ */
+export function createDefaultWatchdogConfig() {
+    const daemons = [];
+    // Try to discover brain packages relative to brain-core
+    const coreDir = path.resolve(import.meta.dirname, '../..');
+    const packagesDir = path.resolve(coreDir, '..');
+    const brainDefs = [
+        { name: 'brain', pkg: 'brain', dataDir: '.brain', pipeSuffix: 'brain' },
+        { name: 'trading-brain', pkg: 'trading-brain', dataDir: '.trading-brain', pipeSuffix: 'trading-brain' },
+        { name: 'marketing-brain', pkg: 'marketing-brain', dataDir: '.marketing-brain', pipeSuffix: 'marketing-brain' },
+    ];
+    for (const def of brainDefs) {
+        const entryPoint = path.join(packagesDir, def.pkg, 'dist', 'index.js');
+        const homeDir = process.env['HOME'] || process.env['USERPROFILE'] || '';
+        const pidPath = path.join(homeDir, def.dataDir, `${def.name}.pid`);
+        daemons.push({
+            name: def.name,
+            entryPoint,
+            args: ['daemon'],
+            pidPath,
+            pipeName: getPipeName(def.pipeSuffix),
+        });
+    }
+    return { daemons };
+}
+//# sourceMappingURL=watchdog-service.js.map

package/dist/watchdog/watchdog-service.js.map

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

package/dist/watchdog/windows-service.d.ts

@@ -0,0 +1,39 @@
+export interface ServiceConfig {
+    name: string;
+    displayName: string;
+    description: string;
+    entryPoint: string;
+    args: string[];
+}
+export interface ServiceStatus {
+    name: string;
+    installed: boolean;
+    state: 'running' | 'stopped' | 'pending' | 'unknown';
+}
+/**
+ * WindowsServiceManager — installs/manages Brain daemons as Windows services.
+ * Uses NSSM (Non-Sucking Service Manager) or SC.exe for service management.
+ * Optional: only works on Windows, graceful no-op on other platforms.
+ */
+export declare class WindowsServiceManager {
+    private logger;
+    private nssmPath;
+    constructor();
+    /** Check if we're on Windows and can manage services. */
+    isAvailable(): boolean;
+    /** Install a Brain daemon as a Windows service. */
+    install(config: ServiceConfig): boolean;
+    /** Uninstall a Brain service. */
+    uninstall(name: string): boolean;
+    /** Start a service. */
+    startService(name: string): boolean;
+    /** Stop a service. */
+    stopService(name: string): boolean;
+    /** Query service status. */
+    queryStatus(name: string): ServiceStatus;
+    /** Query status of all Brain services. */
+    queryAll(): ServiceStatus[];
+    private findNssm;
+    private createWrapperScript;
+    private getLogPath;
+}