@generacy-ai/generacy 0.3.4 → 0.4.0

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

@@ -0,0 +1,62 @@
+/**
+ * Build the `@modelcontextprotocol/sdk` MCP server exposing the seven cockpit
+ * tools over stdio. Tools call the same internal `run<Verb>()` functions the
+ * CLI uses (spec § Design invariant #1).
+ *
+ * Each handler returns `ToolResult<T>` — either `{status:"ok", data}` or
+ * `{status:"error", class, detail}`. That envelope is serialized as
+ * `structuredContent` so callers can dispatch on `status` without parsing
+ * text.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { cockpitStatus } from './tools/cockpit_status.js';
+import { cockpitContext } from './tools/cockpit_context.js';
+import { cockpitAdvance } from './tools/cockpit_advance.js';
+import { cockpitResume } from './tools/cockpit_resume.js';
+import { cockpitQueue } from './tools/cockpit_queue.js';
+import { cockpitMerge } from './tools/cockpit_merge.js';
+import { cockpitAwaitEvents } from './tools/cockpit_await_events.js';
+import { CockpitStatusInputSchema, CockpitContextInputSchema, CockpitAdvanceInputSchema, CockpitResumeInputSchema, CockpitQueueInputSchema, CockpitMergeInputSchema, AwaitEventsInputSchema, } from './schemas.js';
+function toCallToolResult(result) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+        structuredContent: result,
+        isError: result.status === 'error',
+    };
+}
+export function buildMcpServer(deps = {}) {
+    const server = new McpServer({
+        name: 'cockpit',
+        version: '1.0.0',
+    });
+    server.registerTool('cockpit_status', {
+        description: "Print a one-shot snapshot of every ref in the epic body's phases. Read-only.",
+        inputSchema: CockpitStatusInputSchema,
+    }, async (args) => toCallToolResult(await cockpitStatus(args, deps)));
+    server.registerTool('cockpit_context', {
+        description: 'Classify the current waiting-for:* gate for one issue and emit its bundle.',
+        inputSchema: CockpitContextInputSchema,
+    }, async (args) => toCallToolResult(await cockpitContext(args, deps)));
+    server.registerTool('cockpit_advance', {
+        description: 'Manually flip waiting-for:<gate> → completed:<gate> on one issue. Posts an audit comment.',
+        inputSchema: CockpitAdvanceInputSchema,
+    }, async (args) => toCallToolResult(await cockpitAdvance(args, deps)));
+    server.registerTool('cockpit_resume', {
+        description: 'Re-arm a failed phase in place: clears failed:<phase>/agent:error, applies waiting-for/completed pair for the preceding gate.',
+        inputSchema: CockpitResumeInputSchema,
+    }, async (args) => toCallToolResult(await cockpitResume(args, deps)));
+    server.registerTool('cockpit_queue', {
+        description: 'Enqueue eligible refs under a phase heading to the cluster pipeline (unconfirmed — no interactive prompt).',
+        inputSchema: CockpitQueueInputSchema,
+    }, async (args) => toCallToolResult(await cockpitQueue(args, deps)));
+    server.registerTool('cockpit_merge', {
+        description: 'Merge a PR once its required checks are green. Never merges on red.',
+        inputSchema: CockpitMergeInputSchema,
+    }, async (args) => toCallToolResult(await cockpitMerge(args, deps)));
+    server.registerTool('cockpit_await_events', {
+        description: 'Long-poll for cockpit stream events (label changes, phase transitions, epic-complete). Returns a coalesced batch; caller re-arms with the returned cursor.',
+        inputSchema: AwaitEventsInputSchema,
+    }, async (args) => toCallToolResult(await cockpitAwaitEvents(args, deps)));
+    return server;
+}
+//# sourceMappingURL=server.js.map

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

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

package/dist/cli/commands/cockpit/mcp/tools/cockpit_advance.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `cockpit_advance` MCP tool handler.
+ *
+ * Wraps `runAdvance` (which throws `CockpitExit` on refusal / parse error /
+ * transport failure). `wrapToolBoundary` maps thrown `CockpitExit` to a
+ * typed `ToolErrorResult` via the exit-code table.
+ *
+ * Idempotent no-op (advance.ts:122-127): when `completed:<gate>` already
+ * present, `runAdvance` returns without throwing but writes a stdout line
+ * that starts with "already advanced". Represent this as
+ * `{status: "ok", data: {..., noop: true, action: "already-advanced"}}`.
+ */
+import type { CommandRunner, GhWrapper } from '@generacy-ai/cockpit';
+import { type AdvanceCommandDeps } from '../../advance.js';
+import { type ToolResult } from '../errors.js';
+import { type IssueRefInput, type GateNameInput } from '../schemas.js';
+export interface CockpitAdvanceInput {
+    issue: IssueRefInput;
+    gate: GateNameInput;
+}
+export interface CockpitAdvanceData {
+    ref: {
+        owner: string;
+        repo: string;
+        number: number;
+        nwo: string;
+    };
+    gate: string;
+    action: 'advanced' | 'already-advanced';
+    completedLabel: string;
+    commentUrl?: string;
+    noop?: true;
+}
+export interface CockpitAdvanceDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+    loadConfig?: AdvanceCommandDeps['loadConfig'];
+    env?: NodeJS.ProcessEnv;
+    now?: () => Date;
+}
+export declare function cockpitAdvance(input: CockpitAdvanceInput, deps?: CockpitAdvanceDeps): Promise<ToolResult<CockpitAdvanceData>>;
+//# sourceMappingURL=cockpit_advance.d.ts.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_advance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit_advance.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/cockpit/mcp/tools/cockpit_advance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,kBAAkB,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,UAAU,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,EAC1B,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CA0EzC"}

