reviewflow 3.0.0

package/dist/interface-adapters/controllers/mcp/setPhase.handler.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolResult } from "../../../mcp/types.js";
+import { type SetPhaseDependencies } from "../../../usecases/mcp/setPhase.usecase.js";
+export declare function createSetPhaseHandler(deps: SetPhaseDependencies): (args: Record<string, unknown>) => McpToolResult;
+//# sourceMappingURL=setPhase.handler.d.ts.map

package/dist/interface-adapters/controllers/mcp/setPhase.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setPhase.handler.d.ts","sourceRoot":"","sources":["../../../../src/interface-adapters/controllers/mcp/setPhase.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAEN,KAAK,oBAAoB,EACzB,MAAM,2CAA2C,CAAC;AAcnD,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,oBAAoB,GACxB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,aAAa,CAyDlD"}

package/dist/interface-adapters/controllers/mcp/setPhase.handler.js

@@ -0,0 +1,60 @@
+import { setPhase, } from "../../../usecases/mcp/setPhase.usecase.js";
+const VALID_PHASES = [
+    "initializing",
+    "agents-running",
+    "synthesizing",
+    "publishing",
+    "completed",
+];
+function isValidPhase(phase) {
+    return typeof phase === "string" && VALID_PHASES.includes(phase);
+}
+export function createSetPhaseHandler(deps) {
+    return (args) => {
+        const jobId = args.jobId;
+        const phase = args.phase;
+        if (typeof jobId !== "string" || !jobId) {
+            return {
+                content: [{ type: "text", text: "Error: jobId is required" }],
+                isError: true,
+            };
+        }
+        if (!phase) {
+            return {
+                content: [{ type: "text", text: "Error: phase is required" }],
+                isError: true,
+            };
+        }
+        if (!isValidPhase(phase)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Invalid phase '${phase}'. Valid phases: ${VALID_PHASES.join(", ")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = setPhase(jobId, phase, deps);
+        if (!result.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${result.error}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        phase: result.phase,
+                        overallProgress: result.overallProgress,
+                    }, null, 2),
+                },
+            ],
+        };
+    };
+}
+//# sourceMappingURL=setPhase.handler.js.map

package/dist/interface-adapters/controllers/mcp/setPhase.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setPhase.handler.js","sourceRoot":"","sources":["../../../../src/interface-adapters/controllers/mcp/setPhase.handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,QAAQ,GAER,MAAM,2CAA2C,CAAC;AAEnD,MAAM,YAAY,GAAkB;IACnC,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,WAAW;CACX,CAAC;AAEF,SAAS,YAAY,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,qBAAqB,CACpC,IAA0B;IAE1B,OAAO,CAAC,IAA6B,EAAiB,EAAE;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;gBAC7D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;gBAC7D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,yBAAyB,KAAK,oBAAoB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBACjF;iBACD;gBACD,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC3D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAED,OAAO;YACN,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CACnB;wBACC,OAAO,EAAE,IAAI;wBACb,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,eAAe,EAAE,MAAM,CAAC,eAAe;qBACvC,EACD,IAAI,EACJ,CAAC,CACD;iBACD;aACD;SACD,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}

package/dist/interface-adapters/controllers/mcp/startAgent.handler.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolResult } from "../../../mcp/types.js";
+import { type StartAgentDependencies } from "../../../usecases/mcp/startAgent.usecase.js";
+export declare function createStartAgentHandler(deps: StartAgentDependencies): (args: Record<string, unknown>) => McpToolResult;
+//# sourceMappingURL=startAgent.handler.d.ts.map

package/dist/interface-adapters/controllers/mcp/startAgent.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startAgent.handler.d.ts","sourceRoot":"","sources":["../../../../src/interface-adapters/controllers/mcp/startAgent.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,6CAA6C,CAAC;AAErD,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,sBAAsB,GAC1B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,aAAa,CA8ClD"}

package/dist/interface-adapters/controllers/mcp/startAgent.handler.js

