@generacy-ai/generacy 0.4.0 → 0.6.0

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

@@ -0,0 +1,182 @@
+/**
+ * `SourceSelector` — owns the runtime demotion/re-promotion state for the
+ * doorbell's wake source (Q3=D policy). Emits exactly one FR-006 `source=…`
+ * stderr line per transition.
+ *
+ * Contract: `specs/978-summary-generacy-cockpit/contracts/source-selector.md`.
+ */
+export const DEFAULT_DEMOTE_AFTER_FAILURES = 5;
+export const DEFAULT_DEMOTE_AFTER_MS_WITHOUT_SUCCESS = 300_000;
+export const DEFAULT_RE_PROMOTE_INTERVAL_MS = 300_000;
+const ELAPSED_TICKER_INTERVAL_MS = 1_000;
+function formatLine(next, reason) {
+    const label = next === 'poll-fallback' ? 'poll-fallback' : 'smee';
+    return `cockpit doorbell: source=${label} reason=${reason}\n`;
+}
+export class SourceSelector {
+    _current;
+    consecutiveReconnectFailures = 0;
+    lastSuccessfulConnectAt = null;
+    demotedAt = null;
+    rePromoteTimer = null;
+    elapsedTicker = null;
+    modeChangeCbs = [];
+    stopped = false;
+    initialWasSmee;
+    demoteAfterFailures;
+    demoteAfterMsWithoutSuccess;
+    rePromoteIntervalMs;
+    now;
+    stderr;
+    logger;
+    pendingRePromoteEmit = false;
+    constructor(options) {
+        this.initialWasSmee = options.initial === 'smee-attempt';
+        this.demoteAfterFailures =
+            options.demoteAfterConsecutiveFailures ?? DEFAULT_DEMOTE_AFTER_FAILURES;
+        this.demoteAfterMsWithoutSuccess =
+            options.demoteAfterMsWithoutSuccess ?? DEFAULT_DEMOTE_AFTER_MS_WITHOUT_SUCCESS;
+        this.rePromoteIntervalMs =
+            options.rePromoteIntervalMs ?? DEFAULT_RE_PROMOTE_INTERVAL_MS;
+        this.now = options.now ?? (() => Date.now());
+        this.stderr = options.stderr;
+        if (options.logger != null)
+            this.logger = options.logger;
+        this._current = options.initial;
+        const startupReason = options.initial === 'smee-attempt' ? 'startup-smee-selected' : 'startup-no-channel';
+        this.writeLine(this._current, startupReason);
+        if (this.initialWasSmee) {
+            this.elapsedTicker = setInterval(() => this.observeElapsed(), ELAPSED_TICKER_INTERVAL_MS);
+            if (typeof this.elapsedTicker.unref === 'function')
+                this.elapsedTicker.unref();
+        }
+    }
+    get currentSource() {
+        return this._current;
+    }
+    onModeChange(cb) {
+        this.modeChangeCbs.push(cb);
+    }
+    onReconnectAttempt(failedAttempts) {
+        if (this.stopped)
+            return;
+        this.consecutiveReconnectFailures = failedAttempts;
+        if (this._current !== 'smee-active' && this._current !== 'smee-attempt')
+            return;
+        if (failedAttempts >= this.demoteAfterFailures && this._current === 'smee-active') {
+            this.transition('poll-fallback', 'smee-runtime-lost');
+        }
+    }
+    onReconnectSuccess() {
+        if (this.stopped)
+            return;
+        this.consecutiveReconnectFailures = 0;
+        this.lastSuccessfulConnectAt = this.now();
+        if (this._current === 'smee-attempt') {
+            const shouldEmit = this.pendingRePromoteEmit;
+            this.pendingRePromoteEmit = false;
+            if (shouldEmit) {
+                this.transition('smee-active', 'smee-re-promoted');
+            }
+            else {
+                this._current = 'smee-active';
+                for (const cb of this.modeChangeCbs) {
+                    try {
+                        cb('smee-active', 'startup-smee-selected');
+                    }
+                    catch {
+                        /* callback errors are swallowed */
+                    }
+                }
+            }
+        }
+    }
+    observeElapsed() {
+        if (this.stopped)
+            return;
+        if (this._current !== 'smee-active')
+            return;
+        if (this.lastSuccessfulConnectAt == null)
+            return;
+        const elapsed = this.now() - this.lastSuccessfulConnectAt;
+        if (elapsed > this.demoteAfterMsWithoutSuccess) {
+            this.transition('poll-fallback', 'smee-runtime-lost');
+        }
+    }
+    stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        if (this.elapsedTicker != null) {
+            clearInterval(this.elapsedTicker);
+            this.elapsedTicker = null;
+        }
+        if (this.rePromoteTimer != null) {
+            clearInterval(this.rePromoteTimer);
+            this.rePromoteTimer = null;
+        }
+    }
+    transition(next, reason) {
+        if (this._current === next)
+            return;
+        const prev = this._current;
+        this._current = next;
+        if (next === 'poll-fallback') {
+            this.demotedAt = this.now();
+            if (this.initialWasSmee && this.rePromoteTimer == null) {
+                this.rePromoteTimer = setInterval(() => this.tickRePromote(), this.rePromoteIntervalMs);
+                if (typeof this.rePromoteTimer.unref === 'function')
+                    this.rePromoteTimer.unref();
+            }
+        }
+        else if (next === 'smee-attempt' && prev === 'poll-fallback') {
+            // moving out of poll-fallback via the re-promote timer
+            if (this.rePromoteTimer != null) {
+                clearInterval(this.rePromoteTimer);
+                this.rePromoteTimer = null;
+            }
+        }
+        for (const cb of this.modeChangeCbs) {
+            try {
+                cb(next, reason);
+            }
+            catch {
+                /* callback errors are swallowed */
+            }
+        }
+        this.writeLine(next, reason);
+    }
+    tickRePromote() {
+        if (this.stopped)
+            return;
+        if (this._current !== 'poll-fallback')
+            return;
+        // Silent transition to smee-attempt; the eventual line is emitted only if
+        // the reconnect succeeds (smee-re-promoted).
+        if (this.rePromoteTimer != null) {
+            clearInterval(this.rePromoteTimer);
+            this.rePromoteTimer = null;
+        }
+        this._current = 'smee-attempt';
+        this.pendingRePromoteEmit = true;
+        this.consecutiveReconnectFailures = 0;
+        this.demotedAt = null;
+        for (const cb of this.modeChangeCbs) {
+            try {
+                cb('smee-attempt', 'smee-re-promoted');
+            }
+            catch {
+                /* callback errors are swallowed */
+            }
+        }
+    }
+    writeLine(next, reason) {
+        try {
+            this.stderr.write(formatLine(next, reason));
+        }
+        catch {
+            /* stderr write failures are swallowed */
+        }
+    }
+}
+//# sourceMappingURL=source-selector.js.map