package/dist/cli/commands/cockpit/mcp/tools/cockpit_advance.js

@@ -0,0 +1,73 @@
+import { runAdvance } from '../../advance.js';
+import { normalizeIssueRef } from '../ref-input.js';
+import { GATES } from '../../gate-vocabulary.js';
+import { wrapToolBoundary } from '../errors.js';
+import { CockpitAdvanceInputSchema, } from '../schemas.js';
+export function cockpitAdvance(input, deps = {}) {
+    return wrapToolBoundary(async () => {
+        const parsed = CockpitAdvanceInputSchema.safeParse(input);
+        if (!parsed.success) {
+            const detail = parsed.error.issues.map((i) => i.message).join('; ');
+            const cls = /Invalid enum value|invalid_enum_value/i.test(detail)
+                ? 'unknown-gate'
+                : 'invalid-args';
+            return { status: 'error', class: cls, detail };
+        }
+        const normalized = await normalizeIssueRef(parsed.data.issue, {
+            expects: 'issue',
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            ...(deps.gh != null ? { gh: deps.gh } : {}),
+        });
+        if (!normalized.ok)
+            return normalized.error;
+        const gateDef = GATES.get(parsed.data.gate);
+        if (!gateDef) {
+            return {
+                status: 'error',
+                class: 'unknown-gate',
+                detail: `unknown gate "${parsed.data.gate}"`,
+            };
+        }
+        const captured = [];
+        const stderrLines = [];
+        const advanceDeps = {
+            gh: deps.gh ?? normalized.value.gh,
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            ...(deps.loadConfig != null ? { loadConfig: deps.loadConfig } : {}),
+            ...(deps.env != null ? { env: deps.env } : {}),
+            ...(deps.now != null ? { now: deps.now } : {}),
+            stdout: (line) => captured.push(line),
+            stderr: (line) => stderrLines.push(line),
+        };
+        const issueArg = `${normalized.value.ref.nwo}#${normalized.value.ref.number}`;
+        await runAdvance(issueArg, { gate: parsed.data.gate }, advanceDeps);
+        const noop = captured.some((l) => l.startsWith('already advanced'));
+        if (noop) {
+            return {
+                status: 'ok',
+                data: {
+                    ref: normalized.value.ref,
+                    gate: gateDef.name,
+                    action: 'already-advanced',
+                    completedLabel: gateDef.completedLabel,
+                    noop: true,
+                },
+            };
+        }
+        const commentMatch = captured
+            .map((l) => /\(comment: (https?:\/\/[^)]+)\)/.exec(l))
+            .find((m) => m != null);
+        const commentUrl = commentMatch ? commentMatch[1] : undefined;
+        return {
+            status: 'ok',
+            data: {
+                ref: normalized.value.ref,
+                gate: gateDef.name,
+                action: 'advanced',
+                completedLabel: gateDef.completedLabel,
+                ...(commentUrl ? { commentUrl } : {}),
+            },
+        };
+    });
+}
+//# sourceMappingURL=cockpit_advance.js.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_advance.js.map

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

