@generacy-ai/generacy 0.3.4 → 0.5.0

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

@@ -0,0 +1,80 @@
+import { normalizeIssueRef } from '../ref-input.js';
+import { wrapToolBoundary } from '../errors.js';
+import { CockpitScopeRemoveInputSchema, } from '../schemas.js';
+import { writeScopeWithRetry } from '../../scope/retry.js';
+import { ScopeContendedError } from '../../scope/errors.js';
+function isScopeNotFoundError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return /404|not found|no such/i.test(msg);
+}
+export function cockpitScopeRemove(input, deps = {}) {
+    return wrapToolBoundary(async () => {
+        const parsed = CockpitScopeRemoveInputSchema.safeParse(input);
+        if (!parsed.success) {
+            return {
+                status: 'error',
+                class: 'invalid-args',
+                detail: parsed.error.issues.map((i) => i.message).join('; '),
+            };
+        }
+        const scopeN = await normalizeIssueRef(parsed.data.scope, {
+            expects: 'issue',
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            ...(deps.gh != null ? { gh: deps.gh } : {}),
+        });
+        if (!scopeN.ok)
+            return scopeN.error;
+        const refN = await normalizeIssueRef(parsed.data.issue, {
+            expects: 'issue',
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            ...(deps.gh != null ? { gh: deps.gh } : {}),
+        });
+        if (!refN.ok)
+            return refN.error;
+        const gh = deps.gh ?? scopeN.value.gh;
+        const scope = { repo: scopeN.value.ref.nwo, number: scopeN.value.ref.number };
+        const ref = { repo: refN.value.ref.nwo, number: refN.value.ref.number };
+        try {
+            const result = await writeScopeWithRetry({
+                gh,
+                scope,
+                mutation: { kind: 'remove', ref },
+            });
+            return {
+                status: 'ok',
+                data: {
+                    scope: {
+                        owner: scopeN.value.ref.owner,
+                        repo: scopeN.value.ref.repo,
+                        number: scopeN.value.ref.number,
+                    },
+                    ref: {
+                        owner: refN.value.ref.owner,
+                        repo: refN.value.ref.repo,
+                        number: refN.value.ref.number,
+                    },
+                    alreadyAbsent: result.noop,
+                    attempts: result.attempts,
+                },
+            };
+        }
+        catch (err) {
+            if (err instanceof ScopeContendedError) {
+                return {
+                    status: 'error',
+                    class: 'contended',
+                    detail: `${err.code} after ${err.attempts} attempts`,
+                };
+            }
+            if (isScopeNotFoundError(err)) {
+                return {
+                    status: 'error',
+                    class: 'scope-not-found',
+                    detail: `scope issue ${scope.repo}#${scope.number} not found`,
+                };
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=cockpit_scope_remove.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * `cockpit_status` MCP tool handler.
+ *
+ * Wraps `runStatus({json: true})` with an in-memory stdout sink; parses the
+ * single-line JSON envelope the CLI already emits and returns it verbatim
+ * as `data`. No stdout ever reaches the MCP transport (which uses stdout
+ * for JSON-RPC).
+ */
+import type { CommandRunner, GhWrapper } from '@generacy-ai/cockpit';
+import { type ToolResult } from '../errors.js';
+import { type EpicRefInput } from '../schemas.js';
+export interface CockpitStatusInput {
+    epic: EpicRefInput;
+}
+export type CockpitStatusData = unknown;
+export interface CockpitStatusDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+}
+export declare function cockpitStatus(input: CockpitStatusInput, deps?: CockpitStatusDeps): Promise<ToolResult<CockpitStatusData>>;
+//# sourceMappingURL=cockpit_status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit_status.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/cockpit/mcp/tools/cockpit_status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,EACzB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAwDxC"}

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

@@ -0,0 +1,59 @@
+import { runStatus } from '../../status.js';
+import { normalizeIssueRef } from '../ref-input.js';
+import { wrapToolBoundary } from '../errors.js';
+import { CockpitStatusInputSchema, } from '../schemas.js';
+export function cockpitStatus(input, deps = {}) {
+    return wrapToolBoundary(async () => {
+        const parsed = CockpitStatusInputSchema.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.epic, {
+            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 statusDeps = {
+            gh: deps.gh ?? normalized.value.gh,
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+            stdout: (line) => captured.push(line),
+            stderr: (line) => stderrLines.push(line),
+        };
+        const epicArg = `${normalized.value.ref.nwo}#${normalized.value.ref.number}`;
+        const code = await runStatus(epicArg, { json: true }, statusDeps);
+        if (code !== 0) {
+            const detail = stderrLines.join('\n') || `runStatus exited ${code}`;
+            const cls = code === 2 ? 'invalid-args' : 'transport';
+            return { status: 'error', class: cls, detail };
+        }
+        const line = captured.find((l) => l.trim().length > 0);
+        if (line == null) {
+            return {
+                status: 'error',
+                class: 'internal',
+                detail: 'runStatus produced no JSON envelope',
+            };
+        }
+        let parsedJson;
+        try {
+            parsedJson = JSON.parse(line);
+        }
+        catch (err) {
+            return {
+                status: 'error',
+                class: 'internal',
+                detail: `runStatus JSON envelope parse failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        return { status: 'ok', data: parsedJson };
+    });
+}
+//# sourceMappingURL=cockpit_status.js.map

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

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

package/dist/cli/commands/cockpit/merge.d.ts

@@ -0,0 +1,42 @@
+import { Command } from 'commander';
+import type { Logger } from 'pino';
+import type { GhWrapper } from '@generacy-ai/cockpit';
+export interface RunMergeInput {
+    gh: GhWrapper;
+    issue: number;
+    repo: string;
+    logger: Logger;
+}
+export interface RunMergeResult {
+    exitCode: 0 | 1 | 2 | 3;
+    stdout: string;
+    /**
+     * #928 — the PR number the CLI operated on. Set on exit-0 (the PR that was
+     * merged), on the pr-flag paths (mirrors the caller's `--pr <n>`), and on
+     * the resolver's non-terminal red paths where a PR was identified. Absent
+     * on `unresolved` / `pr-number` (no PR to name).
+     */
+    prNumber?: number;
+}
+export interface RunMergeWithExplicitPrInput {
+    gh: GhWrapper;
+    /** The `<ref>` issue number — authorization source for `completed:validate`. */
+    issue: number;
+    repo: string;
+    /** The operator-supplied `--pr <number>` value. Positive integer, validated. */
+    prNumber: number;
+    logger: Logger;
+}
+/**
+ * FR-005 — Commander parser for `--pr <number>`. See contracts/pr-flag-cli.md §2.
+ * Throws `CockpitExit(2)` on any malformed input.
+ */
+export declare function parsePrFlag(input: string): number;
+export declare function runMerge(input: RunMergeInput): Promise<RunMergeResult>;
+/**
+ * FR-005..FR-008 — `--pr <number>` escape hatch. Skips the tier-1/2/3 resolver
+ * chain but keeps every safety precondition. Gate order per contracts/pr-flag-cli.md §3.
+ */
+export declare function runMergeWithExplicitPr(input: RunMergeWithExplicitPrInput): Promise<RunMergeResult>;
+export declare function cockpitMergeCommand(): Command;
+//# sourceMappingURL=merge.d.ts.map

package/dist/cli/commands/cockpit/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,SAAS,EAIV,MAAM,sBAAsB,CAAC;AA8B9B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,SAAS,CAAC;IACd,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBjD;AAsOD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CA8G5E;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,cAAc,CAAC,CAsEzB;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CA4C7C"}

package/dist/cli/commands/cockpit/merge.js

@@ -0,0 +1,360 @@
+import { Command } from 'commander';
+import { getLogger } from '../../utils/logger.js';
+import { CockpitExit } from './exit.js';
+import { resolveIssueContext } from './resolver.js';
+import { classifyChecks } from './shared/required-checks.js';
+import { buildFailingCheckPayload, serializeFailingCheckJson, } from './shared/failing-check-json.js';
+function toPrCandidates(refs) {
+    return refs.map((r) => ({
+        number: r.number,
+        url: r.url,
+        isDraft: r.draft,
+        headRefName: r.headRefName,
+    }));
+}
+// Workflow labels (`waiting-for:*`, `completed:*`) are issue-scoped per the
+// #807-Q2 label protocol. runMerge reads `completed:validate` from
+// IssueStateResult.labels, never from PullRequestDetail.labels.
+const COMPLETED_VALIDATE_LABEL = 'completed:validate';
+/**
+ * FR-005 — Commander parser for `--pr <number>`. See contracts/pr-flag-cli.md §2.
+ * Throws `CockpitExit(2)` on any malformed input.
+ */
+export function parsePrFlag(input) {
+    const trimmed = input.trim();
+    if (trimmed.length === 0 || !/^\d+$/.test(trimmed)) {
+        throw new CockpitExit(2, `merge: --pr must be a positive integer, got: "${input}"`);
+    }
+    const n = Number.parseInt(trimmed, 10);
+    if (!Number.isSafeInteger(n) || n <= 0) {
+        throw new CockpitExit(2, `merge: --pr must be a positive integer, got: "${input}"`);
+    }
+    return n;
+}
+function parseIssueRef(repo, issue) {
+    const [owner, name] = repo.split('/');
+    if (!owner || !name) {
+        throw new Error(`runMerge: repo must be "owner/name", got: ${repo}`);
+    }
+    return { owner, repo: name, number: issue };
+}
+async function classifyAndDeleteBranch(ctx) {
+    const { gh, pr, issueRef, logger } = ctx;
+    if (pr.headRepositoryOwner != null &&
+        pr.headRepositoryOwner !== issueRef.owner) {
+        logger.info({ pr: pr.number, headRef: pr.head, headOwner: pr.headRepositoryOwner }, 'branch deletion skipped: cross-fork PR');
+        return 'merged (branch delete skipped: cross-fork PR)\n';
+    }
+    const repo = `${issueRef.owner}/${issueRef.repo}`;
+    const result = await gh.deleteHeadRef(repo, pr.head);
+    switch (result.outcome) {
+        case 'deleted':
+            return 'merged and branch deleted\n';
+        case 'already-gone':
+            logger.info({ pr: pr.number, headRef: pr.head }, 'branch was already deleted');
+            return 'merged (branch was already deleted)\n';
+        case 'delete-failed':
+            logger.warn({ pr: pr.number, repo, headRef: pr.head, stderr: result.stderr }, 'branch deletion failed');
+            return `merged (branch delete failed: ${result.stderr ?? ''})\n`;
+    }
+}
+/**
+ * Shared merge-tail helper. Fetches issue state, checks completed:validate,
+ * fetches required checks, classifies, merges, deletes branch. Extracted from
+ * runMerge for reuse by runMergeWithExplicitPr per contracts/pr-flag-cli.md §5.
+ */
+async function assertCompletedValidateAndMerge(input) {
+    const { gh, repo, issue, issueRef, prNumber, logger, exitPolicy, linkMethod, } = input;
+    const refuseExit = exitPolicy === 'pr-flag' ? 3 : 1;
+    const pr = await gh.getPullRequestDetail(repo, prNumber);
+    let issueState;
+    try {
+        issueState = await gh.fetchIssueState(repo, issue);
+    }
+    catch (err) {
+        logger.error({ issue, repo, err }, 'Failed to fetch issue state');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'unresolved',
+                pr: null,
+                issue: issueRef,
+            })),
+        };
+    }
+    if (issueState.state === 'CLOSED') {
+        logger.error({
+            issue,
+            repo,
+            state: issueState.state,
+            stateReason: issueState.stateReason,
+        }, 'Issue is CLOSED');
+        return {
+            exitCode: refuseExit,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'unresolved',
+                pr: { number: pr.number, url: pr.url },
+                issue: {
+                    ...issueRef,
+                    state: issueState.state,
+                    stateReason: issueState.stateReason,
+                },
+            })),
+        };
+    }
+    if (!issueState.labels.includes(COMPLETED_VALIDATE_LABEL)) {
+        logger.error({ issue, repo, missingLabel: COMPLETED_VALIDATE_LABEL }, 'Issue missing completed:validate label');
+        const prPayload = linkMethod !== undefined
+            ? { number: pr.number, url: pr.url, linkMethod }
+            : // `missing-label` builder invariant I-9 requires linkMethod. Use the
+                // dedicated pr-flag `missing-label` payload variant: since the shared
+                // builder requires linkMethod for `missing-label`, we synthesize a
+                // sentinel for the pr-flag path so both share the schema shape.
+                { number: pr.number, url: pr.url, linkMethod: 'closing-refs' };
+        return {
+            exitCode: refuseExit,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'missing-label',
+                pr: prPayload,
+                issue: issueRef,
+            })),
+        };
+    }
+    const [required, actualChecks] = await Promise.all([
+        gh.getRequiredCheckNames(repo, pr.base),
+        gh.getPullRequestCheckRuns(repo, pr.number),
+    ]);
+    if (required.source === 'fallback-pr-checks') {
+        logger.warn('required-check set derived from PR check list; token cannot read branch protection');
+    }
+    const noActual = actualChecks.length === 0;
+    const noRequired = required.source === 'branch-protection'
+        ? (required.names?.length ?? 0) === 0
+        : true;
+    if (noActual && noRequired) {
+        await gh.mergePullRequest(repo, pr.number, { squash: true });
+        logger.info({ pr: pr.number }, 'PR merged');
+        const deletionSuffix = await classifyAndDeleteBranch({
+            gh,
+            pr,
+            issueRef,
+            logger,
+        });
+        return {
+            exitCode: 0,
+            stdout: 'no checks configured and none required — proceeding on completed:validate\n' +
+                deletionSuffix,
+            prNumber: pr.number,
+        };
+    }
+    const { failingChecks, ok } = classifyChecks({ required, actual: actualChecks });
+    if (!ok) {
+        logger.error({ pr: pr.number, failing: failingChecks.length }, 'PR has failing or pending required checks');
+        const prPayload = linkMethod !== undefined
+            ? { number: pr.number, url: pr.url, linkMethod }
+            : { number: pr.number, url: pr.url, linkMethod: 'closing-refs' };
+        return {
+            exitCode: refuseExit,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'checks-failing',
+                pr: prPayload,
+                failingChecks,
+                issue: issueRef,
+            })),
+        };
+    }
+    await gh.mergePullRequest(repo, pr.number, { squash: true });
+    logger.info({ pr: pr.number }, 'PR merged');
+    const deletionSuffix = await classifyAndDeleteBranch({
+        gh,
+        pr,
+        issueRef,
+        logger,
+    });
+    return { exitCode: 0, stdout: deletionSuffix, prNumber: pr.number };
+}
+export async function runMerge(input) {
+    const { gh, issue, repo, logger } = input;
+    const issueRef = parseIssueRef(repo, issue);
+    const resolution = await gh.resolveIssueToPRRef(repo, issue);
+    if (resolution.kind === 'unresolved') {
+        logger.error({ issue, repo }, 'No PR resolved for issue');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'unresolved',
+                pr: null,
+                issue: issueRef,
+            })),
+        };
+    }
+    // #928 — the caller's `<issue>` argument is itself a PR node. Emit a
+    // typed refusal at exit-2 with guidance copy; the MCP envelope maps this
+    // reason to `class: 'wrong-kind'`. Closes #906 on the CLI at the same time.
+    if (resolution.kind === 'pr-number') {
+        logger.error({ issue, repo }, `#${issue} is a pull request, not an issue`);
+        return {
+            exitCode: 2,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-number',
+                pr: null,
+                issue: issueRef,
+                hint: `#${issue} is a pull request; pass the issue number ` +
+                    `(e.g. the issue whose closing PR is #${issue}).`,
+            })),
+        };
+    }
+    if (resolution.kind === 'pr-is-draft') {
+        logger.error({
+            issue,
+            repo,
+            linkMethod: resolution.linkMethod,
+            candidates: resolution.candidates.map((c) => c.number),
+        }, 'Resolved PRs are drafts');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-is-draft',
+                pr: null,
+                candidates: toPrCandidates(resolution.candidates),
+                linkMethod: resolution.linkMethod,
+                issue: issueRef,
+            })),
+        };
+    }
+    if (resolution.kind === 'ambiguous') {
+        logger.error({
+            issue,
+            repo,
+            linkMethod: resolution.linkMethod,
+            candidates: resolution.candidates.map((c) => c.number),
+        }, 'Multiple PRs resolved for issue');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'ambiguous-resolution',
+                pr: null,
+                candidates: toPrCandidates(resolution.candidates),
+                linkMethod: resolution.linkMethod,
+                issue: issueRef,
+            })),
+        };
+    }
+    // Exhaustiveness guard — after the branches above, resolution.kind is
+    // 'resolved'. Adding a new arm to PullRequestRefResolution surfaces here
+    // at build time.
+    const _exhaustive = resolution.kind;
+    void _exhaustive;
+    const prRef = resolution.ref;
+    const linkMethod = resolution.linkMethod;
+    // FR-004: log the resolved PR + tier BEFORE any subsequent gh call so a
+    // later failure never erases the evidence of which PR was targeted.
+    logger.info({ pr: prRef.number, linkMethod }, `resolved PR #${prRef.number} via ${linkMethod}`);
+    return assertCompletedValidateAndMerge({
+        gh,
+        repo,
+        issue,
+        issueRef,
+        prNumber: prRef.number,
+        logger,
+        exitPolicy: 'resolver',
+        linkMethod,
+    });
+}
+/**
+ * FR-005..FR-008 — `--pr <number>` escape hatch. Skips the tier-1/2/3 resolver
+ * chain but keeps every safety precondition. Gate order per contracts/pr-flag-cli.md §3.
+ */
+export async function runMergeWithExplicitPr(input) {
+    const { gh, issue, repo, prNumber, logger } = input;
+    const issueRef = parseIssueRef(repo, issue);
+    const pr = await gh.getPullRequestGraphqlDetail(repo, prNumber);
+    // Gate 1 — FR-006a linkage.
+    const declares = pr.closingIssuesReferences.some((l) => l.nameWithOwner === repo && l.number === issue);
+    if (!declares) {
+        const kind = pr.closingIssuesReferences.length === 0 ? 'empty-refs' : 'mismatch';
+        const message = kind === 'empty-refs'
+            ? `--pr ${prNumber} refused: PR #${prNumber} declares no closing issues. Add ${repo}#${issue} via the PR's Development sidebar link, then re-run.`
+            : `--pr ${prNumber} refused: PR #${prNumber} does not declare ${repo}#${issue} as a closing issue. Add ${repo}#${issue} via the PR's Development sidebar link, then re-run.`;
+        logger.error({ pr: prNumber, issue, repo, kind }, `--pr linkage refused: ${kind}`);
+        return {
+            exitCode: 3,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-flag-linkage-refused',
+                pr: { number: prNumber, url: '' },
+                kind,
+                message,
+                issue: issueRef,
+            })),
+        };
+    }
+    // Gate 2 — FR-006b state classifier.
+    if (pr.state === 'MERGED') {
+        logger.info({ pr: prNumber }, `PR #${prNumber} already merged, no-op`);
+        return {
+            exitCode: 0,
+            stdout: `PR #${prNumber} already merged, no-op\n`,
+            prNumber,
+        };
+    }
+    if (pr.state === 'CLOSED') {
+        logger.error({ pr: prNumber }, 'PR is closed without merge');
+        return {
+            exitCode: 3,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-flag-closed-unmerged',
+                pr: { number: prNumber, url: '' },
+                message: `--pr ${prNumber} refused: PR #${prNumber} is closed without merge.`,
+                issue: issueRef,
+            })),
+        };
+    }
+    // state === 'OPEN' → continue.
+    // Gates 3 & 4 — delegate to shared tail with pr-flag exitPolicy.
+    return assertCompletedValidateAndMerge({
+        gh,
+        repo,
+        issue,
+        issueRef,
+        prNumber,
+        logger,
+        exitPolicy: 'pr-flag',
+    });
+}
+export function cockpitMergeCommand() {
+    const cmd = new Command('merge');
+    cmd
+        .description('Squash-merge the PR for <issue> iff it carries completed:validate and every required check is green')
+        .argument('<issue>', 'GitHub issue number')
+        .option('--repo <repo>', 'Owner/name (inferred from cwd if absent)')
+        .option('--pr <number>', 'Escape hatch — target this PR directly, skipping issue→PR resolution. ' +
+        '<issue> remains required as the authorization source for completed:validate. ' +
+        'Enforces linkage verification and all safety preconditions; never bypasses safety.', parsePrFlag)
+        .action(async (issueArg, opts) => {
+        const logger = getLogger();
+        const ctx = await resolveIssueContext({
+            issue: issueArg,
+            repo: opts.repo,
+        });
+        const result = opts.pr != null
+            ? await runMergeWithExplicitPr({
+                gh: ctx.gh,
+                issue: ctx.ref.number,
+                repo: ctx.repo,
+                prNumber: opts.pr,
+                logger,
+            })
+            : await runMerge({
+                gh: ctx.gh,
+                issue: ctx.ref.number,
+                repo: ctx.repo,
+                logger,
+            });
+        if (result.stdout.length > 0) {
+            process.stdout.write(result.stdout);
+        }
+        process.exit(result.exitCode);
+    });
+    return cmd;
+}
+//# sourceMappingURL=merge.js.map

