@generacy-ai/generacy 0.5.0 → 0.6.0

package/dist/cli/commands/cockpit/doorbell.js

@@ -0,0 +1,477 @@
+/**
+ * `generacy cockpit doorbell` — wake sensor for `/cockpit:auto`.
+ *
+ * Owns its own in-process `acquireEpicBus()` call (Q1=C rationale: the
+ * cockpit MCP server is stdio-only and cannot accept a second client). On
+ * smee-live clusters, the doorbell subscribes to the smee.io SSE stream
+ * (real-time-first — revised FR-011, #978) with the poll bus as fallback.
+ * One process → one wake source at a time → one stdout line per event.
+ *
+ * Contract: `contracts/cli-surface.md`, `data-model.md`.
+ */
+import { promises as fsPromises } from 'node:fs';
+import { Command } from 'commander';
+import { GhCliWrapper, createGhResponseCache, createRateLimitScheduler, nodeChildProcessRunner, } from '@generacy-ai/cockpit';
+import { acquireEpicBus, } from './mcp/event-bus-registry.js';
+import { subscribeAndEmit, lineForEvent } from './doorbell/subscribe.js';
+import { discoverChannelUrl, DEFAULT_CHANNEL_FILE_PATH, } from './doorbell/channel-discovery.js';
+import { SourceSelector } from './doorbell/source-selector.js';
+import { SmeeDoorbellSource } from './doorbell/smee-source.js';
+import { runStartupRetry } from './doorbell/startup-retry.js';
+export function classifyForm(positional, options) {
+    const hasPositional = positional != null && positional.trim() !== '';
+    const hasTracking = options.tracking === true;
+    const hasNew = options.new != null && options.new.trim() !== '';
+    if (hasTracking && hasNew) {
+        return { kind: 'conflicting-flags', reason: 'tracking-with-new' };
+    }
+    if (hasNew) {
+        if (hasPositional) {
+            return { kind: 'conflicting-flags', reason: 'positional-with-new' };
+        }
+        return { kind: 'form-3', title: options.new };
+    }
+    if (!hasPositional) {
+        return { kind: 'missing-positional' };
+    }
+    if (hasTracking) {
+        return { kind: 'form-2', ref: positional };
+    }
+    return { kind: 'form-1', ref: positional };
+}
+function drainStdout(stdout) {
+    return new Promise((resolve) => {
+        stdout.write('', () => resolve());
+    });
+}
+function writeLine(stdout, line) {
+    return new Promise((resolve) => {
+        stdout.write(line, () => resolve());
+    });
+}
+/**
+ * Fallback scheduler for tests / callers that do not wire a real
+ * rate-limit-aware scheduler. Retry envelope treats absence as "sleep for
+ * 1s between attempts and do nothing else".
+ */
+function noopScheduler() {
+    return {
+        getCurrentIntervalMs: () => 1_000,
+        probeNow: async () => null,
+        noteRetryAfter: () => undefined,
+        noteResponseHeaders: () => undefined,
+        start: () => undefined,
+        stop: () => undefined,
+    };
+}
+async function runPollMode(input) {
+    const acquire = input.deps.acquireBus ?? acquireEpicBus;
+    const acquireOptions = {
+        epicRef: input.ref,
+        logger: input.logger,
+    };
+    if (input.deps.runner != null)
+        acquireOptions.runner = input.deps.runner;
+    if (input.deps.gh != null)
+        acquireOptions.gh = input.deps.gh;
+    if (input.deps.rateLimitScheduler != null) {
+        acquireOptions.rateLimitScheduler = input.deps.rateLimitScheduler;
+    }
+    const outcome = await runStartupRetry({
+        task: () => acquire(acquireOptions),
+        label: 'acquireEpicBus',
+        rateLimitScheduler: input.deps.rateLimitScheduler ?? noopScheduler(),
+        abortSignal: input.retryAbortSignal,
+        stderr: input.stderr,
+        logger: input.logger,
+    });
+    if (outcome.kind === 'permanent') {
+        return { kind: 'permanent-exit' };
+    }
+    if (outcome.kind === 'aborted') {
+        return null;
+    }
+    const acquired = outcome.value;
+    const onEmit = (event) => {
+        if (input.options.exitOnEpicComplete === true &&
+            input.form.kind === 'form-1' &&
+            event.type === 'epic-complete') {
+            input.stop();
+        }
+    };
+    const unsubscribe = subscribeAndEmit(acquired.bus, { stdout: input.stdout, onEmit });
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        unsubscribe();
+        acquired.release();
+    };
+    return {
+        release,
+        waitForStop: () => input.stopPromise,
+    };
+}
+async function runSmeeMode(input) {
+    if (input.deps.gh == null) {
+        input.logger.warn('cockpit doorbell: smee-mode requires a gh wrapper; falling through');
+        return null;
+    }
+    const gh = input.deps.gh;
+    const onEvent = async (event) => {
+        await new Promise((resolve) => {
+            input.stdout.write(lineForEvent(event), () => resolve());
+        });
+        if (input.options.exitOnEpicComplete === true &&
+            input.form.kind === 'form-1' &&
+            event.type === 'epic-complete') {
+            input.stop();
+        }
+    };
+    const sourceOptions = {
+        channelUrl: input.channelUrl,
+        epicRef: input.ref,
+        gh,
+        logger: input.logger,
+        onEvent,
+        onReconnectAttempt: (n) => input.selector.onReconnectAttempt(n),
+        onReconnectSuccess: () => input.selector.onReconnectSuccess(),
+    };
+    if (input.deps.runner != null)
+        sourceOptions.runner = input.deps.runner;
+    const source = input.deps.smeeSourceFactory != null
+        ? input.deps.smeeSourceFactory(sourceOptions)
+        : new SmeeDoorbellSource(sourceOptions);
+    const outcome = await runStartupRetry({
+        task: async () => {
+            await source.start();
+            return null;
+        },
+        label: 'resolveEpic',
+        rateLimitScheduler: input.deps.rateLimitScheduler ?? noopScheduler(),
+        abortSignal: input.retryAbortSignal,
+        stderr: process.stderr,
+        logger: input.logger,
+    });
+    if (outcome.kind === 'permanent') {
+        return { kind: 'permanent-exit' };
+    }
+    if (outcome.kind === 'aborted') {
+        return null;
+    }
+    return { source };
+}
+export async function runDoorbell(positional, options, deps = {}) {
+    const stderr = process.stderr;
+    const stdout = deps.stdout ?? process.stdout;
+    const exit = deps.exit ??
+        ((code) => {
+            process.exit(code);
+        });
+    const form = classifyForm(positional, options);
+    if (form.kind === 'missing-positional') {
+        stderr.write('cockpit doorbell: parse issue: issue argument is required\n');
+        try {
+            exit(2);
+        }
+        catch {
+            /* test seam may throw; propagate return */
+        }
+        return 2;
+    }
+    if (form.kind === 'conflicting-flags') {
+        if (form.reason === 'positional-with-new') {
+            stderr.write('cockpit doorbell: --new does not accept a positional argument\n');
+        }
+        else {
+            stderr.write('cockpit doorbell: --tracking and --new are mutually exclusive\n');
+        }
+        try {
+            exit(2);
+        }
+        catch {
+            /* test seam may throw; propagate return */
+        }
+        return 2;
+    }
+    const logger = deps.logger ?? { warn: (msg) => process.stderr.write(`${msg}\n`) };
+    let stopResolve = () => undefined;
+    const stopPromise = new Promise((resolve) => {
+        stopResolve = resolve;
+    });
+    let stopped = false;
+    // Signal used to abort startup-retry sleeps promptly on shutdown.
+    const retryAbortController = new AbortController();
+    const stop = () => {
+        if (stopped)
+            return;
+        stopped = true;
+        retryAbortController.abort();
+        stopResolve();
+    };
+    const onSignal = () => {
+        stop();
+    };
+    process.once('SIGINT', onSignal);
+    process.once('SIGTERM', onSignal);
+    const cleanupSignals = () => {
+        process.off('SIGINT', onSignal);
+        process.off('SIGTERM', onSignal);
+    };
+    if (deps.abortSignal != null) {
+        if (deps.abortSignal.aborted) {
+            stop();
+        }
+        else {
+            deps.abortSignal.addEventListener('abort', onSignal, { once: true });
+        }
+    }
+    // `armed\n` written before source selection (Q5=A / spec-explicit
+    // "unconditional, before source selection"). Preserves the shipped
+    // contract with agency#431 — the FR-006 `source=…` line on stderr is the
+    // "which source settled" signal.
+    await writeLine(stdout, 'armed\n');
+    if (form.kind === 'form-3') {
+        await stopPromise;
+        await drainStdout(stdout);
+        cleanupSignals();
+        try {
+            exit(0);
+        }
+        catch {
+            /* test seam may throw */
+        }
+        return 0;
+    }
+    const discover = deps.discoverChannel ?? discoverChannelUrl;
+    const env = deps.env ?? process.env;
+    const fs = deps.fs ?? fsPromises;
+    const channelFilePath = deps.channelFilePath ?? DEFAULT_CHANNEL_FILE_PATH;
+    // Smee-mode needs a gh wrapper for ref-set resolution and aggregate refreshes.
+    // Without one, discovery is wasted work and the code must poll-fallback anyway.
+    let discovery = null;
+    if (deps.gh != null || deps.discoverChannel != null) {
+        try {
+            discovery = await discover({
+                env,
+                channelFilePath,
+                fs,
+                logger,
+            });
+        }
+        catch {
+            discovery = null;
+        }
+    }
+    const selectorOptions = {
+        initial: discovery == null ? 'poll-fallback' : 'smee-attempt',
+        stderr,
+        logger,
+    };
+    const selector = deps.sourceSelectorFactory != null
+        ? deps.sourceSelectorFactory(selectorOptions)
+        : new SourceSelector(selectorOptions);
+    let pollHandle = null;
+    let smeeHandle = null;
+    const tearDownActiveSource = async () => {
+        if (smeeHandle != null) {
+            const s = smeeHandle;
+            smeeHandle = null;
+            await s.source.stop();
+        }
+        if (pollHandle != null) {
+            const p = pollHandle;
+            pollHandle = null;
+            p.release();
+        }
+    };
+    const startPollMode = async () => {
+        if (pollHandle != null)
+            return 'ok';
+        const handle = await runPollMode({
+            ref: form.ref,
+            form,
+            options,
+            deps,
+            logger,
+            stdout,
+            stderr,
+            stopPromise,
+            stop,
+            retryAbortSignal: retryAbortController.signal,
+        });
+        if (handle == null)
+            return 'transient-fail';
+        if ('kind' in handle && handle.kind === 'permanent-exit')
+            return 'permanent-exit';
+        pollHandle = handle;
+        return 'ok';
+    };
+    const startSmeeMode = async (url) => {
+        if (smeeHandle != null)
+            return 'ok';
+        const handle = await runSmeeMode({
+            ref: form.ref,
+            form,
+            channelUrl: url,
+            options,
+            deps,
+            logger,
+            stdout,
+            selector,
+            stop,
+            retryAbortSignal: retryAbortController.signal,
+        });
+        if (handle == null)
+            return 'transient-fail';
+        if ('kind' in handle && handle.kind === 'permanent-exit')
+            return 'permanent-exit';
+        smeeHandle = handle;
+        return 'ok';
+    };
+    // Signals a permanent-error exit from a mode-change branch that runs
+    // fire-and-forget. Consumed once at the outer boundary.
+    let permanentExit = false;
+    selector.onModeChange((next) => {
+        if (next === 'poll-fallback') {
+            void (async () => {
+                if (smeeHandle != null) {
+                    const s = smeeHandle;
+                    smeeHandle = null;
+                    await s.source.stop();
+                }
+                const outcome = await startPollMode();
+                if (outcome === 'permanent-exit') {
+                    permanentExit = true;
+                    stop();
+                }
+                else if (outcome === 'transient-fail')
+                    stop();
+            })();
+        }
+        else if (next === 'smee-attempt' && discovery != null) {
+            void (async () => {
+                if (pollHandle != null) {
+                    const p = pollHandle;
+                    pollHandle = null;
+                    p.release();
+                }
+                const outcome = await startSmeeMode(discovery.url);
+                if (outcome === 'permanent-exit') {
+                    permanentExit = true;
+                    stop();
+                }
+                else if (outcome === 'transient-fail') {
+                    // smee-attempt failed → fall back to poll-mode immediately, without
+                    // waiting for the demotion counter.
+                    const pollOutcome = await startPollMode();
+                    if (pollOutcome === 'permanent-exit') {
+                        permanentExit = true;
+                        stop();
+                    }
+                    else if (pollOutcome === 'transient-fail')
+                        stop();
+                }
+            })();
+        }
+    });
+    if (discovery != null) {
+        const outcome = await startSmeeMode(discovery.url);
+        if (outcome === 'permanent-exit') {
+            selector.stop();
+            cleanupSignals();
+            try {
+                exit(3);
+            }
+            catch {
+                /* test seam may throw */
+            }
+            return 3;
+        }
+        if (outcome === 'transient-fail') {
+            const pollOutcome = await startPollMode();
+            if (pollOutcome === 'permanent-exit') {
+                selector.stop();
+                cleanupSignals();
+                try {
+                    exit(3);
+                }
+                catch {
+                    /* test seam may throw */
+                }
+                return 3;
+            }
+            if (pollOutcome === 'transient-fail' && !stopped) {
+                selector.stop();
+                cleanupSignals();
+                try {
+                    exit(2);
+                }
+                catch {
+                    /* test seam may throw */
+                }
+                return 2;
+            }
+        }
+    }
+    else {
+        const outcome = await startPollMode();
+        if (outcome === 'permanent-exit') {
+            selector.stop();
+            cleanupSignals();
+            try {
+                exit(3);
+            }
+            catch {
+                /* test seam may throw */
+            }
+            return 3;
+        }
+        if (outcome === 'transient-fail' && !stopped) {
+            selector.stop();
+            cleanupSignals();
+            try {
+                exit(2);
+            }
+            catch {
+                /* test seam may throw */
+            }
+            return 2;
+        }
+    }
+    await stopPromise;
+    await tearDownActiveSource();
+    selector.stop();
+    await drainStdout(stdout);
+    cleanupSignals();
+    const finalCode = permanentExit ? 3 : 0;
+    try {
+        exit(finalCode);
+    }
+    catch {
+        /* test seam may throw */
+    }
+    return finalCode;
+}
+export function doorbellCommand() {
+    return new Command('doorbell')
+        .description('Wake sensor for /cockpit:auto. Emits one stdout line per epic bus event.')
+        .argument('[epic-ref]', 'Epic ref (Form 1) or tracking-issue ref (Form 2). Omitted under --new.')
+        .option('--tracking', 'Positional is a tracking-issue ref; subscribe the tracking-ref bus.', false)
+        .option('--new <title>', 'No subscription; arm as a placeholder before the tracking issue exists.')
+        .option('--exit-on-epic-complete', 'Exit 0 after flushing the epic-complete line. Off by default.', false)
+        .action(async (epicRef, options) => {
+        const runner = nodeChildProcessRunner;
+        const cache = createGhResponseCache();
+        const rateLimitScheduler = createRateLimitScheduler({ runner });
+        const gh = new GhCliWrapper(runner, undefined, { cache, rateLimitScheduler });
+        const code = await runDoorbell(epicRef, options, {
+            runner,
+            gh,
+            rateLimitScheduler,
+        });
+        process.exit(code);
+    });
+}
+//# sourceMappingURL=doorbell.js.map