@@ -0,0 +1,40 @@
+import { startAgent, } from "../../../usecases/mcp/startAgent.usecase.js";
+export function createStartAgentHandler(deps) {
+    return (args) => {
+        const jobId = args.jobId;
+        const agentName = args.agentName;
+        if (typeof jobId !== "string" || !jobId) {
+            return {
+                content: [{ type: "text", text: "Error: jobId is required" }],
+                isError: true,
+            };
+        }
+        if (typeof agentName !== "string" || !agentName) {
+            return {
+                content: [{ type: "text", text: "Error: agentName is required" }],
+                isError: true,
+            };
+        }
+        const result = startAgent(jobId, agentName, deps);
+        if (!result.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${result.error}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        agentName: result.agentName,
+                        startedAt: result.startedAt.toISOString(),
+                        overallProgress: result.overallProgress,
+                    }, null, 2),
+                },
+            ],
+        };
+    };
+}
+//# sourceMappingURL=startAgent.handler.js.map

package/dist/interface-adapters/controllers/mcp/startAgent.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startAgent.handler.js","sourceRoot":"","sources":["../../../../src/interface-adapters/controllers/mcp/startAgent.handler.ts"],"names":[],"mappings":"AACA,OAAO,EACN,UAAU,GAEV,MAAM,6CAA6C,CAAC;AAErD,MAAM,UAAU,uBAAuB,CACtC,IAA4B;IAE5B,OAAO,CAAC,IAA6B,EAAiB,EAAE;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAEjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;gBAC7D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAED,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YACjD,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;gBACjE,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC3D,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAED,OAAO;YACN,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CACnB;wBACC,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;wBACzC,eAAe,EAAE,MAAM,CAAC,eAAe;qBACvC,EACD,IAAI,EACJ,CAAC,CACD;iBACD;aACD;SACD,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}

package/dist/interface-adapters/controllers/webhook/eventFilter.d.ts

@@ -0,0 +1,71 @@
+import type { GitHubPullRequestEvent } from '../../../entities/github/githubPullRequestEvent.guard.js';
+import type { GitLabMergeRequestEvent } from '../../../entities/gitlab/gitlabMergeRequestEvent.guard.js';
+export type { GitHubPullRequestEvent, GitLabMergeRequestEvent };
+export declare const REVIEW_TRIGGER_LABEL = "needs-review";
+export type FilterResult = {
+    shouldProcess: false;
+    reason: string;
+} | {
+    shouldProcess: true;
+    reason: string;
+    mergeRequestNumber: number;
+    projectPath: string;
+    mergeRequestUrl: string;
+    sourceBranch: string;
+    targetBranch: string;
+    isFollowup?: boolean;
+};
+export interface GitLabPushEvent {
+    object_kind: 'push';
+    ref: string;
+    project: {
+        id: number;
+        path_with_namespace: string;
+        web_url: string;
+    };
+    commits: Array<{
+        id: string;
+        message: string;
+    }>;
+}
+/**
+ * Filter GitLab MR events
+ * Returns true if we should trigger a review
+ */
+export declare function filterGitLabEvent(event: GitLabMergeRequestEvent): FilterResult;
+/**
+ * Check if a GitLab MR event is an update that might need a followup review
+ * This is called for MRs that are not initial review requests but may have new commits
+ */
+export declare function filterGitLabMrUpdate(event: GitLabMergeRequestEvent): FilterResult;
+/**
+ * Check if a GitLab MR was closed (not merged)
+ * Returns info to clean up tracking
+ */
+export declare function filterGitLabMrClose(event: GitLabMergeRequestEvent): FilterResult;
+/**
+ * Check if a GitLab MR was merged
+ * Returns info to update tracking status
+ */
+export declare function filterGitLabMrMerge(event: GitLabMergeRequestEvent): FilterResult;
+/**
+ * Check if a GitLab MR was approved
+ * Returns info to update tracking status
+ */
+export declare function filterGitLabMrApprove(event: GitLabMergeRequestEvent): FilterResult;
+/**
+ * Filter GitHub PR events
+ * Returns true if we should trigger a review
+ */
+export declare function filterGitHubEvent(event: GitHubPullRequestEvent): FilterResult;
+/**
+ * Check if a GitHub PR was closed (not merged)
+ * Returns info to clean up tracking
+ */
+export declare function filterGitHubPrClose(event: GitHubPullRequestEvent): FilterResult;
+/**
+ * Filter GitHub PR label events
+ * Returns true if the "needs-review" label was added
+ */
+export declare function filterGitHubLabelEvent(event: GitHubPullRequestEvent): FilterResult;
+//# sourceMappingURL=eventFilter.d.ts.map