package/dist/cli/commands/cockpit/doorbell/source-selector.js.map

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

package/dist/cli/commands/cockpit/doorbell/sse-parser.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `parseSseEventBlock` — parses one SSE frame block from smee.io.
+ *
+ * Matches the inline parser in
+ * `packages/orchestrator/src/services/smee-receiver.ts`. Extracts the
+ * `x-github-event` and `body.action` discriminators plus the full body object,
+ * dropping `ready`/`ping` heartbeat frames silently. Malformed JSON → null.
+ */
+export interface NormalizedPayload {
+    githubEvent: string;
+    action: string;
+    body: Record<string, unknown>;
+}
+export declare function parseSseEventBlock(text: string): NormalizedPayload | null;
+//# sourceMappingURL=sse-parser.d.ts.map

package/dist/cli/commands/cockpit/doorbell/sse-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-parser.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/sse-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAoCzE"}

package/dist/cli/commands/cockpit/doorbell/sse-parser.js

@@ -0,0 +1,43 @@
+/**
+ * `parseSseEventBlock` — parses one SSE frame block from smee.io.
+ *
+ * Matches the inline parser in
+ * `packages/orchestrator/src/services/smee-receiver.ts`. Extracts the
+ * `x-github-event` and `body.action` discriminators plus the full body object,
+ * dropping `ready`/`ping` heartbeat frames silently. Malformed JSON → null.
+ */
+export function parseSseEventBlock(text) {
+    let eventType = '';
+    const dataLines = [];
+    for (const line of text.split('\n')) {
+        if (line.startsWith('event:')) {
+            eventType = line.slice(6).trim();
+        }
+        else if (line.startsWith('data:')) {
+            dataLines.push(line.slice(5).trim());
+        }
+    }
+    if (eventType !== 'message' && eventType !== '') {
+        return null;
+    }
+    const dataStr = dataLines.join('\n');
+    if (!dataStr)
+        return null;
+    let data;
+    try {
+        data = JSON.parse(dataStr);
+    }
+    catch {
+        return null;
+    }
+    const githubEvent = data['x-github-event'];
+    if (typeof githubEvent !== 'string' || githubEvent === '')
+        return null;
+    const rawBody = data['body'];
+    if (rawBody == null || typeof rawBody !== 'object')
+        return null;
+    const body = rawBody;
+    const action = typeof body['action'] === 'string' ? body['action'] : '';
+    return { githubEvent, action, body };
+}
+//# sourceMappingURL=sse-parser.js.map