package/dist/cli/commands/cockpit/doorbell.js.map

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

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

@@ -3,6 +3,7 @@
  *
  * Observability verbs (read-only) for Generacy epics and repos:
  *   - watch    — poll an epic's issues/PRs and emit cockpit events on state changes
+ *   - doorbell — wake sensor for /cockpit:auto; one stdout line per epic bus event
  *   - status   — render a grouped, colorized table of the epic's current state
  *
  * Single-issue verbs that inspect and drive workflow state for one issue:

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,cAAc,IAAI,OAAO,CAexC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,cAAc,IAAI,OAAO,CAgBxC"}

package/dist/cli/commands/cockpit/index.js

@@ -3,6 +3,7 @@
  *
  * Observability verbs (read-only) for Generacy epics and repos:
  *   - watch    — poll an epic's issues/PRs and emit cockpit events on state changes
+ *   - doorbell — wake sensor for /cockpit:auto; one stdout line per epic bus event
  *   - status   — render a grouped, colorized table of the epic's current state
  *
  * Single-issue verbs that inspect and drive workflow state for one issue:
@@ -17,6 +18,7 @@
  */
 import { Command } from 'commander';
 import { watchCommand } from './watch.js';
+import { doorbellCommand } from './doorbell.js';
 import { statusCommand } from './status.js';
 import { advanceCommand } from './advance.js';
 import { contextCommand } from './context.js';