package/dist/cli/commands/cockpit/mcp/tools/cockpit_await_events.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `cockpit_await_events` MCP tool handler.
+ *
+ * Long-poll for cockpit stream events for a given epic. Cursor-based;
+ * coalesces bursts within `coalesceWindowMs`; soft-cap at `maxBatchSize`
+ * (returned cursor is the continuation).
+ *
+ * Cursor classes:
+ *   - malformed / never-issued / wrong-epic → typed `invalid-cursor` error
+ *   - expired → silent reset to head with `resetFrom: "expired"`
+ *   - discarded → silent reset to head with `resetFrom: "discarded"`
+ *     (nonce missing, cross-instance, or bus evicted)
+ *   - valid → normal path
+ */
+import type { CommandRunner } from '@generacy-ai/cockpit';
+import type { CockpitStreamEvent } from '../../watch/stream-event.js';
+import { type ToolResult } from '../errors.js';
+import { type Acquired } from '../event-bus-registry.js';
+export interface CockpitAwaitEventsData {
+    events: CockpitStreamEvent[];
+    cursor: string;
+    resetFrom?: 'expired' | 'discarded';
+}
+export interface CockpitAwaitEventsDeps {
+    runner?: CommandRunner;
+    /**
+     * Test seam: provide a pre-built acquired bus. Bypasses the registry
+     * (poll loop not started). Handler will NOT call `release` on it.
+     */
+    acquired?: Acquired;
+    intervalMs?: number;
+}
+export declare function cockpitAwaitEvents(input: unknown, deps?: CockpitAwaitEventsDeps): Promise<ToolResult<CockpitAwaitEventsData>>;
+//# sourceMappingURL=cockpit_await_events.d.ts.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_await_events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit_await_events.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/cockpit/mcp/tools/cockpit_await_events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAsC7C"}

package/dist/cli/commands/cockpit/mcp/tools/cockpit_await_events.js

@@ -0,0 +1,115 @@
+import { normalizeIssueRef } from '../ref-input.js';
+import { wrapToolBoundary } from '../errors.js';
+import { AwaitEventsInputSchema } from '../schemas.js';
+import { acquireEpicBus } from '../event-bus-registry.js';
+import { encodeCursor, INSTANCE_NONCE } from '../event-bus.js';
+export function cockpitAwaitEvents(input, deps = {}) {
+    return wrapToolBoundary(async () => {
+        const parsed = AwaitEventsInputSchema.safeParse(input);
+        if (!parsed.success) {
+            return {
+                status: 'error',
+                class: 'invalid-args',
+                detail: parsed.error.issues.map((i) => i.message).join('; '),
+            };
+        }
+        const args = parsed.data;
+        let acquired;
+        let releaseAfter = true;
+        if (deps.acquired != null) {
+            acquired = deps.acquired;
+            releaseAfter = false;
+        }
+        else {
+            const normalized = await normalizeIssueRef(args.epic, {
+                expects: 'issue',
+                ...(deps.runner != null ? { runner: deps.runner } : {}),
+            });
+            if (!normalized.ok)
+                return normalized.error;
+            const epicRef = `${normalized.value.ref.nwo}#${normalized.value.ref.number}`;
+            acquired = await acquireEpicBus({
+                epicRef,
+                ...(deps.runner != null ? { runner: deps.runner } : {}),
+                gh: normalized.value.gh,
+                ...(deps.intervalMs != null ? { intervalMs: deps.intervalMs } : {}),
+            });
+        }
+        try {
+            return await drainOrWait(acquired.bus, args);
+        }
+        finally {
+            if (releaseAfter)
+                acquired.release();
+        }
+    });
+}
+async function drainOrWait(bus, args) {
+    const parseResult = bus.parseCursor(args.cursor);
+    let resetFrom;
+    let sinceCursor;
+    switch (parseResult.kind) {
+        case 'malformed':
+            return {
+                status: 'error',
+                class: 'invalid-cursor',
+                detail: 'cursor is malformed (expected base64-encoded position)',
+                hint: 'cursor tokens are opaque; pass verbatim from a prior await_events result',
+            };
+        case 'never-issued':
+            return {
+                status: 'error',
+                class: 'invalid-cursor',
+                detail: `cursor position was never issued for epic ${bus.epic}`,
+                hint: 'start with cursor=undefined for a fresh subscription',
+            };
+        case 'wrong-epic':
+            return {
+                status: 'error',
+                class: 'invalid-cursor',
+                detail: `cursor was issued for epic ${parseResult.requestedEpic}, not ${parseResult.boundEpic}`,
+            };
+        case 'expired':
+            resetFrom = 'expired';
+            sinceCursor = 0;
+            break;
+        case 'discarded':
+            resetFrom = 'discarded';
+            sinceCursor = 0;
+            break;
+        case 'valid':
+            sinceCursor = parseResult.position;
+            break;
+    }
+    const result = await bus.waitFor({
+        sinceCursor,
+        maxWaitMs: args.maxWaitMs,
+        coalesceWindowMs: args.coalesceWindowMs,
+        maxBatchSize: args.maxBatchSize,
+    });
+    if (result.entries.length === 0) {
+        // When we reset (expired/discarded), always issue a fresh nonce-carrying
+        // cursor rather than echoing the caller's invalid token.
+        const cursorStr = resetFrom == null && args.cursor != null
+            ? args.cursor
+            : encodeCursor(bus.epic, sinceCursor, INSTANCE_NONCE, bus.busNonce);
+        return {
+            status: 'ok',
+            data: {
+                events: [],
+                cursor: cursorStr,
+                ...(resetFrom != null ? { resetFrom } : {}),
+            },
+        };
+    }
+    const last = result.entries[result.entries.length - 1];
+    return {
+        status: 'ok',
+        data: {
+            events: result.entries.map((e) => e.event),
+            cursor: encodeCursor(bus.epic, last.cursor, INSTANCE_NONCE, bus.busNonce),
+            ...(resetFrom != null ? { resetFrom } : {}),
+        },
+    };
+}
+//# sourceMappingURL=cockpit_await_events.js.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_await_events.js.map

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

