@generacy-ai/generacy 0.3.3 → 0.4.0

package/dist/cli/commands/cockpit/manual-advance-marker.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `formatManualAdvanceComment` — renders the structured issue comment posted
+ * by `cockpit advance` per AD-1 / D-R5.
+ *
+ * Inputs are regex-validated before interpolation so a malformed `gate`,
+ * `actor`, or `ts` cannot inject HTML/markdown into the marker body.
+ *
+ * `actor` is optional: when `undefined` or empty, the `actor=` attribute is
+ * omitted from the HTML comment and the ` by **@<actor>**` clause is dropped
+ * from the sentence (contract: FR-003, `contracts/manual-advance-marker.md`).
+ */
+export interface ManualAdvanceMarker {
+    gate: string;
+    actor?: string;
+    ts: string;
+}
+export declare function formatManualAdvanceComment(marker: ManualAdvanceMarker): string;
+//# sourceMappingURL=manual-advance-marker.d.ts.map

package/dist/cli/commands/cockpit/manual-advance-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-advance-marker.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/manual-advance-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAW9E"}

package/dist/cli/commands/cockpit/manual-advance-marker.js

@@ -0,0 +1,43 @@
+/**
+ * `formatManualAdvanceComment` — renders the structured issue comment posted
+ * by `cockpit advance` per AD-1 / D-R5.
+ *
+ * Inputs are regex-validated before interpolation so a malformed `gate`,
+ * `actor`, or `ts` cannot inject HTML/markdown into the marker body.
+ *
+ * `actor` is optional: when `undefined` or empty, the `actor=` attribute is
+ * omitted from the HTML comment and the ` by **@<actor>**` clause is dropped
+ * from the sentence (contract: FR-003, `contracts/manual-advance-marker.md`).
+ */
+const GATE_REGEX = /^[a-z][a-z0-9-]*$/;
+const ACTOR_REGEX = /^[A-Za-z0-9-]+$/;
+export function formatManualAdvanceComment(marker) {
+    validate(marker);
+    const { gate, actor, ts } = marker;
+    const hasActor = typeof actor === 'string' && actor.length > 0;
+    const commentPrelude = hasActor
+        ? `<!-- generacy-cockpit:manual-advance gate=${gate} actor=${actor} ts=${ts} -->`
+        : `<!-- generacy-cockpit:manual-advance gate=${gate} ts=${ts} -->`;
+    const sentence = hasActor
+        ? `Marked \`completed:${gate}\` by **@${actor}** — \`waiting-for:${gate}\` left in place for the worker to clear on resume.`
+        : `Marked \`completed:${gate}\` — \`waiting-for:${gate}\` left in place for the worker to clear on resume.`;
+    return `${commentPrelude}\n\n${sentence}`;
+}
+function validate(marker) {
+    if (!GATE_REGEX.test(marker.gate)) {
+        throw new Error(`formatManualAdvanceComment: invalid gate name "${marker.gate}"`);
+    }
+    if (typeof marker.actor === 'string' && marker.actor.length > 0) {
+        if (!ACTOR_REGEX.test(marker.actor)) {
+            throw new Error(`formatManualAdvanceComment: invalid actor login "${marker.actor}"`);
+        }
+    }
+    if (typeof marker.ts !== 'string' || marker.ts === '') {
+        throw new Error('formatManualAdvanceComment: ts must be a non-empty ISO-8601 string');
+    }
+    const parsed = new Date(marker.ts);
+    if (Number.isNaN(parsed.getTime()) || parsed.toISOString() !== marker.ts) {
+        throw new Error(`formatManualAdvanceComment: ts "${marker.ts}" is not round-trip ISO-8601`);
+    }
+}
+//# sourceMappingURL=manual-advance-marker.js.map

