byterover-cli 1.7.2 → 2.0.0

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-connector.d.ts

@@ -0,0 +1,46 @@
+import type { ClientType } from '../core/domain/types.js';
+import type { ConnectionResult } from '../core/interfaces/i-client-factory.js';
+import { connectToTransport } from './client-factory.js';
+import { type EnsureDaemonResult } from './daemon-spawner.js';
+/**
+ * Options for connecting to the daemon.
+ *
+ * This is the SINGLE entry point for "ensure daemon + connect transport + register client".
+ * All consumers should use this instead of calling ensureDaemonRunning() + connectToTransport() separately.
+ */
+export type ConnectToDaemonOptions = {
+    /** Client type for registration. */
+    clientType: ClientType;
+    /** Starting directory for daemon/instance discovery. Default: process.cwd() */
+    fromDir?: string;
+    /** Rooms to join after connection + registration (e.g., ['broadcast-room'] for TUI). */
+    joinRooms?: readonly string[];
+    /** Project path sent in client:register payload. Omit for MCP global mode. */
+    projectPath?: string;
+    /** Explicit path to brv-server.js. If omitted, auto-resolved via BRV_SERVER_MAIN or PATH. */
+    serverPath?: string;
+    /** Skip registration entirely (e.g., debug commands). Default: false */
+    skipRegistration?: boolean;
+    /** CLI version for daemon version matching (restart unhealthy daemon). */
+    version?: string;
+};
+/** Dependencies for connectToDaemon — injectable for unit testing. */
+export type ConnectToDaemonDeps = {
+    connectToTransport: typeof connectToTransport;
+    ensureDaemonRunning: (options?: {
+        serverPath?: string;
+        version?: string;
+    }) => Promise<EnsureDaemonResult>;
+};
+/**
+ * Ensures the daemon is running, then connects and registers via transport-client.
+ *
+ * Flow:
+ * 1. ensureDaemonRunning() — spawns daemon if needed (fast no-op if already running)
+ * 2. connectToTransport() — discovers instance, connects Socket.IO, registers, joins rooms
+ *
+ * @throws DaemonSpawnError if daemon fails to start within timeout
+ * @throws ConnectionError (from transport-client) if connection fails
+ */
+export declare function connectToDaemon(options: ConnectToDaemonOptions, deps?: ConnectToDaemonDeps): Promise<ConnectionResult>;
+//# sourceMappingURL=daemon-connector.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-connector.d.ts","sourceRoot":"","sources":["../../src/infra/daemon-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,wCAAwC,CAAA;AAI5E,OAAO,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAC,KAAK,kBAAkB,EAAsB,MAAM,qBAAqB,CAAA;AAEhF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,oCAAoC;IACpC,UAAU,EAAE,UAAU,CAAA;IACtB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wFAAwF;IACxF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,OAAO,kBAAkB,CAAA;IAC7C,mBAAmB,EAAE,CAAC,OAAO,CAAC,EAAE;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;CACxG,CAAA;AAOD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,GAAE,mBAAiC,GACtC,OAAO,CAAC,gBAAgB,CAAC,CA6B3B"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-connector.js