package/dist/cli/commands/cockpit/mcp/tools/cockpit_context.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `cockpit_context` MCP tool handler.
+ *
+ * Wraps `runContext` — the internal function already returns the bundle
+ * object directly (in addition to writing the JSON line to stdout). We
+ * capture stdout to keep it off the MCP transport but use the return value
+ * as `data`.
+ */
+import type { CommandRunner, GhWrapper } from '@generacy-ai/cockpit';
+import { type ContextBundle } from '../../context.js';
+import { type ToolResult } from '../errors.js';
+import { type IssueRefInput } from '../schemas.js';
+export interface CockpitContextInput {
+    issue: IssueRefInput;
+}
+export interface CockpitContextDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+}
+export declare function cockpitContext(input: CockpitContextInput, deps?: CockpitContextDeps): Promise<ToolResult<ContextBundle>>;
+//# sourceMappingURL=cockpit_context.d.ts.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit_context.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/cockpit/mcp/tools/cockpit_context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAuC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE3F,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,EAC1B,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CA+BpC"}

package/dist/cli/commands/cockpit/mcp/tools/cockpit_context.js

@@ -0,0 +1,35 @@
+import { runContext } from '../../context.js';
+import { normalizeIssueRef } from '../ref-input.js';
+import { wrapToolBoundary } from '../errors.js';
+import { CockpitContextInputSchema, } from '../schemas.js';
+export function cockpitContext(input, deps = {}) {
+    return wrapToolBoundary(async () => {
+        const parsed = CockpitContextInputSchema.safeParse(input);
+        if (!parsed.success) {
+            return {
+                status: 'error',
+                class: 'invalid-args',
+                detail: parsed.error.issues.map((i) => i.message).join('; '),
+            };
+        }
+        const normalized = await normalizeIssueRef(parsed.data.issue, {
+            expects: 'issue',
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            ...(deps.gh != null ? { gh: deps.gh } : {}),
+        });
+        if (!normalized.ok)
+            return normalized.error;
+        const captured = [];
+        const stderrLines = [];
+        const contextDeps = {
+            gh: deps.gh ?? normalized.value.gh,
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            stdout: (line) => captured.push(line),
+            stderr: (line) => stderrLines.push(line),
+        };
+        const issueArg = `${normalized.value.ref.nwo}#${normalized.value.ref.number}`;
+        const bundle = await runContext(issueArg, contextDeps);
+        return { status: 'ok', data: bundle };
+    });
+}
+//# sourceMappingURL=cockpit_context.js.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit_context.js","sourceRoot":"","sources":["../../../../../../src/cli/commands/cockpit/mcp/tools/cockpit_context.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAA+C,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AACjE,OAAO,EACL,yBAAyB,GAE1B,MAAM,eAAe,CAAC;AAWvB,MAAM,UAAU,cAAc,CAC5B,KAA0B,EAC1B,OAA2B,EAAE;IAE7B,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,cAAc;gBACrB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;aAC7D,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE;YAC5D,OAAO,EAAE,OAAO;YAChB,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,UAAU,CAAC,KAAK,CAAC;QAE5C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,MAAM,WAAW,GAAuB;YACtC,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE;YAClC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7C,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;SACjD,CAAC;QAEF,MAAM,QAAQ,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACvD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/cockpit/mcp/tools/cockpit_merge.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `cockpit_merge` MCP tool handler.
+ *
+ * Wraps `runMerge` (or `runMergeWithExplicitPr` when `pr` is supplied). Takes
+ * an issue ref, resolves it to a linked PR, and squash-merges IFF the PR is
+ * green and the issue carries `completed:validate`. Fully symmetric with the
+ * CLI verb `cockpit merge <issue>` — the same contract on both transports.
+ *
+ * If the caller's `issue` resolves to a *PR* node (rather than an issue), the
+ * resolver returns `{ kind: 'pr-number' }` and the CLI emits exit-2 with
+ * `reason: 'pr-number'`. `toMcpResult` maps that to `class: 'wrong-kind'`
+ * with the guidance hint carried over verbatim.
+ *
+ * Optional `pr: <number>` mirrors the CLI's `--pr <number>` escape hatch:
+ * skips resolution but keeps every safety precondition (linkage verification,
+ * completed:validate, checks green). Never a resolution bypass of safety.
+ */
+import type { CommandRunner, GhWrapper } from '@generacy-ai/cockpit';
+import { type ToolResult } from '../errors.js';
+import { type IssueRefInput } from '../schemas.js';
+export interface CockpitMergeInput {
+    issue: IssueRefInput;
+    pr?: number;
+}
+export interface CockpitMergeData {
+    pr: {
+        owner: string;
+        repo: string;
+        number: number;
+        url: string;
+    };
+    action: 'merged' | 'blocked';
+    checksState: 'success' | 'failure' | 'pending' | 'none';
+    mergeCommitSha?: string;
+    reason?: string;
+    raw?: unknown;
+}
+export interface CockpitMergeDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+}
+export declare function cockpitMerge(input: CockpitMergeInput, deps?: CockpitMergeDeps): Promise<ToolResult<CockpitMergeData>>;
+//# sourceMappingURL=cockpit_merge.d.ts.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit_merge.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/cockpit/mcp/tools/cockpit_merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIrE,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAmFvC"}