package/dist/cli/commands/cockpit/manual-advance-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-advance-marker.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/manual-advance-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,UAAU,GAAG,mBAAmB,CAAC;AACvC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAQtC,MAAM,UAAU,0BAA0B,CAAC,MAA2B;IACpE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,QAAQ;QAC7B,CAAC,CAAC,6CAA6C,IAAI,UAAU,KAAK,OAAO,EAAE,MAAM;QACjF,CAAC,CAAC,6CAA6C,IAAI,OAAO,EAAE,MAAM,CAAC;IACrE,MAAM,QAAQ,GAAG,QAAQ;QACvB,CAAC,CAAC,sBAAsB,IAAI,YAAY,KAAK,sBAAsB,IAAI,qDAAqD;QAC5H,CAAC,CAAC,sBAAsB,IAAI,sBAAsB,IAAI,qDAAqD,CAAC;IAC9G,OAAO,GAAG,cAAc,OAAO,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CAAC,MAA2B;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,kDAAkD,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,oDAAoD,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,EAAE,8BAA8B,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Typed error results for the cockpit MCP tool boundary.
+ *
+ * Every tool returns `ToolResult<T>` — either `ToolOkResult<T>` (status: 'ok')
+ * or `ToolErrorResult` (status: 'error'). Bare thrown exceptions never reach
+ * the JSON-RPC transport; `wrapToolBoundary` converts them into an
+ * `internal`-class error result.
+ *
+ * `mapCockpitExitToToolError` translates the `CockpitExit` codes used by the
+ * CLI verbs (1 = transport, 2 = argument/parse, 3 = gate refusal) into
+ * discriminated tool-error classes.
+ */
+import { type CockpitExit } from '../exit.js';
+export type ErrorClass = 'invalid-args' | 'wrong-kind' | 'unknown-gate' | 'not-an-epic' | 'gate-refusal' | 'transport' | 'invalid-cursor' | 'not-worker' | 'internal';
+export interface ToolOkResult<T> {
+    status: 'ok';
+    data: T;
+}
+export interface ToolErrorResult {
+    status: 'error';
+    class: ErrorClass;
+    detail: string;
+    hint?: string;
+}
+export type ToolResult<T> = ToolOkResult<T> | ToolErrorResult;
+/** Map a `CockpitExit` from the CLI verb into a typed tool-error result. */
+export declare function mapCockpitExitToToolError(exit: CockpitExit): ToolErrorResult;
+/**
+ * Wrap a tool handler so that any thrown Error (including `CockpitExit`)
+ * becomes a typed `ToolErrorResult`. The MCP transport never sees an
+ * uncaught throw from a wrapped handler.
+ */
+export declare function wrapToolBoundary<T>(fn: () => Promise<ToolResult<T>>): Promise<ToolResult<T>>;
+/**
+ * #928 — Envelope-mapping helper.
+ *
+ * Translates the CLI verb's `RunMergeResult` (`{ exitCode, stdout }`) into the
+ * MCP `ToolResult<T>` envelope. THIS TABLE IS THE TRANSPORT CONTRACT (Q4 → B):
+ * any new `reason` string introduced in `runMerge` must appear here, or fall
+ * through to `class: 'invalid-args'` (which is loud enough for tests to catch).
+ *
+ * Mapping (see data-model.md §toMcpResult):
+ *   exit=0 → ok, data: parsed
+ *   exit=2 + reason='pr-number'          → wrong-kind (with `hint`)
+ *   exit=2 + reason∈{unresolved, ambiguous-resolution, pr-is-draft, checks-failing}
+ *                                         → gate-refusal
+ *   exit=2 + other/missing reason        → invalid-args
+ *   exit=3                               → gate-refusal
+ *   exit=1                               → transport
+ *   exit≥4                               → internal
+ *   non-JSON stdout                      → internal
+ */
+export declare function toMcpResult<T>(cliJsonStdout: string, exitCode: number): ToolResult<T>;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,YAAY,GACZ,cAAc,GACd,aAAa,GACb,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,YAAY,GACZ,UAAU,CAAC;AAEf,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC;AAE9D,4EAA4E;AAC5E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAY5E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAUxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,UAAU,CAAC,CAAC,CAAC,CA8Ff"}

package/dist/cli/commands/cockpit/mcp/errors.js