package/dist/cli/commands/cockpit/merge.js.map

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

package/dist/cli/commands/cockpit/plan-dependency-extractor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Extracts declared cross-issue dependencies from a spec's `plan.md` file.
+ *
+ * v1 heuristic (contracts/plan-dependency-warning.md §Extractor):
+ *   - Trigger verbs: `must be merged`, `must merge first`, `depends on`, `depends-on`,
+ *     `requires`, `extends`, `blocked by`, `prerequisite`.
+ *   - Extract `#\d+` (bare) → `{ defaultOwner, defaultRepo, N }`
+ *   - Extract `[\w-]+/[\w-]+#\d+` → cross-repo
+ *   - Search the trigger line PLUS the immediately-following line (wrapping tolerance).
+ *   - Skip fenced code blocks (` ``` `) and inline code (backticks).
+ *   - De-duplicate by `owner/repo/number`, preserving first-occurrence order.
+ *
+ * `originatingText` is derived from the trigger line, bounded to 120 chars.
+ */
+export interface DependencyRef {
+    owner: string;
+    repo: string;
+    number: number;
+    /** The originating span from the plan.md line (bounded to 120 chars). */
+    originatingText: string;
+}
+/**
+ * Extract dependency refs from `plan.md` markdown.
+ *
+ * @param planMarkdown Raw markdown body.
+ * @param defaultOwner Owner for bare `#N` refs (typically the current issue's owner).
+ * @param defaultRepo Repo for bare `#N` refs (typically the current issue's repo).
+ */
+export declare function extractPlanDependencies(planMarkdown: string, defaultOwner: string, defaultRepo: string): DependencyRef[];
+//# sourceMappingURL=plan-dependency-extractor.d.ts.map

package/dist/cli/commands/cockpit/plan-dependency-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-dependency-extractor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/plan-dependency-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;CACzB;AAsCD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,aAAa,EAAE,CAuFjB"}