@@ -0,0 +1,47 @@
+import { DaemonSpawnError } from '../core/domain/errors/connection-error.js';
+import { connectToTransport } from './client-factory.js';
+import { DaemonInstanceDiscovery } from './daemon-instance-discovery.js';
+import { ensureDaemonRunning } from './daemon-spawner.js';
+const defaultDeps = {
+    connectToTransport,
+    ensureDaemonRunning,
+};
+/**
+ * Ensures the daemon is running, then connects and registers via transport-client.
+ *
+ * Flow:
+ * 1. ensureDaemonRunning() — spawns daemon if needed (fast no-op if already running)
+ * 2. connectToTransport() — discovers instance, connects Socket.IO, registers, joins rooms
+ *
+ * @throws DaemonSpawnError if daemon fails to start within timeout
+ * @throws ConnectionError (from transport-client) if connection fails
+ */
+export async function connectToDaemon(options, deps = defaultDeps) {
+    const { clientType, fromDir, joinRooms, projectPath, serverPath, skipRegistration = false, version } = options;
+    // 1. Ensure daemon is running (fast no-op if already running)
+    const ensureOptions = version || serverPath ? { serverPath, version } : undefined;
+    const daemonResult = await deps.ensureDaemonRunning(ensureOptions);
+    if (!daemonResult.success) {
+        throw new DaemonSpawnError(daemonResult.spawnError);
+    }
+    // 2. Connect + register + join rooms (all handled by transport-client)
+    //    Include serverUrlResolver for daemon-aware reconnection (Tier 3 fallback)
+    return deps.connectToTransport(fromDir, {
+        autoRegister: !skipRegistration,
+        clientType,
+        discovery: new DaemonInstanceDiscovery(),
+        joinRooms,
+        projectPath,
+        serverUrlResolver: async () => {
+            // Spawn daemon if needed (fast no-op if already running)
+            const result = await deps.ensureDaemonRunning(ensureOptions);
+            if (!result.success)
+                return undefined;
+            // Discover new instance (possibly on new port)
+            const disc = new DaemonInstanceDiscovery();
+            const found = await disc.discover(fromDir ?? process.cwd());
+            return found.found ? found.instance.getTransportUrl() : undefined;
+        },
+    });
+}
+//# sourceMappingURL=daemon-connector.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-connector.js","sourceRoot":"","sources":["../../src/infra/daemon-connector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,gBAAgB,EAAC,MAAM,2CAA2C,CAAA;AAE1E,OAAO,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAC,uBAAuB,EAAC,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAA0B,mBAAmB,EAAC,MAAM,qBAAqB,CAAA;AA+BhF,MAAM,WAAW,GAAwB;IACvC,kBAAkB;IAClB,mBAAmB;CACpB,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA+B,EAC/B,OAA4B,WAAW;IAEvC,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,GAAG,KAAK,EAAE,OAAO,EAAC,GAAG,OAAO,CAAA;IAE5G,8DAA8D;IAC9D,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,OAAO,EAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC/E,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAA;IAClE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,gBAAgB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;IACrD,CAAC;IAED,uEAAuE;IACvE,+EAA+E;IAC/E,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACtC,YAAY,EAAE,CAAC,gBAAgB;QAC/B,UAAU;QACV,SAAS,EAAE,IAAI,uBAAuB,EAAE;QACxC,SAAS;QACT,WAAW;QACX,iBAAiB,EAAE,KAAK,IAAI,EAAE;YAC5B,yDAAyD;YACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAA;YAC5D,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAA;YAErC,+CAA+C;YAC/C,MAAM,IAAI,GAAG,IAAI,uBAAuB,EAAE,CAAA;YAC1C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;YAC3D,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QACnE,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-discovery-sync.d.ts

@@ -0,0 +1,41 @@
+import type { IGlobalInstanceManager } from '../core/interfaces/i-instance-manager.js';
+export type DaemonStatus = {
+    actualVersion?: string;
+    expectedVersion: string;
+    pid: number;
+    reason: 'version_mismatch';
+    running: false;
+} | {
+    pid: number;
+    port: number;
+    running: true;
+} | {
+    pid: number;
+    reason: 'heartbeat_stale' | 'pid_dead';
+    running: false;
+} | {
+    reason: 'no_instance';
+    running: false;
+};
+/**
+ * Checks whether the global daemon is running and healthy.
+ *
+ * Health checks (all must pass):
+ * 1. daemon.json exists at <global-data-dir>/ and is valid
+ * 2. PID is alive
+ * 3. Heartbeat is fresh (<15s)
+ * 4. Version matches expectedVersion (if provided)
+ *
+ * @param options - Discovery options.
+ * @param options.dataDir - Custom data directory (defaults to global).
+ * @param options.expectedVersion - If provided, daemon version must match.
+ *   A mismatch returns `{running: false, reason: 'version_mismatch', pid}`.
+ * @param options.instanceManager - Injectable for testing and caller reuse.
+ *   Defaults to a new GlobalInstanceManager if not provided.
+ */
+export declare function discoverDaemon(options?: {
+    dataDir?: string;
+    expectedVersion?: string;
+    instanceManager?: IGlobalInstanceManager;
+}): DaemonStatus;
+//# sourceMappingURL=daemon-discovery-sync.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-discovery-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-discovery-sync.d.ts","sourceRoot":"","sources":["../../src/infra/daemon-discovery-sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,0CAA0C,CAAA;AAOpF,MAAM,MAAM,YAAY,GACpB;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAC,GAC1G;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAC,GAC1C;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,GAAG,UAAU,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAC,GACrE;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAC,CAAA;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,sBAAsB,CAAA;CACzC,GAAG,YAAY,CA+Bf"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-discovery-sync.js