@@ -29,6 +31,7 @@ export function cockpitCommand() {
     const command = new Command('cockpit');
     command.description('Cockpit — inspect and drive workflow state for Generacy epics and issues.');
     command.addCommand(watchCommand());
+    command.addCommand(doorbellCommand());
     command.addCommand(statusCommand());
     command.addCommand(advanceCommand());
     command.addCommand(contextCommand());

package/dist/cli/commands/cockpit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,CAAC,WAAW,CAAC,2EAA2E,CAAC,CAAC;IAEjG,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,CAAC,WAAW,CAAC,2EAA2E,CAAC,CAAC;IAEjG,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -17,13 +17,14 @@
  *   `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 { type CommandRunner, type GhWrapper } from '@generacy-ai/cockpit';
+import { type CommandRunner, type GhWrapper, type RateLimitScheduler } from '@generacy-ai/cockpit';
 import { EpicEventBus } from './event-bus.js';
 export interface AcquireOptions {
     epicRef: string;
     runner?: CommandRunner;
     gh?: GhWrapper;
     intervalMs?: number;
+    rateLimitScheduler?: RateLimitScheduler;
     logger?: {
         warn: (msg: string) => void;
         info?: (msg: string) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"event-bus-registry.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/event-bus-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,SAAS,EAEf,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgD9C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACvE;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,YAAY,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkJ/E;AA2JD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAM7C"}
+{"version":3,"file":"event-bus-registry.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/event-bus-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAExB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoD9C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACvE;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,YAAY,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6J/E;AA8KD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAM7C"}