@generacy-ai/generacy 0.3.3 → 0.4.0

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

@@ -0,0 +1,37 @@
+/**
+ * `generacy cockpit mcp` command — Commander factory. Refuses to start on
+ * worker containers via `GENERACY_CLUSTER_ROLE` (Q2-A defense-in-depth).
+ * On orchestrator (or missing env), builds the MCP server and connects a
+ * stdio transport.
+ */
+import { Command } from 'commander';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { buildMcpServer } from './server.js';
+export function cockpitMcpCommand(deps = {}) {
+    const cmd = new Command('mcp');
+    cmd
+        .description('Run the cockpit stdio MCP server (orchestrator container only; refuses on workers).')
+        .action(async () => {
+        await runCockpitMcp(deps);
+    });
+    return cmd;
+}
+export async function runCockpitMcp(deps = {}) {
+    const env = deps.env ?? process.env;
+    const stderr = deps.stderr ?? ((line) => process.stderr.write(`${line}\n`));
+    const exit = deps.exit ??
+        ((code) => {
+            process.exit(code);
+        });
+    if (env['GENERACY_CLUSTER_ROLE'] === 'worker') {
+        stderr('Error: cockpit mcp: refusing to start on a worker container ' +
+            '(GENERACY_CLUSTER_ROLE=worker). Register this server user-scope in the ' +
+            'orchestrator container only.');
+        exit(2);
+        return;
+    }
+    const server = buildMcpServer();
+    const transport = (deps.makeTransport?.() ?? new StdioServerTransport());
+    await server.connect(transport);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAU7C,MAAM,UAAU,iBAAiB,CAAC,OAAuB,EAAE;IACzD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,GAAG;SACA,WAAW,CACV,qFAAqF,CACtF;SACA,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IACL,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAuB,EAAE;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IACpF,MAAM,IAAI,GACR,IAAI,CAAC,IAAI;QACT,CAAC,CAAC,IAAY,EAAE,EAAE;YAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IAEL,IAAI,GAAG,CAAC,uBAAuB,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,CACJ,8DAA8D;YAC5D,yEAAyE;YACzE,8BAA8B,CACjC,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,CAAC;QACR,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,IAAI,oBAAoB,EAAE,CAEtE,CAAC;IACF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/cli/commands/cockpit/mcp/ref-input.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Normalize `IssueRefInput` (object | string) into a resolved
+ * `{ ref, gh }` bundle for the tool handlers.
+ *
+ * Object form is validated via `IssueRefObjectSchema`; string form is passed
+ * through `resolveIssueContext` — inherits bare-number cwd-inference (#850),
+ * qualified `owner/repo#N`, and URL forms.
+ *
+ * PR-kind gate (subsumes generacy#906): when `expects === 'issue'`, the
+ * resolved number must NOT resolve to a PR. Inspected via `gh.getIssue()`'s
+ * URL — a `/pull/<n>` path is a pull request. Symmetric enforcement in
+ * `cockpit_merge`, which expects a PR and rejects issues.
+ */
+import type { CommandRunner, GhWrapper } from '@generacy-ai/cockpit';
+import { type IssueRef } from '../resolver.js';
+import type { ToolErrorResult } from './errors.js';
+import { type IssueRefInput } from './schemas.js';
+export interface AssertQualifiedOk {
+    ok: true;
+    form: 'short' | 'url';
+}
+export interface AssertQualifiedError {
+    ok: false;
+    error: string;
+}
+/**
+ * Verify that a string ref is in one of the MCP-accepted qualified forms
+ * (owner/repo#N or a github.com issue/pull URL). Bare digits are rejected
+ * with a typed message. Shared across the seven MCP tools.
+ */
+export declare function assertQualifiedString(value: string): AssertQualifiedOk | AssertQualifiedError;
+export interface NormalizedRef {
+    ref: IssueRef;
+    gh: GhWrapper;
+}
+export type NormalizeResult = {
+    ok: true;
+    value: NormalizedRef;
+} | {
+    ok: false;
+    error: ToolErrorResult;
+};
+export type RefKind = 'issue' | 'pr';
+export interface NormalizeOptions {
+    /** What the tool expects. Used to gate the PR-vs-issue kind check. */
+    expects: RefKind;
+    /** Optional injected wrapper — used by tests to short-circuit the kind check. */
+    gh?: GhWrapper;
+    runner?: CommandRunner;
+}
+export declare function normalizeIssueRef(input: IssueRefInput, options: NormalizeOptions): Promise<NormalizeResult>;
+//# sourceMappingURL=ref-input.d.ts.map

package/dist/cli/commands/cockpit/mcp/ref-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-input.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/ref-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAS,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAUxE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;CACvB;AACD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,iBAAiB,GAAG,oBAAoB,CAc1C;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,QAAQ,CAAC;IACd,EAAE,EAAE,SAAS,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AA2BD,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAoE1B"}

package/dist/cli/commands/cockpit/mcp/ref-input.js

@@ -0,0 +1,132 @@
+import { resolveIssueContext } from '../resolver.js';
+import { IssueRefObjectSchema } from './schemas.js';
+import { GhCliWrapper } from '@generacy-ai/cockpit';
+/** #928 Q1 — MCP transport accepts only qualified refs; bare digits and
+ * numeric shortcuts are rejected at the tool boundary with a typed message
+ * naming the accepted forms. cwd-based inference at the MCP layer would
+ * depend on the accident of the entrypoint's spawn cwd (per #850). */
+const QUALIFIED_SHORT_FORM = /^([^/\s]+)\/([^/\s#]+)#(\d+)$/;
+const ISSUE_OR_PR_URL = /^https?:\/\/github\.com\/([^/\s]+)\/([^/\s]+)\/(?:issues|pull)\/(\d+)(?:[/?#].*)?$/;
+/**
+ * Verify that a string ref is in one of the MCP-accepted qualified forms
+ * (owner/repo#N or a github.com issue/pull URL). Bare digits are rejected
+ * with a typed message. Shared across the seven MCP tools.
+ */
+export function assertQualifiedString(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return { ok: false, error: 'ref must not be empty' };
+    }
+    if (QUALIFIED_SHORT_FORM.test(trimmed))
+        return { ok: true, form: 'short' };
+    if (ISSUE_OR_PR_URL.test(trimmed))
+        return { ok: true, form: 'url' };
+    return {
+        ok: false,
+        error: `MCP requires a qualified ref, got: "${value}". ` +
+            `Accepted forms: "<owner>/<repo>#<n>", a full GitHub issue/PR URL, ` +
+            `or the structured object { owner, repo, number }.`,
+    };
+}
+/**
+ * Detect PR vs issue from an `Issue` object. Mirrors `isPullRequest` in
+ * status.ts — the `/pull/<n>` URL segment is the authoritative marker.
+ */
+function isPullRequest(issue) {
+    if (issue.url != null && /\/pull\/\d+/.test(issue.url))
+        return true;
+    return issue.labels.includes('type:pr');
+}
+/** Convert an object form into a live `{ ref, gh }` bundle. */
+function fromObject(input, runner) {
+    const ref = {
+        owner: input.owner,
+        repo: input.repo,
+        number: input.number,
+        nwo: `${input.owner}/${input.repo}`,
+    };
+    const gh = runner ? new GhCliWrapper(runner) : new GhCliWrapper();
+    return { ref, gh };
+}
+export async function normalizeIssueRef(input, options) {
+    let normalized;
+    if (typeof input === 'string') {
+        try {
+            const resolved = await resolveIssueContext({
+                issue: input,
+                ...(options.runner != null ? { runner: options.runner } : {}),
+            });
+            normalized = { ref: resolved.ref, gh: options.gh ?? resolved.gh };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: {
+                    status: 'error',
+                    class: 'invalid-args',
+                    detail: err instanceof Error ? err.message : String(err),
+                },
+            };
+        }
+    }
+    else {
+        const parsed = IssueRefObjectSchema.safeParse(input);
+        if (!parsed.success) {
+            return {
+                ok: false,
+                error: {
+                    status: 'error',
+                    class: 'invalid-args',
+                    detail: parsed.error.issues.map((i) => i.message).join('; '),
+                },
+            };
+        }
+        const built = fromObject(parsed.data, options.runner);
+        normalized = { ref: built.ref, gh: options.gh ?? built.gh };
+    }
+    const kindCheck = await classifyRefKind(normalized);
+    if (kindCheck.kind === 'error') {
+        return { ok: false, error: kindCheck.error };
+    }
+    if (options.expects === 'issue' && kindCheck.kind === 'pr') {
+        return {
+            ok: false,
+            error: {
+                status: 'error',
+                class: 'wrong-kind',
+                detail: `expected an issue, but ${normalized.ref.nwo}#${normalized.ref.number} is a pull request`,
+                hint: 'pass a PR ref to `cockpit_merge`; issue tools require an issue number',
+            },
+        };
+    }
+    if (options.expects === 'pr' && kindCheck.kind === 'issue') {
+        return {
+            ok: false,
+            error: {
+                status: 'error',
+                class: 'wrong-kind',
+                detail: `expected a pull request, but ${normalized.ref.nwo}#${normalized.ref.number} is an issue`,
+                hint: 'pass an issue ref to `cockpit_context`/`cockpit_advance`; `cockpit_merge` requires a PR number',
+            },
+        };
+    }
+    return { ok: true, value: normalized };
+}
+/** Classify a resolved ref as issue or PR via `gh.getIssue()`. */
+async function classifyRefKind(normalized) {
+    try {
+        const issue = await normalized.gh.getIssue(normalized.ref.nwo, normalized.ref.number);
+        return { kind: isPullRequest(issue) ? 'pr' : 'issue' };
+    }
+    catch (err) {
+        return {
+            kind: 'error',
+            error: {
+                status: 'error',
+                class: 'transport',
+                detail: `gh issue view: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=ref-input.js.map

package/dist/cli/commands/cockpit/mcp/ref-input.js.map

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

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

@@ -0,0 +1,287 @@
+/**
+ * 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';
+/** Structured issue/epic reference. */
+export declare const IssueRefObjectSchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    number: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    number: number;
+    owner: string;
+    repo: string;
+}, {
+    number: number;
+    owner: string;
+    repo: string;
+}>;
+export type IssueRefObject = z.infer<typeof IssueRefObjectSchema>;
+/** String form of the ref — passed to `resolveIssueContext` for normalization. */
+export declare const IssueRefStringSchema: z.ZodString;
+/** Accepted `issue` input for every mutation tool. */
+export declare const IssueRefInputSchema: z.ZodUnion<[z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    number: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    number: number;
+    owner: string;
+    repo: string;
+}, {
+    number: number;
+    owner: string;
+    repo: string;
+}>, z.ZodString]>;
+export type IssueRefInput = z.infer<typeof IssueRefInputSchema>;
+/** Alias — `EpicRefInput` is shape-identical to `IssueRefInput`. */
+export declare const EpicRefInputSchema: z.ZodUnion<[z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    number: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    number: number;
+    owner: string;
+    repo: string;
+}, {
+    number: number;
+    owner: string;
+    repo: string;
+}>, z.ZodString]>;
+export type EpicRefInput = IssueRefInput;
+/**
+ * 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 declare const GateNameInputSchema: z.ZodEnum<[string, ...string[]]>;
+export type GateNameInput = z.infer<typeof GateNameInputSchema>;
+/** Concrete defaults for the long-poll event tool. Locked by SC-006 fixture. */
+export declare const AWAIT_EVENTS_DEFAULTS: Readonly<{
+    maxWaitMs: 55000;
+    coalesceWindowMs: 3000;
+    maxBatchSize: 256;
+}>;
+export declare const AwaitEventsInputSchema: z.ZodObject<{
+    epic: z.ZodUnion<[z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        number: number;
+        owner: string;
+        repo: string;
+    }, {
+        number: number;
+        owner: string;
+        repo: string;
+    }>, z.ZodString]>;
+    cursor: z.ZodOptional<z.ZodString>;
+    maxWaitMs: z.ZodDefault<z.ZodNumber>;
+    coalesceWindowMs: z.ZodDefault<z.ZodNumber>;
+    maxBatchSize: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    epic: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+    maxWaitMs: number;
+    coalesceWindowMs: number;
+    maxBatchSize: number;
+    cursor?: string | undefined;
+}, {
+    epic: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+    maxWaitMs?: number | undefined;
+    coalesceWindowMs?: number | undefined;
+    maxBatchSize?: number | undefined;
+    cursor?: string | undefined;
+}>;
+export type AwaitEventsInput = z.infer<typeof AwaitEventsInputSchema>;
+/** Per-tool input schemas — thin wrappers around the primitives. */
+export declare const CockpitStatusInputSchema: z.ZodObject<{
+    epic: z.ZodUnion<[z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        number: number;
+        owner: string;
+        repo: string;
+    }, {
+        number: number;
+        owner: string;
+        repo: string;
+    }>, z.ZodString]>;
+}, "strict", z.ZodTypeAny, {
+    epic: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}, {
+    epic: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}>;
+export declare const CockpitContextInputSchema: z.ZodObject<{
+    issue: z.ZodUnion<[z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        number: number;
+        owner: string;
+        repo: string;
+    }, {
+        number: number;
+        owner: string;
+        repo: string;
+    }>, z.ZodString]>;
+}, "strict", z.ZodTypeAny, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}>;
+export declare const CockpitAdvanceInputSchema: z.ZodObject<{
+    issue: z.ZodUnion<[z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        number: number;
+        owner: string;
+        repo: string;
+    }, {
+        number: number;
+        owner: string;
+        repo: string;
+    }>, z.ZodString]>;
+    gate: z.ZodEnum<[string, ...string[]]>;
+}, "strict", z.ZodTypeAny, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+    gate: string;
+}, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+    gate: string;
+}>;
+export declare const CockpitResumeInputSchema: z.ZodObject<{
+    issue: z.ZodUnion<[z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        number: number;
+        owner: string;
+        repo: string;
+    }, {
+        number: number;
+        owner: string;
+        repo: string;
+    }>, z.ZodString]>;
+}, "strict", z.ZodTypeAny, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}>;
+export declare const CockpitQueueInputSchema: z.ZodObject<{
+    epic: z.ZodUnion<[z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        number: number;
+        owner: string;
+        repo: string;
+    }, {
+        number: number;
+        owner: string;
+        repo: string;
+    }>, z.ZodString]>;
+    phase: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    phase: string;
+    epic: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}, {
+    phase: string;
+    epic: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+}>;
+/**
+ * #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 declare const CockpitMergeInputSchema: z.ZodObject<{
+    issue: z.ZodUnion<[z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        number: number;
+        owner: string;
+        repo: string;
+    }, {
+        number: number;
+        owner: string;
+        repo: string;
+    }>, z.ZodString]>;
+    pr: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+    pr?: number | undefined;
+}, {
+    issue: string | {
+        number: number;
+        owner: string;
+        repo: string;
+    };
+    pr?: number | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/mcp/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,uCAAuC;AACvC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAYtB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,aAAoB,CAAC;AAEtD,sDAAsD;AACtD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAAwD,CAAC;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,oEAAoE;AACpE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAAsB,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAIzC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kCAA6C,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,gFAAgF;AAChF,eAAO,MAAM,qBAAqB;;;;EAIhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,oEAAoE;AACpE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkD,CAAC;AACxF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;EAAoD,CAAC;AAC3F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;EAAoD,CAAC;AAC1F,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AACZ;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKzB,CAAC"}

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

@@ -0,0 +1,84 @@
+/**
+ * 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();
+export const CockpitQueueInputSchema = z
+    .object({ epic: EpicRefInputSchema, phase: z.string().min(1) })
+    .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":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,uCAAuC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,KAAK,CAAC,WAAW,CAAC;IACrB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,KAAK,CAAC,YAAY,CAAC;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEtD,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAGzF,oEAAoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAGtD,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,SAAkC,CAAC,CAAC;AAG9E,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,MAAM;IACjB,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,GAAG;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC;IACxF,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,MAAM,CAAC;SACX,OAAO,CAAC,qBAAqB,CAAC,gBAAgB,CAAC;IAClD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,qBAAqB,CAAC,YAAY,CAAC;CAC/C,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,oEAAoE;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;KACjE,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,MAAM,EAAE,CAAC;AACZ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,KAAK,EAAE,mBAAmB;IAC1B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC;KACD,MAAM,EAAE,CAAC"}

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;AAoB1D,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAUD,wBAAgB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,SAAS,CA4EvE"}