package/dist/cli/commands/cockpit/doorbell/sse-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-parser.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/sse-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC3C,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChE,MAAM,IAAI,GAAG,OAAkC,CAAC;IAEhD,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpF,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/cli/commands/cockpit/doorbell/startup-retry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `runStartupRetry` — envelope around a Promise-returning startup task that
+ * survives transient failures and exits distinctively on permanent ones.
+ * Replaces the doorbell's silent `exit(2)` on first-hiccup failure.
+ *
+ * Contract: `specs/980-summary-978-shipped-working/contracts/startup-retry.md`.
+ */
+import type { RateLimitScheduler } from '@generacy-ai/cockpit';
+export type GhErrorClass = {
+    kind: 'retriable';
+    hint: string;
+} | {
+    kind: 'permanent';
+    reason: string;
+};
+export type StartupRetryLabel = 'acquireEpicBus' | 'resolveEpic';
+export interface StartupRetryOptions<T> {
+    task: () => Promise<T>;
+    label: StartupRetryLabel;
+    rateLimitScheduler: RateLimitScheduler;
+    abortSignal: AbortSignal;
+    stderr: {
+        write(chunk: string): boolean | void;
+    };
+    logger: {
+        warn: (msg: string) => void;
+        info?: (msg: string) => void;
+    };
+    now?: () => number;
+    sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+    classify?: (err: unknown) => GhErrorClass;
+    initialWindowMs?: number;
+    lateWindowIntervalMs?: number;
+}
+export type StartupRetryOutcome<T> = {
+    kind: 'success';
+    value: T;
+} | {
+    kind: 'permanent';
+    reason: string;
+} | {
+    kind: 'aborted';
+};
+/**
+ * Deterministic mapping from a raw `gh`-call error to `GhErrorClass`.
+ *
+ * Retriable rules are evaluated first (node error codes → socket-hang-up →
+ * HTTP 429/5xx). Permanent rules follow (401/Bad credentials → 403 SAML/
+ * scope → 404 not-found → JSON-parse failure). Default: permanent/unknown.
+ *
+ * See `contracts/startup-retry.md § Error classifier` for full rationale.
+ */
+export declare function classifyGhError(err: unknown): GhErrorClass;
+export declare function runStartupRetry<T>(opts: StartupRetryOptions<T>): Promise<StartupRetryOutcome<T>>;
+//# sourceMappingURL=startup-retry.d.ts.map

package/dist/cli/commands/cockpit/doorbell/startup-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-retry.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/startup-retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEjE,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IACjD,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACtE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,YAAY,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAyBxB;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAyD1D;AAoBD,wBAAsB,eAAe,CAAC,CAAC,EACrC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAqFjC"}

