@vercel/factory 0.0.14 → 0.0.16

package/dist/code-review/github-reporter.mjs

@@ -0,0 +1,262 @@
+import { createCheckRun, createPullRequestComment, listCheckRunsForRef, listPullRequestComments, readPullRequestHead, updateCheckRun, updatePullRequestComment } from "../github.mjs";
+//#region src/code-review/github-reporter.ts
+const summaryMarker = "<!-- factory-code-review-summary -->";
+const statePrefix = "<!-- factory-code-review-state:v1:";
+const stateSuffix = " -->";
+const terminalReviewStates = /* @__PURE__ */ new Set(["cancelled", "failed"]);
+const reviewCheckBatchSize = 20;
+const reviewCheckPageIntervalMs = 3e5;
+const reviewCheckEffectKey = {
+	namespace: "software",
+	name: "github_review_check"
+};
+function recordedCheckRunId(effect, headSha) {
+	if (effect?.reference === void 0) return void 0;
+	const { provider, resourceId } = effect.reference;
+	const checkRunId = Number(resourceId);
+	if (provider !== "github" || !Number.isSafeInteger(checkRunId) || checkRunId <= 0) throw new Error("Stored software review-check effect has an invalid GitHub check-run reference");
+	if (headSha !== void 0 && effect.reference.subject !== headSha) throw new Error(`Review task ${effect.taskId} has a check for another commit. Request a new review for ${headSha}.`);
+	return checkRunId;
+}
+/** Create the supplied GitHub check-run and pull-request summary reporter for code reviews. */
+function createGitHubReviewReporter(options) {
+	const checkName = options.checkName ?? "Factory code review";
+	const summaryHeading = options.summaryHeading ?? "Factory code review";
+	const now = () => (options.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+	async function startReviewCheck(input) {
+		const token = await options.tokenForRepository(input.repository);
+		if (input.reuseExisting) {
+			const effect = await options.stores.taskEffects.get({
+				taskId: input.taskId,
+				key: reviewCheckEffectKey
+			});
+			if (recordedCheckRunId(effect, input.headSha) !== void 0 || effect?.resolvedAt !== void 0) return;
+			const existing = (await listCheckRunsForRef({
+				repository: input.repository,
+				token,
+				fetch: options.fetch,
+				ref: input.headSha,
+				checkName
+			})).find((check) => check.externalId === input.taskId);
+			if (existing !== void 0) {
+				await recordReviewCheck(input.taskId, existing.id, input.headSha);
+				return;
+			}
+		}
+		const checkRun = await createCheckRun({
+			repository: input.repository,
+			token,
+			fetch: options.fetch,
+			name: checkName,
+			headSha: input.headSha,
+			status: "in_progress",
+			externalId: input.taskId,
+			detailsUrl: input.pullRequestUrl,
+			startedAt: now(),
+			output: {
+				title: "Review in progress",
+				summary: "The Factory code reviewer is inspecting this commit."
+			}
+		});
+		await recordReviewCheck(input.taskId, checkRun.id, input.headSha);
+	}
+	async function completeReviewCheck(review) {
+		const token = await options.tokenForRepository(review.repository);
+		let checkRunId = recordedCheckRunId(await options.stores.taskEffects.get({
+			taskId: review.taskId,
+			key: reviewCheckEffectKey
+		}), review.headSha);
+		if (checkRunId === void 0) {
+			checkRunId = (await findReviewCheck(review, token)).id;
+			await recordReviewCheck(review.taskId, checkRunId, review.headSha);
+		}
+		await updateCheckRun({
+			repository: review.repository,
+			token,
+			fetch: options.fetch,
+			checkRunId,
+			status: "completed",
+			conclusion: review.verdict === "request_changes" ? "failure" : "success",
+			completedAt: now(),
+			output: {
+				title: review.verdict === "request_changes" ? "Review found blocking issues" : "Review complete",
+				summary: review.summary,
+				annotations: review.comments.map((comment) => ({
+					path: comment.path,
+					startLine: comment.startLine ?? comment.line,
+					endLine: comment.line,
+					annotationLevel: review.verdict === "request_changes" ? "failure" : "notice",
+					title: comment.title,
+					message: comment.body
+				}))
+			}
+		});
+		await options.stores.taskEffects.resolve({
+			taskId: review.taskId,
+			key: reviewCheckEffectKey
+		});
+		if (typeof options.publishSummary === "function" ? await options.publishSummary(review) : options.publishSummary !== false) await updateReviewSummary(review, token);
+	}
+	async function reconcileReviewChecks(input) {
+		const { tasks, ...reconcileOptions } = input;
+		const reconciliationNow = reconcileOptions.now ?? options.now ?? (() => /* @__PURE__ */ new Date());
+		const batchSize = reconcileOptions.batchSize ?? reviewCheckBatchSize;
+		if (!Number.isSafeInteger(batchSize) || batchSize <= 0) throw new Error("Review-check batch size must be a positive safe integer");
+		const candidates = tasks.filter((task) => task.work.route?.id === "code-review" && terminalReviewStates.has(task.state)).sort((left, right) => left.id.localeCompare(right.id));
+		const candidatePage = reconcileOptions.candidatePage ?? Math.floor(reconciliationNow().getTime() / reviewCheckPageIntervalMs);
+		if (!Number.isSafeInteger(candidatePage) || candidatePage < 0) throw new Error("Review-check candidate page must be a nonnegative safe integer");
+		const pageStart = candidatePage % Math.max(1, Math.ceil(candidates.length / batchSize)) * batchSize;
+		const page = candidates.slice(pageStart, pageStart + batchSize);
+		const pending = (await Promise.all(page.map(async (task) => ({
+			task,
+			effect: await options.stores.taskEffects.get({
+				taskId: task.id,
+				key: reviewCheckEffectKey
+			})
+		})))).filter(({ effect }) => effect?.resolvedAt === void 0);
+		const concluded = [];
+		const stamped = [];
+		for (const { task, effect } of pending) try {
+			if (await concludeAbandonedCheck(task, effect, reconciliationNow)) concluded.push(task.id);
+			await options.stores.taskEffects.resolve({
+				taskId: task.id,
+				key: reviewCheckEffectKey,
+				at: reconciliationNow().toISOString()
+			});
+			stamped.push(task.id);
+		} catch {}
+		return {
+			concluded,
+			stamped
+		};
+	}
+	async function recordReviewCheck(taskId, checkRunId, headSha) {
+		await options.stores.taskEffects.record({
+			taskId,
+			key: reviewCheckEffectKey,
+			reference: {
+				provider: "github",
+				resourceId: String(checkRunId),
+				subject: headSha
+			}
+		});
+	}
+	async function updateReviewSummary(review, token) {
+		const summary = findSummaryComment(await listPullRequestComments({
+			repository: review.repository,
+			token,
+			fetch: options.fetch,
+			pullRequestNumber: review.pullRequestNumber
+		}));
+		if (summary === void 0 && review.comments.length === 0) return;
+		const body = renderSummary({ active: review.comments.map(toFinding).sort(compareFindings) });
+		if ((await readPullRequestHead({
+			repository: review.repository,
+			token,
+			fetch: options.fetch,
+			pullRequestNumber: review.pullRequestNumber
+		})).sha !== review.headSha) return;
+		if (summary === void 0) await createPullRequestComment({
+			repository: review.repository,
+			token,
+			fetch: options.fetch,
+			pullRequestNumber: review.pullRequestNumber,
+			body
+		});
+		else if (summary.body !== body) await updatePullRequestComment({
+			repository: review.repository,
+			token,
+			fetch: options.fetch,
+			commentId: summary.id,
+			body
+		});
+	}
+	function renderSummary(state) {
+		const lines = [
+			summaryMarker,
+			`## ${summaryHeading}`,
+			""
+		];
+		if (state.active.length > 0) lines.push(`${state.active.length} open`, "", "### Open findings", "", ...state.active.flatMap((finding) => [`- **${finding.title}** at \`${finding.path}:${finding.line}\``, `  ${finding.body.replaceAll("\n", "\n  ")}`]));
+		else lines.push("✅ All findings resolved.");
+		lines.push("", encodeState(state));
+		return lines.join("\n");
+	}
+	async function findReviewCheck(review, token) {
+		const checkRun = (await listCheckRunsForRef({
+			repository: review.repository,
+			token,
+			fetch: options.fetch,
+			ref: review.headSha,
+			checkName
+		})).find((candidate) => candidate.externalId === review.taskId);
+		if (checkRun === void 0) throw new Error(`could not find ${checkName} check for task ${review.taskId} on ${review.headSha}`);
+		return checkRun;
+	}
+	async function concludeAbandonedCheck(task, effect, reconciliationNow) {
+		const change = task.changeId === void 0 ? null : await options.stores.changes.get(task.changeId);
+		if (change === null) return false;
+		const repository = await options.stores.repositories.get(change.repositoryId);
+		if (repository === null) return false;
+		const token = await options.tokenForRepository(repository.slug);
+		const checkRunId = recordedCheckRunId(effect) ?? await discoverCheckRun(repository.slug, token, task, change.prNumber);
+		if (checkRunId === void 0) return false;
+		const cancelled = task.state === "cancelled";
+		await updateCheckRun({
+			repository: repository.slug,
+			token,
+			fetch: options.fetch,
+			checkRunId,
+			status: "completed",
+			conclusion: cancelled ? "cancelled" : "neutral",
+			completedAt: reconciliationNow().toISOString(),
+			output: {
+				title: cancelled ? "Review cancelled" : "Review did not complete",
+				summary: `The Factory code reviewer ended as ${task.state} without recording a verdict. Push a new commit to request a fresh review.`
+			}
+		});
+		return true;
+	}
+	async function discoverCheckRun(repository, token, task, pullRequestNumber) {
+		const head = await readPullRequestHead({
+			repository,
+			token,
+			fetch: options.fetch,
+			pullRequestNumber
+		});
+		return (await listCheckRunsForRef({
+			repository,
+			token,
+			fetch: options.fetch,
+			ref: head.sha,
+			checkName
+		})).find((candidate) => candidate.externalId === task.id && candidate.status !== "completed")?.id;
+	}
+	return Object.freeze({
+		startReviewCheck,
+		completeReviewCheck,
+		reconcileReviewChecks
+	});
+}
+function findSummaryComment(comments) {
+	return comments.find((comment) => comment.authorType === "Bot" && comment.body.includes(summaryMarker));
+}
+function toFinding(finding) {
+	return {
+		fingerprint: finding.fingerprint,
+		title: finding.title.replaceAll(/\s+/g, " ").trim().slice(0, 60),
+		path: finding.path.replaceAll("`", "'").slice(0, 120),
+		line: finding.line,
+		body: finding.body.trim()
+	};
+}
+function encodeState(state) {
+	return `${statePrefix}${Buffer.from(JSON.stringify(state)).toString("base64url")}${stateSuffix}`;
+}
+function compareFindings(left, right) {
+	return left.path.localeCompare(right.path) || left.line - right.line;
+}
+//#endregion
+export { createGitHubReviewReporter };
+
+//# sourceMappingURL=github-reporter.mjs.map

package/dist/code-review/github-reporter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-reporter.mjs","names":[],"sources":["../../src/code-review/github-reporter.ts"],"sourcesContent":["import {\n  createCheckRun,\n  createPullRequestComment,\n  listCheckRunsForRef,\n  listPullRequestComments,\n  readPullRequestHead,\n  updateCheckRun,\n  updatePullRequestComment,\n  type GitHubIssueComment,\n} from \"../github\";\nimport type { TaskId } from \"../schema/id\";\nimport type { Task } from \"../schema/task\";\nimport type { TaskEffect } from \"../schema/task-effect\";\nimport type { FactoryStores } from \"../store/engine\";\nimport type { DateClock } from \"../schema/common\";\nimport type { RepositorySlug } from \"../schema/repository\";\nimport type { CompletedReview, CompletedReviewFinding } from \"./contracts\";\nimport type { StartReviewCheckInput } from \"./preparation\";\n\n/** Storage, credentials, and presentation settings for GitHub review reporting. */\nexport interface GitHubReviewReporterOptions {\n  stores: Pick<FactoryStores, \"taskEffects\" | \"changes\" | \"repositories\">;\n  tokenForRepository(repositorySlug: RepositorySlug): Promise<string>;\n  fetch?: typeof globalThis.fetch;\n  checkName?: string;\n  summaryHeading?: string;\n  /** Whether to maintain a separate finding-summary comment. Defaults to true. */\n  publishSummary?: boolean | ((review: CompletedReview) => boolean | Promise<boolean>);\n  now?: DateClock;\n}\n\n/** Check-run and pull-request summary lifecycle for supplied code reviews. */\nexport interface GitHubReviewReporter {\n  startReviewCheck(input: StartReviewCheckInput): Promise<void>;\n  completeReviewCheck(review: CompletedReview): Promise<void>;\n  reconcileReviewChecks(input: ReconcileReviewChecksInput): Promise<ReconcileReviewChecksResult>;\n}\n\n/** Bounded rotating-page controls for abandoned review-check recovery. */\nexport interface ReconcileReviewChecksOptions {\n  batchSize?: number;\n  /** Stable page selector; defaults to the current five-minute recovery window. */\n  candidatePage?: number;\n  now?: DateClock;\n}\n\n/** Review Tasks and bounded recovery controls for one reconciliation pass. */\nexport interface ReconcileReviewChecksInput extends ReconcileReviewChecksOptions {\n  tasks: readonly Task[];\n}\n\n/** Review Tasks whose check effects were concluded or durably resolved in one pass. */\nexport interface ReconcileReviewChecksResult {\n  concluded: readonly TaskId[];\n  stamped: readonly TaskId[];\n}\n\ninterface ReviewFinding {\n  fingerprint: string;\n  title: string;\n  path: string;\n  line: number;\n  body: string;\n}\n\ninterface ReviewSummaryState {\n  active: ReviewFinding[];\n}\n\nconst summaryMarker = \"<!-- factory-code-review-summary -->\";\nconst statePrefix = \"<!-- factory-code-review-state:v1:\";\nconst stateSuffix = \" -->\";\nconst terminalReviewStates: ReadonlySet<Task[\"state\"]> = new Set([\"cancelled\", \"failed\"]);\nconst reviewCheckBatchSize = 20;\nconst reviewCheckPageIntervalMs = 300_000;\nconst reviewCheckEffectKey = {\n  namespace: \"software\",\n  name: \"github_review_check\",\n} as const;\n\nfunction recordedCheckRunId(effect: TaskEffect | null, headSha?: string): number | undefined {\n  if (effect?.reference === undefined) return undefined;\n  const { provider, resourceId } = effect.reference;\n  const checkRunId = Number(resourceId);\n  if (provider !== \"github\" || !Number.isSafeInteger(checkRunId) || checkRunId <= 0) {\n    throw new Error(\n      \"Stored software review-check effect has an invalid GitHub check-run reference\",\n    );\n  }\n  if (headSha !== undefined && effect.reference.subject !== headSha) {\n    throw new Error(\n      `Review task ${effect.taskId} has a check for another commit. Request a new review for ${headSha}.`,\n    );\n  }\n  return checkRunId;\n}\n\n/** Create the supplied GitHub check-run and pull-request summary reporter for code reviews. */\nexport function createGitHubReviewReporter(\n  options: GitHubReviewReporterOptions,\n): GitHubReviewReporter {\n  const checkName = options.checkName ?? \"Factory code review\";\n  const summaryHeading = options.summaryHeading ?? \"Factory code review\";\n  const now = () => (options.now ?? (() => new Date()))().toISOString();\n\n  async function startReviewCheck(input: StartReviewCheckInput): Promise<void> {\n    const token = await options.tokenForRepository(input.repository);\n    if (input.reuseExisting) {\n      const effect = await options.stores.taskEffects.get({\n        taskId: input.taskId,\n        key: reviewCheckEffectKey,\n      });\n      if (\n        recordedCheckRunId(effect, input.headSha) !== undefined ||\n        effect?.resolvedAt !== undefined\n      )\n        return;\n      const checks = await listCheckRunsForRef({\n        repository: input.repository,\n        token,\n        fetch: options.fetch,\n        ref: input.headSha,\n        checkName,\n      });\n      const existing = checks.find((check) => check.externalId === input.taskId);\n      if (existing !== undefined) {\n        await recordReviewCheck(input.taskId, existing.id, input.headSha);\n        return;\n      }\n    }\n    const checkRun = await createCheckRun({\n      repository: input.repository,\n      token,\n      fetch: options.fetch,\n      name: checkName,\n      headSha: input.headSha,\n      status: \"in_progress\",\n      externalId: input.taskId,\n      detailsUrl: input.pullRequestUrl,\n      startedAt: now(),\n      output: {\n        title: \"Review in progress\",\n        summary: \"The Factory code reviewer is inspecting this commit.\",\n      },\n    });\n    await recordReviewCheck(input.taskId, checkRun.id, input.headSha);\n  }\n\n  async function completeReviewCheck(review: CompletedReview): Promise<void> {\n    const token = await options.tokenForRepository(review.repository);\n    const effect = await options.stores.taskEffects.get({\n      taskId: review.taskId,\n      key: reviewCheckEffectKey,\n    });\n    let checkRunId = recordedCheckRunId(effect, review.headSha);\n    if (checkRunId === undefined) {\n      checkRunId = (await findReviewCheck(review, token)).id;\n      await recordReviewCheck(review.taskId, checkRunId, review.headSha);\n    }\n    await updateCheckRun({\n      repository: review.repository,\n      token,\n      fetch: options.fetch,\n      checkRunId,\n      status: \"completed\",\n      conclusion: review.verdict === \"request_changes\" ? \"failure\" : \"success\",\n      completedAt: now(),\n      output: {\n        title:\n          review.verdict === \"request_changes\" ? \"Review found blocking issues\" : \"Review complete\",\n        summary: review.summary,\n        annotations: review.comments.map((comment) => ({\n          path: comment.path,\n          startLine: comment.startLine ?? comment.line,\n          endLine: comment.line,\n          annotationLevel: review.verdict === \"request_changes\" ? \"failure\" : \"notice\",\n          title: comment.title,\n          message: comment.body,\n        })),\n      },\n    });\n    await options.stores.taskEffects.resolve({\n      taskId: review.taskId,\n      key: reviewCheckEffectKey,\n    });\n    const publishSummary =\n      typeof options.publishSummary === \"function\"\n        ? await options.publishSummary(review)\n        : options.publishSummary !== false;\n    if (publishSummary) await updateReviewSummary(review, token);\n  }\n\n  async function reconcileReviewChecks(\n    input: ReconcileReviewChecksInput,\n  ): Promise<ReconcileReviewChecksResult> {\n    const { tasks, ...reconcileOptions } = input;\n    const reconciliationNow = reconcileOptions.now ?? options.now ?? (() => new Date());\n    const batchSize = reconcileOptions.batchSize ?? reviewCheckBatchSize;\n    if (!Number.isSafeInteger(batchSize) || batchSize <= 0) {\n      throw new Error(\"Review-check batch size must be a positive safe integer\");\n    }\n    const candidates = tasks\n      .filter(\n        (task) => task.work.route?.id === \"code-review\" && terminalReviewStates.has(task.state),\n      )\n      .sort((left, right) => left.id.localeCompare(right.id));\n    const candidatePage =\n      reconcileOptions.candidatePage ??\n      Math.floor(reconciliationNow().getTime() / reviewCheckPageIntervalMs);\n    if (!Number.isSafeInteger(candidatePage) || candidatePage < 0) {\n      throw new Error(\"Review-check candidate page must be a nonnegative safe integer\");\n    }\n    const pageCount = Math.max(1, Math.ceil(candidates.length / batchSize));\n    const pageStart = (candidatePage % pageCount) * batchSize;\n    const page = candidates.slice(pageStart, pageStart + batchSize);\n    const pending = (\n      await Promise.all(\n        page.map(async (task) => ({\n          task,\n          effect: await options.stores.taskEffects.get({\n            taskId: task.id,\n            key: reviewCheckEffectKey,\n          }),\n        })),\n      )\n    ).filter(({ effect }) => effect?.resolvedAt === undefined);\n    const concluded: TaskId[] = [];\n    const stamped: TaskId[] = [];\n    for (const { task, effect } of pending) {\n      try {\n        if (await concludeAbandonedCheck(task, effect, reconciliationNow)) concluded.push(task.id);\n        await options.stores.taskEffects.resolve({\n          taskId: task.id,\n          key: reviewCheckEffectKey,\n          at: reconciliationNow().toISOString(),\n        });\n        stamped.push(task.id);\n      } catch {\n        // A failed provider operation leaves the stamp absent so the next pass retries it.\n      }\n    }\n    return { concluded, stamped };\n  }\n\n  async function recordReviewCheck(taskId: TaskId, checkRunId: number, headSha: string) {\n    await options.stores.taskEffects.record({\n      taskId,\n      key: reviewCheckEffectKey,\n      reference: {\n        provider: \"github\",\n        resourceId: String(checkRunId),\n        subject: headSha,\n      },\n    });\n  }\n\n  async function updateReviewSummary(review: CompletedReview, token: string): Promise<void> {\n    const comments = await listPullRequestComments({\n      repository: review.repository,\n      token,\n      fetch: options.fetch,\n      pullRequestNumber: review.pullRequestNumber,\n    });\n    const summary = findSummaryComment(comments);\n    if (summary === undefined && review.comments.length === 0) return;\n\n    const body = renderSummary({ active: review.comments.map(toFinding).sort(compareFindings) });\n    const head = await readPullRequestHead({\n      repository: review.repository,\n      token,\n      fetch: options.fetch,\n      pullRequestNumber: review.pullRequestNumber,\n    });\n    if (head.sha !== review.headSha) return;\n\n    if (summary === undefined) {\n      await createPullRequestComment({\n        repository: review.repository,\n        token,\n        fetch: options.fetch,\n        pullRequestNumber: review.pullRequestNumber,\n        body,\n      });\n    } else if (summary.body !== body) {\n      await updatePullRequestComment({\n        repository: review.repository,\n        token,\n        fetch: options.fetch,\n        commentId: summary.id,\n        body,\n      });\n    }\n  }\n\n  function renderSummary(state: ReviewSummaryState): string {\n    const lines = [summaryMarker, `## ${summaryHeading}`, \"\"];\n    if (state.active.length > 0) {\n      lines.push(\n        `${state.active.length} open`,\n        \"\",\n        \"### Open findings\",\n        \"\",\n        ...state.active.flatMap((finding) => [\n          `- **${finding.title}** at \\`${finding.path}:${finding.line}\\``,\n          `  ${finding.body.replaceAll(\"\\n\", \"\\n  \")}`,\n        ]),\n      );\n    } else {\n      lines.push(\"✅ All findings resolved.\");\n    }\n    lines.push(\"\", encodeState(state));\n    return lines.join(\"\\n\");\n  }\n\n  async function findReviewCheck(review: CompletedReview, token: string) {\n    const checkRuns = await listCheckRunsForRef({\n      repository: review.repository,\n      token,\n      fetch: options.fetch,\n      ref: review.headSha,\n      checkName,\n    });\n    const checkRun = checkRuns.find((candidate) => candidate.externalId === review.taskId);\n    if (checkRun === undefined) {\n      throw new Error(\n        `could not find ${checkName} check for task ${review.taskId} on ${review.headSha}`,\n      );\n    }\n    return checkRun;\n  }\n\n  async function concludeAbandonedCheck(\n    task: Task,\n    effect: TaskEffect | null,\n    reconciliationNow: () => Date,\n  ) {\n    const change =\n      task.changeId === undefined ? null : await options.stores.changes.get(task.changeId);\n    if (change === null) return false;\n    const repository = await options.stores.repositories.get(change.repositoryId);\n    if (repository === null) return false;\n    const token = await options.tokenForRepository(repository.slug);\n    const checkRunId =\n      recordedCheckRunId(effect) ??\n      (await discoverCheckRun(repository.slug, token, task, change.prNumber));\n    if (checkRunId === undefined) return false;\n    const cancelled = task.state === \"cancelled\";\n    await updateCheckRun({\n      repository: repository.slug,\n      token,\n      fetch: options.fetch,\n      checkRunId,\n      status: \"completed\",\n      conclusion: cancelled ? \"cancelled\" : \"neutral\",\n      completedAt: reconciliationNow().toISOString(),\n      output: {\n        title: cancelled ? \"Review cancelled\" : \"Review did not complete\",\n        summary: `The Factory code reviewer ended as ${task.state} without recording a verdict. Push a new commit to request a fresh review.`,\n      },\n    });\n    return true;\n  }\n\n  async function discoverCheckRun(\n    repository: RepositorySlug,\n    token: string,\n    task: Task,\n    pullRequestNumber: number,\n  ): Promise<number | undefined> {\n    const head = await readPullRequestHead({\n      repository,\n      token,\n      fetch: options.fetch,\n      pullRequestNumber,\n    });\n    const checkRuns = await listCheckRunsForRef({\n      repository,\n      token,\n      fetch: options.fetch,\n      ref: head.sha,\n      checkName,\n    });\n    return checkRuns.find(\n      (candidate) => candidate.externalId === task.id && candidate.status !== \"completed\",\n    )?.id;\n  }\n\n  return Object.freeze({ startReviewCheck, completeReviewCheck, reconcileReviewChecks });\n}\n\nfunction findSummaryComment(\n  comments: readonly GitHubIssueComment[],\n): GitHubIssueComment | undefined {\n  return comments.find(\n    (comment) => comment.authorType === \"Bot\" && comment.body.includes(summaryMarker),\n  );\n}\n\nfunction toFinding(finding: CompletedReviewFinding): ReviewFinding {\n  return {\n    fingerprint: finding.fingerprint,\n    title: finding.title.replaceAll(/\\s+/g, \" \").trim().slice(0, 60),\n    path: finding.path.replaceAll(\"`\", \"'\").slice(0, 120),\n    line: finding.line,\n    body: finding.body.trim(),\n  };\n}\n\nfunction encodeState(state: ReviewSummaryState): string {\n  return `${statePrefix}${Buffer.from(JSON.stringify(state)).toString(\"base64url\")}${stateSuffix}`;\n}\n\nfunction compareFindings(left: ReviewFinding, right: ReviewFinding): number {\n  return left.path.localeCompare(right.path) || left.line - right.line;\n}\n"],"mappings":"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"}