@@ -0,0 +1,190 @@
+/**
+ * Typed error results for the cockpit MCP tool boundary.
+ *
+ * Every tool returns `ToolResult<T>` — either `ToolOkResult<T>` (status: 'ok')
+ * or `ToolErrorResult` (status: 'error'). Bare thrown exceptions never reach
+ * the JSON-RPC transport; `wrapToolBoundary` converts them into an
+ * `internal`-class error result.
+ *
+ * `mapCockpitExitToToolError` translates the `CockpitExit` codes used by the
+ * CLI verbs (1 = transport, 2 = argument/parse, 3 = gate refusal) into
+ * discriminated tool-error classes.
+ */
+import { isCockpitExit } from '../exit.js';
+/** Map a `CockpitExit` from the CLI verb into a typed tool-error result. */
+export function mapCockpitExitToToolError(exit) {
+    const detail = exit.message;
+    switch (exit.code) {
+        case 1:
+            return { status: 'error', class: 'transport', detail };
+        case 2:
+            return { status: 'error', class: 'invalid-args', detail };
+        case 3:
+            return { status: 'error', class: 'gate-refusal', detail };
+        default:
+            return { status: 'error', class: 'internal', detail };
+    }
+}
+/**
+ * Wrap a tool handler so that any thrown Error (including `CockpitExit`)
+ * becomes a typed `ToolErrorResult`. The MCP transport never sees an
+ * uncaught throw from a wrapped handler.
+ */
+export async function wrapToolBoundary(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (isCockpitExit(err)) {
+            return mapCockpitExitToToolError(err);
+        }
+        const detail = err instanceof Error ? err.message : String(err);
+        return { status: 'error', class: 'internal', detail };
+    }
+}
+/**
+ * #928 — Envelope-mapping helper.
+ *
+ * Translates the CLI verb's `RunMergeResult` (`{ exitCode, stdout }`) into the
+ * MCP `ToolResult<T>` envelope. THIS TABLE IS THE TRANSPORT CONTRACT (Q4 → B):
+ * any new `reason` string introduced in `runMerge` must appear here, or fall
+ * through to `class: 'invalid-args'` (which is loud enough for tests to catch).
+ *
+ * Mapping (see data-model.md §toMcpResult):
+ *   exit=0 → ok, data: parsed
+ *   exit=2 + reason='pr-number'          → wrong-kind (with `hint`)
+ *   exit=2 + reason∈{unresolved, ambiguous-resolution, pr-is-draft, checks-failing}
+ *                                         → gate-refusal
+ *   exit=2 + other/missing reason        → invalid-args
+ *   exit=3                               → gate-refusal
+ *   exit=1                               → transport
+ *   exit≥4                               → internal
+ *   non-JSON stdout                      → internal
+ */
+export function toMcpResult(cliJsonStdout, exitCode) {
+    let parsed = null;
+    let parseFailed = false;
+    try {
+        parsed = cliJsonStdout.trim().length === 0 ? null : JSON.parse(cliJsonStdout);
+    }
+    catch {
+        parseFailed = true;
+    }
+    if (exitCode === 0) {
+        if (parseFailed) {
+            return {
+                status: 'error',
+                class: 'internal',
+                detail: 'CLI produced non-JSON stdout on success exit',
+            };
+        }
+        return { status: 'ok', data: parsed };
+    }
+    const detailFallback = firstLineOr(cliJsonStdout, 'CLI reported an error');
+    if (exitCode === 1) {
+        // Legacy: several cockpit verbs (notably `runMerge`) still use exit-1
+        // for resolver-driven gate refusals. Distinguish by the presence of a
+        // red-payload JSON with a known refusal `reason` — that's a gate
+        // refusal, not a transport error.
+        if (!parseFailed) {
+            const reason = extractString(parsed, 'reason');
+            if (reason !== null && isKnownGateRefusalReason(reason)) {
+                return {
+                    status: 'error',
+                    class: 'gate-refusal',
+                    detail: describeGateRefusal(parsed, reason),
+                };
+            }
+        }
+        return { status: 'error', class: 'transport', detail: detailFallback };
+    }
+    if (exitCode === 2) {
+        if (parseFailed) {
+            return {
+                status: 'error',
+                class: 'internal',
+                detail: 'CLI produced non-JSON stdout on error exit',
+            };
+        }
+        const reason = extractString(parsed, 'reason');
+        if (reason === 'pr-number') {
+            const hint = extractString(parsed, 'hint') ?? undefined;
+            const err = {
+                status: 'error',
+                class: 'wrong-kind',
+                detail: hint ?? `input is a pull request; pass the issue number`,
+            };
+            if (hint !== undefined)
+                err.hint = hint;
+            return err;
+        }
+        if (reason === 'unresolved' ||
+            reason === 'ambiguous-resolution' ||
+            reason === 'pr-is-draft' ||
+            reason === 'checks-failing' ||
+            reason === 'missing-label' ||
+            reason === 'pr-flag-linkage-refused' ||
+            reason === 'pr-flag-closed-unmerged') {
+            return {
+                status: 'error',
+                class: 'gate-refusal',
+                detail: describeGateRefusal(parsed, reason),
+            };
+        }
+        return {
+            status: 'error',
+            class: 'invalid-args',
+            detail: describeInvalidArgs(parsed, detailFallback),
+        };
+    }
+    if (exitCode === 3) {
+        if (parseFailed) {
+            return { status: 'error', class: 'gate-refusal', detail: detailFallback };
+        }
+        const reason = extractString(parsed, 'reason');
+        return {
+            status: 'error',
+            class: 'gate-refusal',
+            detail: reason !== null ? describeGateRefusal(parsed, reason) : detailFallback,
+        };
+    }
+    return { status: 'error', class: 'internal', detail: detailFallback };
+}
+function firstLineOr(stdout, fallback) {
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0)
+        return fallback;
+    const first = trimmed.split('\n')[0];
+    return first != null && first.length > 0 ? first : fallback;
+}
+function extractString(raw, field) {
+    if (raw == null || typeof raw !== 'object')
+        return null;
+    const value = raw[field];
+    return typeof value === 'string' ? value : null;
+}
+function describeGateRefusal(raw, reason) {
+    const message = extractString(raw, 'message');
+    if (message !== null)
+        return message;
+    return reason;
+}
+function isKnownGateRefusalReason(reason) {
+    return (reason === 'unresolved' ||
+        reason === 'ambiguous-resolution' ||
+        reason === 'pr-is-draft' ||
+        reason === 'checks-failing' ||
+        reason === 'missing-label' ||
+        reason === 'pr-flag-linkage-refused' ||
+        reason === 'pr-flag-closed-unmerged');
+}
+function describeInvalidArgs(raw, fallback) {
+    const detail = extractString(raw, 'detail');
+    if (detail !== null)
+        return detail;
+    const message = extractString(raw, 'message');
+    if (message !== null)
+        return message;
+    return fallback;
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/commands/cockpit/mcp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AA2B7D,4EAA4E;AAC5E,MAAM,UAAU,yBAAyB,CAAC,IAAiB;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;IAC5B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC;YACJ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QACzD,KAAK,CAAC;YACJ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;QAC5D,KAAK,CAAC;YACJ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;QAC5D;YACE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAgC;IAEhC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACxD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CACzB,aAAqB,EACrB,QAAgB;IAEhB,IAAI,MAAM,GAAY,IAAI,CAAC;IAC3B,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,8CAA8C;aACvD,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAW,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,cAAc,GAAG,WAAW,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC;IAE3E,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,sEAAsE;QACtE,sEAAsE;QACtE,iEAAiE;QACjE,kCAAkC;QAClC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,IAAI,MAAM,KAAK,IAAI,IAAI,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxD,OAAO;oBACL,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,cAAc;oBACrB,MAAM,EAAE,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC;iBAC5C,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzE,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,4CAA4C;aACrD,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC;YACxD,MAAM,GAAG,GAAoB;gBAC3B,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,YAAY;gBACnB,MAAM,EAAE,IAAI,IAAI,gDAAgD;aACjE,CAAC;YACF,IAAI,IAAI,KAAK,SAAS;gBAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YACxC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IACE,MAAM,KAAK,YAAY;YACvB,MAAM,KAAK,sBAAsB;YACjC,MAAM,KAAK,aAAa;YACxB,MAAM,KAAK,gBAAgB;YAC3B,MAAM,KAAK,eAAe;YAC1B,MAAM,KAAK,yBAAyB;YACpC,MAAM,KAAK,yBAAyB,EACpC,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,cAAc;gBACrB,MAAM,EAAE,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC;aAC5C,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAC5E,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/C,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc;SAC/E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,QAAgB;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,GAAY,EAAE,KAAa;IAChD,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,KAAK,GAAI,GAA+B,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAY,EAAE,MAAc;IACvD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAc;IAC9C,OAAO,CACL,MAAM,KAAK,YAAY;QACvB,MAAM,KAAK,sBAAsB;QACjC,MAAM,KAAK,aAAa;QACxB,MAAM,KAAK,gBAAgB;QAC3B,MAAM,KAAK,eAAe;QAC1B,MAAM,KAAK,yBAAyB;QACpC,MAAM,KAAK,yBAAyB,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAY,EAAE,QAAgB;IACzD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * 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 { type CommandRunner, type GhWrapper } from '@generacy-ai/cockpit';
+import { EpicEventBus } from './event-bus.js';
+export interface AcquireOptions {
+    epicRef: string;
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+    intervalMs?: number;
+    logger?: {
+        warn: (msg: string) => void;
+        info?: (msg: string) => void;
+    };
+    /**
+     * Injection seam for tests: build an event bus without starting a poll
+     * loop. Callers use the returned bus's `emit()` directly.
+     */
+    noPoll?: boolean;
+    /** Test seam: wall-clock provider (drives `lastActiveAt`). */
+    now?: () => number;
+    /** Test seam: override the idle-TTL for this and subsequent acquires. */
+    idleTtlMs?: number;
+    /** Test seam: override the LRU soft cap for this and subsequent acquires. */
+    maxBuses?: number;
+    /**
+     * Test seam: replace the entire poll cycle (resolveEpic + runOnePoll +
+     * computeAggregateEvents). Called from both the poll loop and
+     * `catchUpPoll()`. Used to drive between-call event emission
+     * deterministically in unit tests.
+     */
+    runCycle?: (bus: EpicEventBus) => Promise<void>;
+}
+export interface Acquired {
+    bus: EpicEventBus;
+    release: () => void;
+}
+export declare function acquireEpicBus(options: AcquireOptions): Promise<Acquired>;
+/**
+ * Test-only: forcibly release all subscriptions. Use in test `afterEach`.
+ */
+export declare function _resetRegistryForTests(): void;
+//# sourceMappingURL=event-bus-registry.d.ts.map

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

@@ -0,0 +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"}