@generacy-ai/generacy 0.5.0 → 0.7.0

package/dist/cli/commands/cockpit/doorbell/channel-discovery.js

@@ -0,0 +1,168 @@
+import { dirname, join, parse as parsePath } from 'node:path';
+import { z } from 'zod';
+export const DEFAULT_CHANNEL_FILE_PATH = '/var/lib/generacy/smee-channel';
+export const DEFAULT_WORKSPACE_MIRROR_PATH = '/workspaces/.generacy/cockpit/smee-channel';
+export const DEFAULT_WEBHOOK_CONFIG_TIMEOUT_MS = 5_000;
+// Copied verbatim from packages/orchestrator/src/services/smee-channel-resolver.ts:27
+// to avoid an orchestrator import in the CLI.
+export const SMEE_URL_PATTERN = /^https:\/\/smee\.io\/[A-Za-z0-9_-]+$/;
+export const SmeeHookSchema = z
+    .object({
+    id: z.number().int(),
+    active: z.boolean(),
+    config: z.object({ url: z.string() }),
+    updated_at: z.string(),
+})
+    .passthrough();
+/**
+ * Pure tie-break for `/hooks` payloads (FR-005).
+ * 1. Keep only `active === true`.
+ * 2. Keep only entries whose `config.url` matches `SMEE_URL_PATTERN`.
+ * 3. Sort by `Date.parse(updated_at)` desc; `NaN` sorts last (`-Infinity`).
+ * 4. Return the first entry or `null`.
+ */
+export function pickSmeeHook(hooks) {
+    const candidates = hooks.filter((h) => h.active === true && SMEE_URL_PATTERN.test(h.config.url));
+    const scored = candidates.map((h) => {
+        const t = Date.parse(h.updated_at);
+        return { h, t: Number.isNaN(t) ? -Infinity : t };
+    });
+    scored.sort((a, b) => b.t - a.t);
+    return scored[0]?.h ?? null;
+}
+const ENV_KEY = 'COCKPIT_DOORBELL_SMEE_URL';
+const WALKUP_SUFFIX = join('.generacy', 'cockpit', 'smee-channel');
+function warn(input, msg) {
+    input.logger?.warn?.(msg);
+}
+function isEnoent(err) {
+    if (err == null || typeof err !== 'object')
+        return false;
+    const code = err.code;
+    return code === 'ENOENT';
+}
+function errMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+async function tryReadUrl(input, path, onNonEnoentError, onMalformed) {
+    let raw;
+    try {
+        raw = await input.fs.readFile(path, 'utf-8');
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return null;
+        onNonEnoentError(errMessage(err));
+        return null;
+    }
+    const trimmed = raw.trim();
+    if (SMEE_URL_PATTERN.test(trimmed)) {
+        return trimmed;
+    }
+    onMalformed(trimmed);
+    return null;
+}
+async function runWebhookConfigStage(input) {
+    if (input.runner == null)
+        return null;
+    const targets = input.targets;
+    if (targets == null || targets.length === 0)
+        return null;
+    const timeoutMs = input.webhookConfigTimeoutMs != null && input.webhookConfigTimeoutMs > 0
+        ? input.webhookConfigTimeoutMs
+        : DEFAULT_WEBHOOK_CONFIG_TIMEOUT_MS;
+    const runner = input.runner;
+    for (const target of targets) {
+        const label = `${target.owner}/${target.repo}`;
+        let result;
+        try {
+            result = await runner('gh', ['api', `/repos/${target.owner}/${target.repo}/hooks`], { timeoutMs });
+        }
+        catch (err) {
+            warn(input, `cockpit doorbell: webhook-config stage failed for ${label}: exit=1 (${errMessage(err)})`);
+            continue;
+        }
+        if (result.exitCode !== 0) {
+            warn(input, `cockpit doorbell: webhook-config stage failed for ${label}: exit=${result.exitCode}`);
+            continue;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(result.stdout);
+        }
+        catch {
+            warn(input, `cockpit doorbell: webhook-config stage: malformed JSON for ${label}`);
+            continue;
+        }
+        const parsed = z.array(SmeeHookSchema).safeParse(raw);
+        if (!parsed.success) {
+            warn(input, `cockpit doorbell: webhook-config stage: unexpected /hooks shape for ${label}`);
+            continue;
+        }
+        const hook = pickSmeeHook(parsed.data);
+        if (hook == null)
+            continue; // routine — no smee hook here, try next
+        return hook.config.url;
+    }
+    return null;
+}
+export async function discoverChannelUrl(input) {
+    // Stage 1: env override.
+    const envRaw = input.env[ENV_KEY];
+    const envPresent = envRaw != null && envRaw !== '';
+    if (envPresent) {
+        if (SMEE_URL_PATTERN.test(envRaw)) {
+            return { url: envRaw, source: 'env' };
+        }
+        warn(input, `cockpit doorbell: ${ENV_KEY} does not match smee URL pattern; falling through to channel file`);
+    }
+    // Stage 2: webhook-config (gh api /hooks). Silent no-op when runner or
+    // targets are absent — the FS stages below still run.
+    const webhookUrl = await runWebhookConfigStage(input);
+    if (webhookUrl != null) {
+        return { url: webhookUrl, source: 'webhook-config' };
+    }
+    // Stage 3: walk-up scan starting at cwd.
+    const startCwd = input.cwd ?? process.cwd();
+    const root = parsePath(startCwd).root;
+    let dir = startCwd;
+    // Bound the walk: worst case ~few dozen hops, so no infinite-loop guard beyond
+    // the root check is required — path.dirname eventually stabilizes at root.
+    for (;;) {
+        const candidate = join(dir, WALKUP_SUFFIX);
+        const url = await tryReadUrl(input, candidate, (msg) => warn(input, `cockpit doorbell: walk-up read failed at ${dir}: ${msg}`), () => warn(input, `cockpit doorbell: channel content at ${candidate} does not match smee URL pattern`));
+        if (url != null) {
+            return { url, source: 'workspace-walkup' };
+        }
+        if (dir === root)
+            break;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Stage 4: absolute workspace mirror path.
+    const mirrorPath = input.workspaceMirrorPath ?? DEFAULT_WORKSPACE_MIRROR_PATH;
+    const mirrorUrl = await tryReadUrl(input, mirrorPath, (msg) => warn(input, `cockpit doorbell: failed to read workspace mirror at ${mirrorPath}: ${msg}`), () => warn(input, `cockpit doorbell: channel content at ${mirrorPath} does not match smee URL pattern`));
+    if (mirrorUrl != null) {
+        return { url: mirrorUrl, source: 'workspace-absolute' };
+    }
+    // Stage 5: cluster-internal channel file.
+    let raw;
+    try {
+        raw = await input.fs.readFile(input.channelFilePath, 'utf-8');
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return null;
+        warn(input, `cockpit doorbell: failed to read channel file ${input.channelFilePath}: ${errMessage(err)}`);
+        return null;
+    }
+    const trimmed = raw.trim();
+    if (SMEE_URL_PATTERN.test(trimmed)) {
+        return { url: trimmed, source: 'file' };
+    }
+    warn(input, `cockpit doorbell: channel file ${input.channelFilePath} content does not match smee URL pattern`);
+    return null;
+}
+//# sourceMappingURL=channel-discovery.js.map

package/dist/cli/commands/cockpit/doorbell/channel-discovery.js.map

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

package/dist/cli/commands/cockpit/doorbell/smee-source.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `SmeeDoorbellSource` — SSE consumer for the smee.io channel. Filters
+ * payloads by the epic's ref set and emits `CockpitStreamEvent`s to a
+ * caller-supplied sink. Models the reconnect ladder on
+ * `packages/orchestrator/src/services/smee-receiver.ts`.
+ *
+ * Contract: `specs/978-summary-generacy-cockpit/contracts/smee-doorbell-source.md`.
+ */
+import { type CommandRunner, type GhWrapper } from '@generacy-ai/cockpit';
+import type { CockpitStreamEvent } from '../watch/stream-event.js';
+export declare const DEFAULT_BASE_RECONNECT_DELAY_MS = 5000;
+export declare const DEFAULT_REFRESH_DEBOUNCE_MS = 500;
+export declare const DEFAULT_SAFETY_NET_INTERVAL_MS = 600000;
+export interface SmeeDoorbellSourceOptions {
+    channelUrl: string;
+    epicRef: string;
+    gh: GhWrapper;
+    runner?: CommandRunner;
+    logger: {
+        warn: (msg: string) => void;
+        info?: (msg: string) => void;
+    };
+    onEvent: (event: CockpitStreamEvent) => Promise<void>;
+    onReconnectAttempt: (failedAttempts: number) => void;
+    onReconnectSuccess: () => void;
+    onSseBytes?: () => void;
+    onRefSetRefreshFailure?: (err: unknown) => void;
+    now?: () => number;
+    fetch?: typeof globalThis.fetch;
+    refreshDebounceMs?: number;
+    safetyNetIntervalMs?: number;
+    baseReconnectDelayMs?: number;
+}
+export declare class SmeeDoorbellSource {
+    private readonly channelUrl;
+    private readonly epicRef;
+    private readonly gh;
+    private readonly logger;
+    private readonly onEvent;
+    private readonly onReconnectAttempt;
+    private readonly onReconnectSuccess;
+    private readonly onSseBytes?;
+    private readonly onRefSetRefreshFailure?;
+    private readonly now;
+    private readonly fetchImpl;
+    private readonly refreshDebounceMs;
+    private readonly safetyNetIntervalMs;
+    private readonly baseReconnectDelayMs;
+    private refSet;
+    private aggState;
+    private prev;
+    private currentResolved;
+    private reconnectAttempt;
+    private running;
+    private abortController;
+    private refreshTimer;
+    private refreshDebounceTimer;
+    private aggregateDebounceTimer;
+    private pendingAggregateTrigger;
+    private runLoopPromise;
+    constructor(options: SmeeDoorbellSourceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private sleep;
+    private runLoop;
+    private connect;
+    private processEventBlock;
+    private scheduleRefSetRefresh;
+    private refreshRefSet;
+    private scheduleAggregateRefresh;
+    private runAggregateRefresh;
+}
+//# sourceMappingURL=smee-source.d.ts.map

package/dist/cli/commands/cockpit/doorbell/smee-source.d.ts.map

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

package/dist/cli/commands/cockpit/doorbell/smee-source.js

@@ -0,0 +1,405 @@
+/**
+ * `SmeeDoorbellSource` — SSE consumer for the smee.io channel. Filters
+ * payloads by the epic's ref set and emits `CockpitStreamEvent`s to a
+ * caller-supplied sink. Models the reconnect ladder on
+ * `packages/orchestrator/src/services/smee-receiver.ts`.
+ *
+ * Contract: `specs/978-summary-generacy-cockpit/contracts/smee-doorbell-source.md`.
+ */
+import { resolveEpic, } from '@generacy-ai/cockpit';
+import { calculateBackoffDelay } from '@generacy-ai/smee-backoff';
+import { initialAggregateState } from '../watch/aggregate.js';
+import { snapshotKey } from '../watch/snapshot.js';
+import { parseSseEventBlock } from './sse-parser.js';
+import { webhookToStreamEvent, } from './webhook-to-event.js';
+import { maybeRefreshAggregate, } from './aggregate-on-demand.js';
+export const DEFAULT_BASE_RECONNECT_DELAY_MS = 5_000;
+export const DEFAULT_REFRESH_DEBOUNCE_MS = 500;
+export const DEFAULT_SAFETY_NET_INTERVAL_MS = 600_000;
+const AGGREGATE_TRIGGER_DEBOUNCE_MS = 500;
+function repoRefsToSets(allRefs) {
+    const issues = new Set();
+    const prs = new Set();
+    const repos = new Set();
+    for (const ref of allRefs) {
+        const key = `${ref.repo}#${ref.number}`;
+        issues.add(key);
+        prs.add(key);
+        repos.add(ref.repo);
+    }
+    return { issues, prs, repos };
+}
+function buildRefSet(resolved) {
+    const sets = repoRefsToSets(resolved.parsed.allRefs);
+    sets.issues.add(`${resolved.epic.repo}#${resolved.epic.number}`);
+    sets.repos.add(resolved.epic.repo);
+    return {
+        epicRef: `${resolved.epic.repo}#${resolved.epic.number}`,
+        epicNumber: resolved.epic.number,
+        epicRepo: resolved.epic.repo,
+        issues: sets.issues,
+        prs: sets.prs,
+        watchedRepos: sets.repos,
+    };
+}
+function deriveTrigger(payload) {
+    if (payload.githubEvent === 'issues' && payload.action === 'labeled') {
+        const labelObj = payload.body['label'];
+        if (labelObj != null && typeof labelObj === 'object') {
+            const name = labelObj['name'];
+            if (typeof name === 'string' && name.startsWith('completed:')) {
+                return { kind: 'completed-label', label: name };
+            }
+        }
+    }
+    if (payload.githubEvent === 'issues' && payload.action === 'closed') {
+        return { kind: 'issue-closed' };
+    }
+    if (payload.githubEvent === 'pull_request' && payload.action === 'closed') {
+        return { kind: 'pr-closed' };
+    }
+    return null;
+}
+function mapChecks(rollup) {
+    switch (rollup) {
+        case 'success':
+            return 'green';
+        case 'failure':
+        case 'error':
+            return 'red';
+        case 'pending':
+        case 'none':
+            return undefined;
+    }
+}
+function isEpicPayload(payload, epicNumber) {
+    if (payload.githubEvent !== 'issues')
+        return false;
+    if (payload.action !== 'edited' &&
+        payload.action !== 'labeled' &&
+        payload.action !== 'unlabeled') {
+        return false;
+    }
+    const issueObj = payload.body['issue'];
+    if (issueObj == null || typeof issueObj !== 'object')
+        return false;
+    const num = issueObj['number'];
+    return num === epicNumber;
+}
+export class SmeeDoorbellSource {
+    channelUrl;
+    epicRef;
+    gh;
+    logger;
+    onEvent;
+    onReconnectAttempt;
+    onReconnectSuccess;
+    onSseBytes;
+    onRefSetRefreshFailure;
+    now;
+    fetchImpl;
+    refreshDebounceMs;
+    safetyNetIntervalMs;
+    baseReconnectDelayMs;
+    refSet = null;
+    aggState = initialAggregateState();
+    prev = new Map();
+    currentResolved = null;
+    reconnectAttempt = 0;
+    running = false;
+    abortController = null;
+    refreshTimer = null;
+    refreshDebounceTimer = null;
+    aggregateDebounceTimer = null;
+    pendingAggregateTrigger = null;
+    runLoopPromise = null;
+    constructor(options) {
+        this.channelUrl = options.channelUrl;
+        this.epicRef = options.epicRef;
+        this.gh = options.gh;
+        this.logger = options.logger;
+        this.onEvent = options.onEvent;
+        this.onReconnectAttempt = options.onReconnectAttempt;
+        this.onReconnectSuccess = options.onReconnectSuccess;
+        if (options.onSseBytes != null) {
+            this.onSseBytes = options.onSseBytes;
+        }
+        if (options.onRefSetRefreshFailure != null) {
+            this.onRefSetRefreshFailure = options.onRefSetRefreshFailure;
+        }
+        this.now = options.now ?? (() => Date.now());
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        this.refreshDebounceMs = options.refreshDebounceMs ?? DEFAULT_REFRESH_DEBOUNCE_MS;
+        this.safetyNetIntervalMs =
+            options.safetyNetIntervalMs ?? DEFAULT_SAFETY_NET_INTERVAL_MS;
+        this.baseReconnectDelayMs =
+            options.baseReconnectDelayMs ?? DEFAULT_BASE_RECONNECT_DELAY_MS;
+    }
+    async start() {
+        if (this.running)
+            return;
+        // Blocking startup ref-set refresh: propagate resolveEpic failures so the
+        // caller (`runSmeeMode`) can demote to poll-fallback.
+        const resolved = await resolveEpic({
+            epicRef: this.epicRef,
+            gh: this.gh,
+            logger: this.logger,
+        });
+        this.currentResolved = resolved;
+        this.refSet = buildRefSet(resolved);
+        this.running = true;
+        this.abortController = new AbortController();
+        this.refreshTimer = setInterval(() => this.refreshRefSet(), this.safetyNetIntervalMs);
+        if (typeof this.refreshTimer.unref === 'function')
+            this.refreshTimer.unref();
+        this.runLoopPromise = this.runLoop();
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.abortController != null) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        if (this.refreshTimer != null) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+        if (this.refreshDebounceTimer != null) {
+            clearTimeout(this.refreshDebounceTimer);
+            this.refreshDebounceTimer = null;
+        }
+        if (this.aggregateDebounceTimer != null) {
+            clearTimeout(this.aggregateDebounceTimer);
+            this.aggregateDebounceTimer = null;
+        }
+        if (this.runLoopPromise != null) {
+            try {
+                await this.runLoopPromise;
+            }
+            catch {
+                /* drain */
+            }
+            this.runLoopPromise = null;
+        }
+    }
+    sleep(ms, signal) {
+        return new Promise((resolve) => {
+            if (signal.aborted) {
+                resolve();
+                return;
+            }
+            const timer = setTimeout(resolve, ms);
+            if (typeof timer.unref === 'function')
+                timer.unref();
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+    async runLoop() {
+        const signal = this.abortController?.signal;
+        if (signal == null)
+            return;
+        while (this.running && !signal.aborted) {
+            let sleepMs = calculateBackoffDelay(this.reconnectAttempt, {
+                base: this.baseReconnectDelayMs,
+                cap: 30_000,
+            });
+            try {
+                await this.connect(signal);
+                this.reconnectAttempt = 0;
+                sleepMs = calculateBackoffDelay(this.reconnectAttempt, {
+                    base: this.baseReconnectDelayMs,
+                    cap: 30_000,
+                });
+            }
+            catch (err) {
+                if (signal.aborted)
+                    break;
+                this.reconnectAttempt++;
+                sleepMs = calculateBackoffDelay(this.reconnectAttempt, {
+                    base: this.baseReconnectDelayMs,
+                    cap: 30_000,
+                });
+                this.logger.warn(`cockpit doorbell: smee connection lost, reconnecting in ${sleepMs}ms (attempt ${this.reconnectAttempt}): ${err instanceof Error ? err.message : String(err)}`);
+                try {
+                    this.onReconnectAttempt(this.reconnectAttempt);
+                }
+                catch {
+                    /* callback failures don't stop the loop */
+                }
+            }
+            if (this.running && !signal.aborted) {
+                await this.sleep(sleepMs, signal);
+            }
+        }
+    }
+    async connect(signal) {
+        const response = await this.fetchImpl(this.channelUrl, {
+            headers: { Accept: 'text/event-stream' },
+            signal,
+        });
+        if (!response.ok) {
+            throw new Error(`smee connection failed: ${response.status} ${response.statusText}`);
+        }
+        if (response.body == null) {
+            throw new Error('smee response has no body');
+        }
+        try {
+            this.onReconnectSuccess();
+        }
+        catch {
+            /* callback failures don't stop the loop */
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (!signal.aborted) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                if (value != null && value.length > 0) {
+                    try {
+                        this.onSseBytes?.();
+                    }
+                    catch {
+                        /* callback failures don't stop the loop */
+                    }
+                }
+                buffer += decoder.decode(value, { stream: true });
+                const events = buffer.split('\n\n');
+                buffer = events.pop() ?? '';
+                for (const block of events) {
+                    if (!block.trim())
+                        continue;
+                    await this.processEventBlock(block);
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async processEventBlock(block) {
+        const payload = parseSseEventBlock(block);
+        if (payload == null)
+            return;
+        if (this.refSet == null)
+            return;
+        if (isEpicPayload(payload, this.refSet.epicNumber)) {
+            this.scheduleRefSetRefresh();
+        }
+        const result = webhookToStreamEvent(payload.githubEvent, payload.action, payload.body, this.refSet, () => new Date(this.now()).toISOString());
+        if (result != null) {
+            const events = Array.isArray(result) ? result : [result];
+            for (const ev of events) {
+                let stamped = ev;
+                if (ev.type === 'issue-transition' &&
+                    (ev.event === 'pr-checks' ||
+                        (ev.event === 'label-change' && ev.sourceLabel === 'completed:validate'))) {
+                    // no gh calls — read-through PrSnapshot cache only (FR-005)
+                    const snap = this.prev.get(snapshotKey(ev.repo, 'pr', ev.number));
+                    if (snap?.kind === 'pr') {
+                        const wire = mapChecks(snap.checksRollup);
+                        if (wire !== undefined) {
+                            stamped = { ...ev, checks: wire };
+                        }
+                    }
+                }
+                try {
+                    await this.onEvent(stamped);
+                }
+                catch (err) {
+                    this.logger.warn(`cockpit doorbell: onEvent sink rejected: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        const trigger = deriveTrigger(payload);
+        if (trigger != null) {
+            this.scheduleAggregateRefresh(trigger);
+        }
+    }
+    scheduleRefSetRefresh() {
+        if (this.refreshDebounceTimer != null)
+            clearTimeout(this.refreshDebounceTimer);
+        this.refreshDebounceTimer = setTimeout(() => {
+            this.refreshDebounceTimer = null;
+            void this.refreshRefSet();
+        }, this.refreshDebounceMs);
+        if (typeof this.refreshDebounceTimer.unref === 'function') {
+            this.refreshDebounceTimer.unref();
+        }
+    }
+    async refreshRefSet() {
+        if (!this.running)
+            return;
+        try {
+            const resolved = await resolveEpic({
+                epicRef: this.epicRef,
+                gh: this.gh,
+                logger: this.logger,
+            });
+            this.currentResolved = resolved;
+            this.refSet = buildRefSet(resolved);
+        }
+        catch (err) {
+            this.logger.warn(`cockpit doorbell: ref-set refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+            if (this.onRefSetRefreshFailure != null) {
+                try {
+                    this.onRefSetRefreshFailure(err);
+                }
+                catch {
+                    /* callback errors are swallowed */
+                }
+            }
+        }
+    }
+    scheduleAggregateRefresh(trigger) {
+        this.pendingAggregateTrigger = trigger;
+        if (this.aggregateDebounceTimer != null) {
+            clearTimeout(this.aggregateDebounceTimer);
+        }
+        this.aggregateDebounceTimer = setTimeout(() => {
+            this.aggregateDebounceTimer = null;
+            const next = this.pendingAggregateTrigger;
+            this.pendingAggregateTrigger = null;
+            void this.runAggregateRefresh(next);
+        }, AGGREGATE_TRIGGER_DEBOUNCE_MS);
+        if (typeof this.aggregateDebounceTimer.unref === 'function') {
+            this.aggregateDebounceTimer.unref();
+        }
+    }
+    async runAggregateRefresh(trigger) {
+        if (!this.running || this.refSet == null)
+            return;
+        const output = await maybeRefreshAggregate({
+            trigger,
+            epicRef: this.epicRef,
+            epicRepo: this.refSet.epicRepo,
+            epicNumber: this.refSet.epicNumber,
+            prevAgg: this.aggState,
+            prev: this.prev,
+            currentResolved: this.currentResolved,
+            gh: this.gh,
+            logger: this.logger,
+            now: () => new Date(this.now()).toISOString(),
+        });
+        this.aggState = output.nextAgg;
+        this.prev = output.nextPrev;
+        this.currentResolved = output.nextResolved;
+        for (const ev of output.events) {
+            try {
+                await this.onEvent(ev);
+            }
+            catch (err) {
+                this.logger.warn(`cockpit doorbell: aggregate onEvent sink rejected: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=smee-source.js.map