@generacy-ai/generacy 0.3.4 → 0.5.0

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

@@ -0,0 +1,97 @@
+/**
+ * Zod input schemas for the seven cockpit MCP tools.
+ *
+ * `AWAIT_EVENTS_DEFAULTS` is the single source of truth for the long-poll /
+ * coalesce / batch-size defaults — referenced by Zod defaults on
+ * `AwaitEventsInputSchema` AND by the SC-006 fixture assertion. Do not fork.
+ */
+import { z } from 'zod';
+import { listGates } from '../gate-vocabulary.js';
+/** Structured issue/epic reference. */
+export const IssueRefObjectSchema = z
+    .object({
+    owner: z
+        .string()
+        .min(1)
+        .regex(/^[^/\s]+$/),
+    repo: z
+        .string()
+        .min(1)
+        .regex(/^[^/\s#]+$/),
+    number: z.number().int().positive(),
+})
+    .strict();
+/** String form of the ref — passed to `resolveIssueContext` for normalization. */
+export const IssueRefStringSchema = z.string().min(1);
+/** Accepted `issue` input for every mutation tool. */
+export const IssueRefInputSchema = z.union([IssueRefObjectSchema, IssueRefStringSchema]);
+/** Alias — `EpicRefInput` is shape-identical to `IssueRefInput`. */
+export const EpicRefInputSchema = IssueRefInputSchema;
+const gateNames = listGates();
+/**
+ * Gate-name schema built at import time from the gate vocabulary. Unknown
+ * gate names are rejected at the MCP boundary with `class: "unknown-gate"`.
+ */
+export const GateNameInputSchema = z.enum(gateNames);
+/** Concrete defaults for the long-poll event tool. Locked by SC-006 fixture. */
+export const AWAIT_EVENTS_DEFAULTS = Object.freeze({
+    maxWaitMs: 55_000,
+    coalesceWindowMs: 3_000,
+    maxBatchSize: 256,
+});
+export const AwaitEventsInputSchema = z
+    .object({
+    epic: EpicRefInputSchema,
+    cursor: z.string().optional(),
+    maxWaitMs: z.number().int().min(0).max(300_000).default(AWAIT_EVENTS_DEFAULTS.maxWaitMs),
+    coalesceWindowMs: z
+        .number()
+        .int()
+        .min(0)
+        .max(60_000)
+        .default(AWAIT_EVENTS_DEFAULTS.coalesceWindowMs),
+    maxBatchSize: z
+        .number()
+        .int()
+        .positive()
+        .max(4_096)
+        .default(AWAIT_EVENTS_DEFAULTS.maxBatchSize),
+})
+    .strict();
+/** Per-tool input schemas — thin wrappers around the primitives. */
+export const CockpitStatusInputSchema = z.object({ epic: EpicRefInputSchema }).strict();
+export const CockpitContextInputSchema = z.object({ issue: IssueRefInputSchema }).strict();
+export const CockpitAdvanceInputSchema = z
+    .object({ issue: IssueRefInputSchema, gate: GateNameInputSchema })
+    .strict();
+export const CockpitResumeInputSchema = z.object({ issue: IssueRefInputSchema }).strict();
+/**
+ * #935 — `cockpit_queue` accepts either the phase form (existing) or a new
+ * single-issue form. Discriminated union at Zod level so TypeScript consumers
+ * of the tool see both variants explicitly.
+ */
+export const CockpitQueueInputSchema = z.union([
+    z.object({ epic: EpicRefInputSchema, phase: z.string().min(1) }).strict(),
+    z.object({ issue: IssueRefInputSchema }).strict(),
+]);
+/** #935 — scope-mutation tool schemas. */
+export const CockpitScopeAddInputSchema = z
+    .object({ scope: EpicRefInputSchema, issue: IssueRefInputSchema })
+    .strict();
+export const CockpitScopeRemoveInputSchema = z
+    .object({ scope: EpicRefInputSchema, issue: IssueRefInputSchema })
+    .strict();
+/**
+ * #928 — `cockpit_merge` accepts an **issue ref** (matching the CLI verb),
+ * with an optional `pr: <number>` escape hatch mirroring CLI `--pr <number>`.
+ * Field name change from `pr` (old, inverted) to `issue`; the old-field-name
+ * redirection message is emitted at the tool handler when a `pr` key with a
+ * non-numeric value is seen (per clarifications Q5 → B).
+ */
+export const CockpitMergeInputSchema = z
+    .object({
+    issue: IssueRefInputSchema,
+    pr: z.number().int().positive().optional(),
+})
+    .strict();
+//# sourceMappingURL=schemas.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * 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 type { CommandRunner } from '@generacy-ai/cockpit';
+export interface BuildMcpServerDeps {
+    runner?: CommandRunner;
+}
+export declare function buildMcpServer(deps?: BuildMcpServerDeps): McpServer;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAwB1D,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAUD,wBAAgB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,SAAS,CAgGvE"}

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

@@ -0,0 +1,72 @@
+/**
+ * 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 { cockpitScopeAdd } from './tools/cockpit_scope_add.js';
+import { cockpitScopeRemove } from './tools/cockpit_scope_remove.js';
+import { CockpitStatusInputSchema, CockpitContextInputSchema, CockpitAdvanceInputSchema, CockpitResumeInputSchema, CockpitQueueInputSchema, CockpitMergeInputSchema, CockpitScopeAddInputSchema, CockpitScopeRemoveInputSchema, 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_scope_add', {
+        description: "Append a task-list ref to a scope (epic or tracking) issue's body. Concurrency-safe with bounded retry.",
+        inputSchema: CockpitScopeAddInputSchema,
+    }, async (args) => toCallToolResult(await cockpitScopeAdd(args, deps)));
+    server.registerTool('cockpit_scope_remove', {
+        description: "Remove a task-list ref line from a scope issue's body. Concurrency-safe with bounded retry.",
+        inputSchema: CockpitScopeRemoveInputSchema,
+    }, async (args) => toCallToolResult(await cockpitScopeRemove(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"}