@@ -0,0 +1,48 @@
+import { join } from 'node:path';
+import { HEARTBEAT_FILE } from '../constants.js';
+import { checkDaemonHealth } from './daemon-health.js';
+import { getGlobalDataDir } from './global-data-path.js';
+import { GlobalInstanceManager } from './global-instance-manager.js';
+/**
+ * Checks whether the global daemon is running and healthy.
+ *
+ * Health checks (all must pass):
+ * 1. daemon.json exists at <global-data-dir>/ and is valid
+ * 2. PID is alive
+ * 3. Heartbeat is fresh (<15s)
+ * 4. Version matches expectedVersion (if provided)
+ *
+ * @param options - Discovery options.
+ * @param options.dataDir - Custom data directory (defaults to global).
+ * @param options.expectedVersion - If provided, daemon version must match.
+ *   A mismatch returns `{running: false, reason: 'version_mismatch', pid}`.
+ * @param options.instanceManager - Injectable for testing and caller reuse.
+ *   Defaults to a new GlobalInstanceManager if not provided.
+ */
+export function discoverDaemon(options) {
+    const dataDir = options?.dataDir ?? getGlobalDataDir();
+    const instanceManager = options?.instanceManager ?? new GlobalInstanceManager({ dataDir });
+    const instance = instanceManager.load();
+    if (!instance) {
+        return { reason: 'no_instance', running: false };
+    }
+    const heartbeatPath = join(dataDir, HEARTBEAT_FILE);
+    const health = checkDaemonHealth(instance.pid, heartbeatPath, {
+        actualVersion: instance.version,
+        expectedVersion: options?.expectedVersion,
+    });
+    if (!health.healthy) {
+        if (health.reason === 'version_mismatch') {
+            return {
+                actualVersion: health.actualVersion,
+                expectedVersion: health.expectedVersion,
+                pid: instance.pid,
+                reason: 'version_mismatch',
+                running: false,
+            };
+        }
+        return { pid: instance.pid, reason: health.reason, running: false };
+    }
+    return { pid: instance.pid, port: instance.port, running: true };
+}
+//# sourceMappingURL=daemon-discovery-sync.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-discovery-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-discovery-sync.js","sourceRoot":"","sources":["../../src/infra/daemon-discovery-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAI9B,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAC,qBAAqB,EAAC,MAAM,8BAA8B,CAAA;AAQlE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,OAI9B;IACC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,CAAA;IAEtD,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,IAAI,qBAAqB,CAAC,EAAC,OAAO,EAAC,CAAC,CAAA;IACxF,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,CAAA;IAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAC,CAAA;IAChD,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE;QAC5D,aAAa,EAAE,QAAQ,CAAC,OAAO;QAC/B,eAAe,EAAE,OAAO,EAAE,eAAe;KAC1C,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YACzC,OAAO;gBACL,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,MAAM,EAAE,kBAAkB;gBAC1B,OAAO,EAAE,KAAK;aACf,CAAA;QACH,CAAC;QAED,OAAO,EAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAC,CAAA;IACnE,CAAC;IAED,OAAO,EAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAC,CAAA;AAChE,CAAC"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-health.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Result of a daemon health check.
+ */
+export type DaemonHealthResult = {
+    healthy: false;
+    reason: 'heartbeat_stale';
+} | {
+    healthy: false;
+    reason: 'pid_dead';
+} | {
+    actualVersion?: string;
+    expectedVersion: string;
+    healthy: false;
+    reason: 'version_mismatch';
+} | {
+    healthy: true;
+};
+/**
+ * Checks daemon health (synchronous).
+ *
+ * Single source of truth for all daemon health checks.
+ * Used by both discoverDaemon (sync) and DaemonInstanceDiscovery (async).
+ *
+ * Health checks (in order):
+ * 1. PID is alive (process.kill(pid, 0))
+ * 2. Heartbeat is fresh (< threshold)
+ * 3. Version matches expected (if provided)
+ *
+ * @param pid - Daemon process ID to check
+ * @param heartbeatPath - Path to heartbeat file
+ * @param options - Optional version check parameters
+ */
+export declare function checkDaemonHealth(pid: number, heartbeatPath: string, options?: {
+    actualVersion?: string;
+    expectedVersion?: string;
+}): DaemonHealthResult;
+//# sourceMappingURL=daemon-health.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-health.d.ts","sourceRoot":"","sources":["../../src/infra/daemon-health.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAC,GAC3C;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAC,GACpC;IACE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,kBAAkB,CAAA;CAC3B,GACD;IAAC,OAAO,EAAE,IAAI,CAAA;CAAC,CAAA;AAEnB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAC,GAC3D,kBAAkB,CAmBpB"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-health.js

