@mininglamp-oss/cc-channel-octo 1.0.1 → 1.0.2-dev.0af5b14

package/dist/cli.js

@@ -0,0 +1,467 @@
+#!/usr/bin/env node
+/**
+ * cc-channel-octo CLI — a process supervisor for the gateway.
+ *
+ * The gateway itself (`index.ts`) only runs in the foreground. This thin
+ * supervisor backgrounds it, tracks a single process-wide PID file, and stops
+ * it gracefully (SIGTERM, then SIGKILL on timeout). It does NOT replace the
+ * per-bot `gateway.lock` (which prevents two processes serving the same bot) —
+ * the PID file lives at the baseDir root, a sibling of every bot subtree.
+ *
+ *   cc-channel-octo start [--foreground]
+ *   cc-channel-octo stop  [--timeout=<seconds>]
+ *   cc-channel-octo restart
+ *   cc-channel-octo status
+ *
+ * POSIX only (macOS/Linux): stop relies on SIGTERM/SIGKILL. On Windows, run the
+ * gateway under a service manager instead — Node has no SIGTERM semantics there.
+ */
+import { spawn, execFileSync } from 'node:child_process';
+import { openSync, readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync, realpathSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { DEFAULT_CONFIG_PATH } from './config.js';
+import { configure } from './configure.js';
+/**
+ * Resolve the supervisor's fixed paths. baseDir defaults to the directory of
+ * the global config (`~/.cc-channel-octo`); tests inject a temp dir. indexEntry
+ * is the compiled gateway entrypoint, a sibling of this file.
+ */
+export function resolveSupervisorPaths(baseDir) {
+    const base = baseDir ?? dirname(DEFAULT_CONFIG_PATH);
+    return {
+        baseDir: base,
+        pidFile: join(base, 'cc-channel-octo.pid'),
+        logFile: join(base, 'logs', 'gateway.log'),
+        indexEntry: fileURLToPath(new URL('./index.js', import.meta.url)),
+    };
+}
+/**
+ * Extract a package version from raw package.json text. Returns 'unknown'
+ * rather than throwing if the text is malformed or has no non-empty string
+ * `version`. Pure (no I/O) so the fallback paths are unit-testable.
+ */
+export function parseVersion(raw) {
+    try {
+        const pkg = JSON.parse(raw);
+        if (pkg && typeof pkg === 'object' && 'version' in pkg) {
+            const v = pkg.version;
+            if (typeof v === 'string' && v.length > 0)
+                return v;
+        }
+    }
+    catch {
+        /* fall through to 'unknown' */
+    }
+    return 'unknown';
+}
+/**
+ * The package version, read at runtime from package.json — which lives at the
+ * package root, one level up from this module in both src/ (src/cli.ts) and the
+ * compiled output (dist/cli.js). Returns 'unknown' if the file can't be read.
+ */
+export function readVersion() {
+    try {
+        return parseVersion(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function parseArgs(argv) {
+    const [cmd = '', ...rest] = argv;
+    let foreground = false;
+    let timeoutSec = 10;
+    let version;
+    let gatewayUrl;
+    let apiKey;
+    let model;
+    let apiUrl;
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (a === '--foreground' || a === '-f') {
+            foreground = true;
+        }
+        else if (a.startsWith('--timeout=')) {
+            const n = Number.parseInt(a.slice('--timeout='.length), 10);
+            if (Number.isFinite(n) && n > 0)
+                timeoutSec = n;
+        }
+        else if (a === '--gateway-url') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --gateway-url requires a value');
+            }
+            gatewayUrl = next;
+        }
+        else if (a.startsWith('--gateway-url=')) {
+            gatewayUrl = a.slice('--gateway-url='.length);
+        }
+        else if (a === '--api-key') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --api-key requires a value');
+            }
+            apiKey = next;
+        }
+        else if (a.startsWith('--api-key=')) {
+            apiKey = a.slice('--api-key='.length);
+        }
+        else if (a === '--model') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --model requires a value');
+            }
+            model = next;
+        }
+        else if (a.startsWith('--model=')) {
+            model = a.slice('--model='.length);
+        }
+        else if (a === '--api-url') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --api-url requires a value');
+            }
+            apiUrl = next;
+        }
+        else if (a.startsWith('--api-url=')) {
+            apiUrl = a.slice('--api-url='.length);
+        }
+        else if (!a.startsWith('-') && version === undefined) {
+            version = a;
+        }
+    }
+    return { cmd, foreground, timeoutMs: timeoutSec * 1000, version, gatewayUrl, apiKey, model, apiUrl };
+}
+/**
+ * Liveness probe via signal 0. EPERM means the process exists but is owned by
+ * another user — still "alive" for our purposes; ESRCH means it's gone.
+ */
+export function isAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+export function procStartTime(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return null;
+    try {
+        const out = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the PID record. Accepts the current JSON form (`{"pid":N,"id":"…"}`) and
+ * the legacy bare-integer form (written by pre-ownership-token releases), which
+ * yields a null identity so callers fall back to liveness-only handling.
+ */
+export function readPidRecord(pidFile) {
+    if (!existsSync(pidFile))
+        return null;
+    const raw = readFileSync(pidFile, 'utf-8').trim();
+    if (!raw)
+        return null;
+    if (/^\d+$/.test(raw)) {
+        const pid = Number.parseInt(raw, 10);
+        return Number.isInteger(pid) && pid > 0 ? { pid, id: null } : null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && 'pid' in parsed) {
+            const pidVal = parsed.pid;
+            const idVal = parsed.id;
+            if (typeof pidVal === 'number' && Number.isInteger(pidVal) && pidVal > 0) {
+                return { pid: pidVal, id: typeof idVal === 'string' ? idVal : null };
+            }
+        }
+    }
+    catch {
+        /* fall through to null */
+    }
+    return null;
+}
+/** The numeric PID from the file (no ownership check), or null. */
+export function readPid(pidFile) {
+    return readPidRecord(pidFile)?.pid ?? null;
+}
+export function writePid(pidFile, pid, id) {
+    writeFileSync(pidFile, `${JSON.stringify({ pid, id })}\n`, { mode: 0o600 });
+}
+export function removePid(pidFile) {
+    try {
+        unlinkSync(pidFile);
+    }
+    catch {
+        /* already gone — fine */
+    }
+}
+/**
+ * PID of the running gateway we own, or null. A process counts as ours only if
+ * it is alive AND its current OS identity matches the one recorded at start —
+ * the guard that stops `stop`/`restart`/`upgrade` from signaling a process that
+ * merely inherited the PID after an unclean crash + reuse. Identity mismatch
+ * means the file is stale (PID recycled), so it is removed. Legacy files (no
+ * recorded identity) and unreadable live identities fall back to liveness only,
+ * matching the pre-ownership-token behavior rather than refusing to stop.
+ */
+export function resolveOwnedPid(paths, procId) {
+    const rec = readPidRecord(paths.pidFile);
+    if (rec === null)
+        return null;
+    if (!isAlive(rec.pid)) {
+        removePid(paths.pidFile);
+        return null;
+    }
+    if (rec.id === null)
+        return rec.pid; // legacy file — nothing to verify against
+    const liveId = procId(rec.pid);
+    if (liveId === null)
+        return rec.pid; // identity unreadable — don't refuse to act
+    if (liveId === rec.id)
+        return rec.pid; // verified ours
+    removePid(paths.pidFile); // PID was recycled by an unrelated process
+    return null;
+}
+async function cmdStart(paths, foreground, procId) {
+    if (foreground) {
+        const child = spawn(process.execPath, [paths.indexEntry], {
+            stdio: 'inherit',
+            env: process.env,
+        });
+        return new Promise((resolve) => {
+            child.on('exit', (code) => resolve(code ?? 0));
+        });
+    }
+    const running = resolveOwnedPid(paths, procId);
+    if (running !== null) {
+        console.log(`cc-channel-octo: already running (pid ${running})`);
+        return 0;
+    }
+    mkdirSync(dirname(paths.logFile), { recursive: true });
+    const fd = openSync(paths.logFile, 'a');
+    const child = spawn(process.execPath, [paths.indexEntry], {
+        detached: true,
+        stdio: ['ignore', fd, fd],
+        env: process.env,
+    });
+    child.unref();
+    if (child.pid === undefined) {
+        console.error('cc-channel-octo: failed to spawn gateway');
+        return 1;
+    }
+    // Record the child's start-time identity alongside its PID so a later
+    // stop/restart can confirm it's still our process and not a PID-reuse victim.
+    writePid(paths.pidFile, child.pid, procId(child.pid));
+    // Confirm it didn't exit immediately (bad config, taken lock, …).
+    await sleep(400);
+    if (!isAlive(child.pid)) {
+        removePid(paths.pidFile);
+        console.error(`cc-channel-octo: gateway exited on startup; see ${paths.logFile}`);
+        return 1;
+    }
+    console.log(`cc-channel-octo: started (pid ${child.pid}), logs at ${paths.logFile}`);
+    return 0;
+}
+async function cmdStop(paths, timeoutMs, procId) {
+    const pid = resolveOwnedPid(paths, procId);
+    if (pid === null) {
+        // resolveOwnedPid already removed a stale/recycled file.
+        console.log('cc-channel-octo: not running');
+        return 0;
+    }
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+        removePid(paths.pidFile);
+        console.log('cc-channel-octo: not running');
+        return 0;
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!isAlive(pid)) {
+            removePid(paths.pidFile);
+            console.log(`cc-channel-octo: stopped (pid ${pid})`);
+            return 0;
+        }
+        await sleep(200);
+    }
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        /* exited between the last check and now — fine */
+    }
+    removePid(paths.pidFile);
+    console.log(`cc-channel-octo: force-killed (pid ${pid}) after ${timeoutMs / 1000}s`);
+    return 0;
+}
+function cmdStatus(paths, procId) {
+    const pid = resolveOwnedPid(paths, procId);
+    if (pid !== null) {
+        console.log(`cc-channel-octo: running (pid ${pid}), logs at ${paths.logFile}`);
+    }
+    else {
+        console.log('cc-channel-octo: stopped');
+    }
+    return 0;
+}
+/** npm package name installed globally for the gateway. */
+const NPM_PKG = '@mininglamp-oss/cc-channel-octo';
+/**
+ * Semantic-version whitelist. The version reaches us from the daemon → fleet
+ * upgrade order (an untrusted boundary) and is interpolated into an npm spec,
+ * so reject anything outside `[0-9A-Za-z.-+]` to prevent argument/shell
+ * injection even though we spawn npm without a shell.
+ */
+const VERSION_RE = /^[0-9A-Za-z.\-+]+$/;
+/**
+ * Build the `npm install -g <pkg>@<version>` argument vector. A blank/omitted
+ * version installs `@latest`. Pure (no I/O) so the injection guard is unit
+ * testable. Throws on an unsafe version string.
+ */
+export function buildUpgradeArgs(version) {
+    const v = version && version.trim() ? version.trim() : 'latest';
+    if (v !== 'latest' && !VERSION_RE.test(v)) {
+        throw new Error(`unsafe version: ${v}`);
+    }
+    return ['install', '-g', `${NPM_PKG}@${v}`];
+}
+/**
+ * Self-update: `npm install -g @mininglamp-oss/cc-channel-octo@<version>` then
+ * restart the gateway so the new code is live. Invoked by the daemon to drive
+ * a fleet upgrade order (mirrors openclaw's daemon-driven plugin install).
+ */
+async function cmdUpgrade(paths, timeoutMs, procId, version) {
+    let args;
+    try {
+        args = buildUpgradeArgs(version);
+    }
+    catch (err) {
+        console.error(`cc-channel-octo: ${err.message}`);
+        return 2;
+    }
+    console.log(`cc-channel-octo: upgrading via npm ${args.join(' ')}`);
+    const code = await new Promise((resolve) => {
+        const child = spawn('npm', args, { stdio: 'inherit', env: process.env });
+        child.on('error', (err) => {
+            console.error(`cc-channel-octo: failed to spawn npm: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (c) => resolve(c ?? 1));
+    });
+    if (code !== 0) {
+        console.error(`cc-channel-octo: npm install failed (exit ${code})`);
+        return code;
+    }
+    // Restart so the freshly installed code is running.
+    await cmdStop(paths, timeoutMs, procId);
+    return cmdStart(paths, false, procId);
+}
+function usage() {
+    return `cc-channel-octo ${readVersion()} — gateway process supervisor
+
+Usage:
+  cc-channel-octo start [--foreground]   start the gateway in the background
+  cc-channel-octo stop [--timeout=<s>]   gracefully stop (SIGTERM, then SIGKILL)
+  cc-channel-octo restart                stop (if running) then start
+  cc-channel-octo status                 show running state
+  cc-channel-octo upgrade [<version>]    npm install -g the gateway (default latest) then restart
+  cc-channel-octo configure --gateway-url <url> [--api-key <key>] [--model <model>] [--api-url <octo-server-url>]   write LLM gateway + key (+ optional model / Octo server url) to config (key also via CC_OCTO_CONFIGURE_API_KEY)
+  cc-channel-octo version                print the version
+
+Paths (under ~/.cc-channel-octo):
+  pid : cc-channel-octo.pid
+  log : logs/gateway.log
+
+POSIX only (macOS/Linux). On Windows, run under a service manager.`;
+}
+export async function run(argv, baseDir, procId = procStartTime) {
+    let parsed;
+    try {
+        parsed = parseArgs(argv);
+    }
+    catch (err) {
+        // Usage error (e.g. a flag missing its value): report it as a usage
+        // failure (exit 2), not an unhandled internal error from the top-level catch.
+        console.error(`cc-channel-octo: ${err.message}`);
+        return 2;
+    }
+    const { cmd, foreground, timeoutMs, version, gatewayUrl, apiKey, model, apiUrl } = parsed;
+    const paths = resolveSupervisorPaths(baseDir);
+    switch (cmd) {
+        case 'start':
+            return cmdStart(paths, foreground, procId);
+        case 'stop':
+            return cmdStop(paths, timeoutMs, procId);
+        case 'restart':
+            await cmdStop(paths, timeoutMs, procId);
+            return cmdStart(paths, false, procId);
+        case 'status':
+            return cmdStatus(paths, procId);
+        case 'upgrade':
+            return cmdUpgrade(paths, timeoutMs, procId, version);
+        case 'configure': {
+            const resolvedApiKey = apiKey ?? process.env.CC_OCTO_CONFIGURE_API_KEY ?? '';
+            const configPath = baseDir ? join(baseDir, 'config.json') : undefined;
+            try {
+                configure(gatewayUrl ?? '', resolvedApiKey, configPath, { model, apiUrl });
+                console.log('cc-channel-octo: configured gateway + api key');
+                return 0;
+            }
+            catch (err) {
+                console.error(`cc-channel-octo: ${err.message}`);
+                return 2;
+            }
+        }
+        case 'version':
+        case '--version':
+        case '-v':
+            console.log(readVersion());
+            return 0;
+        case 'help':
+        case '--help':
+        case '-h':
+            console.log(usage());
+            return 0;
+        case '':
+            // Backward compat: bare `cc-channel-octo` (e.g. `npx cc-channel-octo`)
+            // runs the gateway in the foreground, matching the pre-supervisor bin
+            // (`dist/index.js`) behavior documented in README/CHANGELOG. Daemon-style
+            // process management is opt-in via the `start`/`stop`/`restart`/`status`
+            // subcommands.
+            return cmdStart(paths, true, procId);
+        default:
+            console.error(`cc-channel-octo: unknown command '${cmd}'\n`);
+            console.error(usage());
+            return 2;
+    }
+}
+// Run only when invoked as a script (production / linked bin), not when
+// imported (tests). When called via the `bin` symlink, Node resolves
+// import.meta.url to the real file but leaves process.argv[1] as the symlink
+// path — so resolve argv[1] to its realpath before comparing, or the linked
+// command would silently no-op.
+const entrypoint = process.argv[1];
+if (entrypoint && import.meta.url === pathToFileURL(realpathSync(entrypoint)).href) {
+    run(process.argv.slice(2))
+        .then((code) => process.exit(code))
+        .catch((err) => {
+        console.error('cc-channel-octo:', String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config-watcher.d.ts

@@ -0,0 +1,48 @@
+/** Minimal manager surface the watcher needs (eases testing). */
+export interface Reconcilable {
+    runningKeys(): string[];
+    addBot(configId: string): Promise<void>;
+    removeBot(configId: string): Promise<void>;
+}
+/**
+ * Reconcile the running set toward `desiredConfigIds` once. Removes first, then
+ * adds, so a config that swaps a bot for another with an overlapping resource
+ * (lock/dir) frees it before the replacement claims it. Add/remove failures are
+ * logged and swallowed so one bad bot doesn't abort the whole reconcile; the
+ * BotManager queue keeps the set consistent. Pure-ish (no fs) for unit testing.
+ *
+ * `isStale` is checked before each add/remove: a newer config event makes the
+ * in-flight reconcile abandon its remaining (now outdated) actions, so a bot
+ * removed by a later edit is never started by an earlier, slower reconcile
+ * (plan C6 generation guard).
+ */
+export declare function reconcile(manager: Reconcilable, desiredConfigIds: readonly string[], log?: (msg: string) => void, isStale?: () => boolean): Promise<void>;
+export interface WatcherHandle {
+    /** Force an immediate reconcile (bypasses debounce). For tests / initial sync. */
+    applyNow(): Promise<void>;
+    close(): void;
+}
+export interface WatchOptions {
+    /** Absolute path to the global config.json. */
+    configPath: string;
+    manager: Reconcilable;
+    /**
+     * Produce the desired configId list from disk. MUST throw on any invalid
+     * config so the watcher can keep the current set (plan D). Typically wraps
+     * loadConfig + resolveBotConfigs and maps to `bots[].id`.
+     */
+    loadDesired: () => readonly string[];
+    /** Debounce window in ms (coalesce a burst of writes). Default 200. */
+    debounceMs?: number;
+    log?: (msg: string) => void;
+}
+/**
+ * Start watching `configPath`'s directory and reconcile on change.
+ *
+ * Serialization & staleness: a single `chain` promise serializes apply runs,
+ * and each run re-reads the latest config at execution time, so a burst of
+ * events collapses to "apply the newest state" rather than replaying each
+ * intermediate edit. The BotManager's own queue further serializes the
+ * resulting add/remove calls.
+ */
+export declare function watchConfig(opts: WatchOptions): WatcherHandle;

package/dist/config-watcher.js

@@ -0,0 +1,143 @@
+/**
+ * Config watcher — drives BotManager from config.json changes (#157).
+ *
+ * Watches the global config's directory (not the file directly: an atomic
+ * temp+rename swaps the inode, and a file-targeted fs.watch would stop firing
+ * after the first rename). On any change it schedules a debounced, serialized
+ * `applyLatestConfig`, which RE-READS the latest config inside the task (never
+ * a precomputed diff — plan C6) and reconciles the running set toward it.
+ *
+ * Robustness (plan D): the desired set is produced by a single `loadDesired`
+ * call; if it throws for ANY reason (half-written file, JSON error, missing
+ * token, duplicate id, unsafe apiUrl, broken per-bot config), the current
+ * running set is left untouched — a bad edit never tears down healthy bots.
+ */
+import { watch } from 'node:fs';
+import { dirname, basename } from 'node:path';
+import { diffBotSets } from './bot-manager.js';
+/**
+ * Reconcile the running set toward `desiredConfigIds` once. Removes first, then
+ * adds, so a config that swaps a bot for another with an overlapping resource
+ * (lock/dir) frees it before the replacement claims it. Add/remove failures are
+ * logged and swallowed so one bad bot doesn't abort the whole reconcile; the
+ * BotManager queue keeps the set consistent. Pure-ish (no fs) for unit testing.
+ *
+ * `isStale` is checked before each add/remove: a newer config event makes the
+ * in-flight reconcile abandon its remaining (now outdated) actions, so a bot
+ * removed by a later edit is never started by an earlier, slower reconcile
+ * (plan C6 generation guard).
+ */
+export async function reconcile(manager, desiredConfigIds, log = () => { }, isStale = () => false) {
+    const { toAdd, toRemove } = diffBotSets(desiredConfigIds, manager.runningKeys());
+    for (const id of toRemove) {
+        if (isStale()) {
+            log(`[hot-reload] reconcile superseded by a newer config, stopping`);
+            return;
+        }
+        try {
+            await manager.removeBot(id);
+            log(`[hot-reload] removed bot ${id}`);
+        }
+        catch (err) {
+            log(`[hot-reload] removeBot ${id} failed: ${errMsg(err)}`);
+        }
+    }
+    for (const id of toAdd) {
+        if (isStale()) {
+            log(`[hot-reload] reconcile superseded by a newer config, stopping`);
+            return;
+        }
+        try {
+            await manager.addBot(id);
+            log(`[hot-reload] added bot ${id}`);
+        }
+        catch (err) {
+            log(`[hot-reload] addBot ${id} failed: ${errMsg(err)}`);
+        }
+    }
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * Start watching `configPath`'s directory and reconcile on change.
+ *
+ * Serialization & staleness: a single `chain` promise serializes apply runs,
+ * and each run re-reads the latest config at execution time, so a burst of
+ * events collapses to "apply the newest state" rather than replaying each
+ * intermediate edit. The BotManager's own queue further serializes the
+ * resulting add/remove calls.
+ */
+export function watchConfig(opts) {
+    const { configPath, manager, loadDesired } = opts;
+    const debounceMs = opts.debounceMs ?? 200;
+    const log = opts.log ?? (() => { });
+    const dir = dirname(configPath);
+    const file = basename(configPath);
+    let chain = Promise.resolve();
+    let timer;
+    let closed = false;
+    // Generation guard (plan C6). `latestGen` is bumped the moment a file event is
+    // observed (in schedule), NOT when the debounced apply finally runs — so an
+    // in-flight reconcile is invalidated immediately on a new event, even during
+    // the debounce window, instead of continuing to add/connect a bot a later
+    // edit already removed. Each apply captures the gen current when it starts and
+    // bails (isStale) as soon as a newer event has bumped past it.
+    let latestGen = 0;
+    const apply = () => {
+        const myGen = latestGen;
+        // Re-read latest desired set INSIDE the serialized task (plan C6). Any
+        // failure (half-write / invalid config) leaves the running set untouched.
+        chain = chain.then(async () => {
+            if (closed)
+                return;
+            let desired;
+            try {
+                desired = loadDesired();
+            }
+            catch (err) {
+                log(`[hot-reload] config invalid, keeping current bots: ${errMsg(err)}`);
+                return;
+            }
+            await reconcile(manager, desired, log, () => closed || myGen !== latestGen);
+        });
+        return chain;
+    };
+    const schedule = () => {
+        if (closed)
+            return;
+        // Invalidate any in-flight reconcile right now (not at debounce expiry): a
+        // slow reconcile must see this newer event before it acts on stale desired.
+        latestGen++;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            void apply();
+        }, debounceMs);
+        timer.unref?.();
+    };
+    let watcher;
+    try {
+        watcher = watch(dir, (_event, changed) => {
+            // Only react to our config file (the dir may hold per-bot subdirs etc.).
+            // changed is null on some platforms — be permissive and reconcile then.
+            if (changed === null || changed === file)
+                schedule();
+        });
+        watcher.on('error', (err) => log(`[hot-reload] watcher error: ${errMsg(err)}`));
+    }
+    catch (err) {
+        log(`[hot-reload] failed to start watcher on ${dir}: ${errMsg(err)}`);
+    }
+    return {
+        applyNow: apply,
+        close: () => {
+            closed = true;
+            if (timer)
+                clearTimeout(timer);
+            watcher?.close();
+        },
+    };
+}
+//# sourceMappingURL=config-watcher.js.map