package/dist/cli/commands/cockpit/doorbell/startup-retry.js

@@ -0,0 +1,159 @@
+const DEFAULT_INITIAL_WINDOW_MS = 2 * 60_000;
+const DEFAULT_LATE_WINDOW_INTERVAL_MS = 5 * 60_000;
+function errMessage(err) {
+    if (err == null)
+        return '';
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+function errCode(err) {
+    if (err == null || typeof err !== 'object')
+        return undefined;
+    const code = err.code;
+    return typeof code === 'string' ? code : undefined;
+}
+const RETRIABLE_NODE_CODES = new Set([
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'ENOTFOUND',
+    'ECONNREFUSED',
+    'EPIPE',
+]);
+/**
+ * Deterministic mapping from a raw `gh`-call error to `GhErrorClass`.
+ *
+ * Retriable rules are evaluated first (node error codes → socket-hang-up →
+ * HTTP 429/5xx). Permanent rules follow (401/Bad credentials → 403 SAML/
+ * scope → 404 not-found → JSON-parse failure). Default: permanent/unknown.
+ *
+ * See `contracts/startup-retry.md § Error classifier` for full rationale.
+ */
+export function classifyGhError(err) {
+    const message = errMessage(err);
+    const code = errCode(err);
+    // Retriable: node error codes.
+    if (code != null && RETRIABLE_NODE_CODES.has(code)) {
+        return { kind: 'retriable', hint: code.toLowerCase() };
+    }
+    // Retriable: socket hang up.
+    if (/socket hang up/i.test(message)) {
+        return { kind: 'retriable', hint: 'socket-hang-up' };
+    }
+    // Retriable: HTTP 429 / 5xx.
+    const retriableHttp = message.match(/\bHTTP\s+(429|500|502|503|504)\b/);
+    if (retriableHttp) {
+        return { kind: 'retriable', hint: `http-${retriableHttp[1]}` };
+    }
+    // Retriable: GitHub primary/secondary rate limits. These do NOT reliably
+    // surface as "HTTP 429" — the GraphQL primary limit arrives as plain text
+    // ("API rate limit exceeded" / "...rate limit already exceeded...") with no
+    // HTTP status, and the secondary/abuse limit arrives as HTTP 403. They MUST
+    // be matched here, before the permanent 401/403 rules below, or a
+    // rate-limited `gh` call is misclassified as permanent and the doorbell
+    // exit(3)s instead of retrying — the exact failure this envelope exists to
+    // prevent, since rate-limiting is the dominant transient `gh` failure.
+    if (/rate limit (?:already )?exceeded/i.test(message) ||
+        /secondary rate limit/i.test(message) ||
+        /abuse detection/i.test(message)) {
+        return { kind: 'retriable', hint: 'rate-limit' };
+    }
+    // Permanent: 401 / Bad credentials.
+    if (/\bHTTP\s+401\b/.test(message) || /Bad credentials/i.test(message)) {
+        return { kind: 'permanent', reason: 'bad-credentials' };
+    }
+    // Permanent: 403 / SAML / scope.
+    if (/\bHTTP\s+403\b/.test(message) ||
+        /SAML|scope|not accessible by/i.test(message)) {
+        return { kind: 'permanent', reason: 'scope-or-sso' };
+    }
+    // Permanent: 404 / not-found.
+    if (/\bHTTP\s+404\b/.test(message) ||
+        /Could not resolve to (an Issue|a Repository)/i.test(message)) {
+        return { kind: 'permanent', reason: 'not-found' };
+    }
+    // Permanent: malformed output.
+    if (/parsing|expected JSON|invalid character/i.test(message)) {
+        return { kind: 'permanent', reason: 'malformed-output' };
+    }
+    return { kind: 'permanent', reason: 'unknown' };
+}
+function defaultSleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+export async function runStartupRetry(opts) {
+    const { task, label, rateLimitScheduler, abortSignal, stderr, logger, now = () => Date.now(), sleep = defaultSleep, classify = classifyGhError, initialWindowMs = DEFAULT_INITIAL_WINDOW_MS, lateWindowIntervalMs = DEFAULT_LATE_WINDOW_INTERVAL_MS, } = opts;
+    const startedAt = now();
+    let attempt = 0;
+    let firstRetriableEmitted = false;
+    let phase = 'initial';
+    let recoveredFromLate = false;
+    for (;;) {
+        if (abortSignal.aborted)
+            return { kind: 'aborted' };
+        attempt += 1;
+        try {
+            const value = await task();
+            if (recoveredFromLate) {
+                stderr.write(`cockpit doorbell: startup-retry-recovered label=${label}\n`);
+            }
+            return { kind: 'success', value };
+        }
+        catch (err) {
+            const cls = classify(err);
+            if (cls.kind === 'permanent') {
+                stderr.write(`cockpit doorbell: permanent-error label=${label} reason=${cls.reason}\n`);
+                return { kind: 'permanent', reason: cls.reason };
+            }
+            // Retriable branch.
+            if (phase === 'initial') {
+                if (!firstRetriableEmitted) {
+                    stderr.write(`cockpit doorbell: startup-retry label=${label} reason=${cls.hint} attempt=${attempt}\n`);
+                    firstRetriableEmitted = true;
+                }
+                else {
+                    logger.info?.(`cockpit doorbell: startup-retry label=${label} reason=${cls.hint} attempt=${attempt}`);
+                }
+            }
+            else {
+                logger.info?.(`cockpit doorbell: startup-retry-late label=${label} reason=${cls.hint} attempt=${attempt}`);
+            }
+            if (phase === 'initial' && now() - startedAt >= initialWindowMs) {
+                stderr.write(`cockpit doorbell: startup-retry-exhausted label=${label} transitioning to late-startup retry\n`);
+                phase = 'late';
+                recoveredFromLate = true;
+            }
+            const sleepMs = phase === 'initial'
+                ? rateLimitScheduler.getCurrentIntervalMs()
+                : lateWindowIntervalMs;
+            await sleep(sleepMs, abortSignal);
+            if (abortSignal.aborted)
+                return { kind: 'aborted' };
+            // Best-effort hook so the scheduler's watermark logic advances between
+            // attempts. Failures are swallowed — the scheduler is defensive.
+            if (phase === 'initial') {
+                try {
+                    rateLimitScheduler.noteResponseHeaders({});
+                }
+                catch {
+                    /* best-effort */
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=startup-retry.js.map

package/dist/cli/commands/cockpit/doorbell/startup-retry.js.map

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

package/dist/cli/commands/cockpit/doorbell/subscribe.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `subscribeAndEmit` — drives a `bus.waitFor` loop and writes one stdout line
+ * per emitted event to the caller-supplied stdout target. Pure translator
+ * lives in `lineForEvent`.
+ *
+ * Contract: `contracts/subscribe-and-emit.md`.
+ */
+import type { EpicEventBus } from '../mcp/event-bus.js';
+import type { CockpitStreamEvent } from '../watch/stream-event.js';
+export interface SubscribeEmitOptions {
+    stdout: {
+        write(chunk: string, cb?: () => void): boolean | void;
+    };
+    onEmit?: (event: CockpitStreamEvent) => void;
+}
+export type SubscribeUnsubscribe = () => void;
+export declare function lineForEvent(event: CockpitStreamEvent): string;
+export declare function subscribeAndEmit(bus: EpicEventBus, options: SubscribeEmitOptions): SubscribeUnsubscribe;
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/cli/commands/cockpit/doorbell/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/subscribe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAClE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC;AAM9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE9D;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,oBAAoB,GAC5B,oBAAoB,CA6CtB"}

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

@@ -0,0 +1,54 @@
+const WAIT_MS = 60_000;
+const COALESCE_WINDOW_MS = 0;
+const MAX_BATCH_SIZE = 100;
+export function lineForEvent(event) {
+    return `${event.type}\n`;
+}
+export function subscribeAndEmit(bus, options) {
+    let stopped = false;
+    let resolveStop = null;
+    const stopSignal = new Promise((resolve) => {
+        resolveStop = resolve;
+    });
+    const loop = async () => {
+        let sinceCursor = 0;
+        while (!stopped) {
+            const waitPromise = bus.waitFor({
+                sinceCursor,
+                maxWaitMs: WAIT_MS,
+                coalesceWindowMs: COALESCE_WINDOW_MS,
+                maxBatchSize: MAX_BATCH_SIZE,
+            });
+            const result = await Promise.race([
+                waitPromise.then((r) => ({ kind: 'entries', r })),
+                stopSignal.then(() => ({ kind: 'stopped' })),
+            ]);
+            if (result.kind === 'stopped')
+                return;
+            if (stopped)
+                return;
+            for (const entry of result.r.entries) {
+                if (stopped)
+                    return;
+                const line = lineForEvent(entry.event);
+                await new Promise((resolve) => {
+                    options.stdout.write(line, () => resolve());
+                });
+                sinceCursor = entry.cursor;
+                options.onEmit?.(entry.event);
+            }
+        }
+    };
+    void loop();
+    return () => {
+        if (stopped)
+            return;
+        stopped = true;
+        if (resolveStop != null) {
+            const r = resolveStop;
+            resolveStop = null;
+            r();
+        }
+    };
+}
+//# sourceMappingURL=subscribe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/subscribe.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,GAAG,MAAM,CAAC;AACvB,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,GAAiB,EACjB,OAA6B;IAE7B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,WAAW,GAAwB,IAAI,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC/C,WAAW,GAAG,OAAO,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,OAAO,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;gBAC9B,WAAW;gBACX,SAAS,EAAE,OAAO;gBAClB,gBAAgB,EAAE,kBAAkB;gBACpC,YAAY,EAAE,cAAc;aAC7B,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC1D,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,CAAC;aACtD,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBACrC,IAAI,OAAO;oBAAE,OAAO;gBACpB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACvC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;gBACH,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,EAAE,CAAC;IAEZ,OAAO,GAAG,EAAE;QACV,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,WAAW,CAAC;YACtB,WAAW,GAAG,IAAI,CAAC;YACnB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/cli/commands/cockpit/doorbell/webhook-to-event.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `webhookToStreamEvent` — pure Q1=A mapping. Takes a normalized
+ * `{ githubEvent, action, body }` triple, the epic's ref-set filter, and
+ * returns one `CockpitStreamEvent` per matched ref (or null when the payload
+ * is out of scope).
+ *
+ * Contract: `specs/978-summary-generacy-cockpit/contracts/webhook-to-event-mapping.md`.
+ *
+ * Reuses `CockpitEventSchema` from `../watch/emit.ts` — does NOT extend the
+ * enum. `from`/`to` are best-effort null (see contract § "Emitted shape").
+ */
+import type { CockpitEventValidated } from '../watch/emit.js';
+export interface RefSetView {
+    epicRef: string;
+    epicNumber: number;
+    epicRepo: string;
+    issues: Set<string>;
+    prs: Set<string>;
+    watchedRepos: Set<string>;
+}
+/**
+ * Q1=A mapping. Returns exactly one `CockpitEventValidated` for `issues.*` and
+ * `pull_request.*` matches, or one per matched PR for `check_run.completed` /
+ * `check_suite.completed`. Callers that want single-event semantics should
+ * take the first element.
+ */
+export declare function webhookToStreamEvent(githubEvent: string, action: string, body: Record<string, unknown>, refSet: RefSetView, now: () => string): CockpitEventValidated | CockpitEventValidated[] | null;
+//# sourceMappingURL=webhook-to-event.d.ts.map

package/dist/cli/commands/cockpit/doorbell/webhook-to-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-to-event.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/webhook-to-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAiHD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,MAAM,GAChB,qBAAqB,GAAG,qBAAqB,EAAE,GAAG,IAAI,CAyExD"}