From 009fbeb5432399b90617d059db18c74f3f44adf9 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Wed, 24 Dec 2025 21:20:10 +0000
Subject: [PATCH] chore: add gmail hook setup notes

---
 src/hooks/gmail-ops.ts         | 1 +
 src/hooks/gmail-setup-utils.ts | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/hooks/gmail-ops.ts b/src/hooks/gmail-ops.ts
index dbf4d0f2e..4aae31ae3 100644
--- a/src/hooks/gmail-ops.ts
+++ b/src/hooks/gmail-ops.ts
@@ -114,6 +114,7 @@ export async function runGmailSetup(opts: GmailSetupOptions) {
     opts.project ??
     parsedTopic?.projectId ??
     (await resolveProjectIdFromGogCredentials());
+  // Gmail watch requires the Pub/Sub topic to live in the OAuth client project.
   if (!projectId) {
     throw new Error(
       "GCP project id required (use --project or ensure gog credentials are available)",
diff --git a/src/hooks/gmail-setup-utils.ts b/src/hooks/gmail-setup-utils.ts
index 5abe7bab1..d9d94d111 100644
--- a/src/hooks/gmail-setup-utils.ts
+++ b/src/hooks/gmail-setup-utils.ts
@@ -172,6 +172,7 @@ export async function ensureTailscaleEndpoint(params: {
   }
 
   const baseUrl = `https://${dnsName}${pathArg}`;
+  // Funnel/serve strips pathArg before proxying; keep it only in the public URL.
   return params.token ? `${baseUrl}?token=${params.token}` : baseUrl;
 }