package/dist/code-review/preparation.d.mts

@@ -0,0 +1,34 @@
+import { TaskId } from "../schema/id.mjs";
+import { RepositorySlug } from "../schema/repository.mjs";
+import { Task } from "../schema/task.mjs";
+import { FactoryStores } from "../store/engine.mjs";
+//#region src/code-review/preparation.d.ts
+/** Commit-fenced pull-request details used to begin a review check run. */
+interface StartReviewCheckInput {
+  repository: RepositorySlug;
+  headSha: string;
+  taskId: TaskId;
+  pullRequestUrl: string;
+  reuseExisting?: boolean;
+}
+/** Provider operations used to fence and initialize a pull-request review. */
+interface PreparePullRequestReviewOptions {
+  readHead(input: ReadPullRequestReviewHeadInput): Promise<string>;
+  startCheck(input: Omit<StartReviewCheckInput, "reuseExisting">): Promise<void>;
+}
+/** Repository and pull-request identity used to read a review target head. */
+interface ReadPullRequestReviewHeadInput {
+  repository: RepositorySlug;
+  pullRequestNumber: number;
+}
+/** Stores, Task, message, and provider operations used to prepare one review. */
+interface PreparePullRequestReviewInput extends PreparePullRequestReviewOptions {
+  stores: Pick<FactoryStores, "changes" | "repositories">;
+  task: Task;
+  message: string;
+}
+/** Prepare the linked pull request head and reporting check before launching a reviewer. */
+declare function preparePullRequestReview(input: PreparePullRequestReviewInput): Promise<string>;
+//#endregion
+export { PreparePullRequestReviewInput, PreparePullRequestReviewOptions, ReadPullRequestReviewHeadInput, StartReviewCheckInput, preparePullRequestReview };
+//# sourceMappingURL=preparation.d.mts.map

