@generacy-ai/generacy 0.3.4 → 0.5.0

package/dist/cli/commands/cockpit/mcp/event-bus-registry.js

@@ -0,0 +1,305 @@
+/**
+ * Per-orchestrator-process registry of `EpicEventBus` instances, keyed by
+ * epic-ref string (`"owner/repo#number"`).
+ *
+ * Each bus is driven by a private poller — mirrors `watch.ts` but emits into
+ * the bus instead of stdout NDJSON. Multiple concurrent `cockpit_await_events`
+ * callers against the same epic share the subscriber; refcounted via
+ * `acquire` / `release`.
+ *
+ * Bus lifetime is decoupled from call lifetime (#924): `release()` at
+ * refcount 0 pauses the poller and arms an idle-TTL timer instead of tearing
+ * down the bus. The next `acquire()` disarms the timer, resumes the poller,
+ * and runs a synchronous catch-up poll so between-call events are captured.
+ * A soft cap on live buses evicts the least-recently-active on overflow.
+ *
+ * Env knobs:
+ *   `COCKPIT_MCP_BUS_IDLE_TTL_MS` — idle-TTL for refcount-0 buses (default 600_000).
+ *   `COCKPIT_MCP_BUS_MAX`         — soft cap on live buses (default 100).
+ */
+import { GhCliWrapper, LoudResolverError, resolveEpic, } from '@generacy-ai/cockpit';
+import { resolveIssueContext } from '../resolver.js';
+import { runOnePoll } from '../watch/poll-loop.js';
+import { computeAggregateEvents, initialAggregateState, } from '../watch/aggregate.js';
+import { EpicEventBus } from './event-bus.js';
+const DEFAULT_INTERVAL_MS = 30_000;
+/** Env knob `COCKPIT_MCP_BUS_IDLE_TTL_MS` — idle-TTL for refcount-0 buses. */
+const DEFAULT_IDLE_TTL_MS = 600_000;
+/** Env knob `COCKPIT_MCP_BUS_MAX` — soft cap on live buses. */
+const DEFAULT_MAX_BUSES = 100;
+function parsePositiveIntEnv(raw, fallback, name, logger) {
+    if (raw == null || raw === '')
+        return fallback;
+    const n = Number.parseInt(raw, 10);
+    if (Number.isNaN(n) || n <= 0) {
+        logger?.warn(`event-bus: invalid ${name}=${raw}; using default ${fallback}`);
+        return fallback;
+    }
+    return n;
+}
+const registry = new Map();
+export async function acquireEpicBus(options) {
+    const expandedRef = await expandRef(options.epicRef, options.runner);
+    const now = options.now ?? Date.now;
+    const logger = options.logger ?? { warn: () => undefined };
+    const idleTtlMs = parsePositiveIntEnv(process.env.COCKPIT_MCP_BUS_IDLE_TTL_MS, options.idleTtlMs ?? DEFAULT_IDLE_TTL_MS, 'COCKPIT_MCP_BUS_IDLE_TTL_MS', logger);
+    const maxBuses = parsePositiveIntEnv(process.env.COCKPIT_MCP_BUS_MAX, options.maxBuses ?? DEFAULT_MAX_BUSES, 'COCKPIT_MCP_BUS_MAX', logger);
+    const existing = registry.get(expandedRef);
+    if (existing != null) {
+        const wasPaused = existing.refCount === 0;
+        if (existing.idleTimer != null) {
+            clearTimeout(existing.idleTimer);
+            existing.idleTimer = null;
+        }
+        existing.refCount += 1;
+        existing.lastActiveAt = now();
+        // Reinsert at tail for LRU ordering.
+        registry.delete(expandedRef);
+        registry.set(expandedRef, existing);
+        // Catch-up only runs when the poller was paused (refcount had been 0);
+        // concurrent-caller acquires (refcount was already > 0) skip it.
+        if (wasPaused) {
+            await existing.catchUpPoll();
+            existing.resumePoller();
+        }
+        return { bus: existing.bus, release: () => releaseKey(expandedRef) };
+    }
+    // New bus. Evict LRU if at soft cap.
+    if (registry.size >= maxBuses) {
+        const evictedKey = registry.keys().next().value;
+        if (evictedKey != null) {
+            const evicted = registry.get(evictedKey);
+            if (evicted != null) {
+                if (evicted.idleTimer != null)
+                    clearTimeout(evicted.idleTimer);
+                evicted.stop();
+                registry.delete(evictedKey);
+                logger.warn(`event-bus: LRU eviction of ${evictedKey} at cap ${maxBuses}`);
+            }
+        }
+    }
+    const bus = new EpicEventBus({ epic: expandedRef });
+    if (options.noPoll === true && options.runCycle == null) {
+        const sub = {
+            bus,
+            refCount: 1,
+            stop: () => undefined,
+            pausePoller: () => undefined,
+            resumePoller: () => undefined,
+            catchUpPoll: async () => undefined,
+            idleTimer: null,
+            lastActiveAt: now(),
+            idleTtlMs,
+            logger,
+        };
+        registry.set(expandedRef, sub);
+        return { bus, release: () => releaseKey(expandedRef) };
+    }
+    const gh = options.gh ?? new GhCliWrapper(options.runner);
+    const interval = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+    const state = {
+        prev: new Map(),
+        aggState: initialAggregateState(),
+        firstPoll: true,
+        currentResolved: null,
+    };
+    const controller = new AbortController();
+    const pauseState = {
+        paused: false,
+        resumeResolver: null,
+    };
+    const runCycle = options.runCycle
+        ? () => options.runCycle(bus)
+        : () => runRealCycle(bus, expandedRef, gh, state, logger);
+    const catchUpPoll = async () => {
+        try {
+            await runCycle();
+            logger.info?.(`event-bus: catch-up poll for ${expandedRef}`);
+        }
+        catch (err) {
+            logger.warn(`event-bus: catch-up poll failed for ${expandedRef}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+    const stop = () => {
+        controller.abort();
+        // Also wake any pending resume waiter so the loop exits promptly.
+        if (pauseState.resumeResolver != null) {
+            const r = pauseState.resumeResolver;
+            pauseState.resumeResolver = null;
+            r();
+        }
+    };
+    const pausePoller = () => {
+        pauseState.paused = true;
+    };
+    const resumePoller = () => {
+        if (!pauseState.paused)
+            return;
+        pauseState.paused = false;
+        if (pauseState.resumeResolver != null) {
+            const r = pauseState.resumeResolver;
+            pauseState.resumeResolver = null;
+            r();
+        }
+    };
+    const sub = {
+        bus,
+        refCount: 1,
+        stop,
+        pausePoller,
+        resumePoller,
+        catchUpPoll,
+        idleTimer: null,
+        lastActiveAt: now(),
+        idleTtlMs,
+        logger,
+    };
+    registry.set(expandedRef, sub);
+    // Kick off the poll loop unless the caller opted out (`noPoll` with a
+    // custom `runCycle` is a valid test config — the loop is still needed).
+    if (options.noPoll !== true) {
+        void runPollLoop(runCycle, interval, controller.signal, pauseState, logger);
+    }
+    return { bus, release: () => releaseKey(expandedRef) };
+}
+function releaseKey(key) {
+    const sub = registry.get(key);
+    if (sub == null)
+        return;
+    sub.refCount -= 1;
+    if (sub.refCount > 0)
+        return;
+    sub.pausePoller();
+    sub.idleTimer = setTimeout(() => {
+        // Guarded: an acquire may have raced in during the tick.
+        const current = registry.get(key);
+        if (current == null || current !== sub)
+            return;
+        if (current.refCount > 0)
+            return;
+        current.stop();
+        registry.delete(key);
+        current.idleTimer = null;
+        current.logger.info?.(`event-bus: idle-TTL eviction of ${key}`);
+    }, sub.idleTtlMs);
+    if (sub.idleTimer.unref)
+        sub.idleTimer.unref();
+}
+async function expandRef(input, runner) {
+    const resolved = await resolveIssueContext({
+        issue: input,
+        ...(runner != null ? { runner } : {}),
+    });
+    return `${resolved.ref.nwo}#${resolved.ref.number}`;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        if (timer.unref)
+            timer.unref();
+        signal.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}
+function waitForResume(pauseState, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted || !pauseState.paused) {
+            resolve();
+            return;
+        }
+        pauseState.resumeResolver = resolve;
+        signal.addEventListener('abort', () => {
+            if (pauseState.resumeResolver === resolve) {
+                pauseState.resumeResolver = null;
+                resolve();
+            }
+        }, { once: true });
+    });
+}
+async function runPollLoop(runCycle, interval, signal, pauseState, logger) {
+    while (!signal.aborted) {
+        if (pauseState.paused) {
+            await waitForResume(pauseState, signal);
+            if (signal.aborted)
+                break;
+            continue;
+        }
+        try {
+            await runCycle();
+        }
+        catch (err) {
+            logger.warn(`event-bus: poll error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (signal.aborted)
+            break;
+        if (pauseState.paused)
+            continue;
+        await sleep(interval, signal);
+    }
+}
+async function runRealCycle(bus, expandedRef, gh, state, logger) {
+    if (state.currentResolved == null) {
+        try {
+            state.currentResolved = await resolveEpic({ epicRef: expandedRef, gh, logger });
+        }
+        catch (err) {
+            if (err instanceof LoudResolverError) {
+                logger.warn(`event-bus: resolveEpic failed: ${err.message}`);
+            }
+            else {
+                logger.warn(`event-bus: resolveEpic failed: ${String(err)}`);
+            }
+            return;
+        }
+    }
+    const resolved = state.currentResolved;
+    const result = await runOnePoll(state.prev, {
+        gh,
+        refs: resolved.parsed.allRefs,
+        epicOwnerRepo: resolved.epic.repo,
+        logger,
+    });
+    for (const event of result.events) {
+        bus.emit({ ...event, type: 'issue-transition' });
+    }
+    const aggregateResult = computeAggregateEvents({
+        curr: result.curr,
+        parsed: resolved.parsed,
+        epicRepo: resolved.epic.repo,
+        epicNumber: resolved.epic.number,
+        prevState: state.aggState,
+        initial: state.firstPoll,
+        now: () => new Date().toISOString(),
+    });
+    for (const event of aggregateResult.events) {
+        bus.emit(event);
+    }
+    state.aggState = aggregateResult.nextState;
+    state.prev = result.curr;
+    state.firstPoll = false;
+    // Refresh the resolved epic for the next cycle (best effort).
+    try {
+        state.currentResolved = await resolveEpic({ epicRef: expandedRef, gh, logger });
+    }
+    catch (err) {
+        logger.warn(`event-bus: resolveEpic refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Test-only: forcibly release all subscriptions. Use in test `afterEach`.
+ */
+export function _resetRegistryForTests() {
+    for (const sub of registry.values()) {
+        if (sub.idleTimer != null)
+            clearTimeout(sub.idleTimer);
+        sub.stop();
+    }
+    registry.clear();
+}
+//# sourceMappingURL=event-bus-registry.js.map

package/dist/cli/commands/cockpit/mcp/event-bus-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-registry.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/event-bus-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,GAIZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,8EAA8E;AAC9E,MAAM,mBAAmB,GAAG,OAAO,CAAC;AACpC,+DAA+D;AAC/D,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,mBAAmB,CAC1B,GAAuB,EACvB,QAAgB,EAChB,IAAY,EACZ,MAAwC;IAExC,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,EAAE,IAAI,CAAC,sBAAsB,IAAI,IAAI,GAAG,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC7E,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAwBD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAiCjD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAuB;IAC1D,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,mBAAmB,CACnC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EACvC,OAAO,CAAC,SAAS,IAAI,mBAAmB,EACxC,6BAA6B,EAC7B,MAAM,CACP,CAAC;IACF,MAAM,QAAQ,GAAG,mBAAmB,CAClC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAC/B,OAAO,CAAC,QAAQ,IAAI,iBAAiB,EACrC,qBAAqB,EACrB,MAAM,CACP,CAAC;IAEF,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,KAAK,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YAC/B,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACjC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;QACvB,QAAQ,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC;QAC9B,qCAAqC;QACrC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7B,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACpC,uEAAuE;QACvE,iEAAiE;QACjE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC7B,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,qCAAqC;IACrC,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAChD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,IAAI,OAAO,CAAC,SAAS,IAAI,IAAI;oBAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC/D,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,8BAA8B,UAAU,WAAW,QAAQ,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAEpD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;QACxD,MAAM,GAAG,GAAiB;YACxB,GAAG;YACH,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;YACrB,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;YAC5B,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS;YAC7B,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;YAClC,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,GAAG,EAAE;YACnB,SAAS;YACT,MAAM;SACP,CAAC;QACF,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC/B,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAE3D,MAAM,KAAK,GAAc;QACvB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,QAAQ,EAAE,qBAAqB,EAAE;QACjC,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,IAAI;KACtB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,UAAU,GAAe;QAC7B,MAAM,EAAE,KAAK;QACb,cAAc,EAAE,IAAI;KACrB,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;QAC/B,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAS,CAAC,GAAG,CAAC;QAC9B,CAAC,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAE5D,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,QAAQ,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,EAAE,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,uCAAuC,WAAW,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC1G,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,kEAAkE;QAClE,IAAI,UAAU,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,UAAU,CAAC,cAAc,CAAC;YACpC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC;YACjC,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,GAAS,EAAE;QAC9B,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO;QAC/B,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC;QAC1B,IAAI,UAAU,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,UAAU,CAAC,cAAc,CAAC;YACpC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC;YACjC,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,GAAG,GAAiB;QACxB,GAAG;QACH,QAAQ,EAAE,CAAC;QACX,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,WAAW;QACX,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,GAAG,EAAE;QACnB,SAAS;QACT,MAAM;KACP,CAAC;IACF,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAE/B,sEAAsE;IACtE,wEAAwE;IACxE,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,KAAK,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;AACzD,CAAC;AAOD,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO;IACxB,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;IAClB,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO;IAC7B,GAAG,CAAC,WAAW,EAAE,CAAC;IAClB,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;QAC9B,yDAAyD;QACzD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,GAAG;YAAE,OAAO;QAC/C,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC;YAAE,OAAO;QACjC,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,OAAgD,CAAC,SAAS,GAAG,IAAI,CAAC;QACnE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAClB,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK;QAAE,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,KAAa,EAAE,MAAiC;IACvE,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC;QACzC,KAAK,EAAE,KAAK;QACZ,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC,CAAC;IACH,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAmB;IAC5C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,UAAsB,EAAE,MAAmB;IAChE,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,UAAU,CAAC,cAAc,GAAG,OAAO,CAAC;QACpC,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,IAAI,UAAU,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC;gBAC1C,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC;gBACjC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,QAA6B,EAC7B,QAAgB,EAChB,MAAmB,EACnB,UAAsB,EACtB,MAAuC;IAEvC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACxC,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7E,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM;QAC1B,IAAI,UAAU,CAAC,MAAM;YAAE,SAAS;QAChC,MAAM,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,GAAiB,EACjB,WAAmB,EACnB,EAAa,EACb,KAAgB,EAChB,MAAuC;IAEvC,IAAI,KAAK,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,KAAK,CAAC,eAAe,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,kCAAkC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,OAAO;QACT,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE;QAC1C,EAAE;QACF,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;QAC7B,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI;QACjC,MAAM;KACP,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAwB,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,eAAe,GAAG,sBAAsB,CAAC;QAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI;QAC5B,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QAChC,SAAS,EAAE,KAAK,CAAC,QAAQ;QACzB,OAAO,EAAE,KAAK,CAAC,SAAS;QACxB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,KAA2B,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC;IAC3C,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IAExB,8DAA8D;IAC9D,IAAI,CAAC;QACH,KAAK,CAAC,eAAe,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,0CAA0C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI;YAAE,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvD,GAAG,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IACD,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/cli/commands/cockpit/mcp/event-bus.d.ts

@@ -0,0 +1,82 @@
+import type { CockpitStreamEvent } from '../watch/stream-event.js';
+export interface EventBusEntry {
+    cursor: number;
+    event: CockpitStreamEvent;
+    emittedAt: number;
+}
+export interface WaitForInput {
+    sinceCursor: number;
+    maxWaitMs: number;
+    coalesceWindowMs: number;
+    maxBatchSize: number;
+    /** Optional clock injection for tests. */
+    now?: () => number;
+}
+export interface WaitForResult {
+    entries: EventBusEntry[];
+    resetFrom?: 'expired';
+}
+export type CursorParseResult = {
+    kind: 'valid';
+    position: number;
+} | {
+    kind: 'expired';
+    requestedPosition: number;
+} | {
+    kind: 'discarded';
+    reason: 'legacy' | 'cross-instance' | 'evicted';
+} | {
+    kind: 'malformed';
+} | {
+    kind: 'never-issued';
+} | {
+    kind: 'wrong-epic';
+    requestedEpic: string;
+    boundEpic: string;
+};
+export interface EpicEventBusOptions {
+    epic: string;
+    retentionCount?: number;
+    retentionMs?: number;
+    now?: () => number;
+    /** Test seam: override the per-bus nonce. Defaults to a fresh random. */
+    nonce?: string;
+}
+/**
+ * Per-process nonce generated once at module load. Embedded in every cursor
+ * token so cross-instance cursors (server restart) classify as `discarded`
+ * rather than `never-issued`.
+ */
+export declare const INSTANCE_NONCE: string;
+export declare function encodeCursor(epic: string, position: number, pnonce: string, bnonce: string): string;
+export declare function decodeCursor(str: string): {
+    epic: string;
+    position: number;
+    pnonce?: string;
+    bnonce?: string;
+} | null;
+export declare class EpicEventBus {
+    readonly epic: string;
+    readonly busNonce: string;
+    private buffer;
+    private nextCursor;
+    private waiters;
+    private readonly retentionCount;
+    private readonly retentionMs;
+    private readonly clock;
+    constructor(options: EpicEventBusOptions);
+    emit(event: CockpitStreamEvent): EventBusEntry;
+    parseCursor(str: string | undefined): CursorParseResult;
+    /**
+     * Drain entries with cursor > sinceCursor immediately (up to maxBatchSize);
+     * if empty, wait up to maxWaitMs for the first emit, then coalesce for
+     * coalesceWindowMs (or until maxBatchSize is reached).
+     */
+    waitFor(input: WaitForInput): Promise<WaitForResult>;
+    private waitForFirstEmit;
+    private flushWaiters;
+    private trim;
+    /** Test-only inspector. */
+    size(): number;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/cli/commands/cockpit/mcp/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/event-bus.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAA8C,CAAC;AAI5E,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAGR;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6B7E;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,OAAO,EAAE,mBAAmB;IAQxC,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa;IAa9C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB;IA0BvD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA+C1D,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,IAAI;IAUZ,2BAA2B;IAC3B,IAAI,IAAI,MAAM;CAGf"}

package/dist/cli/commands/cockpit/mcp/event-bus.js

@@ -0,0 +1,230 @@
+/**
+ * In-process event bus for `cockpit_await_events`.
+ *
+ * Per-epic broadcaster subscribed to the same event source `cockpit watch`
+ * uses (poll loop + aggregate emits). Monotonic cursor; LRU buffer bounded
+ * by `retentionCount` AND `retentionMs` (whichever hits first).
+ *
+ * Cursor is base64-encoded JSON `{epic, position, pnonce, bnonce}` — opaque
+ * to callers. `pnonce` is a per-process instance nonce (16 hex chars);
+ * `bnonce` is a per-bus-instance nonce (16 hex chars). Distinct classes:
+ *   - `valid`         → normal path
+ *   - `expired`       → position below the low-watermark; return `resetFrom: "expired"`
+ *   - `discarded`     → nonce missing (legacy) or mismatched (cross-instance / evicted);
+ *                       reset to head with `resetFrom: "discarded"`
+ *   - `malformed`     → not base64 / not JSON / bad shape
+ *   - `never-issued`  → shape ok, nonces match, but position outside issued range
+ *   - `wrong-epic`    → cursor was issued for a different epic
+ *
+ * Retention env knobs: `COCKPIT_MCP_EVENT_RETENTION_COUNT` (default 10_000),
+ * `COCKPIT_MCP_EVENT_RETENTION_MS` (default 600_000).
+ */
+import crypto from 'node:crypto';
+/**
+ * Per-process nonce generated once at module load. Embedded in every cursor
+ * token so cross-instance cursors (server restart) classify as `discarded`
+ * rather than `never-issued`.
+ */
+export const INSTANCE_NONCE = crypto.randomBytes(8).toString('hex');
+const NONCE_SHAPE = /^[0-9a-f]{16}$/;
+export function encodeCursor(epic, position, pnonce, bnonce) {
+    const json = JSON.stringify({ epic, position, pnonce, bnonce });
+    return Buffer.from(json, 'utf-8').toString('base64');
+}
+export function decodeCursor(str) {
+    let buf;
+    try {
+        buf = Buffer.from(str, 'base64');
+    }
+    catch {
+        return null;
+    }
+    const decoded = buf.toString('utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(decoded);
+    }
+    catch {
+        return null;
+    }
+    if (parsed == null || typeof parsed !== 'object')
+        return null;
+    const record = parsed;
+    if (typeof record.epic !== 'string' || typeof record.position !== 'number')
+        return null;
+    if (!Number.isInteger(record.position) || record.position < 0)
+        return null;
+    const out = {
+        epic: record.epic,
+        position: record.position,
+    };
+    if (typeof record.pnonce === 'string' && NONCE_SHAPE.test(record.pnonce)) {
+        out.pnonce = record.pnonce;
+    }
+    if (typeof record.bnonce === 'string' && NONCE_SHAPE.test(record.bnonce)) {
+        out.bnonce = record.bnonce;
+    }
+    return out;
+}
+export class EpicEventBus {
+    epic;
+    busNonce;
+    buffer = [];
+    nextCursor = 1;
+    waiters = [];
+    retentionCount;
+    retentionMs;
+    clock;
+    constructor(options) {
+        this.epic = options.epic;
+        this.retentionCount = options.retentionCount ?? 10_000;
+        this.retentionMs = options.retentionMs ?? 600_000;
+        this.clock = options.now ?? Date.now;
+        this.busNonce = options.nonce ?? crypto.randomBytes(8).toString('hex');
+    }
+    emit(event) {
+        const entry = {
+            cursor: this.nextCursor,
+            event,
+            emittedAt: this.clock(),
+        };
+        this.nextCursor += 1;
+        this.buffer.push(entry);
+        this.trim();
+        this.flushWaiters();
+        return entry;
+    }
+    parseCursor(str) {
+        if (str == null)
+            return { kind: 'valid', position: 0 };
+        const decoded = decodeCursor(str);
+        if (decoded == null)
+            return { kind: 'malformed' };
+        if (decoded.pnonce == null || decoded.bnonce == null) {
+            return { kind: 'discarded', reason: 'legacy' };
+        }
+        if (decoded.epic !== this.epic) {
+            return { kind: 'wrong-epic', requestedEpic: decoded.epic, boundEpic: this.epic };
+        }
+        if (decoded.pnonce !== INSTANCE_NONCE) {
+            return { kind: 'discarded', reason: 'cross-instance' };
+        }
+        if (decoded.bnonce !== this.busNonce) {
+            return { kind: 'discarded', reason: 'evicted' };
+        }
+        if (decoded.position === 0)
+            return { kind: 'valid', position: 0 };
+        if (decoded.position >= this.nextCursor)
+            return { kind: 'never-issued' };
+        const lowWatermark = this.buffer.length === 0 ? this.nextCursor : this.buffer[0].cursor;
+        if (decoded.position < lowWatermark - 1) {
+            return { kind: 'expired', requestedPosition: decoded.position };
+        }
+        return { kind: 'valid', position: decoded.position };
+    }
+    /**
+     * Drain entries with cursor > sinceCursor immediately (up to maxBatchSize);
+     * if empty, wait up to maxWaitMs for the first emit, then coalesce for
+     * coalesceWindowMs (or until maxBatchSize is reached).
+     */
+    async waitFor(input) {
+        const now = input.now ?? this.clock;
+        const drainFrom = (since, cap) => {
+            const out = [];
+            for (const entry of this.buffer) {
+                if (entry.cursor <= since)
+                    continue;
+                out.push(entry);
+                if (out.length >= cap)
+                    break;
+            }
+            return out;
+        };
+        let batch = drainFrom(input.sinceCursor, input.maxBatchSize);
+        if (batch.length === 0) {
+            if (input.maxWaitMs === 0) {
+                return { entries: [] };
+            }
+            const first = await this.waitForFirstEmit(input.sinceCursor, input.maxWaitMs);
+            if (first == null)
+                return { entries: [] };
+            batch = [first];
+        }
+        if (batch.length >= input.maxBatchSize) {
+            return { entries: batch };
+        }
+        if (input.coalesceWindowMs > 0) {
+            const deadline = now() + input.coalesceWindowMs;
+            while (batch.length < input.maxBatchSize) {
+                const remaining = deadline - now();
+                if (remaining <= 0)
+                    break;
+                const nextSince = batch[batch.length - 1].cursor;
+                const more = drainFrom(nextSince, input.maxBatchSize - batch.length);
+                if (more.length > 0) {
+                    for (const entry of more)
+                        batch.push(entry);
+                    continue;
+                }
+                const next = await this.waitForFirstEmit(nextSince, remaining);
+                if (next == null)
+                    break;
+                batch.push(next);
+            }
+        }
+        return { entries: batch };
+    }
+    waitForFirstEmit(sinceCursor, waitMs) {
+        return new Promise((resolve) => {
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                this.waiters = this.waiters.filter((w) => w !== waiter);
+                resolve(null);
+            }, waitMs);
+            if (timer.unref)
+                timer.unref();
+            const waiter = {
+                sinceCursor,
+                resolve: (entries) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearTimeout(timer);
+                    resolve(entries[0] ?? null);
+                },
+            };
+            this.waiters.push(waiter);
+        });
+    }
+    flushWaiters() {
+        if (this.waiters.length === 0)
+            return;
+        const pending = this.waiters;
+        this.waiters = [];
+        for (const waiter of pending) {
+            const entries = [];
+            for (const entry of this.buffer) {
+                if (entry.cursor > waiter.sinceCursor)
+                    entries.push(entry);
+            }
+            waiter.resolve(entries);
+        }
+    }
+    trim() {
+        const cutoff = this.clock() - this.retentionMs;
+        while (this.buffer.length > 0 && this.buffer[0].emittedAt < cutoff) {
+            this.buffer.shift();
+        }
+        while (this.buffer.length > this.retentionCount) {
+            this.buffer.shift();
+        }
+    }
+    /** Test-only inspector. */
+    size() {
+        return this.buffer.length;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/cli/commands/cockpit/mcp/event-bus.js.map

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

package/dist/cli/commands/cockpit/mcp/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `generacy cockpit mcp` command — Commander factory. Refuses to start on
+ * worker containers via `GENERACY_CLUSTER_ROLE` (Q2-A defense-in-depth).
+ * On orchestrator (or missing env), builds the MCP server and connects a
+ * stdio transport.
+ */
+import { Command } from 'commander';
+export interface CockpitMcpDeps {
+    /** Injection seam for tests — bypass real stdio transport. */
+    makeTransport?: () => unknown;
+    env?: NodeJS.ProcessEnv;
+    stderr?: (line: string) => void;
+    exit?: (code: number) => never;
+}
+export declare function cockpitMcpCommand(deps?: CockpitMcpDeps): Command;
+export declare function runCockpitMcp(deps?: CockpitMcpDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/cockpit/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAUpE;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB5E"}