package/dist/interface-adapters/controllers/webhook/eventFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventFilter.d.ts","sourceRoot":"","sources":["../../../../src/interface-adapters/controllers/webhook/eventFilter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2DAA2D,CAAC;AAEzG,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC;AAEhE,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD,MAAM,MAAM,YAAY,GACpB;IAAE,aAAa,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC;IACE,aAAa,EAAE,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAGN,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,mBAAmB,EAAE,MAAM,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY,CAwC9E;AAyBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY,CA4BjF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY,CAsBhF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY,CAsBhF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY,CAgBlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAwC7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAsB/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAmClF"}

package/dist/interface-adapters/controllers/webhook/eventFilter.js

@@ -0,0 +1,252 @@
+import { loadConfig } from '../../../config/loader.js';
+export const REVIEW_TRIGGER_LABEL = 'needs-review';
+/**
+ * Filter GitLab MR events
+ * Returns true if we should trigger a review
+ */
+export function filterGitLabEvent(event) {
+    const config = loadConfig();
+    const myUsername = config.user.gitlabUsername;
+    // Must be a merge_request event
+    if (event.object_kind !== 'merge_request') {
+        return { shouldProcess: false, reason: 'Not a merge request event' };
+    }
+    const mr = event.object_attributes;
+    // MR must be open
+    if (mr.state !== 'opened') {
+        return { shouldProcess: false, reason: `MR state is ${mr.state}, not opened` };
+    }
+    // Skip draft MRs
+    if (mr.draft) {
+        return { shouldProcess: false, reason: 'MR is a draft' };
+    }
+    // Check if I was added as a reviewer
+    const wasAddedAsReviewer = checkGitLabReviewerAdded(event, myUsername);
+    if (!wasAddedAsReviewer) {
+        return {
+            shouldProcess: false,
+            reason: `${myUsername} was not added as reviewer in this event`,
+        };
+    }
+    return {
+        shouldProcess: true,
+        reason: `${myUsername} was assigned as reviewer`,
+        mergeRequestNumber: mr.iid,
+        projectPath: event.project.path_with_namespace,
+        mergeRequestUrl: mr.url,
+        sourceBranch: mr.source_branch,
+        targetBranch: mr.target_branch,
+    };
+}
+/**
+ * Check if user was NEWLY ADDED as a reviewer on this MR
+ * Only triggers when: user is in current reviewers BUT was NOT in previous reviewers
+ * This prevents triggering on MR updates when user is already assigned
+ */
+function checkGitLabReviewerAdded(event, username) {
+    // STRICT CHECK: Only trigger if changes.reviewers shows user was ADDED
+    if (event.changes?.reviewers) {
+        const wasInPrevious = event.changes.reviewers.previous?.some(r => r.username === username) ?? false;
+        const isInCurrent = event.changes.reviewers.current?.some(r => r.username === username) ?? false;
+        // Only trigger if user was ADDED (in current but not in previous)
+        return isInCurrent && !wasInPrevious;
+    }
+    // No changes.reviewers = no reviewer change = don't trigger
+    // This prevents triggering on other MR update events
+    return false;
+}
+/**
+ * Check if a GitLab MR event is an update that might need a followup review
+ * This is called for MRs that are not initial review requests but may have new commits
+ */
+export function filterGitLabMrUpdate(event) {
+    const mr = event.object_attributes;
+    // MR must be open
+    if (mr.state !== 'opened') {
+        return { shouldProcess: false, reason: `MR state is ${mr.state}, not opened` };
+    }
+    // Skip draft MRs
+    if (mr.draft) {
+        return { shouldProcess: false, reason: 'MR is a draft' };
+    }
+    // Only process "update" action (new commits pushed)
+    if (mr.action !== 'update') {
+        return { shouldProcess: false, reason: `Action is ${mr.action}, not update` };
+    }
+    return {
+        shouldProcess: true,
+        reason: 'MR was updated (potential new commits)',
+        mergeRequestNumber: mr.iid,
+        projectPath: event.project.path_with_namespace,
+        mergeRequestUrl: mr.url,
+        sourceBranch: mr.source_branch,
+        targetBranch: mr.target_branch,
+        isFollowup: true,
+    };
+}
+/**
+ * Check if a GitLab MR was closed (not merged)
+ * Returns info to clean up tracking
+ */
+export function filterGitLabMrClose(event) {
+    const mr = event.object_attributes;
+    // Check if action is "close" (MR closed without merging)
+    if (mr.action !== 'close') {
+        return { shouldProcess: false, reason: `Action is ${mr.action}, not close` };
+    }
+    // Verify state is closed
+    if (mr.state !== 'closed') {
+        return { shouldProcess: false, reason: `State is ${mr.state}, not closed` };
+    }
+    return {
+        shouldProcess: true,
+        reason: 'MR was closed',
+        mergeRequestNumber: mr.iid,
+        projectPath: event.project.path_with_namespace,
+        mergeRequestUrl: mr.url,
+        sourceBranch: mr.source_branch,
+        targetBranch: mr.target_branch,
+    };
+}
+/**
+ * Check if a GitLab MR was merged
+ * Returns info to update tracking status
+ */
+export function filterGitLabMrMerge(event) {
+    const mr = event.object_attributes;
+    // Check if action is "merge"
+    if (mr.action !== 'merge') {
+        return { shouldProcess: false, reason: `Action is ${mr.action}, not merge` };
+    }
+    // Verify state is merged
+    if (mr.state !== 'merged') {
+        return { shouldProcess: false, reason: `State is ${mr.state}, not merged` };
+    }
+    return {
+        shouldProcess: true,
+        reason: 'MR was merged',
+        mergeRequestNumber: mr.iid,
+        projectPath: event.project.path_with_namespace,
+        mergeRequestUrl: mr.url,
+        sourceBranch: mr.source_branch,
+        targetBranch: mr.target_branch,
+    };
+}
+/**
+ * Check if a GitLab MR was approved
+ * Returns info to update tracking status
+ */
+export function filterGitLabMrApprove(event) {
+    const mr = event.object_attributes;
+    if (mr.action !== 'approved') {
+        return { shouldProcess: false, reason: `Action is ${mr.action}, not approved` };
+    }
+    return {
+        shouldProcess: true,
+        reason: 'MR was approved',
+        mergeRequestNumber: mr.iid,
+        projectPath: event.project.path_with_namespace,
+        mergeRequestUrl: mr.url,
+        sourceBranch: mr.source_branch,
+        targetBranch: mr.target_branch,
+    };
+}
+/**
+ * Filter GitHub PR events
+ * Returns true if we should trigger a review
+ */
+export function filterGitHubEvent(event) {
+    const config = loadConfig();
+    const myUsername = config.user.githubUsername;
+    // Check event action
+    // "review_requested" is sent when someone is requested for review
+    if (event.action !== 'review_requested') {
+        return { shouldProcess: false, reason: `Action is ${event.action}, not review_requested` };
+    }
+    const pr = event.pull_request;
+    // PR must be open
+    if (pr.state !== 'open') {
+        return { shouldProcess: false, reason: `PR state is ${pr.state}, not open` };
+    }
+    // Skip draft PRs
+    if (pr.draft) {
+        return { shouldProcess: false, reason: 'PR is a draft' };
+    }
+    // Check if I was the one requested
+    // GitHub sends "requested_reviewer" in the event payload
+    if (event.requested_reviewer?.login !== myUsername) {
+        return {
+            shouldProcess: false,
+            reason: `Requested reviewer is ${event.requested_reviewer?.login}, not ${myUsername}`,
+        };
+    }
+    return {
+        shouldProcess: true,
+        reason: `${myUsername} was requested as reviewer`,
+        mergeRequestNumber: pr.number,
+        projectPath: event.repository.full_name,
+        mergeRequestUrl: pr.html_url,
+        sourceBranch: pr.head.ref,
+        targetBranch: pr.base.ref,
+    };
+}
+/**
+ * Check if a GitHub PR was closed (not merged)
+ * Returns info to clean up tracking
+ */
+export function filterGitHubPrClose(event) {
+    const pr = event.pull_request;
+    // Check if action is "closed"
+    if (event.action !== 'closed') {
+        return { shouldProcess: false, reason: `Action is ${event.action}, not closed` };
+    }
+    // Verify state is closed
+    if (pr.state !== 'closed') {
+        return { shouldProcess: false, reason: `State is ${pr.state}, not closed` };
+    }
+    return {
+        shouldProcess: true,
+        reason: 'PR was closed',
+        mergeRequestNumber: pr.number,
+        projectPath: event.repository.full_name,
+        mergeRequestUrl: pr.html_url,
+        sourceBranch: pr.head.ref,
+        targetBranch: pr.base.ref,
+    };
+}
+/**
+ * Filter GitHub PR label events
+ * Returns true if the "needs-review" label was added
+ */
+export function filterGitHubLabelEvent(event) {
+    // Check event action
+    if (event.action !== 'labeled') {
+        return { shouldProcess: false, reason: `Action is ${event.action}, not labeled` };
+    }
+    const pr = event.pull_request;
+    // PR must be open
+    if (pr.state !== 'open') {
+        return { shouldProcess: false, reason: `PR state is ${pr.state}, not open` };
+    }
+    // Skip draft PRs
+    if (pr.draft) {
+        return { shouldProcess: false, reason: 'PR is a draft' };
+    }
+    // Check if the added label is our trigger label
+    if (event.label?.name !== REVIEW_TRIGGER_LABEL) {
+        return {
+            shouldProcess: false,
+            reason: `Label "${event.label?.name}" is not "${REVIEW_TRIGGER_LABEL}"`,
+        };
+    }
+    return {
+        shouldProcess: true,
+        reason: `Label "${REVIEW_TRIGGER_LABEL}" was added`,
+        mergeRequestNumber: pr.number,
+        projectPath: event.repository.full_name,
+        mergeRequestUrl: pr.html_url,
+        sourceBranch: pr.head.ref,
+        targetBranch: pr.base.ref,
+    };
+}
+//# sourceMappingURL=eventFilter.js.map

package/dist/interface-adapters/controllers/webhook/eventFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventFilter.js","sourceRoot":"","sources":["../../../../src/interface-adapters/controllers/webhook/eventFilter.ts"],"names":[],"mappings":"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"}

package/dist/interface-adapters/controllers/webhook/github.controller.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import type { Logger } from 'pino';
+import type { ReviewRequestTrackingGateway } from '../../gateways/reviewRequestTracking.gateway.js';
+export declare function handleGitHubWebhook(request: FastifyRequest, reply: FastifyReply, logger: Logger, trackingGateway: ReviewRequestTrackingGateway): Promise<void>;
+//# sourceMappingURL=github.controller.d.ts.map

package/dist/interface-adapters/controllers/webhook/github.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.controller.d.ts","sourceRoot":"","sources":["../../../../src/interface-adapters/controllers/webhook/github.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAYnC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAepG,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,4BAA4B,GAC5C,OAAO,CAAC,IAAI,CAAC,CA0Uf"}