package/dist/code-review/preparation.mjs

@@ -0,0 +1,23 @@
+//#region src/code-review/preparation.ts
+/** Prepare the linked pull request head and reporting check before launching a reviewer. */
+async function preparePullRequestReview(input) {
+	const change = input.task.changeId === void 0 ? null : await input.stores.changes.get(input.task.changeId);
+	if (change === null || input.task.repositoryIds.length !== 1 || change.repositoryId !== input.task.repositoryIds[0]) throw new Error("Code review requires its linked Change");
+	const repository = await input.stores.repositories.get(change.repositoryId);
+	if (repository === null || !repository.enabled) throw new Error("Code review repository is unavailable");
+	const headSha = await input.readHead({
+		repository: repository.slug,
+		pullRequestNumber: change.prNumber
+	});
+	await input.startCheck({
+		repository: repository.slug,
+		headSha,
+		taskId: input.task.id,
+		pullRequestUrl: change.prUrl
+	});
+	return `${input.message}\n\nPull request: ${change.prUrl}.\nExpected head commit: ${headSha}.\nReview only this head and finish with record_post_review.`;
+}
+//#endregion
+export { preparePullRequestReview };
+
+//# sourceMappingURL=preparation.mjs.map

package/dist/code-review/preparation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.mjs","names":[],"sources":["../../src/code-review/preparation.ts"],"sourcesContent":["import type { TaskId } from \"../schema/id\";\nimport type { RepositorySlug } from \"../schema/repository\";\nimport type { Task } from \"../schema/task\";\nimport type { FactoryStores } from \"../store/engine\";\n\n/** Commit-fenced pull-request details used to begin a review check run. */\nexport interface StartReviewCheckInput {\n  repository: RepositorySlug;\n  headSha: string;\n  taskId: TaskId;\n  pullRequestUrl: string;\n  reuseExisting?: boolean;\n}\n\n/** Provider operations used to fence and initialize a pull-request review. */\nexport interface PreparePullRequestReviewOptions {\n  readHead(input: ReadPullRequestReviewHeadInput): Promise<string>;\n  startCheck(input: Omit<StartReviewCheckInput, \"reuseExisting\">): Promise<void>;\n}\n\n/** Repository and pull-request identity used to read a review target head. */\nexport interface ReadPullRequestReviewHeadInput {\n  repository: RepositorySlug;\n  pullRequestNumber: number;\n}\n\n/** Stores, Task, message, and provider operations used to prepare one review. */\nexport interface PreparePullRequestReviewInput extends PreparePullRequestReviewOptions {\n  stores: Pick<FactoryStores, \"changes\" | \"repositories\">;\n  task: Task;\n  message: string;\n}\n\n/** Prepare the linked pull request head and reporting check before launching a reviewer. */\nexport async function preparePullRequestReview(\n  input: PreparePullRequestReviewInput,\n): Promise<string> {\n  const change =\n    input.task.changeId === undefined ? null : await input.stores.changes.get(input.task.changeId);\n  if (\n    change === null ||\n    input.task.repositoryIds.length !== 1 ||\n    change.repositoryId !== input.task.repositoryIds[0]\n  ) {\n    throw new Error(\"Code review requires its linked Change\");\n  }\n  const repository = await input.stores.repositories.get(change.repositoryId);\n  if (repository === null || !repository.enabled) {\n    throw new Error(\"Code review repository is unavailable\");\n  }\n  const headSha = await input.readHead({\n    repository: repository.slug,\n    pullRequestNumber: change.prNumber,\n  });\n  await input.startCheck({\n    repository: repository.slug,\n    headSha,\n    taskId: input.task.id,\n    pullRequestUrl: change.prUrl,\n  });\n  return `${input.message}\\n\\nPull request: ${change.prUrl}.\\nExpected head commit: ${headSha}.\\nReview only this head and finish with record_post_review.`;\n}\n"],"mappings":";;AAkCA,eAAsB,yBACpB,OACiB;CACjB,MAAM,SACJ,MAAM,KAAK,aAAa,KAAA,IAAY,OAAO,MAAM,MAAM,OAAO,QAAQ,IAAI,MAAM,KAAK,QAAQ;CAC/F,IACE,WAAW,QACX,MAAM,KAAK,cAAc,WAAW,KACpC,OAAO,iBAAiB,MAAM,KAAK,cAAc,IAEjD,MAAM,IAAI,MAAM,wCAAwC;CAE1D,MAAM,aAAa,MAAM,MAAM,OAAO,aAAa,IAAI,OAAO,YAAY;CAC1E,IAAI,eAAe,QAAQ,CAAC,WAAW,SACrC,MAAM,IAAI,MAAM,uCAAuC;CAEzD,MAAM,UAAU,MAAM,MAAM,SAAS;EACnC,YAAY,WAAW;EACvB,mBAAmB,OAAO;CAC5B,CAAC;CACD,MAAM,MAAM,WAAW;EACrB,YAAY,WAAW;EACvB;EACA,QAAQ,MAAM,KAAK;EACnB,gBAAgB,OAAO;CACzB,CAAC;CACD,OAAO,GAAG,MAAM,QAAQ,oBAAoB,OAAO,MAAM,2BAA2B,QAAQ;AAC9F"}