@@ -0,0 +1,35 @@
+import { isHeartbeatStale } from './heartbeat-utils.js';
+import { isProcessAlive } from './process-utils.js';
+/**
+ * Checks daemon health (synchronous).
+ *
+ * Single source of truth for all daemon health checks.
+ * Used by both discoverDaemon (sync) and DaemonInstanceDiscovery (async).
+ *
+ * Health checks (in order):
+ * 1. PID is alive (process.kill(pid, 0))
+ * 2. Heartbeat is fresh (< threshold)
+ * 3. Version matches expected (if provided)
+ *
+ * @param pid - Daemon process ID to check
+ * @param heartbeatPath - Path to heartbeat file
+ * @param options - Optional version check parameters
+ */
+export function checkDaemonHealth(pid, heartbeatPath, options) {
+    if (!isProcessAlive(pid)) {
+        return { healthy: false, reason: 'pid_dead' };
+    }
+    if (isHeartbeatStale(heartbeatPath)) {
+        return { healthy: false, reason: 'heartbeat_stale' };
+    }
+    if (options?.expectedVersion && options.actualVersion !== options.expectedVersion) {
+        return {
+            actualVersion: options.actualVersion,
+            expectedVersion: options.expectedVersion,
+            healthy: false,
+            reason: 'version_mismatch',
+        };
+    }
+    return { healthy: true };
+}
+//# sourceMappingURL=daemon-health.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-health.js","sourceRoot":"","sources":["../../src/infra/daemon-health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAA;AAgBjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,aAAqB,EACrB,OAA4D;IAE5D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAC,CAAA;IAC7C,CAAC;IAED,IAAI,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAC,CAAA;IACpD,CAAC;IAED,IAAI,OAAO,EAAE,eAAe,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC;QAClF,OAAO;YACL,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,kBAAkB;SAC3B,CAAA;IACH,CAAC;IAED,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,CAAA;AACxB,CAAC"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-instance-discovery.d.ts

@@ -0,0 +1,22 @@
+import type { DiscoveryResult, IInstanceDiscovery } from '../core/interfaces/i-instance-discovery.js';
+import type { IClientLogger } from '../core/interfaces/i-client-logger.js';
+/**
+ * Default implementation of IInstanceDiscovery.
+ *
+ * Reads from the platform-specific global data directory (see getGlobalDataDir()).
+ * Single daemon per machine — no project-local discovery.
+ *
+ * Health checks (all must pass for found=true):
+ * 1. daemon.json exists and is valid JSON with pid, port, startedAt
+ * 2. Process with recorded PID is alive
+ * 3. Heartbeat file exists and timestamp is within threshold (default 15s)
+ */
+export declare class DaemonInstanceDiscovery implements IInstanceDiscovery {
+    #private;
+    constructor(options?: {
+        dataDir?: string;
+        logger?: IClientLogger;
+    });
+    discover(fromDir: string): Promise<DiscoveryResult>;
+}
+//# sourceMappingURL=daemon-instance-discovery.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-instance-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-instance-discovery.d.ts","sourceRoot":"","sources":["../../src/infra/daemon-instance-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,eAAe,EAAE,kBAAkB,EAAC,MAAM,4CAA4C,CAAA;AACnG,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uCAAuC,CAAA;AAUxE;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;;gBAIpD,OAAO,CAAC,EAAE;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAA;KAAC;IAK1D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAyD1D"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-instance-discovery.js