package/dist/cli/commands/cockpit/mcp/tools/cockpit_merge.js

@@ -0,0 +1,99 @@
+import { runMerge, runMergeWithExplicitPr } from '../../merge.js';
+import { assertQualifiedString, normalizeIssueRef } from '../ref-input.js';
+import { getLogger } from '../../../../utils/logger.js';
+import { toMcpResult, wrapToolBoundary } from '../errors.js';
+import { CockpitMergeInputSchema } from '../schemas.js';
+export function cockpitMerge(input, deps = {}) {
+    return wrapToolBoundary(async () => {
+        const parsed = CockpitMergeInputSchema.safeParse(input);
+        if (!parsed.success) {
+            // Q5 → B: preserve the old-field-name redirection. If the caller sent
+            // a `pr` key whose value is NOT a positive integer (i.e. they meant
+            // the pre-#928 shape where `pr` carried the issue ref), surface the
+            // renamed-field guidance instead of Zod's raw unknown-key diagnosis.
+            if (isPrLikelyOldFieldName(input)) {
+                return {
+                    status: 'error',
+                    class: 'invalid-args',
+                    detail: "the 'pr' field was renamed to 'issue'; pass the issue ref, not the PR number",
+                };
+            }
+            return {
+                status: 'error',
+                class: 'invalid-args',
+                detail: parsed.error.issues.map((i) => i.message).join('; '),
+            };
+        }
+        // Q1 → A: bare strings on the MCP transport must be qualified refs.
+        if (typeof parsed.data.issue === 'string') {
+            const qualified = assertQualifiedString(parsed.data.issue);
+            if (!qualified.ok) {
+                return { status: 'error', class: 'invalid-args', detail: qualified.error };
+            }
+        }
+        const normalized = await normalizeIssueRef(parsed.data.issue, {
+            expects: 'issue',
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            ...(deps.gh != null ? { gh: deps.gh } : {}),
+        });
+        if (!normalized.ok)
+            return normalized.error;
+        const logger = getLogger();
+        const nwo = normalized.value.ref.nwo;
+        const issueNumber = normalized.value.ref.number;
+        const gh = deps.gh ?? normalized.value.gh;
+        const result = parsed.data.pr != null
+            ? await runMergeWithExplicitPr({
+                gh,
+                issue: issueNumber,
+                repo: nwo,
+                prNumber: parsed.data.pr,
+                logger,
+            })
+            : await runMerge({
+                gh,
+                issue: issueNumber,
+                repo: nwo,
+                logger,
+            });
+        // Successful merge → synthesize a MCP payload. The CLI emits either an
+        // empty stdout (no notes) or a note followed by a branch-deletion suffix
+        // on success — neither is JSON. `result.prNumber` carries the resolved
+        // PR (or the caller's explicit `--pr <n>`).
+        if (result.exitCode === 0) {
+            const prNumber = result.prNumber ?? parsed.data.pr ?? issueNumber;
+            const url = `https://github.com/${nwo}/pull/${prNumber}`;
+            return {
+                status: 'ok',
+                data: {
+                    pr: {
+                        owner: normalized.value.ref.owner,
+                        repo: normalized.value.ref.repo,
+                        number: prNumber,
+                        url,
+                    },
+                    action: 'merged',
+                    checksState: 'success',
+                },
+            };
+        }
+        return toMcpResult(result.stdout, result.exitCode);
+    });
+}
+/**
+ * Detects the pre-#928 field shape: a `pr` key whose value is NOT a positive
+ * integer (i.e. either a string, object, or non-integer number). Used to
+ * emit the renamed-field guidance instead of Zod's default error.
+ */
+function isPrLikelyOldFieldName(raw) {
+    if (raw == null || typeof raw !== 'object')
+        return false;
+    const r = raw;
+    if (!('pr' in r))
+        return false;
+    const pr = r.pr;
+    if (typeof pr === 'number' && Number.isInteger(pr) && pr > 0)
+        return false;
+    return true;
+}
+//# sourceMappingURL=cockpit_merge.js.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_merge.js.map

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