package/dist/code-review/stall.d.mts

@@ -0,0 +1,17 @@
+import { TaskId } from "../schema/id.mjs";
+import { FactoryStores } from "../store/engine.mjs";
+import { StallSweepOptions, TaskStallSweepResult } from "../stall.mjs";
+//#region src/code-review/stall.d.ts
+/** Task capability required by code-review stall supersession. */
+type CodeReviewStallSweepStores = Pick<FactoryStores, "tasks">;
+/** Generic stall-sweep controls with the supplied review supersession policy fixed. */
+type SweepCodeReviewStallsOptions = Omit<StallSweepOptions, "cancelStalled">;
+/** Generic stall results with obsolete code reviews reported as superseded. */
+interface SweepCodeReviewStallsResult extends Omit<TaskStallSweepResult, "cancelled"> {
+  readonly superseded: readonly TaskId[];
+}
+/** Apply the supplied code-review supersession policy around the generic stall sweep. */
+declare function sweepCodeReviewStalls(stores: CodeReviewStallSweepStores, options: SweepCodeReviewStallsOptions): Promise<SweepCodeReviewStallsResult>;
+//#endregion
+export { CodeReviewStallSweepStores, SweepCodeReviewStallsOptions, SweepCodeReviewStallsResult, sweepCodeReviewStalls };
+//# sourceMappingURL=stall.d.mts.map