@@ -0,0 +1,83 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DAEMON_INSTANCE_FILE, HEARTBEAT_FILE } from '../constants.js';
+import { InstanceInfo } from '../core/domain/entities/instance-info.js';
+import { checkDaemonHealth } from './daemon-health.js';
+import { findProjectRoot } from './find-project-root.js';
+import { getGlobalDataDir } from './global-data-path.js';
+import { NoOpClientLogger } from './no-op-client-logger.js';
+import { DaemonInstanceSchema } from './schemas/schemas.js';
+/**
+ * Default implementation of IInstanceDiscovery.
+ *
+ * Reads from the platform-specific global data directory (see getGlobalDataDir()).
+ * Single daemon per machine — no project-local discovery.
+ *
+ * Health checks (all must pass for found=true):
+ * 1. daemon.json exists and is valid JSON with pid, port, startedAt
+ * 2. Process with recorded PID is alive
+ * 3. Heartbeat file exists and timestamp is within threshold (default 15s)
+ */
+export class DaemonInstanceDiscovery {
+    #dataDir;
+    #logger;
+    constructor(options) {
+        this.#dataDir = options?.dataDir ?? getGlobalDataDir();
+        this.#logger = options?.logger ?? new NoOpClientLogger();
+    }
+    async discover(fromDir) {
+        const instance = await this.#readInstanceFile();
+        if (!instance) {
+            return { found: false, reason: 'no_instance' };
+        }
+        const heartbeatPath = join(this.#dataDir, HEARTBEAT_FILE);
+        const health = checkDaemonHealth(instance.pid, heartbeatPath);
+        if (!health.healthy) {
+            const reason = health.reason === 'pid_dead' ? 'instance_crashed' : 'instance_stale';
+            return { found: false, reason };
+        }
+        const projectRoot = await findProjectRoot(fromDir);
+        return {
+            found: true,
+            instance,
+            ...(projectRoot !== undefined && { projectRoot }),
+        };
+    }
+    async #readInstanceFile() {
+        const filePath = join(this.#dataDir, DAEMON_INSTANCE_FILE);
+        try {
+            const content = await readFile(filePath, 'utf8');
+            const json = JSON.parse(content);
+            // Use Zod schema for validation instead of manual type guard
+            const parsed = DaemonInstanceSchema.safeParse(json);
+            if (!parsed.success) {
+                this.#logger.debug(`Invalid daemon.json schema: ${parsed.error.message}`);
+                return undefined;
+            }
+            return InstanceInfo.fromJson(parsed.data);
+        }
+        catch (error) {
+            // Log specific error types for debugging
+            if (error && typeof error === 'object' && 'code' in error) {
+                const code = error.code;
+                if (code === 'ENOENT') {
+                    this.#logger.debug('Daemon instance file not found');
+                }
+                else if (code === 'EACCES') {
+                    this.#logger.warn(`Permission denied reading daemon instance: ${filePath}`);
+                }
+                else {
+                    this.#logger.error(`Failed to read daemon instance: ${error}`);
+                }
+            }
+            else if (error instanceof SyntaxError) {
+                this.#logger.error(`Invalid JSON in daemon.json: ${error.message}`);
+            }
+            else {
+                this.#logger.error(`Failed to read daemon instance: ${error}`);
+            }
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=daemon-instance-discovery.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-instance-discovery.js.map

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

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-reconnector.d.ts

@@ -0,0 +1,60 @@
+import type { ConnectionState, ITransportClient } from '../core/interfaces/i-client.js';
+import { type ConnectToDaemonOptions, connectToDaemon } from './daemon-connector.js';
+/**
+ * Options for {@link createDaemonReconnector}.
+ */
+export type DaemonReconnectorOptions = {
+    /** Backoff multiplier. Default: 1.5. */
+    backoffMultiplier?: number;
+    /** Options passed to connectToDaemon() on each reconnection attempt. */
+    connectOptions: ConnectToDaemonOptions;
+    /** Initial backoff delay (ms). Default: 1000. */
+    initialDelayMs?: number;
+    /** Maximum backoff delay (ms). Default: 30000. */
+    maxDelayMs?: number;
+    /**
+     * Called after each successful reconnection with the new client.
+     * The reconnector has already:
+     * - Disconnected the old client
+     * - Wired its own state handler on the new client
+     *
+     * Consumer should update their client reference, re-register event handlers, etc.
+     */
+    onReconnected: (newClient: ITransportClient) => void | Promise<void>;
+    /**
+     * Called on every state change of the active client (optional).
+     * Use for logging, UI updates, etc.
+     * Reconnection is already handled internally — no need to trigger it here.
+     */
+    onStateChange?: (state: ConnectionState, client: ITransportClient) => void;
+};
+/** Handle returned by {@link createDaemonReconnector} to cancel auto-reconnection. */
+export type DaemonReconnectorHandle = {
+    /** Cancel auto-reconnection. Cleans up timers and state handlers. */
+    cancel: () => void;
+};
+/** Dependencies for createDaemonReconnector — injectable for unit testing. */
+export type DaemonReconnectorDeps = {
+    connectToDaemon: typeof connectToDaemon;
+};
+/**
+ * Watches a client for disconnection and auto-reconnects via connectToDaemon().
+ *
+ * Flow on disconnect:
+ * 1. Wait with exponential backoff
+ * 2. Call connectToDaemon(connectOptions) to spawn daemon + connect
+ * 3. Disconnect old client (stops its internal Tier 1/2/3 reconnection)
+ * 4. Wire state handler on new client
+ * 5. Call onReconnected(newClient) for consumer-specific setup
+ * 6. Watch new client for future disconnects (repeats from step 1)
+ *
+ * Also handles Socket.IO built-in reconnection: when state transitions
+ * to 'connected' without a full reconnect, backoff delay is reset.
+ *
+ * @param client - The initial (already connected) client to watch
+ * @param options - Reconnection options and callbacks
+ * @param deps - Injectable dependencies (for testing)
+ * @returns Handle to cancel auto-reconnection
+ */
+export declare function createDaemonReconnector(client: ITransportClient, options: DaemonReconnectorOptions, deps?: DaemonReconnectorDeps): DaemonReconnectorHandle;
+//# sourceMappingURL=daemon-reconnector.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-reconnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-reconnector.d.ts","sourceRoot":"","sources":["../../src/infra/daemon-reconnector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAE,gBAAgB,EAAC,MAAM,gCAAgC,CAAA;AAErF,OAAO,EAAC,KAAK,sBAAsB,EAAE,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAMlF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,wEAAwE;IACxE,cAAc,EAAE,sBAAsB,CAAA;IACtC,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;OAOG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAC3E,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,uBAAuB,GAAG;IACpC,qEAAqE;IACrE,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,OAAO,eAAe,CAAA;CACxC,CAAA;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,wBAAwB,EACjC,IAAI,GAAE,qBAAmC,GACxC,uBAAuB,CA2FzB"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-reconnector.js

@@ -0,0 +1,101 @@
+import { connectToDaemon } from './daemon-connector.js';
+const DEFAULT_INITIAL_DELAY_MS = 1000;
+const DEFAULT_MAX_DELAY_MS = 30_000;
+const DEFAULT_BACKOFF_MULTIPLIER = 1.5;
+const defaultDeps = {
+    connectToDaemon,
+};
+/**
+ * Watches a client for disconnection and auto-reconnects via connectToDaemon().
+ *
+ * Flow on disconnect:
+ * 1. Wait with exponential backoff
+ * 2. Call connectToDaemon(connectOptions) to spawn daemon + connect
+ * 3. Disconnect old client (stops its internal Tier 1/2/3 reconnection)
+ * 4. Wire state handler on new client
+ * 5. Call onReconnected(newClient) for consumer-specific setup
+ * 6. Watch new client for future disconnects (repeats from step 1)
+ *
+ * Also handles Socket.IO built-in reconnection: when state transitions
+ * to 'connected' without a full reconnect, backoff delay is reset.
+ *
+ * @param client - The initial (already connected) client to watch
+ * @param options - Reconnection options and callbacks
+ * @param deps - Injectable dependencies (for testing)
+ * @returns Handle to cancel auto-reconnection
+ */
+export function createDaemonReconnector(client, options, deps = defaultDeps) {
+    const { backoffMultiplier = DEFAULT_BACKOFF_MULTIPLIER, connectOptions, initialDelayMs = DEFAULT_INITIAL_DELAY_MS, maxDelayMs = DEFAULT_MAX_DELAY_MS, onReconnected, onStateChange, } = options;
+    let cancelled = false;
+    let currentClient = client;
+    let stateUnsubscribe;
+    let reconnectTimer;
+    let isReconnecting = false;
+    let currentDelay = initialDelayMs;
+    function wireStateHandler(targetClient) {
+        stateUnsubscribe?.();
+        stateUnsubscribe = targetClient.onStateChange((state) => {
+            if (cancelled)
+                return;
+            // Notify consumer of state change (for logging, UI updates, etc.)
+            onStateChange?.(state, targetClient);
+            if (state === 'connected') {
+                // Socket.IO built-in reconnect succeeded — reset backoff
+                currentDelay = initialDelayMs;
+                isReconnecting = false;
+            }
+            if (state === 'disconnected') {
+                attemptReconnect();
+            }
+        });
+    }
+    function attemptReconnect() {
+        if (cancelled || isReconnecting)
+            return;
+        isReconnecting = true;
+        reconnectTimer = setTimeout(async () => {
+            if (cancelled)
+                return;
+            try {
+                const result = await deps.connectToDaemon(connectOptions);
+                if (cancelled) {
+                    await result.client.disconnect();
+                    return;
+                }
+                // Disconnect old client (stops its internal Tier 1/2/3 reconnection)
+                const oldClient = currentClient;
+                try {
+                    await oldClient.disconnect();
+                }
+                catch {
+                    // Ignore disconnect errors on old client
+                }
+                currentClient = result.client;
+                currentDelay = initialDelayMs;
+                isReconnecting = false;
+                // Wire state handler on new client first (before consumer callback)
+                wireStateHandler(result.client);
+                // Notify consumer (update reference, re-register handlers, etc.)
+                await onReconnected(result.client);
+            }
+            catch {
+                // Exponential backoff (capped)
+                currentDelay = Math.min(currentDelay * backoffMultiplier, maxDelayMs);
+                isReconnecting = false;
+                // Retry
+                attemptReconnect();
+            }
+        }, currentDelay);
+    }
+    // Wire initial client
+    wireStateHandler(client);
+    return {
+        cancel: () => {
+            cancelled = true;
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            stateUnsubscribe?.();
+        },
+    };
+}
+//# sourceMappingURL=daemon-reconnector.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-reconnector.js.map

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

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-spawner.d.ts

@@ -0,0 +1,33 @@
+import type { DaemonInstanceInfo } from '../core/interfaces/i-instance-manager.js';
+export type EnsureDaemonResult = {
+    info: Pick<DaemonInstanceInfo, 'pid' | 'port'>;
+    started: boolean;
+    success: true;
+} | {
+    reason: 'timeout';
+    spawnError?: string;
+    success: false;
+};
+/**
+ * Ensures a daemon is running, spawning one if needed.
+ *
+ * Flow:
+ * 1. Check if daemon is already running (fast path, no lock needed)
+ * 2. Acquire spawn lock (all mutations happen under lock)
+ * 3. If lock held → wait for daemon to appear
+ * 4. Re-check after lock (race window between step 1 and lock)
+ * 5. Handle unhealthy daemon (version mismatch or stale heartbeat) → gracefully stop
+ * 6. Clean up stale files
+ * 7. Spawn daemon as detached process
+ * 8. Poll until daemon is ready
+ * 9. Release lock in finally block
+ */
+export declare function ensureDaemonRunning(options?: {
+    dataDir?: string;
+    /** Polling interval for readiness/stop checks. Default: 100ms. Lower in tests for speed. */
+    pollIntervalMs?: number;
+    serverPath?: string;
+    timeoutMs?: number;
+    version?: string;
+}): Promise<EnsureDaemonResult>;
+//# sourceMappingURL=daemon-spawner.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/daemon-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-spawner.d.ts","sourceRoot":"","sources":["../../src/infra/daemon-spawner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAyB,MAAM,0CAA0C,CAAA;AAiBxG,MAAM,MAAM,kBAAkB,GAC1B;IAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAC,GACjF;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAC,CAAA;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4D9B"}