package/dist/cli/commands/cockpit/mcp/tools/cockpit_queue.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `cockpit_queue` MCP tool handler.
+ *
+ * Wraps `runQueue` with the confirmation prompt short-circuited to `true`
+ * (agents don't type "y" — the whole point of the MCP transport is to
+ * eliminate that class of round). Returns the structured `queued`/`skipped`
+ * arrays derived from `QueueResult.rows`.
+ */
+import type { CommandRunner, GhWrapper } from '@generacy-ai/cockpit';
+import { type QueueCommandDeps } from '../../queue.js';
+import { type ToolResult } from '../errors.js';
+import { type EpicRefInput } from '../schemas.js';
+export interface CockpitQueueInput {
+    epic: EpicRefInput;
+    phase: string;
+}
+export interface CockpitQueueData {
+    epic: {
+        owner: string;
+        repo: string;
+        number: number;
+    };
+    phase: string;
+    queued: Array<{
+        repo: string;
+        number: number;
+        url: string;
+    }>;
+    skipped: Array<{
+        repo: string;
+        number: number;
+        reason: string;
+    }>;
+}
+export interface CockpitQueueDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+    cockpitGh?: GhWrapper;
+    loadConfig?: QueueCommandDeps['loadConfig'];
+    fetchPlan?: QueueCommandDeps['fetchPlan'];
+}
+export declare function cockpitQueue(input: CockpitQueueInput, deps?: CockpitQueueDeps): Promise<ToolResult<CockpitQueueData>>;
+//# sourceMappingURL=cockpit_queue.d.ts.map

package/dist/cli/commands/cockpit/mcp/tools/cockpit_queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit_queue.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/cockpit/mcp/tools/cockpit_queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAY,KAAK,gBAAgB,EAAoB,MAAM,gBAAgB,CAAC;AAEnF,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;CAC3C;AAkCD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAkDvC"}