package/dist/code-review/stall.mjs

@@ -0,0 +1,30 @@
+import { sweepTaskStalls } from "../stall.mjs";
+//#region src/code-review/stall.ts
+const supersedingReviewStates = /* @__PURE__ */ new Set([
+	"queued",
+	"running",
+	"stalled",
+	"needs_human"
+]);
+function supersedingCodeReview(task, tasks) {
+	if (task.work.route?.id !== "code-review" || task.changeId === void 0) return void 0;
+	return tasks.find((candidate) => candidate.id !== task.id && candidate.work.route?.id === "code-review" && !candidate.waitingForMessages && candidate.changeId === task.changeId && supersedingReviewStates.has(candidate.state) && Date.parse(candidate.createdAt) > Date.parse(task.createdAt));
+}
+/** Apply the supplied code-review supersession policy around the generic stall sweep. */
+async function sweepCodeReviewStalls(stores, options) {
+	const { cancelled: superseded, ...generic } = await sweepTaskStalls(stores, {
+		...options,
+		cancelStalled(task, tasks) {
+			const successor = supersedingCodeReview(task, tasks);
+			return successor === void 0 ? null : `review superseded by newer commits: task ${successor.id} reviews the current head`;
+		}
+	});
+	return {
+		...generic,
+		superseded
+	};
+}
+//#endregion
+export { sweepCodeReviewStalls };
+
+//# sourceMappingURL=stall.mjs.map

package/dist/code-review/stall.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall.mjs","names":[],"sources":["../../src/code-review/stall.ts"],"sourcesContent":["import type { TaskId } from \"../schema/id\";\nimport type { Task } from \"../schema/task\";\nimport type { FactoryStores } from \"../store/engine\";\nimport { sweepTaskStalls, type StallSweepOptions, type TaskStallSweepResult } from \"../stall\";\n\n/** Task capability required by code-review stall supersession. */\nexport type CodeReviewStallSweepStores = Pick<FactoryStores, \"tasks\">;\n\nconst supersedingReviewStates: ReadonlySet<Task[\"state\"]> = new Set([\n  \"queued\",\n  \"running\",\n  \"stalled\",\n  \"needs_human\",\n]);\n\nfunction supersedingCodeReview(task: Task, tasks: readonly Task[]): Task | undefined {\n  if (task.work.route?.id !== \"code-review\" || task.changeId === undefined) return undefined;\n  return tasks.find(\n    (candidate) =>\n      candidate.id !== task.id &&\n      candidate.work.route?.id === \"code-review\" &&\n      !candidate.waitingForMessages &&\n      candidate.changeId === task.changeId &&\n      supersedingReviewStates.has(candidate.state) &&\n      Date.parse(candidate.createdAt) > Date.parse(task.createdAt),\n  );\n}\n\n/** Generic stall-sweep controls with the supplied review supersession policy fixed. */\nexport type SweepCodeReviewStallsOptions = Omit<StallSweepOptions, \"cancelStalled\">;\n\n/** Generic stall results with obsolete code reviews reported as superseded. */\nexport interface SweepCodeReviewStallsResult extends Omit<TaskStallSweepResult, \"cancelled\"> {\n  readonly superseded: readonly TaskId[];\n}\n\n/** Apply the supplied code-review supersession policy around the generic stall sweep. */\nexport async function sweepCodeReviewStalls(\n  stores: CodeReviewStallSweepStores,\n  options: SweepCodeReviewStallsOptions,\n): Promise<SweepCodeReviewStallsResult> {\n  const result = await sweepTaskStalls(stores, {\n    ...options,\n    cancelStalled(task, tasks) {\n      const successor = supersedingCodeReview(task, tasks);\n      return successor === undefined\n        ? null\n        : `review superseded by newer commits: task ${successor.id} reviews the current head`;\n    },\n  });\n  const { cancelled: superseded, ...generic } = result;\n  return { ...generic, superseded };\n}\n"],"mappings":";;AAQA,MAAM,0CAAsD,IAAI,IAAI;CAClE;CACA;CACA;CACA;AACF,CAAC;AAED,SAAS,sBAAsB,MAAY,OAA0C;CACnF,IAAI,KAAK,KAAK,OAAO,OAAO,iBAAiB,KAAK,aAAa,KAAA,GAAW,OAAO,KAAA;CACjF,OAAO,MAAM,MACV,cACC,UAAU,OAAO,KAAK,MACtB,UAAU,KAAK,OAAO,OAAO,iBAC7B,CAAC,UAAU,sBACX,UAAU,aAAa,KAAK,YAC5B,wBAAwB,IAAI,UAAU,KAAK,KAC3C,KAAK,MAAM,UAAU,SAAS,IAAI,KAAK,MAAM,KAAK,SAAS,CAC/D;AACF;;AAWA,eAAsB,sBACpB,QACA,SACsC;CAUtC,MAAM,EAAE,WAAW,YAAY,GAAG,YAAY,MATzB,gBAAgB,QAAQ;EAC3C,GAAG;EACH,cAAc,MAAM,OAAO;GACzB,MAAM,YAAY,sBAAsB,MAAM,KAAK;GACnD,OAAO,cAAc,KAAA,IACjB,OACA,4CAA4C,UAAU,GAAG;EAC/D;CACF,CAAC;CAED,OAAO;EAAE,GAAG;EAAS;CAAW;AAClC"}

package/dist/code-review.d.mts

@@ -0,0 +1,7 @@
+/// <reference types="node" />
+import { CompletedReview, CompletedReviewFinding } from "./code-review/contracts.mjs";
+import { GitHubPostReviewCommentInput, GitHubPostReviewFailureCode, GitHubPostReviewInput, GitHubPostReviewResult, GitHubPostReviewTool, GitHubPostReviewToolOptions, GitHubPostReviewToolStores, createGitHubPostReviewTool } from "./code-review/eve-post-review.mjs";
+import { GitHubAnswerReviewCommentInput, GitHubApplyReviewFixInput, GitHubApplyReviewFixResult, GitHubListPullRequestDiscussionInput, GitHubReadReviewCommentInput, GitHubReviewCommentTools, GitHubReviewCommentToolsOptions, GitHubReviewCommentToolsStores, GitHubSuggestReviewFixInput, createGitHubReviewCommentTools } from "./code-review/eve-review-comments.mjs";
+import { PreparePullRequestReviewInput, PreparePullRequestReviewOptions, ReadPullRequestReviewHeadInput, StartReviewCheckInput, preparePullRequestReview } from "./code-review/preparation.mjs";
+import { CodeReviewStallSweepStores, SweepCodeReviewStallsOptions, SweepCodeReviewStallsResult, sweepCodeReviewStalls } from "./code-review/stall.mjs";
+export { type CodeReviewStallSweepStores, type CompletedReview, type CompletedReviewFinding, type GitHubAnswerReviewCommentInput, type GitHubApplyReviewFixInput, type GitHubApplyReviewFixResult, type GitHubListPullRequestDiscussionInput, type GitHubPostReviewCommentInput, type GitHubPostReviewFailureCode, type GitHubPostReviewInput, type GitHubPostReviewResult, type GitHubPostReviewTool, type GitHubPostReviewToolOptions, type GitHubPostReviewToolStores, type GitHubReadReviewCommentInput, type GitHubReviewCommentTools, type GitHubReviewCommentToolsOptions, type GitHubReviewCommentToolsStores, type GitHubSuggestReviewFixInput, type PreparePullRequestReviewInput, type PreparePullRequestReviewOptions, type ReadPullRequestReviewHeadInput, type StartReviewCheckInput, type SweepCodeReviewStallsOptions, type SweepCodeReviewStallsResult, createGitHubPostReviewTool, createGitHubReviewCommentTools, preparePullRequestReview, sweepCodeReviewStalls };

package/dist/code-review.mjs

@@ -0,0 +1,5 @@
+import { createGitHubPostReviewTool } from "./code-review/eve-post-review.mjs";
+import { createGitHubReviewCommentTools } from "./code-review/eve-review-comments.mjs";
+import { preparePullRequestReview } from "./code-review/preparation.mjs";
+import { sweepCodeReviewStalls } from "./code-review/stall.mjs";
+export { createGitHubPostReviewTool, createGitHubReviewCommentTools, preparePullRequestReview, sweepCodeReviewStalls };

package/dist/communication.d.mts

@@ -0,0 +1,9 @@
+import { OutboxId, outboxIdSchema } from "./schema/id.mjs";
+import { ReplyTo, replyToSchema } from "./schema/common.mjs";
+import { CommunicationEvent, CommunicationOutcome, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes } from "./schema/communication.mjs";
+import { OutboxMessage, OutboxQueue, outboxMessageSchema, outboxQueueSchema, outboxStateSchema } from "./schema/outbox.mjs";
+import { OutboxEventConflictError, RetryOutboxMessageInput } from "./store/engine.mjs";
+import { CommunicationOutboxStores, CreateOutboxCommunicationRouterOptions, OutboxDeliveryOptions, OutboxSweepResult, SweepCommunicationOutboxOptions, createOutboxCommunicationRouter, sweepCommunicationOutbox } from "./connectors/outbox.mjs";
+import { CommunicationAdapter, CommunicationRouter, NormalizedSignal, SignalNormalizer, WebhookEvent, createCommunicationRouter } from "./connectors/index.mjs";
+import { TaskCommunicationProjection, TaskCommunicationReconciler, TaskCommunicationResult, TaskCommunicationStores, TaskLifecycleProjectionInput, createTaskCommunicationReconciler } from "./task-communication.mjs";
+export { type CommunicationAdapter, type CommunicationEvent, type CommunicationOutboxStores, type CommunicationOutcome, type CommunicationRouter, type CreateOutboxCommunicationRouterOptions, type NormalizedSignal, type OutboxDeliveryOptions, OutboxEventConflictError, type OutboxId, type OutboxMessage, type OutboxQueue, type OutboxSweepResult, type ReplyTo, type RetryOutboxMessageInput, type SignalNormalizer, type SweepCommunicationOutboxOptions, type TaskCommunicationProjection, type TaskCommunicationReconciler, type TaskCommunicationResult, type TaskCommunicationStores, type TaskLifecycleProjectionInput, type WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter, createOutboxCommunicationRouter, createTaskCommunicationReconciler, outboxIdSchema, outboxMessageSchema, outboxQueueSchema, outboxStateSchema, replyToSchema, sweepCommunicationOutbox };

package/dist/communication.mjs

@@ -0,0 +1,9 @@
+import { outboxIdSchema } from "./schema/id.mjs";
+import { replyToSchema } from "./schema/common.mjs";
+import { communicationEventSchema, communicationOutcomeSchema, communicationOutcomes } from "./schema/communication.mjs";
+import { outboxMessageSchema, outboxQueueSchema, outboxStateSchema } from "./schema/outbox.mjs";
+import { OutboxEventConflictError } from "./store/engine.mjs";
+import { createOutboxCommunicationRouter, sweepCommunicationOutbox } from "./connectors/outbox.mjs";
+import { createCommunicationRouter } from "./connectors/index.mjs";
+import { createTaskCommunicationReconciler } from "./task-communication.mjs";
+export { OutboxEventConflictError, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter, createOutboxCommunicationRouter, createTaskCommunicationReconciler, outboxIdSchema, outboxMessageSchema, outboxQueueSchema, outboxStateSchema, replyToSchema, sweepCommunicationOutbox };

package/dist/connectors/github.d.mts

@@ -0,0 +1,26 @@
+import { RepositorySlug } from "../schema/repository.mjs";
+import { MaybePromise } from "../schema/common.mjs";
+import { CommunicationEvent } from "../schema/communication.mjs";
+import { CommunicationAdapter } from "./index.mjs";
+//#region src/connectors/github.d.ts
+/** A GitHub repository and issue or pull-request number encoded by a reply destination. */
+interface GitHubReplyTarget {
+  repository: RepositorySlug;
+  number: number;
+}
+/** Parse a GitHub conversation address into its repository and issue or pull-request number. */
+declare function parseGitHubReplyAddress(address: string): GitHubReplyTarget;
+/** Render a provider-neutral communication event as a GitHub Markdown comment. */
+declare function renderGitHubCommunicationEvent(event: CommunicationEvent): string;
+/** Configures repository-scoped authentication, rendering, and transport for GitHub delivery. */
+interface GitHubCommunicationAdapterOptions {
+  token(repository: RepositorySlug): MaybePromise<string>;
+  render?(event: CommunicationEvent): string;
+  fetch?: typeof globalThis.fetch;
+  userAgent?: string;
+}
+/** Deliver Factory communication events as GitHub issue or pull-request comments. */
+declare function createGitHubCommunicationAdapter(options: GitHubCommunicationAdapterOptions): CommunicationAdapter;
+//#endregion
+export { GitHubCommunicationAdapterOptions, GitHubReplyTarget, createGitHubCommunicationAdapter, parseGitHubReplyAddress, renderGitHubCommunicationEvent };
+//# sourceMappingURL=github.d.mts.map

package/dist/connectors/github.mjs

@@ -0,0 +1,55 @@
+import { repositorySlugSchema } from "../schema/repository.mjs";
+import { communicationEventSchema } from "../schema/communication.mjs";
+//#region src/connectors/github.ts
+/** Parse a GitHub conversation address into its repository and issue or pull-request number. */
+function parseGitHubReplyAddress(address) {
+	const match = /^(?<repository>[^/]+\/[^/#]+)(?:#|\/pull\/)(?<number>[1-9][0-9]*)$/u.exec(address);
+	if (match?.groups?.repository === void 0 || match.groups.number === void 0) throw new Error(`Invalid GitHub reply address: ${address}.`);
+	return {
+		repository: repositorySlugSchema.parse(match.groups.repository.toLowerCase()),
+		number: Number(match.groups.number)
+	};
+}
+/** Render a provider-neutral communication event as a GitHub Markdown comment. */
+function renderGitHubCommunicationEvent(event) {
+	const detail = [
+		"question",
+		"summary",
+		"message",
+		"reason"
+	].map((field) => event.data[field]).find((value) => typeof value === "string" && value.trim() !== "");
+	const options = Array.isArray(event.data.options) ? event.data.options.filter((value) => typeof value === "string") : [];
+	return [detail ?? "Factory update", ...options.map((option) => `- ${option}`)].join("\n");
+}
+/** Deliver Factory communication events as GitHub issue or pull-request comments. */
+function createGitHubCommunicationAdapter(options) {
+	const fetchImplementation = options.fetch ?? globalThis.fetch;
+	const render = options.render ?? renderGitHubCommunicationEvent;
+	return Object.freeze({
+		channel: "github",
+		async deliver(input) {
+			const event = communicationEventSchema.parse(input);
+			if (event.replyTo.channel !== "github") throw new Error(`GitHub communication adapter cannot deliver to ${event.replyTo.channel}.`);
+			const target = parseGitHubReplyAddress(event.replyTo.address);
+			const response = await fetchImplementation(`https://api.github.com/repos/${target.repository}/issues/${target.number}/comments`, {
+				method: "POST",
+				headers: {
+					accept: "application/vnd.github+json",
+					authorization: `Bearer ${await options.token(target.repository)}`,
+					"content-type": "application/json",
+					"user-agent": options.userAgent ?? "agent-factory"
+				},
+				body: JSON.stringify({ body: render(event) })
+			});
+			if (!response.ok) {
+				await response.body?.cancel();
+				throw new Error(`GitHub communication delivery failed: ${response.status}`);
+			}
+			await response.body?.cancel();
+		}
+	});
+}
+//#endregion
+export { createGitHubCommunicationAdapter, parseGitHubReplyAddress, renderGitHubCommunicationEvent };
+
+//# sourceMappingURL=github.mjs.map

package/dist/connectors/github.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.mjs","names":[],"sources":["../../src/connectors/github.ts"],"sourcesContent":["import {\n  communicationEventSchema,\n  type CommunicationAdapter,\n  type CommunicationEvent,\n} from \"./index\";\nimport type { MaybePromise } from \"../schema/common\";\nimport { repositorySlugSchema, type RepositorySlug } from \"../schema/repository\";\n\n/** A GitHub repository and issue or pull-request number encoded by a reply destination. */\nexport interface GitHubReplyTarget {\n  repository: RepositorySlug;\n  number: number;\n}\n\n/** Parse a GitHub conversation address into its repository and issue or pull-request number. */\nexport function parseGitHubReplyAddress(address: string): GitHubReplyTarget {\n  const match = /^(?<repository>[^/]+\\/[^/#]+)(?:#|\\/pull\\/)(?<number>[1-9][0-9]*)$/u.exec(address);\n  if (match?.groups?.repository === undefined || match.groups.number === undefined) {\n    throw new Error(`Invalid GitHub reply address: ${address}.`);\n  }\n  return {\n    repository: repositorySlugSchema.parse(match.groups.repository.toLowerCase()),\n    number: Number(match.groups.number),\n  };\n}\n\n/** Render a provider-neutral communication event as a GitHub Markdown comment. */\nexport function renderGitHubCommunicationEvent(event: CommunicationEvent): string {\n  const detail = [\"question\", \"summary\", \"message\", \"reason\"]\n    .map((field) => event.data[field])\n    .find((value): value is string => typeof value === \"string\" && value.trim() !== \"\");\n  const options = Array.isArray(event.data.options)\n    ? event.data.options.filter((value): value is string => typeof value === \"string\")\n    : [];\n  return [detail ?? \"Factory update\", ...options.map((option) => `- ${option}`)].join(\"\\n\");\n}\n\n/** Configures repository-scoped authentication, rendering, and transport for GitHub delivery. */\nexport interface GitHubCommunicationAdapterOptions {\n  token(repository: RepositorySlug): MaybePromise<string>;\n  render?(event: CommunicationEvent): string;\n  fetch?: typeof globalThis.fetch;\n  userAgent?: string;\n}\n\n/** Deliver Factory communication events as GitHub issue or pull-request comments. */\nexport function createGitHubCommunicationAdapter(\n  options: GitHubCommunicationAdapterOptions,\n): CommunicationAdapter {\n  const fetchImplementation = options.fetch ?? globalThis.fetch;\n  const render = options.render ?? renderGitHubCommunicationEvent;\n  return Object.freeze({\n    channel: \"github\",\n    async deliver(input: CommunicationEvent): Promise<void> {\n      const event = communicationEventSchema.parse(input);\n      if (event.replyTo.channel !== \"github\") {\n        throw new Error(`GitHub communication adapter cannot deliver to ${event.replyTo.channel}.`);\n      }\n      const target = parseGitHubReplyAddress(event.replyTo.address);\n      const response = await fetchImplementation(\n        `https://api.github.com/repos/${target.repository}/issues/${target.number}/comments`,\n        {\n          method: \"POST\",\n          headers: {\n            accept: \"application/vnd.github+json\",\n            authorization: `Bearer ${await options.token(target.repository)}`,\n            \"content-type\": \"application/json\",\n            \"user-agent\": options.userAgent ?? \"agent-factory\",\n          },\n          body: JSON.stringify({ body: render(event) }),\n        },\n      );\n      if (!response.ok) {\n        await response.body?.cancel();\n        throw new Error(`GitHub communication delivery failed: ${response.status}`);\n      }\n      await response.body?.cancel();\n    },\n  });\n}\n"],"mappings":";;;;AAeA,SAAgB,wBAAwB,SAAoC;CAC1E,MAAM,QAAQ,sEAAsE,KAAK,OAAO;CAChG,IAAI,OAAO,QAAQ,eAAe,KAAA,KAAa,MAAM,OAAO,WAAW,KAAA,GACrE,MAAM,IAAI,MAAM,iCAAiC,QAAQ,EAAE;CAE7D,OAAO;EACL,YAAY,qBAAqB,MAAM,MAAM,OAAO,WAAW,YAAY,CAAC;EAC5E,QAAQ,OAAO,MAAM,OAAO,MAAM;CACpC;AACF;;AAGA,SAAgB,+BAA+B,OAAmC;CAChF,MAAM,SAAS;EAAC;EAAY;EAAW;EAAW;CAAQ,CAAC,CACxD,KAAK,UAAU,MAAM,KAAK,MAAM,CAAC,CACjC,MAAM,UAA2B,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,EAAE;CACpF,MAAM,UAAU,MAAM,QAAQ,MAAM,KAAK,OAAO,IAC5C,MAAM,KAAK,QAAQ,QAAQ,UAA2B,OAAO,UAAU,QAAQ,IAC/E,CAAC;CACL,OAAO,CAAC,UAAU,kBAAkB,GAAG,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI;AAC1F;;AAWA,SAAgB,iCACd,SACsB;CACtB,MAAM,sBAAsB,QAAQ,SAAS,WAAW;CACxD,MAAM,SAAS,QAAQ,UAAU;CACjC,OAAO,OAAO,OAAO;EACnB,SAAS;EACT,MAAM,QAAQ,OAA0C;GACtD,MAAM,QAAQ,yBAAyB,MAAM,KAAK;GAClD,IAAI,MAAM,QAAQ,YAAY,UAC5B,MAAM,IAAI,MAAM,kDAAkD,MAAM,QAAQ,QAAQ,EAAE;GAE5F,MAAM,SAAS,wBAAwB,MAAM,QAAQ,OAAO;GAC5D,MAAM,WAAW,MAAM,oBACrB,gCAAgC,OAAO,WAAW,UAAU,OAAO,OAAO,YAC1E;IACE,QAAQ;IACR,SAAS;KACP,QAAQ;KACR,eAAe,UAAU,MAAM,QAAQ,MAAM,OAAO,UAAU;KAC9D,gBAAgB;KAChB,cAAc,QAAQ,aAAa;IACrC;IACA,MAAM,KAAK,UAAU,EAAE,MAAM,OAAO,KAAK,EAAE,CAAC;GAC9C,CACF;GACA,IAAI,CAAC,SAAS,IAAI;IAChB,MAAM,SAAS,MAAM,OAAO;IAC5B,MAAM,IAAI,MAAM,yCAAyC,SAAS,QAAQ;GAC5E;GACA,MAAM,SAAS,MAAM,OAAO;EAC9B;CACF,CAAC;AACH"}

package/dist/connectors/index.d.mts

@@ -1,3 +1,35 @@
-import { ct as CommunicationOutcome, dt as communicationOutcomes, lt as communicationEventSchema, st as CommunicationEvent, ut as communicationOutcomeSchema } from "../engine-DFHU2Pe-.mjs";
-import { a as WebhookEvent, c as OutboxSweepResult, i as SignalNormalizer, l as createOutboxCommunicationRouter, n as CommunicationRouter, o as createCommunicationRouter, r as NormalizedSignal, s as OutboxDeliveryOptions, t as CommunicationAdapter, u as sweepCommunicationOutbox } from "../index-Bw6hggoH.mjs";
-export { CommunicationAdapter, type CommunicationEvent, type CommunicationOutcome, CommunicationRouter, NormalizedSignal, OutboxDeliveryOptions, OutboxSweepResult, SignalNormalizer, WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter, createOutboxCommunicationRouter, sweepCommunicationOutbox };
+import { SignalSource } from "../schema/signal.mjs";
+import { ReplyTo } from "../schema/common.mjs";
+import { CommunicationEvent, CommunicationOutcome, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes } from "../schema/communication.mjs";
+import { CommunicationOutboxStores, CreateOutboxCommunicationRouterOptions, OutboxDeliveryOptions, OutboxSweepResult, SweepCommunicationOutboxOptions, createOutboxCommunicationRouter, sweepCommunicationOutbox } from "./outbox.mjs";
+//#region src/connectors/index.d.ts
+/** An authenticated provider webhook envelope before connector-specific normalization. */
+interface WebhookEvent {
+  deliveryId: string;
+  event: string;
+  payload: unknown;
+}
+/** Connector-neutral signal data ready for admission into Factory. */
+interface NormalizedSignal<TSource extends SignalSource = SignalSource> {
+  source: TSource;
+  deliveryId: string;
+  replyTo: ReplyTo;
+  payload: unknown;
+}
+/** Converts a verified webhook into a Factory signal or deliberately ignores it. */
+type SignalNormalizer<TSignal extends NormalizedSignal = NormalizedSignal> = (event: WebhookEvent) => TSignal | null;
+/** Delivers communication events for one provider channel. */
+interface CommunicationAdapter {
+  readonly channel: string;
+  deliver(event: CommunicationEvent): Promise<void>;
+}
+/** Routes validated communication events to adapters by reply channel. */
+interface CommunicationRouter {
+  readonly channels: readonly string[];
+  deliver(event: CommunicationEvent): Promise<void>;
+}
+/** Create a channel router that rejects duplicate registrations and unsupported destinations. */
+declare function createCommunicationRouter(adapters: readonly CommunicationAdapter[]): CommunicationRouter;
+//#endregion
+export { CommunicationAdapter, type CommunicationEvent, type CommunicationOutboxStores, type CommunicationOutcome, CommunicationRouter, type CreateOutboxCommunicationRouterOptions, NormalizedSignal, type OutboxDeliveryOptions, type OutboxSweepResult, SignalNormalizer, type SweepCommunicationOutboxOptions, WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter, createOutboxCommunicationRouter, sweepCommunicationOutbox };
+//# sourceMappingURL=index.d.mts.map